IBM Rational Team Concert for i Installation Guide · COBOL applications, you must use Rational...

IBM Rational Team Concert for i, Version 1.0

Installation Guide

��

First Edition, November 2008

This edition applies to IBM Rational Team Concert for i (product number 5724-V58) and to all subsequent releases

and modifications until otherwise indicated in new editions.

© Copyright International Business Machines Corporation 2008.

US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract

with IBM Corp.

Note

Before using this information and the product it supports, be sure to read the general

information in “Notices” on page 25.

Contents

About this guide . . . . . . . . . . . v

Conventions in this document . . . . . . . . v

Chapter 1. Prerequisites and system

requirements . . . . . . . . . . . . 1

Hardware requirements . . . . . . . . . . . 1

Software requirements . . . . . . . . . . . 1

Prerequisites for Jazz Team Server for i . . . . 1

Prerequisites for Build System Toolkit for i . . . 2

Prerequisites for Rational Team Concert for i client

and Rational Developer for i . . . . . . . . 2

Prerequisites for Rational Team Concert for i Web

client . . . . . . . . . . . . . . . . 2

Chapter 2. Installing Jazz Team Server

for i and Build System Toolkit for i . . . 3

Installing Jazz Team Server for i Express Edition and

Build System Toolkit for i from a CD . . . . . . 4

Installing Jazz Team Server for i Express Edition and

Build System Toolkit for i from an electronic image . 4

Installing Jazz Team Server for i Express Trial Edition

and Build System Toolkit for i from an electronic

image . . . . . . . . . . . . . . . . . 5

Installing Jazz Team Server for i Standard Edition

and Build System Toolkit for i from a CD . . . . . 5

Installing Jazz Team Server for i Standard Edition

and Build System Toolkit for i from an electronic

image . . . . . . . . . . . . . . . . . 6

Installing Jazz Team Server for i Standard Trial

Edition and Build System Toolkit for i from an

electronic image . . . . . . . . . . . . . 6

Chapter 3. Configuring your installation 7

Creating Jazz Team Server database tables . . . . 7

Setting up WebSphere Application Server . . . . . 8

Part 1: Setting Java Virtual Machine parameters . 9

Part 2: Securing WebSphere Application Server 10

Part 3: Installing the Jazz Web archive file . . . 12

Part 4: Verifying the installation . . . . . . 14

Completing the installation . . . . . . . . . 14

Licensing considerations . . . . . . . . . 15

Installing the Rational Team Concert for i client . . 16

Chapter 4. Getting started with Rational

Team Concert for i . . . . . . . . . . 17

Chapter 5. Troubleshooting and getting

help . . . . . . . . . . . . . . . . 19

Frequently asked questions . . . . . . . . . 20

Notices . . . . . . . . . . . . . . 25

Trademarks and service marks . . . . . . . . 27

© Copyright IBM Corp. 2008 iii

iv IBM Rational Team Concert for i Installation Guide

About this guide

This guide provides information about installing, configuring, and using IBM®

Rational® Team Concert for i. To use this guide, you must be familiar with

Windows®® and IBM® i operating systems.

Rational Team Concert for i is a collaborative software delivery environment. With

it, teams can simplify, automate, and govern application development on IBM i.

Rational Team Concert for i extends the base Rational® Team Concert product by

providing a Team Server and Build System Toolkit that run on IBM i. The Rational

Team Concert for i client is shipped as an installable component of Rational

Developer for i, an integrated development environment for creating new and

modernizing existing RPG and COBOL applications. To use the functionality for

team collaboration and managing RPG and COBOL applications, you must use

Rational Team Concert for i in conjunction with Rational Developer for i.

You can find additional installation information at http://publib.boulder.ibm.com/infocenter/rtcihelp/v1r0m0/index.jsp.

Conventions in this document

In this document, the following examples are used:

yourServerHostName

Refers to the TCP/IP host name or IP address for your IBM i server (for

example, rtci.example.com or 192.168.1.101).

yourJazzServerPortNumber

Refers to the WebSphere® Application Server port which is used to connect

to the Jazz™ Team Server application (for example, 9443).

yourWASAdminPortNumber

Refers to the WebSphere Application Server port which is used to access

the WebSphere Application Server Administration console (for example,

9060).

© Copyright IBM Corp. 2008 v

http://publib.boulder.ibm.com/infocenter/rtcihelp/v1r0m0/index.jsp


vi IBM Rational Team Concert for i Installation Guide

Chapter 1. Prerequisites and system requirements

The Rational Team Concert for i prerequisites and requirements are described in

this section.

Hardware requirements

Make sure that you have the following prerequisite hardware installed and

operational before you proceed with the Jazz Team Server for i installation on IBM

i.

The Rational Team Concert for i client requires the following hardware:

v Processor: Intel® Pentium® III (minimum); Intel Core 2 Duo (recommended)

v Memory: 1 GB minimum

v Disk space: 1 GB minimum

v Display: 1024 x 768 minimum resolution

The Jazz Team Server for i requires the following hardware:

v IBM POWER™ server or IBM i server running i 5.4 or 6.1

– IBM i models 515, 520, 525, 550, 570, 595, 800, 810, 825, 870, 890, and MMA

– Blade model 7998-61X

Note that the Rational Team Concert for i client is an optional installation feature

of Rational Developer for i. Because Rational Developer for i is the foundational

software on which Rational Team Concert for i can be used, this Rational Team

Concert for i Installation Guide will frequently refer you to the Rational Developer

for i Installation Guide for installation information.

Get more information about hardware requirements for the Rational Team Concert

for i client and Rational Developer for i in the hardware requirements listed in the

Rational Developer for i Installation Guide.

Software requirements

The following are software requirements for Jazz Team Server for i.

Prerequisites for Jazz Team Server for i

Make sure that you have the following prerequisite applications installed and

operational before you proceed with the Jazz Team Server for i installation on IBM

i.

v IBM i 5.4 or 6.1 with the following program temporary fixes (PTFs):

IBM i 5.4

- SI31547 for product 5722JC1 (IBM Toolbox for Java™)

- SI32280 for product 5722SS1 (IBM i) IBM i 6.1

- SI31554 for product 5761JC1 (IBM Toolbox for Java)

- SI31976 for product 5761SS1 (IBM i)v IBM J2SE 5.0 32-bit JVM with the applicable Group PTF applied:

– IBM i 5.4

© Copyright IBM Corp. 2008 1

http://download.boulder.ibm.com/ibmdl/pub/software/awdtools/rdi/v75/75/documents/install_instruction/

