Installing the Configuration Tool on z/OSMF

Edit online

To install the Z Common Data Provider Configuration Tool, you must log in to the IBM z/OS Management Facility (z/OSMF), and import the cdpConfig.properties file.

Before you begin

Before you install the Configuration Tool, the following tasks must be complete:
  1. Z Common Data Provider is installed, and all SMP/E tasks are complete.
  2. z/OSMF is installed, configured, and running.
    Tip: z/OSMF is running if the started tasks CFZCIM, IZUANG1, and IZUSVR1 are active.
  3. The working directory for the Configuration Tool must be set up. For more information, see Setting up a working directory for the Configuration Tool.

About this task

To install the Configuration Tool, you must be logged in to z/OSMF with a TSO user ID that is in z/OSMF administrator group 1, which is the UNIX group to which z/OSMF administrators are added. By default, z/OSMF administrator group 1 is IZUADMIN.

Procedure

To install the Configuration Tool, complete the following steps:

  1. Open z/OSMF in a web browser, and log in with your TSO ID.
    Tips:
    • The web address, such as https://host/zosmf/, is dependent on the configuration of your z/OSMF installation.
    • If you cannot log in to z/OSMF, verify that the z/OSMF WebSphere® Liberty Profile server is started. The default procedure is IZUSVR1.
  2. In the left navigation pane, expand z/OSMF Administration, and click Import Manager.
  3. Type the path and name of the cdpConfig.properties file and click Import. The cdpConfig.properties file is in the working directory that is created after running the savingpolicy.sh script. By default, the path is /u/userid/cdpConfig/HBOCDEUI/v5r1m0/LIB.
    The import can take several seconds. When it is complete, the following message is shown:
    Plug-in "Common Data Provider" with tasks 
"Common Data Provider" was added to z/OSMF.
To control access, define SAF resource profiles in the
"ZMFAPLA" class for the following SAF resources:
"IZUDFLT.ZOSMF.IBM_CDP.CONFIG.CDPConfiguration".
    Tip: If you click this resulting message, you are directed to documentation that your systems programmer might need to grant permissions for accessing the plug-in, as indicated in the next step.
  4. Have your systems programmer run a SAF command to grant permissions for the z/OSMF administrator group 1 (default is IZUADMIN group) to access the plug-in. For example, if you are using RACF®, run the following command: 
    
RDEFINE ZMFAPLA IZUDFLT.ZOSMF.IBM_CDP.CONFIG.CDPConfiguration UACC(NONE) 
PERMIT IZUDFLT.ZOSMF.IBM_CDP.CONFIG.CDPConfiguration CLASS(ZMFAPLA) ID(IZUADMIN) ACCESS(CONTROL) 
PERMIT IZUDFLT.ZOSMF.IBM_CDP.CONFIG.CDPConfiguration CLASS(ZMFAPLA) ID(IZUUSER) ACCESS(READ)
SETROPTS RACLIST(ZMFAPLA) REFRESH