IBM Support

Uninstalling the IMS Server 8.2.1-ISS-SAMESSO-IMS-FP0008

Question & Answer


Question

How to uninstall an IMS Server fix pack?

Answer

When you install a fix pack for IMS Server, you can uninstall the fix pack and revert to the previous version if necessary. You can uninstall the fix pack automatically or manually.

To uninstall the fix pack and to revert IMS Server to the previous version, you must have access to the IMS Server installation files.

Uninstalling the fix pack automatically
These steps uninstall the IMS Server fix pack and automatically redeploys the IMS Server in the WebSphere Application Server.

Note: This procedure is applicable for WebSphere Application Server Version 7.0 only.

Ensure that:
  • You extracted the etc-ISS-SAMESSO-8.2.1.zip file into your selected directory and copied the extracted etc folder into the root of the IMS Server installation directory.
  • IMS Server fix pack is installed.
  • WebSphere Application Server 7.0 is installed and running.
  • IBM HTTP Server is installed and configured for the IMS Server.

Procedure
1. From the <IMS Server installation directory>\etc\ folder, open the tamesso.ims.appserver.properties file with a text editor.

2. Edit the values of these variables.
    • was.hostname=was_hostname
      was.connector.port=was_connector_port
      was.security.enabled=true
      was.admin.user.id=was_admin_id
      was.admin.user.pwd=was_admin_pw
      was.truststore.file=truststore_file
      was.truststore.pwd=truststore_pwd
      was.keystore.file=
      was.keystore.pwd=
 
    • a. Replace was_hostname with the name of your computer.

      b. Replace was_connector_port with the SOAP connector port. For example: 8880.

        • Retrieve the SOAP connector port value from: C:\Program Files\IBM\WebSphere\AppServer\profiles\<profile_name>\logs\AboutThisProfile.txt

          Note: If you use WebSphere Application Server Network Deployment, <profile_name> is the deployment manager profile name.

      c. Take one of the following actions:
          • If WebSphere Application Server security is enabled, replace was_admin_id and was_admin_pw with your WebSphere Application Server user name and password.
          • If WebSphere Application Server security is not enabled, set the value of was.security.enabled to false.

      d. Set the truststore_file and truststore_pwd.

      • Note: Use any of these valid formats when you specify the path for the truststore file:
        • C:/.../...
        • C:\\...\\...
        • truststore_file
          Replace truststore_file with the path where the truststore file is located. Follow the format in the tamesso.ims.appserver.properties file.
          • For WebSphere Application Server stand-alone:

          • C:\Program Files\IBM\WebSphere\AppServer\profiles\<profile_name>\config\cells\<cell_name>\nodes\<node_name>\trust.p12

            See the following example:
            C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\ibmusvr1Node01Cell\nodes\ibmusvr1Node01\trust.p12
          • For WebSphere Application Server Network Deployment:

          • C:\Program Files\IBM\WebSphere\AppServer\profiles\<Dmgr_profilename>\config\cells\<cell_name>\trust.p12

            See the following example:
            C:\Program Files\IBM\WebSphere\AppServer\Profiles\Dmgr01\config\cells\ibm-svr1Cell01\trust.p12

          truststore_pwd
          Replace truststore_pwd with your WebSphere Application Server trust store password.
          The default password for WebSphere Application Server trust store is WebAS.
      e. If two-way SSL is enabled, set the was.keystore.file and was.keystore.pwd.
      • Note: Use any of these valid formats when you specify the path for the keystore file:
        • C:/.../...
        • C:\\...\\...
        • was.keystore.file
          Specify the path where the keystore file is located. Follow the format indicated in the tamesso.ims.appserver.properties file. For example:
          • For WebSphere Application Server stand-alone:

          • C:\Program Files\IBM\WebSphere\AppServer\profiles\<profile_name>\config\cells\<cell_name>\nodes\<node_name>\key.p12

            See the following example:
            C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\ibmusvr1Node01Cell\nodes\ibmusvr1Node01\key.p12
          • For WebSphere Application Server Network Deployment:

          • C:\Program Files\IBM\WebSphere\AppServer\profiles\<Dmgr_profilename>\config\cells\<cell_name>\key.p12

            See the following example:
            C:\Program Files\IBM\WebSphere\AppServer\Profiles\Dmgr01\config\cells\ibm-svr1Cell01\key.p12
       
        • was.keystore.pwd
          Specify the WebSphere Application Server keystore password.
          Note: Remove the value after the installation to avoid compromising security.

      f. Click Save and close the file.


