Configuring properties files

You can modify the properties values manually.

About this task

During installation, you can configure the DASH_ITMCollector, DASH_SA, and DASH_IOALA properties files for Performance Management Dashboards for IBM® Z Automation Web Console using IBM Installation Manager.

After installation, you can configure Tivoli® Directory Integrator using the Tivoli Directory Integrator configuration editor. The configuration editor is GUI-based and allows you to edit assembly lines and customize how data is presented in Dashboard Application Services Hub (DASH) V3.1.2.1.

This topic guides you to configure the properties files after installation.

Tip: It's highly recommended that you change the properties using the web configuration tool instead of editing directly in the properties file.

Procedure

Go to the solution directory. The default directory is /opt/IBM/TDI/V7.1.1/DASH_ITMCollector.
Edit the following fields in the DASH_ITMCollector properties file.
itm.numservers

Multiple TEPS can be configured, this property is the maximum TEPS number you prefer, no more than 6.

itm.provider

Refers to the provider ID of the ITM CURI Data Provider that is enabled on the Tivoli Enterprise Portal Server and is accessed via itm.url.
Specify in the following format:
```
/providers/itm.<TEMS-Name>
```
Where TEMS_NAME is the HUB Tivoli Enterprise Monitoring Server (TEMS) label, not the host name.
You can determine the provider ID by using the Search button when you edit the ITMSD data provider connection in DASH. For more information, see Defining a CURI Data Provider connection.

itm.url

URL that is used to access the ITM CURI Data Provider on the Tivoli Enterprise Portal Server.
Specify in the following format:
```
http://<TEPS-Hostname>:<ITMcDP-Portnumber>/ibm/tivoli/rest
```
The default port number is 15200.
itm.user

The Tivoli Enterprise Portal Server user ID.

{protect}-itm.password

The IBM Tivoli Monitoring user password.

The Tivoli Enterprise Portal Server user password, which will be encrypted by TDI server and used for data requests sending to TEPS server.

itm.cfgpassword

The Tivoli Enterprise Portal Server user password, which will be encrypted by IBM Z Automation Web Console server and used for searching providers on configuration page.

itm.components

The components that used this TEPS as the default server. The values could be any of "cics, db2, ims, jvm, lpar, mq, network, storage, was".

itm.name

The name of this server. The value will be displayed on the select TEPS dropdown box if multiple servers are configured.

itm.host

The hostname or IP address of the TEPS.

itm.port

The port number of the TEPS.

itm.label

The HUB Tivoli Enterprise Monitoring Server (TEMS) label: <TEMS-Name>.

itm.path

The portal address of the TEPS without hostname and port number.

itm.description

Descriptive information of the provider.
If you use the default solution directory, /opt/IBM/TDI/V7.1.1/DASH_ITMCollector (SOLDIR), enter the following commands to encrypt the password that is specified in the DASH_ITMCollector properties file.
```
/opt/IBM/TDI/V7.1.1/serverapi/cryptoutils.sh -input /opt/IBM/TDI/V7.1.1/DASH_ITMCollector/DASH_ITMCollector.properties
-output /opt/IBM/TDI/V7.1.1/DASH_ITMCollector/DASH_ITMCollector.properties -mode encrypt_props 
-keystore /opt/IBM/TDI/V7.1.1/testserver.jks -storepass server -alias server
```
If you don't use the default solution directory, you see the following command where you replace SOLDIR with your chosen solution directory:
```
-input SOLDIR/DASH_ITMCollector.properties -output SOLDIR/DASH_ITMCollector.properties
```
For example,
```
TDI_INSTDIR/serverapi/cryptoutils.sh
-input TDI_SOLDIR/DASH_ITMCollector/DASH_ITMCollector.properties
-output TDI_SOLDIR/DASH_ITMCollector/DASH_ITMCollector.properties -mode encrypt_props
-keystore TDI_INSTDIR/testserver.jks -storepass server -alias server
```
The Tivoli Directory Integrator solutions directory TDI_SOLDIR defaults to /opt/IBM/TDI/V7.1.1/DASH_ITMCollector and the Tivoli Directory Integrator installation directory TDI_INSTDIR defaults to /opt/IBM/TDI/V7.1.1.
You must replace TDI_SOLDIR with your chosen Tivoli Directory Integrator solution directory, and replace TDI_INSTDIR with your chosen Tivoli Directory Integrator installation directory.
Edit the following fields in the DASH_SA properties file.

sa.user

The IBM Z Automation Web Console functional user ID that is used by TDI to access to System Automation domains. The default value is eezdmn.

sa.password

The password for the IBM Z Automation Web Console functional user ID.
Edit the following fields in the DASH_IOALA properties file if you are using IBM Operations Analytics - Log Analysis.

Server

The host name or IP address of your IBM Operations Analytics for z Systems®.

Port

The IBM Operations Analytics for z Systems server port.
If you changed any of the TDI properties, either recycle the TDI server or complete the following steps to refresh the configuration:
1. In DASH, navigate to Console Settings > Connections.
2. Select the TDI connection and click Edit existing provider.
3. Click OK without doing any changes.