Microsoft Azure Blob Storage Service
Self-Hosted Only
Available for 7.4+ and 7.3 FP2+
Microsoft Azure Blob Storage is a cloud-based storage solution that DXP’s Azure Blob Storage Store uses to seamlessly store files to the cloud. Under the hood, it uses the Microsoft’s Blob Storage API, optimized to handle huge amounts of unstructured data.
Before enabling this connection, you must have an active Azure Blob Store account, a configured Connection String, and an Azure Blob Container.
Next, do the following to enable the connection to your Liferay instance,
- Configure the File Store Method via the Control Panel
- Set the
dl.store.impl
portal property to use Azure Blob Storage as the default storage method
If a database transaction rollback occurs in a Document Library, the transaction’s file system changes are not reversed. Inconsistencies between Document Library files and those in the file system store can occur and may require manual synchronization. All of the DXP stores except for DBStore are vulnerable to this limitation.
Configuring the Store
Follow these steps to configure the store:
-
Open the Global Menu () → Control Panel → System Settings → File Storage → Azure Blob Storage.
-
Enter a Connection String for your Azure Blob Storage Store.
-
Enter the name of the Azure Blob Container you want to use for storing your files.
-
Optionally, enter an Encryption Scope for storing files.
-
Optionally, determine whether to enable HTTP Logging. When enabled, HTTP requests and responses made by the Azure client are printed in the server logs.
Once you’ve configured the Azure Blob Storage Store, you can set it as your default file storage system.
Setting Azure Blob Storage as Default Store
Follow these steps to use Azure Blob Storage as the default Store for the Liferay instance:
-
Add the following property to the instance’s
portal-ext.properties
file:dl.store.impl=com.liferay.portal.store.azure.AzureStore
If a
portal-ext.properties
file doesn’t exist, create a new one with the above value and add it to the instance’s[LIFERAY_HOME]
or[USER_HOME]
folder.This overrides the default value for
dl.store.impl
in theportal.properties
file. -
Restart the Liferay server.
Once finished restarting, the configured Azure Blob Storage container is your instance’s default store.
If you’re using Azure Blob Storage store in a clustered environment, the configuration on all nodes must be identical. In particular, make sure the portal-ext.properties
file and the Azure Blob Storage store settings in System Settings are the same.