IBM Rational Method Composer, Version 7.2

Installation guide

Overview

You can find the most recent version of this document online at the IBM Publications center, including updated translation versions.

IBM Installation Manager

Regardless of which installation scenario you follow to install Rational Method Composer on your workstation, use Installation Manager to install your Rational^(R) package.

IBM Installation Manager offers a number of time-saving features. It keeps track of what you are about to install, software components that you have already installed, and components that are available for you to install. It searches for updates so you know that you are installing the latest version of a Rational product package. Installation Manager also provides tools for managing licenses for the product packages that it installs. It provides tools for updating and modifying packages. You can also use it to uninstall product packages.

IBM Installation Manager comprises five wizards that make it easy to maintain your product packages through their lifecycles:

• The Install Packages wizard walks you through the installation process. You can install a product package by simply accepting the defaults, or you can modify the default settings to create a custom installation. Before you install a product package, you are provided with a complete summary of the selections that you have made throughout the wizard. With the wizard you can install one or more product packages at the same time.
• The Update Packages wizard searches for available updates to product packages that you have installed. An update might be a released fix, a new feature, or a new version of the Rational product. Details of the contents of the update are provided in the wizard. You can choose whether to apply an update.
• With the Modify Packages wizard, you can modify specific elements of a package that you have already installed. During your initial installation of the product package, you select the features you want to install. If you find later that you require other features, you can use the Modify Packages wizard to add them to your product package installation. You can also remove features, and add or remove languages.

• The Manage Licenses wizard helps you to set up the licenses for your packages. Use this wizard to change your trial license to a full license, to set up your servers for floating licenses, and to select which type of license to use for each package.
• The Uninstall Packages wizard helps you to remove a product package from your computer. You can uninstall more than one package at a time.

Installation requirements

Hardware requirements

Software requirements

Operating system

The following operating systems are supported for this product:

• Microsoft Windows^(R) XP Professional with Service Pack 1 or 2
• Microsoft Windows 2000 Professional with Service Pack 4
• Microsoft Windows 2000 Server with Service Pack 4
• Microsoft Windows 2000 Advanced Server with Service Pack 4
• Microsoft Windows Server 2003 Standard Edition with Service Pack 1 and Service Pack 2
• Microsoft Windows Server 2003 Enterprise Edition with Service Pack 1 and Service Pack 2
• Microsoft Windows Vista Business, Enterprise, or Ultimate editions
• Red Hat Enterprise Linux^(R) Workstation Version 4.0 (update 4 or 5)
• Red Hat Desktop Version 4.0 (running in 32-bit mode) (update 4 or 5)
• SUSE Linux Enterprise Server (SLES) Version 9 (all service packs; running in 32-bit mode)
• SUSE Linux Enterprise Server (SLES) Version 10 and Service Pack 1

The listed operating systems support all supported languages.

Browsers

The following browsers are supported:

• Internet Explorer 5.5 with Service Pack 2
• Internet Explorer 6.0 with Service Pack 1
• Internet Explorer 7.0
• Mozilla 1.7.12 or later
• Firefox 1.5.0.6 or later
• Firefox 2.0.0.4 or later

BIRT reporting

The following software is required if you are using BIRT reporting:

• Microsoft Word 2003 or 2007
• Adobe Reader 6 or later

User privileges requirements

• Your user ID must not contain double-byte characters.

Planning to install

If you are upgrading from a previous release of Rational Method Composer, see Upgrading Rational Method Composer for important information before you install Rational Method Composer 7.2.

Installation scenarios

The following are some of the factors that might determine your installation scenario:

• The location for your installation (for example, you can install the product onto your own workstation, or make the installation files available to your enterprise}.
• The type of installation (for example, you can use the Installation Manager GUI, or install silently).

These are the typical installation scenarios you might follow:

• Installing from a DVD.
• Installing from a downloaded electronic image on your workstation.
• Installing from an electronic image on a shared drive.

Note that in the latter three scenarios you can choose to run the Installation Manager program in silent mode to install. For details on running Installation Manager in silent mode, see Installing silently.

Note also that you can install updates at the same time that you install the base product package.

Installing from DVDs

In this installation scenario, you have the DVDs that contain the product package files, and typically you are installing Rational Method Composer on your own workstation.

Installing from a downloaded electronic image on your workstation

In this scenario, you have downloaded the installation files from IBM Passport Advantage^(R) and you will install for an overview of the steps.

Installing from an electronic image on a shared drive

In this scenario, you will place the electronic image on a shared drive so that users in your enterprise can access the installation files for from a single location.

Installation repositories

If the launchpad is used to start Rational Method Composer, the repository information is passed to Install Manager.

By default, IBM Install Manager uses an embedded URL in each Rational software development product to connect to a repository server over the Internet. Installation Manager then searches for the product packages as well as new features.

Setting repository preferences in Installation Manager

To add, edit, or remove a repository location in Installation Manager:

