Installing BMC Digital Workplace silently

When you install BMC Digital Workplace in silent mode, you run the installer from a command line. For other options for installing BMC Digital Workplace, see Performing the BMC Digital Workplace installation.

Before you begin

Complete the steps in Preparing for installation of BMC Digital Workplace.

To create an options.txt file

Before you can run the installer in silent mode, you must create an options.txt file to identify the options that you want the installer to include in the installation or upgrade. Use one of the following methods to create the options.txt file:

Method

Steps

Make the installer generate an options file based on the current installation.

Run an installation on a computer that you want to use as a model for silent installations on other computers.. Add the following option to the command line when you run the installer:

-DGENERATE_OPTIONS_FILE=<OutputOptionsFileName>.txt

Create an options.txt file from an installation log.

From an installation log in the Log Viewer, click the tab of the installation run from which you want to generate an options file.
Select File > Save As.
From the Save As Type list, select Project Options File.
Enter a file name, and click OK.

Example options.txt file

The following example shows an options.txt file that is used to run the installer in silent mode:

# General parameters
-J BMC_USER_INSTALL_DIRECTORY=/opt/bmc/dwp
-J BMC_JAVA_JRE_64_BIT_HOME_PATH=

# RoD installations MyIT Only = true (Without integration with Remedy)
# Hybrid installation BMC_SEPARATE_MYIT=true
# ONLY FOR FRESH INSTALLATION
-J BMC_MYIT_ONLY=false
-J BMC_SEPARATE_MYIT=false

# Set property to "false" if ADVANCED mode is required.
-J BASE_RUN_MODE_USED=true


# For pre-created DB if you are not using a DB admin account 
-J CREATE_NEW_DB=false 
-J USE_EXISTING_DB=true 
# These values will correspond to the users you specified when pre-creating the database: 
-J BMC_MYIT_RDBMS_SCHEMA_SYSTEM_DATA= 
-J BMC_MYIT_RDBMS_SCHEMA_BUSINESS_DATA=

# Cluster information
# Only for fresh installations
-J BMC_MYIT_CLUSTER_MODE=[PRIMARY/SECONDARY]

# RDBMS information
# ONLY FOR FRESH INSTALLATION
-J CREATE_NEW_DB=true
-J USE_EXISTING_DB=false
-J BMC_MYIT_RDBMS_HOST=[YOUR DB HOSTNAME HERE]
-J BMC_MYIT_RDBMS_SID_OR_DB_NAME=[SID_OR_DB_NAME]
-J ORACLE_RDBMS_USED=[true/false]
-J MS_SQL_RDBMS_USED=[true/flase]
-J BMC_MYIT_RDBMS_PORT=[1521/1433]
-J BMC_MYIT_RDBMS_USER=[system/sa]
-J BMC_MYIT_RDBMS_PASSWORD=bmcAdm1n
-J BMC_MYIT_RDBMS_SCHEMA_BUSINESS_DATA=Hybrid_Business
-J BMC_MYIT_RDBMS_SCHEMA_SYSTEM_DATA=Hybrid_System
-J BMC_MYIT_RDBMS_SCHEMA_BUSINESS_PASSWORD=bmcAdm1n
-J BMC_MYIT_RDBMS_SCHEMA_SYSTEM_PASSWORD=bmcAdm1n

# AR server information - Only for on-premise installations
# ONLY FOR FRESH INSTALLATION
-J BMC_AR_PASSWORD=bmc
-J BMC_AR_SERVER_NAME=ITSMhostname
-J BMC_AR_PORT=2222

# Tomcat information - Only for fresh installations
-J BMC_MYIT_INSTALL_TOMCAT=true
-J BMC_MYIT_JSP_TOMCAT_INSTALL_DIRECTORY=/opt/apache/tomcat8
-J BMC_MYIT_JSP_TOMCAT_HTTP_PORT=9000
-J BMC_IS_TOMCAT_SSL_ON=[true/false]
-J BMC_SSL_KEYSTORE_PATH=/opt/keystore.jks
-J BMC_SSL_KEYSTORE_PASSWORD=bmcAdm1n
-J BMC_TOMCAT_SSL_PORT=8443

To encrypt a password for silent installation

The options file for BMC Remedy AR System must contain the administrator password for the target computer. The Maintenance Tool enables you to create an encrypted password that you can paste into the options file. Perform the following steps:

Start the BMC Remedy AR System Maintenance tool as explained in the BMC Remedy AR System documentation.
Click the Encrypt tab.
In the Password and Confirm Password fields, type your password.
Click Encrypt.
Copy and paste the encrypted password into the options.txt file for your silent installer.
For example, if you want to encrypt the application system password and the output is DES\:b76c59dbc2e1433c7a9c2f006a2e2429116840dce695aea9, enter the following strings:
```
# -J BMC_ITSM_PASSWORD=DES\:b76c59dbc2e1433c7a9c2f006a2e2429116840dce695aea9
```

Note

To encrypt a password through the command line, use the -encrypt option. For example, enter:

<product>MaintenanceTool.cmd -silent -encrypt -encrypt -password=<password> -confirm_password=<password>

To run the installer in silent mode

Create an options.txt file that contains the options for the installer:
- Copy and paste options from the example DWP-ini-template.txt file (usually found in the utility folder of the BMC Remedy AR System installer files) into an options.txt file for the installation that you want to run.
- Use an options.txt file generated in an earlier installation.
- Create an options.txt file from an example options.txt file.
Using the Installation worksheets for BMC Digital Workplace as a guide, edit the options accordingly, ensuring that you include the appropriate option.
As you edit the options.txt file, apply the following guidelines:
- Remove the comment (#) markers.Make sure that the options.txt file includes the following line:
  -J BMC_SEPARATE_MYIT=false
- In UNIX environments, ensure that no Ctrl+M characters appear in the options.txt file.
Run the installer with the -i silent option:
- (Windows) setup.exe -i silent -DOPTIONS_FILE=c:\path\to\options.txt
- (UNIX) ./setup.bin -i silent -DOPTIONS_FILE=/path/to/options.txt

Where to go from here

Verifying the BMC Digital Workplace installation