On z/OS: Configuring the Problem Insights server and the common services

Edit online

You can configure the Problem Insights server to interact with the Elastic Stack, Splunk, or the Z Data Analytics Platform for message-based analysis and with event management systems for forwarding events.

About this task

The following topics contain important reference information:

Depending on how you want to use the Problem Insights server, the configuration files that are described in Configuration file reference for the Problem Insights server must be copied from the samples directory to the config directory. You must then update the files according to the comments in the files, and restart the Problem Insights server.

In addition to the configuration files for the Problem Insights server, there is one configuration file for the common gateway and authentication services: zoa-svc.config.

Important:

During runtime creation, the configuration files cli.config and zoa-svc.config are automatically copied from the samples directory to the config directory and are customized by the setup command izoa-setup.run.
All parameters in the configuration files must have a specified value unless otherwise stated in a comment in the file. For some parameters, default values are specified, but you must verify that these values are appropriate for your environment, and change them if they are not.
The configuration files are encoded in ISO8859-1 and are tagged in the ZFS accordingly. To view the tagging of the files, run the following command from the runtime (IZOA_HOME/config) directory:
```
ls -T *.config
```
To update these files, you must use a file editor that is capable of reading and writing ISO8859-1 data. If you plan to use the vi editor, or a similar command line editor on z/OS UNIX System Services, set the value of the _BPXK_AUTOCVT environment variable to ON to enable automatic code set conversion between EBCDIC and ISO8859-1.
```
export _BPXK_AUTOCVT=ON
```

Procedure

In the config directory, open the cli.config file, review the values of all configuration properties, and update the values as appropriate.
Important: During runtime creation, izoa-setup.run automatically sets the port value for the Problem Insights server based on the input you provided. This port value will be written to the following properties:
- port in the cli.config file
- PIPORT in the zoa-svc.config file
If you change the value of port in the cli.config file after runtime creation, you must also change PIPORT in the zoa-svc.config file to the same value. Otherwise, the Problem Insights server cannot operate correctly.
Save and close the cli.config file.
To apply the configuration settings to the Problem Insights server, again run the izoa-setup.run script, as described in Installing the Problem Insights server as a stand-alone application.
Configure the Problem Insights server runtime environment, as described in the following steps:
1. From the main menu of the setup utility, select option 3, which is Configure runtime environment and machine learning system.
2. In the secondary menu, specify that you want to configure a runtime environment for the Problem Insights server (suboption 2).
3. Provide your target directory for the runtime environment.
4. Respond to any prompts in the window.
Exit the setup utility.
In the config directory, open the zoa-svc.config file, review the values of all configuration properties, and update the values as appropriate.
Important:
- The following properties are not used when the Problem Insights server is configured for IBM Z® Operational Log and Data Analytics use cases only.
  - APPLICATION_SERVERHOST
  - APPLICATION_SERVERUSER
  - APPLICATION_SERVERPASSWORD
- Do not update the following properties unless you use TLS certificates and keystores other than the ones generated for you by the izoa-setup.run script:
  - ZAIOPS_ZUUL_PASS
  - GATEWAY_SSL_PASSWORD
  - SSL_PWD
Save and close the zoa-svc.config file.