- SF99291 for product 5722JV1– IBM i 6.1

- SF99562 for product 5761JV1v WebSphere Application Server V6.1 or WebSphere Application Server - Express

V6.1 with the latest group PTF applied (both are product 5733W61).

v IMPORTANT: By default, the application server is configured to use the IBM i

Java Developer Kit 5.0 JVM (also known as the classic JVM). Rational Team

Concert for IBM i requires IBM J2SE 5.0 32-bit JVM. For instructions, see

enablejvm command in the WebSphere Application Server Information Center.

Prerequisites for Build System Toolkit for i

Installing Build System Toolkit for i requires:

v IBM i 5.4 or 6.1

v To compile RPG, COBOL, C, C++, CL, or DDS on IBM i using Build System

Toolkit for i, the compilers must be installed. The IBM i compilers are in product

5722WDS for IBM i 5.4 and 5761WDS for IBM i 6.1.

v IBM J2SE 5.0 32-bit JVM with the applicable group PTF applied:

– IBM i 5.4 - SF99291 for product 5722JV1

– IBM i 6.1 - SF99562 for product 5761JV1

Prerequisites for Rational Team Concert for i client and

Rational Developer for i

For more information about Rational Team Concert for i and Rational Developer

for i prerequisites, refer to the installation requirements in the Rational Developer

for i Installation Guide.

The Rational Team Concert for i client requires one of the following operating

systems:

v Windows Vista Business x86-32, SP1 or later

v Windows Vista Enterprise x86-32, SP1 or later

v Windows Vista Ultimate x86-32, SP1 or later

v Windows XP Professional Service Pack 2 x86-32 or later

Prerequisites for Rational Team Concert for i Web client

To access Jazz Team Server using the Rational Team Concert for i Web client, one

of the following browsers is required:

v Microsoft® Internet Explorer 7

v Mozilla Firefox 2

For additional online information about Rational Team Concert for i, see the online

Information Center at


You can also register at jazz.net at

https://jazz.net/pub/user/register.jsp

2 IBM Rational Team Concert for i Installation Guide

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.base.iseries.doc/info/iseries/ae/rxml_enablejvm.html




https://jazz.net/pub/user/register.jsp

Chapter 2. Installing Jazz Team Server for i and Build System

Toolkit for i

Jazz Team Server for i and Build System Toolkit for i are packaged in several ways

and with different editions and licensing as follows:

v Edition: Standard or Express

v Media: CD or electronic image via Passport Advantage® download

v License: Trial or permanent

In each case, the product is delivered as a complete zip file containing two

additional zip files: one for the Jazz Team Server for i and one for the Build System

Toolkit for i. Regardless of your installation package combination (Express or

Standard, trial or permanent, CD or electronic image), copy the complete zip file to

a specified directory on your IBM i system, unzip all of the files, and then continue

with the configuration of the Jazz Team Server for i.

For information to help you choose the Jazz Team Server for i edition and

installation method that are right for you, see the editions and licenses information

in the Rational Team Concert for i Information Center. To purchase and download

the Jazz Team Server for i and Build System Toolkit for i packages, go to the

Passport Advantage Web site at

http://www.ibm.com/support/docview.wss?rs=727&uid=swg24020826.

The procedures listed below vary slightly, depending on file names and media

type. Click the link below that applies to your installation package, complete those

steps, then proceed with configuring the Jazz Team Server for i.

Note: All Jazz Team Server for i and Build System Toolkit for i licenses are first

installed only as trials by default, but you can convert a trial licence to a

permanent license by downloading the Server Activation Key from the

Passport Advantage Web site. For more information, consult “Licensing

considerations” on page 15.

v For instructions for installing the Express Edition with a CD, go to “Installing

Jazz Team Server for i Express Edition and Build System Toolkit for i from a

CD” on page 4.

v For instructions for installing the Express Edition with an electronic image, go to

“Installing Jazz Team Server for i Express Edition and Build System Toolkit for i

from an electronic image” on page 4.

v For instructions for installing the Express Trial Edition with an electronic image,

go to “Installing Jazz Team Server for i Express Trial Edition and Build System

Toolkit for i from an electronic image” on page 5.

v For instructions for installing the Standard Edition with a CD, go to “Installing

Jazz Team Server for i Standard Edition and Build System Toolkit for i from a

CD” on page 5.

v For instructions for installing the Standard Edition with an electronic image, go

to “Installing Jazz Team Server for i Standard Edition and Build System Toolkit

for i from an electronic image” on page 6.



http://www.ibm.com/support/docview.wss?rs=727&uid=swg24020826

v For instructions for installing the Standard Trial Edition with an electronic

image, go to “Installing Jazz Team Server for i Standard Trial Edition and Build

System Toolkit for i from an electronic image” on page 6.

Installing Jazz Team Server for i Express Edition and Build System

Toolkit for i from a CD

1. Insert the installation CD into the Windows workstation CD drive.

2. Create the following directory in your integrated file system (IFS) on IBM i, for

storing Jazz Team Server and Build System Toolkit files: /QIBM/ProdData/RTCi/V1.0/Express. This directory is referred to as <JazzInstallDirectory>.

3. Copy the RTCi-Server-Express-Build-System-Toolkit-V1.0.zip file to this

directory.

4. From the main menu on IBM i, type the qsh command.

5. After you are in Qshell, change directories to /QIBM/ProdData/RTCi/V1.0/Express and unzip the file using the following command:

jar -xf RTCi-Server-Express-Build-System-Toolkit-V1.0.zip

This command results in the Jazz Team Server for i and Build System Toolkit

for i zip files being extracted from the combined zip file (Build-System-Toolkit-on-i-V1.0.zip and Jazz-Team-Server-on-i-Express-V1.0.zip).

Repeat the jar -xf command for each of these additional zip files.

6. To complete the installation of the Jazz Team Server for i, see Chapter 3,

“Configuring your installation,” on page 7.

Installing Jazz Team Server for i Express Edition and Build System

Toolkit for i from an electronic image

1. Download all required parts of the product image from IBM Passport

Advantage to a temporary directory on your Windows workstation (for

example, c:\RTCi10).

2. Create the following directory in your integrated file system (IFS) on IBM i for

storing the Jazz Team Server and Build System Toolkit files:

/QIBM/ProdData/RTCi/V1.0/Express. This directory is referred to as

<JazzInstallDirectory>.

3. Copy the RTCi-Server-Express-Build-System-Toolkit-V1.0.zip to this directory.



