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 (ELM) applications, created your databases, and deployed and started the applications on your application server.Note: Some parameters are not reversible. When you run multiple repotools -setup
commands, make sure you preserve all the response files and merge them as one file manually to
automate similar setups.
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 trueto 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 Matterssample. |
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
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
Open a command line and enter
this command:
cd opt/IBM/JazzTeamServer/server/ ./repotools-jts.sh -setup repositoryURL=https://hostname.example.com:9443/jts