This section describes the methods for installing the DevOps Foresight server in a new environment.
Prerequisites
Before starting the DevOps Foresight server installation, the DevOps Insight server must be installed and collecting data. In addition, you need the following in order to complete the DevOps Foresight installation:
-
DevOps Foresight server license—this server is licensed separately from CloudBees CD and DevOps Insight.
-
DevOps Insight host name and port number
-
DevOps Insight Elasticsearch port number
-
DevOps Insight server user name and password
-
CloudBees CD server host name, user name, and password
System Considerations for DevOps Foresight Server Installation
General considerations
For a production environment, CloudBees recommends that you install the DevOps Foresight server on a system other than systems running other CloudBees CD components (such as the CloudBees CD server, web server, repository server, or agent).
System-level considerations
Windows Server 2008 |
|
Ubuntu 18.04 (64-bit) |
run the following command:
This error is a known Ubuntu bug. |
Graphical User Interface Installation Methods
The graphical user interface installation methods are supported by Windows platforms and Linux platforms running the X Window System.
Interactive Command-Line Installation
The command-line user interface installation method is supported only by Linux platforms. In this mode, additional command line parameters that are listed in Silent Unattended Installation can be used.
-
Choose one of the following commands to start the full installer.
-
From a command line, enter
sudo ./CloudBeesFlowDevOpsForesightServer-x64-<version>
-
On Linux platforms with the X Window System, the installer invokes the graphical user interface. To override this behavior, enter
sudo ./CloudBeesFlowDevOpsForesightServer-x64-<version> --mode console
.The following message appears:
Logging to "/tmp/ijtmp_00CB8424-9E21-C4E5-3357-0E5B11BADFA6/installer-EFlowReportServ.log" Copyright (c) 2010-2019, CloudBees, Inc. All rights reserved. This will install {CD} DevOps Foresight Server on your computer. Continue? [n/Y]
-
-
Continue the installation by entering
y
.The following message appears:
Specify the install directory (for binaries) [/opt/electriccloud/electriccommander]
-
Press
Enter
to accept the default installation directory, or enter a new installation directory path for program files and binaries.The following message appears:
Specify the data directory (for data files, configurations and logs) [/opt/electriccloud/electriccommander]
-
Press
Enter
to accept the default installation directory, or enter a new installation directory path for data files, configurations, and logs.The following message appears:
Specify the user the services will run as [<primary user>]
-
Enter the name of the user who owns the CloudBees CD DevOps Foresight server processes.
The following message appears:
Specify the group the services will run as [<primary group>]
-
Enter the name of the group who owns the CloudBees CD DevOps Foresight server processes, or accept the default primary group of the chosen user by pressing
Enter
.The following message appears:
Specify the host name or IP address on which the installed service will be available [ip-10-0-0-162.us-west-1.compute.internal]
The host name or IP address of the system on which the DevOps Foresight server is being installed.
-
If you want to specify a non-default host name, enter it, or accept the default host name by pressing
Enter
.The following message appears:
Choose the port which will be used by server [9100]
This port is used by the DevOps Foresight server.
-
If you want specify a non-default port number, enter that number, or accept the default port number by pressing
Enter
.The following message appears:
Specify the host of the remote {CD} DevOps Insight server []
-
Enter the host name of DevOps Insight server and press
Enter
You must specify a host.The following message appears:
Specify the port of the remote {CD} DevOps Insight server [9200]
-
Enter the port number for your DevOps Insight Server, or accept default and press
Enter
.The following message appears:
Does the {CD} DevOps Insight server on "e5590-phair" use authentication? [n/Y]
-
In most cases, it does use authentication. Continue the installation by entering
y
.The following message appears:
Specify the user name with which to login to "e5590-phair" [reportuser]
-
Enter the user name you configured during the DevOps Insight Server install, or accept the default by pressing
Enter
.The following message appears:
Specify the password for "reportuser" on "e5590-phair" [changme]
-
Enter the password you configured during the DevOps Insight Server install, or accept the default by pressing
Enter
.The following message appears:
Specify the host[:port] of the remote {CD} server []
-
Enter the name of the CloudBees CD server that will communicate with this DevOps Foresight server. If the remote server is using a non-default HTTPS port, you must specify the host name as
<host>:<port>
. If you do not specify a port, HTTPS port 8443 is assumed (the same as the CloudBees CD server default port).The following message appears:
Specify the user name with which to login to "<remote host>" [admin]
-
Enter the name of a CloudBees CD user on the CloudBees CD server who has sufficient privileges to edit server settings. This field defaults to the CloudBees CD-supplied
admin
user.The following message appears:
Specify the password for "<remote user>" on "<remote host>" []
-
Enter the password for the CloudBees CD user. The default password for the
admin
user ischangeme
.The following message appears:
The {CD} DevOps Foresight Server will be configured on {CD} server version <version> on <remote host>
The CloudBees CD software is installed on the machine. When the installation completes successfully, a message that contains the line Installation complete
appears.
Silent Unattended Installation
You can run the CloudBees CD DevOps Foresight server installer in unattended (silent) mode with no user interface on either Windows or Linux.
Installing the DevOps Foresight Server
Enter one of the following commands from a command line.
-
Linux:
sudo ./CloudBeesFlowDevOpsForesightServer-x64-<version> --mode silent <arguments>
-
Windows:
CloudBeesFlowDevOpsForesightServer-x64-<version>.exe --mode silent <arguments>
where:
-
<version>
is your CloudBees CD DevOps Foresight server version number. -
<arguments>
represents any additional silent install arguments.
For a successful installation in this mode, you must specify the following:
-
Linux: Use the
--unixServerUser
and--unixServerGroup
options to specify the user name and group that the CloudBees CD DevOps Foresight server service runs as. -
Windows: Use the
--windowsServerUser
,--windowsServerPassword
, and--WindowsServerDomain
options to specify the user name, password, and domain (if the account is not local) of the account the CloudBees CD DevOps Foresight server service runs as or the--windowsServerLocalSystem
option to use the local system account.
Arguments
The following table lists installation arguments. You can view the full installer help by entering CloudBees CDDevOpsForesightServer-x64-<version> --help
.
--dataDirectory <argument> |
Directory used to store binaries:
|
||
--devopsInsightServer <argument> |
Host name of the remote DevOps Insight Server server. |
||
--devopsInsightServerPassword <argument> |
Password of the remote DevOps Insight Server server. |
||
--devopsInsightServerPort <argument> |
Port of the remote DevOps Insight Server server. |
||
--devopsInsightServerUser <argument> |
User name to use when logging in to the remote CloudBees CD server. |
||
--help |
Display the information in this table |
||
--hostName <argument> |
Host name or IP address to be used by the remote CloudBees CD server to communicate with the DevOps Foresight server. The default value is the current host name of the machine. |
||
--installDirectory <argument> |
Directory used to store binaries. Default value on Linux: Default value on Windows: |
||
--licenseFile <argument> |
The file name of the license file. |
||
--mode <arguments> |
Set the installer mode:
|
||
--remoteServer <argument> |
|
||
--remoteServerPassword <argument> |
Password to use when logging in to the remote CloudBees CD server. |
||
--remoteServerUser <argument> |
User name to use when logging in to the remote CloudBees CD server. |
||
--temp <argument> |
Set the temporary directory used by this program |
||
--unixServerGroup <argument> |
(Linux only) Group name that the CloudBees CD DevOps Foresight server services run as
|
||
--unixServerUser <argument> |
(Linux only) User name that the CloudBees CD DevOps Foresight server services run as
|
||
--version |
Display installer version information |
||
--windowsServerDomain <argument> |
(Windows only) Domain of the account the CloudBees CD DevOps Foresight server services will run as on Windows
|
||
--windowsServerLocalSystem |
(Windows only) Run the CloudBees CD DevOps Foresight server services as the local system account |
||
--windowsServerPassword <argument> |
(Windows only) Password of the account that the CloudBees CD DevOps Foresight server services will run as
|
||
--windowsServerUser <argument> |
User name of the account the CloudBees CD DevOps Foresight server services will run as on Windows
|