Creating directories for Jazz Team Server and the Engineering Lifecycle Management applications
The Jazz Team Server (JTS) and each of the IBM® Engineering Lifecycle Management applications installed on z/OS require several directories in addition to the UNIX System Services directory created by the SMP/E installation.
One of the required directories is a working directory and the other required directories are
used to store Jazz Team Server and
Engineering Lifecycle Management
configuration files. There are sample members for each application in
hlq.SBLZSAMP used to create and populate these directories
with the required files from the SMP/E installed directory. The following table lists the sample
member in hlq.SBLZSAMP associated with the installed
application.
| Installed application | Sample member |
|---|---|
| Change and Configuration Management (CCM) - HRCM703 | BLZCPCCM |
| Global Configuration Management - HRGC703 | BLZCPGC |
| Jazz Reporting Service - HRRS703 | BLZCPDCC, BLZCPRS, BLZCPLQE |
| Jazz Team Server (JTS) - HRJS703 | BLZCPJTS |
| Link Index Provider - HRLI703 | BLZCPLDX |
| Quality Management (QM) - HRQM703 | BLZCPQM |
| IBM Engineering Lifecycle Optimization Engineering Insights - HRRE703 | BLZCPRE |
| Requirements Management (RM) - HRRM703 | BLZCPRM |
| IBM WebSphere Liberty - HRWL703 | BLZCPWLP |
You can run sample JCL members based on the components that you installed and plan to configure.
There are also sample members used for configuring the Build System Toolkit
(BLZCPBTK), the Rational Build Agent
(BLZCPBFA), and the Build Manager (BLZCPPVM) on z/OS . For
instructions on running those members, see:
The following three symbolic names are used throughout this guide to indicate the following
directories:
You must use unique directory names for @confPath@ and @workPath@ if you want to
maintain additional configurations for previous versions.
| Symbolic name | Use | Variable in BLZCP* jobs | Default directory |
|---|---|---|---|
| @pathPrefix@ | The path prefix specified during the SMP/E installation. | BLZHOME | |
| @confPath@ | The Jazz Team Server configuration files directory. | BLZCONF | /etc/jazz703 |
| @workPath@ | The Jazz Team Server working directory. | BLZWORK | /u/jazz703 |
Space recommendations: The JTS and Engineering Lifecycle Management
directories must have the following allocations:
- @workPath@
- 6000 cylinders 3390, for running the Jazz Team Server and Engineering Lifecycle Management applications on z/OS . This figure might be larger than required if the server is not running on z/OS or if the server is not running all of the Engineering Lifecycle Management applications. Allocate a file system that allows for significant expansion as your installation grows.
- @confPath@
- 300 cylinders 3390
RACF server file access requirements: The BLZCP* jobs will
create directories that are owned by the user ID that runs the BLZCP* jobs. In addition, the BLZCP*
members contain the @confgrp@ and @workgrp@ variables, which must be set to the SAF groups that
contain all of the user IDs that require write access to the configuration and work directories. You
must also associate group IDs (GID) with these SAF groups. The Jazz Team Server and
Engineering Lifecycle Management
application directories require the following RACF file
access permissions so the server can function:
- The user ID that runs the WebSphere® Liberty server must have read and write access to @confPath@ and @workPath@.
- The user ID that runs the Jazz Team Server repository tools are run must have read and write access to @confPath@ and @workPath@.
The recommended approach to providing access to the working directories and configuration directories is to create a RACF group and assign the IDs to that group that are needed for the functions you plan to use.
In addition to creating and populating these directories, the sample
jobs provided also perform several required customizations. The variables
mentioned in the Symbolic name table, must be set in several places
in each job. In addition there are other variables that might need
to be set listed in the following table:
| Variable Name | Use | Default value |
|---|---|---|
| BLZBFAH | The installation directory of the Rational Build Agent. | /usr/lpp/jazz/7.0.3/buildagent |
| BLZBFAC | The Rational Build agent configuration files directory. | /etc/jazz703/ccm |
| BLZJAVA | The location of the Java directory. | /usr/lpp/java/J11.0_64 |
| BLZHOST | The fully qualified host name where the server is running . | Host.name |
| iconvLoc | The location of the iconv utility. | /bin/iconv |
The instructions contained in each configuration job will indicate which variables you must configure.
For each JOB, configure the sample member in hlq.SBLZSAMP using the instructions contained in the member. Use the SUBMIT command to submit the modified JCL and check the job log. Return codes of 0 indicate the configuration is correct.