Choosing the Correct Installation Interface and Installer Option

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

A list of supported platforms can be found here.

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.

Copyright © 2010-2020 CloudBees, Inc.Online version published by CloudBees, Inc. under the Creative Commons Attribution-ShareAlike 4.0 license.CloudBees and CloudBees DevOptics are registered trademarks and CloudBees Core, CloudBees Flow, CloudBees Flow Deploy, CloudBees Flow DevOps Insight, CloudBees Flow DevOps Foresight, CloudBees Flow Release, CloudBees Accelerator, CloudBees Accelerator ElectricInsight, CloudBees Accelerator Electric Make, CloudBees CodeShip, CloudBees Jenkins Enterprise, CloudBees Jenkins Platform, CloudBees Jenkins Operations Center, and DEV@cloud are trademarks of CloudBees, Inc. Most CloudBees products are commonly referred to by their short names — Accelerator, Automation Platform, Flow, Deploy, Foresight, Release, Insight, and eMake — throughout various types of CloudBees product-specific documentation. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Jenkins is a registered trademark of the non-profit Software in the Public Interest organization. Used with permission. See here for more info about the Jenkins project. The registered trademark Jenkins® is used pursuant to a sublicense from the Jenkins project and Software in the Public Interest, Inc. Read more at www.cloudbees.com/jenkins/about. Apache, Apache Ant, Apache Maven, Ant and Maven are trademarks of The Apache Software Foundation. Used with permission. No endorsement by The Apache Software Foundation is implied by the use of these marks.Other names may be trademarks of their respective owners. Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this content, and CloudBees was aware of a trademark claim, the designations have been printed in caps or initial caps. While every precaution has been taken in the preparation of this content, the publisher and authors assume no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.