Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Installation properties for platform options files


The topic lists the properties that you can include in the options files for platform components. The values that you assign to these properties determine the installation settings for the installation program.

To help you determine your property values, see the installation worksheets provided for the GUI installation and the Sample platform options file templates.

Installation properties for all platform options files

The following table contains installation properties that are common for all server platform components.

Installation properties for all platform options file

Property name

Description and sample property

installLocation

Specifies the full path to the installation directory 

Default value:

  • Windows: c:/Program Files/BMC Software/BAO
  • UNIX: /opt/bmc/bao 
    -P installLocation=/opt/bmc/bao 
    This property is required in every options file.

AO_INSTALL_TYPE

Specifies the installation type:

  • install_new 
    Installs a new version of the product 
    -J AO_INSTALL_TYPE=install_new
  • upgrade_new 
    Performs the following upgrade actions:
    • Upgrades from an earlier version of the component to the latest version
    • Repairs the latest installed version
    • Adds new features to the current version 
      -J AO_INSTALL_TYPE=upgrade_new 
      This property is required in every options file.

AO_INSTALLING_FEATURES

Specifies the components to install on the target computer: 
REPO, CDP, AP, LAP, OCP, GRAPH 

The following property specifies the repository 
-J AO_INSTALLING_FEATURES=REPO 

The following property specifies a CDP and BMC Atrium Orchestrator Operator Control Panel. 
-J AO_INSTALLING_FEATURES=CDP,OCP 

With the exception of BMC Atrium Orchestrator Development Studio, this property is required in every options file.

AO_START_SERVER_ON_SUCCESS

Specifies whether to start the server after a successful installation:

  • true: Starts the server
  • false: Does not start the server 
    -J AO_START_SERVER_ON_SUCCESS=true 
    You can use this optional property with any of the components.

AO_SECURITY_COMM_HOST

Specifies the fully qualified domain name (FQDN) where BMC Atrium Single Sign-On is installed

AO_SECURITY_WEB_PORT

Specifies the port number where BMC Atrium Single Sign-On is installed

Default value: 8443

AO_SECURITY_WEB_PROTOCOL

Specifies the protocol on which BMC Atrium Single Sign-On is installed

Valid values: http, https (default)

AO_WEBSERVER_PORT

Specifies the port number for the repository 
Default value: 28080 
-J AO_WEBSERVER_PORT=28080

AO_WEBSERVER_SHUTDOWN_PORT

Specifies the web server shutdown port 
Default value: 28050 
-J AO_WEBSERVER_SHUTDOWN_PORT=28050

AO_WEBSERVER_PROTOCOL

Specifies the protocol on which the repository is installed

Valid values: http, https (default)

AO_WEBSERVER_HOST

Specifies the fully qualified domain name of the host where you want to install the repository or any other platform components

AO_WEBSERVER_URL

Specifies the URL used to launch the platform component

AO_AMADMIN_PASSWORD

Specifies the password required to log on to BMC Atrium Single Sign-On by using the default amadmin account

Note: Specify the password used during the installation of BMC Atrium Single Sign-On

This property is required while installing the repository and the CDP.

AO_WINDOWS_SERVICE_NAME

Specifies the service name on a Windows computer

Valid values: BAO-CDP, BAO-REPO, BAO-OCP, BAO-DB, BAO-AP, BAO-LAP, BAO-HACDP, or any custom alphanumeric value without spaces.


Installation properties for repository options file

The following table lists the properties to include in an options file that installs the repository component.

Installation properties for repository options file 

Property name

Description and sample property

AO_SECURITY_COMM_HOST

Specifies the fully qualified domain name of the host where BMC Atrium Single Sign-On is installed 
-J AO_SECURITY_COMM_HOST=vw-pun-atm-dv65.dsl.bmc.com

AO_SECURITY_WEB_PORT

Specifies the port used in the URL to launch BMC Atrium Single Sign-On 
-J AO_SECURITY_WEB_PORT=8443

AO_SECURITY_WEB_PROTOCOL

Specifies the protocol used in the URL to launch BMC Atrium Single Sign-On 
Default value: https 
-J AO_SECURITY_WEB_PROTOCOL=https


Installation properties for CDP options file

