IBM Rational SoDA
Installation and Upgrade Guide
Version 7.0.2
Windows
SC23-8901-00
Note
Before using this information and the product it supports, read the information
in Notices.
8th Edition, September 2008
This edition applies to version 7.0.2 of IBM Rational SoDA (part number 5724-G53) and to all subsequent
releases and modifications until otherwise indicated in new editions. This
edition replaces IBM Rational SoDA Installation Guide GI11-6298-00 released
for Rational Suite.
Copyright International Business Machines Corporation 1995, 2008. All rights reserved.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Overview
This installation guide provides instructions for installing, updating,
and uninstalling IBM(R) Rational(R) SoDA(R).
About IBM Rational SoDA
With Rational SoDA documenters
and project managers can automate the creation of project documents
from multiple sources, such as Rational Rose and Rational RequisitePro, to
create a single document.
Installation requirements
This section details hardware, software, and user privilege requirements
that must be met in order to successfully install and run your software.
For the most up-to-date, detailed system requirements, refer to http://www.ibm.com/software/awdtools/soda/index.html.
Hardware requirements
Before you can install the product, verify that your system meets
the minimum hardware requirements.
Hardware |
Requirements |
Processor |
Intel(R) Pentium(R) |
Memory |
Minimum: 512 MB of RAM |
Disk space |
Minimum: 500 MB of disk space is required for product package
installation. Additional disk space is required for the resources that you
develop. |
Display |
1024 x 768 resolution minimum using 256 Colors (or higher for best
results) |
Other hardware |
Microsoft(R) mouse or compatible pointing device |
Software requirements
Before you can install the product, verify that your system meets
the software requirements.
Operating system
The following operating systems
are supported for this product:
- Microsoft Windows(R) Vista
with Service Pack 1
- Microsoft Windows 2003
server
- Microsoft Windows XP
Professional with Service Pack 1 or 2 and later running on 32-bit processors
(IA-32) and 64-bit processors (AMD64, EM64T)
- Microsoft Windows 2000
Professional with Service Pack 4 and later running on 32-bit processors (IA-32)
Microsoft Word
The following versions
are supported:
- 2000
- 2002 SP1 and SP2
- 2003 SP1
- 2007
Additional requirements
- Windows Terminal
Server 2000 Service Pack 4 for remote access.
- Adobe(R) Acrobat Reader 4.x or higher to read IBM Rational documentation.
Download a free version of Adobe Acrobat Reader from http://www.adobe.com
- Internet connection to request and receive license key files. For more
information, see the IBM Rational License Management Guide
User privileges requirements
You must have a user ID that meets the following requirements before
you can install Rational SoDA.
- Your user ID must not contain double-byte characters.
- For Windows: the user privileges required for installing
depend on the version of Windows on your computer:
- For Windows Vista, you must log in to the Administrator
account (or run as Administrator; right-click the program file or shortcut
and select Run as Administrator) to perform the following
tasks:
- Install or update IBM Installation Manager (the application that installs
and updates Rational SoDA)
- Install or update a product offering
- For other supported Windows versions, you must have
a user ID that belongs to the Administrators group.
Planning to install
Read all topics in this section before you begin to
install or update any of the product features. Effective planning and an understanding
of the key aspects of the installation process can help ensure a successful
installation.
Installation scenarios
There are a number of scenarios that you can follow when you install
or update Rational SoDA.
Your installation scenario might be determined by the format and method
by which you access your installation files (for example, from CDs or files
downloaded from IBM Passport
Advantage(R)).
These are the typical installation scenarios you might follow:
- Installing from the CDs.
- Installing from a downloaded electronic image on your workstation.
- Installing from an electronic image on a shared drive.
- Installing from a repository on an HTTP or HTTPS Web server.
Note:
- In the latter three scenarios you can choose to run the Installation Manager
program in silent mode to install Rational SoDA.
For details on running Installation Manager in silent mode, see Installing silently.
- You can also install updates at the same time that you install the base
product package.
Installing from CDs
In this installation scenario,
you have the CDs that contain the product package files, and typically you
are installing Rational SoDA on
your own workstation. See Installing Rational SoDA from
CDs: task overview for
an overview of the steps.
Installing from a downloaded electronic image on your workstation
In
this scenario, you have downloaded the installation files from IBM Passport
Advantage and you will install Rational SoDA on
your own workstation. See Installing Rational SoDA from
an electronic image on your workstation: task overview for
an overview of the steps.
Installing 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 Rational SoDA from
a single location. See Installing Rational SoDA from
an electronic image on a shared drive: task overview for
an overview of the steps.
Installing from a repository
on an HTTP or HTTPS Web server
This scenario is the fastest method
for installing the product on a network and is different from the shared-drive
installation. To place product package files for Rational SoDA on
an HTTP or HTTPS Web server, you must use IBM Packaging Utility, a utility
application, to copy the installation files in a package format that you can
use to install Rational SoDA directly
from an HTTP or HTTPS Web server. This utility is provided with Rational SoDA.
The directory on the HTTP or HTTPS Web server that contains the package is
called a repository. Note that any optional software included with the Rational SoDA installation
CDs are not placed in the package; only the Rational SoDA installation
files are placed in the package. See Installing Rational SoDA from
a repository on an HTTP or HTTPS Web server: task overview and Placing Rational SoDA on
an HTTP Web server: task overview for an overview of the steps.
Upgrade from previous versions
If you have a previous version of the product, or
if you plan to install multiple Rational Team products on the same
workstation, review the information in this section.
Upgrading from previous versions of Rational SoDA
Rational SoDA version
7.0.2 cannot be installed on a computer on which previous versions of Rational SoDA are installed.
All previous versions of Rational SoDA must
be uninstalled before attempting to install Rational SoDA version
7.0.2. During the installation of Rational SoDA version
7.0.2, if an installation of the previous version is detected, the installation
routine will stop.
Note:
Uninstalling a previous version of the package will not delete project
assets.
Uninstalling a previous version: scenarios
Earlier versions of Rational SoDA should
be uninstalled through a specific uninstallation program, and not through IBM Installation Manager or the Windows control
panel utilities.
To uninstall an earlier version, use the uninstallation program rationaluninstalltool.exe.
With this program, you have the following two scenarios for removing previously
installed versions:
- A clean uninstallation, which completely removes the Rational installation
directory and the Rational Software registry keys under both HKEY_LOCAL_MACHINE
and HKEY_CURRENT_USER.
- A user-data-preserved uninstallation, which does not remove files that
are used to customize the environment. These files are:
- SoDAWord\logs directory
- SoDAWord\temp directory
Note:
The uninstallation program rationaluninstalltool.exe removes
earlier versions of Rational SoDA, Rational ClearCase(R), Rational ClearQuest(R), Rational RequisitePro(R), Rational ProjectConsole(TM), Rational TestManager,
and Rational Robot
at the same time.
Uninstalling a previous version: tasks
Earlier versions of Rational SoDA should
be uninstalled through a specific uninstallation program. Do not use IBM Installation Manager or
the Windows control
panel utilities to remove previously installed versions of SoDA.
Ensure that you have read the overview on uninstalling previous versions.
To uninstall a previous version of Rational SoDA:
- Download the uninstallation program rationaluninstalltool.exe and
save it to the hard disk.
- Run the Windows command prompt (Click Start -> Run, enter cmd,
and press Enter).
- Navigate to the directory where the uninstallation program is saved.
- Run the following command: rationaluninstalltool.exe log
file name [ -c ], where log file name is
the name and location of the file where you want to store the logging information,
and [ -c ] specifies a clean uninstallation that completely
removes the Rational installation
directory and the Rational Software registry keys under
both HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER.
Installation repositories
IBM Installation Manager retrieves
product packages from specified repository locations.
If the launchpad is used to start Installation Manager,
the repository information is passed to Installation Manager.
If the Installation Manager is
started directly, you must specify an installation repository that contains
the product packages that you want to install. See Setting repository preferences in Installation Manager.
Some organizations bundle and host their own product packages on their
intranet. For information about this type of installation scenario, see Installing from a repository
on an HTTP or HTTPS Web server.
Your system administrators will need to provide you with the correct URL.
By default, IBM Installation 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, updates, and new features.
Setting repository preferences in Installation Manager
When you start the installation of Rational SoDA from
the launchpad program, the location of the repository that contains the product
package you are installing is automatically defined in IBM Installation Manager when it starts.
However, if you start Installation Manager directly (for example, installing Rational SoDA from a repository
located on a Web server) then you must specify the repository preference (the
URL for the directory that contains the product package) in Installation Manager
before you can install the product package. Specify these repository locations
on the Repositories page of the Preferences window. By default, Installation
Manager uses an embedded URL in each Rational software development product
to connect to a repository server through the Internet and search for installable
packages and new features. Your organization may require you to redirect the
repository to use intranet sites.
Note:
Before starting the installation process, be sure to obtain
the installation package repository URL from your administrator.
To add, edit, or remove a repository location in Installation Manager:
- Start Installation Manager.
- 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.
- On the Repositories page, click Add
Repository.
- In the Add repository window, type the URL
of the repository location or browse to it and set a file path.
- Click OK. If you provided an HTTPS or restricted
FTP 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.
- To exit, click OK.
Note:
For Installation Manager to search the default repository
locations for the installed packages, ensure the preference Search
service repositories during installation and updates on the Repositories
preference page is selected. This preference is selected by default.
Preinstallation tasks
Before you install the product, complete these steps:
- Confirm that your system meets the requirements described in the
section Installation requirements.
- Confirm that your user ID meets the required access privileges
for installing the product. See User privileges requirements.
- Read the section Planning to install and
give particular attention to the topic Upgrade from previous versions.
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 SoDA from
CDs: task overview
In this installation scenario, you have the CDs that contain the
installation files, and typically you are installing Rational SoDA on
your own workstation.
The following procedure lists the general steps for installing from
CDs:
- Complete the preinstallation steps. For more information, see Preinstallation tasks.
- Insert the first installation CD into your CD drive.
- If autorun is enabled on your system, the Rational SoDA launchpad
program automatically opens. If autorun is not enabled, start the launchpad
program. For more information, see Starting the launchpad program.
- Start the installation of Rational SoDA from
the launchpad. For more information, see Starting an installation from the launchpad program.
If IBM Installation
Manager is not detected on your workstation, then you must install it to continue.
Follow the instructions in the wizard to complete the installation of Installation
Manager. For more information, see Installing Installation Manager on Windows.
When
the installation of Installation Manager completes, or if it is already on
your computer, Installation Manager starts automatically.
- To complete the installation, click Install Packages and
follow the instructions in the Install Packages wizard. For more information,
see Installing Rational SoDA by
using the Installation Manager GUI.
- Configure your license using the Rational License Key Administrator.
For more information, see Managing licenses.
Installing Rational SoDA from
an electronic image on your workstation: task overview
In this scenario, you have downloaded the installation files from IBM Passport
Advantage and you will install Rational SoDA on
your own workstation.
The following procedure lists the general steps for installing Rational SoDA from an
electronic installation image:
- Ensure that your workstation has sufficient space to store both
the files you must download from IBM Passport Advantage and the
extracted installation image. For more information, see Hardware requirements.
- Ensure that your workstation has sufficient space to store both
the files that you must download and the extracted installation image. For
more information, see Hardware requirements.
- Download all required parts for the product image from IBM Passport
Advantage to a temporary directory.
- Extract the installation image from the downloaded file and verify
that the installation image is complete. For more information, see Verifying and extracting electronic images.
- Continue with the steps in Installing from an electronic image below.
Installing from an electronic image
- Complete the preinstallation steps listed in Preinstallation tasks.
- Start the launchpad program. For more information, see Starting the launchpad program.
- Start the installation of Rational SoDA from
the launchpad. For more information, see Starting an installation from the launchpad program.
- If IBM Installation
Manager is not detected on your workstation you are prompted to install it
and then the installation wizard starts. Follow the instructions in the wizard
to complete the installation of Installation Manager. For more information,
see Installing Installation Manager on Windows.
When
the installation of Installation Manager completes, restart the Installation
Manager program to start the Install Packages wizard.
Note:
If you exit Installation
Manager before completing the product installation, you must restart Installation
Manager from the launchpad. If you start the Installation Manager directly,
it is not preconfigured with the necessary installation repositories.
- If IBM Installation
Manager is detected on your workstation and a new version of Installation Manager 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.
Note:
For
Installation Manager to search the predefined IBM update repository locations for Installation Manager, 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.
- Follow the instructions in the Install Packages wizard to complete
the installation. For complete details, see Installing Rational SoDA by
using the Installation Manager GUI.
- Configure your license using the Rational License Key Administrator.
For more information, see Managing licenses.
Installing Rational SoDA from
an electronic image on a shared drive: task overview
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 Rational SoDA from a single
location.
The following steps are performed by the person who places the installation
image on a shared drive.
- 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. For more information, see Hardware requirements.
- Download all required parts for the product image from IBM Passport
Advantage to a temporary directory on the shared drive.
- Extract the installation image from the downloaded files into an
accessible directory on the shared drive and verify the installation image
is complete. For more information, see Verifying and extracting electronic images.
To install Rational SoDA from
the installation files on the shared drive:
- Change to the disk1 directory on the shared drive containing the installation
image.
- Follow the steps in Installing from an electronic image.
Installing Rational SoDA from
a repository on an HTTP or HTTPS Web server: task overview
In this scenario, the product packages are retrieved by IBM Installation Manager from
an HTTP or HTTPS Web server.
These steps assume the repository containing the package for Rational SoDA has
been created on the HTTP or HTTPS Web server.
To install the Rational SoDA package
from a repository on an HTTP or HTTPS server:
- Complete the preinstallation steps listed in Preinstallation tasks.
- Install IBM Installation Manager.
See Working with IBM Installation Manager. In
this scenario, for example, the Installation Manager installation files are
available from a shared drive.
- Start Installation Manager.
For more information, see Starting Installation Manager on Windows.
- Set the URL of the repository containing the package of Rational SoDA as
a repository preference in Installation Manager. See Setting repository preferences in Installation Manager.
- Start the Install Packages wizard in Installation Manager and follow
the on-screen instructions in the Install Packages wizard to complete the
installation. For more information, see Installing Rational SoDA by
using the Installation Manager GUI.
- Configure your license using the Rational License Key Administrator.
For more information, see Managing licenses.
Placing Rational SoDA on
an HTTP Web server: task overview
To prepare Rational SoDA for
installation from a repository located on an HTTP Web server:
- Ensure that your HTTP or HTTPS Web server has sufficient disk space
to store the product package. See Hardware requirements.
- Ensure that your workstation has sufficient disk space to store
both the files you must download from IBM Passport Advantage and the
extracted installation image. See Hardware requirements
- Download all required parts for the product image from IBM Passport
Advantage to a temporary directory on your workstation.
- Extract the installation image from the downloaded files into another
temporary directory on your workstation and verify that the installation image
is complete. For more information, see Verifying and extracting electronic images.
- On your workstation, install the IBM Packaging Utility from the Enterprise
Deployment CD (or electronic disk) that is appropriate for your platform.
- Using the Packaging Utility, copy the Rational SoDA product
package.
- Copy the output of the Packaging Utility to an HTTP or HTTPS Web
Server.
- Copy the installation files for IBM Installation Manager from the Enterprise
Deployment CD to a shared drive.
- Instruct users in your organization to install Installation Manager.
- Provide users the URL for the repository that contains the Rational SoDA product
package you created earlier.
IBM Installation
Manager
IBM Installation Manager is a
program that helps you install the product packages. It also helps you update,
modify, and uninstall this and other packages that you install. A package
can be a product, a group of components, or a single component that is designed
to be installed by Installation Manager.
IBM Installation Manager offers
several time-saving features, which you can use to complete the following
tasks:
- Install product packages
- Search for and install updates to installed product packages
- Modify installed product packages
- Revert installed product packages to earlier versions
- Uninstall product packages
For more information about IBM Installation Manager, visit the Installation
Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1m0r0/index.jsp.
Working with IBM Installation Manager
This section deals with some common tasks relating to IBM Installation Manager.
For more information, see the Installation Manager online
help or the Installation Manager Information
Center at http://publib.boulder.ibm.com/infocenter/install/v1m0r0/index.jsp.
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:
- Run install.exe from the InstallerImage_win32
folder on the first installation disk.
- Click Next on the Install Packages page.
- Review the license agreement on the License Agreement page and
select I accept the terms in the license agreement to
accept. Click Next.
- If the installation location needs to be changed, on the Destination
Folder page click the Browse button. Click Next.
- Click Install on the Summary page. When
the installation process is complete, a message confirms the success of the
process.
- Click Finish. IBM Installation Manager opens.
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 SoDA packages.
If you start Installation Manager directly,
then you must set a repository preference and choose product packages manually.
For more information, see Planning to install.
To
start Installation Manager manually:
- Open the Start menu from the Taskbar.
- Select All Programs -> IBM
Installation Manager -> IBM Installation Manager.
Note:
On Windows Vista operating system,
you must run Installation Manager as administrator: Right-click the program
shortcut and click Run as administrator.
Uninstalling Installation Manager on Windows
Before you can uninstall Installation Manager, you need to uninstall
all products installed through it.
- Click Start -> Settings -> Control Panel.
- Double-click Add or Remove Programs.
- Select the entry for IBM Installation Manager and click Remove.
- Click Next on the Uninstall
page. The IBM Installation Manager is
selected for uninstallation.
- Click Uninstall in the Summary page.
Silently installing and uninstalling Installation Manager
IBM Installation
Manager can be silently installed and uninstalled.
Silently installing Installation Manager
To install Installation Manager silently, unzip the installer
and switch to the InstallerImage_platform subdirectory,
then use the following commands:
- 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, you can use Installation Manager or the Installation
Manager installer to silently install packages.
Silently uninstalling Installation Manager from Windows
To silently uninstall Installation Manager on Windows:
- 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.
- Enter the following command: uninstallc.exe --launcher.ini
silent-uninstall.ini
Verifying and extracting electronic images
After you download the installation files, you must extract
the electronic image from the compressed file before you can install Rational SoDA.
You may want to verify the completeness of the downloaded files before extracting
the image.
If you select the Download Director option for downloading the
installation file, the Download Director applet automatically verifies the
completeness of each file that it processes.
Extract each compressed file to the same directory.
Installing from the launchpad program
The launchpad program provides you with a single location to view
release information and start the installation process.
Use the launchpad program to start the installation of Rational SoDA in
the following cases:
- Installing from the product CDs
- Installing from an electronic image on your local file system
- 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 SoDA package.
If you install and start Installation Manager directly,
then you must set repository preferences manually.
To install from the
launchpad:
- Complete the preinstallation tasks described in Preinstallation tasks,
if you have not done so already.
- Start the launchpad program. See Starting the launchpad program.
- Start the installation of Rational SoDA.
See Starting an installation from the launchpad program.
Follow the instructions in the Install Packages wizard to complete
the installation. For complete details, see Installing Rational SoDA by
using the Installation Manager GUI.
Important:
Installation notes for the Windows Vista operation system:
- You must run the launchpad programs as administrator.
- If you are starting the installation of Rational SoDA from
the launchpad program, you must run the launchpad programs as administrator.
If the launchpad program starts automatically (for example, if you are installing
from a CD), stop the launchpad program and restart it by using the Run
as administrator command (At the root level of the CD or disk
image, right-click launchpad.exe and click Run as Administrator.).
- Selecting installation directories within the Program Files directory
(C:\Program Files) is not recommended. If you select either an Installation
Location or Shared Resources Directory within the Program Files directory,
the packages that you install must be run as administrator.
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 CD and autorun is enabled on your
workstation, then the Rational SoDA launchpad
starts automatically when you insert the first installation disc into your
CD 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:
- Insert the IBM Rational SoDA CD
into your CD drive.
- If autorun is enabled on your system, the IBM Rational SoDA launchpad
program automatically opens. If autorun is not enabled on your system, run
launchpad.exe located in the root directory of the CD.
Starting an installation from the launchpad program
- Start the launchpad program.
- If you have not done so already, read
the release information by clicking Release notes.
- When you are ready to begin the installation, click Install IBM Rational SoDA.
- If IBM Installation Manager is not
detected on your system or if an older version is already installed, then
you must continue with the installation of the latest release.
- Follow the instructions in the wizard to complete the installation
of IBM Installation Manager. Refer
to Installing Installation Manager on Windows for
more information.
- When the installation of IBM Installation Manager completes
successfully, to close the wizard, click Finish. After the installation is complete, IBM Installation Manager opens
automatically.
- If this is a new installation, to complete the installation process
click Install Packages and follow the instructions
in the wizard. For complete details, see Installing Rational SoDA by
using the Installation Manager GUI
- If this is a product update, to complete the update process click Update
Packages and follow the instructions in the wizard.
For complete details, see Updating Rational SoDA.
Installing Rational SoDA by
using the Installation Manager GUI
The following steps describe installing the IBM Rational SoDA with
the Installation Manager graphical
user interface (GUI).
- From the Installation Manager start
page, click Install.
Note:
If a new version
of Installation Manager is
found, you are prompted to confirm that you want to install it before you
can continue. To proceed, click OK. Installation Manager
automatically installs the new version, stops, restarts, and resumes.
- The Install Packages page lists all the packages found in the repositories
that Installation Manager searched.
If two versions of a package are found, only the most recent, or recommended,
version of the package is displayed.
- To display all versions of any product found by Installation Manager,
select Show all versions.
- To return to the display of only the recommended product, ensure that Show
all versions is not selected.
- Optional: To read the description of theIBM Rational SoDAversion,
select the version check box. The description is displayed under Details .
- Optional: To search for updates to the IBM Rational SoDA product,
click Check for Other Versions and Extensions.
Note:
For Installation Manager to search the predefined IBM update repository
locations for the installed products, the preference Search service
repositories during installation and updates on the Repositories
preference page (File -> Preferences) must be selected. This preference is selected by default.
Internet access is also required.
Installation Managersearches
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 that the search is taking place. You can install updates at the same
time that you install the base product package.
- If updates for the IBM Rational SoDA product
are found, they will be displayed in the Installation Packages list
on the Install Packages page below the 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. To display the additional
information in a browser, click the link. To fully understand the package
you are installing, review all information beforehand.
- Select the IBM Rational SoDA package
and any updates to the package that you want to install. Updates that have
dependencies are automatically selected and cleared together. To continue,
click Next.
Note:
If earlier versions of
the product are installed, they should be removed before proceeding further.
- On the Licenses page, read the license agreement for the selected
package.
- If you agree to the terms of all of the license agreements,
click I accept the terms of the license agreement.
- To continue, click Next.
- On the Location page, Accept the default path for the installation
directory or, type the path. You can also browse to select the path. Click Next.
- On the Features page:
- Select the language that you want the package to be installed
in, and click Next.
- Select the package that you want to install, and click Next.
- To configure the license server, enter the license server elements
in the License server element(s) field. If you do not
know this information, you can continue with the installation, and configure
the license server later.
- To continue, click Next.
- On the Summary page, review your choices before installing the IBM Rational SoDA package. If
you want to change the choices that you made on previous pages, click Back and
make your changes. To see the repository, click Repository Information.
When you are satisfied with your installation choices, to install the package
click Install. A progress indicator
shows the percentage of the installation completed.
- When the installation process is complete, a message confirms the
success of the process.
- Optional: To open the installation log file for
the current session in a new window, click View log file .
You must close the Installation Log window to continue. To display
the details of an event in the log file, select the entry and read the details
in the Details section. You can import or export the
log file as an xml file, filter the log file on the basis of logged events,
and open the log file as a web page.
- Optional: To delete any files specified for rollback,
click Files for rollback and in the Preferences Window,
select the files to be deleted.
- Click Finish. The Install Package wizard
closes and you are returned to the start page of Installation Manager.
Installing silently
You can install Rational SoDA by
running Installation Manager in silent installation mode. When you run Installation
Manager in silent mode, the user interface is not available; instead, Installation
Manager uses a response file to input the commands that are required to install
the product package. You can also install Installation Manager silently using
the Installation Manager installer. You can then use the installer to silently
install product packages.
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 a package.
There are two main
tasks required for silent installation:
- Create the response file.
- Run Installation Manager in silent installation mode.
Creating a response file with Installation Manager
You can create a response file by recording your actions as you
install Rational SoDA using
Installation Manager, or the Installation Manager installer. When you record
a response file, all of the selections that you make in the Installation Manager
GUI are stored in an XML file. When you run Installation Manager in silent
mode, Installation Manager uses the XML response file to locate the repository
that contains the package, select the features to install, and so on.
To record a response file for installation (or uninstallation):
- On a command line, change to the eclipse subdirectory in the directory
where you installed Installation Manager. For example:
- cd C:\Program Files\IBM\Installation Manager\eclipse
- 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:
Note:
Ensure the file paths you enter exist; Installation Manager will
not create directories for the response file and the log file.
- Follow the instructions in the Install Packages wizard to make
your installation choices. For details, see Installing Rational SoDA by
using the Installation Manager GUI.
- 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
You can use the Installation Manager installer to record the installation
of Installation Manager and other products.
To record the installation of Installation Manager, follow these
steps:
- Extract the Installation Manager, then go to the InstallerImage_platform directory.
- 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 Installation Manager
installer, follow these steps:
- Go to the InstallerImage_platform directory
in location where you extracted the Installation Manager.
- Open the install.ini file by removing the following lines: -input and @osgi.install.area/install.xml
- Enter the following command: install -record <response
file path and name> -skipInstall <agentDataLocation>, for example:
install -record
- Start the Installation Manager and complete the Install Packages
wizard.
Installing and running Installation Manager in silent mode
Use the Installation Manager installer to install Installation
Manager, then use Installation Manager to install product packages in silent
installation mode from a command line.
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:
Argument |
Description |
-vm |
Specifies the Java(TM) launcher. In silent mode, always use
java.exe on Windows, and java on other platforms. |
-nosplash |
Specifies that the splash screen should be suppressed. |
--launcher.suppressErrors |
Specifies that the JVM error dialog should be suppressed. |
-silent |
Specifies that the Installation Manager installer or Installation
Manager should be run in silent mode. |
-input |
Specifies an XML response file as the input to
Installation Manager installer or the Installation Manager. A response file
contains commands that installer or Installation Manager runs. |
-log |
(Optional) Specifies a log file that records the result of the silent
installation. The log file is an XML file. |
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:
- installc --launcher.ini silent-install.ini -log <log file
path and name> . For example: installc --launcher.ini silent-install.ini
-log c:\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:
- 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
If you want to silently install products using the Installation
Manager installer, from the eclipse directory, enter the following command:
- 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
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
You can silently search for and install updates for all available
products.
To search for and silently install all available products:
- On a command line, change to the eclipse subdirectory in the directory
where you installed Installation Manager.
- Enter and run the following command, substituting your own locations
for the response file and, optionally, the log file:
- IBMIMc.exe --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
You can silently search for and install updates for all currently
installed products.
To search for and silently install updates for all available products:
- On a command line, change to the eclipse subdirectory in the directory
where you installed Installation Manager.
- Enter and run the following command, substituting your own locations
for the response file and, optionally, the log file:
- IBMIMc.exe --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
If you want to use the silent installation capabilities of Installation
Manager, you need to create a response file that contains all of the commands
that Installation Manager must run. The recommended way to do this is to create
a response file by recording your actions as you install the IBM Rational SoDA package.
However, you can create or edit a response file manually.
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
While you typically specify preferences using the Preferences window,
you can also specify preferences (identified as keys) in a response file for
use during a silent installation.
Note:
You can specify more than one preference in a response file.
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">
</preference>
Use the following table to identify keys and their associated
values for silent installation preferences:
Key |
Value |
Notes |
com.ibm.cic.common.core.preferences.logLocation |
Specifies the location of Installation Manager log file. |
Important:
This key is optional and is designed for testing
and debugging. If you do not specify a location for the log file, both silent
installation and the UI version of Installation Manager will use the same
location. |
com.ibm.cic.license.policy.location |
Specifies a URL that defines where the remote license policy file
resides. |
|
com.ibm.cic.common.core.preferences.http.proxyEnabled |
True or False |
False is the default value. |
com.ibm.cic.common.core.preferences.http.proxyHost |
Host name or IP address |
|
com.ibm.cic.common.core.preferences.http.proxyPort |
Port number |
|
com.ibm.cic.common.core.preferences.http.proxyUseSocks |
True or False |
False is the default value. |
com.ibm.cic.common.core.preferences.SOCKS.proxyHost |
Host name or IP address |
|
com.ibm.cic.common.core.preferences.SOCKS.proxyPort |
Port number |
|
com.ibm.cic.common.core.preferences.ftp.proxyEnabled |
True or False |
False is the default value. |
com.ibm.cic.common.core.preferences.ftp.proxyHost |
Host name or IP address |
|
com.ibm.cic.common.core.preferences.ftp.proxyPort |
Port number |
|
com.ibm.cic.common.core.preferences.eclipseCache |
c:\IBM\common (Windows)
Note:
The paths above are
default values for this preference; typically, install packages provide their
own values for this preference. |
You cannot change this location if you have already installed a package. |
com.ibm.cic.agent.core.pref.offering.service.repositories. areUsed |
True or False |
Change this preference to 'False' to disable it. When 'True', all
linked repositories will be searched when products are installed or updated. |
com.ibm.cic.common.core.preferences. preserveDownloadedArtifacts |
True or False |
Change this preference to 'False' to disable it. When true, the files
required to roll the package back to a previous version are stored on your
system. When false, these files are not stored. If you do not store these
files, you must connect to your original repository or media to roll back. |
Silent installation commands
You can use this reference table to learn more about response file
commands for use during a silent installation.
Response file commands |
Description |
Profile
<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> |
Use this command to create a package group (or installation location).
If the specified package group already exists, then the command has no effect.
Currently, when creating the profile, the silent installation will also create
two installation contexts; one for Eclipse and one for native.
A profile is an installation location. |
Repositories
<server>
<repository location="http://example/
repository/">
<repository location="file:/C:/
repository/">
<!--add more repositories below-->
<...>
</server> |
Use this command to specify the repositories used during a silent
installation. Use a URL or UNC path to specify remote repositories; use directory
paths to specify local repositories. |
Install
<install>
<offering profile= "profile id"
features= "feature ids"
id= "offering id" version= "offering
version"></offering>
<!--add more offerings below>
<...>
</install> |
Use this command to specify the installation packages that will be
installed.
The profile ID must match an existing profile or a profile created
by the set profile command.
Feature IDs can be optionally specified
by a comma-delimited list, such as "feature1, feature2" and so on. If no feature
IDs are specified, all the default features in the specified offering will
be installed.
The version number is not required. If no version is specified,
the Installation Manager will install the most recent product with the specified
ID and any available updates and fixes.
Note:
Required features will
be included for installation, even if they are not explicitly specified in
the comma-delimited list. |
<install modify="true"> or <uninstall
modify="true"> (optional attribute)
<uninstall modify="true">
<offering profile="profileID"
id="Id" version="Version"
features="-"/>
</uninstall> |
Use the <install modify="true"> attribute
on install and uninstall commands to indicate that you want to modify an existing
installation. If the attribute is not set to true, the
value defaults to false. If the intent of the modify operation
is only to install additional language packs, then a hyphen "-" should be
used in the offering feature ID list to indicate no new features are being
added.
Important:
You must specify "modify=true" and
a hyphen "-" feature list as specified in the example;
otherwise, the install command will install the offering's default features
and the uninstall command will remove all the features. |
Uninstall
<uninstall>
<offering profile= "profile id"
features= "feature ids"
id= "offering id" version= "offering
version"></offering>
<!--add more offerings below>
<...>
</uninstall> |
Use this command to specify the packages that will be uninstalled.
The
profile ID must match an existing profile or a profile specified in a profile
command. Further, if there are no feature IDs specified, all the features
in the specified offering will be uninstalled; if there are no offering IDs
specified, all the installed offerings in the specified profile will be uninstalled. |
Rollback
<rollback>
<offering profile= "profile id"
id= "offering id"
version= "offering version">
</offering>
<!--add more offerings below
<...>
</rollback> |
Use this command to roll back to the specified offerings from the
version currently installed on the specified profile. You cannot specify
features in a roll back command. |
InstallAll
<installALL/>
Note:
This
command is equivalent to using
-silent -installAll . |
Use this command to silently search for and install all available
packages. |
UpdateAll
<updateALL/>
Note:
This
command is equivalent to using
-silent -updateAll . |
Use this command to silently search for and update all available
packages. |
Wizard
<launcher -mode wizard -input
< response file > |
Use this command to start Installation Manager in UI mode. The UI
mode starts Installation Manager in either the install wizard or the uninstall
wizard. However, in this case, the response file can only contain preference
commands and install commands or preference command and uninstall commands;
you can not mix install and uninstall commands in the same response file when
you run Installation Manager in UI mode. |
Additional response file attributes
Response file attribute |
Description |
Clean
<agent-input clean="true">
</agent-input> |
By default, clean="false". Installation Manager
will use the repository and other preferences specified in the response file
in addition to the existing preferences set in the Installation Manager. If
a preference is specified in the response file and the Installation Manager,
the one in the response file takes precedence.
If set to clean="true",
Installation Manager will use the repository and other preferences specified
in the response file; the existing preferences set in the Installation Manager
will not be used. |
Temporary
<agent-input clean="true" temporary="false">
</agent-input> |
By default, temporary is set to 'false' and the
preferences set in your response file persist. When you set temporary="true",
the preferences set in the response file will not persist.
You can use the
temporary and clean attributes together, for example, if you set clean to
true and temporary to false, after running the silent installation
the repository setting specified in the response file will override the preferences
set in the previous sessions using Installation Manager. |
License agreement acceptance
<agent-input acceptLicense="false">
</agent-input> |
By default, you agree to accept whatever license an installation
package carries when using Installation Manager in silent installation mode.
If you do not want to accept the license agreement, you can use an additional
attribute in the <agent-input> element that automatically
fails the silent installation operation, <agent-input acceptLicense="false">.
If the installation package you are installing has a license agreement that
must be accepted, the silent installation operation will fail. |
Reference: Sample response file
You can use an XML-based response file to specify predefined information
such as silent installation preferences, repository locations, installation
profiles, and so on. Response files are beneficial for teams and companies
that want to install installation packages silently and to standardize the
locations and preferences for installation packages.
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
You can use silent install log files to examine the results of
a silent installation session.
If during the creation of a response file you specified that a
log file also be created, the silent installation functionality creates an
XML-based log file that records the result of the silent install execution.
If the silent installation session is successful, the log file contains only
the root element of <result> </result>. However, if
errors occur during the installation, the silent install log file contains
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 location you specified when you created the response file.
Managing licenses
Licensing for your installed IBM Rational SoDA software
is administered using the IBM Rational License Key Administrator (LKAD).
LKAD is installed with IBM Rational SoDA and
with your IBM Rational License Server software.
The IBM Rational License
Key Administrator is a tool that you can use to import license keys to your
desktop computers. You can also configure your client to use floating and
named-user licenses, and change your license configuration. The LKAD wizard
starts after the product installation is complete. You can also start the
LKAD wizard on a client by clicking Start -> Programs -> IBM Rational -> Rational
License Key Administrator.
For more information
about managing licenses with Rational Common Licensing, see the Rational ClearQuest
Information Center at http://publib.boulder.ibm.com/infocenter/cqhelp/v7r1m0/topic/com.ibm.rational.licensing.doc/topics/c_managing_lic.htm
For more information about managing licenses for
your Rational product,
see the Rational licensing
support page at http://www.ibm.com/software/rational/support/licensing.
You can start Rational SoDA from
the desktop environment.
To start the product from the desktop, click Start -> Programs -> IBM Rational SoDA.
Important:
On the Windows Vista operation system,
if the installation location for Rational SoDA is
in a directory in the path C:\Program Files, you must
run Rational SoDA as
the administrator. To run as administrator, right-click the program shortcut
and click
Run as administrator.
On Windows Vista,
the Program Files directory is usually virtualized in order to allow users
who are not running as the administrator to have write access to this protected
directory. However, the virtualization workaround is not compatible with Rational SoDA.
Updating Rational SoDA
You can install updates for products that were installed with IBM Installation
Manager. Package updates provide fixes and updates to installed features and
might also include new features that you can install using the Modify wizard.
By default, Internet access is required unless your repository preference
points to your local update site.
Each installed product has the location
embedded for its default IBM update repository. For Installation Manager to search
the IBM update
repository locations for the installed product, the preference Search
service repositories during installation and updates on the Repositories
preference page must be selected. This preference is selected by default.
See
the Installation Manager help for more information.
Note:
Close all programs
that were installed using Installation Manager before updating.
To find and install product updates:
- From the Start page of the Installation Manager, click Update.
- If IBM Installation Manager is not
detected on your system or if an older version is already installed, then
you must continue with the installation of the latest release. Follow the
instructions in the wizard to complete the installation of IBM Installation Manager
- In the Update wizard, select the location where the Rational SoDA product
you want to update is installed or select the Update All check
box, and then click Next. Installation
Manager searches for updates in its repositories and the predefined update
sites for Rational SoDA.
A progress indicator shows the search is taking place.
- If updates for a product are found, then they are displayed in
the Updates list on the Update Packages page below
their corresponding product. Only recommended updates are displayed by default.
Click Show all to display all updates found for the
available product.
- To learn more about an update, click the update and review its
description under Details.
- If additional information about the update is available, a More
info link will be included at the end of the description text.
Click the link to display the information in a browser. Review this information
before installing the update.
- Select the updates that you want to install or click Select
Recommended to restore the default selections. Updates that have
a dependency relationship are automatically selected and cleared together.
- Click Next to continue.
- On the Licenses page, read the license agreements for the selected
updates. On the left side of the License page, the
list of licenses for the updates you selected is displayed; click each item
to display the license agreement text.
- If you agree to the terms of all the license agreements, click I
accept the terms of the license agreements.
- Click Next to continue.
- On the Summary page, review your choices before installing the
updates.
- If you want to change the choices you made on previous pages,
click Back, and make your changes.
- When you are satisfied, click Update to
download and install the updates. A progress indicator shows the percentage
of the installation completed.
Note:
During the update process, Installation Manager might prompt
you for the location of the repository for the base version of the package.
If you installed the product from CDs or other media, they must be available
when you use the update feature.
- Optional: When the update process completes, a message
that confirms the success of the process is displayed near the top of the
page. Click View log file to open the log file for
the current session in a new window. You must close the Installation Log window
to continue.
- Click Finish to close the wizard.
- Optional: Only the features that you already have installed
are updated using the Update wizard. If the update
contains new features that you would like to install, run the Modify
Packages wizard and select the new features to install from the
feature selection panel.
Reverting updates to previous versions
You can remove an update to some packages to revert to a previous
version by using the Roll Back Packages wizard of IBM Installation Manager.
During the rollback process, Installation Manager must access files
from the earlier version of the package. By default, these files are stored
on your computer when you upgrade to a new package. If you have deleted the
files that are saved locally for rollback or cleared the Save files
for rollback check box in the Preferences page (File
> Preferences > Files for Rollback) while upgrading, you will
not be able to roll back to the previous version without the media or repositories
that were used to install that version of the package.
Use the rollback feature if you have applied an update to a product
package and decide later that you want to remove the update and revert to
the earlier version of the product. When you use the rollback feature, Installation
Manager uninstalls the updated resources and reinstalls the resources from
the previous version. You can only roll back one version level at a time.
For
more information, see the Installation Manager online help or Information
Center.
To revert an update to a previous version, complete the following
steps:
- On the Start page, click Roll back Packages.
- In the Rollback wizard, from the Installation Packages list,
select the package that you want to revert to the previous version.
- Follow the instructions in the wizard.
Uninstalling Rational SoDA
The Uninstall option in the Installation Manager enables you to
uninstall products.
- To uninstall the product you must log in to the system using the same
user account that you used to install the product.
- Before removing the IBM Rational products (including the IBM Rational
license server) from clients, record the specified license server host names
in the IBM Rational License Key Administrator (LKAD)
- Start the LKAD by clicking Start -> Programs -> IBM Rational -> IBM Rational License Key Administrator.
- Find the host names by clicking Settings -> Client/Server Configuration.
- After you install the new IBM Rational products, reset the license server
name in the LKAD. The LKAD wizard starts after the installation. If the wizard
does not start, click Start -> Programs -> IBM Rational -> IBM Rational License Key Administrator.
To uninstall the product:
- Close the programs that you installed using Installation Manager.
- On the Start page of the Installation Manager click Uninstall.
- In the Uninstall Packages page, select the Rational SoDA product.
Click Next.
- In the Summary page, review the list of packages that will be uninstalled
and click Uninstall. A confirmation
is displayed after the uninstallation finishes.
- To exit the wizard, click Finish.
IBM Packaging
Utility
Use IBM Packaging
Utility software to copy product packages to a repository that can be placed
on a Web server available over HTTP or HTTPS.
Packaging Utility software is located on the Enterprise Deployment CD that
is included with Rational SoDA.
If you want to place a repository that contains a Rational SoDA package
on a Web server that will be available over HTTP or HTTPS, you must use Packaging
Utility to copy the product package of Rational SoDA 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 using
the tool.
Installing Packaging Utility
IBM Packaging
Utility must be installed from the Enterprise Deployment CD before it can
be used to copy the Rational SoDA product
package.
Use the following steps to install IBM Packaging Utility software from the
Enterprise Deployment CD:
- Navigate to the Enterprise Deployment CD for the appropriate platform
and extract the zip file from the CD.
- Navigate to the Packaging Utility directory and extract the Packaging
Utility installation package from the compressed file (pu.disk_win32.zip or
pu.disk_linux.zip).
- Locate the Packaging Utility installer executable.
- Change to the InstallerImage_win32 directory in the area where the
pu.disk_win32.zip file was unpacked. Locate the installer executable "install.exe".
- Start the installer executable and follow the instructions in the
wizard to install the Packaging Utility.
- If IBM Installation
Manager is not detected on your workstation, you are prompted to install it
and then the installation wizard starts. Follow the instructions in the wizard
to complete the installation of Installation Manager.
- 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.
- Follow the instructions in the Install Packages wizard
to complete the installation.
Copying product packages to an HTTP server using Packaging Utility
To
create a repository on an HTTP or HTTPS server, you must use Packaging Utility
to copy the product package for Rational SoDA.
- If you are copying from a CD image, perform
these tasks:
- Insert the first installation CD into your CD drive.
- If autorun is enabled on your system, the Rational SoDA launchpad
program automatically opens. Close the launchpad program.
- Start Packaging Utility.
- On the main page of the utility, click Copy Packages. 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
- 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.
- To advance to the Source page, click Next.
If there are no product packages to select, you must open a repository that
contains product packages.
- To open a repository, click Open repository.
Note:
A repository can be a path to a file on the local file system,
a disk drive containing the first CD of the product, or a URL to a file on
a server.
- To define a repository location, click the Repository Location Browse button,
and then navigate to the Repository location (the common root directory) that
contains the disk images. For example, if the product files (disk1, disk2,
and so on) reside in C:\productA\unzip, you should navigate there and select
the repository.config file, the diskTag.inf, the jar file, or a zip file.
- To define the repository location and to close the Browse
to a repository directory window, click OK.
- On the Destination page, click the Browse button
and select an existing repository directory, or create a new folder to store
the products.
- 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.
- To advance to the Summary page, click Next. 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.
- To copy the selected product packages to the destination repository,
click Copy. 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.
- To return to the Packaging Utility main page, click Done.
After you have use Packaging Utility to copy the Rational SoDA 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.)
For the latest information about working
with IBM Packaging Utility, visit the IBM Packaging Utility Information Center
at http://publib.boulder.ibm.com/infocenter/install/v1m0r0/index.jsp.
Notices
(C) Copyright IBM Corporation 1995, 2008.
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:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact
the IBM Intellectual Property Department in your country or send inquiries,
in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
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.
IBM may use or distribute any of the information you supply in any way
it believes appropriate without incurring any obligation to you.
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:
Intellectual Property Dept. for Rational Software
IBM Corporation
20 Maguire Road
Lexington, Massachusetts 02421-3112
U.S.A.
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:
- developerWorks(R)
- IBM
- Passport Advantage
- Rational
- WebSphere(R)
- iSeries(R)
- zSeries(R)
Microsoft and Windows are trademarks of Microsoft Corporation
in the United States, other countries, or both.
Linux(R) is a trademark of Linus Torvalds in the United States, other countries,
or both.
Other company, product or service names, may be trademarks or service marks
of others.
Index
A
B
C
D
F
I
L
P
R
S
U
V
W
A
B
C
D
F
I
L
P
R
S
U
V
W