IBM Rational Team Concert for i Beta Program

Installation Guide

IBM Rational Team Concert for i Beta Program

Installation Guide

Note! Before using this information and the product it supports, be sure to read the general information under Notices on page 19.

This edition applies to the Beta version of 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. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents
About this book . . . . . . . . . . . v
About this beta program . . . . . . . . . . v Completing the installation . . . . . . . . . 9

Chapter 1. Prerequisites and system requirements . . . . . . . . . . . . 1 Chapter 2. Locating and installing the files . . . . . . . . . . . . . . . . 3 Chapter 3. Configuring your installation
Creating the Jazz Team Server database tables Setting up the WebSphere Application Server Part 1: Setting the Java Virtual Machine parameters . . . . . . . . . . . Part 2: Securing the WebSphere Application with IBM i authentication . . . . . . Part 3: Installing the Jazz Web archive file Part 4: Verifying the installation . . . . . . . .

Chapter 4. Setting up the Rational Team Concert client . . . . . . . . . 11 Chapter 5. Setting up the build engine 13

Chapter 6. Getting started with Rational Team Concert for i . . . . . . . . . . 15 Chapter 7. Troubleshooting and getting help . . . . . . . . . . . . . . . . 17
Frequently asked questions . . . . . . . . . 18

5
. 5 . 5 6 7 7 8

. . . Server . . . . . . . . .

Notices . . . . . . . . . . . . . . 19
Trademarks and service marks . . . . . . . . 21

Copyright IBM Corp. 2008

iii

iv

IBM Rational Team Concert for i Installation Guide

About this book

This installation guide provides information about installing and configuring the beta version of IBM Rational Team Concert for i. Rational Team Concert for i is a collaborative software delivery environment that allows teams to simplify, automate, and govern software delivery on IBM i. This book is for system administrators responsible for installing and maintaining the Rational Team Concert for i client on their workstation and the Jazz Team Server on IBM i. To use this book, you need to be familiar with the Windows and IBM i operating systems. For the latest version of this document, see http://www.ibm.com/support/ docview.wss?rs=3365&uid=swg21305640

About this beta program

Rational Team Concert for i builds on the core Rational Team Concert product by providing a Jazz Team Server and Build System Toolkit that runs on IBM i. This beta is intended to provide early access to the Rational Team Concert for i product. It will provide the same capabilities as the core Rational Team Concert product with the ability to run the Jazz Team Server and Build System Toolkit on IBM i. This beta will not allow management and build of applications written in RPG, COBOL, or EGL. Restrictions: 1. You cannot use the Jazz Team Server setup wizard to configure the Team Server database connection for the Rational Team Concert for i beta product. The required steps are described in this guide. 2. You cannot use the Jazz Team Server setup wizard to assign repository permissions to new users.

Copyright IBM Corp. 2008

vi

IBM Rational Team Concert for i Installation Guide

Chapter 1. Prerequisites and system requirements

Ensure you have the following prerequisite applications installed and operational before you proceed with the installation on IBM i: v IBM i 5.4 or 6.1 with the following PTFs: IBM i 5.4: SI31547 for Product 5722JC1 SI32280 for Product 5722SS1 IBM i 6.1: SI31554 for Product 5761JC1 SI31976 for Product 5761SS1 v WebSphere Application Server V6.1 v IBM J2SE 5.0 32-bit JVM with latest Java group PTF applied Note: 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 at http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/ index.jsp?topic=/com.ibm.websphere.base.iseries.doc/info/iseries/ae/ rxml_enablejvm.html. For support and access to additional online information, register at Jazz.net at https://jazz.net/pub/user/register.jsp.

Copyright IBM Corp. 2008

IBM Rational Team Concert for i Installation Guide

Chapter 2. Locating and installing the files

Complete the following steps to download and install Rational Team Concert for i files. 1. Get the package from the Rational Team Concert for System z and IBM i Open Beta Web site at http://www.ibm.com/services/forms/ preLogin.do?lang=en_US&source=swerpratl-rtciz2008-3 2. Download the following files to a temporary directory:
Table 1. Rational Team Concert for i installation files Description Jazz Team Server for IBM i Rational Team Concert Eclipse-based client OPTIONAL: Build System Toolkit for IBM i File name RTC-TeamServer-on-i-1.0Beta1.zip RTC-Client-for-i-and-z-1.0Beta1.zip RTC-BuildSystemToolkit-on-i-1.0Beta1.zip