3. Launch the IBM Update Installer for WebSphere Software.
      • a. On your Microsoft Windows Desktop, select Start > All Programs > IBM WebSphere > Update Installer for WebSphere Software. The IBM Update Installer for WebSphere Software wizard is displayed.

        b. Click Next. The Product Selection page is displayed.

        c. Click Browse to select the location of the <IMS Server installation directory> and click Open. For example: C:\Program Files\IBM\ISAM ESSO\IMS Server

        d. Click Next. The Maintenance Operation Selection page is displayed.

        e. Select Uninstall Maintenance package.

        f. Click Next. The Maintenance Package Directory Selection page is displayed.

        g. Click Next.

        h. Select the 8.2.1-ISS-SAMESSO-IMS-FP0008.pak file.

        i. Click Next. The Installation Summary page is displayed.

        j. Click Next. Two possible messages can be displayed:

         
        • Success: The following maintenance package was successfully uninstalled.
          Displays if you provided the correct connection properties.

          Success: The following maintenance package was partially uninstalled.
          Displays if you provided the wrong connection properties. See Uninstalling fix pack manually procedure.
4. Click Finish.

What to do next
  • Map the ISAMESSOIMS module.
  • Do the post installation configurations.
  • Verify that the IMS Server version was changed to the previously installed version.

See the 8.2.1-ISS-SAMESSO-IMS-FP0008 technote for the steps for each procedure.

Uninstalling the fix pack manually


You must uninstall the IMS Server fix pack and manually redeploy the IMS Server in the WebSphere Application Server.

Ensure that:
  • IMS Server fix pack is installed.
  • IBM HTTP Server is configured for the IMS Server.

Procedure

1. On your Microsoft Windows Desktop, select Start > All Programs > IBM WebSphere > Update Installer for WebSphere Software. The IBM Update Installer for WebSphere Software wizard is displayed.

2. Click Next. The Product Selection page is displayed.

3. Click Browse to select the location of the <IMS Server installation directory> and click Open. For example: C:\Program Files\IBM\ISAM ESSO\IMS Server

4. Click Next. The Maintenance Operation Selection page is displayed.

5. Select Uninstall Maintenance package.

6. Click Next. The Maintenance Package Directory Selection page is displayed.

7. Click Next.

8. Select the 8.2.1-ISS-SAMESSO-IMS-FP0008.pak file

9. Click Next. The Uninstallation Summary page is displayed.

10. Click Next. The message Success: The following maintenance package was uninstalled is displayed.

11. Click Finish.

 

What to do next

  • Manually uninstall the IMS Server.
  • Install the ISAMESSOIMSConfig application.
  • Install the ISAMESSOIMS application.
  • Map the ISAMESSOIMS module.
  • Do the post installation configurations.
  • Verify that the IMS Server version was changed to the previously installed version.

See the 8.2.1-ISS-SAMESSO-IMS-FP0008 technote for the steps for each procedure.

[{"Product":{"code":"SS9JLE","label":"IBM Security Access Manager for Enterprise Single Sign-On"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"IMS Server","Platform":[{"code":"PF033","label":"Windows"}],"Version":"8.2.1","Edition":"","Line of Business":{"code":"LOB24","label":"Security Software"}}]

Document Information

Modified date:
07 October 2019

UID

ibm11078275