Repository tools command to configure the server

Run the setup command from a command-line to set up database, configure email settings, configure the user registry, and register any applications you have just installed.

Purpose

The setup command is a repository tools command that allows you to set up a Jazz® Team Server and associated applications without using the setup wizard. The command may be run in interactive mode to help capture the response file needed to drive future automated installations. Prior to running the setup command, you must have installed the Jazz Team Server and any IBM® Engineering Lifecycle Management (Engineering Lifecycle Management) applications, created your databases, and deployed and started the applications on your application server.

Parameters

Attribute Description Required Default
repositoryURL The connection URL for the server. No https://localhost:9443/jts
adminUserId The administrator user ID to log in to the JAZZ repository. No ADMIN
adminPassword The administrator user ID password to log in to the JAZZ repository. No ADMIN
credentialsFile The file containing the administrator user's login credentials. No credentials.properties
certificateFile The file containing the administrator user's login certificate. No none
smartCard The alias to login using a smart card, or ? to list available aliases. No none
logFile Path to the log file. No repotools-jts_setup.log
parametersFile The location of the setup parameters configuration file. The parameters file contains values for the various wizard step properties. No none
prompt Whether to prompt the user for input if a parameters file is used. If a parameters file is used and this is set to missing, you will be prompted for any missing property values in the parameters file. If a parameters file is used and the prompt value is not set, then an error occurs if any property is missing. If a parameters file is not used, the prompt attribute is not used. No none
responseFile The location to write the response file. The response file is a properties file that has all of the recorded chosen properties that occurred during the setup session. No none
overwrite Whether to overwrite an existing response file. Legal values are yes or no. No no
includeLifecycleProjectStep Set this attribute to true to include an optional step to instantiate lifecycle project templates. This will include a step that allows you to deploy templates such as the Money That Matters sample. No false
kerberos Authenticate with Windows user credentials using Kerberos/SPNEGO by setting to true. Or authenticate with Windows Integrated Authentication by setting to windows. No None
express Use this parameter to run the setup in express mode. Legal values are yes or no with no being the default value. No no

Example

For Windows operating system Open a command prompt and enter this command:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -setup repositoryURL=https://hostname.example.com:9443/jts kerberos=true

For Unix operating systems Open a command line and enter this command:

cd opt/IBM/JazzTeamServer/server/
./repotools-jts.sh -setup repositoryURL=https://hostname.example.com:9443/jts