You can perform various migration procedures for Alfresco Content Services servers and databases.
Migrating servers (#migrating-servers)
The process of migrating an instance of Alfresco Content Services running on one server to another server follows a similar pattern to the backup process, with additional steps to ensure any configuration is also copied over.
The dir.root
property is usually defined in the alfresco-global.properties
file.
The dir.root
is often a directory named alf_data
within the directory where Alfresco Content Services is installed, and will hold both content and full text indexes by default. The dir.root
location is also reported in the logs when the server is started.
Backing up Alfresco Content Services Server 1
This task describes how to back up the first server for migration.
-
Stop the Alfresco Content Services server to ensure that no changes can be made while backing up or restoring.
-
Export the database to
dir.root
(same location as content and indexes). -
Copy the configuration directory to
dir.root
. For example:cp -r tomcat/shared/classes/alfresco/extension alf_data
-
Back up
dir.root
.
Restoring to Alfresco Content Services Server 2
This task describes how to restore a back up of a server to another server.
-
Install a compatible Alfresco Content Services server. This is typically an identical version to server 1.
Note: Do not start the new server.
-
Restore
dir.root
. If the path is different on server 2, change thedir.root
configuration. -
Rename the new server’s configuration directory. For example:
mv tomcat/shared/classes/alfresco/extension new_ext
-
Move the configuration directory from
dir.root
to the appropriate location. For example:mv alf_data/extension tomcat/shared/classes/alfresco
-
If any configuration references server 1 explicitly, change these references to server 2.
-
Import the database from
dir.root
. -
Start the server.
You should now have a new instance of Alfresco Content Services on a second server with identical data.