jar -xf RTCi-Server-Express-Build-System-Toolkit-V1.0.zip


for i zip files being extracted from the combined zip file (Build-System-Toolkit-on-i-V1.0.zip and Jazz-Team-Server-on-i-Express--V1.0.zip).





Installing Jazz Team Server for i Express Trial Edition and Build

System Toolkit for i from an electronic image






/QIBM/ProdData/RTCi/V1.0/Express. This directory is referred to as


3. Copy the RTCi-Server-Express-Trial-Build-System-Toolkit-V1.0.zip to this

directory.



jar -xf RTCi-Server-Express-Trial-Build-System-Toolkit-V1.0.zip


for i zip files being extracted from the combined zip file (Build-System-Toolkit-on-i-V1.0.zip and Jazz-Team-Server-on-i-Express-Trial-V1.0.zip).




Installing Jazz Team Server for i Standard Edition and Build System

Toolkit for i from a CD

1. Insert the installation CD into the Windows workstation CD drive.



/QIBM/ProdData/RTCi/V1.0/Standard. This directory is referred to as


3. Copy the RTCi-Server-Standard-Build-System-Toolkit-V1.0.zip to this

directory.


5. After you are in Qshell, change directories to /QIBM/ProdData/RTCi/V1.0/Standard and unzip the file using the following command:

jar -xf RTCi-Server-Standard-Build-System-Toolkit-V1.0.zip


for i zip files being extracted from the combined zip file (Build-System-Toolkit-on-i-V1.0.zip and Jazz-Team-Server-on-i-Standard-V1.0.zip).




Chapter 2. Installing Jazz Team Server for i and Build System Toolkit for i 5

Installing Jazz Team Server for i Standard Edition and Build System

Toolkit for i from an electronic image








3. Copy the RTCi-Server-Standard-Build-System-Toolkit-V1.0.zip to this

directory.



jar -xf RTCi-Server-Standard-Build-System-Toolkit-V1.0.zip.


for i zip files being extracted from the combined zip file (Build-System-Toolkit-on-i-V1.0.zip and Jazz-Team-Server-on-i-Standard-V1.0.zip).




Installing Jazz Team Server for i Standard Trial Edition and Build

System Toolkit for i from an electronic image








3. Copy the RTCi-Server-Standard-Trial-Build-System-Toolkit-V1.0.zip to this

directory.



jar -xf RTCi-Server-Standard-Trial-Build-System-Toolkit-V1.0.zip.


for i zip files being extracted from the combined zip file (Build-System-Toolkit-on-i-V1.0.zip and Jazz-Team-Server-on-i-Standard-Trial-V1.0.zip).





Chapter 3. Configuring your installation

After successfully installing the required and optional components, complete the

following tasks to configure your installation.

Edit the following items in <JazzInstallDirectory>/jazz/server/teamserver.properties. Be careful when editing the properties and .ini files. Use

Wordpad, Rational Developer for System i™ Remote System Explorer, or EDTF to

ensure that you correctly format the files.

1. Replace jazzDBuser with a user ID with the authority to create and write to a

library on the system.

2. Replace jazzDBpswd with a password for jazzDBuser.

Note: Do not modify password={password}.

3. By default, Jazz Team Server will create and use the library JAZZREPO01 in

QSYS.LIB as its repository. If you want to use a different library, uncomment

the line (remove the pound sign) with

com.ibm.team.repository.db.db2i.schema.name, and replace JAZZREPO01 with

the name of the library you want to use. See the following example.

Note: The com.ibm.team.repository.db.jdbc.location line has been wrapped

in this example. In your code, that setting and the parameters should be

on one line. Also, information about commenting lines can usually be

ignored, as the relevant lines should already be commented out (or in).#

# DB2i configuration

#

# Uncomment the following lines, customize the location to use DB2i

com.ibm.team.repository.db.vendor = DB2i

com.ibm.team.repository.db.jdbc.location=//localhost;hold statements=true;

user=jazzDBuser;password={password};

com.ibm.team.repository.db.jdbc.password=jazzDBpswd

com.ibm.team.repository.db.db2i.schema.name=MYREPO

4. Optional: Rational Team Concert for i supports IBM i local authentication and

LDAP for security. If you are using local operating system authentication for

WebSphere Application Server security, you also need to add the following

statement to teamserver.properties:

com.ibm.team.repository.user.registry.type=UNSUPPORTED

Creating Jazz Team Server database tables

The Repository Tools application is a standalone application that provides a way to

manage a Jazz Team Server for i repository database, including creating and

migrating the repository database.

By running this application with various parameters, you can perform commands

on the repository database. For example, use the -createTables parameter to create

the repository database.

With Jazz Team Server for i, you can launch the application using a script from

within a QShell session. The repository tools shell script is located in

<JazzInstallDirectory>/jazz/server and is called repotools.qsh. Change directories


to <JazzInstallDirectory>/jazz/server. Run the command ./repotools.qsh

-createTables to create the database tables for a Jazz Team Server repository.

Notes:

1. The path for the log can be passed directly to the command. For example,

./repotools.qsh -createTables logFile=/QIBM/UserData/User1/createRTCiTables.log

2. By default, this command looks for configuration information in a

teamserver.properties file in the current directory, and uses the configuration

parameters in that file to create the repository. It uses the user ID and password

you specified in that file to create the repository library and tables, and will

create the repository in the library using the name you specified (if you

changed the default from JAZZREPO01).

3. By default, this command will create a log file called

repotools_createTables.log, which contains information that is recorded when

you create the tables, and also a statement about whether you created the tables

successfully. This log file is created in the current directory unless you provide

a different file path. If you want to use a different log file name, you can

change it using this command as an example: ./repotools.qsh -createTables

logFile=createRTCiTables.log.

4. Go to Migrating > Migrating the Jazz Team Server at the Rational Team

Concert for i Information Center for more information about the repository

tools application.

Setting up WebSphere Application Server

Before you can set up Jazz Team Server for i, you must create a WebSphere

Application Server runtime environment. This runtime environment is defined by a

profile that you can modify, and it includes all of the files that the server processes

in the runtime environment. (These are files that you can change.) During

WebSphere Application Server installation, a default profile named default is

created. The default profile is a standalone application server profile that contains

a single application server called server1. You can choose to use this default profile

for Jazz Team Server for i, or, to create a new, standalone application server, you

can create a new profile using the manageprofiles command.

Consult either “Frequently asked questions” on page 20 or the WebSphere

