Control-M Post-installation Procedures on UNIX

The following procedures describe the required and optional steps after you install Control-M:

If you installed Control-M/Server on NFS, you can only use the Control-M/Server user on the same host where Control-M/Server was installed.

Configuring the Automatic Startup/Shutdown Script for Control-M/EM on UNIX

This procedure describes how to configure the automatic startup/shutdown script for Control-M/EM on UNIX (optional).

If not all Control-M/EM server components are installed on one account, you need to include the startup and shutdown commands in operating system startup and shutdown scripts of the host computer.

Begin

  1. Log in as root.

  2. Navigate to /etc/.

  3. In the inittab file, add the following commands to the start-up script of your operating system as needed:

    • <identifier>:<runlevel>:<action>:<command> - <em_account> "-c start_server"

    • <identifier>:<runlevel>:<action>:<command> - <em_account> "-c start_config_agent"

    • em:2:once:su - <em_account> "-c start_server"

    • em2:2:once:su - <em_account> "-c start_config_agent"

  4. In the rc.shutdown file, add the following commands to the shut-down script of your operating system, as needed:

    • su - <em_account> -c "em ctl -mcs -C Config_Agent -M [Hostname] -cmd shutdown"

    • sleep 10

    • su - <em_account> -c "stop_server -U <<db_server_administrator_name>-P <db_server_administrator_name>"

  5. Restart the Control-M/EM host.

Configuring the Automatic Startup/Shutdown Procedure for Control-M/EM (RedHat and Oracle Linux 7 or Later)

This procedure describes how to configure the automatic startup procedure for Control-M/EM on RedHat 7 or higher and Oracle Linux 7 or higher.

If there is a High Availability installation, you must start the non-active environment, after the active environment starts.

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.

    EM.service

  4. Open the file and type the following:

    Copy
    [Unit]
    Description=Control-M/EM
    After=systemd-user-sessions.service multi-user.target network.target 
    [Service] 
    User=<unit_service> 
    ExecStart=/bin/sudo -u <user_account> /bin/csh -c "start_server;start_config_agent"
    Type=forking 
    RemainAfterExit=yes 
    ExecStop= 
    No High Availability: /bin/sudo -u <user_account> /bin/csh -c "[EM_home_dir]/bin/em ctl -mcs -C Config_Agent -M [hostname] -cmd shutdown"
    No High Availability with a dedicated PostgreSQL: /bin/sudo -u <user_account> /bin/csh -c "[EM_home_dir]/bin/em ctl -mcs -C Config_Agent -M [hostname] -cmd shutdown; [EM_home_dir]/bin/stop_server"
    High Availability: : /bin/sudo -u <user_account> /bin/csh -c "[EM_home_dir]/bin/em ctl -mcs -C Config_Agent -M [stand-by environment host name] -cmd shutdown; sleep 30; [EM_home_dir]/bin/em ctl -mcs -C Config_Agent -M [active environment host name] -cmd shutdown" 
    [Install]
    WantedBy=multi-user.target

    The option [Service] User=<unit_service> is optional.

  5. Save the file.

  6. Run the following commands:

    • systemctl daemon-reload

    • systemctl enable [unit service file].service

  7. Restart the Control-M/EM computer.

Configuring the Automatic Startup/Shutdown Procedure for Control-M/Server on UNIX

This procedure describes how to configure the automatic startup procedure for Control-M/Server on RedHat 7, Oracle Linux 7, and SUSE Linux Enterprise Server 12.

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.

    EXAMPLE: CtmServer.service

  4. Open the file and type the following:

    Copy
    [Unit]
    Description=Control-M Server
    After=systemd-user-sessions.service multi-user.target network.target
    [Service]
    ExecStart=/bin/sh -c [server_home_dir]/ctm_server/data/rc.<account name>
    Type=forking
    RemainAfterExit=yes
    ExecStop=/usr/bin/su - <account name> -c '[server_home_dir]/ctm_server/scripts/shut_ca ; [server_home_dir]/ctm_server/scripts/shut_ctm -CA; sleep 10 ; [server_home_dir]/ctm_server/scripts/shutdb; [server_home_dir]/ctm_server/scripts/shut_kafka'
    [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 Control-M/Server computer.