Start Release

This topic describes how to start the Release server on different operating systems, either interactively or as a background process.

To start the Release server, open a command prompt or terminal, point to the XL_RELEASE_SERVER_HOME/bin directory, and execute the appropriate command:

Operating system	Command
Microsoft Windows	run.cmd
Unix-based systems	run.sh

Start Release in the background

important

To run Release in the background, it must be configured to start without user interaction. The server should not require a password for the encryption key that is used to protect passwords in the repository. Alternatively, you can store the password in the XL_RELEASE_SERVER_HOME/conf/xl-release-server.conf file, by adding following: repository.keystore.password=MY_PASSWORD. Release will encrypt the password when you start the server.

To start the Release server as a background process:

1. Open a command prompt or terminal and point to the XL_RELEASE_SERVER_HOME/bin directory.
2. Execute the appropriate command:

important

If you close the command prompt in Microsoft Windows, Release will stop.

Operating system	Command
Microsoft Windows	START /B run.cmd
Unix-based systems	nohup bin/run.sh &

Server options

Specify the options you want to use when starting the Release server in the XL_RELEASE_SERVER_OPTS environment variable.

The following server options are available:

Option	Description
-force-upgrades	Forces the execution of upgrades at Release startup.
-repository-keystore-password VAL	Identifies the password to use to access the repository keystore. If not specified and the repository keystore does require a password, Release will prompt you for it.
-setup	Runs the Release setup wizard.
-setup-defaults VAL	Specifies a file that contains default values for configuration properties set in the setup wizard.

To view the available server options when starting the Release server, add the -h flag to the start command.