Application Server 6.1 Information Center at http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp. You can find information about creating and

managing WebSphere Application Server profiles, WebSphere Application Server

administration, and WebSphere Application Server security. You can also refer to

the manageProfiles command, found in the bin directory of your WebSphere

Application Server installation. For example: /QIBM/ProdData/WebSphere/AppServer/V61/Base/bin.

The steps that follow in this guide are intended to provide you only with basic

WebSphere Application Server configuration guidance, and not complete

instructions for WebSphere Application Server administration. For the following

topics, refer to the WebSphere Application Server that you are using for the Jazz

Team Server for i. This server might be the default server, or it might be a new

server that you created solely for the Jazz Team Server for i. In this document, this

server is referred to as <yourWASInstanceName>.




http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp


After you have determined whether you will use the default WebSphere

Application Server or a new server, deploy the Jazz Team Server for i to your

WebSphere Application Server.

Setting up your WebSphere Application Server with Jazz Team Server for i takes

place in four parts:

v “Part 1: Setting Java Virtual Machine parameters”

v “Part 2: Securing WebSphere Application Server” on page 10

v “Part 3: Installing the Jazz Web archive file” on page 12

v “Part 4: Verifying the installation” on page 14

Before you continue, run the following command from any directory within

QShell to give read and write access from Jazz Team Server for i to the /tmp

directory:

v chmod -R 777 /tmp

Part 1: Setting Java Virtual Machine parameters

WebSphere Application Server Java Virtual Machine (JVM) properties are required

to point to your directories and files. These parameters are automatically set up

using a provided script.

To set the JVM parameters, complete the following steps:

1. Log on to IBM i, and enter the QSH command.

2. To start the server, navigate to the directory containing the WebSphere

Application Server commands and executable files. For example: cd

/QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/<yourWASInstanceName>/bin.

3. Start the server using the ./startServer command. When the server has started,

the system will provide a port number that you can use to access the

WebSphere Application Server Integrated Solutions console. For example:

CPC1221: Job 107206/QEJBSVR/SERVER1 submitted to job queue QWASJOBQ in

library QWAS61.

CWNATV00I: Application server server1 in profile default has started and is

ready to accept connections on admin port 9060.

4. To access the WebSphere Application Server console, replace

<yourWASAdminPortNumber> with the port number the system provided in

the following URL: http://<yourServerHostName>:<yourWASAdminPortNumber>/ibm/console

5. Log on to the WebSphere Application Server Integrated Solutions console.


A user ID is not needed because security is not set.

6. Expand Environment, select WebSphere Variables, and click the right arrow

to go to Page: 2 of 2.

7. From the list of names, copy the information from the Value fields for the

following variable names and paste to a text editor file:

USER_INSTALL_ROOT, WAS_CELL_NAME, and WAS_SERVER_NAME.

8. Add /bin to the directory path value you pasted for USER_INSTALL_ROOT.

For example: /QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/<yourWASInstanceName>/bin.

9. Navigate to the script directory script_py where your Jazz Team Server for i is

installed on IBM i:

cd /<JazzInstallDirectory>/jazz/server/script_py.

10. Modify the RTCi_JVM.qsh with the USER_INSTALL_ROOT value you pasted

and modified in a previous step.

11. In the qsh command line, invoke the script to populate the JVM custom

properties using the following command: ./RTCi_JVM.qsh.

If the server is secure, you will also be prompted for your user name and

password. The WebSphere Application Server will also prompt you for your

WAS_CELL_NAME and WAS_SERVER_NAME.

12. When you are prompted to indicate a Maximum Heap Size, it is

recommended that you indicate a value of 768 MB; however, you can also

choose instead to set the value to match your available IBM i memory.

Part 2: Securing WebSphere Application Server

The Jazz Team Server requires that WebSphere Application Server administrative

security and application security are enabled. The Jazz Team Server for i uses the

functions of WebSphere Application Server security to validate user IDs and

passwords. In addition, WebSphere Application Server security is used to assign

Jazz Team Server for i repository permissions to a particular user ID. This

assignment can be done for individual users or groups of users, based on the

facilities of the security provider. This mapping of user IDs to repository


permissions is discussed further in “Part 3: Installing the Jazz Web archive file” on

page 12. For more information about the WebSphere Application Server, go to

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp.

“Securing WebSphere Application Server with IBM i authentication” and “Securing

WebSphere Application Server with LDAP” introduce information on securing the

WebSphere Application Server with either IBM i or LDAP authentication.

Securing WebSphere Application Server with IBM i

authentication

The following steps describe one way to secure the WebSphere Application Server

using IBM i as the security provider.

Note: Your WebSphere Application Server must be running to complete these

steps.

1. Navigate to the WebSphere Application Server administration directory using

the cd command. For example: cd /QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/<yourWASInstanceName>/bin.

2. Use the wsadmin command to start the WebSphere Application Server

administration tool. For example:

./wsadmin

WASX7209I: Connected to process "server1" on node LOTI19 using

SOAP connector ; The type of process is: UnManagedProcess

WASX7029I: For help, enter: "$Help help"

3. Secure the WebSphere Application Server profile with a valid user ID and

password by entering the following command: securityon <yourUserID>

<yourPassword>. This user ID and password will be used to access the secure

WebSphere Application Server administrative console, and has authority to stop

the application server after it is secured.

4. Use the quit command to stop the WebSphere Application Server

administration tool.

5. For the changes to take effect, you must stop the server using the ./stopServer

command and restart it using the ./startServer command in

/QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/<yourWASInstanceName>/bin. When the server has restarted, a message

should display that is similar to the following:

CPC1221: Job 107206/QEJBSVR/SERVER1 submitted to job queue QWASJOBQ in

library QWAS61.

CWNATV00I: Application server server1 in profile default has started and is

ready to accept connections on admin port 9060.

Securing WebSphere Application Server with LDAP

If you want to secure your Jazz Team Server for i by requiring users to

authenticate through an LDAP server, you must secure your WebSphere

Application Server with LDAP. You can configure your server to use LDAP

security in one of several ways. Please review the following articles for information

about configuring WebSphere Application Server security using LDAP:

v http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/topic/com.ibm.websphere.express.doc/info/exp/ae/tsec_ldap.html

v https://jazz.net/learn/LearnItem.jsp?href=content/tech-notes/jazz-team-server-1_0-was-ldap-realm-setup/index.html

v https://jazz.net/jazzdocs/topic/com.ibm.team.install.doc/topics/c_plan_identity_management.html