3. Create a directory in your integrated file system (IFS) on IBM i for storing the downloaded files. For example, you can create a directory structure /QIBM/UserData/RTCi/V1/TeamServer but you can use any directory to which you have write access. This directory will be referred to as <yourDirectory> in the following steps. Copy RTC-TeamServer-on-i-1.0Beta1.zip to the directory you created. 4. Unzip the file using the following steps: v From the main menu, type the qsh command v Once you are in QShell, change directories using the cd command to the location of the zip file you downloaded. v Use the jar command to unzip the file. For example:
jar xf RTC-TeamServer-on-i-1.0Beta1.zip

You should now have a jazz directory. 5. Edit the following items in <yourDirectory>/jazz/server/teamserver.properties v Replace jazzDBuser with a user ID with the authority to create and write to a library on the system. v Replace jazzDBpswd with a password for jazzDBuser Note: Do not modify password={password}. v By default, Jazz will create and use the library JAZZREPO01 as its repository. If you want to use a different library, uncomment the line with com.ibm.team.repository.db.db2i.schema.name and replace JAZZREPO01 with the name of the library you want to use. For example,
# # DB2i configuration # # Comment out above lines, uncomment the following three lines and customize example location to use DB2i com.ibm.team.repository.db.vendor = DB2i com.ibm.team.repository.db.jdbc.location=//localhost;hold statements=true;

Copyright IBM Corp. 2008

user=jazzDBuser;password={password}; com.ibm.team.repository.db.jdbc.password=jazzDBpswd #com.ibm.team.repository.db.db2i.schema.name=JAZZREPO01

v 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 6. Edit <yourDirectory>/jazz/server/provision_profiles/profile.ini. Replace
url=file:./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

7. Edit <yourDirectory>/jazz/server/provision_profiles/i-license-profile.ini. Replace

url=file:./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

IBM Rational Team Concert for i Installation Guide

Chapter 3. Configuring your installation

After successfully installing the required and optional components, complete the following tasks to configure your installation.

Creating the Jazz Team Server database tables

You can create the Jazz Team Server repository by using the provided repository tools. Run the following command to create the repository library and tables:
./repotools.qsh -createTables

By default, this command looks for 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). This command will create a log file called repotools_createTables.log, which will contain information recorded when creating the tables and a statement about whether creation of the tables was successful. Note: If you create another properties file, for example,teamserver_test.properties then you have to pass it using this command:./repotools.qsh -createTables teamserver.properties=teamserver_test.properties logFile=createTables.log Run the command ./repotools.qsh -createTables to create the database tables for a Jazz Team Server repository. The repository tools file is located in <yourDirectory>/jazz/server. The parameter teamserver.properties can be used to reference a different properties file. This command creates the tablespace and all the required tables and indexes for a Jazz Team Server repository.

Setting up the WebSphere Application Server

Setting up the WebSphere Application Server takes place in four parts: setting the Java Virtual Machine (JVM) parameters, securing the WebSphere Application Server, installing the Jazz Web archive file, and verifying the installation. Before you set up the WebSphere Application Server, run the following commands to provide read and write access to the /tmp directory by the WebSphere Application Server: cd /tmp chmod -R 777 These steps are not intended to provide complete instructions for WebSphere Application Server administration. Instead, these instructions are intended to provide basic guidance. The following sections assume that you are installing the Jazz Team Server to the default WebSphere Application Server instance. If you choose to create a new WebSphere Application Server profile to be used with the Jazz Team Server, you should substitute that profile name for default in the following sections. Consult the WebSphere Application Server 6.1 Information Center at http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/topic/
Copyright IBM Corp. 2008

com.ibm.websphere.base.iseries.doc/info/welcome_base.html for more details on creating and managing WebSphere Application Server profiles and WebSphere Application Server administration.

Part 1: Setting the Java Virtual Machine parameters

