The software can be installed to run on Jetty, IBM® WebSphere® Application Server, IBM WebSphere Application
Server Community Edition, or Tomcat. Follow these steps to install
the software for UNIX.
About this task
For WebSphere Application
Server, WebSphere Application
Server Community Edition, and Tomcat, the web server and Rational Change must be installed by the
same user.
Procedure
- Change the directory to the DVD installation
directory.
$ cd change/unix
- Run the IBM Rational Change Server installation
script.
To run the installation script
in command-line mode instead of GUI mode, append -nogui to
the command. When the script prompts you for values, type the values
shown for the GUI steps.
$ ./setup.sh Note: If you receive a warning, your system might not meet
the
server
requirements. Other reasons for a warning are that the installation
program did not find the JRE, there was insufficient disk space. Or
the
DISPLAY is not valid or writable. For additional
information, contact
IBM Rational Software Support.
- In the Software License Agreement dialog
box, which follows the Welcome dialog box, read
the license agreement information, and then click Accept.
- In the Install Info - Select Install Set dialog
box, select the applicable application to install, and then click Next.
- In the Change Info - Server Type dialog
box, select the applicable server type, and then click Next.
Click Learn More to
view details about the server types or see Installation considerations for more information.
- In the Web Server Info - Select
a Web Server dialog box, select a web server, and then
click Next.
- For Jetty, accept the default.
- For WebSphere Application
Server, WebSphere Application
Server Community Edition, or Tomcat, type the location of the existing
web server installation.
- In the Web Server Info - Port
and Context dialog box:
- Accept the default or type an unused port number for
the Rational Change server.
- Type a unique context path for Rational Change.
- Type a unique context path for Help.
Depending
on the option you selected on the Install Info - Select
Install Set dialog box, this path may or may not be required.
- Click Next.
If you specify a port number less than 1024,
you must start the Rational Change
server as root.
If you change
the port number, context path, and Help path, update items 5, 6, and
7 on the work sheet.
- For WebSphere Application
Server only, in the WebSphere Profile dialog
box, select a WebSphere profile
where you want to install Rational Change
(item 8 on the work sheet), and then click Next.
At least one profile must exist to run the
product.
- For WebSphere Application
Server or WebSphere Application
Server Community Edition only, in the Web Server Info -
Admin User dialog box, type the WebSphere server admin ID (item 9 on the
work sheet) and password, and then click Next.
- For WebSphere Application
Server only, in the WebSphere Server Instance dialog
box, select a WebSphere server
(item 10 on the work sheet).
- In the Change Info - Install Directory dialog
box, accept the default path or type the appropriate installation
path, and then click Next.
If you change the installation directory, update item
1 on the work sheet.
- In the Change Info - Local Admin
User dialog box, type the user name and password (item
2 on the work sheet), and then click Next.
The local admin user, which replaces the ChangeAdmin
user from previous releases, is a special Rational Change user account that is defined
during installation. Unlike regular user accounts, the local admin
user is authenticated by Rational Change
directly, rather than by IBM Rational Directory Server.
The user account is also used to perform certain background activities.
- In the Change Info - Host dialog
box, accept the default or type the name of the machine to run Rational Synergy sessions (it
must be a UNIX machine). Then
click Next.
If
you change the host name, update item 3 on the work sheet. You can
add more session hosts later.
- In the Change Info - License Information dialog
box, select the applicable option (item 4 on the work sheet), and
then click Next.
If
you will supply license information later, you are reminded to edit
the license data in the license_data.txt file. See
step 21 for specific
details.
- In the Synergy Info - Directory dialog
box, accept the default or type a path to the Rational Synergy installation (CCM_HOME,
item 11 on the work sheet). Then click Next.
If you change the path to the Rational Synergy installation, update your
work sheet.
If you receive a warning about the
installation path, the existing CCM_HOME installation
might not be the required release of Rational Synergy. Click No to
specify a different path to CCM_HOME or Yes to
proceed with the installation using the path you already specified.
- In the Synergy Info - Database dialog
box, type the path to the database, and then click Next.
- Stand-alone server: Type a path to a Rational Synergy database.
- Central server: Type a path to a DCM-initialized Rational Synergy central CR
database.
- Remote server: Type a path to a DCM-initialized Rational Synergy development
database.
If you change the database path, update
item 12 on the work sheet. You can add more databases later.
If
you receive a warning, the existing database might not be for the
required release, or the path you specified might not be correct or
visible. Click No to specify a different path
to database_path or click Yes to
proceed with the installation using the path you already specified.
- In the Synergy Info - Session
User dialog box, type the name of the session user and
password (item 13 on the work sheet), and then click Next.
The user name must be defined in the operating
system and be a user in the Rational Synergy
database.
- In the Help Info- Help Server URL dialog
box, select the applicable option, and then click Next.
- In the Start Copying Files dialog
box, click Install.
The Rational Change files are copied
to the installation directory. As the files are copied, a status screen
shows the progress of the installation.
- In the Install Wizard Complete dialog
box, click Finished to exit the installation
process.
- On the Change Info - License Information dialog
box, if you chose to specify license information later, you must specify
that information before you can log on to Rational Change. Edit the license_data.txt file
in the applicable directory:
For example:
CHANGE_APP_HOME/WEB-INF/wsconfig
- Start
the Rational Change server.
What to do next
Now you are ready to verify
the installation.