1. Start Installation Manager.
2. On the Start page of Installation Manager, click File -> Preferences, and then click Repositories. The Repositories page opens, showing any available repositories, their locations, and whether they are accessible.
3. On the Repositories page, click Add Repository.
4. In the Add repository window, type the URL of the repository location or browse to it and set a file path.
5. Click OK. If you provided a HTTPS repository location, then you will be prompted to enter a user ID and password. The new or changed repository location is listed. If the repository is not accessible, a red x is displayed in the Accessible column.
6. Click OK to exit.

Verifying and extracting electronic images

You can compare the published MD5 values with the checksum of the downloaded files to check if the downloaded file is corrupt or incomplete.

Extracting the downloaded files

Extract each compressed file to the same directory.

Preinstallation tasks

1. Confirm that your system meets the requirements described in the section Installation requirements.
2. Confirm that your user ID meets the required access privileges for installing the product. See User privileges requirements.
3. Read the section Planning to install.

Installation tasks

The following sections provide an overview of the installation scenarios that are described in the section Installation scenarios. You can access detailed instructions from links in the main steps.

Installing Rational Method Composer from DVD: task overview

The following are the general steps for installing from DVD:

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. Insert the DVD into your DVD drive.
3. For Linux: Mount the DVD drive.
4. If autorun is enabled on your system, the launchpad program automatically opens. If autorun is not enabled, start the launchpad program. Refer to Starting the launchpad program for details.
5. Start the installation of Rational Method Composer from the launchpad. For details, see Starting an installation from the launchpad program.
6. Follow the on-screen instructions in the Install Packages wizard to complete the installation.

Installing Rational Method Composer from an electronic image on your workstation: task overview

The following are the general steps for installing Rational Method Composer from an electronic installation image:

1. Ensure that your workstation has sufficient space to store both the files you must download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements.
2. Download all required parts for the product image from IBM Passport Advantage to a temporary directory.
3. Extract the installation image from the downloaded file and verify that the installation image is complete. See Verifying and extracting electronic images for details.
4. Continue with the steps in Installing from an electronic image below.

Installing from an electronic image

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. Start the launchpad program. Refer to Starting the launchpad program for details.
3. Start the installation of Rational Method Composer from the Launchpad. For details, see Starting an installation from the launchpad program.
4. Follow the on-screen instructions in the Install Packages wizard to complete the installation.

Installing Rational Method Composer from an electronic image on a shared drive: task overview

The following steps are performed by the person who places the installation image on a shared drive.

1. Ensure that your shared drive has sufficient disk space to store both the files you must download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements for details.
2. Download all required parts for the product image from IBM Passport Advantage to a temporary directory on the shared drive.
3. Extract the installation image from the downloaded files into an accessible directory on the shared drive and verify the installation image is complete. See Verifying and extracting electronic images for details.

To install Rational Method Composer from the installation files on the shared drive:

1. Change to the disk1 directory on the shared drive containing the installation image.
2. Follow the steps in Installing from an electronic image.

Managing licenses

The trial license that comes with IBM Rational Method Composer expires 30 days after installation. You need to activate IBM Rational Method Composer in order to use it after the expiration date. Using the Manage Licenses wizard, you can upgrade a trial version of IBM Rational Method Composer to a licensed version by importing a product activation kit.

For more information on managing licenses for your Rational product, see the Rational licensing support page at http://www-306.ibm.com/software/rational/support/licensing/.

Installing Tivoli Unified Process

IBM Tivoli^(R) Unified Process (ITUP) is not installed as part of the Rational Method Composer installation. You need to manually copy the ITUP files in your required language onto your machine.

Installing ITUP Libraries

Follow these steps to install ITUP libraries.

1. Create a folder to hold the desired library.
2. Copy the desired library file from the CD-ROM or CD image. For example, to install the French library, unzip the file ITUP_content_fr.zip from the content folder on the CD-ROM into the folder you created.
3. Start IBM Rational^(R) Method Composer and open the ITUP library.

Installing ITUP published sites

1. Create a folder to hold the desired published site.
2. Copy the desired published site file from the CD-ROM. For example, to install the French published site unzip the file ITUP_published_fr.zip from the published folder on the CD-ROM into the new folder you created.
3. To view the published site, open index.htm in the new folder using your web browser.

Managing IBM Installation Manager

This section deals with some common tasks relating to IBM Installation Manager. For more information, see the Installation Manager online help.

Installing Installation Manager on Windows

If you start the installation of your product from the launchpad program, then the installation of IBM Installation Manager is started automatically if it is not already installed on your workstation. (For more information on this process, refer to Installing from the launchpad program.) In other cases, you must manually start the installation of Installation Manager.

To start the installation of Installation Manager manually:

1. Run install.exe from the InstallerImager_win32 folder on the first installation disk.
2. Click Next on the Welcome screen.
3. Review the license agreement on the License Agreement page and select I accept the terms in the license agreement to accept. Click Next.
4. Click the Change button on the Destination Folder page to change the installation location if required. Click Next.
5. Click Next on the Setup Type page.
6. Click Install on the Ready to Install Program page. The Completed page opens after the installation is complete.
7. Click Finish.