http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/topic/com.ibm.websphere.express.doc/info/exp/ae/tsec_ldap.html

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/topic/com.ibm.websphere.express.doc/info/exp/ae/tsec_ldap.html

https://jazz.net/learn/LearnItem.jsp?href=content/tech-notes/jazz-team-server-1_0-was-ldap-realm-setup/index.html

https://jazz.net/learn/LearnItem.jsp?href=content/tech-notes/jazz-team-server-1_0-was-ldap-realm-setup/index.html

https://jazz.net/jazzdocs/topic/com.ibm.team.install.doc/topics/c_plan_identity_management.html


Notes:

1. Ignore any references in these articles to Tomcat or Derby, as these are not

applicable to Rational Team Concert for i.

2. You must be a registered user of jazz.net to access articles on that site.

3. To use LDAP for security, you must have an LDAP server to use with the Jazz

Team Server for i.

4. To get basic information about setting up IBM Tivoli® Directory Server for i

(LDAP), go to

http://publib.boulder.ibm.com/infocenter/systems/topic/rzahy/rzahy.pdf

After you have secured the WebSphere Application Server with LDAP, you can use

user IDs and groups from your LDAP server to grant Jazz Team Server for i

repository permissions, and also to create Jazz Team Server for i repository users

that map to LDAP users.

For information about Rational Team Concert for i server administration

configuration of the WebSphere Application Server, go to http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp

Note: You must perform LDAP authentication in the WebSphere Application

Server console.

Part 3: Installing the Jazz Web archive file

The Jazz Team Server for i is composed of a Web archive file called jazz.war, along

with certain other dependent files. The jazz.war file must be installed on your

WebSphere Application Server if you want to be able to use the Jazz Team Server

for i. Use the following procedure on the WebSphere Application Server Integrated

Solutions console to install the file:

1. Use a Web browser to log on to the WebSphere Application Server Integrated

Solutions console with a URL like http://<yourServerHostName>:<yourPortNumber>/ibm/console/. For example,

http://<yourServerHostName>:9060/ibm/console

If you have already enabled WebSphere Application Server security, you will

be redirected to a secure port.

2. Expand Applications, then click Enterprise Applications.

3. On the Enterprise Applications window, click Install.

4. For Path to new application, select Remote file system.

5. Browse to the jazz.war file at <JazzInstallDirectory>/jazz/server/jazz.war.

Note: Select a node name to browse the file system. For more information on

WebSphere Application Server node names, go to http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp

6. Set Context root to /jazz.

7. Under How do you want to install the application?, select Show me all

installation options and parameters and click Next.

8. Complete each subsequent step, accepting all defaults until you get to Map

security roles to users or groups. The security roles and levels of access

defined by the Jazz Team Server include:

JazzAdmins

Jazz repository administrators with full read-write access


http://publib.boulder.ibm.com/infocenter/systems/topic/rzahy/rzahy.pdf





JazzDWAdmins

Jazz repository administrators with specific permissions to control the

data warehouse on a Jazz Team Server

JazzGuests

Users with read-only access to the Jazz repository

JazzUsers

Users with regular read-write access to the Jazz repositoryThere are two options for mapping security roles. If you have many users, it

is more efficient to create group profiles on IBM i and map those groups to

Jazz Team Server roles rather than mapping a large number of individual

users.

To map groups of users to Jazz Team Server roles (recommended):

a. On IBM i, create Group Profiles using names such as

JAZZADMINS, JAZZDWADMS, JAZZGUESTS, JAZZUSERS.

(There is a ten-character limit.)

Note: These group profile names are suggestions only. You can

choose to assign any group profile name you prefer (up to

ten characters in length).For more information about creating group profiles on IBM i, go to

“Frequently asked questions” on page 20.

b. Assign users to the appropriate group profiles.

c. On the WebSphere Application Server Integrated Solutions console,

use Look up groups to map those groups of users to their

corresponding roles.

1) Select JazzAdmins and click Look up groups.

2) On the next screen, click Search, and select at least one group

from the Available list and move it to Selected using >>.

Note: The WebSphere Application Server console displays only

those groups that have at least one user assigned.

3) Repeat these steps for JazzDWAdmins, JazzUsers, and

JazzGuests.

To map individual users to Jazz Team Server roles:

a. Select JazzAdmins and click Look up users.

b. On the next screen, click Search, and select at least one user ID

from the Available list and move it to Selected using >>.

c. Repeat these steps for JazzDWAdmins, JazzUsers, and JazzGuests.

Note: This setup is different if you use LDAP security. The users and groups

in this case would correspond to user IDs or groups on your LDAP

server. For more information on LDAP security and Jazz, see

https://jazz.net/jazzdocs/topic/com.ibm.team.install.doc/topics/c_plan_identity_management.html.

9. Click Finish, then Save directly to the master configuration. When the save

is complete, a red x is displayed under Application status for jazz.war.

10. Start jazz.war.

The jazz.war file is now installed.




Part 4: Verifying the installation

Complete the following steps to ensure the application is installed and set up

properly:

1. The WebSphere Application Server logs provide informational and error

messages related to the Jazz Team Server. You must verify that the correct JVM

is being used by this application server instance. For example, navigate to

/QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/<yourWASInstanceName>/logs/<yourWASInstanceName> and check the

SystemOut.log.

2. Verify that J9VM is initiated by ensuring the first lines of the log include text

that refers to the IBM J9 JVM. Your log should be similar to the following:

Java version = J2RE 1.5.0 IBM J9 2.3 OS400 ppc-32 j9vmap3223-20080315

(JIT enabled)

J9VM - 20080314_17962_bHdSMr

JIT - 20080130_0718ifx2_r8

GC - 200802_08, Java Compiler = j9jit23, Java VM name = IBM J9

Note: If you find that you are not using the IBM J9 VM, you must use the

enableJVM command with the std32 option to enable it. For example, in

QSH, change the directory to /QIBM/ProdData/WebSphere/AppServer/V61/Base/bin. and run the command enableJVM -jvm std32

-profile MYPROFILE.

3. Access the Jazz Team Server administrative Web interface using the secure port

associated with the application server virtual host to which you installed the

jazz_war application. In a default application server, this is port 9443. Use this

port to access the Jazz Team Server administrative Web interface to verify the

server status using a Web browser, for example, https://<yourServerHostName>.com:<yourJazzServerPortNumber>/jazz/admin. Log in

with a user ID that has JazzAdmins permission and verify that the Server

Status summary does not display any error messages.

