Silent installation properties


The silent installation property values are listed in the options text file that defines the type of installation, the components to install, the installation location, and the configuration settings for the components. The installation properties are in the form of a prefix tag followed by a property name and value pair. For more information, see the sample options file that is provided with the installer files.

This topic provides information about the following:

Prefix tags

The following table lists the prefix tags that precede the installation properties.

Prefix tags for silent installation properties

Prefix tags

Description

-J

Precedes Java properties

-P

Precedes directory properties

-A

Precedes application features

Success

Tip

To increase the viewing area of the information in this topic, hide the navigation pane on the left side of your screen by pressing [ or open the page in full screen mode by pressing F. To show the navigation pane, press [ or to exit full screen mode, press Esc.

Warning

Note

You must encrypt the password for each of the password properties. You can run the BRPMMaintenanceTool.cmd (Windows) or BRPMMaintenanceTool.sh (Linux) tool packaged with the solution for encrypting passwords. This tool is located in the RLMhome\Disk1\utility directory.

Silent installation properties for BMC Release Process Management

An asterisk in the Required column indicates that a property is required only under certain conditions. See the Description column for more information.

Property name

Required

Description

New installation

-P installLocation

Yes

Specifies the full path to the installation directory
Default values:

  • Windows: C:\Program Files\BMC Software\RLM
  • UNIX: /opt/bmc/RLM

Example: -P installLocation=/opt/bmc/RLM

Migration information

-J BMC_MIGRATE_EXISTING_BRPM_INSTALLATION

Yes

Specifies whether you want to upgrade your current BRPM version to the new version.

  • Not to upgrade from your current version to the new version, enter false
  • To upgrade from your current version to the new version, enter true, and then specify the following required properties:
    -J BMC_BRPM_DATABASE_MIGRATION
    -J BMC_AUTOMATION_RESULTS
    -J BMC_OTHER_SETTING
    -J BMC_REFERENCE_BRPM_INSTALLATION_PATH
    -J BMC_BRPM_MIGRATION_VERSION
-J BMC_BRPM_DATABASE_MIGRATION

 

No*

Specifies if you want to update the existing database to the new version or delete the existing database and create a new database.

Note: This property is required only if you want to upgrade your current BRPM version to the new version.

  • To update the existing database, enter the following text: -J BMC_BRPM_DATABASE_MIGRATION=USE_SAME_DATABASE
  • To delete the existing database and create a new one, enter the following text:
    -J BMC_BRPM_DATABASE_MIGRATION=USE_SAME_DATABASE_EMPTY_DATABASE_CONTENTS
-J BMC_AUTOMATION_RESULTS

No*

Specifies to save your current BRPM automation results:

Note: This property is required only if you want to upgrade your current BRPM version to the new version in a new folder.

-J BMC_AUTOMATION_RESULTS=COPY_DATA

Default value: -J BMC_AUTOMATION_RESULTS = REFER_SAME_LOCATION

–J BMC_OTHER_SETTINGS

No*

Specifies whether you want to keep your additional settings (such as SMTP configuration).

Note: This property is required only if you want to upgrade your current BRPM version to the new version.

  • To copy your existing configuration, enter the following:
    -J BMC_OTHER_SETTINGS=COPY_CONFIGURATION
  • To discard your existing configuration, enter the following:
    -J BMC_OTHER_SETTINGS=DISCARD
-J BMC_REFERENCE_BRPM_INSTALLATION_PATH

No*

Specifies the directory path to your current BRPM installation.

Note: This property is required only if you want to upgrade your current BRPM version to the new version.

Warning: If you do not specify the correct reference BRPM installation path, the \RLM\releases folder might be removed during the upgrade.

The default directory paths are:

  • Windows: C:\Program Files\BMC Software\RLM.
  • Linux: /opt/bmc/RLM

Example: -J BMC_REFERENCE_BRPM_INSTALLATION_PATH=/opt/bmc/RLM/releases/5.3.0/RPM

–J BMC_BRPM_MIGRATION_VERSION

No

(Optional) Specifies the existing BRPM version.

Note: This property is required only if you want to migrate your current BRPM version to the new version.

Example: -J BMC_BRPM_MIGRATION_VERSION = 5.0.03.003

-J BMC_BRPM_SKIP_DB_MODIFICATION_FOR_CLUSTER

No

(Optional) Specifies whether to modify the database (used for cluster installation only).

Example: -J BMC_BRPM_SKIP_DB_MODIFICATION_FOR_CLUSTER = false (true)

Instance type selection

-J BMC_BRPM_INSTANCE_TYPE

Yes

Specifies the deployment mode for BRPM.

  • To run BRPM as a single instance, enter -J BMC_BRPM_INSTANCE_TYPE=STANDALONE and then specify the following required properties:
    -J BMC_BRPM_CLUSTER_NODE_NAME
    -J BMC_BRPM_CLUSTER_NODE_IP
  • To run BRPM as a node in the cluster, enter -J BMC_BRPM_INSTANCE_TYPE=CLUSTER, and then specify the following required properties:
    -J BMC_BRPM_CLUSTER_NODE_NAME
    -J BMC_BRPM_CLUSTER_NODE_IP

-J BMC_BRPM_CLUSTER_NODE_NAME

No*

Specifies the name of the cluster node or standalone instance on which BRPM is running.

Example: -J BMC_BRPM_CLUSTER_NODE_NAME=node1

-J BMC_BRPM_CLUSTER_NODE_IP

No*

Specifies the IP address of the cluster node or standalone instance on which BRPM is running.

Example: -J BMC_BRPM_CLUSTER_NODE_IP=192.168.0.1

Feature selection

-A featureBRPM

Yes

Specifies the installation of the BRPM product.

-A PostgreSQL

No

(Optional) Specifies whether to install the PostgreSQL server. BRPM comes bundled with a PostgreSQL server. Installation of the PostgreSQL server is optional.

JRE information

-J USE_BMC_BUNDLED_JRE

Yes

Specifies whether to install the JRE bundled with the product.

  • Set to true if the bundled JRE must be installed.
  • Set to false if you want to use the JRE version that is already installed on your computer, and then specify the -J BMC_JAVA_JRE_PATH property.
-J BMC_JAVA_JRE_PATH

 

No*

Specifies the path for the JRE on your computer.

Note: This property is required only if you want to use JRE installed on your computer (-J USE_BMC_BUNDLED_JRE=false)

Example: -J BMC_JAVA_JRE_PATH=C:\RPM\lib\jre

Installation type

-J BMC_BRPM_INSTALL_TYPE

Yes

Specifies whether you perform the installation as a root or as a non-root user.

  • To install as a non-root user:
    -J
    BMC_BRPM_INSTALL_TYPE=PARTIAL_PRIVILEGE
  • To install as a root user:
    -J
    BMC_BRPM_INSTALL_TYPE=FULL_PRIVILEGE

HTTPS port information

-J GENERATE_SELF_SIGNED_CERTIFICATE

No*

Specifies whether or not you want to use the self-signed certificate generated by the installer.

Example: -J GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J GENERATE_SELF_SIGNED_CERTIFICATE=FALSE

-J BMC_BRPM_HTTPS_PORT

No*

Specifies the HTTPS port.

Example: -J BMC_BRPM_HTTPS_PORT=8443

-J BMC_BRPM_KEYSTORE_PASSWORD

No*

Specifies the password used to generate the private key.

Example: -J BMC_BRPM_KEYSTORE_PASSWORD= DES\:c0327a60f9d00b3792580258e5f6feee

-J BMC_BRPM_PRIVATE_KEY

No*

Specifies the private key file and the path to the file.

This property is required only if GENERATE_SELF_SIGNED_CERTIFICATE=FALSE

Note: The private key must be generated separately.

Example: -J BMC_BRPM_PRIVATE_KEY=/tmp/key.der

-J BMC_BRPM_CERTIFICATE_FILE

No*

Specifies the certificate file and the path to the file.

This property is required only if GENERATE_SELF_SIGNED_CERTIFICATE=FALSE

Note: The certificate file must be generated separately. 

Example: -J BMC_BRPM_CERTIFICATE_FILE=/tmp/cert.der

-J SSL_COMMON_NAME

No*

Specifies the host name or IPv4 address of the server.

This property is required only if GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J SSL_COMMON_NAME=SAT Pvt Ltd

Note: This field must match the host name in the URL that is used to access BRPM.

-J CERT_ORG_UNIT

No*

Specifies the name of the name of your organization unit.

This property is required only if GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J CERT_ORG_UNIT=Development

-J CERT_ORG_NAME

No*

Specifies the name of your organization.

This property is required only if GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J CERT_ORG_NAME=SAT

-J CERT_LOCALITY

No*

Specifies your city or other locality.

This property is required only if GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J CERT_LOCALITY=New York

-J CERT_STATE

No*

Specifies the name of your state, province, or other political subdivision.

This property is required only if GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J CERT_STATE=New York

-J CERT_COUNTRY

No*

Specifies the name of your country.

This property is required only if GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Note: You can specify only upto 2 characters as the property value.

Example: -J CERT_COUNTRY=US

Superuser information

-J BMC_SUPERUSER_FIRSTNAME

Yes

Specifies the first name for the superuser.

Example: -J BMC_SUPERUSER_FIRSTNAME=John

-J BMC_SUPERUSER_LASTNAME

Yes

Specifies the last name for the superuser.

Example: -J BMC_SUPERUSER_LASTNAME=Administrator

-J BMC_SUPERUSER_EMAIL

Yes

Specifies the email ID of the superuser.

Example: -J BMC_SUPERUSER_EMAIL=admin@example.com

-J BMC_SUPERUSER_LOGIN

Yes

Specifies the superuser login ID, which is used for the first login.

Example: -J BMC_SUPERUSER_LOGIN=admin

-J BMC_SUPERUSER_PASSWORD,
-J BMC_SUPERUSER_CONFIRM_PASSWORD

Yes

Specifies the encrypted password that corresponds to the superuser login ID.
The password must be encrypted by the utility provided.

Examples:

  • -J BMC_SUPERUSER_PASSWORD= DES\:9c61a83f6c17233a2d6a967aa95bb1ec
  • -J BMC_SUPERUSER_CONFIRM_PASSWORD= DES\:9c61a83f6c17233a2d6a967aa95bb1ec

Database information

 

 

-J BMC_DB_TYPE

Yes

Specifies the database that you want to use. You can specify one of the following values:

  • POSTGRESQL
  • ORACLE
  • SQL_SERVER

Example: -J BMC_DB_TYPE=POSTGRESQL

-J BMC_DB_HOST

Yes

Specifies the computer name or the IP address of the server where your database is installed.

Example: -J BMC_DB_HOST=127.0.0.1

-J BMC_DB_PORT

Yes

Specifies the port of the server that you used for installing your database.

Example: -J BMC_DB_PORT=5432

-J BMC_DB_NAME

Yes

Specifies the database name or SID for the BRPM database.

  • If you use PostgreSQL or Microsoft SQL Server, specify the name of the database instance that was used during the database installation.
  • If you use Oracle, specify the SID details or the service name in the following formats:
    Note: For Oracle RAC, use service name only.Example:
    • If your SID name is rpmorclsid, enter rpmorclsid (-J BMC_DB_NAME=rpmorclsid)
    • If your service name is rpmorclservice, enter  /rpmorclservice (-J BMC_DB_NAME=rpmorclservice )
-J BMC_DB_USER_NAME

Yes

Specifies the user name of the database instance that was used during the database installation.

Example: -J BMC_DB_USER_NAME=brpmuser

-J BMC_DB_USER_PASSWORD

Yes

Specifies the encrypted password of the database instance that was used during the database installation.

Example: -J BMC_DB_USER_PASSWORD= DES\:35582269c6fa5491949a671e3db0c4c5

Messaging system information

 

 

-J BMC_MESSAGING_SYSTEM_PORT

Yes

Specifies the port of the messaging system server.

Example: -J BMC_MESSAGING_SYSTEM_PORT=1190

-J BMC_MESSAGING_SYSTEM_USER_NAME

Yes

Specifies the user name of the messaging system server.

Example: -J BMC_MESSAGING_SYSTEM_USER_NAME=brpmuser

-J BMC_MESSAGING_SYSTEM_USER_PASSWORD

Yes

Specifies the encrypted password of the messaging system server.

Example:  -J BMC_MESSAGING_SYSTEM_USER_PASSWORD= DES\:35582269c6fa5491949a671e3db0c4c5

Email notification information

 

 

-J MAIL_NOTIFICATIONS

Yes

Specifies whether you want to use email notification settings for the BRPM.

  • Not to receive email notifications:
    -J
    MAIL_NOTIFICATIONS=NO_NOTIFICATIONS
  • To use and configure email notifications, enter   -J   MAIL_NOTIFICATIONS=USE_SMTP, and then specify the following required properties:-J  BMC_SMTP_HOST
    -J BMC_SMTP_PORT
    -J BMC_SMTP_DOMAIN_NAME
    -J BMC_SMTP_AUTHENTICATION
    -J BMC_SMTP_USER_NAME
    -J BMC_SMTP_USER_PASSWORD
    -J BMC_SMTP_TLS
-J BMC_SMTP_HOST

No*

Specifies the fully qualified name or the IP address of the SMTP server used for sending emails.

Note: This property is required if you configure to receive email notifications (-J MAIL_NOTIFICATIONS=USE_SMTP).

Example: -J BMC_SMTP_HOST=smtp.gmail.com

-J BMC_SMTP_PORT

No*

Specifies the SMTP server port.

Note: This property is required if you configure to receive email notifications (-J MAIL_NOTIFICATIONS=USE_SMTP).

Example: -J BMC_SMTP_PORT=25

-J BMC_SMTP_DOMAIN_NAME

No*

Specifies the SMTP domain name in email notification address.
For example, if your user name is redmine@example.net, then your domain name is example.net.

Note: This property is required if you configure to receive email notifications (-J MAIL_NOTIFICATIONS=USE_SMTP).

Example: -J BMC_SMTP_DOMAIN_NAME=$SMTP_DOMAIN

-J BMC_SMTP_AUTHENTICATION

No*

Specifies the authentication mechanism used for your SMTP service.

Note: This property is required if you configure to receive email notifications (-J MAIL_NOTIFICATIONS=USE_SMTP).

Specify one of the following values:

  • none
  • plain
  • login
  • cram_md5

Example: -J BMC_SMTP_AUTHENTICATION=login

-J BMC_SMTP_USER_NAME

No*

Specifies the user name used to connect to the SMTP server.

Notes: This property is required under following conditions:

  • You configure to receive email notifications (-J MAIL_NOTIFICATIONS=USE_SMTP
  • You do not use SMTP authentication (-J BMC_SMTP_AUTHENTICATION=none)

Example: -J BMC_SMTP_USER_NAME=brpmtest2@gmail.com

-J BMC_SMTP_USER_PASSWORD

No*

Specifies the encrypted password used to connect to the SMTP server.

Notes: This property is required under following conditions:

  • You configure to receive email notifications (-J MAIL_NOTIFICATIONS=USE_SMTP
  • You do use SMTP authentication (-J BMC_SMTP_AUTHENTICATION=plain, -J BMC_SMTP_AUTHENTICATION=login, or -J BMC_SMTP_AUTHENTICATION=cram_md5)

Example: -J BMC_SMTP_USER_PASSWORD= DES\:35582269c6fa5491949a671e3db0c4c5

-J BMC_SMTP_TLS

No*

Specifies whether your SMTP server requires a secure connection and is using TLS.

Note: This property is required if you configure to receive email notifications (-J MAIL_NOTIFICATIONS=USE_SMTP).

  • If you use secure connection (TLS), set this property to true
  • If you use HTTP, set this property to false

Example: -J BMC_SMTP_TLS=true

TorqueBox/JBoss superuser details

 

 

-J BMC_TORQUEBOX_SUPERUSER_LOGIN

Yes

Specifies the user login for accessing the TorqueBox or JBoss server.

Example: -J BMC_TORQUEBOX_SUPERUSER_LOGIN=superuser

-J BMC_TORQUEBOX_SUPERUSER_PASSWORD

Yes

Specifies the user password for accessing the TorqueBox or JBoss server.

Example: -J BMC_TORQUEBOX_SUPERUSER_PASSWORD= DES\:a751b8161238d051e4e986421d24d2dcd1cff043003f0e35

-J BMC_TORQUEBOX_SUPERUSER_CONFIRM_PASSWORD

Yes

Confirms the specified user password for accessing the TorqueBox or JBoss server.

Example: -J BMC_TORQUEBOX_SUPERUSER_CONFIRM_PASSWORD= DES\:a751b8161238d051e4e986421d24d2dcd1cff043003f0e35

Silent installation properties for 

WarningSome content is unavailable due to permissions.

Property name

Required

Description

New installation

-P installLocation

Yes

Specifies the full path to the installation directory

Default value:

  • Windows: C:\Program Files\BMC Software\RLMUI
  • UNIX: /opt/bmc/RLMUI

Example: -P installLocation=/opt/bmc/RLMUI

Feature selection

-A featureRPMUI

Yes

Specifies the installation of

WarningSome content is unavailable due to permissions.

.

-A featureApache

Yes

Specifies the installation of the Apache HTTP server.

Installation type

-J INSTALL_TYPE

 Yes

Specifies whether you perform the installation as a root or as a non-root user.

  • To install as a non-root user:
    -J
    INSTALL_TYPE=PARTIAL_PRIVILEGE
  • To install as a root user:
    -J
    INSTALL_TYPE=FULL_PRIVILEGE

HTTPS port information

-J GENERATE_SELF_SIGNED_CERTIFICATE

No*

Specifies whether or not you want to use the self-signed certificate generated by the installer.

Example: -J GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J GENERATE_SELF_SIGNED_CERTIFICATE=FALSE

-J HTTPS_PORT

Yes

Specifies the HTTPS port.

Example: -J HTTPS_PORT=443

-J PRIVATE_KEY_PASSWORD

No*

Specifies the password used to generate the private key.

Example: -J PRIVAYE_KEY_PASSWORD= DES\:c0327a60f9d00b3792580258e5f6feee

-J PRIVATE_KEY_FILE

No*

Specifies the directory path to the private key for SSL encryption.

This property is required only if GENERATE_SELF_SIGNED_CERTIFICATE=FALSE

Example: -J PRIVATE_KEY_FILE=/home/user/Documents/private_key

-J CERTIFICATE_FILE

No*

Specifies the directory path to the certificate for SSL connection.

This property is required only if GENERATE_SELF_SIGNED_CERTIFICATE=FALSE

Example: -J CERTIFICATE_FILE=/home/user/Documents/cert_file

-J SELF_SIGNED_CERTIFICATE_LOCATION

No*

Specifies the location where you want to store the generated self-signed certificate.

Note: This property is required only if GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J SELF_SIGNED_CERTIFICATE_LOCATION=/home/user/Documents

-J SSL_COMMON_NAME

No*

Specifies the host name or IPv4 address of the server.

This property is required only if you set GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Note:  This field must match the host name in the URL that is used to access BRPM.

Example: -J SSL_COMMON_NAME=SAT Pvt Ltd

-J CERT_ORG_UNIT

No*

Specifies the name of the name of your organization unit.

This property is required only if you set GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J CERT_ORG_UNIT=Development

-J CERT_ORG_NAME

No*

Specifies the name of your organization.

This property is required only if you set GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J CERT_ORG_NAME=SAT

-J CERT_LOCALITY

No*

Specifies your city or other locality.

This property is required only if you set GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J CERT_LOCALITY=New York

-J CERT_STATE

No*

Specifies the name of your state, province, or other political subdivision.

This property is required only if you set GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Example: -J CERT_STATE=New York

-J CERT_COUNTRY

No*

Specifies the name of your country.

This property is required only if you set GENERATE_SELF_SIGNED_CERTIFICATE=TRUE

Note: You can specify only upto 2 characters as the property value.

Example: -J CERT_COUNTRY=US

BMC Release Process Management server information

-J BRPM_BACKEND_URL

Yes

Specifies the URL to the BMC Release Process Management 5.0.server.

Examples: 

-J BRPM_BACKEND_URL=http://121.183.175.44:8080/brpm
-J BRPM_BACKEND_URL=https://server_1.domain_name:8443/brpm 

 

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

BMC Release Process Management 5.0.06