Starting Installation Manager on Windows

IBM Installation Manager should be started from the launchpad program. Doing so starts Installation Manager with a configured repository preference and selected Rational Method Composer packages. If you start Installation Manager directly, then you must set a repository preference and choose product packages manually.

To start Installation Manager manually:

1. Open the Start menu from the Taskbar.
2. Select All Programs -> IBM Installation Manager -> IBM Installation Manager.

Uninstalling Installation Manager on Windows

To uninstall Installation Manager manually:

1. Run installlc.exe from the InstallerImager_win32 folder on the first installation disk.
2. Click Next on the Welcome screen.
3. Select the Remove button on the Program Maintenance page. Click Next.
4. Click Next on the Setup Type page.
5. Click Remove on the Remove the Program page.
6. Click Finish on the InstallShield Wizard Completed page.

Silently installing and uninstalling Installation Manager

Silently installing Installation Manager on Windows

To silently install Installation Manager onto a default install location on Windows:

1. Change directory to InstallerImage_win32 folder on the first installation disk.
2. Run setup.exe /S /v"/qn"

If you want to change the install location, you can add the INSTALLDIR property inside the /v option. For example: setup.exe /S /v"/qn INSTALLDIR=\"C:\InstallationManager\""

Silently uninstalling Installation Manager from Windows

To silently uninstall Installation Manager on Windows:

1. From a command line, go to the uninstall directory for the Installation Manager. By default, this is C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\uninstall.
2. Enter the following command: uninstallc.exe --launcher.ini silent-uninstall.ini

Installing from the launchpad program

Use the launchpad program to start the installation in the following cases:

• Installing from the product DVDs.
• Installing from an electronic image on your workstation.
• Installing from an electronic image on a shared drive.

By starting the installation process from the launchpad program, IBM Installation Manager is automatically installed if it is not already on your computer, and it starts preconfigured with the location of the repository that contains the Rational Method Composer package. If you install and start Installation Manager directly, then you must set repository preferences manually.

To install from the launchpad:

1. Complete the preinstallation tasks described in Preinstallation tasks, if you have not done so already.
2. Start the launchpad program. See Starting the launchpad program.
3. Start the installation of Rational Method Composer. See Starting an installation from the launchpad program.

Follow the on-screen instructions in the Install Packages wizard to complete the installation.

Starting the launchpad program

Complete the preinstallation tasks described in Preinstallation tasks, if you have not done so already.

If you are installing from a DVD and autorun is enabled on your workstation, then the launchpad starts automatically when you insert the first installation disc into your DVD drive. If you are installing from an electronic image, or if autorun is not configured on your workstation, then you must start the launchpad program manually.

To start the launchpad program:

1. Insert the Rational Method Composer DVD into your DVD drive. For Linux: Ensure that you have mounted the DVD drive.
2. If autorun is enabled on your system, the launchpad program automatically opens. If autorun is not enabled on your system:
   • For Windows: Run launchpad.exe located in the root directory of the DVD.
   • For Linux: Run launchpad.sh located in the root directory of the DVD.

Starting an installation from the launchpad program

1. Start the launchpad program.
2. If you have not done so already, read the release information by clicking Release notes.
3. When you are ready to begin the installation, click Install Rational Method Composer.
4. A message window opens to inform you whether the program IBM Installation Manager is detected on your workstation.
   • If IBM Installation Manager is not detected on your system, then you are informed that you must install it before you can continue.
     1. Click OK to install IBM Installation Manager. The installation wizard starts.
     2. Follow the on-screen instructions in the wizard to complete the installation. Refer to Installing Installation Manager on Windows for more information.
     3. When the installation of completes successfully, click Finish to close the wizard.
     4. Read the message that opens and click OK.
   • If IBM Installation Manager is detected on your system, click OK and it starts and automatically opens the Install Packages wizard.
5. Follow the on-screen instructions in the Install Packages wizard to complete the installation.

Installing Rational Method Composer using the IBM Installation Manager graphical interface

Depending on the installation scenario that you are following, the Install Packages wizard might start automatically. In other scenarios, you will need to start the wizard.

1. If the Install Packages wizard did not start automatically, then start it:
   1. Start the Installation Manager.
   2. From the Start page, click Install Packages.
      Note:
      If a new version is found, you are prompted to confirm that you want to install it before you can continue. Click OK to proceed. Installation Manager automatically installs the new version, stops, restarts, and resumes.
      When Installation Manager starts, it searches its defined repositories for available packages.
2. The Install page of Install Packages wizard lists all the packages found in the repositories that are searched. If two versions of a package are discovered, only the most recent, or recommended, version of the package is displayed.
   • To display all versions of any package found, click Show all versions.
   • To return to the display of only the recommended packages, click Show only recommended.
