Trial install

This topic describes how to install a trial version of XL Deploy.

Important: Before installing XL Deploy as a trial, ensure that your system meets the minimum server, network, and hard disk requirements. For more information, see Requirements for installing XL Deploy

Download the XL Deploy server trial software

  1. Go to https://xebialabs.com/products/xl-deploy/trial/.
  2. Enter your details and click Go!. Note: A trial license key will be sent to your specified email address.
  3. Click Server Download.

Extract the XL Deploy server archive

  1. Log in to the computer where you want to install XL Deploy.
  2. Create an installation directory such as /opt/xebialabs/xl-deploy or C:\Program Files\XL Deploy.
  3. Copy the XL Deploy server archive to the directory.
  4. Extract the archive in the directory.

Note: We recommended to install the XL Deploy server as a non-root user such as xldeploy.

Run the server setup wizard

Run the server setup wizard on a Microsoft Windows or Unix-based host. You can stop the setup wizard at any time, enter exitsetup. All changes to the configuration will be discarded.

To install the XL Deploy server:

  1. Go to a command line or terminal window, and depending on your system, execute on of the following commands to start the setup wizard:

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

    The following message is displayed: Do you want to use the simple setup? Default values are used for all properties. To make changes to the default properties, please answer no. Options are yes or no. [yes]:

  2. Enter yes, or press enter, to install XL Deploy with a default configuration. Using this method, XL Deploy will be installed with the following settings:

    • SSL will be disabled
    • HTTP bind address is 0.0.0.0
    • HTTP port is 4516
    • Context root is /
    • The server will use a minimum of 30 and a maximum of 150 threads.
    • Applications can be imported from the importablePackages directory.
  3. At the “Provide a password” for the admin user prompt, provide a password for the admin user. Choose a password with a minimum of 6 characters. Note: The admin user has all permissions and is used to connect to the XL Deploy repository.

  4. At the “Generate an encryption key” prompt, you can optionally choose to generate a password encryption key to protect passwords that you store in the repository. Important: If you want to start XL Deploy as a service on system boot, do not add a password to the password encryption key. Adding a password to the encryption key prevents automated start. Note: If you do not want to provide a password, press enter twice.

    • Answer yes to generate a new key. This will create an encryption key in XL_DEPLOY_SERVER_HOME/conf/repository-keystore.jceks. XL Deploy will use this key to encrypt and decrypt all password properties. This will also be used for encrypted entries in dictionaries and passwords that are set in the XL_DEPLOY_SERVER_HOME/conf/deployit.conf file. Note: You can also provide a password to secure the key. You will be required to enter this password when XL Deploy starts, either: Interactively via a prompt, Non-interactively via a command-line parameter, or non-interactively via a configuration file.
    • Answer no to use the built-in XL Deploy encryption key, or to use a key that you have previously generated.
  5. At the “Set up completed” prompt:

    • Answer yes to finish the setup process. The setup wizard will start XL Deploy and show the URL where you can access it, for example, http://localhost:4516.
    • Answer no to exit setup.
  6. Install the trial license key and log in. Note: If you did not receive a trial license key to your specified email, check your spam folder. If the license key is not in your spam folder, revisit https://xebialabs.com/products/xl-deploy/trial/ and reenter your details. If after reentering your details you still do not have a trial license key, contact support.

    1. Copy the license key from the email.
    2. Paste the license key into the License field.
    3. Click Install license. A message displays indicating the end date for the 30-day license.
    4. Click Get started.
    5. Log in with the username admin and the password that you provided during the setup process.

For information on starting XL Deploy in the future, see Start XL Deploy.