Deploying and configuring the Discovery Agent

To enable the Discovery Agent to collect data and send it to the Discovery Server, you must deploy the Discovery Agent on the z/OS system. This deployment and configuration process is a one-time procedure for each agent installation.

Before you begin

You must have the required permissions to deploy the Discovery Agent.

Procedure

  1. Upload the discovery-agent-<version>-mainframe.tar file from the Discovery Server installation directory to the USS environment.
  2. Run the pax -r -ppx -f discovery-agent-<version>-mainframe.tar command to extract the .tar package.
    The Discovery Agent directory is created, and contains the following files and directories:
    config
internal_config
lib
log
script
ZJOB
  3. To set the running authority, navigate to the discovery-agent-<version> folder and run the find discovery-agent-<version> -name "*.sh" | xargs chmod 755 command.
  4. Perform the following steps:
    1. To update the tagging of the *.YML and *.XML files to "ASCII", run the following commands: 
      cd <zDsicovery Agent Root> 
chtag -t -c ISO8859-1 config/*
chtag -t -c ISO8859-1 internal_config/*
    2. To verify if the config files are tagged, run the ls -Tla config/ command.
      Example:
      drwxrwxr-x   2 YCHAN    TDGRP       8192 Oct  5 10:42 ./
drwxrwxrwx   8 YCHAN    TDGRP       8192 Oct  9 14:50 ../
t ISO8859-1   T=on  -rw-r--r--   1 YCHAN    TDGRP        376 Oct  5 10:42 CONFIG.YML
t ISO8859-1   T=on  -rw-r--r--   1 YCHAN    TDGRP        376 Oct  5 10:42 FIlE_DYNAMIC_JCL.YML
t ISO8859-1   T=on  -rw-r--r--   1 YCHAN    TDGRP        364 Oct  5 10:42 FILE_IDML.YML
t ISO8859-1   T=on  -rw-r--r--   1 YCHAN    TDGRP        380 Oct  5 10:42 FILE_ROUTECARD.YML
t ISO8859-1   T=on  -rw-r--r--   1 YCHAN    TDGRP        374 Oct  5 10:42 FILE_STATIC_JCL.YML
    3. Repeat the verification process for the internal_config files by running the ls -Tla internal_config/ command.
  5. Back up the <agent installation root>/config directory by running the following commands: 
    cd <zDiscovery Agent Root>
cp -R config config_original

    Creating a backup of the directories ensures data protection by generating copies that can be restored in the event of accidental deletion, corruption, or hardware failure. The config_original directory contains the default configuration template provided with the discovery agent and can serve as a valuable reference for future use when needed.

  6. To perform any actions on the Discovery Agent, perform the following steps:
    1. Create a dataset member.
    2. Run the cd <zDiscovery Agent Root> command to go the folder where the Discovery Agent is installed.
    3. Run the cd ZJOB command to access the ZJOB folder.
      The ZJOB folder contains the following files: 
      README.txt
ZAGDEL
ZAGENT
ZAGETCT
ZAGETJOB
    4. Run the cp <File name> "//'<dataset name>'" to copy the ZAGDEL, ZAGENT, ZAGETCT, and ZAGETJOB files to the dataset individually.
      For example, to copy the ZAGENT file, the command used is: cp ZAGENT "//'user_name.ZRDDS.AGENT.V140.JCL'".
    5. Modify the SCPATH, JAVAHOME, COMMPARM, and OTHPARM parameters in the copied files individually.
      deploy_settings_output