3. Click the Rational Method Composer package to display its description in the Details pane.
4. To search for updates to the package, click Check for updates.
   Note:
   For Installation Manager to search the predefined IBM update repository locations for the installed packages, the preference Search the linked repositories during installation and updates on the Repositories preference page must be selected. This preference is selected by default. Internet access is also required.
   Installation Manager searches for updates at the predefined IBM update repository for the product package. It also searches any repository locations that you have set. A progress indicator shows the search is taking place. You can install updates at the same time that you install the base product package.
5. If updates for the package are found, then they will be displayed in the Installation Packages list on the Install Packages page below their corresponding product. Only recommended updates are displayed by default.
   • To view all updates found for the available packages, click Show all versions.
   • To display a package description under Details, click on the package name. If additional information about the package is available, such as a readme file or release notes, a More info link is included at the end of the description text. Click the link to display the additional information in a browser. To fully understand the package you are installing, review all information beforehand.
6. Select the package and any updates to the package that you want to install. Updates that have dependencies are automatically selected and cleared together. Click Next to continue.
   Note:
   If you install multiple packages at the same time, then all the packages will be installed into the same package group.
7. On the Licenses page, read the license agreement for the selected package. If you selected more than one package to install, there might be a license agreement for each package. On the left side of the License page, click each package version to display its license agreement. The package versions that you selected to install (for example, the base package and an update) are listed under the package name.
   1. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements.
   2. Click Next to continue.
8. On the Location page, type the path for the shared resources directory in the Shared Resources Directory field; or accept the default path. The shared resources directory contains resources that can be shared by one or more package groups. Click Next to continue.
   Important:
   You can specify the shared resources directory only the first time that you install a package. Use your largest disk for this to help ensure adequate space for the shared resources of future packages. You cannot change the directory location unless you uninstall all packages.
9. On the Location page, either choose an existing package group to install the package into, or create a new one. A package group represents a directory in which packages share resources with other packages in the same group. To create a new package group:
   1. Click Create a new package group.
   2. Type the path for the installation directory for the package group. The name for the package group is created automatically. For Windows other than Vista, the default path is: C:\Program Files\IBM\RMC72. For Windows Vista the default path is: C:\Program Files_IBM\RMC72. For Linux the default path is: /opt/IBM/RMC72.
   3. Click Next to continue.
10. On the Features page under Languages, select the languages for the package group. The corresponding national language translations for the user interface and documentation for the package will be installed as well as the English and native library 7.2. Note that your choices apply to all packages installed under this package group. The RUP library and published sites are installed for the selected languages.
11. On the Summary page, review your choices before installing the package. If you want to change the choices that you made on previous pages, click Back and make your changes. When you are satisfied with your installation choices, click Install to install the package. A progress indicator shows the percentage of the installation completed.
12. When the installation process is complete, a message confirms the success of the process.
    1. Click View log file to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
    2. In the Install Package wizard, select whether you want to start when you exit.
    3. Click Finish to launch the selected package. The Install Package wizard closes and you are returned to the Start page.

Installing silently

Running Installation Manager in silent mode is helpful because it enables you to use a batch process to install, update, modify and uninstall product packages through scripts.

Note that you must install Installation Manager before you can silently install the Rational Method Composer package. Refer to Managing IBM Installation Manager for details on installing Installation Manager or Silently installing and uninstalling Installation Manager.

There are two main tasks required for silent installation:

1. Create the response file.
2. Run Installation Manager in silent installation mode.

Creating a response file

To record a response file for installation (or uninstallation):

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager. For example:
   • For Windows: cd C:\Program Files\IBM\Installation Manager\eclipse
   • For other platforms: cd /opt/IBM/InstallationManager/eclipse
2. On a command line, type the following command to start the Installation Manager, substituting your own file name and location for the response file and (optionally) the log file:
   • IBMIM -record <response file path and name> -log <log file path and name>. For example, IBMIM.exe -record c:\mylog\responsefile.xml -log c:\mylog\record_log.xml
   • You can record a response file without installing or uninstalling a product by adding the optional -skipInstall <agentDataLocation> argument. Note that <agentDataLocation> must be a writable directory. The argument causes the Installation Manager to save the installation data without installing the product. You can use the same <agentDataLocation> in the next recording session to record updates or modifications to the product, or to record license management. Note that the products installed or preferences, including repository settings, that you may have set on install when not using the -skipInstall argument are not be stored. Using -skipInstall will make installation faster because the IM is not installing the product, it is just recording the installation data.

     The syntax for using the skipInstall argument is: IBMIM -record <response file path and name> skipInstall <a writable directory for agent data location>. For example IBMIM -record c:\mylog\responsefile.xml -skipInstall c:\temp\recordData

   If you are recording without installing or uninstalling, continue through the wizard, then close the Installation Manager to create the file.

   Note:
   Ensure the file paths you enter exist; Installation Manager will not create directories for the response file and the log file.
