IBM Support

In a multi-product scenario, after uninstalling Rational ClearCase, ClearQuest, or RequisitePro web features from a WAS profile, the existing WAS profile might not be started.

Troubleshooting


Problem

After uninstalling IBM Rational ClearCase, Rational ClearQuest, or Rational RequisitePro web components from an existing IBM WebSphere Application Server (WAS) profile, the existing WAS profile might not be restarted and as a result, Web components of installed products that use this profile cannot be used because the profile is stopped.

Symptom

Multiple IBM Rational ClearCase, ClearQuest, or RequisitePro web features are installed and running in the same WebSphere Application Server profile. After uninstalling one of the products, attempts to open a web application for the remaining installed products fail. Here are example scenarios:

  • ClearQuest Web is not running after removing the CCRC WAN Server from a WAS profile <AppSrv01>, where both CCRC WAN Server and ClearQuest Web were installed.
  • ReqWeb is not running after removing ClearQuest Web from a WAS profile <AppSrv01>, where both ReqWeb and ClearQuest Web were installed.
  • CCRC WAN Server is not running after removing ClearQuest Web from an existing WAS profile <AppSrv01>, where both CCRC WAN Server and ClearQuest Web were installed.

Cause

During the product uninstall process, the existing WAS profile must be stopped. After the uninstall operation completes, the profile is not restarted because the product is no longer on the machine. The uninstall process does not provide a way to keep the profile running, or to restart it if other Rational products are still installed in the profile.

Diagnosing The Problem

After an uninstall operation, the existing WAS profile administrative console is stopped.

You can verify this from the Administrative Console, which can be accessed on a web browser on the www.hostname:<WAS_Profile_Port>/ibm/console


<WAS_Profile_Port> can be found under the <WAS_Profile_Location>\logs\AboutThisProfile.txt

Look for the Administrative console port. The default port for AppSrv01 is 9060. For example:
www.localhost:9060/ibm/console.

Resolving The Problem

After uninstalling a product in multi-product installation, restart the WAS profile by using either the startServer command or the Windows Services.


Starting the WAS profile using the startServer command

    1. Change directories to the profile_root/bin</code>] directory of the existing WAS profile.
    2. Start the server with the startServer command.

    • startServer.bat server1 -profileName profile_name

      [Linux] [HP-UX] [Solaris] [AIX]


      startServer.sh server1 -profileName profile_name

      Note:  If you have already changed to the profile_root/bin directory of the target profile, do not specify the -profileName argument.

Starting the WAS profile from the Windows Services console


[Windows] If a Windows service has been created for the application server, optionally use the Windows Services utility to start the server.

    1. To start the Services utility, click Start > Settings Control Panel to open the Control Panel.
    2. From the Control Panel, double-click the Administrative Tools icon to open the Administrative tools folder.
    3. Double-click the Services icon to open the Services console.
    4. In the details panel, locate the existing WAS profile <IBM WebSphere Application Server V7.0 - profileNode>. Then, start the profile using either of these methods:
      1. Click the service. Then, click Start from the Action menu.
      2. Right-click the service. Then click Start.

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSSH27","label":"Rational ClearCase"},"ARM Category":[{"code":"a8m50000000L0i5AAC","label":"ClearCase"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.0.1;9.0.1;9.0.2;9.1.0"},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSSHCT","label":"Rational RequisitePro"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1.3;7.1.3.1;7.1.3.10;7.1.3.11;7.1.3.12;7.1.3.13;7.1.3.14;7.1.3.15;7.1.3.16;7.1.3.17;7.1.3.2;7.1.3.3;7.1.3.4;7.1.3.5;7.1.3.6;7.1.3.7;7.1.3.8;7.1.3.9;7.1.4;7.1.4.1;7.1.4.10;7.1.4.2;7.1.4.3;7.1.4.4;7.1.4.5;7.1.4.6;7.1.4.7;7.1.4.8;7.1.4.9","Edition":"Enterprise","Line of Business":{"code":"LOB45","label":"Automation"}},{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"ARM Category":[{"code":"a8m50000000L0iAAAS","label":"ClearQuest"}],"Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF057","label":"HP"}],"Version":"8.0.1;9.0.1;9.0.2;9.1.0"}]

Document Information

Modified date:
30 November 2020

UID

swg21517154

Page Feedback