Upgrade Procedure

Upgrading from Crowd 2.0 to Crowd 2.1 Beta 2 should be straightforward. Please follow the Crowd upgrade guide.

Custom Application Connectors

If you are using a custom application connector:

• You can connect a Crowd 2.0.7 client to the Crowd 2.1 server, because the SOAP API is fully backward-compatible.
• If possible, we recommend that you upgrade the client to version 2.1. This will require a recompilation of the application, because some of the classes have moved into different packages within the client JAR.

IPv6 with Confluence

This section applies only if you are using IPv6 with Confluence. In Crowd 2.1 Beta 2, SSO does not work between Confluence and Crowd if Confluence is using IPv6 addresses. This issue will be fixed before Crowd 2.1 is released.

To fix this problem with the beta, please add a flag to force IPv4 in Confluence:

1. Edit the following file in your Confluence installation:
   • On Windows: {CONFLUENCE_INSTALLATION}\bin\setenv.bat
   • On UNIX: {CONFLUENCE_INSTALLATION}/bin/setenv.sh
2. Add -Djava.net.preferIPv4Stack=true to the JAVA_OPTS variable.

As a result of your edit, the whole line will be similar to this:

• On Windows:

  
  set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx512m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=true
  

• On UNIX:

  
  JAVA_OPTS="-Xms256m -Xmx512m -XX:MaxPermSize=256m $JAVA_OPTS -Djava.awt.headless=true -Djava.net.preferIPv4Stack=true"
  

IPv6 with JIRA

This section applies only if you are using IPv6 with JIRA. In Crowd 2.1 Beta 2, SSO does not work between JIRA and Crowd if JIRA is using IPv6 addresses. This issue will be fixed before Crowd 2.1 is released.

To fix this problem with the beta, please add a flag to force IPv4 in JIRA:

1. Edit the following file in your JIRA installation:
   • On Windows: {JIRA_INSTALLATION}\bin\setenv.bat
   • On UNIX: {JIRA_INSTALLATION}/bin/setenv.sh
2. Add -Djava.net.preferIPv4Stack=true to the JAVA_OPTS variable.

As a result of your edit, the whole line will be similar to this:

• On Windows:

  
  set JAVA_OPTS=%JAVA_OPTS% -Xms%JVM_MINIMUM_MEMORY% -Xmx%JVM_MAXIMUM_MEMORY% %JVM_REQUIRED_ARGS% %DISABLE_NOTIFICATIONS% %JVM_SUPPORT_RECOMMENDED_ARGS% -Djava.net.preferIPv4Stack=true
  

• On UNIX:

  
  JAVA_OPTS="-Xms${JVM_MINIMUM_MEMORY} -Xmx${JVM_MAXIMUM_MEMORY} ${JAVA_OPTS} ${JVM_REQUIRED_ARGS} ${DISABLE_NOTIFICATIONS} ${JVM_SUPPORT_RECOMMENDED_ARGS} -Djava.net.preferIPv4Stack=true"