3. Follow the on-screen instructions in the Install Packages wizard to make your installation choices, stopping when you reach the Summary page. For details, see Installing Rational Method Composer using the IBM Installation Manager graphical interface.
4. Click Install, and then when the installation process begins click Cancel.
5. Click Finish, then close Installation Manager.

An XML response file is created and resides in the location specified in the command.

Recording a response file with the Installation Manager installer

To record the installation of Installation Manager, follow these steps:

1. Unzip the Installation Manager, then go to the eclipse directory.
2. To start recording, enter install -record <response file path and name> -skipInstall <agentDataLocation> -vmargs -Dcom.ibm.cic.agent.hidden=false

Recording a product install with the installer

To start recording a product install with the installer:

1. Go to the eclipse directory
2. Open the install.ini file by removing the following lines: -input, @osgi.install.area/install.xml
3. Enter the following command: install -record <response file path and name> -skipInstall <agentDataLocation>, for example: install -record

Installing and running Installation Manager in silent mode

Refer to the Installation Manager Web site for additional documentation on how to run it in silent mode. For example, silently installing from a repository that requires authentication (user ID and password).

The following table describes the arguments used with the silent installation command:

-nosplash

--launcher.suppressErrors

-input

-log

Both the Installation Manager installer and the Installation Manager have an initialization or .ini file silent-install.ini that includes default values for the arguments in the table.

The Installation Manager installer is used to install the Installation Manager. Follow these steps to install the Installation Manager silently.

To install Installation Manager silently, unzip the installer and switch to the eclipse subdirectory, then use the following commands:

• For Windows: installc --launcher.ini silent-install.ini -log <log file path and name> . For example: installc --launcher.ini silent-install.ini -log c:\mylogfile.xml
• For other platforms: install --launcher.ini silent-install.ini -log <log file path and name>. For example, install --launcher.ini silent-install.ini -log /root/mylogs/mylogfile.xml

After Installation Manager is installed, you can use it to install other products. You can also use the Installation Manager installer to install the products.

To run Installation Manager in silent mode run the following command from the eclipse subdirectory:

• For Windows: IBMIMc.exe --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: IBMIMc.exe --launcher.ini silent-install.ini -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml
• For other platforms: IBMIM --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: IBMIM --launcher.ini silent-install.ini -input /root/mylog/responsefile.xml -log /root/mylog/silent_install_log.xml

If you want to silently install products using the Installation Manager installer, from the eclipse directory, enter the following command:

• For Windows: installc.exe --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: installc --launcher.ini silent-install.ini -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml
• For other platforms: install.exe --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: IBMIM --launcher.ini silent-install.ini -input /root/mylog/responsefile.xml -log /root/mylog/silent_install_log.xml

When the Installation Manager installer, or Installation Manager runs in silent installation mode; it reads the response file and writes a log file to the directory you specified. While you must have a response file when running in silent installation mode, log files are optional. The result of this execution should be a status of 0 on success and non-zero number on failure.

Searching for and silently installing all available products

To search for and silently install all available products:

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:
   • For Windows: IBMIMc.exe --launcher.ini silent-install.ini -installAll -log <log file path and name>
   • For other platforms: IBMIM --launcher.ini silent-install.ini -installAll -log <log file path and name>

All available products known to Installation Manager are installed.

Silently installing updates to all currently installed products

To search for and silently install updates for all available products:

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:
   • For Windows: IBMIMc.exe --launcher.ini silent-install.ini -updateAll -log <log file path and name>
   • For other platforms: IBMIM --launcher.ini silent-install.ini - -updateAll -log <log file path and name>

All available product updates known to Installation Manager are installed.

Response file commands

There are two categories of commands for the response file:

• Preference commands are used to set preferences that are found in Installation Manager under File -> Preferences, such as repository location information.
• Silent installation commands are used to emulate the Install Packages wizard in Installation Manager.

Silent installation preference commands

When you define preferences in a response file, your XML code will look similar to the following example:

<preference>
	name = "the key of the preference"
	value = "the value of the preference to be set" 
</preferences>

Use the following table to identify keys and their associated values for silent installation preferences:

Silent installation commands

<profile 
id="the profile (package group) id" 
installLocation="the install location of
 the profile">
<data key="key1" value="value1"/>
<data key="key2" value="value2"/>

</profile>

<server>
<repository location="http://example/
repository/">
<repository location="file:/C:/
repository/">
<!--add more repositories below-->
<...>
      </server>

<install>
<offering profile= "profile id" 
features= "feature ids" 
id= "offering id" version= "offering 
version"></offering>

<!--add more offerings below>
<...>

</install>

<uninstall modify="true">
<offering profile="profileID"
 id="Id" version="Version" 
features="-"/>
</uninstall>

<uninstall>
<offering profile= "profile id" 
features= "feature ids" 
id= "offering id" version= "offering 
version"></offering>

<!--add more offerings below>
<...>

</uninstall>

<rollback>
<offering profile= "profile id"
 id= "offering id" 
version= "offering version">
</offering>

<!--add more offerings below
<...>

</rollback>

<installALL/>

-silent -installAll 