Note: If you are unsure of the secure port used for your WebSphere Application

Server profile, you can determine the port from the IBM i HTTP Server

Administration, which you can access at http://<yourServerHostName>:2001/HTTPAdmin. Click the Manage > Application

Servers, and select your WebSphere Application Server profile. Click Server

Ports in the left menu. The Secure HTTP port is where the Jazz server is

available. Use this port as the secure port to access the Jazz Team Server.

Alternately, in a typical WebSphere Application Server configuration, you

can determine the secure port for the Jazz Team Server for i as follows:

1. Log in to the WebSphere Administration Console in the same way that

you did to install the Jazz Team Server Web Archive file. For example:

http://<yourServerHostName>:<yourWASAdminPortNumber>/ibm/console.

2. Click Servers > Application Servers > Communications, then

MYRPROFILE.

3. Select the Configuration tab. Under Comunications, expand the Ports

section. The port name WC_defaulthost_secure is typically the port used

for secure Jazz Team Server for i access.

Completing the installation

The following topic describes how to complete the installation of Rational Team

Concert for i.


Licensing considerations

By default, IBM Rational Team Concert for i is installed with a trial license. If you

are evaluating Rational Team Concert for i with a trial license, you can skip this

section.

To convert a license from trial to permanent, download the Server Activation Key

file from Passport Advantage. In Passport Advantage, right-click the file and select

Save. Install the key by following these steps:

1. Unzip the file to get jazz_team_server_express_i-release.jar or

jazz_team_server_standard_i-release.jar for the Express and Standard editions

respectively.

2. In a Web browser, enter the URL for the Jazz Team Server Administrative page.

For example: https://<yourHostServerName>:<yourJazzServerPortNumber>/jazz/admin.

3. Log in with your Jazz administrative user account.

4. Click Server.

5. In the Configuration section, click License Key Management.

6. In the Server Activation Key section, click Browse.

7. Navigate to the jazz_team_server_express_i-release.jar or

jazz_team_server_standard_i-release.jar file, select it, then click OK to upload

the key.

Note: If you purchase additional IBM Rational Team Concert for i client

licenses from Passport Advantage, download the Contributor and

Developer Client Activation Key files from Passport Advantage. Install

the keys by following steps 2 and 3 above, except that you must click

Browse in the Client Activation Key section, not the Server Activation

Key section. Make sure to enter the number of Contributor or Developer

licenses you have purchased.

8. Save your changes.

After the server is installed, you must also consider some configuration options

before continuing.

v Refer to the Rational Team Concert for i Information Center for important

information about additional administrative tasks, including creating users,

creating project areas and teams, configuring email settings, and configuring

advanced properties.

v Some files contain passwords. Those files should be protected so that they are

readable only by users who are authorized to know the password for the

accounts. The Jazz Team Server for i requires that the database password is

stored in <JazzInstallDirectory>/server/teamserver.properties. When properties

files are saved, the application always makes a backup copy of the previous

version in the same directory. If you want to remove all files that contain the

clear-text password, remove the backup properties files after configuring the

server for the first time.

v If you configured the application server to use ports other than the defaults,

these ports should also be configured in the Jazz Team Server for i configuration.

These port numbers are used for composing URLs for things like feed links and

item links in email notifications. To update the defaults, use the Jazz Team

Server for i administrative Web interface. Click Configuration, then Advanced

Properties to locate the properties below.

com.ibm.team.repository.servlet.internal.ServletConfigurationService

- Repository HTTPS port


com.ibm.team.repository.service.internal.webuiInitializer.

ConfigPropertyInitializer

- URL HTTPS port

Click Edit to enable the editing of these properties, then click Save to save your

changes.

Note: When using IBM i authentication, giving a user access to Jazz Team Server

for i is a three-step process:

1. Create the IBM i user ID. (Check whether a user ID already exists for the

user.)

2. Create a corresponding user in the Jazz Team Server for i repository.

3. Give the Jazz Team Server for i user the correct user permissions, either

by mapping the specific user to a Jazz Team Server for i user role or by

adding the user to a group that is already mapped to a user role.

Installing the Rational Team Concert for i client

This topic provides a link to both an overview and the necessary steps to correctly

and successfully install the Rational Team Concert for i client. For more

information, refer to the installation tasks in the Rational Developer for i

Installation Guide.

v Refer to the Rational Developer for i Installation Guide and installation

scenarios.

v Make sure your check the Rational Team Concert for i Client installable option.

v After you have installed Rational Developer for i, check immediately for

updates, and then do so on a regular basis thereafter. Go to Updating IBM

Rational Developer for i V7.5 and follow the steps provided to upgrade to the

latest level of Rational Developer for i.

If you have already installed Rational Developer for i 7.5 but did not install the

Rational Team Concert for i client, you can modify your Rational Developer for i

7.5 installation to add the Rational Team Concert for i client. See the installation

tasks in the Rational Developer for i Installation Guide and follow the steps

provided to add the optional Rational Team Concert for i client feature.







Chapter 4. Getting started with Rational Team Concert for i

The jazz.net Web site offers many resources to help you get started with Jazz

components and Rational Team Concert. Register at jazz.net and review the

tutorials at https://jazz.net/jazzdocs/topic/com.ibm.team.concert.tutorial.doc/topics/tut_rtc_abstract.html.

The tutorial will teach you to do the following:

v Set up a project and team

v Get connected as a user

v Create and understand work items

v Organize team work

v Save and share source

v Use the Web user interface

v Examine the Jazz build

Expect to spend a few hours to complete the tutorial.

For a faster introduction, see the Jazz technology platform quick reference at

https://jazz.net/jazzdocs/topic/com.ibm.team.platform.doc/topics/c_jazz-platform-quick-ref.html.

For additional information, see Rational Team Concert for i online help at

http://publib.boulder.ibm.com/infocenter/rtcihelp/v1r0m0/index.jsp.

To get started using Rational Team Concert for i, begin with the following online

help topics:

v Managing the Jazz Team Server through the Web interface

v Working with projects, teams, and process

Notes:

1. Jazz Repository permissions cannot be assigned using the Jazz Team Server

Web administration user interface or the Rational Team Concert client. These

must be configured using the WebSphere Application Server administration

console Security Role to User/Group mapping settings for the jazz.war file.

See “Part 3: Installing the Jazz Web archive file” on page 12.

2. Jazz repository user IDs are case sensitive. If you are using IBM i authentication

for your security provider, you should use uppercase Jazz repository IDs.


