Agent Post-installation Procedures

The following procedures describe the required and optional steps after you install the Agent:

• Enabling Agent for Non-Root Mode
• Changing the JRE Package
• Changing the JRE Package in Application Integrator
• Configuring the Automatic Startup/Shutdown Procedure for Agent on Linux
• Configuring the Automatic Startup/Shutdown Procedure for Agent on Solaris
• Configuring the Automatic Startup Procedure for Agent on AIX
• Configuring Western European Language Support on Linux

To avoid performance issues, BMC recommends that you work with your IT or security personnel to exclude the following from anti-virus scanning:

• (UNIX/Linux) All of the files and subdirectories in the $CONTROLM directory, and the bmcjava and bmcperl directories in the $HOME account.

• (Windows) All of the files and subdirectories in the Agent and Control-M Common directories.

• All Agent processes, such as p_ctmam, and binary programs.

• All communication ports used by Agent processes and binary programs.

Enabling Agent for Non-Root Mode

This procedure describes how to enable Agent for non-root mode for jobs that are owned by a user that is different from the one running Agent.

Begin

1. Log in as user root and run the set_agent_mode script using the enable non root mode option on each installed Agent. The script need only be run once for each Agent.

2. From the Control-M Configuration Manager, define a job owner password for each job owner that is used by the Agent.

3. For an upgrade installation, you must replace the automatic startup script on each Agent computer to reflect its root or non-root status.

   You can toggle between root mode and non-root mode on any Agent by shutting down the Agent from the user that is currently running the Agent, and re-starting Agent with the user necessary for the new mode.

Changing the JRE Package in Application Integrator

This procedure describes how to change the JRE package in Application Integrator. The use of JRE is supported only where the major release version is the same as the tested version. For more information about Java, see Control-M External Java Installation.

Begin

• Do one of the following:

  • UNIX: Do the following:

    1. Edit the external_java_path.dat file in the <HOME>/BMCINSTALL/ directory.

    2. Define an alternative Java home directory by modifying the value of the parameter CM_AI_JAVA_HOME to the external Java path, as follows:

       CM_AI_JAVA_HOME={new JRE Path}

       • A relative path is not supported.

       • The path can only include alphanumeric, period, underscore, hyphen and plus characters.

    3. Stop the Application Integrator using the following command.

       $CONTROLM/cm/AI/exe/cm_container stop

       Application Integrator starts automatically.

  • Windows: Do the following:

    1. Edit the external_java_path.dat file in the <AGENT_HOME>\BMCINSTALL\ directory.

    2. Define an alternative Java home directory by modifying the value of the parameter CM_AI__JAVA_HOME to the external Java path, as follows:

       CM_AI_JAVA_HOME={new JRE Path}

       • The path must be enclosed with quotation marks.

       • A network path is not supported.

       • A relative path is not supported.

       • The path can only include alphanumeric characters, spaces, ., _, -, and +.

    3. Stop the Application Integrator using the following command.

       <AGENT_HOME>\cm\AI\exe\cm_container stop

       Application Integrator restarts automatically.

Configuring the Automatic Startup/Shutdown Procedure for Agent on Linux

This procedure describes how to configure the automatic startup procedure for Agent on Linux.

Begin

1. Log in as root.

2. Navigate to the following to location:
   
   /etc/systemd/system/

3. Create a new unit service file with 644 permissions.

   The extension must be .service such as ctmag.service.

4. Open the file and type the following:

   Copy

   [Unit]
   Description=Control-M Agent
   [Service]
   Type=forking
   RemainAfterExit=yes
   ExecStart=[agent_home_dir]/ctm/scripts/rc.agent_user start
   ExecStop=[agent_home_dir]/ctm/scripts/rc.agent_user stop 
   [Install]
   WantedBy=multi-user.target

5. Save the file.

6. From a command line, run the following commands:

   • systemctl daemon-reload

   • systemctl enable [unit service file].service

7. Restart the Agent computer.

Configuring the Automatic Startup/Shutdown Procedure for Agent on Solaris

This procedure describes how to configure the automatic startup procedure for Agent on Solaris.

Begin

1. Log in as root.

2. Copy the rc.agent_user script to the init.d and run the following:

   cp <agentHome>/ctm/scripts/rc.agent_user /etc/init.d/rc.<agentUser>ln -s ../init.d/rc.<agentUser>/etc/rc2.d/S13<agentUser>

   cp home/ctm/scripts/rc.agent_user /etc/init.d/rc.agent1

   ln -s ../init.d/rc.agent1 /etc/rc2.d/S13agent1

3. Create a relative path to the rc2.d directory pointing to the script in the init.d directory.

4. Run the startup procedure command as the root user.

Configuring the Automatic Startup Procedure for Agent on AIX

This procedure describes how to configure the automatic startup procedure for Agent on AIX.

Begin

1. Log in as root privileged user.

2. Run the following command:
   
   cp <Agent_Home>/ctm/scripts/rc.agent_user /etc/<Agent_User>

3. Verify execution permissions (-rwxr-xr-x):
   ls -la /etc/<Agent_User>

   If the permissions are not set, execute as follows:

   chmod 755 /etc/<Agent_User>

4. Open the /etc/inittab file in an editor, and append the following line:

   <Agent_User>:2:once:/etc/<Agent_User>

   • For user agent1, run the following command:

     cp /home/agent1/ctm/scripts/rc.agent_user /etc/agent1

   • In the file /etc/inittab append the following line:

     agent1:2:once:/etc/agent1

Configuring Western European Language Support on Linux

This procedure describes how to configure Western European language support on Linux. Update the locale to the same value on every computer or Linux account.

Begin

1. From a command prompt, type the locale -a command.

2. Set the values as described in Linux Environment Variables for West European Languages in the .cshrc or profile file.

   LC_ALL=

   LC_CTYPE=de_DE.ISO8859-1

   LANG=de_DE.ISO8859-1

   LC_COLLATE=C

   LC_MESSAGES=C

3. Run the source ~/.cshrc command.

Linux Environment Variables for West European Languages

The following table lists the environment variables and values to use for setting Western European language support on Linux machines, as described in Configuring Western European Language Support on Linux.

Environment Variable	Description
LC_ALL	"" (an empty string) Set this variable by adding the setenv LC_ALL "" to the .cshrc or .profile file
LC_CTYPE and LANG	The value of the required language locale for Linux. setenv LC_CTYPE localeName setenv LANG localeName
LC_COLLATE	C for all languages (or c, as defined on the computer). To determine whether the C locale is present, use the locale -a command. If the C (or c) locale is not present, you can use POSIX or one of the English locales that appear in the previous table. Set this variable by adding the setenv LC_COLLATE C to the .cshrc or .profile file:
LC_MESSAGES	C (or c, as defined on the computer) for all languages on accounts where the Agent is installed. To determine whether the C locale is present, use the locale -a command. If the C (or c) locale is not present, use POSIX or one of the English locales that appear in the previous table. Set this variable by adding the setenv LC_MESSAGES C to the .cshrc or .profile file.

ISO Latin-1 Character Set Locale Settings for Linux

The following table lists the character set locale settings for each of the Linux machines for each of the ISO-Latin-1 supported languages.

Language	Red Hat Linux	SuSE Linux
English (USA)	en_US.iso88591	en_US
English (UK)	en_GB.iso88591	en_GB
German	german	german
French	french	french
Spanish	spanish	spanish