Sample Configuration File

B Sample Configuration File

ASAP offers a sample configuration properties file to configure WebLogic, ASAP, and Database. The sample configuration properties file can be found in $ASAP_HOME/config directory with the name sampleASAPConfiguration.properties. You must update the file with the values for database and WebLogic configurations. Oracle recommends to rename the file so that it can be re-used for upgrade.

Note:

Ensure that there are no trailing and leading whitespaces in the values set for the properties in the sampleASAPConfiguration.properties file.

The sample configuration file is as follows:

#########################################################################
##  Configure ASAP UNIX Environment Variables
##########################################################################
##  Type the name of the base directory of the Oracle database client program. The ASAP installation generates an ORACLE_HOME UNIX environment variable based on the directory name.
ORACLE_HOME=
## Provide the path to ant program
ANT_HOME=
##  Set the ASAP mode that you require. You can run ASAP in the Production (PROD) or Development (TEST) mode. ASAP loads static provisioning configuration information from the database based on mode. 
ASAP_SYS=TEST
##  Type the ASAP environment ID (maximum 4 alphanumeric characters). The ASAP environment ID is a unique identifier for each ASAP environment as one system  can have multiple ASAP instances.
ENV_ID=

###########################################################################
##  Configure ASAP Database 
##########################################################################
##  The ASAP installation program retrieves the name of the Oracle RDBMS Server from tnsname.ora file on the installed Oracle client program. 
##  Name of Oracle RDBMS Server :
DSQUERY=
##  Oracle Server DBA User Name :
DB_USER=
##  Oracle Server DBA Password :
DB_PASSWORD=
##                         ASAP Database Users Creation
##                        ------------------------------
##  CREATE_USERS=true:  The database users will be created during the ASAP configuration.
##  CREATE_USERS=false: The database users must be created by the user beforehand.
CREATE_USERS=true
##  Is this an Oracle RAC database :
RACDB=false
##  RAC Database Connection String, Format: Host1:Port1:ServiceName,Host2:Port2:ServiceName,... :
RACDB_CONNECT_STRING=

##########################################################################
##  Configure ASAP Database Table spaces 
##########################################################################
##Specify the required table space for each ASAP server. The recommended table space set up for the SARM server is SARM_DATA for the data table space and SARM_INDEX for the index table space. 
#The recommended table space for all other ASAP servers is DATA for data table space and INDX for index table space. ASAP database scripts populate the database schema based on the defined values. 
##  ADM
ADMDB_PARAMETERS=ADM, DATA, indx
##  Control
CTRLDB_PARAMETERS=CTRL, DATA, indx
##  NEP
NEPDB_PARAMETERS=NEP, DATA, indx
##  SARM
SARMDB_PARAMETERS=SARM, SARM_DATA, sarm_index
##  TEMP ( Specify the temporary table space you want ASAP to use.)
TEMP_TS=TEMP

##########################################################################
## Configure ASAP Database User Password 
##########################################################################
##For each ASAP server, type the password for each database schema. ASAP database scripts create user schemas based on the user name and password that you define. 
##  ADM
ADMDB_PASSWORD=
##  Control
CTRLDB_PASSWORD=
##  NEP
NEPDB_PASSWORD=
##  SARM
SARMDB_PASSWORD=

##########################################################################
##  Configure ASAP UNIX Environment Variables - ASAP Server Port
##########################################################################
##Define the port number for ASAP servers.
##  CTRL Server
CTRL_PORT=30001
##  SARM Server
SARM_PORT=30002
##  NEP Server
NEP_PORT=30003
##  Define the port number for work order event notification for the OCA SRP. This information will be populated in tbl_asap_srp table in the SARM database.  
## Oca Server
OCA_PORT=30004
##  Define the port number for the Java SRP server to send work orders. This information will be populated in the tbl_listens table in the Control database. Define the port number for the Java SRP server to receive work order events. This information will be populated in the tbl_asap_srp table in the SARM database.  
##  JSRP - Sending WO
JSRPsend_PORT=30005
##   JSRPS123 - Receiving WO event 
JSRPrecev_PORT=30006
##   ASAP DAEMON 
DAEMON_PORT=30007
##   JeNEP Listener Port 
NEP_Listener_PORT=30008

##########################################################################
##  Configure Oracle WebLogic Server for ASAP
##########################################################################
##  Path to the WebLogic installation directory
WL_HOME=
##  User Name of the Oracle WebLogic Server Administrator
WLS_USER=
##  HOST for the Oracle WebLogic Server
WLS_HOST=
##      Port for the Oracle WebLogic AdminServer
##  ------------------------------------------------
##  Specify NON-SSL Port if WLS_SSL_ENABLED is false
##  Specify SSL Port if WLS_SSL_ENABLED is true 
WLS_ADMIN_PORT=
##  NON SSL Port for the target server of the WebLogic
WLS_TARGET_PORT=
##  SSL Port for the target server of the WebLogic
WLS_TARGET_SSL_PORT=
##  Oracle WebLogic Server
WLS_SERVER=AdminServer
## Use SSL?
WLS_SSL_ENABLED=false
## SSL KeyStore File
KEYSTORE_FILE=

