Sun Identity Manager 8.1 Upgrade

ProcedureTo Perform a Manual Upgrade on a UNIX Platform

Perform the following steps to upgrade Identity Manager manually on a supported UNIX platform:

  1. Stop the application server and Gateway.

  2. Update the Identity Manager database.

  3. Set your environment.


    export ISPATH=Path-to-Install-Software export WSHOME=Path-to-Identity-Manager-Installation-or-Staging Directory 
    export TEMP=Path-to-Temporary-Directory
    
  4. Run the pre-process.


    mkdir $TEMP
    cd $TEMP
    jar -xvf $ISPATH/idm.war \
    WEB-INF/lib/idm.jar WEB-INF/lib/idmcommon.jar
    CLASSPATH=$TEMP/WEB-INF/lib/idm.jar:\
    $TEMP/WEB-INF/lib/idmcommon.jar:
    java -classpath $CLASSPATH -Dwaveset.home=$WSHOME \
    com.waveset.install.UpgradePreProcess
  5. Install the software.


    cd $WSHOME
    jar -xvf $ISPATH/idm.war
  6. Run the post-process.


    java -classpath $CLASSPATH -Dwaveset.home=$WSHOME
      com.waveset.install.UpgradePostProcess

    Note –
    • The upgrade post-process step runs in a separate Java virtual machine. The default heap size for this step is 1024 MB. If you experience out-of-memory exceptions during this step, set the maximum heap size value higher. To specify a custom value, set the JAVA_OPTS environment variable using the form —Xmx<heap size> where heap size is a value, such as 2048m. An example is -Xmx2048m.

    • The installer supports upgrading installations that have renamed, deleted, or disabled the default Configurator account.

      The installer prompts you for the user name and password to import the update.xml during the upgrade post process. If the user or password is typed incorrectly, you will be prompted (up to three times) to enter the correct name or password. The error will be displayed in the text box behind it.

      For manual installation, you must provide the -U username -P password flags to pass the credentials to the UpgradePostProcess procedure.


  7. Change directory to $WSHOME/bin/solaris or $WSHOME/bin/linux, and set permissions on the files in the directory so that they are executable.

  8. If you installed into a staging directory, create a .war file for deployment to your application server.

  9. Remove the Identity Manager files from the application server work directory.