Uninstalling from WebSphere Application Server manually

To uninstall IBM® Rational® Asset Manager manually, use the following instructions to uninstall the enterprise and web archives from the application server and remove any other settings and configurations.

Before you begin

If you used the server setup application or Installation Manager to help you deploy the application files, you can use them to help you remove files. For more information, see Uninstalling with the server setup application and Installation Manager.

Procedure

  1. Start the IBM WebSphere® Application Server Administrative Console.
  2. Log in using an administrator user ID and password.
  3. Delete the datasource for Rational Asset Manager:
    1. Locate and click the Datasource with the JNDI name jdbc/RAM_Con
      • If you are using a standalone server, you may find it under the Server scope.
      • If you are using a network server, you may find it under the cluster that Rational Asset Manager was installed on.
    2. Note the name of the component-managed authentication alias that the datasource uses.
    3. Delete the datasource.
    4. Navigate to Security > Global security > Java Authentication and Authorization Service > J2C Authentication Data.
    5. Delete the entry whose name matches the component-managed authentication alias that you noted.
  4. If you installed Rational Team Concert onto your server or cluster, delete the datasource for Rational Team Concert:
    1. Locate and click the Datasource with the JNDI name jdbc/RTC_Con
      • If you are using a standalone server, you may find it under the Server scope.
      • If you are using a network server, you may find it under the server that Rational Team Concert was installed on.
    2. Note the name of the component-managed authentication alias that the datasource uses.
    3. Delete the datasource.
    4. Navigate to Security > Global security > Java Authentication and Authorization Service > J2C Authentication Data.
    5. Delete the entry whose name matches the component-managed authentication alias that you noted.
  5. Optional: If your server is a network deployment cluster, delete the system integration bus.
    1. Navigate to Service Integration > Buses.
    2. Delete the bus named RAMBus.
    3. Navigate to Resources > JMS > Connection Factories.
    4. Delete the factory named RAM Factory. It might be under the scope of the cluster that Rational Asset Manager was installed on.
    5. Navigate to Resources > JMS > Topics.
    6. Delete the topic named RAM Cache. It might be located under the scope of the cluster that Rational Asset Manager was installed on.
  6. Remove the applications.
    1. Click Applications > Application types > WebSphere enterprise applications in the navigation pane.
    2. Check any of the applications that are installed:
      • RAM1WebApplication
      • com.ibm.ram.repository.setup.web.ear
      • ramhelp_war (or iehs_war for Rational Asset Manager 7.5.0.2 or earlier)
      • rmcabdgovernprocess_war
      • ramjazz_war (or jazz_war for Rational Asset Manager 7.5.0.2 or earlier)
    3. Click Uninstall.
    4. Click Save to apply the changes to the master configuration.
  7. Locate and delete the storage directories for Rational Asset Manager:
    1. Click Resources > URLs.
    2. Click All scopes.
    3. You will see many variables called RAM Persist, RAM Local, and RAM Index.
    4. Click on every variable and note the values of the variables, which will be directories.
    5. Delete all files and folders in those directories. On a WebSphere Application Server ND environment, the Persist directory will be a single shared directory, and there will be an Index and Local directory for every node in the cluster.
    6. After you have deleted all of the directories, delete all the variables called RAM Persist, RAM Local, RAM Index, and RAM CQJRE
  8. Delete custom properties for IBM Rational Team Concert:
    1. Click Servers > Server types > WebSphere Application Servers.
    2. Click the name of the server where you deployed Rational Team Concert.
    3. Click Java and Process Management.
    4. Click Process Definition.
    5. Click Java Virtual Machine.
    6. Click Custom Properties.
    7. Select the following properties:
      1. JAZZ_HOME (the value of this variable will be a folder on your hard drive that you will have to delete)
      2. java.awt.headless
      3. org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin
      4. (if you used an Oracle database) ORACLE_JDBC
      5. (if you used a Microsoft SQL Server database) SQLSERVER_JDBC
    8. Click Delete.
  9. Delete the shared libraries references for Rational Asset Manager:
    1. Click Servers > Server types > WebSphere Application Servers.
    2. Click the name of the server where you deployed Rational Asset Manager.
    3. Click Java and Process Management.
    4. Click Classloader.
    5. Click the Classloader ID.
    6. Click Shared library references.
    7. Select the property that begins with the prefix rlsibmratl. Example: rlsibmratl_812.
    8. Click Delete.
    9. For a WebSphere Application Server Cluster, repeat these steps for each application server in the cluster.
  10. Delete the shared libraries for Rational Asset Manager:
    1. Click Environment > Shared libraries.
    2. Select All scopes.
    3. Click Shared library references.
    4. Select all of the shared libraries that begin with the prefix rlsibmratl. Example: rlsibmratl_812
    5. Click Delete.
  11. Optional: If Rational Asset Manager was the only application on the server, remove any environment variables.
    1. Click Environment > WebSphere Variables in the navigation pane.
    2. Click the name of any environment variables that were set up for Rational Asset Manager (for example, Oracle_JDBC_DRIVER_PATH).
    3. Click Delete.
    4. Click Save to apply the changes to the master configuration.
  12. Optional: Re-configure authentication and security settings. If you configured security specifically for Rational Asset Manager, then revert any settings to the previous configuration. If the security settings apply to other applications, do not modify them.
  13. Stop the server. On a cluster, you only need to stop the application server that was running Rational Team Concert.
  14. Navigate to the following directory on your hard drive: WebSphere_install_directory\profiles\profile_name\temp\server_name\
  15. In the server_name directory, delete the following directories:
    • RAM1WebApplication
    • ramhelp_war (or iehs_war for Rational Asset Manager 7.5.0.2 or earlier)
    • rmcabdgovernprocess_war
    • ramjazz_war (In a WebSphere Application Server ND environment, this folder is only on the computer with the application server that was running Rational Team Concert

    For a WebSphere Application Server Cluster, delete the above directories on every physical computer in the cell.

  16. Navigate to the following directory on your hard drive: WebSphere_install_directory\profiles\profile_name\config\cells\cell_name\. On a cluster, this directory will be in a subdirectory of the profile of the machine where Deployment Manager is installed.
  17. In the cell_name directory, delete the RTC directories: ram_jdbc and ramSharedLibs.
  18. Restart the server.

Feedback