To set up the Java Virtual Machine (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/default/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 in the following URL: http://serverip:portnumber/ibm/console 5. Log on 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 and then click New 10. Insert the following values for the property fields:
Table 2. Property values to enter in WebSphere Application Server Property DB2I_JDBC Value to enter /QIBM/ProdData/http/public/jt400/lib a

com.ibm.team.repository.provision.profile <yourDirectory>/jazz/sever/ provision_profiles com.ibm.team.server.configURL java.awt.headless log4j.configuration org.eclipse.emf.ecore.plugin.EcorePlugin .doNotLoadResourcesPlugin OPTIONAL: user.timezone file:///<yourDirectory>/jazz/server/ teamserver.properties true file:///<yourDirectory>/jazz/server/ log4j.properties true America/New_York
b

Notes: a. Ensure that is the correct directory for your installation. b. Set timezone according to your region. See Time zone IDs that can be specified for the user.timezone property at http://publib.boulder.ibm.com/ infocenter/wasinfo/v6r1/topic/com.ibm.websphere.base.iseries.doc/info/ iseries/ae/rrun_svr_timezones.html for details. When complete, your screen should look like the screen below.

IBM Rational Team Concert for i Installation Guide

11. Save directly to the master configuration.

Part 2: Securing the WebSphere Application Server with IBM i authentication

The Jazz Team Server requires that WebSphere Application Server administrative security and application security are enabled. If you choose to secure the WebSphere Application Server using IBM i as the security provider, you need to complete the following steps. Note: This step will be different if you are setting up security using LDAP. 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 1. Navigate to the WebSphere Application Server administration directory using the cd command. For example:
cd /QIBM/UserData/WebSphere/AppServer/V61/base/profiles/default/bin

2. Use the wsadmin command to start the WebSphere Application Server admin 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 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 admin tool. 5. For the changes to take effect, you must stop the server using the ./stopServer command and restart it using the ./startServer command. When the server has restarted, you should have the following message:
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.

Part 3: Installing the Jazz Web archive file

You need to install the Jazz Web archive file jazz.war on your application server. Install the jazz.war file using the WebSphere Application Server Integrated Solutions console by completing the following steps:
Chapter 3. Configuring your installation

1. Use a Web browser to log on to the WebSphere Application Server Integrated Solutions console with a URL like this: http://YourServer:YourPortNumber/ibm/ console/. For example:
http://serverip:9060/ibm/console

2. 3. 4. 5.

If you have already enabled WebSphere Application Server security, you will be redirected to a secure port. Expand Applications, click Enterprise Applications On the Enterprise Applications window, click the Install button For Path to new application, select Remote file system Browse to the jazz.war file at <yourDirectory>/jazz/server/jazz.war

Note: Select a node name to browse the file system. 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. Accept all defaults until you get to Step 8: Map security roles to users or groups. The security roles and levels of access include: JazzAdmins Jazz repository administrators with full read-write access 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 repository 9. Select JazzAdmins and click Look up users Note: This step will be different if you are setting up security using LDAP. 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 10. On the next screen, click Search, and select at least one user ID from the Available list and move it to Selected using >> 11. Repeat steps 8 and 9, for the following groups: JazzDWAdmins, JazzUsers, and JazzGuests 12. Check all the check boxes under All Authenticated and then click Next 13. In Step 9 click Finish and click Save 14. The jazz.war is now installed and will have a red cross shown under Application Status 15. Restart the WebSphere Application Server to use the changes you made to the JVM properties. The Jazz Team Server application should start automatically when you restart the WebSphere Application Server.

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 helpful informational messages and error messages related to the Jazz Team Server. First verify that the correct

IBM Rational Team Concert for i Installation Guide

JVM is being used by this application server instance. For example, navigate to /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/default/logs/server1 and check the SystemOut.log. 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

2. 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 with the following URL: https://yourServer.com:yourSecurePort/jazz/admin. Log in with a user ID that has JazzAdmins permission and verify that the Server Status summary does not show 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://yourSystem:2001/ HTTPAdmin. Click the Manage tab, ->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 will be available. Use this port as the secure port to access the Jazz Team Server.

Completing the installation

After the server is installed, you must consider some configuration options before continuing. v Some files contain passwords. Those files should be protected so that they are readable only by users authorized to know the password for the accounts. The Jazz Team Server requires that the database password is stored in JazzInstallDir/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 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 advanced properties configuration page of the Admin Web UI to modify the following properties:
com.ibm.team.repository.servlet.internal.ServletConfigurationService

- Repository HTTP port - Repository HTTPS port

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

- URL HTTP Port - URL HTTPS Port You are now ready to connect to the server with the Rational Team Concert client or a Web browser.

Chapter 3. Configuring your installation

10

IBM Rational Team Concert for i Installation Guide

Chapter 4. Setting up the Rational Team Concert client

Complete the following steps to install the Rational Team Concert client (also called the Eclipse client) on Windows: 1. Download the client zip file RTC-Client-for-i-and-z-1.0Beta1.zip 2. Extract the .zip file to an installation directory of your choice. Relative to the installation directory you choose, the client path is JazzInstallDir/client. 3. To start the client, double click on the TeamConcert.exe application in the directory JazzInstallDir/client/eclipse. You will use the Rational Team Concert Eclipse client with the Tutorial exercises. See Chapter 6, Getting started with Rational Team Concert for i, on page 15.

Copyright IBM Corp. 2008

11

12

IBM Rational Team Concert for i Installation Guide

Chapter 5. Setting up the build engine

Complete the following steps to set up the build engine on IBM i: 1. Download the Build System Toolkit zip RTC-BuildSystemToolkit-on-i1.0Beta1.zip to an integrated file system (IFS) location on IBM i where you want to run the Jazz Build Engine. For example, /QIBM/UserData/RTCi/V1/ Build. 2. Unzip the file by completing the following steps: a. From the Main Menu, type the qsh command. b. Once you are in QShell, using the cd command, change to the directory where you downloaded the Build System Toolkit zip file c. Use the jar command to unzip the file. For example,
jar xf RTC-BuildSystemToolkit-on-i-1.0Beta1.zip

3. 4.

5.

6.

d. You should now have a jazz directory containing the build engine Change your directory to jazz\buildsystem\buildengine\eclipse. If you have extracted the .zip file to a different directory than /QIBM/UserData/RTCi/V1/Build, then edit jbe.qsh to update the BUILD_ECLIPSE variable to point to your specific directory. Use the Rational Team Concert client to define a build engine. See Lesson 8: Team Builds in the tutorial, Getting Started with Rational Team Concert at https://jazz.net/jazzdocs/index.jsp?topic=/com.ibm.team.concert.tutorial.doc/ topics/tut_rtc_build.html. Start the build engine using the following command:
jbe.qsh -repository REPOSITORYURI -engineID ENGINENAME -userId USERNAME -pass PASSWORD

For example:
./jbe.qsh -repository https://elcrtp21.rtp.raleigh.ibm.com:9444/ jazz -engineID MY_ENGINE -userId JOHNDOE -pass pas1wrd1

7. Look for the following text to indicate a successful startup:

> ./jbe.qsh -repository https://elcrtp21.rtp.raleigh.ibm.com:9444/jazz -engineID MY_ENGINE -userId JOHNDOE -pass pas1wrd1 BUILD_ECLIPSE=<yourDirectory>/jazz/buildsystem/ buildengine/eclipse osgi> 2008-07-01 17:13:13 [Jazz build engine] Running build loop... 2008-07-01 17:13:13 [Jazz build engine] Waiting for request...

Restriction: You must leave this window open for as long as you need the build engine to build. If you get an error message like, cd: 001-0008 Error found changing to directory ..., you have the incorrect directory specified for BUILD_ECLIPSE in jbe.qsh. You have now set up the Jazz Build Engine on IBM i. Note: When this Jazz Build Engine instance processes build requests, the builds are executed under the authority of the user profile that was used to start the engine. As a result, it is possible for users to request builds specifying
Copyright IBM Corp. 2008

13

commands they should not have authority to execute. You can control who is able to request builds by only assigning the Request Build permission to specific roles. It is not recommended that you grant this permission to everyone.

14

IBM Rational Team Concert for i Installation Guide

Chapter 6. Getting started with Rational Team Concert for i

Keep in mind that the Rational Team Concert for i Beta is an early release version. The documentation referenced is included with the distributed version of Rational Team Concert and many but not all of the topics are applicable to Rational Team Concert for i Beta product. The Jazz.net Web site has many resources to help you get started with Jazz components and Rational Team Concert. Register at Jazz.net and see Tutorial: Get started with Rational Team Concert at https://jazz.net/jazzdocs/topic/ com.ibm.team.concert.tutorial.doc/topics/tut_rtc_abstract.html. The tutorial will teach you to: v v v v v v v Set up a project and team Get connected as a user Create and understand work items Organize team work Save and share source Use the Web user interface 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_jazzplatform-quick-ref.html. In addition, see the Rational Team Concert online help at https://jazz.net/jazzdocs/index.jsp for additional information. To get started using Rational Team Concert for i, start with the following online help topics: v Managing the Jazz Team Server through the Web interface at https://jazz.net/ jazzdocs/topic/com.ibm.team.repository.web.admin.doc/topics/ tworkwithadminwebui.html v Working with projects, teams, and process at https://jazz.net/jazzdocs/topic/ com.ibm.team.platform.doc/topics/t_projects_teams_process.html Explore the online help and the Jazz.net Web site for product details, concepts, and troubleshooting for Rational Team Concert, the Jazz platform, and new incubator technologies. 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 7. 2. Jazz repository user IDs are case sensitive. If you are using IBM i authentication for your security provider, you should use upper case Jazz repository IDs.

Copyright IBM Corp. 2008

15

16

IBM Rational Team Concert for i Installation Guide

Chapter 7. Troubleshooting and getting help

The Jazz.net forum and bug tracking page are available for solving problems, creating bug reports, and answering questions related to the Rational Team Concert for i Beta program. To use the forums or open bug reports, first register with Jazz.net. When you receive your password, log on to Jazz.net using those credentials. To use the forum: 1. Browse the Jazz.net forums at https://jazz.net/community/forums.jsp 2. Use the jazz.user forum at https://jazz.net/forums/viewforum.php?f=1 to search for similar problems or questions by clicking the Search link at the bottom of the page 3. To create a new forum topic, click the New topic button, and fill in the following fields: v In the Subject field enter [RTCi] along with a brief topic description. For example, [RTCi] Starting Jazz Team Server generates errors. v Enter a description in the Message body. v Click Submit. To search for or create a bug report or work item, go to the Jazz Bug Tracking page at https://jazz.net/bugs/bugs.jsp to browse or search for bug reports. To search existing bug reports you can use a predefined work item query or create a custom query of your own. To get a list of all of the work items for Rational Team Concert for System z, run the RTC on IBM i work items query. To submit a work item or bug report, complete the following steps: v Click New work item v In the Summary field enter a brief topic description v From the Type list, select Defect (the default option) if you are reporting a problem, or Enhancement if you are suggesting a new feature or improvement. v From the Filed against list, select the (Show All) category and then open the Filed against drop-down list again and choose "RTC on IBM i" v Enter a detailed description in the Description field v Optional: Enter a level of Severity and/or Priority v If you want to add a file attachment or screen capture of the problem, that option is available on the Links tab v Click Save to submit your work item v Record your work item number for future reference You can use the discussion section of the work item to add comments using the Add Comment link on the right of the discussion section at the bottom of the Overview tab. Developers can also add comments or respond to your questions there. You will be notified by e-mail when the work item changes or when comments are added. Tip: For advice on effective bug reporting, see How to Report Bugs Effectively at http://www.chiark.greenend.org.uk/~sgtatham/bugs.html

Copyright IBM Corp. 2008

17

Frequently asked questions

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

and use the ./startserver command to start or the ./stopserver command to stop. Question: Why can't I assign a Client Access License to a user from the Web user interface? Answer: If you are unable to assign Client Access Licenses to users, check the profile.ini and i-license-profile.ini files and ensure that you put all the parameters on the same line.

18

IBM Rational Team Concert for i Installation Guide

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 users 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.

Copyright IBM Corp. 2008

19

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 IBMs 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 IBMs application programming interfaces.

20

IBM Rational Team Concert for i Installation Guide

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. Other company, product, or service names may be trademarks or service marks of others.

Notices

21

22

IBM Rational Team Concert for i Installation Guide

Printed in USA