Starting agents
To start an agent, run the shell script or batch file.
Before you begin
Procedure
- Go to the agent_installation\bin directory.
- Run the appropriate script:
- To start a compact agent from console, run this
command:
./agent.exe run
- To start a compact agent in background, run this
command:
./agent.exe start
The optional pidfile argument is used for agents on UNIX™, typically when it runs from an init script.
- On Windows™, run this
command:
agent.cmd start
- On Linux™ or UNIX™, run this command:
./agent start
- On z/OS®, to run the agent as a started task, customize the sample
hlq.SBUZSAMP(BUZAGNT)
started task member, and then copy the task member to theSYS1.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:
Associate the agent user ID to the started task by setting up the STARTED class profile. Enter these commands.//* //* HCL Launch Agent - Start //* //BUZAGNT PROC AGENT='/opt/ucd/agent/bin' //* //BUZAGNT EXEC PGM=BPXBATCH,REGION=0M,TIME=NOLIMIT, // PARM='PGM &AGENT./agent run' //STDOUT DD SYSOUT=* //STDERR DD SYSOUT=* //* // PEND //*
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).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
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 the UCD z/OS agent.C BUZAGNT
- On IBM® i, you must start the agent through the IBM® Portable Application Solutions Environment for i (PASE for i) shell.
- To start a compact agent from console, run this
command:
- After the agent starts, go to the HCL Launch web application, and under Resources, open the Agents page.
- Associate the agent user ID to the started task by setting up the STARTED class profile. To set up the STARTED class, enter these commands:
Results
When the installation is complete, the agent is listed with a status of
Online
.