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. Click here to view the documentation for the current version.

Example options.txt file

The options in the following example were used in an working installation. To encrypt the passwords as shown in this example, see Encrypting passwords for silent installations.

Example
################################################################################
# MyIT Service Broker installer configuration file
#
# This file contains the settings that are required by the installation scripts.
# Update the parameters with the specific values for the application server.
#
# Unless otherwise specified, the following syntax applies:
# - Options where default values are empty require information about your system.
# - Options with default values can be replaced.
#
# IMPORTANT:
# The installation process should be run with root user access permissions.
# If required libraries are missing from your system, the installer will
# generate a list of dependencies in a script that must be run. Then you
# can run this installer again.
#
################################################################################



################################################################################
# Application platform install location
#
# The application runs on a modified BMC AR System platform. The AR System
# parameters in this options.txt file pertain to this modified platform.
#
# If the -P option is not set, the default location will be set based on your
# operating system:
#
# - UNIX/Linux: /opt/bmc/ARSystem
#
################################################################################

-P installLocation=/opt/bmc/ARSystem



################################################################################
# Dependency installation location
#
# You must specify the locations where dependencies should be installed.
# The examples show suggested values that are not specified by default.
#
################################################################################

# Oracle JRE home path
#
# Optional if Java is not presently installed.
# Required if Java is currently installed.
#
# If Java is not installed, then leave this option and Java v1.8 will
# be installed into the default location.
# If Java is installed, then this location must point to the JRE folder
# of a valid Java installation or else the installation will fail.
#
# Example: BMC_JAVA_JRE_64_BIT_HOME_PATH=/usr/lib/jvm/java-1.8.0/jre
#

-J BMC_JAVA_JRE_64_BIT_HOME_PATH=/usr/java/latest


################################################################################
# BMC Remedy Action Request System specific properties
#
# The application runs on a modified BMC AR System platform. The AR System
# parameters in this options file refer to this modified platform.
#
################################################################################

# AR System administrator user login name
#
# The admin account to be created. This account will be used to install
# the initial tenant data when BMC_ARSERVER_SAMPLE_DATA around line 265
# is set to true.
#

-J BMC_AR_USER=Demo

# AR System administrator user password
#
# Enter the same value to set and confirm the password.
# In this example, the Demo account password is empty.
#

-J BMC_AR_PASSWORD=DES\:facfe8dfd0743920d8d901de05557886
-J BMC_AR_CONFIRM_PASSWORD=DES\:facfe8dfd0743920d8d901de05557886

# Application Service password
#
# Create a password for the BMC Remedy AR System server
# where MyIT Service Broker will be installed.
#
# A default password must be provided.
#

-J BMC_AR_APPLICATION_PASSWORD=DES\:facfe8dfd0743920d8d901de05557886

# Application service account password for Mid Tier server
#
# A default password must be provided.
#

-J BMC_MIDTIER_PASSWORD=DES\:facfe8dfd0743920d8d901de05557886

# Application service account password to manage DSO
#
# A default password must be provided.
#

-J BMC_AR_DSO_PASSWORD=DES\:facfe8dfd0743920d8d901de05557886

# AR System server port
#
# The port on which the AR System server will listen for connections.
# The default port is specified below. Change the port only if required.
#

-J BMC_AR_PORT=9988

# AR System plugin port
#
# The port on which the AR System server will listen for AR System plugins.
# The default port is specified below. Change the port only if required.
#

-J BMC_AR_PLUGIN_PORT=9977

# AR System Server Role
#
# Uncomment to specify whether the server instance is a master or slave node. 
# Default is "master" for single instance server. For Multi-Node specify the 
# master node as "master" and the remaining nodes as "slave"

#-J BMC_AR_SERVER_ROLE=master

# AR System server instance name
#
# The reference to the platform AR System server.
# The default is localhost. Change the instance name only if required.
#

-J BMC_AR_SERVER_NAME=localhost

