Installing and Running the Build System Toolkit on IBM i System.

Installing and Running the Build System Toolkit on IBM i Systems

Created By: Iftikhar Ahmed Sheikh

Contents

Installing and Running the Build System Toolkit on IBM i Systems. 1

About this task. 1

Procedure. 1

Installing the Build System Toolkit on IBM i Systems

The?Build System Toolkit?can be installed on?IBM? i?using the licensed program installation process.

After restoring the licensed program, the?Build System Toolkit?and Rational? Build Agent are installed in the following directory:/QIBM/ProdData/RTC502/Build/.

Install the?Build System Toolkit?and Rational Build Agent on?IBM i?by completing these steps:

1.???Verify that the system value?QALWOBJRST?(allow object restore) is set to?*ALL.

a.???To check the system value for?QALWOBJRST, enter this command on a 5250 command line:

WRKSYSVAL QALWOBJRST

and select option?5?to display the value. If the value is already set to?*ALL, skip to the next step.

b.???If the value is not?*ALL, take note of the current value so that it can be used to restore the system value later.

c.???To change?QALWOBJRST?system value to?*ALL?enter this command:

WRKSYSVAL QALWOBJRST

to open the?Work with System Values?screen and select option?2, change the value to?*ALL, press?Enter?and then?F3.

2.???Create a library for installation using a 5250 command line and entering the following command:

CRTLIB?RTC_TMP TEXT('RTC INSTALL LIBRARY')

3.???Create these save files. When you are installing the?Build System Toolkit, use these commands:

4.?CRTSAVF FILE(RTC_TMP/BJTS502) TEXT('RTC INSTALL PRODUCT *BASE')

CRTSAVF FILE(RTC_TMP/KJTS502) TEXT('RTC INSTALL PRODUCT Build System Toolkit and Rational Build Agent')

Note:?The?Jazz? Team Server?does not need to be installed, but the base option does.

5.???Upload the save files to the?RTC_TMP?library. Depending on which installation medium you are using, there are two methods for uploading the save files:

Method 1: Installing from Passport Advantage? files or from a DVD using your PC DVD drive

Complete these steps to install from your workstation to your?IBM i?system:

a.???Download the?Build System Toolkit?and Rational Build Agent save file from Passport Advantage. Download the save file to the temporary directory?c:\RTCTMP?on your PC workstation. If you have a product DVD, you could insert the DVD into the DVD drive instead.

b.???Start an FTP session by entering the following command in the MS-DOS Command Prompt:

FTP <yourServerHostName>

where?<yourServerHostName>?is the name of the target?IBM i?system.

c.???When prompted, enter your?IBM i?system user ID and password.

d.???Enter?BIN?to change the FTP type to?BINARY.

e.???Set the file naming convention to?Path?by entering the following:

quote site namefmt 1

f.????Transfer the save file from the Passport Advantage files you downloaded or from the DVD to the?IBM i?system. Run these commands:

put <YourDirectory>\BJTS502.savf /qsys.lib/RTC_TMP.lib/BJTS502.file

put <YourDirectory>\KJTS502.savf /qsys.lib/RTC_TMP.lib/KJTS502.file

where <YourDirectory> is your PC DVD drive or the temporary directory?c:\RTCTMP?where you downloaded the save file.

g.???End your FTP session with this command:

QUIT

h.???Delete?c:\RTCTMP?if you downloaded the save file there.

Method 2: Installing from a DVD using your?IBM i?DVD drive

Complete these steps to install from an?IBM i?DVD:

i.????Insert the DVD into the DVD drive and enter the following command on a 5250 command line:

WRKLNK OBJ('/qopt')

j.????Where the?Work with Object Links?screen displays the?qopt?object link, select?5 (Next Level)?to select the next object link, which is the volume ID (volid) of the DVD-ROM. Record the value here for use later during the installation:

VOL ID _____________________________________________

k.???Run these commands:

CPYFRMSTMF FROMSTMF('/QOPT/<volid>/BJTS502.savf') TOMBR('/qsys.lib/RTC_TMP.lib/BJTS502.file') MBROPT(*replace)

CPYFRMSTMF FROMSTMF('/QOPT/volid>/KJTS502.savf') TOMBR('/qsys.lib/RTC_TMP.lib/KJTS502.file') MBROPT(*replace)