The following table lists the properties to include in an options file that installs the primary CDP component. For more information about grid properties that you can assign during CDP installation, see the Types and Logging tables in theCDP installation worksheet.

Installation properties for CDP options file 

Property name

Description and sample property

AO_ENVIRONMENT_NAME

Specifies the name of the environment 
-J AO_ENVIRONMENT_NAME=ENV2

AO_ADMIN_USERNAME

Specifies the name of the administrator. See Installing-the-repository for default user and password information. 

-J AO_ADMIN_USERNAME=<adminUser>

AO_ADMIN_PASSWORD

Specifies the name of the administrator password 

See Installing-the-repository for default user and password information.
-J AO_ADMIN_PASSWORD=<adminPassword>

AO_GRID_NAME

Specifies the grid name. A valid grid name contains 1-30 alphanumeric characters and does not contain any special characters or spaces. 
Default value: GRID1 
-J AO_GRID_NAME=DevGrid1

AO_GRID_TYPE

 

Specifies one of the following grid types: 

  • dev
  • test
  • preprod
  • prod 
    For more information about this grid property, see the Types table in CDP installation worksheet
    Default value: dev 
    -J AO_GRID_TYPE=prod

AO_GRID_LOGGING_LEVEL

 

Specifies one of the following logging levels: 

  • debug
  • info
  • warn
  • error
  • off 
    For more information about this grid property, see the Logging table in CDP installation worksheet
    Default value: debug 
    -J AO_GRID_LOGGING_LEVEL=warn

AO_CDP_IS_PRIMARY

 

Specifies whether the installation is for the initial CDP 

  • true: The peer is the primary CDP.
  • false: This peer is HA-CDP. 
    -J AO_CDP_IS_PRIMARY=true

AO_PEER_NAME

Specifies the name of the CDP 
Default value: CDP1 
-J AO_PEER_NAME=CDP1

AO_REPOSITORY_HOST

Specifies the host name or IP address for the repository. The value cannot be a loopback address. 
-J AO_REPOSITORY_HOST=vw-pun-atm-dv65.dsl.bmc.com

AO_REPOSITORY_PORT

Specifies the port used for the repository
Default value: 28080 
-J AO_REPOSITORY_PORT=28080

AO_REPOSITORY_PROTOCOL

Specifies the protocol used for the repository login page: http or https 
Default value: https 
-J AO_REPOSITORY_PROTOCOL=https

AO_REPOSITORY_USER_NAME

Specifies the user name required to log on 
Default value: admin 
-J AO_REPOSITORY_USER_NAME=admin

AO_REPOSITORY_PASSWORD

Specifies the password that corresponds to the user name

Note: The password value is encrypted and is not stored in the installation log.

-J AO_REPOSITORY_PASSWORD=mypassword

AO_CERT_PRINCIPAL

Specifies whether the certificate principal is the owner of the license; the expected value is a company name 
-J AO_CERT_PRINCIPAL=My Company Name

AO_CERT_PASSWORD

Specifies a password that is at least six characters in length 
-J AO_CERT_PASSWORD=mypassword

AO_PEER_COMM_PORT

Specifies the grid peer communications port number 
Default value: 38501 
-J AO_PEER_COMM_PORT=8501

AO_GRAPH_SERVER_HOST

Specifies the host name or IP address of the graphing server 
-J AO_GRAPH_SERVER_HOST=111.11.111.111

AO_GRAPH_SERVER_PORT

Specifies the port number for the graphing server 
-J AO_GRAPH_SERVER_PORT=8080

Installation properties for BMC Atrium Orchestrator Operator Control Panel options file

The following table lists the properties to include in an options file that installs the BMC Atrium Orchestrator Operator Control Panel. You can install the BMC Atrium Orchestrator Operator Control Panel separately or with a CDP or an AP. 

Installation properties for BMC Atrium Orchestrator Operator Control Panel options file 

Property name

Description and sample property

AO_PEER_NET_CONFIG_CDP_HOST

Specifies the host name or IP address of the CDP 
-J AO_PEER_NET_CONFIG_CDP_HOST=vw-pun-atm-dv65.dsl.bmc.com

AO_PEER_NET_CONFIG_CDP_PORT

Specifies the web communication port for the CDP 
-J AO_PEER_NET_CONFIG_CDP_PORT=38080