# AR System server host name
#
# The Fully Qualified Domain Name or IP address of the platform
# AR System server.
#
# The default IP address is specified. Change this value only if required.

-J BMC_AR_SERVER_HOST_NAME=127.0.0.1

# BMC Marketplace location
#
# Reserved for future integration with BMC Marketplace.
# Can be left blank.
#

-J BMC_MARKETPLACE=



################################################################################
# Database Options
################################################################################

# Database administrator login name
#
# The login name for the platform AR System server DBA user account.
#
# - Oracle database server example: BMC_DATABASE_DBA_LOGIN=system
# - MSSQL Server example: BMC_DATABASE_DBA_LOGIN=sa
#

# To install as non-DBA using precreated databases, comment out this option:
#-J BMC_DATABASE_DBA_LOGIN=

# Database administrator password
#
# The password for the platform AR System server DBA user account.
#

# To install as non-DBA using precreated databases, comment out this option:
#-J BMC_DATABASE_DBA_PASSWORD=

# Tenant administrator user login name
#
# The login name for the platform AR System server non-DBA admin
# user that will be created.
#
# Example: -J BMC_DATABASE_LOGIN=ARAdmin
#

-J BMC_DATABASE_LOGIN=MYITSB_APPDB

# Tenant administrator user password
#
# The password for the platform AR System server non-DBA user.
# Enter the same value twice to set and confirm the password.
#

-J BMC_DATABASE_PASSWORD=DES\:36770645f38b921cc6b93f4e064d440bc0991807380d076f
-J BMC_DATABASE_CONFIRM_PASSWORD=DES\:36770645f38b921cc6b93f4e064d440bc0991807380d076f


# Database engine type
#
# The database engine installed for use as the platform server.
# - If MSSQL Server, specify SQL_SERVER
# - If Oracle, specify ORACLE
#

-J BMC_DATABASE_TYPE=ORACLE

# Database server host location
#
# The Hostname or IP address of the database server.
#
# Example: -J BMC_DATABASE_HOST=172.22.192.54
#

-J BMC_DATABASE_HOST=myitsb-db-server.com

# Database port
#
# The port number associated with the Fully Qualified Domain Name
# of the database server.
#

-J BMC_DATABASE_PORT=1521

# Database server instance name
#
# The Oracle database SID name or the MSSQL Server database instance name.
# Note: Oracle SID names cannot be more than 8 characters in length.
#
# Example: -J BMC_DATABASE_INSTANCE=ora112db
#

-J BMC_DATABASE_INSTANCE=ORAIDDSB

# Database overwrite existing data option
#
# To drop and recreate the AR System tablespaces and database objects, specify
# "overwrite". When upgrading an existing version of MyIT Service Broker,
# leave the value blank. This can also be left blank for fresh installations
# as long as tablespace names you have specified in this options.txt file
# do not already exist.
#

#-J BMC_DATABASE_OPTION=

# Seed AR System server sample data
#
# Specify whether to seed initial AR System data during installation.
# Requires BMC_AR_TENANT_TABLESPACE_NAME to be set to the name of a
# tenant database tablespace already created or that you will create.
# Supported values: true, false
#

-J BMC_ARSERVER_SAMPLE_DATA=false

# Database tablespace name
#
# The name of the platform AR System database schema.
#

-J BMC_DATABASE_DBA_TABLESPACE_NAME=MYITSB_APPDB

# Database datafile name
#
# The name of the platform AR System physical database file.
#

-J BMC_DATABASE_DBA_DATAFILE_NAME=MYITSB_APPDB.DBF

# Database logfile name
#
# The name of the platform AR System database log file.
#

-J BMC_DATABASE_DBA_LOGFILE_NAME=MYITSB_APPDB.LOG

# Database datafile size
#
# The maximum size of the platform AR System database data file.
#

-J BMC_DATABASE_DBA_DATAFILE_SIZE=2000

# Database logfile size
#
# The maximum size of the database log file.
#