6.???Install the?Build System Toolkit?and Rational Build Agent by entering these commands:

7.?RSTLICPGM LICPGM(5750CL2) DEV(*SAVF) RLS(V5R0M2) SAVF(RTC_TMP/BJTS502)

RSTLICPGM LICPGM(5750CL2) DEV(*SAVF) OPTION(3) RLS(V5R0M2) SAVF(RTC_TMP/KJTS502)

Note:?If your system is not using English as the primary language, you have to specify value 2924 for the LNG parameter of the?RSTLICPGM?command.

When it is restored, these messages display:

*PGM objects for product 5750CL2 *BASE release V5R0M2 restored.

*PGM objects for product 5750CL2 option 3 release V5R0M2 restored.

8.???If you do not intend to install other options of the?Rational Team Concert??licensed programs, change the?QALWOBJRST?value back to the value you recorded earlier in step?1.b?and delete the installation library using this command:

DLTLIB RTC_TMP

Installing and Running the Rational Build Agent on IBM i Systems

The build agent executable file has been installed into?/QIBM/ProdData/RTC502/Build/jazz/buildsystem/buildagent?during the licensed program installation.

Follow these steps to configure an agent:

1.???Edit the?/QIBM/ProdData/RTC502/Build/jazz/buildsystem/buildagent/startbfa.sh?file.

o??Modify the lines that start with?JAZZ_USER= and JAZZ_PASSWORD_FILE=?to the user ID and password file location created for the Jazz? user that will run the builds.

o??Optional: Modify other properties if you want to use a different JVM, for example Java? 7.

2.???Log on to IBM? i and enter the?QSH?command.

3.???Navigate to?/QIBM/ProdData/RTC502/Build/jazz/buildsystem/buildagent.

4.???Run?./startbfa.sh. The default port number in the?IBM i?script is 6666.

Tip:?When you start the Rational Build Agent with the?./startbfa.sh?command, the agent starts in a new job that inherits the same priority as the user. By default, interactive jobs run at a run priority (RUNPTY) of 20. The build agent might use most of the CPU cycles when it is active, causing other interactive jobs run longer. Batch jobs run at a slower run priority?RUNPTY?of 50.

If Rational Build Agent builds are using most of your CPU cycles, change the run priority of the builds to a slower priority. Issuing the following commands in the i/OS command prompt changes the Rational Build Agent run priority to 50. Before you enter the./startbfa.sh?command, remember to navigate to the folder that contains the command.

CHGJOB RUNPTY(50)

QSH

startbfa.sh

exit QSH

CHGJOB RUNPTY(20)

If the Rational Build Agent is already running, you can change the run priority for the agent:

1.???Find the job by entering the?NETSTAT?command.

2.???Identify the port where the agent is running.

3.???Display the job running on that port.

4.???Enter the?CHGJOB?command for the job, and specify the parameter?RUNPTY(50).

Creating encrypted password files

You can create an encrypted password file that you can use with the?Rational Team Concert? Build?toolkit Ant tasks or to start the?Jazz? Build Engine.

Procedure

1.???From a command line, navigate to?installdir/buildsystem/buildengine/eclipse, where?installdir?is the?Build System Toolkitinstallation directory.

2.???Type?jbe -createPasswordFile pass.txt.

Note:?pass.txt?can be any file name.

3.???When prompted, type the password. The password is encrypted and stored in a?pass.txt?file that is located in the?Build System Toolkit?installation directory

Note:?The password file is not strongly encrypted. Any user with access to the file can potentially decrypt it. Set appropriate operating system file permissions on the password file to prevent access from anyone other than the user running the Jazz Build Engine and the Ant tasks. The main benefit of using a password file instead of the password command line argument (for the Jazz Build Engine) or password attribute (for Ant tasks) is to avoid the password being repeated in the clear in build scripts, and the shell history.

Results

Now, instead of specifying passwords in plain text, you can specify an encrypted password file. For example:

<startBuildActivity repositoryAddress="${repositoryAddress}"

?????????????????????????????????userId="${userId}"

?????????????????????????????????passwordFile="/home/user/pass.txt"/>