Configuring IBM Sterling Control Center Monitor Docker Containers

The following section describes configuration information available in the configCC.properties file. These parameters are required to deploy Control Center in a Docker containerized environment.

Note: All fields in configCC.properties file must be specified in same order as defined in the example above.
Parameter Description
productEntitlement Possible Control Center deployment options are “CCD, CCM”, “CCD” or “CCM”, and you can provide any of following options:
CCM – Control Center Monitor
CCD – Control Center Director

engineName

This variable value will be used as Engine name.

dbType

Type of database such as, MSSQL, ORACLE, or DB2

dbHost

IP address of server where the database is installed

dbPort

Database port number of Control Center Database

dbUser

Database user name.

dbPass

Database password.

dbName

Database schema name.

dbLoc

Applicable only for DB2 z/OS. DB2 Location name.

dbInit

Database should be initialized with this configuration. Default value is false.
dbDrivers Path of Database driver jar files. It can be retrieved from user_inputs folder. The main file path is /app/CC/user_inputs/ to which the jar file name must be appended.

Example: If your database jar file is mssql-jdbc-7.4.1.jre8.jar then you will give value to dbDrivers as /app/CC/user_inputs/mssql-jdbc-7.4.1.jre8.jar

If there are multiple database drivers as in case of DB2, then those files should be specified with comma (,) separated with full path. Example: /app/CC/user_inputs/db2jcc4.jar,/app/CC/user_inputs/db2jcc_license_cu.jar

mssqlGlobal

Specify true when data with Unicode characters needs to be stored.

httpPort

Http port number of Control Center, default number is 58080. This is the port CC’s Java Swing UI will use to connect to Control Center EP/engine.

webHttpPort

Port number of Control Center Web Console.

Default: 58082

webHost

Control Center hostname. This value is available and taken from system’s hostname.

autoStopJavaWebAppServer

Specify true if Web App Server should be stopped when Event Processor is stopped. Otherwise, specify false.

eventRepositoryAuth

Specify to true to enable authentication for Event repository, otherwise specify false.

emailHostname

E-mail Host name

emailPort

E-mail Port number

emailUser

E-mail usernmame

emailPassword

E-mail password

emailRespond

E-mail id to respond

ccAdminEmailAddress

Control Center Administrator's e-mail address

userKey

User Key used for installation. This is optional.

oracleRacOrScan

Oracle related configuration.

jmsEnable

If JMS is enabled. (Optional)

jmsType

JMS type (Optional)

jmsHost

JMS host (Optional)

jmsPort

JMS port (Optional)

jmsQueueManager

JMS Queue Manager name (Optional)

jmsChannel

JMS channel name that IBM Control Center communicates with to receive messages. (Optional)

jmsSubject

JMS Subject (Optional)

jmsTopic

JMS Topic (Optional)

jmsUserid

JMS User Id (Optional)

jmsPassword

JMS password (Optional)

jmsEmbedBroker

JMS embed broker (Optional)

jmsDataDirectory

JMS data directory (Optional)

jmsTimeToLive

JMS time to live (Optional)

jmsRetries

JMS retries (Optional)

jmsRetryWait

JMS Retry wait (Optional)

jmsBrokerName

JMS Broker Name (Optional)

dbSSL

If database connection requires a SSL connection.

keyStore

Key Store certificate file path. Main path is fixed as /app/CC/user_inputs/ to which certificate file name should be appended.

JRE certificate file's path in configuration parameters KeyStore is taken from /app/CC/user_inputs/ directory.

Example: If your keyStore file is CCenter.keystore, it should be placed inside user_inputs directory. Path to be specified for the keyStore parameter will be /app/CC/user_inputs/CCenter.keystore

keyStorePass

Password of the keystore that contains the key certificate.

trustStore

Path of the trust store certificate file that will contain trusted certificates. Main path is fixed as /app/CC/user_inputs/ to which certificate file name should be appended.

JRE certificate file's path in configuration parameters trustStore is taken from /app/CC/user_inputs/ directory.

Example: If your trustStore file is CCenter.trustStore, it should be placed inside user_inputs directory. Path to be specified for the trustStore parameter will be /app/CC/user_inputs/CCenter.keystore

trustStorePass

Password of to access the truststore trusted certificates store file.
jreTrustStorePass password of JRE truststore

httpsPort

HTTP port number for a secured connection. For example, 58081

webHttpsPort

Web UI port number for a secured connection For example, 58083

adminUserPw

password of Control Center default user 'admin'

adminUserId

ID of Control Center default user 'admin'
adminEmailAddress Email address of Control Center designated Admin User.
keyAlias Key alias that will be used for keystore, default value is test_ccenter
packagePath Path of the directory where Connect:Direct installer files are located, default value is ../packages. Applicable for Control Center Director.
seasPrimaryAddress Hostname or IP Address of SEAS server
seasPrimaryPort Port number of SEAS server, default is 61365
seasAlternativeAddress Address of alternative SEAS server
seasAlternativePort Port of alternative SEAS server
seasSecureConnection Specify Y or N based on whether connection with SEAS server will be secure or not.
seasProfileName Profile name of SEAS server
seasPersistentConnection Specify Y on N based on whether connection with SEAS server will be persistent or not.
seasSecureProtocol SEAS secure protocol name

Sample File

#Product Option
productEntitilement=CCD,CCM

#Control center database information
dbType=MSSQL
dbHost=111.22.333.444
dbPort=1433
dbUser=sa
dbName=DOCKER-62
dbLoc=none
dbInit=true
dbPartition=false
dbDrivers=/app/CC/user_inputs/mssql-jdbc-7.4.1.jre8.jar
mssqlGlobal=false


#Port numbers of Control centers
httpPort=58080
webHttpPort=58082
httpsPort=58081
webHttpsPort=58083

webHost=
autoStopJavaWebAppServer=true
eventRepositoryAuth=false

#Email related details
emailHostname=localhost
emailPort=25
emailUser=
emailRespond=noone@anywhere
ccAdminEmailAddress=admin@test.com

oracleRacOrScan=

#JMS related details
jmsEnable=
jmsType=
jmsHost=
jmsPort=
jmsQueueManager=
jmsChannel=
jmsSubject=
jmsTopic=
jmsEmbedBroker=
jmsDataDirectory=
jmsTimeToLive=
jmsRetries=
jmsRetryWait=
jmsBrokerName=

#Secure parameters
dbSSL=

#JRE certificate details  
keyStore=/app/CC/user_inputs/CCenter.keystore
trustStore=/app/CC/user_inputs/CCenter.truststore

#Secret parameters
engineName=CCenter
dbPass=password
adminUserId=admin
adminUserPw=test$6CC
keyStorePass=changeit
emailPassword=
jmsUserid=
jmsPassword=
userKey=user$6KEY
trustStorePass=changeit

adminEmailAddress=admin@test.com
jreTrustStorePass=


keyAlias=test_ccenter
packagePath=../packages
seasPrimaryAddress=111.22.333.444
seasPrimaryPort=61365
seasAlternativeAddress=
seasAlternativePort=
seasSecureConnection=N
seasProfileName=test
seasPersistentConnection=N
seasSecureProtocol=
Note: Package path must be ../packages as the path is shared to outside host.