Running an Express Agent Graphical User Interface Installation

4 minute readReferenceExtensibility

The CloudBees CD/RO agent software must be installed on each agent machine you intend to use with CloudBees CD/RO. Review Before You Install CloudBees CD/RO before performing this procedure.

You install CloudBees CD/RO agent software on Windows or Linux with this installation method. For macOS or other supported UNIX-only agent machines, see Non-Server Platform Agent Installation Method .
  1. (Linux only) Enter the following command to make the installer file executable:

    chmod +x ./CloudBeesFlow-<version>
  2. Do one of the following to start the installation:

    • For Linux with root or sudo privileges or for Windows installations, double-click the installer file.

    • For non-root/non-sudo installations, enter:

      ./<full_installer_file> --nonRoot

      For this installation type, a warning appears.

  3. For non-root/non-sudo installations, click Yes to dismiss the warning.

    The Welcome to the CloudBees CD/RO Installer screen appears.

    The screen examples in this procedure are from a Windows system. Different options will appear in some windows on a Linux system.
  4. Select the Express Agent installation option, and then click Next to continue.

    The Remote CloudBees CD/RO server screen appears.

  5. Complete the following information on the Remote CloudBees CD/RO server screen.

    • Server Host Name —Use this field to enter the name of the CloudBees CD/RO server that will communicate with this agent. If the remote server is using a non-default HTTPS port, you must specify the Server Host Name as <host>:<port>. If you do not specify a port, HTTPS port 8443 is assumed (the same as the CloudBees CD/RO server default port).

    • CloudBees CD/RO User Name —Use this field to enter the name of a CloudBees CD/RO user on the CloudBees CD/RO server who has sufficient privileges to create a resource. This field defaults to the CloudBees CD/RO-supplied admin user.

    • Password —Use this field to enter the password for the CloudBees CD/RO user. The default password for the admin user is changeme.

    • Discover the plugins directory —Select this check box if you want the agent machine to have access to the plugins directory. You should allow access to the plugins directory so agents have access to collections of features, third-party integrations, or third-party tools.

      The plugins directory on the CloudBees CD/RO server must be “shared” before the agent machine can use “discover” to find the directory. For more information, see Universal Access to the Plugins Directory.
    • Create a resource—Select this check box if you want to create a resource on the remote CloudBees CD/RO server for the agent you are installing.

    • Trusted —Select this check box to restrict this agent to one CloudBees CD/RO server. The agent will not respond to incoming communication from any other CloudBees CD/RO server. This is useful when you want to create a secure production environment, but generally not needed for test or development systems.

    • Resource Name —Use this field to enter the name of the resource you would like to use for the agent. This field is available for use when the Create a resource check box is selected.

    • Create in default zone —Select this check box if you want to create the agent in the default zone.

    • Agent Gateway URL —Use this field to enter the URL of the gateway used to communicate with the CloudBees CD/RO server. This field is available for use when the Create in default zone check box is cleared.

    • Zone Name —Use this field to enter the name of the zone used during remote agent and or remote repository creation. This field is available for use when the Create in default zone check box is cleared.

  6. Click Next to continue. The Agent service account screen appears.

  7. Select the appropriate steps for your platform and complete the following information on the screen.

    • Windows:

      • User Name —Use this field to enter the name of the user who will run the CloudBees CD/RO agent service.

        The user that the agent runs as must have permission to write to the $INSTALL_DIRECTORY/log directory.

      • Password — Use this field to enter the password of the user who will run the CloudBees CD/RO agent service.

      • Domain —Use this field to enter the domain name information for the user. For example, electric-cloud.com. Leave this field blank if this is a local user.

      • Use the local system account —Select this check box if you want the CloudBees CD/RO agent service to run as the Windows local system account.

        The Windows local system account cannot access network resources such as shared file systems used for plugins or workspaces. Therefore, do not use this option for a clustered server deployment, which requires a shared file system for plugins. This option is typically used only for installing agents on numerous machines, which would otherwise require that you create a new account on each of those machines.
    • Linux:

      • User Name —Use this field to enter the name of the user who owns the CloudBees CD/RO agent process.

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

      • Group Name —Use this field to enter the name of the group who owns the CloudBees CD/RO agent process.

  8. Click Next to continue. The Ready to Install appears.

  9. Review this screen to verify your selections. Use the Back button to change any of your settings if necessary.

  10. Click Next to continue.

  11. CloudBees CD/RO installs the agent and tools components. This process can take a few minutes:

    When the install process is complete, the Install Wizard Complete screen appears.

  12. Click Finish to complete the installation.