Running Control-M/Server Utilities as Other Users

This procedure describes how to run Control-M/Server Utilities as other users.

Begin

User Environment Variable DefinitionLink copied to clipboard

The following environment variables must be defined:

  • CONTROLM_SERVER

  • CONTROLM_USER

  • CONTROLM_DATABASE

  • CTM_DATABASE_TYPE

  • machine

  • LIBPATH, or LD_LIBRARY_PATH, or SHLIB_PATH

  • CTM_PYTHON_HOME=<copied value from CTM/Server account environment>

  • CTM_JAVA_HOME=<copied value from CTM/Server account environment>

  • CTM_PERL_HOME=<copied value from CTM/Server account environment>

The following table lists additional environment variables that are required, according to the type of database.

Oracle

PostgreSQL

ORACLE_BASE

DB_TYPE

ORACLE_HOME

PGHOME

ORACLE_SID

PGDATA

NLS_LANG

PGPORT

 

PGHOST

 

PGDATABASE

 

PGUSER

 

PGSYSCONFDIR

 

PGSERVICE

 

LD_LIBRARY_PATH/LIBPATH/

SHLIBPATH

 

DBU_BIN

To determine the values to assign to variables, see Determining the Values to Assign to Variables.

Adding an Executable Library to the Path of the UserLink copied to clipboard

This procedure describes how to add an executable library to the user path, which is mandatory. The path must include the following:
<user name>/ctm_server/scripts

Begin

  • Do one of the following:

    • csh or tsch in Oracle: Use the following command to modify the path:
      set path=($path $<ORACLE_HOME>/bin ~<controlm_owner>/ctm_server/exe_<OS_ID>)

      set path=($path $<ORACLE_HOME>/bin~<controlm_owner>/ctm_server/exe_Solaris)

    • Other Shells: Use the following command to modify the path when using other shells, such as sh or ksh:
      PATH="$PATH: <user name>/ctm_server/exe_<OS_ID>"

      PATH="$PATH: <user name>/ctm_server/exe_HP-UX-ia64"

Assign Read/Write PermissionsLink copied to clipboard

This following table describes the read and write permissions that are assigned to the user.

Permission Type

Directory

Read and Write Permission for Specific Files

<controlm‑directory>/ctm_server/data/keys/.ctmpda

<controlm‑directory>/ctm_server/data/keys/.ctmpdo

(PGSQL Only)

Read and Write Permission for All Files

<controlm-directory>/pgsql/etc/pg_service.conf

You must provide security access to these files, as follows:

  • Give the group controlm read permission for the files.

  • All users who require access to Control-M utilities should belong to the same group as the Control-M/Server account of their primary group.

Determining the Values to Assign to VariablesLink copied to clipboard

This procedure describes how to determine the values to assign to variables in UNIX/Linux.

Begin

  1. Specify the following command for each variables from the Control-M user.
    echo $<variableName>

    echo$ORACLE

  2. Use the formats to define the shared library path variables for each database in the user environment, depending on the Server computer type, as described in Shared Library Variable Name.

  3. Do one of the following:

    • Oracle: Set the shared library environment variable value to:
      <user name>/ctm_server/oracle/lib:<user name>/ctm_server/exe_<opSysID>

      The variables in the library path are:

      • <opSysID>: The identifier for the type of operating system.

      • <user name>: The home name for the user account.

    • PostgreSQL: Set the shared library environment variable value to:
      <user name>/ctm_server/exe_<opSysID>:~<user name>/pgsql/lib

      The variables in the library path are:

      • <opSysID>: The identifier for the type of operating system.

      • <user name>: The home name for the user account.

    For the shared library path variables, see Shared Library Path Variables.

Shared Library Variable NameLink copied to clipboard

Use the formats in the following table to define the shared library path variables for each database in the user environment, depending on the Control-M/Server computer type.

Server Computer

Shared Library Environment Variable Name

AIX

LIBPATH

HP-UX

SHLIB_PATH

Solaris

LD_LIBRARY_PATH

Linux x86_64

LD_LIBRARY_PATH

Shared Library Path VariablesLink copied to clipboard

The following table describes the shared library path variables for Oracle and PostgreSQL.

Variable

Description

<Control-M/Server Path>

The default, full path name of the Windows home directory where Control-M/Server is installed.

<user name>

The default, full path name of the UNIX user account home directory where Control-M/Server is installed.

<opSysID>

The operating system ID of the Control-M/Server computer, such as AIX, HP‑UX‑11, HP-UX-ia64, Solaris, or Linux.