<updateALL/>

-silent -updateAll 

<license policyFile="policy file
 location"/>

<license policyFile="c:\mylicense.opt"/> 

<launcher -mode wizard -input 
< response file >

Reference: Sample response file

<agent-input >

<!-- add preferences -->
<preference name="com.ibm.cic.common.core.preferences. http.proxyEnabled" 
value="c:/temp"/>

<!-- create the profile if it doesn't exist yet -->
<profile id="my_profile" installLocation="c:/temp/my_profile"></profile>

<server>
<repository location= 
"http://a.site.com/local/products/sample/20060615_1542/repository/"></repository>
/server>

<install>
	<offering profile= "my_profile" features= "core" id= "ies" 
version= "3.2.0.20060615">
	</offering>
/install>

</agent-input>

Silent install log files

The silent installation functionality creates an XML-based log file that records the result of the silent install execution (as long as a log file path is specified using -log <your log file path>.xml). If your silent installation session is successful, the log file will contain just the root element of <result> </result>. However, if errors occur during the installation, the silent install log file will contain error elements with messages such as:

<result>
	<error> Cannot find profile: profile id</error>
	<error> some other errors</error>
</result>

For detailed analysis, you can look at the logs generated in the Installation Manager data area. By using a preference command, you can optionally set the data area to your preferred location, as shown in the response file topic.

Uninstalling Rational Method Composer

To uninstall the packages, you must log in to the system using the same user account that you used to install the product packages.

To uninstall the packages:

1. Close the programs that you installed using Installation Manager.
2. On the Start page click Uninstall Packages.
3. In the Uninstall Packages page, select the Rational Method Composer product package that you want to uninstall. Click Next.
4. In the Summary page, review the list of packages that will be uninstalled and then click Uninstall. The Complete page is displayed after the uninstallation finishes.
5. Click Finish to exit the wizard.

IBM Packaging Utility

Packaging Utility software is located on the Rational Method Composer installation DVD that is included with . If you want to place a repository that contains a package on a Web server that will be available over HTTP or HTTPS, you must use Packaging Utility to copy the product package of into the repository.

Use this utility to perform the following tasks:

• Generate a new repository for product packages.
• Copy product packages to a new repository. You can copy multiple product packages into a single repository, thereby creating a common location for your organization from which product packages can be installed using IBM Installation Manager.
• Delete product packages from a repository.

Refer to the online help for Packaging Utility for full instructions for using the tool.

Installing Packaging Utility

Use the following steps to install IBM Packaging Utility software:

1. Navigate the to the Rational Method Composer DVD.
2. Locate the Packaging Utility installation files.
3. Change to the PackagingUtility directory on the Rational Method Composer DVD, or, if you downloaded an electronic image, go to the location to which you extracted it.
4. Extract the Packaging Utility installation files into a single directory. Ensure that you preserve the directory structure of the compressed files.
   • For Windows: Extract the contents of the pu.disk_win32.zip file.
   • For Linux: Extract the contents of the pu.disk_linux.zip file.
5. Change to the directory where you extracted the Packaging Utility installation files and start the installation program.
   • For Windows: Run install_win32.exe.
   • For Linux: Run install_linux.bin.
6. If IBM Installation Manager is not detected on your workstation, you are prompted to install it and then the installation wizard starts. Follow the on-screen instructions in the wizard to complete the installation of Installation Manager. See Installing Installation Manager on Windows for details.
7. When the installation of Installation Manager completes, or if it is already on your computer, Installation Manager starts and automatically begins the Install Packages wizard.
8. Follow the on-screen instructions in the Install Packages wizard to complete the installation.

Copying product packages to an HTTP server using Packaging Utility

Note also that Packaging Utility can be used to combine multiple product packages into a single repository location. Refer to the Packaging Utility online help for more information.

To copy product packages with Packaging Utility:

1. Start Packaging Utility.
2. On the main page of the utility, click Copy product package. The Prerequisite page opens, and presents two options:
   • I will be downloading product packages from IBM Web
   • I will be obtaining the product packages from other sources
3. Click I will be downloading product packages from IBM Web.
   Note:
   You can use the I will be obtaining the product packages from other sources option if you have already defined an accessible repository.
4. Click Next to advance to the Source page. If there are no product packages to select, you must open a repository that contains product packages.
5. To open a repository, click the Open repository button. The Open Repository window opens.
   Note:
   A repository can be a path to a directory in the file system, a disk drive containing the first CD or DVD of the product, or a URL to a directory on a server.