##########################################################################
## Configure Oracle WebLogic Server Passwords
##########################################################################
##  Each password must be at least 8 characters long, and must contain at least 1 number or special character.
##  ASAP_admin
ADMIN_PASSWORD=
##  cmws_studio
CMWS_PASSWORD=
##  ASAP_monitor
MONITOR_PASSWORD=
##  ASAP_operator
OPERATOR_PASSWORD=
##  WebLogic admin password
WLS_PASSWORD=
##  asap_ws_user
WS_PASSWORD=

##########################################################################
## Configure GRPC specific properties
##########################################################################
## SSL for GRPC ? 1 = Enabled, 0 = Not Enabled
GRPC_SSL_ENABLED=1
## Authentication for GRPC ? 1 = Enabled, 0 = Not Enabled
GRPC_AUTH_ENABLED=1
## Absolute path of SSL identity certificate in the pkcs12 format
SSL_IDENTITY_PKCS12_LOCATION=
## Absolute path of SSL trust certificate in the pkcs12 format
SSL_TRUST_PKCS12_LOCATION=

The various sections, their properties, and the description are explained in the following tables.

Configure ASAP UNIX Environment Variables:

Table B-1 lists the configuration parameters for ASAP Linux variables.

Table B-1 Configure ASAP UNIX Environment Variables

Name	Description	Required?
ORACLE_HOME	Enter the name of the base directory of the Oracle database client program. ASAP installation generates an UNIX environment variable(ORACLE_HOME) based on the directory name.	Yes
ANT_HOME	Specifies the location of ANT.	Yes
ASAP_SYS	Select the ASAP mode Production (PROD) Development (TEST) ASAP loads static provisioning configuration information from the database based on the mode. The default value is TEST.	Yes
ENV_ID	ASAP environment ID (maximum 4 alphanumeric characters).	Yes

Configure ASAP Database:

Table B-2 lists the parameters required for configuring ASAP database.

Table B-2 Configure ASAP Database

Name	Description	Required?
DSQUERY	Specifies the name of Oracle RDBMS Server. The ASAP installation program retrieves the name of the Oracle RDBMS Server from tnsnames.ora file on the installed Oracle client program.	Yes
DB_USER	Specifies the Oracle Server Database administrator User Name.	Yes
DB_PASSWORD	Specifies the Oracle Server Database administrator Password.	No (in Console mode)
CREATE_USERS	Specifies whether the Oracle Database user is created. When CREATE_USERS is set to true which is the default value, the database users are created during the ASAP configuration. When CREATE_USERS is set to false, you must have the database users already.	Yes
RACDB	Specifies whether this is an Oracle RAC database. Set to true for an Oracle RAC database. Set to false if it is not an Oracle RAC database. The default value is false.	Yes
RACDB_CONNECT_STRING	Specifies the value of the RAC Database Connection String. If RACDB is true, the value of the RAC Database Connection String is in the format:`Host1:Port1:ServiceName,Host2:Port2:ServiceName, and so on` .	Yes, if RACDB is true

Configure ASAP Database Table spaces:

Table B-3 lists the parameters to configure ASAP database table spaces.

Table B-3 Configure ASAP Database Table spaces

Name	Description	Required?
ADMDB_PARAMETERS	Specifies the required table space for each ASAP server. The recommended values are: `ADMDB_PARAMETERS=ADM, DATA, indx` Where `ADM` is the ASAP schema. `DATA` is the recommended data table space. `indx` is the recommended index table space. ASAP database scripts populate the database schema based on the defined values.	Yes
CTRLDB_PARAMETERS	Specifies the required table space for each ASAP server. The recommended values are: `CTRLDB_PARAMETERS=CTRL, DATA, indx` Where `CTRL` is the ASAP schema. `DATA` is the recommended data table space. `indx` is the recommended index table space. ASAP database scripts populate the database schema based on the defined values.	Yes
NEPDB_PARAMETERS	Specifies the required table space for each ASAP server. The recommended values are: `NEPDB_PARAMETERS=NEP, DATA, indx` Where `NEP` is the ASAP schema. `DATA` is the recommended data table space. `indx` is the recommended index table space. ASAP database scripts populate the database schema based on the defined values.	Yes
SARMDB_PARAMETERS	Specifies the required table space for each ASAP server. The recommended values are: `SARMDB_PARAMETERS=SARM, SARM_DATA, sarm_index` Where `SARM` is the ASAP schema. `SARM_DATA` is the recommended data table space. `sarm_index` is the recommended index table space. ASAP database scripts populate the database schema based on the defined values.	Yes
TEMP_TS	Temporary table space that ASAP must use.	Yes

