Choosing the Correct Installation Interface and Installer Option

6 minute readReference

This section describes the various installation interfaces and available options for specific platform types.

See the list of supported platforms for more information.

User Interface Installation Process

This process provides an installation Wizard for installing CloudBees CD/RO on a supported server platform. The following installation options are generally preferred by Windows users, but they are also supported on Linux platforms with the X Window System installed.

The installation options are:

  • Express Server

    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.

    CloudBees CD/RO ships with a demo license, which limits the software to two concurrent job steps and the CloudBees CD/RO-provided built-in database. Running CloudBees CD/RO on a single machine with the demo license is not recommended for a production environment. Additionally, the built-in database is not supported in a clustered CloudBees CD/RO configuration.

In a production configuration, connect CloudBees CD/RO to an external database. If CloudBees CD/RO is installed with the built-in database, you can reconfigure it to use an external database at any time. For a list of alternate databases supported by CloudBees CD/RO, see Supported Alternate Databases . For more information and configuration instructions, see External Database Configuration.

Using an external database requires a CloudBees CD/RO enterprise license. You must configure an external database at the same time as you install your enterprise license to prevent error messages about an unsupported configuration or a license requirement.

  • Express Agent This option installs a CloudBees CD/RO agent and CloudBees CD/RO tools. This option is available via a “full” installer file (see CloudBees CD/RO Installer Files ). Use this option for managed hosts where you want to run job steps.

  • Advanced This option installs individual components, directories, or ports of your choice. This option is available via one of the “full” installer files (see CloudBees CD/RO Installer Files).

    • Use this option to install any combination of your choice among the CloudBees CD/RO server, built-in database, web server, and repository server. (A local agent and CloudBees CD/RO tools are required and are automatically installed.)

  • CloudBees Analytics Server

    Installs the CloudBees Analytics server. This option requires the CloudBees Analytics-only installer file (see CloudBees CD/RO Installer Files ).

    This option includes the ability to add CloudBees Analytics servers to a CloudBees Analytics cluster. For details, see Creating a CloudBees Analytics Server Cluster .

  • 32-Bit Agent-Only (Windows Only)

    Installs a 32-bit CloudBees CD/RO agent. This option is available via the 32-bit agent-only installer file (see CloudBees CD/RO Installer Files ). Use this option for managed hosts where you want to run job steps.

    This option is useful for installing a single agent. To install multiple agents, you should use Silent Unattended Installation .

  • “Pure” 64-Bit Agent-Only (Linux Only)

    Installs a “pure” 64-bit CloudBees CD/RO agent. This option is available via the “pure” 64-bit agent-only Linux installer file (see CloudBees CD/RO Installer Files ).

    Use this option for managed hosts where you want to run job steps. This option is for installing a single agent. To install multiple agents, you should use Silent Unattended Installation .

  • “Pseudo” 64-Bit Agent-Only (Windows Only)

    Installs a “pseudo” 64-bit CloudBees CD/RO agent. This option is available via the “pseudo” 64-bit agent-only Windows installer file (see CloudBees CD/RO Installer Files ). Use this option for managed hosts where you want to run job steps.

    This option is useful for installing a single agent. To install multiple agents, you should use Silent Unattended Installation .

Interactive Command-Line Installation Process (Linux Only)

These installation options provide an interactive command line for installing CloudBees CD/RO on a supported server platform. These installation methods are available only for Linux platforms.

The installation options are:

  • Express Server

    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.

    CloudBees CD/RO ships with a demo license, which limits the software to two concurrent job steps and the CloudBees CD/RO-provided built-in database. Running CloudBees CD/RO on a single machine with the demo license is not recommended for a production environment. Additionally, the built-in database is not supported in a clustered CloudBees CD/RO configuration.

In a production configuration, connect CloudBees CD/RO to an external database. If CloudBees CD/RO is installed with the built-in database, you can reconfigure it to use an external database at any time. For a list of alternate databases supported by CloudBees CD/RO, see Supported Alternate Databases . For more information and configuration instructions, see External Database Configuration.

Using an external database requires a CloudBees CD/RO enterprise license. You must configure an external database at the same time as you install your enterprise license to prevent error messages about an unsupported configuration or a license requirement.

  • Express Agent This option installs a CloudBees CD/RO agent and CloudBees CD/RO tools. This option is available via a “full” installer file (see CloudBees CD/RO Installer Files ). Use this option for managed hosts where you want to run job steps.

  • Advanced This option installs individual components, directories, or ports of your choice. This option is available via one of the “full” installer files (see CloudBees CD/RO Installer Files).

    • Use this option to install any combination of your choice among the CloudBees CD/RO server, built-in database, web server, and repository server. (A local agent and CloudBees CD/RO tools are required and are automatically installed.)

  • CloudBees Analytics Server

    Installs the CloudBees Analytics server. This option requires the CloudBees Analytics-only installer file (see CloudBees CD/RO Installer Files ).

    This option includes the ability to add CloudBees Analytics servers to a CloudBees Analytics cluster. For details, see Creating a CloudBees Analytics Server Cluster .

  • 32-Bit Agent-Only (Windows Only)

    Installs a 32-bit CloudBees CD/RO agent. This option is available via the 32-bit agent-only installer file (see CloudBees CD/RO Installer Files ). Use this option for managed hosts where you want to run job steps.

    This option is useful for installing a single agent. To install multiple agents, you should use Silent Unattended Installation .

  • “Pure” 64-Bit Agent-Only (Linux Only)

    Installs a “pure” 64-bit CloudBees CD/RO agent. This option is available via the “pure” 64-bit agent-only Linux installer file (see CloudBees CD/RO Installer Files ).

    Use this option for managed hosts where you want to run job steps. This option is for installing a single agent. To install multiple agents, you should use Silent Unattended Installation .

  • “Pseudo” 64-Bit Agent-Only (Windows Only)

    Installs a “pseudo” 64-bit CloudBees CD/RO agent. This option is available via the “pseudo” 64-bit agent-only Windows installer file (see CloudBees CD/RO Installer Files ). Use this option for managed hosts where you want to run job steps.

    This option is useful for installing a single agent. To install multiple agents, you should use Silent Unattended Installation .

Silent Unattended Installation

These installation options provide a non-interactive command-line installation for supported server platforms. For a list of these options and the installers required for them, see CloudBees CD/RO Installer Files.

You might find this installation process preferable for installing multiple remote agents, servers, or CloudBees Analytics servers. This installation includes the ability to add CloudBees Analytics servers to a CloudBees Analytics cluster.

The installation options are:

  • Windows

    This option is only for Windows platforms.

  • Linux

    This option is only for Linux platforms.

Non-Server Platform Agent Interface

This is a command line interface for installing the CloudBees CD/RO agent and tool software only on supported non-server platforms.

The installations options are:

  • Command-Line Agent

    Installs an agent from a UNIX command-line installer.

  • Silent Agent

    Runs unattended (silent) installations with the UNIX installer.