6. To define a repository location, click the Repository Location Browse button, and then navigate to and select the Repository location - either the common root directory that contains the electronic disk images or the drive containing the first product installation CD or DVD. For example, if the files (disk1, disk2, and so on) reside in C:\My product\unzip, you should define this location as a repository.
7. Click OK to define the repository location and to close the Browse to a repository directory window.
8. On the Destination page, click the Browse button and select an existing repository directory, or create a new folder to store the products.
9. After you specify a repository for the selected product packages and any fixes, click OK to close the Browse to a directory window. The file path that you just defined is listed in the Directory field on the Destination page.
10. Click Next to advance to the Summary page. The Summary page displays the selected product packages that will be copied into the destination repository. This page also lists the amount of storage space that the copy requires, as well as the amount of available space on the drive.
11. Click Copy to copy the selected product packages to the destination repository. A status bar opens at the bottom of the wizard indicating how much time is remaining in the copy process. After the copy process is finished, a Complete page opens and displays all of the product packages that were copied successfully.
12. Click Done to return to the Packaging Utility main page.

Now that you have used Packaging Utility to copy the installation files into a repository, you can place the repository on a Web server and make the directories and files available over HTTP. (The repository can also be placed on a UNC drive.)

Managing licenses

The trial license that comes with IBM Rational Method Composer expires 30 days after installation. You need to activate IBM Rational Method Composer in order to use it after the expiration date. Using the Manage Licenses wizard, you can upgrade a trial version of IBM Rational Method Composer to a licensed version by importing a product activation kit.

For more information on managing licenses for your Rational product, see the Rational licensing support page at http://www-306.ibm.com/software/rational/support/licensing/.

Licenses

Authorized User License

An IBM Rational Authorized User license permits a single, specific individual to use a Rational software product. Purchasers must obtain an Authorized User license for each individual user who accesses the product in any manner. An Authorized User license cannot be reassigned unless the purchaser replaces the original assignee on a long-term or permanent basis.

For example, if you purchase one Authorized User license, you can assign that license to one specific individual, who can then use the Rational software product. The Authorized User license does not entitle a second person to use that product at any time, even if the licensed individual is not actively using it.

Activation kits

Product activation kits contain the permanent license key for your trial Rational product. You purchase the activation kit, download the activation kit .zip file to your local machine, and then import the activation kit .jar file to enable the license for your product. You use IBM Installation Manager to import the activation kit to your product.

License enablement

Licenses for Rational Software Development Platform offerings are enabled in two ways:

• Importing a product activation kit
• Enabling Rational Common Licensing to obtain access to floating license keys

Activation kits

Product activation kits contain the permanent license key for your trial Rational product. You purchase the activation kit, download the activation kit .zip file to your local machine, and then import the activation kit .jar file to enable the license for your product. You use IBM Installation Manager to import the activation kit to your product.

Floating license enforcement

Optionally, you can obtain floating license keys, install IBM Rational License Server, and enable Floating license enforcement for your product. Floating license enforcement provides the following benefits:

• License compliance enforcement across the organization
• Fewer license purchases
• Serve license keys for IBM Rational Team Unifying and Software Development Platform desktop products from the same license server

For more information on obtaining activation kits and Floating licenses, see Purchasing licenses.

Viewing license information for installed packages

To view license information:

1. Start IBM Installation Manager.
2. On the main page, click Manage Licenses.

The package vendor, current license types, and expiration dates are displayed for each installed package.

Importing a product activation kit

If you have not purchased an activation kit, you must do this first. If you have purchased a product or a product activation kit, insert the appropriate CD or download the activation kit from IBM Passport Advantage to an accessible workstation. The activation kit is packaged as a .zip file containing a Java^(TM) archive (.jar) file. The .jar file contains the permanent license key and must be imported to activate your product.

To import an activation kit .jar file and enable the new license key:

1. Start IBM Installation Manager.
2. On the main page, click Manage Licenses.
3. Select a package and click the Import Activation Kit button.
4. Click Next. Details for the selected package are shown, including the current license kind and the product version range of the license.
5. Browse to the path on the media CD or download location for the activation kit; then select the appropriate Java archive (JAR) file and click Open.
6. Click Next. The Summary page displays the target install directory for the activation kit, the product the new license applies to, and version information.
7. Click Finish.

The product activation kit with its permanent license key is imported to the product. The Manage Licenses wizard indicates whether the import is successful.

Purchasing licenses

To purchase licenses and enable your product, complete the following steps:

1. Determine the type of license you want to purchase.
2. Go to ibm.com^(R) or contact your IBM sales representative to purchase the product license. For details, visit the IBM Web page on How to buy software.
3. Depending on the type of license you purchase, use the Proof of Entitlement you receive and do one of the following to enable your product:
   • If you purchase Authorized User licenses for your product, go to Passport Advantage and follow the instructions there for downloading your product activation kit .zip file. Once you have downloaded the activation kit, you must import the product activation .jar file using Installation Manager.

When you want to import the activation kit for IBM Rational Method Composer, use the Manage Licenses wizard in IBM Installation Manager.

Increasing the number of file handles on Linux workstations

Important: For best results, before you work with your Rational product, increase the number of file handles available for , because it uses more than the default limit of 1024 file handles per process. (A system administrator might need to make this change.)

Exercise caution when using the following these steps to increase your file descriptors on Linux. Failure to follow the instructions correctly might result in a computer that will not start correctly. For best results, have your system administrator perform this procedure.

