Configuring Control Center Director
About this task
The Control Center Director configuration utility referred to here as the configuration script is a menu driven command-line utility for configuring the Control Center Director.
When you run the configuration script in prompt mode, and are prompted for values, the applicable default value is displayed in brackets at the end of the prompt. If you enter no value, the script uses the default value. The default value also provides an example of the format of the value that is required.
The default location for the configuration setup script is: \ControlCenterDirector\bin.
Procedure
- Log in to the target system on which the product installation resides
-
Open a command-line shell and go to the
\common\bincd c:\ControlCenterDirector\bin -
Invoke the following script and respond to the prompts in each section.
./config.sh -
Select the Product
entitlement
configuration based on your preference.
--------------------------------------------------------------------
Config step : Product entitlement configuration
IBM Sterling Control Center - Not configured...
1. IBM Sterling Control Center Director
2. IBM Sterling Control Center Monitor
3. All Products
Choose Product Option based on your entitlement [0] : 1
Are the values that were entered correct? (Y/N) [Y]
Product entitlement configuration has been done successfully!
-
The utility displays a list of prerequisites before proceeding with configurations.
--------------------------------------------------------------------
Config step : *** Pre-Configuration Steps ***
--------------------------------------------------------------------
Before proceding with configuration, ensure to have the following:
1. Database connection details
2. JDBC Driver file
3. Keystore and Truststore for secure connection
4. Package folder for Connect:Direct installers(downloaded from IBM site)
5. SMTP(Email) Server connection details
6. External Authentication Server details
-
The utility starts and prompts you to enter details in the KeyStore and TrustStore
Configuration section.
Note: If you change the TrustStore, you must follow complete configuration procedure again.
------------------------------------------------------------------- Config step: Keystore / truststore configuration ... Warning: Specify a valid keystore.(See the documentation to build one) Otherwise the secure connectors may not start. -------------------------------------------------------------------- Keystore and truststore configuration ... Provide the path to your java keystore file [../conf/security/CCenter.keystore] : /home/CCD/KEYSTORE Please provide password to the keystore (at least 6 chars, no blanks) : Re-enter Password Enter Alias for Key: [CDRDEV-052] : CERT_ALIAS Provide the path to your trust store file [/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.65-3.b17.el7.x86_64/jre/lib/security/cacerts] : /home/CCD/TRUSTSTORE You provided the following value(s) Keystore file path: /home/CCD/KEYSTORE Keystore password: ******** Key Alias: CERT_ALIAS Truststore file path (optional): /home/CCD/TRUSTSTORE You are using the default truststore password. Are the values that were entered correct? (Y/N) [Y]Control Center Director uses certificate-based authentication to secure connection with Connect:Direct Server. For more information on generating KeyStore see, Setting up Control Center Director Keystore.
-
In the JDBC Driver File installation section, enter the database type and JDBC driver
details required to connect to your database server.
The following section describes the configuration prompts for a SQL server database type.For connection parameters for other database types see, Configuring Control Center Director to use Oracle database schemas and Configuring Control Center Director to use DB2 database .
--------------------------------------------------------------------
Config step : JDBC driver files installation ...
For detailed IBM Control Center Director system requirements, go to the following URL:
http://www-01.ibm.com/support/docview.wss?uid=swg27036103
--------------------------------------------------------------------
Provide the following database parameters...
Provide a database type (DB2 or DB2zOS or Oracle or MSSQL)[DB2] : MSSQL
Provide the full path to sqljdbc42.jar or mssql-jdbc-<n.n.n>.jre<version> including the file name) : /home/CCD/DATABASE_DRIVER
JDBC Driver Class Name : org.apache.derby.jdbc.AutoloadedDriver Major Version : 10 Minor Version: 5
JDBC Driver Class Name : org.apache.derby.jdbc.ClientDriver Major Version : 10 Minor Version: 5
JDBC Driver Class Name : com.microsoft.sqlserver.jdbc.SQLServerDriver Major Version : 4 Minor Version: 2
You provided the following parameters:
Database type = MSSQL
You provided JDBC driver file(s)
/home/CCD/DATABASE_DRIVER
Are the values that were entered correct? (Y/N) [Y]
JDBC Driver file(s) installation... Successful
-
In the Database Connection Parameters Configuration section, enter database connection
details.
--------------------------------------------------------------------
Config step : Database connection parameters configuration ...
For detailed IBM Control Center Director system requirements, go to the following URL:
http://www-01.ibm.com/support/docview.wss?uid=swg27036103
--------------------------------------------------------------------
Provide the following database connection parameters...
Do you want to configure a secure connection to your database? (Y/N) [N] : N
Provide the database host name [127.0.0.1]: 172.20.186.38
Provide the database port number [1433]:
Provide the database user name []: ccd
Database Password (no blanks):
Re-enter Database Password:
Provide the database name []: DATABASE_NAME
Do you want your database to support globalization?
If you select yes, your database size can increase significantly(Y/N). [N] : N
You provided the following database connection parameters:
Database type = MSSQL
Secure connection to database = N
Database host name = 172.20.186.38
Database port = 1433
Database user name = ccd
Database password = ********
Database name = DATABASE_NAME
Your database will not support globalization.
Are the values that were entered correct? (Y/N) [Y]Y
No Root pass phrase found in DB and so generating a new one.
Updating application.properties with key store/trust store info...
The SMTP server configuration for IBM Control Center was not completed in this installation location, and no SMTP configuration is in the database.
DB Scripts Directory is '/home/CCD/IBM/bin/db'
Executing scripts....
….…...
DB initialization - Successful
Note: After successful database configuration, Client Authentication certificate is generated and persisted. It is also imported in Truststore and has a validity of 10 years. This will be used to generate signed certificates for New Installation on Connect:Direct server. -
Use the Administration User configuration section to create a Control Center Director
administrator user and to set up its credentials.
--------------------------------------------------------------------
Config step : Administration User configuration...
--------------------------------------------------------------------
Admin user password must be set.
Enter Admin user password (no blanks):
Re-enter Enter Admin user password :
Enter Admin user email-id address (no blanks): admin@domain.com
Re-enter Enter Admin user email-id address : admin@domain.com
You provided the following values:
Admin user password = ***********
Admin user email-id address = admin@domain.com
Admin user password and email-id address has been set.
-
In the Event Processor (Engine) Name Configuration section, enter Control Center Director Engine name.
--------------------------------------------------------------------
Config step : Event processor (engine) name configuration ...
--------------------------------------------------------------------
Provide a 10 character Event Processor (engine) name [Director] :
You provided the following Event Processor (engine) name :
Event Processor (engine) name is 'Director'
Are the values that were entered correct? (Y/N) [Y]
Event Processor (engine) name has been successfully configured ...
-
In the Engine Time Zone Configuration section, enter a time zone value for the Engine.
If the source installation and target installation were not in the same time zone, you must specify
the time zone.
--------------------------------------------------------------------
Config step : Engine time zone configuration ...
--------------------------------------------------------------------
Default Time Zone : (UTC+05:30) Calcutta, Chennai, Mumbai, New Delhi
1. (UTC+05:30) Calcutta, Chennai, Mumbai, New Delhi
Choose a time zone number [1] : 1
You chose the following time zone for the IBM Control Center event processor (engine):
1. (UTC+05:30) Calcutta, Chennai, Mumbai, New Delhi
Are the values that were entered correct? (Y/N) [Y]
Engine Time Zone has been successfully configured ...
-
In the HTTP connector configuration section, enter the appropriate details to connect
event processor and the console.
--------------------------------------------------------------------
Config step : HTTP connector configuration (connection between event processor (engine) and the console)...
--------------------------------------------------------------------
HTTP connector configuration ...
Provide a port number. (Enter 0 to disable the HTTP) [58080] :
Provide a listening address for the above port. [0.0.0.0](0.0.0.0- to listen on all addresses):
You provided the following values:
Port number = 58080
Listening address for port = 0.0.0.0
Are the values that were entered correct? (Y/N) [Y]y
Http Connector configuration complete.
-
In the Secure HTTP connector configuration section, enter the appropriate details to
establish connection between Engine and console.
--------------------------------------------------------------------
Config step : Secure HTTP connector configuration (connection between Engine and the console)...
Note: A valid keystore is needed for the secure connection.
--------------------------------------------------------------------
Do you want to configure the secure HTTP connector? (Y/N)y Are you sure about your selection? (Y/N)y
Secure HTTP connector configuration ...
Provide a port number.(Enter 0 to disable the HTTPS) [58081] :
Provide a listening address for the port. [0.0.0.0](0.0.0.0- to listen on all addresses):
You provided the following values:
Port number = 58081
Listening address for port = 0.0.0.0
Are the values that were entered correct? (Y/N) [Y]y
Secure Http Connector configuration has been done successfully!
-
In the Web Services Configuration section, enter appropriate connection details. Control
Center Director uses Web Server connection details defined here to connect to Control Center
Director's Web Services.
--------------------------------------------------------------------
Config step : Web Application server ..configuration...
(This step is required for web client.)
Note: A valid keystore is needed for the secure connection.
--------------------------------------------------------------------
Web Application server configuration ...
Provide a secure port number. (Enter 0 to disable) [58083] :
Provide the host name of the event processor (engine). [CDRDEV-052] :
Provide a listening address for the above port. [0.0.0.0](0.0.0.0- to listen on all addresses):
You provided the following values:
Web Application server secure port = 58083
Event processor (engine) host name = CDRDEV-052
Listening address for port = 0.0.0.0
Are the values that were entered correct? (Y/N) [Y]
-
In the Package path configuration section, enter the package directory properties where
the Connect:Direct packages are made available.
--------------------------------------------------------------------
Config step : Package path configuration ...
--------------------------------------------------------------------
Package Configuration ...
Provide the path to your package folder [../packages] : /home/CCD/PACKAGES
Packages location path is : /home/CCD/PACKAGES
Are the values that were entered correct? (Y/N) [Y]
Updating application.properties with package path...
-
In the E-mail server (SMTP) Configuration section, enter the e-mail server connection
and SMTP server administrator e-mail details.
--------------------------------------------------------------------
Config step : Email (SMTP) server configuration ...
--------------------------------------------------------------------
To receive an email notification that is generated by an action in IBM Control Center, you must provide the email server configuration details and the IBM Control Center administrator's email address.
Email host name? [localhost] :
Email port number? [25] :
Email user name? Enter dot (.) for none. [] : .
Enter user password (no blanks). Enter dot (.) for none.
Re-Enter user password (no blanks). Enter dot (.) for none.
Email from address? [noone@anywhere] :
Administrator email address? [noone@anywhere] :
You provided the following email configuration options:
Email host name = localhost
Email port number = 25
Email user name =
Email password = ********
Email from address = noone@anywhere
SMTP Administrator email address = noone@anywhere
Are the values that were entered correct? (Y/N) [Y]
Updating application.properties with SMTP info...
-
In the External Authentication Server (SEAS) Configuration section, enter the connection
details here.
--------------------------------------------------------------------
Config step : External Authentication Server configuration ...
--------------------------------------------------------------------
Do you want to configure External Authentication Server connection settings(Y/N)?Y
Are you sure about your selection? (Y/N)Y
Seas configuration ...
Provide Primary Address [] : 172.20.186.38
Provide Primary port [] : 61365
Provide Alternate Address(Blank is valid)[] :
Provide Alternate port(Blank is valid)[] :
Provide Profile Name?[]: ACDEMO
Use Persistent Connection?(Y/N) [Y]:
Use Secure Connection?(Y/N) [Y]: Y
Provide Seas Secure Protocol: (Press Enter for using default) [TLSv1.2]: TLSv1.2
You provided the following External Auth Server connection parameters:
Primary Address -------> 172.20.186.38
Primary Port ----------> 61365
Alternate Address ----->
Alternate Port -------->
Profile Name ----------> ACDEMO
Persistent Connection -> Y
Secure Connection -----> Y
Seas Secure Protocol --> TLSv1.2
Are the values that were entered correct? (Y/N) [Y]
The IBM Control Center Director event processor(engine) configuration is complete.
Run runEngine.sh to start IBM Control Center Director
After starting IBM Control Center Director following URLs can be used to launch Web UI and REST API
1. Web UI URL
https://CDRDEV-052:58083/cc-ui/index.html
2. REST API Documentation(Swagger)
https://CDRDEV-052:58083/swagger-ui.html#
3. OSA URL for Connect:Direct Server
https://CDRDEV-052:58083/osa/events/post
Updating permissions for encryption key files...
Updating permissions for encryption key files...Done!
-
Configuring IBM Control Center Director is complete.
The IBM Control Center Director event processor(engine) configuration is complete.
Run runEngine.sh to start IBM Control Center Director
After starting IBM Control Center Director following URLs can be used to launch Web UI and REST API:
1. Web UI URL
https://CDRDEV-052:58083/cc-ui/index.html
2. REST API Documentation(Swagger)
https://CDRDEV-052:58083/swagger-ui.html#
3. OSA URL for Connect:Direct Server
https://CDRDEV-052:58083/osa/events/post
Updating permissions for encryption key files...
Updating permissions for encryption key files...Done!