Post-installation Procedures on Linux

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 Linux

This procedure describes how to configure the automatic startup/shutdown script for Control-M/EM on Linux (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.

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 (Red Hat and Oracle Linux 8 or Higher)

This procedure describes how to configure the automatic startup procedure for Control-M/EM on Red Hat 8 or higher and Oracle Linux 8 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/csh -c "start_server;start_config_agent"
    Type=forking 
    RemainAfterExit=yes 
    ExecStop= 
    No High Availability: /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/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/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 host.

Automatic Startup/Shutdown Procedure for Control-M/Server on Linux

The database server and Control-M/Server must be running at all times on the initial Control-M/Server installation. BMC Software recommends that they be started at system startup time.

You can modify the startup procedure to ensure that the database server, Control-M/Server, and the Control-M/Server Configuration Agent are started during system startup. The command to copy the necessary startup instructions to your system startup directory is listed below.

All commands shown below must be executed as the root user.

Depending on your operating system, modify the automatic startup procedure as described in the following table:

Operating System

Startup Procedure

Shutdown Procedure

Linux

cp <ctmHome>/ctm_server/data/rc.<controlmUser> /etc/rc.d/<controlmUser>

ln -s /etc/rc.d<controlmUser> /etc/rc.d/rc2.d/S98<controlmUser>

cp /home/controlm/ctm_server/data/rc.controlm/etc/rc.d/controlm

ln -s/etc/rc.d/controlm/etc/rc.d/rc2.d/S98controlm

SUSE Linux Enterprise Server 15

See Configuring the Automatic Startup/Shutdown Procedure for Control-M/Server on Linux.

  

Red Hat 8 or higher

See Configuring the Automatic Startup/Shutdown Procedure for Control-M/Server on Linux.

  

Oracle Linux
8 or higher

See Configuring the Automatic Startup/Shutdown Procedure for Control-M/Server on Linux.