Choosing the Correct Installation Interface and Installer Option

6 minute read

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 Flow 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 Flow server, built-in database, web server, and repository server on one machine. The default CloudBees Flow server settings are used. A local agent (required for running jobs), and CloudBees Flow tools are also installed.

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

    IMPORTANT:

    CloudBees Flow ships with a demo license, which limits the software to two concurrent job steps and the CloudBees Flow-provided built-in database. Running CloudBees Flow on a single machine with the demo license is not recommended for a production environment. include::ROOT:partial$install-trad/built-in-db.adoc[]

    In a production configuration, connect CloudBees Flow to a database. If CloudBees Flow 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 Flow, see Supported Alternate Databases . For more information and configuration instructions, see External Database Configuration .

    Using an external database requires a CloudBees Flow 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 Flow agent and CloudBees Flow tools. This option is available via a “full” installer file (see CloudBees Flow 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 agents on multiple machines, you should use Silent Unattended Installation .

  • 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 Flow Installer Files ).

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

  • DevOps Insight Server

    Installs the CloudBees Flow DevOps Insight server. This option requires the DevOps Insight-only installer file (see CloudBees Flow Installer Files ).

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

  • DevOps Foresight Server

    Installs the CloudBees Flow DevOps Foresight server. This option requires the DevOps Foresight-only installer file (see CloudBees Flow Installer Files ).

  • 32-Bit Agent-Only (Windows Only)

    Installs a 32-bit CloudBees Flow agent. This option is available via the 32-bit agent-only installer file (see CloudBees Flow 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 Flow agent. This option is available via the “pure” 64-bit agent-only Linux installer file (see CloudBees Flow 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 Flow agent. This option is available via the “pseudo” 64-bit agent-only Windows installer file (see CloudBees Flow 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 Flow 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 Flow server, built-in database, web server, and repository server on one machine. The default CloudBees Flow server settings are used. A local agent (required for running jobs), and CloudBees Flow tools are also installed.

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

    IMPORTANT:

    CloudBees Flow ships with a demo license, which limits the software to two concurrent job steps and the CloudBees Flow-provided built-in database. Running CloudBees Flow on a single machine with the demo license is not recommended for a production environment. include::ROOT:partial$install-trad/built-in-db.adoc[]

    In a production configuration, connect CloudBees Flow to a database. If CloudBees Flow 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 Flow, see Supported Alternate Databases . For more information and configuration instructions, see External Database Configuration .

    Using an external database requires a CloudBees Flow 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 Flow agent and CloudBees Flow tools. This option is available via a “full” installer file (see CloudBees Flow 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 agents on multiple machines, you should use Silent Unattended Installation .

  • 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 Flow Installer Files ).

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

  • DevOps Insight Server

    Installs the CloudBees Flow DevOps Insight server. This option requires the DevOps Insight-only installer file (see CloudBees Flow Installer Files ).

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

  • DevOps Foresight Server

    Installs the CloudBees Flow DevOps Foresight server. This option requires the DevOps Foresight-only installer file (see CloudBees Flow Installer Files ).

  • 32-Bit Agent-Only (Windows Only)

    Installs a 32-bit CloudBees Flow agent. This option is available via the 32-bit agent-only installer file (see CloudBees Flow 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 Flow agent. This option is available via the “pure” 64-bit agent-only Linux installer file (see CloudBees Flow 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 Flow agent. This option is available via the “pseudo” 64-bit agent-only Windows installer file (see CloudBees Flow 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 Flow Installer Files.

You might find this installation process preferable for installing multiple remote agents, servers, or DevOps Insight servers. This installation includes the ability to add DevOps Insight servers to a DevOps Insight 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 Flow 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.