Setting up an environment for the tasks run by HCL UnO agent

Overview

You can set the environment variables in the unorc file instead of adding it individually for each task. You can use the same environment to run multiple tasks as the same user. When you run a task for the first time with the agent, it creates an empty unorc file, that you can configure to add the environment variables. This file is specific to each user who configures and starts the agent, and is then created as follows:

c:\Users\user_name\unorc.cmd

/home/user_name/.unorc

If you want to run a task with another username, ensure that you manually create and make available a unorc file in that users home directory as specified above. You can also create a common unorc file to run tasks as multiple users. Create a copy from the unorc file and configure the file as per your requirements. You must save this file in the following path:

C:\\ProgramData\HCL\UnO

/tmp/HCL/UnO

Then specify the location of the file as a value for the -ctp parameter while configuring the HCL UnO agent or after agent configuration, edit the agent.properties file to update the uno.agent.common.temp.dir parameter.

Note: The commonTempPath is a directory accessible to all users. For example, if you are not the user who installs the agent and you try to run a task using scripts on the agent, a copy of the script file is saved to this path.

If you have multiple unorc files, the one specific to the user and the other created manually for multiple users, the variables and values in both files are taken into consideration when the task is run. If the same variable is set in both the unorc files, the priority is always given to the value in the specific user file when the task is run.

In Windows operating system, unorc.cmd file is created with the following details:

@ECHO OFF

REM
REM  *****************************************************************
REM  HCL Confidential - OCO Source Materials
REM
REM  Licensed Materials - Property of HCL
REM
REM  Copyright HCL Technologies Ltd. 2024. All Rights Reserved.
REM  *****************************************************************
REM

REM This is a batch file used to load the environment variables before the task is run. 
REM You can set a variable as shown below
REM set variableName=value

You can add an environment variable as follows:

set variableName=value

In Unix operating system, .unorc file is created with the following details:

#!/bin/sh

#
#  *****************************************************************
#  HCL Confidential - OCO Source Materials
#
#  Licensed Materials - Property of HCL
#
#  Copyright HCL Technologies Ltd. 2024. All Rights Reserved.
#  *****************************************************************
#

# This is a batch file used to load the environment variables before the task is run.
# You can set a variable as shown below
# variableName=value

You can add an environment variable as follows:

variableName=value