The following argument table is an excerpt from the installer help text. You can view the full installer help by entering the <installer_file> --help
command.
Only limited validity checking is performed on these values during an unattended installation, which means typing errors or other mistakes might cause unexpected issues. |
The response-file and save-response-file arguments are not supported as of versions newer than 6.0.4 and 6.4.
|
Argument | Description | ||
---|---|---|---|
--agentAllowRootUser |
(Linux platforms) Lets you specify
|
||
--agentArtifactCache [< directory >] |
Directory containing cached artifact versions. |
||
--agentGatewayURL [< URL >] |
URL of the gateway used to communicate with the CloudBees Flow server. |
||
--agentIdleConnectionTimeout [< milliseconds >] |
Idle connection timeout for the CloudBees Flow agent (in milliseconds). The default is 0 (the connection does not time out). |
||
--agentInitMemory [< percent >] |
Initial Java heap size as a percentage of the total system memory for the CloudBees Flow agent. This setting has no default and is overridden if you have set |
||
--agentInitMemoryMB [< megabytes >] |
Initial Java heap size for the CloudBees Flow agent (in MB). The default is 16. |
||
--agentMaxConnections [< number >] |
Maximum number of network connections for the CloudBees Flow agent. The default is 200. |
||
--agentMaxConnectionsPerRoute [< number >] |
Maximum number of network connections per route for the CloudBees Flow agent. The default is 20. |
||
--agentMaxMemory [< percent >] |
Maximum Java heap size as a percentage of the total system memory. This setting has no default and is overridden if you have set |
||
--agentMaxMemoryMB [< megabytes >] |
Maximum Java heap size for the CloudBees Flow agent (in MB). The default is 64. |
||
--agentLocalPort [< port >] |
Port used by the CloudBees Flow agent for HTTP communication on the localhost network interface. |
||
--agentOutboundConnectTimeout <milliseconds> |
Timeout for the CloudBees Flow agent establishing outbound connections (in milliseconds). The default is 30000. |
||
--agentPort [< port >] |
Port used by the installed CloudBees Flow agent for HTTPS communication on any network interface. |
||
--agentTLSEnabledProtocol < protocols > |
Comma-delimited list of SSL/TLS protocols that will be allowed for agent connections using HTTPS. The possible values are any combination of The default security configurations are as follows:
To avoid the following warning in the Automation Platform web UI, we recommend removing the
To safely remove this protocol, enter the following command on the CloudBees Flow server:
When you do this, you would also need to upgrade older agents to the latest version to avoid security risks. You would need to upgrade agents if you are using the following agent versions:
|
||
--agentWindowsServiceStartType [< start_type >] |
(Windows only) Start type of the CloudBees Flow agent service. Available values are |
||
--databaseMemoryBufferSize [ <size> ] |
Size of the database memory buffer. The value can be suffixed with a unit (K, M, or G). The default unit is bytes. The default size is 256 MB. |
||
--databasePassword [ <password> |
]Password used to access the database. The default password is |
||
--databasePort [ <port> ] |
Port used by the built-in (default) database. The default port is 8900. |
||
--dataDirectory [< directory >] |
Directory used to store configuration files, logs, and database artifacts. |
||
--force32Bit |
Force a 32-bit install, even if the machine is 64-bit. |
||
--haveRunMigrationUtility |
When you upgrade from CloudBees Flow Automation Platform 4.2.x to CloudBees Flow 5.0 and later, the database is modified to support modifications to universally unique identifiers (UUIDs). The upgrade process includes using a migration tool to add support for UUIDs. For more information, go to Properties Changed to UUIDs . |
||
--help |
Display this information. |
||
--installAgent |
Install the CloudBees Flow agent. When using silent installation for the agent-only installer (using the agent binary), in order to install the agent properly, you must use this argument. Otherwise, only tools are installed. |
||
--installDatabase |
Install a local built-in database to use with the main CloudBees Flow server. This database works only for standard licenses (shipped with CloudBees Flow by default) and evaluation licenses. This database is not recommended for production systems. |
||
--installDirectory [< directory >] |
Directory used to store program files and binaries. |
||
--installRepository |
Install a CloudBees Flow artifact repository server. |
||
--installServer |
Install the main CloudBees Flow server. |
||
--installWeb |
Install the local web server and CloudBees Flow web interface. |
||
--mode [< installer_mode >] |
Mode in which the installer will run. Available values: |
||
--nonRoot |
(Linux full installations and Linux agent-only installations) Install as a non-root user or a user without You cannot use Also, you cannot use |
||
--remoteServer [< host >:< port >] |
`host:port ` for the remote CloudBees Flow server. The port is optional and can be omitted if the server is using the default HTTP port. |
||
--remoteServerCreateRepository |
Create a repository object on the remote CloudBees Flow server. You can specify the host name of the repository to create on the remote CloudBees Flow server by also using the |
||
--remoteServerCreateResource |
Create a resource for the installed agent on the remote CloudBees Flow server. You can specify the host name of the resource to create on the remote CloudBees Flow server by also using the |
||
--remoteServerDiscoverPlugins |
Set the plugins directory for the installed agent and/or web server to the shared plugins directory defined on the remote CloudBees Flow server. |
||
--remoteServerPassword [< password >] |
Password to use when logging in to the remote CloudBees Flow server. |
||
--remoteServerRepository [< repository_name >] |
Name of the repository to create on the remote CloudBees Flow server. |
||
--remoteServerRepositoryHostName [< repository_host_name >] |
Host name of the repository to create on the remote CloudBees Flow server. The |
||
--remoteServerResource [< resource_name >] |
Name of the resource to create on the remote CloudBees Flow server. |
||
--remoteServerResourceHostName [< server_resource_name >] |
Host name of the resource to create on the remote CloudBees Flow server. The |
||
--remoteServerUser [< user_name >] |
User name to use when logging in to the remote CloudBees Flow server. |
||
--repositoryPort [< port >] |
Port used by the CloudBees Flow artifact repository server (the default is 8200). |
||
--repositoryTLSEnabledProtocol < protocols > |
Comma-delimited list of SSL/TLS protocols that will be allowed for CloudBees Flow repository server connections using HTTPS. The possible values are any combination of The default security configurations are as follows:
To avoid the following warning in the Automation Platform web UI, we recommend removing the
To safely remove this protocol, enter the following command on the CloudBees Flow server:
When you do this, you would also need to upgrade older agents to the latest version to avoid security risks. You would need to upgrade agents if you are using the following agent versions:
|
||
--response-file [< file >] |
File containing installer responses. |
||
--save-response-file [< file >] |
File for writing installer responses to when the installer exists. |
||
--serverFileTransferPort [< port >] |
File transfer port used by the installed CloudBees Flow server. |
||
--serverHttpPort [< port >] |
HTTP port used by the installed CloudBees Flow server. |
||
--serverHttpsPort [< port >] |
HTTPS port used by the installed CloudBees Flow server. |
||
--serverServicePrincipalName= name |
The Kerberos Service Principal Name that will be used to authorize users. This command changes the |
||
--serverTLSEnabledProtocol < protocols > |
Comma-delimited list of SSL/TLS protocols that will be allowed for CloudBees Flow server connections using HTTPS. The possible values are any combination of The default security configurations are as follows:
To avoid the following warning in the Automation Platform web UI, we recommend removing the
To safely remove this protocol, enter the following command on the CloudBees Flow server:
When you do this, you would also need to upgrade older agents to the latest version to avoid security risks. You would need to upgrade agents if you are using the following agent versions:
|
||
Disables checking for the existence of a valid home directory. This argument overrides the default checks (whether the Certain CloudBees Flow installers allow you to perform installations as a non-root user or a user without The installer writes installation data to the home directory of the user who invoked the installer. The installer will read this data during subsequent upgrades or uninstallations. This argument ensures that the installer finishes successfully for non-root or non-
|
|||
--temp [< directory >] |
Directory used to store temporary files used by the installer. |
||
--trustedAgent |
Restricts the agent to one CloudBees Flow server. The agent will not respond to incoming communication from any other CloudBees Flow server. This is useful when you want to create a secure production environment, but generally not needed for test or development systems. |
||
--unixAgentGroup [< group_name >] |
Group the installed CloudBees Flow agent runs as. You cannot use this argument with the |
||
--unixAgentUser [< user_name >] |
User the installed CloudBees Flow agent runs as. The user and group that the agent runs as must have permission to write to the If you specify root, you must also use the You cannot use this argument with the |
||
--unixServerGroup [< group_name >] |
Group the installed CloudBees Flow, web, or repository server runs as. You cannot use this argument with the |
||
--unixServerUser [< user_name >] |
User the installed CloudBees Flow, web, or repository server runs as. You cannot use this argument with the |
||
--useSameServiceAccount |
Use the same account for server and agent services. Not recommended for production systems. |
||
--version |
Display installer version information. |
||
--webDefaultUI=<flow|commander> |
The type of the Commander server user interface that will be used by default. This setting determines whether the Deploy UI or the Automation Platform UI appears when users browse to https://<cloudbees-flow-server>without appending /flow or /commander respectively to the end of the URL. You can reconfigure this behavior post-installation by using the ecconfigure |
||
--webEnableKerberosConstrainedDelegation=<true|false> |
Enable ( |
||
--webEnableKrb5Trace=<1|0> |
Enable (1) or disable (0) additional Kerberos protocol logging for the web server. This parameter manages the |
||
--webEnableSsoKerberos =<true|false> |
Enable ( |
||
--webHostName [< name >] |
Name users need to type in their browser to access the web server. |
||
--webHttpPort [< port >] |
HTTP port used by the installed web server. |
||
--webHttpsPort [< port >] |
HTTPS port used by the installed web server. |
||
--webServicePrincipalName=[< name >] |
The Kerberos Service Principal Name that will be used to authorize users. This command changes the |
||
--windowsAgentDomain [< domain_name >] |
Domain of the account the installed CloudBees Flow agent runs as. |
||
--windowsAgentLocalSystem |
Run the CloudBees Flow agent as the local system account. |
||
--windowsAgentPassword [< password >] |
Password of the account the installed CloudBees Flow agent runs as. |
||
--windowsAgentUser [< user_name >] |
User name of the account the installed CloudBees Flow agent runs as. User that the agent runs as must have permission to write to the |
||
--windowsServerDomain [< domain_name >] |
Domain of the account the installed CloudBees Flow, web, or repository server runs as. |
||
--windowsServerLocalSystem |
Run the CloudBees Flow, web, or repository server as the local system account. NOTE: 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. |
||
--windowsServerPassword [< password >] |
Password of the account the installed CloudBees Flow, web, or repository server runs as. |
||
--windowsServerUser [< user_name >] |
User name of the account the installed CloudBees Flow, web, or repository server runs as. |
||
--windowsSkipAdminCheck |
Do not check that the user running the installer is a direct member of group Administrators. |
||
--zoneName [< zone_name >] |
Zone name used during remote agent and or remote repository creation. |