Sun Java logo     Previous      Contents      Next     

Sun logo
Sun Java System Identity Installation Pack 2005Q4M3 SP4 Release Notes  

Notes on Installation and Update

Installation Notes

Update Notes

When updating Identity Manager, review the installation section for your application server for application server-specific instructions. This section includes a summary of upgrade tasks for upgrading from Identity Manager version 6.0 to 6.0 SP4. For more information, see the Identity Manager 6.0 Upgrade manual.

Identity Install Pack 2005Q4M3 SP4 can be updated from the following previous versions:

Use the following information and procedures to update Identity Manager.

Note  In some environments, including HP-UX, you may be required or prefer to follow the alternate, manual update procedures. If so, skip to the section titled Update Identity Manager Manually.

Note  Identity Manager 6.0 involves a schema change that introduces new tables for tasks, groups, organizations, and the syslog table. You must create these new table structures and move your existing data. See Step 2: Update the Repository Database Schema in the Documentation Additions and Corrections section of this document.

Note  If you edited the Access Review Notice email template in Identity Manager version 6.0, you must either save the template before upgrading Identity Manager or edit the template after you upgrade. (The upgrade process overwrites the template with the default values.) (ID-13216)

Step 1: Update the Identity Manager Software

Use the following information and procedures to update Identity Manager.

Notes:

To update Identity Manager:

  1. Shut down the application server.
  2. If you are running the Sun Identity Manager Gateway on the Identity Manager server, stop the gateway service with this command:

    3. gateway -k

  3. Run the install command to start the installation process.

    4. Identity Manager displays the Welcome panel.

  4. Click Next. Identity Manager displays the Select Installation Directory panel. Select Upgrade and click Next.
  5. Enter a location for (or click Browse to locate) the Identity Manager installation directory, and then click Next.
  6. Click Next to begin update.

    7. Identity Manager displays the Installation Summary Panel.

    Note  For detailed information about the installation, click Details. Depending on the amount of information captured during the installation process, not all messages will be displayed here. View the log file (identified in details) for more information. When finished, click Close to exit the installer.

  7. Remove all of the compiled Identity Manager files from the application server work directory.
  8. If the update process did not do so already, move any hotfix class files from the WEB-INF/classes directory to the patches/HotfixName directory.

Step 2: Update the Sun Identity Manager Gateway

If you are running the Sun Identity Manager Gateway on a remote system, use the following steps to update it:

  1. Log in to the Windows 2000 system where the Sun Identity Manager Gateway is installed.
  2. Change to the directory where the gateway is installed.
  3. Stop the gateway service by running the command:

    4. gateway -k

  4. If using Windows 2000 or later, exit all instances of the Services MMC plug-in.
  5. Delete the existing gateway files.
  6. If the newly updated gateway is installed on a system that is not the Identity Manager server, then copy the gateway.zip file from the location the installation image was unpacked.
  7. Unpack the gateway.zip file into the directory where the gateway was installed.
  8. Run the following command to start the gateway service:

    9. gateway -s

You can also start and stop the gateway by following these steps:

  1. Open the Windows Control Panel.
  2. Open Services. (In Windows 2000, Services is located in Administrative Tools.)
  3. Select Sun Identity Manager Gateway.
  4. Click Start or Stop.

Update Identity Manager Manually

In some environments, you may need to perform the update steps manually instead of using the Identity Manager installation and upgrade program.

Notes:

Follow these steps to update Identity Manager manually:

  1. Stop the application server and the Sun Identity Manager Gateway.
  2. Enter the following series of commands:

    3. On Supported Windows Platforms

    1. Set your environment:

      2. set SPPATH=Path to Service Pack Files
      set WSHOME=Path to Identity Manager Installation
      OR Staging Directory
      set TEMP=Path to Temporary Directory

    2. Run pre-process:

      3. mkdir %TEMP%
      cd /d %TEMP%
      jar -xvf %SPPATH%\IDPAK2005Q4M3_SP4.jar \
      WEB-INF\lib\idm.jar \ WEB-INF\lib\idmcommon.jar \
      WEB-INF\lib\idmformui.jar
      set TMPLIBPTH=%TEMP%\WEB-INF\lib
      set CLASSPATH=%TMPLIBPTH%\idm.jar;\
      %TMPLIBPTH%\idmcommon.jar;%TMPLIBPTH%\idmformui.jar
      java -classpath %CLASSPATH% -Dwaveset.home=%WSHOME%
         com.waveset.install.UpgradePreProcess

    3. Install software:

      4. cd %WSHOME%
      jar -xvf       %SPPATH%\IDM.jar

    4. Run post-process:

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

      On Supported UNIX Platforms

    5. Set your environment:

      6. export SPPATH=Path to Extracted Service Pack Files
      export WSHOME=Path to Identity Manager Installation
      OR Staging Directory
      export TEMP=Path to Temporary Directory

    6. Run pre-process:

      7. mkdir $TEMP
      cd $TEMP
      jar -xvf $SPPATH/IDPAK2005Q4M3_SP4.jar \
      WEB-INF/lib/idm.jar WEB-INF/lib/idmcommon.jar \
      WEB-INF/lib/idmformui.jar
      CLASSPATH=$TEMP/WEB-INF/lib/idm.jar:\
      $TEMP/WEB-INF/lib/idmcommon.jar:\
      $TEMP/WEB-INF/lib/idmformui.jar
      java -classpath $CLASSPATH -Dwaveset.home=$WSHOME \
      com.waveset.install.UpgradePreProcess

    7. Install software:

      8. cd $WSHOME
      jar -xvf $SPPATH/IDM.jar

    8. Run post-process:

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

  3. Change directory to $WSHOME/bin/solaris or $WSHOME/bin/linux, then set permissions on the files in the directory so that they are executable.
  4. If you installed into a staging directory, create a .war file for deployment to your application server.

    5. Note  Refer to the appropriate chapter in Sun Java™ System Identity Manager Installation for application server-specific instructions.

  5. Remove the Identity Manager files from the application server work directory.
  6. If the update process did not do so already, move any hotfix class files from the WEB-INF/classes directory to the patches/HotfixName directory.
  7. Start the application server.
  8. Update the Identity Manager database. Refer to the earlier section titled Step 2: Update the Sun Identity Manager Gateway for detailed instructions.
  9. Update and then restart the Sun Identity Manager Gateway. Refer to the earlier section titled Step 2: Update the Sun Identity Manager Gateway for detailed instructions.


Previous      Contents      Next     

Copyright 2008 Sun Microsystems, Inc. All rights reserved.