Upgrading From Release 6.x to Release 6.3

You can upgrade from previous release 6 versions by using the import and export method described in Upgrading From Release 5.0.5 - 5.1.3 to Release 6.3, or you can perform side-by-side upgrade that allows you to continue to use your existing Repository by applying a patch to update the components. When you have completed the side-by-side upgrade, you will have two Java CAPS environments and will use the Java CAPS 6.3 components to connect to your Repository from the previous environment.

No matter which method you use, the runtime application must be manually rebuilt and redeployed to the new application server after the runtime upgrade is complete. This is described in Completing the Upgrade From Java CAPS 6.x.

To upgrade from an earlier Release 6 version, perform the following steps:

• Upgrading the Repository (side-by-side method) OR Upgrading From Release 5.0.5 - 5.1.3 to Release 6.3 (export and import method)

• Completing the Upgrade From Java CAPS 6.x

Upgrading the Repository

This topic describes the side-by-side method of upgrading the Repository. In addition to installing the laster version of Java CAPS, you will also install a patch to the previous version's Repository so you can continue using it in the new Java CAPS installation.

To Upgrade the Repository

1. Perform a complete backup of your existing Java CAPS Repository, domains, and the caps-patch directory.
2. Install Java CAPS 6.3 in a separate directory with the following guidelines:
   • Use the same Repository name for the new Repository as for the existing Repository that you are upgrading.
   • Use the same port numbers for the new installation as you did for the existing Java CAPS environment.
3. Rename the new Repository to repository_63.
4. Copy the caps-patch directory from the Java CAPS 6.3 environment into the old Java CAPS directory.

   ---

   Note - This step will replace the caps-patch directory in the old Java CAPS environment.

   ---

5. Copy the file named patches_ml.zip from the patches directory of your installation media to a temporary local directory.
6. Extract the ZIP file to the temporary directory (maintaining the directory structure).
7. Navigate to TempDir/patches_ml/patches/.

   You should see a file name 6836560-01-REP.zip.

8. Install the Repository patch by running the following command. Use the caps-patch-install command from the old Repository's caps-patch/util/bin directory.

   caps–patch–install –verbose -repuser user -reppwd pasword –patch temp-dir/6836560–01–REP.zip

   where temp-dir is the location where you copied 6836560-01-REP.zip.

   ---

   Note - The patch installer takes additional optional parameters. For more information about the syntax, see Java CAPS 6.3 Patch Management Tools in Installing Patches for Oracle Java CAPS.

   ---

   This updates the Repository in the older Java CAPS environment.

9. If you are using LDAP prefixes, open the file JavaCAPSHome/repository/repository/startserver.bat (or startserver.sh), where JavaCAPSHome is the Java CAPS R6 or R6U1 home directory. Add the following to the JAVA_OPTS section of the file:

   -Dorg.apache.catalina.realm.JNDIRealm.ROLE_PREFIX=prefix

   where prefix is the full LDAP prefix to use; for example, com.sun.java.

   ---

   Note - LDAP prefixes are a new features of the LDAP Adapter in this release. Prefixes are similar to suffixes, except they are prepended instead of appended to a user or group name to form the distinguished name (DN).

   ---

10. Start the Repository you just updated (in the old Java CAPS environment) and launch the Java CAPS 6.3 NetBeans IDE.
11. Connect to the updated Repository from the NetBeans IDE.

    You might need to modify the Repository connection information and CAPS Project location to connect to the correct Repository.

12. Open the existing Repository-based Projects in the Projects window to verify that you are connecting correctly to the updated Repository.
13. Continue to Completing the Upgrade From Java CAPS 6.x.

Completing the Upgrade From Java CAPS 6.x

Once you have imported all previous Projects and Environment into Java CAPS 6.3 or have updated the previous Repository, you need to redeploy and in some cases reconfigure the Projects. Runtime components need to be recreated as well.

To Complete the Upgrade

1. Complete the steps under Upgrading the Repository.
2. Recreate any runtime artifacts using the GlassFish Admin Console for Java CAPS 6.3.

   This could include any connection pools, security attributes, application configurations, application variables, and so on.

3. Reinstall the required plugins in Enterprise Manager.
4. Open any JBI Projects in NetBeans Project window.
5. Build and deploy all Repository and JBI Projects to the new GlassFish server installed with Java CAPS 6.3.