Configuring a user account on UNIX

This procedure describes how to configure specific parameters for Control-M. The account cannot contain any data, must be solely dedicated to Control-M, and the name must not exceed 8 characters.

The Control-M/EM, Control-M/Server, and Control-M/Agent owner can be a local user, an LDAP user, or an NIS user. The Control-M/EM, Control-M/Server, and Control-M/Agent account home directory can be located on a local disk or NFS.

NOTE: If you are using /bin/csh as the startup shell for the Control-M user, ensure that tcsh shell is also installed on this machine as it is used internally by the application.

To configure a user account on UNIX:

1. Do one of the following:
   • Create a user account, as follows:

     /usr/sbin/useradd -u <numeric_user_id> -g <user_group> -d <user_home>

   • Create a group, as follows:

     Linux/Solaris: /usr/sbin/groupadd <user_group>

     AIX: /usr/bin/mkgroup <user_group>

   NOTE: In a clustered environment, you need to create two accounts (one for each node). Both accounts must have identical names and IDs. Both home directories must point to the same location on the shared disk.

   The <user_shell> account must be defined as one of the following names or programs:

   • /bin/csh
   • /bin/tcsh
   • /bin/sh (Control-M/Agent and Control-M/EM only)
   • /bin/ksh (Control-M/Agent and Control-M/EM only)
   • /bin/bash (Control-M/Agent only)
2. Configure the predefined limits that are designed to limit or prevent the excessive use of resources by a single process, as described in Control-M limits on UNIX accounts.
3. Verify that the HOST environment variable is defined on all shells by running the env command.

   If the HOST environment variable not defined, contact your IT system administrator.

4. Verify that the HOME directory is configured with 755 permissions by running Is Id on the Agent account.

   EXAMPLE: ls -ld /home/ctmag

   drwxr-xr-x 25 ctmag users 4096 Dec 2 13:47 /home/ctmag

   If the permissions are not set to 755, you can use the chmod command to set it.

   EXAMPLE: chmod 755 /home/ctmag