Configuring the CMF Integration Server to extract CMF data


(BMC.AMIOPS.SPE2110)

The following procedures explain how to configure the CMF Integration Server to extract BMC AMI Ops Monitor for CMF data. You can perform them with an API development tool (such as Postman or cURL).

Before you begin

Make sure that the CMF Integration Server is installed and set up on your system. For more information, seeConfiguring Common REST API options.

To configure the MV host server

  1. Ask your system administrator to generate a client certificate for the MV host server. 

    Important

    • The certificate should have a public and a private key (mve_client.p12 file in the example in Step 2) .
    • The certificate should be in PKCS12 format.
  2. In the installationDirectory folder, edit the gpm_custom.properties file to specify the following ssl parameters in ascii format: 

    mve.keystore.file=<location/key> (Example: mve_client.p12)
    mve.keystore.password=<certificatePassword> (This is provided when the certificate is generated)
  3. Restart the CMF Integration Server.

Changing the server port after the installation

  1. Edit property AMICMF_PORT in the UBMCSAMP(CRACMNEV) dataset.

    Example

    AMICMF_PORT=15567

  2. Restart the server job.

To connect the CMF Integration Server to the MV host server

Use one of the following methods to configure the CMF Integration Server to receive data from the MV host server: 

Important

The MV host must reside on the CASPlex that z/OSMF monitors.

Define MV host server for CMF integration using REST API


Best practice
Using the GET method, define MV host server for CMF integration using REST API.


Edit a URL based on the following structure:

http://<cmfIntegrationHostName>:<cmfIntegrationPortNumber>/gpm/service/update?host=<mvHostName>&port=<mvPortNumber>

The following table describes the variables:

Variable

Description

<cmfIntegrationHostName>

Name of the system hosting the CMF Integration Server

<cmfIntegrationPortNumber>

Port number of the CMF Integration Server that is listening for the RMF call

<mvHostName>

Name of the system hosting the MV host server

<mvPortNumber>

Port number of the MV server


Example


http://sysa:2525/gpm/service/update?host=myHost&port=80 

Define MV host server for CMF integration manual modification

To define MV host server manually, edit the gpm_configurations.json in installationDirectory file. If it doesn't already exist, create it.

To edit the gpm_configurations.json file, perform the following steps:

  1. Specify the MV host name and port for the gpmOnlyUse service.

    Example

    The following example defines the MV server myHost on port 80.

    [
    {
         "HOSTCN": "myHost",
         "HOSTIP": "",
         "PORT": 80,
         "TLS": "N",
         "WEBSERVICEName": "gpmOnlyUse",
         "STATUS": "ACTIVE",
         "DESCRIPTION": "For GPM use"
    }
    ]
  2. Restart the CMF Integration Server.

Where to go from here

Complete the procedure in Configuring-z-OSMF-to-retrieve-data-from-the-CMF-Integration-Server.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*