-J BMC_DATABASE_DBA_LOGFILE_SIZE=1000

# Database character encoding method
#
# Specify if UTF Character Encoding is used.
# Supported values: true, false
#

-J BMC_DATABASE_UTF=true

# Database authentication method
#
# The preferred method of authentication for the database Sys Admin.
# Supported values: WINDOWSAUTH, SQLAUTH
#

-J BMC_SQLSERVER_WINDOWSAUTH_OR_SQLAUTH=SQLAUTH

# Identify Oracle by SID or service name
#
# Required for Oracle installations, ignored by MSSQL installations.
# Leave set to the default value: true
#

-J BMC_DATABASE_ORACLE_SID_OR_SERVICE=true

# MyIT Service Broker installation process
#
# To install a new system, specify: Install
# To upgrade an existing system, specify: Upgrade
#

-J BMC_ARSYSTEM_INSTALL_OPTION=Install

# AR System plugin server 32-bit JRE version
#
# If running a 32-bit plugin server, specify: true
# If running a 64-bit plugin server, specify: false
#

-J BMC_JAVA_AR_SERVER_SELECTED_FOR_32BIT=false

# AR System email server 32-bit JRE version
#
# If running a 32-bit plugin server, specify: true
# If running a 64-bit plugin server, specify: false
#

-J BMC_JAVA_EMAIL_ENGINE_SELECTED_FOR_32BIT=false

# The default viewing language
#
# Specify the language to display information.
# Supported value: en
#

-J BMC_USER_SELECTED_VIEW_LANGUAGES=en

# The default data language
#
# Specify the language to display stored information.
# Supported value: en
#

-J BMC_USER_SELECTED_DATA_LANGUAGE=en

# Skip startup health check
#
# Specify whether to perform health checks during server startup.
# Supported values: true, false
#

-J SKIP_HEALTH_CHECK=true

# Upgrade language locale
#
# Specify whether to upgrade your language locale.
# Supported values: true, false
#

-J BMC_ADD_LOCALE_UPGRADE=false

# Java plugin port
#
# Specify the Java Plugin listener port.
#

-J BMC_JAVA_PLUGIN_PORT=9999

# Enable BMC port mapper
#
# Specify whether or not to enable to the BMC port mapper.
# Supported values: true, false
#

-J BMC_PORT_MAPPER_ENABLED=false

# Database case sensitivity
#
# If database is case-insensitive, specify: T
# If database is case-sensitive, specify: F
#

-J BMC_DATABASE_CASE_INSENSITIVE=T

# Tenant installation
#
# Do not change. By default multitenancy is enabled.
#

-J BMC_TENANT_INSTALL_MODE=MULTI

# Ignore pre-check installation warnings
#
# Most pre-check warnings which would cancel the install process can be safely
# ignored. This option should always be left set to "true" as the installer will
# catch any errors as they happen during installation.

-J BMC_IGNORE_PRECHECK_ERROR=true

-J BMC_ATRIUM_PLUGIN_PORT_NUMBER=9556

-J BMC_NE_PLUGIN_PORT_NUMBER=9555

-J BMC_DBONLY_UPGRADE_CONFIRM=false

################################################################################
# Available features
#
# Do not change. This setting is required by the AR System platform.
#
################################################################################

-A featureARSystemServers

Where to go from here

Running the installer

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Christoph Klapetke

    Hi Tony,

    why you have to define the ARTenant name in the option.txt when the installer isn´t able to create the ARTenant tablespace. In addition to that the ARTenant DB should be created before you install the Service Broker.

     

    Cheers

    Christoph

    Dec 23, 2016 05:59
  2. Tony Chung

    Hi Christoph,

    The options.txt file still includes these options even though the installer does not use them. We are working on an update to this page to better match the correct behavior of the installer. However, as the options.txt still features the options, I thought we should define them here.

    I've also updated the tenant database preparation and installing the tenant data topics.

    Thanks,

    -Tony

    Dec 24, 2016 01:27