Upgrading Crowd

Step 1. Preparation

Please read the Release Notes for the version you are upgrading to, and the Upgrade Notes for any versions you are skipping:

• Crowd 1.1 Upgrade Notes
• Crowd 1.0 Upgrade Notes

Step 2. Shut down Crowd and all integrated applications

You need to shut down Crowd and all Crowd-connected applications before backing up or performing the upgrade.

Step 3. Back up your Crowd files

Back up the following files:

• {CROWD_INSTALL}/database (back up the entire directory) (Note: if you are using an external database, this is not required)
  
  
• {CROWD_INSTALL}/crowd-webapp/WEBINF/classes/crowd.properties
  
  
• {CROWD_INSTALL}/crowd-webapp/WEBINF/classes/jdbc.properties
  
  
• {CROWD_INSTALL}/crowd-openidserver-webapp/WEBINF/classes/crowd.properties (Note: if you are upgrading from Crowd 1.0, this file may not exist)
  
  
• {CROWD_INSTALL}/crowd-openidserver-webapp/WEBINF/classes/jdbc.properties (Note: if you are upgrading from Crowd 1.0, this file may not exist)
  
  
• If you are using the standalone version of Crowd, back up the following files as well:
  
  
  • {CROWD_INSTALL}/apache-tomcat-X.X.XX/conf/Catalina/localhost/crowd.xml
    
    
  • {CROWD_INSTALL}/apache-tomcat-X.X.XX/conf/Catalina/localhost/openidserver.xml (Note: if you are upgrading from Crowd 1.0, this file may not exist)
    
    
  • {CROWD_INSTALL}/apache-tomcat-X.X.XX/conf/server.xml (Required if you are not running on port 8095)
    
    
  • Your database driver, e.g. {CROWD_INSTALL}/apache-tomcat-X.X.XX/common/lib/mysql*.jar (Note: if you are using an external database, this is not required)
    
    
• If you have installed Crowd on a separate application server, you need to back up your customised configuration files.

Step 4. Re-install Crowd

1. Download Crowd.
2. Unzip the download archive into a directory of your choice (note: do not specify directory names that contain spaces). This directory will be referred to as {CROWD_INSTALL}.
   Please make sure that your new {CROWD_INSTALL} directory has a different name from your old {CROWD_INSTALL} directory (e.g. you may need to rename your old {CROWD_INSTALL} directory before you begin), as legacy files may cause problems.

Step 5. Restore your Crowd files

Copy the files from Step 3 to your new {CROWD_INSTALL} directory.

Step 6. Start Crowd

Run the start-up script: 

• start_crowd.bat for Windows;
  or:
• start_crowd.sh for Unix environment.

The upgrade process will be performed when Crowd starts up. You will not see the Setup Wizard.

Monitor the atlassian-crowd.log to ensure that the upgrade process has completed successfully.

Step 7. Update your integrated applications

Copy the new client/crowd-XXXX-X.X.X.jar files to each Crowd-integrated application's WEB-INF/lib folder, replacing the existing crowd-XXXX-X.X.X.jar files.
For details please see the configuration instructions for each application:

• 3.2.1 Integrating Crowd with Apache or Subversion
• 3.2.2 Integrating Crowd with Atlassian Bamboo
• 3.2.3 Integrating Crowd with Atlassian Confluence
• 3.2.4 Integrating Crowd with Atlassian CrowdID
• 3.2.5 Integrating Crowd with Atlassian FishEye
• 3.2.6 Integrating Crowd with Atlassian JIRA
• 3.2.7 Integrating Crowd with Jive Forums
• 3.2.8 Integrating Crowd with a Custom Application

If you have installed Crowd on a new server, or changed Crowd's URL or port number, you will also need to edit the crowd.properties file in each integrated application accordingly.

トラブルシューティング

If you have any problems during upgrade, please raise a support request at https://support.atlassian.com/ja/ and attach your atlassian-crowd.log so we can help you find out what's gone wrong.

関連トピック

• Crowd Release Notes
• Crowd をインストールする
• Upgrading Crowd