To increase your file descriptors:

1. Log in as root. If you do not have root access you will need to obtain it before continuing.
2. Change to the etc directory
3. Use the vi editor to edit the initscript file in the etc directory. If this file does not exist, type vi initscript to create it.

   Important: If you decide to increase the number of file handles, do not leave an empty initscript file on your computer. If you do so, your machine will not start up the next time that you turn it on or restart.

4. On the first line, type ulimit -n 4096 (the key here is that the number is significantly larger than 1024, the default on most Linux computers). Caution: do not set this too high, because it can seriously impact system-wide performance.
5. On the second line, type eval exec "$4".
6. Save and close the file after making sure you have done steps 4 and 5.
   Note:
   Ensure you have followed the steps correctly, as not doing this correctly will result in a machine that does not boot.
7. Optional: Restrict your users or groups by modifying the limits.conf file in the etc/security directory. Both SUSE Linux Enterprise Server (SLES) Version 9 and Red Hat Enterprise Linux Version 4.0 have this file by default. If you do not have this file, you might consider a smaller number in step 4 above (for example, 2048). You need to do this so that most users have a reasonably low limit on the number of allowable open files per process. If you used a relatively low number in step 4, it is less important to do this. However, if you choose to set a high number in step 4, refraining from establishing limits in the limits.conf file can seriously impact computer performance.

   The following is a sample limits.conf file would look that restricts all users and then sets different limits for others afterwards. This sample assumes you set descriptors to 8192 in step 4 earlier.

   *      soft nofile 1024
   *      hard nofile 2048
   root    soft nofile 4096
   root    hard nofile 8192
   user1   soft nofile 2048
   user1 hard nofile 2048
   

   Note that the * in the example above sets the limits for all users first. These limits are lower than the limits that follow. The root user has a higher number of allowable descriptors open, while user1 is in between the two. Make sure you read and understand the documentation contained within the limits.conf file before making your modifications.

For more information on the ulimit command, refer to the man page for ulimit.

Upgrading Rational Method Composer

The first is if you are upgrading from Rational Method Composer 7.0, 7.0.1, 7.1, or 7.1.1 and have created your own method library or made changes to the Rational library with Rational Method Composer version 7.0, 7.0.1, 7.1 or 7.1.1. You will need to manually update your library or libraries. After a library is updated, you can no longer use it with an earlier version of Rational Method Composer.

This section also explains how you can update your existing library with the updated Rational Method Composer method plug-ins included with this release.

During installation, new versions of the method plug-ins are copied into a directory called exported_libraries\library.72.

The second case is if you are upgrading a library from 7.1.0 or 7.1.1 to 7.2 and the library is under configuration management control. When you open a library created in an earlier release of Rational Method Composer and that library is not under source control, the Rational Method Composer upgrade tool will ask you whether to automatically upgrade the library. If you accept, the upgrade is taken care of for you automatically and you do not need to follow the procedures described here.

To update an existing Rational Method Composer library

1. Before starting IBM Rational Method Composer, make a copy of your existing library. (see Uninstalling IBM Rational Method Composer for detailed instructions).
2. Start Rational Method Composer and open your existing library. You will be warned that the library needs to be upgraded and asked if you want to proceed. Click Yes.
3. You will be asked if you want to backup your library before proceeding. If you did not backup your library in step 1, do it now by clicking Yes. If you are sure you have a backup, click Skip.
4. Your library has now been updated.

To update a customized library

If you have added your own content to your library and you want to update it with the latest content from Rational, do the following:

1. Start IBM Rational Method Composer and open your existing library.
2. Select File->Import. This starts the Import wizard.
3. Select Library Configuration and click Next.
4. Browse to the following location: /exported_libraries/library_72. Click OK and then Next.
5. If any of the original plug-ins in your library are locked, you will be given a warning and asked to continue. Click OK.
6. You will see a report of the versions of plug-ins and content packages that are in the import and corresponding items in the library. To proceed with the import click Finish.
7. If you do not have a backup copy of your current library it is advisable to make a backup copy before importing the plug-ins. Click OK when asked to make a backup copy of your library.
8. The plug-ins are imported into your library and replace the earlier versions.

Notices

(C) Copyright IBM Corporation 2000, 2007. All rights reserved.

Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this Documentation and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

Trademarks and service marks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

• AIX^(R)
• ClearCase^(R)
• developerWorks^(R)
• IBM
• ibm.com
• iSeries^(TM)
• MultiSite
• MVS^(TM)
• OS/390^(R)
• OS/400^(R)
• Passport Advantage
• POWER5^(TM)
• PowerPC^(R)
• pSeries^(R)
• Rational
• RS/6000^(R)
• WebSphere^(R)
• z/OS^(R)
• zSeries^(R)

Intel^(R), Itanium^(R), and Pentium^(R) are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.

UNIX^(R) is a registered trademark of The Open Group in the United States and other countries.

Other company, product or service names, may be trademarks or service marks of others.