https://jazz.net/jazzdocs/topic/com.ibm.team.concert.tutorial.doc/topics/tut_rtc_abstract.html

https://jazz.net/jazzdocs/topic/com.ibm.team.concert.tutorial.doc/topics/tut_rtc_abstract.html

https://jazz.net/jazzdocs/topic/com.ibm.team.platform.doc/topics/c_jazz-platform-quick-ref.html

https://jazz.net/jazzdocs/topic/com.ibm.team.platform.doc/topics/c_jazz-platform-quick-ref.html




Chapter 5. Troubleshooting and getting help

The Jazz Team Server for i logs informational, warning, and error messages that

you can use to troubleshoot, and which you might need when you report a

problem. The log4j.properties file controls the log file location and format, and you

can find this file at <JazzInstallDirectory>/jazz/server. By default, the Jazz Team

Server for i records messages in the WebSphere Application Server log files, and

also in a separate jazz.log file, which is located in a directory with a name that is

similar to this:

v /QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/<yourWASInstance>/logs

This log contains only Jazz Team Server for i messages and is not automatically

cleared, so you should delete it periodically when it gets too large.

The WebSphere Application Server files are located in the logs directory for your

server profile and server instance, in a directory with a name that is similar to this:

v /QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/<yourWASInstance>/logs/<yourWASInstance>

To troubleshoot, start with the SystemOut.log and the SystemErr.log, although

other logs in that directory might also contain helpful information. These logs

contain both WebSphere Application Server messages and Jazz Team Server

messages. Note, however, that when one of these logs reaches 1024 MB, the

WebSphere Application Server automatically closes and saves it as one historical

log. You can change this action in the WebSphere Application Server

Administration Console by performing the following steps:

1. Within the WebSphere Administration Console, select TroubleShooting.

2. Select Logs and Trace.

3. Select JVM Logs.

4. Configure the maximum log size and the maximum number of historical files

to keep, according to your preferences.

Tip: For guidance on more effective bug reporting, see How to Report Bugs

Effectively at

http://www.chiark.greenend.org.uk/~sgtatham/bugs.html

Information about Rational Developer for i APAR/PTF is available online at

http://www.ibm.com/software/awdtools/rdi/support/

To find more information about any required Power Systems server PTFs, do the

following:

1. Open the Remote System Explorer perspective. The name of the current

perspective is displayed in the top left corner of the title bar for the Window.

To open the Remote System Explorer perspective, select Window > Open

Perspective > Other, then select Remote System Explorer from the list.

2. Create a connection to IBM i by expanding New Connection > IBM i.

3. Expand your new connection and right-click on IBM i Objects. Select Verify

Connection from the menu. This displays a dialog that shows which required

PTFs are already installed on the system and which ones are missing.


http://www.chiark.greenend.org.uk/~sgtatham/bugs.html

http://www.ibm.com/software/awdtools/rdi/support/

Frequently asked questions

The following are answers to some of the questions that are frequently asked about

installing Rational Team Concert for i.

1. Question:

Can I install the Build System Toolkit for i on a different IBM i system?

Answer:

Yes

1. From the <JazzInstallDirectory>, copy the Build-System-Toolkit-on-i-V1.0.zip to <JazzInstallDirectory> on the remote machine.

2. Unzip the Build-System-Toolkit-on-i-V1.0.zip file using jar -xf

Build-System-Toolkit-on-i-V1.0.zip.

You now have the files you need on the remote IBM i machine to start a

build engine. Configuration and startup of a build engine is discussed in

the Rational Team Concert for i Information Center.

2. Question:

Where are the startserver and stopserver files located and how do I use

them?

Answer:

Navigate to your WebSphere Application Server bin directory. For

example: /QIBM/ProdData/WebSphere/AppServer/V61/Base/bin. Use the

./startserver command to start or the ./stopserver command to stop. If you

need to start or stop a WebSphere Application Server instance other than

the default WebSphere Application Server instance, you can pass the

-profileName parameter to the ./startserver or ./stopserver commands.

3. Question:

How do I create a WebSphere Application Server profile?

Answer:

To create a WebSphere Application Server profile that you can use to start

a new WebSphere Application Server instance, perform the following steps:

1. From QShell, navigate to your WebSphere Application Server

installation directory. For example: cd /QIBM/ProdData/WebSphere/AppServer/V61/Base/bin.

2. Use the manageprofiles command to create a new profile. For example:

./manageprofiles -create -profileName WAS4RTCI.

3. The manageprofiles command will tell you whether you successfully

created the profile, and then direct you to the log file that was

generated when you created the profile.

Note: The process of creating a WebSphere Application Server profile takes

several minutes to complete. This delay is normal.4. Question:

How do I create IBM i group profiles?

Answer:

v The following are examples of IBM i commands that can be used to

create group profiles on IBM i to be used with the Jazz Team Server for

i:

– crtusrprf usrprf(JAZZADMINS) password(*none) grpprf(*none)

text(’Group profile for JAZZADMINS’)

There are four user roles associated with the Jazz Team Server for i

application:

– JazzAdmins

– JazzDWAdmins

– JazzUsers

– JazzGuests



You can create a separate group for each of these roles by repeating the

command above with a different usrprf name.v To assign a valid user ID to a group, use the command chgusrprf

usrprf(MONDIEU) grpprf(JAZZADMINS).

v You can also assign a supplemental group.

Consult the IBM i Info Center for additional information.

5. Question:

How do I manually set up WebSphere Application Server JVM parameters

(without a script)? Also, what are these settings used for, and how do I

verify that they are correct?

Answer:

The Jazz Team Server for i requires that several WebSphere Application

Server JVM custom properties are set so that you can locate necessary

configuration files. These values are set using the RTCi_JVM.qsh

command during the installation process. If these properties are somehow

set incorrectly, or if the contents of the configuration files are incorrect, the

Jazz Team Server for i will not initialize properly.

Note: Be careful when you edit the properties and .ini files. Use Wordpad,

Rational Developer for i Remote System Explorer, or EDTF to ensure

that the files are formatted correctly.To view the JVM parameters, complete the following steps:

1. Log in to IBM i and enter the QSH command.

2. To start the server, navigate to the directory containing the WebSphere

Application Server commands and executable files. For example: cd

/QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/<yourWASInstance>/bin.

3. Start the server using the ./startServer command. When the server has

started, the system will provide a port number that you can use to

access the WebSphere Application Server Integrated Solutions console.

For example:

CPC1221: Job 107206/QEJBSVR/SERVER1 submitted to job queue QWASJOBQ

