Control-M Workload Archiving Installation

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

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 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. These instances use the same database server and share the same Workload Archiving database schema.

After you complete the installation, you must 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.100, you must 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 Control-M/EM Distributed.

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 component desired states to UP in the Control-M Configuration Manager.

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

Before You Begin

Begin

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

  2. Double-click on the Control-M Workload Archiving activation CD image to mount it on the newly installed Control-M/EM Distributed.

    A new drive appears under This PC in the Windows File Explorer.

  3. From the new drive, double-click the Setup.exe file.

    The Control-M Workload Archiving Installation wizard appears.

  4. 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 appears.

      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. Run the following installation script:

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

        The installation log can be found at the following location:

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

  5. 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 Control-M/EM Distributed.

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 component desired states to UP in the Control-M Configuration Manager.

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

Before You Begin

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 appears.

      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_Installation_Folder>/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.