This page last changed on Jul 08, 2010 by kburke.
This guide applies to situations when you may need to migrate Crowd because:
- Your Crowd server is changing.
- You are cloning your production server for a staging, test or development instance.
Preparation
- Make sure you have a Crowd license for the new server you are targeting. Developer/staging licenses are available for any commercial or academic license. Create a developer license or contact us for help.
- Add the IP address or hostname of the target Crowd server to the remote addresses in your existing Crowd server:
- Find the IP address or hostname of the target Crowd server.
- Log in to the Crowd Administration Console on your existing Crowd server.
- Click the 'Applications' tab, find the 'Crowd Console' application and open the 'Remote Addresses' tab.
- Ensure that the address list includes at least the following items: 'localhost', '127.0.0.1' and the IP address or hostname of the machine that is going to receive the new Crowd instance. This list determines the hosts that can access the Crowd Administration Console.
- Perform an XML backup of your existing Crowd server. Make sure that you check the 'Reset Domain' checkbox, otherwise you may be prevented from logging in to the new Crowd Administration Console.
From this point on, we will call your existing Crowd server the 'original' server.
Migration
- Copy the XML backup over to the target server.
- Install Crowd on the target server using our installation guide.
- The Crowd version can be the same or higher than the version on the original Crowd server.
- When specifying your Crowd Home directory, make sure you choose a new location and not your original Crowd Home directory.
- Run the Setup Wizard.
- When asked for the type of installation, choose 'Import data from an XML backup'. Provide the full path to your XML backup file and import the data.
- When given the option of configuring Crowd to target a database, make sure you choose a new one and not your original Crowd database.
- When the import finishes, shut down Crowd.
- Locate the crowd.properties file in the target server's Crowd Home directory. (This file will have been generated from the data in the XML backup.) Edit the file and modify the line crowd.server.url so that it points to your new Crowd server.
Post Migration Verification
- In your original Crowd server, you can now remove the IP address or hostname you added during the preparation steps. This will help prevent you from accidentally logging into your original Crowd server.
- Start Crowd on the new server. You should be able to authenticate and access Crowd using the same credentials as on your original Crowd server.
Applications and Customisations
- For any application you are going to test against this new Crowd server, you will need to modify the application's crowd.properties file to point to this new server.
- If you have installed any Crowd plugins or added other customisations, you will need to re-apply them on the new server.
If you encounter any difficulties, please feel free to contact support and let us know which step you are having problems with.
RELATED TOPICS
Specifying your Crowd Home Directory
Crowd Installation and Upgrade Guide
Running the Setup Wizard
|