Configuring the server on IBM i systems

Some installation and configuration tasks are completed automatically when you install the IBM Engineering Lifecycle Management licensed program on IBM i.

Complete the following tasks to configure your server on IBM i:

1. Install the Engineering Lifecycle Management licensed programs on IBM i.
   For details, see Installing Jazz Team Server and the IBM Engineering Lifecycle Management applications on IBM i systems.

   When IBM Engineering Workflow Management licensed programs are installed on IBM i, the following tasks are completed automatically:

   • These profiles are created:
     • JAZZADMINS, JAZZDWADMS, JAZZUSERS, JAZZGUESTS and JAZZPJADMS. (You can use these profiles for WebSphere® Application Server user role mapping.)
     • JTSADMIN with password jtsadmpwd. (This user ID and password are used to secure the WebSphere Application Server console and to access the Engineering Workflow Management administrative web user interface.)
     • db2iadmin with password db2iadmpwd (This user ID and password are used to create Jazz Team Server , Engineering Workflow Management, Engineering Test Management application, IBM DOORS® Next application, Lifecycle Query Engine, Link Index Provider, Data Collection Component, Global Configuration (GC) repository and IBM Engineering Lifecycle Optimization Engineering Insights databases.)
     • JTSBUILD with password jtsbldpwd. (This user ID and password are used as the Build Forge Agent JAZZ_USER and is set by default in the Build Forge Agent startup script, startbfa.sh.
       Note: The user ID JTSBUILD is the recommended user to start your build agents because it has the minimum privileges required for impersonation during builds. Impersonation occurs when users request personal builds and override the build agent authentication.
   • Run the following command to set JAVA_HOME to Java 11 at the job-scope:

     ADDENVVAR ENVVAR(JAVA_HOME) VALUE('/QOpenSys/QIBM/ProdData/JavaVM/jdk11/64bit') 
     LEVEL(*JOB)  

     Test for Java 11 by running the following command:

     QSH CMD(‘java -version’)

   • Run repotools to create the JTS, CCM, QM, RM, DCC, GC, and ENI application repository databases.
   • Install the QJTS703 library, which contains the following CL commands for automated Jazz Team Server installation and configuration:

     CFGJAZZSVR

     Creates the server instance in either WebSphere Liberty server Liberty. Option 20 must be installed. It also configures the server instance, secures the server instance using IBM i authentication, and starts the Jazz Team Server.

     STRJAZZSVR

     Starts the already configured Jazz Team Server.

     STPJAZZSVR

     Stops the Jazz Team Server.

     DLTJAZZSVR

     Deletes the server instance used for the Jazz Team Server.

     UPGJAZZSVR

     Upgrades an existing Jazz Team Server from a previous release.

2. Run the CL command QJTS703/CFGJAZZSVR to configure and start the Jazz Team Server using Liberty (option 20 must be installed).
   Note: The JTSADMIN user profile must be assigned *READ permission to any *USRPRF objects for the user IDs that need to authenticate as administrators to the IBM WebSphere Liberty server.

   Press the F4 key to see the parameters and default values, or previously used values, for the command QJTS703/CFGJAZZSVR:

   Configure Jazz Server (CFGJAZZSVR)

   Type choices and press the Enter key.
    PROFILE NAME:  . . . . . . . . .   JTS                     Name        
    *NODE NAME:  . . . . . . . . . .   JTS_NODE                Node        
    HTTPS PORT NUMBER: . . . . . . .   29443                   Name        
    *WAS VERSION:  . . . . . . . . .   V85                     V8,  V85    
    *WAS OPTION:   . . . . . . . . .   BASE                    BASE, Name, 
    *Max Heap Size:  . . . . . . . .   '*'                     *, Size     
    ADMIN USER ID: . . . . . . . . .   JTSADMIN                Name        
    ADMIN PASSWORD:  . . . . . . . .                           Name				
    REPLACE WAS PROFILE: . . . . . .   *NO                     *NO, *YES
    USE A JAZZ AUTH SERVER:  . . . .   *NO                     *NO, *YES

   Note: The lines beginning with an asterisk (*) are only available and displayed when using WebSphere Application Server.
3. When the Jazz Team Server is running, you can use JTSADMIN/jtsadmpwd to access the Jazz Team Server administrative web user interface at https://example.com:<yourJazzServerPortNumber>/jts/admin where <yourJazzServerPortNumber> is the port number you specify on the command QJTS703/CFGJAZZSVR.