Run an express server command-line installation

4 minute readReference

This option installs the CloudBees CD/RO server, built-in database, web server, and repository server on one machine. The default CloudBees CD/RO server settings are used. A local agent (required for running jobs), and CloudBees CD/RO tools are also installed.

This option is available via a “full” installer file (see CloudBees CD/RO Installer Files ). This option is best for quickly installing the CloudBees CD/RO software for evaluation purposes.

Review Before You Install CloudBees CD/RO before performing this procedure.

The built-in database is not supported in a clustered CloudBees CD/RO configuration.
  1. If you have not already done so, download the full installer file. To download this version, select:

  2. Start the installer:

    1. Enter the following command to make the installer file executable:

      Command
      Current version
      chmod +x CloudBeesFlow-x64-<version>
      chmod +x CloudBeesFlow-x64-2024.09.0.176472
    2. Start the installation:

      For more information about required user privileges, refer to Linux services user permissions.
      • For root or sudo installations, run:

        Command
        Current version
        ./CloudBeesFlow-x64-<version>
        ./CloudBeesFlow-x64-2024.09.0.176472
        • For root or sudo installations on Linux systems with a graphical interface systems, run:

          Command
          Current version
          ./CloudBeesFlow-x64-<version> --mode console
          ./CloudBeesFlow-x64-2024.09.0.176472 --mode console
      • For non-root/non-sudo installations, run:

        Command
        Current version
        ./CloudBeesFlow-x64-<version> --nonRoot
        ./CloudBeesFlow-x64-2024.09.0.176472 --nonRoot
        • For non-root/non-sudo installations on Linux systems with a graphical interface systems, run:

          Command
          Current version
          ./CloudBeesFlow-x64-<version> \ --nonRoot \ --mode console
          ./CloudBeesFlow-x64-2024.09.0.176472 \ --nonRoot \ --mode console

    A warning about automatic server start-up with non-root/non- sudo installations appears. Enter Yes to dismiss the warning.

  3. The following prompt appears:

    Copyright (c) 2006-2018, CloudBees, Inc. All rights reserved. This will install CloudBees CD on your computer. Continue? [n/Y]
    1. Continue the installation by entering y.

  4. The following prompt appears:

    Specify the type of setup you would like to perform: expressServer, expressAgent, or advanced. [expressServer]
    1. Enter: expressServer and press Enter.

  5. Review information about sending data. Enter n if you do not wish to participate. Otherwise, telemetry data is sent by default.

    CloudBees Software Delivery Automation server has the ability to send information about its use, which helps to make CloudBees Software Delivery Automation better and more intuitive. Telemetry collects anonymized aggregated information and does not collect any identifying information like user names. For privacy reasons, you can turn off the ability to send telemetry data to CloudBees. Send usage data [n/Y] y
    The Send usage data option appears for new installations or upgrades from versions that didn’t have the ability to send usage data (v10.0 and earlier).

    Press Enter to continue.

  6. Specify installation directory:

    Specify the install directory (for program files and binaries). [/opt/cloudbees/sda]
  7. Press Enter to accept the default installation directory or enter a new directory.

    The following prompt appears:

    Specify the user the server, web, and/or repository will run as. []
  8. Enter a user name.

    This is the user who owns the CloudBees CD/RO server, repository server, and web server processes. For example, you might enter build.

    The following prompt appears:

    Specify the group the server, web, and/or repository will run as. []
  9. Enter a group name.

    This is the group who owns the CloudBees CD/RO server, repository server, and web server processes. For example, you might enter build.

    The following prompt appears:

    Use the same service account for the agent (not recommended for production systems)? [y/N]

    For security reasons in production environments, you should use a separate user and group for the agent service. This is because the server service has permission to read the key file: /opt/electriccloud/commander/conf/passkey in Linux or C:\ProgramData\CloudBees\Software Delivery Automation\conf\passkey in Windows. The key file is used to decrypt passwords stored in CloudBees CD/RO. Using a different user and group for the agent service ensures that a process running on the agent cannot access the key file.

  10. Choose one of the following options:

    • Enter y to use the same user and group for the agent service. This is not recommended for production systems.

    • Enter n to use a separate user and group for the agent service.

      The following prompt appears:

      Specify the user the agent will run as. []
  11. Enter a user name.

    This is the user who owns the CloudBees CD/RO agent process. For example, you might enter build.

    The user/group that the agent runs as must have permission to write to the $INSTALL_DIRECTORY/log directory. If you specify root, enter y when the following confirmation appears:

    It is not recommended to use the 'root' user for running the agent process. Please confirm if you would like to proceed [y/N]

    The following prompt appears:

    Specify the group the agent will run as. []
  12. Enter a group name.

    This is the group that owns the CloudBees CD/RO agent process. For example, you might enter build.

  13. For non-root/non- sudo Linux installations, configure autostart for the CloudBees CD/RO services.

CloudBees CD/RO is installed on the machine. When the installation completes successfully, a message that contains the line CloudBees CD/RO <version> was successfully installed! appears.