in library QWAS61.

CWNATV00I: Application server server1 in profile default has started

and is ready to accept connections on admin port 9060.

4. To access the WebSphere Application Server console, replace

portnumber with the port number the system provided at

http://<yourServerHostName>:<yourWASAdminPortNumber>/ibm/console. For example: http://<yourServerHostName>:9060/ibm/console.

5. Log in to the WebSphere Application Server Integrated Solutions

console.

6. Expand Servers, click Application servers, and select

yourApplicationServer.

7. On the Configuration tab, under Server Infrastructure, expand Java

and Process Management and click Process Definition.

8. Under Additional Properties, click Java Virtual Machine.

9. Under Additional Properties, click Custom Properties.

10. Verify that the following values for the property fields are correct.

Specifically, make sure that they are correct for your system

configuration; in other words, that these values correctly point to the

referenced properties files and the provision_profiles directory:

Chapter 5. Troubleshooting and getting help 21

http://publib.boulder.ibm.com/iseries/

Table 1. Property values to enter in WebSphere Application Server

Property Value to enter

DB2I_JDBC /QIBM/ProdData/http/public/jt400/lib

a

com.ibm.team.repository.provision.profile <JazzInstallDirectory>/jazz/sever/provision_profiles

com.ibm.team.server.configURL file:///<JazzInstallDirectory>/jazz/server/teamserver.properties

java.awt.headless true

log4j.configuration file:///<JazzInstallDirectory>/jazz/server/log4j.properties

org.eclipse.emf.ecore.plugin.EcorePlugin

.doNotLoadResourcesPlugin

true

OPTIONAL: user.timezone America/New_York

b

Notes:

a. Ensure that is the correct directory for your installation.

b. Set the timezone according to your region. For details, see Time

zone IDs that can be specified for the user.timezone property at

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp.

11. If you need to make changes, save directly to the master

configuration, then stop and restart the application server. Wait until

you have completed this section before stopping and restarting the

server.

12. Edit <JazzInstallDirectory>/jazz/server/provision_profiles/profile.ini. Replace:

url=file:./<JazzInstallDirectory>/jazz/server/update-site

with the full path to your jazz/server/update-site directory.

For example:

url=file:/QIBM/UserData/RTCi/V1/TeamServer/jazz/server/update-site

13. Edit <JazzInstallDirectory>/jazz/server/provision_profiles/profilei.ini. Replace:

url=file:./<JazzInstallDirectory>/jazz/server/update-site

with the full path to your jazz/server/update-site directory. For

example:

url=file:/QIBM/UserData/RTCi/V1/TeamServer/jazz/server/update-site

The property com.ibm.team.repository.provision.profile points to a

directory that contains three .ini files. These .ini files are used by the

Jazz Team Server for i to ″provision," or to locate and load, additional

features and plug-ins from configured update sites. You can check

each of these .ini files to make sure that the URL property is correct

for your configuration. The contents should be as described in the

next step and should point to a valid directory on your system.

14. Edit <JazzInstallDirectory>/jazz/server/provision_profiles/i-license-profile.ini. Replace:

url=file:./<JazzInstallDirectory>/jazz/server/license-update-site

with the full path to your jazz/server/license-update-site directory.

For example:

url=file:/QIBM/UserData/RTCi/V1/TeamServer/jazz/server/

license-update-site




You can view the results of this provisioning process from the Jazz

Team Server for i administrative Web interface, using a URL similar to

https://<yourServerHostName>:<yourJazzServerPortNumber>/jazz/admin?internal

15. Click Provision Status in the left pane. If there are error messages

there, you can use them to diagnose any problems.

16. After fixing these problems, reset the Jazz Team Server for i to

reprovision with the new settings.

17. Click Server Reset and restart the server. You can then click to check

the Provision Status again.

Chapter 5. Troubleshooting and getting help 23

Notices

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-0032, 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, MA 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 document 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.

Any performance data contained herein was determined in a controlled

environment. Therefore, the results obtained in other operating environments may

vary significantly. Some measurements may have been made on development-level

systems and there is no guarantee that these measurements will be the same on

generally available systems. Furthermore, some measurement may have been

estimated through extrapolation. Actual results may vary. Users of this document

should verify the applicable data for their specific environment.

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.

All statements regarding IBM’s future direction or intent are subject to change or

withdrawal without notice, and represent goals and objectives only.

This information contains examples of data and reports used in daily business

operations. To illustrate them as completely as possible, the examples include the

names of individuals, companies, brands, and products. All of these names are

fictitious and any similarity to the names and addresses used by an actual business

enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which

illustrates programming techniques on various operating platforms. You may copy,

modify, and distribute these sample programs in any form without payment to

IBM, for the purposes of developing, using, marketing or distributing application

programs conforming to the application programming interface for the operating

platform for which the sample programs are written. These examples have not

been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or

imply reliability, serviceability, or function of these programs. You may copy,

modify, and distribute these sample programs in any form without payment to

IBM for the purposes of developing, using, marketing, or distributing application

programs conforming to IBM’s application programming interfaces.


Each copy or any portion of these sample programs or any derivative work, must

include a copyright notice as follows:

(c) (your company name) (year). Portions of this code are derived from IBM Corp.

Sample Programs. (c) Copyright IBM Corp. _enter the year or years_. All rights

reserved.

Additional legal notices are described in the legal_information.html file that is

included in your Rational software installation.

Trademarks and service marks

IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of

International Business Machines Corporation in the United States, other countries,

or both. If these and other IBM trademarked terms are marked on their first

occurrence in this information with a trademark symbol (® or

™), these symbols

indicate U.S. registered or common law trademarks owned by IBM at the time this

information was published. Such trademarks may also be registered or common

law trademarks in other countries. A current list of IBM trademarks is available on

the Web at “Copyright and trademark information” at www.ibm.com/legal/copytrade.shtml

Microsoft and Windows are trademarks of Microsoft Corporation in the United

States, other countries, or both.

UNIX® is a registered trademark of The Open Group in the United States and

other countries.

Java is a trademark of Sun Microsystems, Inc. in the United States, other countries,

or both.

Intel and Pentium are trademarks or registered trademarks of Intel Corporation or

its subsidiaries in the United States and other countries.

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

others.

Notices 27

��

Printed in USA

IBM Rational Team Concert for i Installation Guide · COBOL applications, you must use Rational...

Documents

Transcript of IBM Rational Team Concert for i Installation Guide · COBOL applications, you must use Rational...