Starting agents

To start an agent, run the shell script or batch file.

Before you begin

Make sure that the server is running. Also, if the agent runs through an agent relay, make sure that the relay is started.

Procedure

  1. Go to the agent_installation\bin directory.
  2. Run the appropriate script:
    Option Description
    On Windows
    agent.cmd start
    On Linux or UNIX
    ./agent start
    On z/OS® customize the sample hlq.SBUZSAMP(BUZAGNT) started task member, and then copy the task member to the SYS1.PROCLIB library. Provide the installation directory of the agent. The default installation directory of the agent is /opt/ucd/agent/bin. The following lines show sample code:
    //* 
    //* JES JOB MONITOR 
    //*
    //BUZAGNT  PROC AGENT='/opt/ucd/agent/bin'SETROPTS GENERIC(STARTED)
    //*
    //BUZAGNT  EXEC PGM=BPXBATCH,REGION=0M,TIME=NOLIMIT,
    //            PARM='PGM &AGENT./agent run'
    //STDOUT   DD SYSOUT=*
    //STDERR   DD SYSOUT=*
    //*
    //        PEND
    //*

    Associate the agent user ID to the started task by setting up the STARTED class profile. Enter these commands.

    SETROPTS GENERIC(STARTED)
    
    RDEFINE STARTED BUZAGENT.*
      STDATA(USER(BUZUSR1) GROUP(BUZGRP1) TRUSTED(NO)
      DATA('URBANCODE DEPLOY AGENT')
    
    SETROPTS CLASSACT(STARTED) RACLIST(STARTED)
     or, if the STARTED class is already in use:
    SETROPTS RACLIST(STARTED) REFRESH

    You can also use the started procedures table (ICHRIN03) to associate the names of started procedures with specific RACF user IDs and group names. See z/OS Security Server RACF System Programmer's Guide for information on how to code the started procedures replaceable module, and for a complete description of the started procedures table (ICHRIN03).

    To start the agent task, use the START command.

    S BUZAGNT

    To stop the agent task, use the CANCEL command. The STOP command is not supported by thewUCD z/OS agent.

    C BUZAGNT
    On IBM® i Start the agent through the IBM Portable Application Solutions Environment for i (PASE for i) shell.
  3. After the agent starts, go to the IBM UrbanCode™ Deploy web application, and under Resources, open the Agents page.

Results

When the installation is complete, the agent is listed with a status of Online.


Feedback