IBM Support

How to determine the installed version of IBM Rational Software Architect

Question & Answer


Question

How do you find out which version of IBM Rational Software Architect for Websphere Software (RSA4WS), IBM Rational Software Architect (RSA) or IBM Rational Application Developer (RAD) is installed on a machine?

Cause

You are administering a large number of machines and you want to be able to make sure that the same version of RSA4WS, RSA or RAD is installed on a given set of machines.

Answer

ANSWER

There are two ways for you to check which versions of RSA4WS, RSA or RAD is installed on your machine depending on your version of IBM Installation Manager (IM):

  • Use the imcl command (This is the recommended method but it requires IM version 1.4.3 or higher.)

    • The easiest way for you to find out which versions of RSA4WS, RSA or RAD is installed is to use the  imcl command that was introduced with IM 1.4.3. You can find the imcl executable file in the tools directory of your IM installation directory. By default, this directory can be found in C:\Program Files\IBM\Installation Manager\eclipse\tools on Microsoft Windows or in /opt/IBM/InstallationManager/eclipse/tools on Linux.

    From this directory, you can run the following command to have a list of all installed packages:

    imcl listInstalledPackages (or imcl.exe listInstalledPackages on Windows.)

    This command will return a list of all packages installed on your machine, among which you will find the installed versions of RSA4WS, RSA or RAD, if any. For instance, if you have installed RSA4WS 8.0.4.2 on your machine, you should see the following line:



    com.ibm.rational.rsa4ws.80_8.0.4020.RSA4WSO8042-I20121203_2132

    Additionally, starting with version 1.5 of IM, you can add the -verbose option that will more explicitly state the name and version of the installed packages and make it easier for you to find your version. For instance, if you have RSA4WS 8.0.4.2 installed on your machine, you should see the following lines:


    [Package]

    Name: IBM? Rational? Software Architect for WebSphere Software (com.ibm.rational.rsa4ws.80)

    Version: 8.0.4.2 (8.0.4020.RSA4WSO8042-I20121203_2132

    For RSA or RAD the process is the same, except for the name of the packages.

With early releases of RSA and RSA4WS v8.0.x, versions 1.4.1 or 1.4.2 of IM, which did not come with theimcl command, were supported for installation. If you or any of your users are using these versions, you will have to make sure that every IM version that is installed is upgraded to at least version 1.4.3.

If upgrading IM on all the machines you are administering is not possible, you will have to write a small program that mimics what the imcl does, namely parsing the installed.xml  file to find out which version of RSA is installed.

  • Parse the installed.xml file (This method is more complex, but it does not require any specific version of IM.)

    • The installed.xml file is a file used by IM to maintain a list of all packages and features that are currently installed on your machine. This file can be found in IM installation directory. By default, this directory is located in C:\Program Files\IBM\Installation Manager\eclipse\tools on Windows or in /opt/IBM/InstallationManager/eclipse/tools on Linux


    Within this file, assuming that you have RSA4WS 8.0.4.2 installed, you should notably have a <package> tag which looks like:


     <package kind='offering' name='IBM® Rational® Software Architect  for WebSphere Software'  id='com.ibm.rational.rsa4ws.80' version='8.0.4020.RSA4WSO8042-I20121203_2132'>

    and contains, among many others, <property> tags similar to the following


    <property name='cic.info.name' value='IBM® Rational® Software Architect  for WebSphere Software'/>

          <property name='cic.info.version' value='8.0.4.2'/>



    You would then need to write a script that that parses the XML file and looks for its property cic.info.version for each package named IBM® Rational® Software Architect  for WebSphere Software.


    You could then display the full name (using the cic.info.name value) of each RSA4WS instance installed on the machine and its exact version.

    If you also have versions of RSA or of RAD, the process would be the same, but the name of the package to look for would be different.


Note that if you have several versions of the same product installed on your machine, both methods will enable you to find all installed versions.

Related Information

Command-line arguments for imcl

[{"Product":{"code":"SSYK2S","label":"Rational Software Architect Designer"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"},{"code":"PF016","label":"Linux"}],"Version":"8.5.1;8.5;8.0.4.2;8.0.4.1;8.0.4;8.0.3;8.0.2;8.0.1;8.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SS4JCV","label":"Rational Software Architect for WebSphere Software"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.0;8.0.1;8.0.2;8.0.3;8.0.4;8.0.4.1;8.0.4.2;8.5;8.5.1","Edition":"","Line of Business":{"code":"LOB15","label":"Integration"}},{"Product":{"code":"SSRTLW","label":"Rational Application Developer for WebSphere Software"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.0;8.0.1;8.0.2;8.0.3;8.0.4;8.0.4.1;8.0.4.2;8.5;8.5.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
10 September 2020

UID

swg21634993

Page Feedback