How to install custom plug-ins on Rational Software Architect as an administrator in a multi-user install

Technote (FAQ)


Question

How should you install custom plug-ins on IBM Rational Software Architect as administrator, in a multi-user install, where you intend to make the installation directory read-only for regular users?

Cause

When you launch IBM Installation Manager in order to install IBM Rational Software Architect, you can choose to install as an administrator (using the command install or  installc ), or as a single user (using the command userinst or userinstc ).

Comparing these two cases with the Eclipse 3.6 Help page Eclipse Multi-User installs:

- installing as administrator corresponds to Scenario #3 - shared configuration
- installing as single user corresponds to Scenario #1 - private install

IBM Installation Manager invokes Rational Software Architect with the Eclipse -initialize command; the Scenario #2 - shared install never applies to Rational Software Architect installations.


The Eclipse help page states:

Updating
Shared configuration

Plug-ins can be installed in/removed from the shared configuration. Users will catch up with those changes the next time Eclipse runs. It is necessary to make sure users having the shared configuration as their master configuration are not running Eclipse.

If you install as administrator, and you intend to make the installation directory read-only for regular users, should you ever run IBM Rational Software Architect while logged-on as administrator?

Answer

By default, IBM Installation Manager prompts you to launch Rational Software Architect in the last page of the installation wizard, even when you install as administrator.

If you do not need to install any additional plug-ins, proceed as follows:

  1. Close IBM Installation Manager without launching Rational Software Architect

  2. Make the Rational Software Architect installation directory read-only for regular users

  3. Log in a regular user to test Rational Software Architect

If you need to install additional plug-ins, there are two possible workflows:

A. Use the dropins folder:

  1. Close IBM Installation Manager without launching Rational Software Architect

  2. Copy any desired plug-ins and features in the RSA_Installation_Directory>\dropins folder

  3. Make the Rational Software Architect installation directory read-only for regular users

  4. Log in as a regular user to test Rational Software Architect (the additional plug-ins will be reconciled with the rest of the platform using each regular user's configuration).

B. Use the P2 Director Application:

A common scenario for users of Rational Software Architect is to create individual plug-ins (without features) for extending the product functionality. In the following example, you will see how to install such a plug-in using the P2 Director.

Before you can install a single plug-in using P2 Director, you need to create a repository containing P2 metadata for this plug-in.

  1. Assume that you have created a plug-in called com.ibm.rational.support.profile1_1.0.0.201212061200.jar and assume that he plug-in is located C:\localRepository\plugins

  2. Create a directory that will serve as P2 metadata and artifact repository C:\p2_director\repository

  3. Generate P2 metadata with the following command (all in one line): "C:\Program Files\IBM\SDP\eclipsec.exe" -application org.eclipse.equinox.p2.publisher.FeaturesAndBundlesPublisher-metadataRepository file:c:/p2_director/repository -artifactRepository file:c:/p2_director/repository -bundles c:/localRepository/plugins -compress -publishArtifacts where:

    This will generate the following:
    C:\p2_director\repository\artifacts.jar
    C:\p2_director\repository\content.jar
    C:\p2_director\repository\plugins\com.ibm.rational.support.profile1_1.0.0.201212061200.jar


  4. Install the plug-in with the following command (all in one line): "C:\Program Files\IBM\SDP\eclipsec.exe" -application org.eclipse.equinox.p2.director -repository file:c:/p2_director/repository -installIU com.ibm.rational.support.profile1/1.0.0.201212061200 -destination "C:/Program Files/IBM/SDP" -profile bootProfile where:

Note 1: The value of the -profile parameter is bootProfile for Rational Software Architect installations.You can verify this by inspecting the directory:
C:\Program Files\IBM\SDP\p2\org.eclipse.equinox.p2.engine\profileRegistry\bootProfile.profile

Note 2: The plug-in will be added to the following location: C:\Program Files\IBM\SDP\p2\cic.p2.cache.location.

For additional information about the commands used above, see the links in the Related information section.

Related information

Eclipse Multi User Installs
Installation Manager Commands
P2 Director

Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational Software Architect Installation Linux, Windows 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
Software Development Rational Application Developer for WebSphere Software Installation Linux, Windows 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

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational Software Architect for WebSphere Software
Installation

Software 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

Operating system(s):

Linux, Windows

Reference #:

1616302

Modified date:

2013-01-28

Translate my page

Machine Translation

Content navigation