Configure ASAP Database User Password:

Table B-4 lists the parameters to configure ASAP database user password.

Table B-4 Configure ASAP Database User Password

Name	Description	Required?
ADMDB_PASSWORD	Specifies password for each database schema. For each ASAP server, type the password for each database schema. ASAP database scripts create user schemas based on the user name and password that you define.	Yes (in Silent Mode)
CTRLDB_PASSWORD	Specifies password for each database schema. For each ASAP server, type the password for each database schema. ASAP database scripts create user schemas based on the user name and password that you define.	Yes (in Silent Mode)
NEPDB_PASSWORD	Specifies password for each database schema. For each ASAP server, type the password for each database schema. ASAP database scripts create user schemas based on the user name and password that you define.	Yes (in Silent Mode)
SARMDB_PASSWORD	Specifies password for each database schema. For each ASAP server, type the password for each database schema. ASAP database scripts create user schemas based on the user name and password that you define.	Yes (in Silent Mode)

Configure Oracle WebLogic Server for ASAP:

Table B-5 lists the parameters to configure Oracle WebLogic server for ASAP.

Table B-5 Configure Oracle WebLogic Server for ASAP

Name	Description	Required?
WL_HOME	Specifies the path to the WebLogic installation directory.	Yes
WLS_HOST	Specifies the host for the Oracle WebLogic Server.	Yes
WLS_USER	Specifies the username of the Oracle WebLogic Server Administrator.	Yes
WLS_ADMIN_PORT	Specify NON-SSL port if WLS_SSL_ENABLED is false. Specify SSL port if WLS_SSL_ENABLED is true.	Yes
WLS_TARGET_PORT	Specifies the non-SSL port for the target server of the WebLogic.	Yes
WLS_TARGET_SSL_PORT	Specifies the SSL port for the target server of the WebLogic.	Yes if SSL is enabled
WLS_SERVER	Specifies the Oracle WebLogic server. The default value is AdminServer.	Yes
WLS_SSL_ENABLED	Set to true if SSL is enable. The default value is false.	Yes
KEYSTORE_FILE	Specifies the path of the SSL KeyStore file.	Yes if SSL is enabled

ASAP Server Ports:

Table B-6 lists the parameters to configure ASAP server ports.

Table B-6 ASAP Server Ports

Name	Description	Required?
SARM_PORT	Specifies the port number of the SARM server. The default value is 30002.	Yes
CTRL_PORT	Specifies the port number of the control server. The default value is 30001.	Yes
NEP_PORT	Specifies the port number of the NEP server. The default value is 30003.	Yes
OCA_PORT	Specifies the port number for work order event notification for the OCA SRP. The default value is 30004.	Yes
JSRPsend_PORT	Specifies the port number for the Java SRP server to send work orders. The default value is 30005.	Yes
JSRPrecev_PORT	Specifies the port number for the Java SRP server to receive work order events. The default value is 30006.	Yes
DAEMON_PORT	Specifies the port number of the daemon server. The default value is 30007.	Yes
NEP_Listener_PORT	Specifies the port number of the NEP listener. The default value is 30008.	Yes

Configure WebLogic Passwords for Silent mode:

Table B-7 lists the parameters to configure passwords for installing ASAP in the silent mode.

Table B-7 Configure WebLogic Passwords for Silent mode

Property	Description	Required?
ADMIN_PASSWORD	Specifies the password for ASAP_admin.	No (in Console mode)
CMWS_PASSWORD	Specifies the password for CMWS Studio.	No (in Console mode)
MONITOR_PASSWORD	Specifies the password for the ASAP_Monitor.	No (in Console mode)
OPERATOR_PASSWORD	Specifies the password for the ASAP_operator.	No (in Console mode)
WLS_PASSWORD	Specifies the password for the WebLogic admin.	No (in Console mode)
WS_PASSWORD	Specifies the password for the ASAP_ws_user.	No (in Console mode)

Configure GRPC specific properties:

Table B-8 lists the parameters to configure GRPC specific properties.

Table B-8 Configure GRPC specific properties

Property	Description	Required?
GRPC_SSL_ENABLED	Specifies if SSL is enabled for GRPC. The valid values are: 1 - Enabled 0 - Disabled	No
GRPC_AUTH_ENABLED	Specifies if the authentication is enabled for GRPC. The valid values are: 1 - Enabled 0 - Disabled	No
SSL_IDENTITY_PKCS12_LOCATION	Specifies the absolute path of SSL identity certificate in the pkcs12 format.	Yes if GRPC_SSL_ENABLED is enabled
SSL_TRUST_PKCS12_LOCATION	Specifies the absolute path of SSL trust certificate in the pkcs12 format.	Yes if GRPC_SSL_ENABLED is enabled