Installation types

5 minute readReference

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

For more information on which operating system versions are supported, refer to Supported platforms for CloudBees CD/RO on traditional platforms.

GUI installation

This option provides an installation wizard to install CloudBees CD/RO on supported operating systems, and is available on Windows and on Linux platforms with the X Window System installed.

For more information about GUI installations, refer to GUI installation methods.

CloudBees CD/RO full installer options

The following installation options are available for CloudBees CD/RO using the full installer.

Express Server

CloudBees recommends this installation option for quickly installing CloudBees CD/RO software for evaluation purposes. This option installs the CloudBees CD/RO server, web server, repository server, built-in database, and agent on one machine. Additionally, CloudBees Tools are installed. The default CloudBees CD/RO server settings are used.

The CloudBees CD/RO installer includes a demo license that limits the software to two concurrent job steps and installing the CloudBees CD/RO-provided built-in database. Using the built-in database is not supported in clustered CloudBees CD/RO environments. Additionally, this option does not support migrating data when you upgrade to newer CloudBees CD/RO versions.

Using an external database requires a CloudBees CD/RO enterprise license. You must configure an external database when you install your enterprise license to prevent error messages about an unsupported configuration or a license requirement. This is not supported using the Express Server option.

SDA

CloudBees recommends using this installation option for testing and development environments that require an external database. This option installs the CloudBees CD/RO server, web server, repository server, and agent on one machine with the option to configure an external database. Additionally, CloudBees Tools are installed.

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

CloudBees recommends using this option to install an agent on managed hosts where you want to run job steps. This option installs a single CloudBees CD/RO agent and CloudBees Tools.

To install agents on multiple machines, refer to Silent unattended installation.

Advanced

CloudBees recommends using this option for production environments and to install CloudBees CD/RO components on separate machines. Using this option allows you to install and configure individual components, directories, and ports.

For production environments, CloudBees recommends installing each CloudBees CD/RO component on separate machines. Additionally, there are specific agent security recommendation that can be found on Agent security recommendations.

This option allows you to install single components or any combination of the CloudBees CD/RO server, built-in/external database, web server, repository server, or agent on the machine. A local agent and CloudBees Tools are also automatically installed.

CloudBees Analytics installer

Installs the CloudBees Analytics server. This option uses the standalone CloudBees Analytics installer, and includes the ability to add CloudBees Analytics servers to a CloudBees Analytics cluster.

For more information about clustering CloudBees Analytics, refer to Install the CloudBees Analytics server in cluster mode.

Agent installer

CloudBees recommends using this option to install an agent on managed hosts where you only want to run job steps. This option uses the standalone CloudBees CD/RO agent installer, and installs a single CloudBees CD/RO agent and CloudBees Tools.

To install agents on multiple machines, refer to 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.

For more information about interactive command-line installations, refer to Interactive command-line Linux traditional installation.

CloudBees CD/RO full installer options

The following installation options are available for CloudBees CD/RO using the full installer.

Express Server

CloudBees recommends this installation option for quickly installing CloudBees CD/RO software for evaluation purposes. This option installs the CloudBees CD/RO server, web server, repository server, built-in database, and agent on one machine. Additionally, CloudBees Tools are installed. The default CloudBees CD/RO server settings are used.

The CloudBees CD/RO installer includes a demo license that limits the software to two concurrent job steps and installing the CloudBees CD/RO-provided built-in database. Using the built-in database is not supported in clustered CloudBees CD/RO environments. Additionally, this option does not support migrating data when you upgrade to newer CloudBees CD/RO versions.

Using an external database requires a CloudBees CD/RO enterprise license. You must configure an external database when you install your enterprise license to prevent error messages about an unsupported configuration or a license requirement. This is not supported using the Express Server option.

SDA

CloudBees recommends using this installation option for testing and development environments that require an external database. This option installs the CloudBees CD/RO server, web server, repository server, and agent on one machine with the option to configure an external database. Additionally, CloudBees Tools are installed.

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

CloudBees recommends using this option to install an agent on managed hosts where you want to run job steps. This option installs a single CloudBees CD/RO agent and CloudBees Tools.

To install agents on multiple machines, refer to Silent unattended installation.

Advanced

CloudBees recommends using this option for production environments and to install CloudBees CD/RO components on separate machines. Using this option allows you to install and configure individual components, directories, and ports.

For production environments, CloudBees recommends installing each CloudBees CD/RO component on separate machines. Additionally, there are specific agent security recommendation that can be found on Agent security recommendations.

This option allows you to install single components or any combination of the CloudBees CD/RO server, built-in/external database, web server, repository server, or agent on the machine. A local agent and CloudBees Tools are also automatically installed.

CloudBees Analytics installer

Installs the CloudBees Analytics server. This option uses the standalone CloudBees Analytics installer, and includes the ability to add CloudBees Analytics servers to a CloudBees Analytics cluster.

For more information about clustering CloudBees Analytics, refer to Install the CloudBees Analytics server in cluster mode.

Agent installer

CloudBees recommends using this option to install an agent on managed hosts where you only want to run job steps. This option uses the standalone CloudBees CD/RO agent installer, and installs a single CloudBees CD/RO agent and CloudBees Tools.

To install agents on multiple machines, refer to Silent unattended installation.

Silent unattended installation

CloudBees recommends this option for installing multiple remote agents, servers, or CloudBees Analytics servers using a non-interactive command-line. This installation also includes the ability to add CloudBees Analytics servers to a CloudBees Analytics cluster. Silent unattended installation are supported for:

For more information about silent unattended traditional installation, refer to Silent unattended traditional installation

Non-server platform agent interface

This is a command-line interface for installing the CloudBees CD/RO agent and tool software 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.

For more information on installing non-server UNIX agents Non-server installation for UNIX agents.