Configuring IZSME

To configure a new TEPS for use, follow the steps below.

1. From the window that displays the No default TEPS is configured message, click on the Settings gear icon in the top right corner. The Settings screen will be displayed.
2. Click the Add new button at the top of the screen. The Add Connection window is displayed.
3. Specify values for the following fields.
   Note: Chinese characters are not supported in any of the fields in the configuration user interface. To connect IZSME to TEPS databases, Tivoli Data Warehouse, and LDAP servers, you will not be able to use Chinese characters for the following fields:

   • Database schema name
   • Administrator username and password for connecting to databases and LDAP servers
   • DNS names for TEMS and other servers configured here

   Zowe authentication

   Specify whether or not Zowe authentication should be enabled. When Zowe authentication is enabled (the default), users will be authenticated against Zowe when they choose this configuration upon launching IZSME.

   TEMS properties – Host

   Specify the host name or IP address for this Tivoli Enterprise Monitoring Server (TEMS). This setting is the host name or IP address of the machine where the hub TEMS is installed.

   TEMS properties – Port

   Specify a numeric value for the port. The standard port value is 1918.

   Hot Standby TEMS Host (optional)

   This optional field allows you to specify a secondary High Availability TEMS host in case the primary TEMS is not available. If you wish to specify a secondary TEMS, specify the host name or IP address of the machine where the secondary TEMS is installed. If you do not want to specify a secondary High Availability TEMS, leave this field blank.

   Database properties – Host

   Specify the host name for this TEPS database.

   Database properties – Port

   Specify a numeric value for the port. The standard port value is 50000.

   Database properties – Username

   Specify the user ID of the person who has access to this database.

   Database properties – Password

   Specify the password associated with the Username.

   JDBC URL

   This URL is built for you automatically based on the values you specify in the other fields on this screen. If you are using the default database name (TEPS), you do not need to change the URL. However, if you are not using the default database name, you can change the URL to suit your environment. Any changes made to the URL will be changed in the fields above vice versa.

   Also, you may need to specify the currentSchema special register. For example, if the schema for TEPS tables is ITMUSER (and that is not the database username you entered), you would edit the JDBC URL as shown in this example:

   jdbc:db2://myhost:50000/TEPS

   Change to:

   jdbc://myhost:50000/TEPS:currentSchema=ITMUSER;

   Note: The JDBC URL must end with a semi-colon (;) or an error message will display.

   TEPS properties – Host

   Specify the host name or IP address for this Tivoli Enterprise Portal Server (TEPS). This setting is the host name or IP address of the machine where the TEPS is installed.

   TEPS properties – Port

   Specify a numeric value for the port.

4. Click Test, on the right side of the Database properties section, to verify that these values are acceptable. If not, try a different value.
5. Click Save to add this TEPS to the list.

To edit a TEPS configuration:

1. Click the Settings gear icon in the top right corner.
2. On the Settings window, highlight the line you want to change.
3. Click the kabob menu (three vertical dots) in the header bar. (You may need to page right to see the rest of the screen.)
4. Click Edit.
5. The Edit Connection window displays the current settings for this highlighted line.
6. Change the values you need to adjust and click Save. If you do not want to make any changes, click Cancel.

The DB Status column shows the status of the TEPS database:

• Available – The connection is good.
• Error – No connection was made.
• Unknown – No connection has been attempted yet.

The TEMS Status column shows the status of the Tivoli Enterprise Monitoring Server. The status can be one of the following:

• Available – The connection is good.
• Error – No connection was made.
• Unknown – No connection has been attempted yet.

Java Sidecar is a Java process that must be running in order to start IZSME. Java Sidecar listens on a port. The default port is 20202; if this port is not available, Java Sidecar will attempt to use the next 19 ports in succession until it finds an available port, going as far as 20221. You can specify a different range of ports by specifying the javaListenerPort property in the pluginConfig.json configuration file:

{
  "javaListenerPort": "20202",
  "javaVMArguments": [],
  "classPath": "../lib/jar/*",
  "cache": {

[etc.]

The pluginConfig.json file is located in [zowe_instance_dir]/workspace/app-server/ZLUX/pluginStorage/com.rs.tep.queryhandler/pluginConfiguration/. If you do not currently have a pluginConfig.json file, you will need to create it, as well as the directories leading to the file. Make sure that the App Server process has read access to this file.

You will need to provide the following information on the login screen:

Logon ID

Type the logon ID, such as a user ID, that was assigned to you to access IZSME.

Password

If a password is required for this logon ID, type the password here.