Control-M Workload Archiving Installation

The following procedures describe how to install Control-M Workload Archiving on UNIX and Windows, which enables you to archive job logs and outputs in a secure and central repository:

Control-M Workload Archiving can connect to an existing Oracle or PostgreSQL database server. Control-M Workload Archiving is installed with a dedicated PostgreSQL database server but BMC recommends that you use an existing database server.

You must install a secondary instance of Control-M/EM server that is installed in a distributed configuration, as described in Control-M/Enterprise Manager Installation. The installation process installs a dedicated GUI Server.

Multiple instances of Control-M Workload Archiving on separate Control-M/EM distributed machines enable you to archive jobs faster and provide a high availability solution to your Control-M Workload Archiving environment.

After you've completed the installation, you need to define Workload Archiving policies, as described in Defining Workload Archiving policies.

  • To avoid slow performance on Control-M/EM, set the Control-M/Server IOALOGLM system parameter to 7 or less.

  • If you are upgrading to version 9.0.21, you need to upgrade the Control-M/EM server and then upgrade the Control-M/EM Distributed, as described in Upgrading Control-M/EM on UNIX and Upgrading Control-M/EM on Windows. The Workload Archiving server is upgraded automatically during the Control-M/EM Distributed upgrade.

  • Workflow Insights and Workload Archiving cannot be installed on the same Control-M/EM instance.

Installing Control-M Workload Archiving on Windows

This procedure describes how to install Control-M Workload Archiving on Windows on a distributed Control-M/EM.

You can install multiple instances of Control-M Workload Archiving on separate Control-M/EM distributed machines, which share an external PostgresSQL or Oracle database. This enables you to archive jobs faster and provides a high availability solution to your Control-M Workload Archiving environment.

  • If you install multiple Workload Archiving instances, you must set all the Workload Archiving components desired state to UP in the Control-M Configuration Manager.

  • The date and time on additional distributed Control-M/EM machines with Workload Archiving must be synced with each other.

Before you begin

  • Verify that the Control-M/EM database server is up and running.

  • Verify that you have installed a primary Control-M/Enterprise Manager version 9.0.21 or later, as described in Control-M/Enterprise Manager Installation.

  • Verify that you have installed a distributed Control-M/EM, as described in Control-M/Enterprise Manager Installation.

  • Download the Control-M Workload Archiving activation CD (see Product Distribution in the Control-M Workload Archiving Release Notes).

Begin

  1. Log in to the Control-M/EM distributed computer.

  2. From the Control-M Workload Archiving activation CD, double-click the setup.exe file.

    The Control-M Workload Archiving Installation wizard appears.

  3. Do one of the following:

    • Interactive install: Follow the on-screen instructions until the installation is complete.

    • Automatic install: Create a parameter file and then run the automatic install in a non-interactive mode, as follows:

    1. Follow the on-screen instructions until the Summary window.

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

    3. Click Yes to quit the installation.

      A confirmation message appears.

    4. Click Yes.

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

    6. Log in using a user ID that has Administrator permissions on the current computer.

    7. Ensure that the installation DVD is still in the DVD drive, and run the installation script, as follows:

      <source_path>\Setup.exe -silent <xml_path>\<filename.xml>

      The installation log can be found at the following location:

      <installFolder>\<Control-M/EM home dir>BMCINSTALL\log\BMC_Control-M_Workload_Archiving_Install_<date-time>.log

  4. Click Done.

    If you cannot connect to Control-M Workload Archiving from the CCM, see 000087384.

Installing Control-M Workload Archiving on UNIX

This procedure describes how to install Control-M Workload Archiving on UNIX on a distributed Control-M/EM.

You can install multiple instances of Control-M Workload Archiving on separate Control-M/EM distributed machines, which share an external PostgresSQL or Oracle database. This enables you to archive jobs faster and provides a high availability solution to your Control-M Workload Archiving environment.

  • If you install multiple Workload Archiving instances, you must set all the Workload Archiving components desired state to UP in the Control-M Configuration Manager.

  • The date and time on additional distributed Control-M/EM machines with Workload Archiving must be synced with each other.

Before you begin

  • Verify that the Control-M/EM database server is up and running.

  • Verify that you have installed a primary Control-M/Enterprise Manager version 9.0.21 or later, as described in Control-M/Enterprise Manager Installation.

  • Verify that you have installed a distributed Control-M/EM, as described inControl-M/Enterprise Manager Installation.

  • Download the Control-M Workload Archiving activation CD (see Product Distribution in the Control-M Workload Archiving Release Notes).

Begin

  1. Mount the installation CD from the root user and log off the root user before continuing with the installation.

  2. Log in to the Control-M Workload Archiving account.

    If you are using the GUI, set the environment variable DISPLAY to value <hostName>:0.0. It is not necessary to set DISPLAY for console mode or silent mode. (For more information, see Setting Environment Variables in UNIX.)

  3. Type the following command:

    <cdPath>/setup.sh

  4. Do one of the following:

    • Interactive install: Follow the on-screen instructions until the installation is complete.

    • Automatic install: Do the following:

    1. Follow the on-screen instructions until the Summary window.

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

    3. Click Yes to quit the installation.

    4. A confirmation message appears.

    5. Click Yes.

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

    7. To run the installation script, type the following command:

      <source_path>/setup.sh -silent <source_path/filename.xml>

  5. Follow the on-screen instructions until the installation is complete.

    If you cannot connect to Control-M Workload Archiving from the CCM, see 000087384.

Uninstalling Control-M Workload Archiving from Windows

This procedure describes how to uninstall Control-M Workload Archiving from Windows.

  • If you are uninstalling a Control-M Workload Archiving instance with a dedicated PostgreSQL database, the database is removed with the uninstall process. Any other additional instances that share this dedicated database stop working. You must back up your dedicated database before you uninstall.

  • If you are uninstalling a Control-M Workload Archiving instance with an external database, the database is not removed with the uninstall process.

Begin

  1. From the Start menu, select Control Panel.

  2. Double-click Programs and Features.

  3. Select Control-M Workload Archiving, and click Uninstall.

  4. Click OK to continue.

    Control-M Workload Archiving is successfully removed from your computer.

Uninstalling Control-M Workload Archiving from UNIX

This procedure describes how to uninstall Control-M Workload Archiving from UNIX.

  • If you are uninstalling a Control-M Workload Archiving instance with a dedicated PostgreSQL database, the database is removed with the uninstall process. Any other additional instances that share this dedicated database stop working. You must back up your dedicated database before you uninstall.

  • If you are uninstalling a Control-M Workload Archiving instance with an external database, the database is not removed with the uninstall process.

Begin

  1. Log in as a Control-M user.

  2. Navigate to the following directory:

    <Workload_Archiving_InstallFolder>/BMCINSTALL/uninstall/DRARB

  3. Type one of the following commands:

    • Interactive uninstall: ./uninstall.sh

    • Automatic uninstall: ./uninstall.sh -silent

      Control-M Workload Archiving is successfully removed from your computer.