Home
Orchestrating
Orchestrate anything with HCL Universal Orchestrator.
Managing HCL UnO agent in Unix operating systems
You can manage the agent by using scripts that are generated while configuring the agent or by Daemon process. It is recommended to use any method for ideal cohesion and efficient administration.
Managing HCL UnO agent using scripts in Unix operating systems
When you configure the agent for the first time, the process creates multiple scripts that can be used to manage HCL UnO agent afterward. You can run each scripts to accomplish specific results.

Orchestrating
Orchestrate anything with HCL Universal Orchestrator.
- Orchestration CLI commands
  You can use the various command options in Orchestration CLI to achieve specific results. The command options are not case sensitive and you can use either uppercase or lowercase letters.
- Job stream definition
  This topic introduces the job stream definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Job definition
  This topic introduces the job definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Calendar definition
  This topic introduces the calendar definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Folder definition
  This topic introduces the folder definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Credentials definition
  This topic introduces credentials definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Variable table definition
  This topic introduces the variable table definition, that can be managed from the Orchestration CLI and from the Dynamic Workload Console.
- Workstation definition
  This topic introduces the workstation definition, that can be done from the Orchestration CLI and from the Dynamic Workload Console.
- Managing an event source definition from the Orchestration CLI
  In this topic you can find the syntax to manage an event source definition.
- Event plug-in structure
- Static pools
  A static pool in HCL Universal Orchestrator groups multiple workstations together and manages the workload by assigning jobs to available workstations within the pool. This helps to optimize resource utilization.
- Managing matching criteria
  In this topic you can find a description of matching criteria.
- Managing HCL UnO agent in Unix operating systems
  You can manage the agent by using scripts that are generated while configuring the agent or by Daemon process. It is recommended to use any method for ideal cohesion and efficient administration.
  - Managing HCL UnO agent using Daemon process in Unix operating systems
    When you configure the agent for the first time, the process creates Daemon script that can be used to manage HCL UnO agent afterward. You can run each scripts to accomplish specific results.
  - Managing HCL UnO agent using scripts in Unix operating systems
    When you configure the agent for the first time, the process creates multiple scripts that can be used to manage HCL UnO agent afterward. You can run each scripts to accomplish specific results.
  - Decoding exit codes for script management
    The exit code is displayed after each command runs, to indicate the status of the command output.
- Managing HCL UnO agent in Windows operating systems
  You can manage the agent by using scripts that are generated while configuring the agent or by Daemon process. It is recommended to use any method for ideal cohesion and efficient administration.
- Managing time zones
  In this topic you can find information about managing time zones.
- Policy-driven plan
  The new HCL Universal Orchestrator policy-driven adaptive plan makes your workload more autonomous, dynamic and scalable.
- Parsing OCLI files in streaming
  HCL Universal Orchestrator enables you to add or replace files containing multiple item types through OCLI in a single command.
- Data exchange and transformation
  This topic explains how you can streamline your workflows using data exchange and transformation.

Managing HCL UnO agent using scripts in Unix operating systems

When you configure the agent for the first time, the process creates multiple scripts that can be used to manage HCL UnO agent afterward. You can run each scripts to accomplish specific results.

Before you begin

You must have configured the agent to create the scripts. For more information, see Configuring HCL UnO agent.
Navigate to the bin folder under the --dataDir, where all the scripts to manage the agent are available.

About this task

When you configure the agent for the first time, the following scripts are created:

start.sh: To start the agent and the running instance creates the agent.pid file that contains the process ID of the running agent. If no configuration file is found, running the script displays an error.
stop.sh: Stops the running instance of the agent, if any. If the agent is not running or unavailable, running the script results in an error. The agent stops after all the jobs are completed. You can also use the -f option with the script to forcefully stop the agent, although it is not recommended.
upgrade.sh: Update the agent to the specified version. The agent is updated to a new version with zero downtime. You must know the path to the new agent jar file.
data-gather: The scripts gathers all the associated data with the agent in a zip file.

You can run these scripts using the command prompt to ensure automation of tasks and consistency in operations.

Procedure

Open the command line.
Type the name of any script, and then press Enter.
Example:
```
start.sh
```
Important: Specify the path to the new agent jar file also if you want to use the upgrade script to update the agent to a new version.
For example,
```
upgrade.sh [path to the new agent jar file]
```

Results

You have successfully run the required command.