AO_PEER_NET_CONFIG_GRID_NAME

Specifies the name of the grid to join 
Default value: GRID1 
-J AO_PEER_NET_CONFIG_GRID_NAME=GRID2

AO_PEER_NET_CONFIG_PROTOCOL

Specifies the protocol: http or https 
Default value: https 
-J AO_PEER_NET_CONFIG_PROTOCOL=https

AO_PEER_NET_CONFIG_VALIDATE

Specifies whether to validate peer communications configuration

  • true: enables the silent installation program to test the peer-to-CDP or OCP-to-CDP communication configuration
  • false: continues the installation without validating the peer communication configurations 
    Default value: true 
    -J AO_PEER_NET_CONFIG_VALIDATE=true

Installation properties for AP, LAP, and HA-CDP options files

The following table lists the properties to include in an options file that installs optional peers. 

Installation properties for AP, LAP, and HA-CDP options files 

Property name

Description and sample property

AO_PEER_NET_CONFIG_CDP_HOST

Specifies the host name or IP address of the CDP 
-J AO_PEER_NET_CONFIG_CDP_HOST=vw-pun-atm-dv65.dsl.bmc.com

AO_PEER_NET_CONFIG_CDP_PORT

Specifies the web communication port for the CDP 
-J AO_PEER_NET_CONFIG_CDP_PORT=38080

AO_PEER_NET_CONFIG_CDP_USER

Specifies the user name required to log on 
Default value: admin 
-J AO_PEER_NET_CONFIG_CDP_USER=admin

AO_PEER_NET_CONFIG_CDP_PASSWORD

Specifies the password that corresponds to the user name 
Default value: admin123

Note: The password value is encrypted and is not stored in the installation log.

-J AO_PEER_NET_CONFIG_CDP_PASSWORD=admin123

AO_PEER_NET_CONFIG_GRID_NAME

Specifies the name of the grid to join 
Default value: GRID1 
-J AO_PEER_NET_CONFIG_GRID_NAME=GRID1

AO_PEER_NET_CONFIG_NEW_PEER_NAME

Specifies the name of the new peer to install 
-J AO_PEER_NET_CONFIG_NEW_PEER_NAME=AP1

AO_PEER_NET_CONFIG_PROTOCOL

Specifies the protocol: http or https 
Default value: http 
-J AO_PEER_NET_CONFIG_PROTOCOL=http

Note: Do not set the value to https unless you have configured the web server container for SSL. 

AO_PEER_NET_CONFIG_VALIDATE

Specifies whether to validate peer communications configuration

  • true: enables the silent installation program to test the peer-to-CDP or OCP-to-CDP communication configuration
  • false: continues the installation without validating the peer communication configurations 
    Default value: true 
    -J AO_PEER_NET_CONFIG_VALIDATE=true

Installation properties for BMC Atrium Orchestrator Development Studio options files

Silent installation properties lists the properties that you can include in the options file for BMC Atrium Orchestrator Development Studio.   

Installation properties for BMC Atrium Orchestrator Development Studio options files 

Property name

Description and sample property

installLocation

Specifies the full path to the installation directory 

Default value:

Windows: c:\Program Files\BMC Software\AO\Studio 

  • -P /Applications/BMC Software/AO/Studio

DEVSTUDIO_INSTALL_TYPE

 Specifies installation for the BMC Atrium Orchestrator Development Studio component

  • install_new 
    Installs a new version of BMC Atrium Orchestrator Development Studio 
    -J DEVSTUDIO_INSTALL_TYPE=install_new
  • upgrade_new 
    Performs the following upgrade actions:
    • Upgrades from an earlier version of the component to the latest version
    • Repairs the latest installed version
    • Adds new features to the current version 
      -J DEVSTUDIO_INSTALL_TYPE=upgrade_new

DEVSTUDIO_WORKSPACE_DIR

Specifies path to the workspace folder, which is the folder where BMC Atrium Orchestrator Development Studio stores your work 

Note; Ensure that you specify the path exactly as it appears in your file system, including upper- and lowercase characters.

This directory must exist before you execute the silent installation. 

-J DEVSTUDIO_WORKSPACE_DIR=c:\DevStudioWork

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*