Control-M for Backup Installation

The following procedures describe how to install Control-M for Backup on a UNIX or Windows Agent.

If you must install multiple instances of Control-M for Backup on several hosts with the same configuration, use the automatic installation, as described in these procedures.

Installing Control-M for Backup on a UNIX Agent

This procedure describes how to install Control-M for Backup on a UNIX Agent.

Before You Begin

• Verify that all jobs that are executing on the Agent have ended.

• Verify that you meet the Java requirements, as described in Control-M External Java Installation.

Begin

1. Log in as the Agent user.

2. Run the following command to stop the Agent:

   $CONTROLM/scripts/shut-ag -u <agentUser> -p all

   If the Agent was installed with a root user, then you must log in as a root user every time you start up or shut down the Agent in this procedure.

3. Use one of the following modes:

   • Display: If you install using GUI (or XServer), set your DISPLAY environment variable, as described in Setting Environment Variables in UNIX.

   • Console: It is not necessary to set DISPLAY.

4. Run the following command:

   • Linux: <install_source_path>/BKP.9.0.21.300_Linux-x86_64.BIN

   • AIX: <install_source_path>/BKP.9.0.21.300_AIX.BIN

5. Do one of the following:

   • Interactive Install: Continue with the on-screen instructions until the installation is complete.

   • Automatic Install: Do the following:

     1. Continue with the on-screen instructions until the Summary window.

     2. Click Generate and select the location to create the XML parameter file.

     3. Click Yes.

     4. Copy the automatic installation parameters file to a network location that is accessible to all hosts where you want to perform an automatic installation.

     5. Run the following command:

        • Linux: <install_source_path>/<BKP.9.0.21.300_Linux-x86_64.BIN> -silent <filename.xml>

        • AIX: <install_source_path>/<BKP.9.0.21.300_AIX.BIN> -silent <filename.xml>

   The installation log is saved to the following location:

   $HOME/<username>/BMCINSTALL/log/cmbackup/BMC_Plugin_For_backUp_Install_<date-time>.log

6. Log out of the Agent.

7. Log in and start the Agent with the following command:

   $CONTROLM/scripts/start-ag -u <agentUser> -p all

Installing Control-M for Backup on a Windows Agent

This procedure describes how to install Control-M for Backup on a Windows Agent.

Before You Begin

• Verify that all jobs that are executing on the Agent have ended.

• Verify that you meet the Java requirements, as described in Control-M External Java Installation.

Begin

1. Log in as a user with Administrator privileges and stop the Agent.

2. Do one of the following:

   • From the installation path, double-click the BKP.9.0.21.300_windows_x86_64.exe file.

   • Open the command prompt as Administrator and type the following command:

     <install_source_path>\BKP.9.0.21.300_windows_x86_64.exe .

3. Do one of the following:

   • Interactive Install: Continue with the on-screen instructions until the installation is complete.

   • Automatic Install: Do the following:

     1. Continue with the on-screen instructions until the Summary window.

     2. Click Generate and select the location to create the XML parameter file.

     3. Click Yes.

        The automatic installation XML parameters file created (<filename>.xml) is relevant only for hosts with the same Agent instance name. A separate <filename>.xml file must be created or modified manually for each Agent instance name.

     4. Copy the automatic installation parameters file to a network location that is accessible to all Agent hosts where you want to perform an automatic installation.

     5. Run the installation script, as follows:

        <install_source_path>\BKP.9.0.21.300_windows_x86_64.exe -silent <silent.xml>

   The installation log is available at the following location:

   <Control-M Agent instance directory>\BMCINSTALL\log\cmbackup\BMC_Plugin_For_BackUp_Install_<date-time>.log

   If the installation fails, the log file is saved to the following location:

   %temp%\BMC_Plugin_For_BackUp_Install_<date-time>.log

4. Restart the Agent.

Uninstalling Control-M for Backup from UNIX

This procedure describes how to uninstall Control-M for Backup from UNIX.

Before You Begin

• Stop all jobs running on Agent.

• Verify that all jobs have stopped executing.

Begin

1. From a Agent host, log in as an Agent user, and type the following command to shut down Agent:

   $CONTROLM/scripts/shut-ag -u <agentUser> -p all

   If the Agent was installed with user root, then log in as user root every time you start up or shut down the Agent throughout this procedure.

2. Set your DISPLAY environment variable according to the host name, as described in Setting Environment Variables in UNIX.

3. Navigate to the following directory:

   $HOME/BMCINSTALL/uninstall/DRBKP.<version>/

4. Type one of the following commands:

   • Interactive: ./uninstall.sh

   • Automatic: ./uninstall.sh -silent

5. To restart the Agent, type the following command:

   $CONTROLM/scripts/start-ag -u <agentUser> -p all

Uninstalling Control-M for Backup from Windows

This procedure describes how to uninstall Control-M for Backup from Windows.

Before You Begin

• Stop all jobs running on Agent.

• Verify that all jobs have stopped executing.

Begin

1. From the Start menu, select Control Panel.

2. Double-click Uninstall a program.

3. Select Control-M for Backup.

4. Click OK to continue.

Performing an Automatic Uninstall from Windows

This procedure describes how to perform an automatic uninstall of Control-M for Backup from Windows.

Before You Begin

• Stop all jobs running on the Agent.

• Verify that all jobs have ended.

Begin

1. Log in to the host using a user ID that has Administrator authorizations.

2. From a command line, run the following command using the full path:

   <Agent Install Path>\BMCINSTALL\uninstall\DRBKP.<version>\uninstall.exe -silent

Changing the JRE Package in Control-M for Backup

This procedure describes how to change the JRE package in Control-M for Backup. 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_9.0.21.300.dat file in the <HOME>/BMCINSTALL/ directory.

    2. Define an alternative Java home directory by modifying the value of the parameter CM_BACKUP_JAVA_HOME to the external Java path.

       CM_BACKUP_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 Control-M for Backup using the following command.

       $CONTROLM/cm/BACKUPCM/exe/cm_container.sh stop

       Control-M for Backup restarts automatically.

  • Windows: Do the following:

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

    2. Define an alternative Java home directory by modifying the value of the parameter CM_BACKUP_JAVA_HOME to the external Java path.

       CM_BACKUP_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, space, period, underscore, hyphen and plus characters.

    3. Stop Control-M for Backup using the following command.

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

       Control-M for Backup restarts automatically.