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. The following procedures describe how to upgrade the PostgreSQL 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 hosts 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.

  • To avoid slow performance on Control-M for z/OS, verify that IOA LOG INDEX (LOGI) on Control-M for z/OS is enabled and updated regularly.

  • If you are upgrading to version 9.0.21.300, 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, which requires a separate Control-M/EM Distributed instance for each Workload Archiving instance. Each Workload Archiving server uses the same external PostgreSQL database server. This enables you to archive jobs faster and provides a high availability active-active 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 hosts with Workload Archiving must be synced with each other.

Before You Begin

Begin

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

  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 hosts where you want to perform an automatic installation.

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

      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, which requires a separate Control-M/EM Distributed instance for each Workload Archiving instance. Each Workload Archiving server uses the same external PostgreSQL or Oracle database server. This enables you to archive jobs faster and provides a high availability active-active 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 hosts 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 hosts 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.

Upgrading the PostgreSQL Database Server on Windows

This procedure describes how to upgrade the Workload Archiving PostgreSQL Database Server on Windows.

Before You Begin

Begin

  1. On the new instance of Control-M/EM Distributed, do the following:

    1. Create the following system environment variable:

      • Variable Name: WA_SECOND_FULL_INSTALL

      • Variable Value: Y

    2. From the command line, run the following command to verify that the environment variable was set correctly:

      echo %WA_SECOND_FULL_INSTALL%

      Verify that Y appears.

  2. On the new Control-M/EM Distributed host, install a new instance of Control-M Workload Archiving from windows_x86_64/Setup.exe in the CD image, as described in Steps 3–5 of Installing Control-M Workload Archiving on Windows.

  3. From the CCM, stop the original Workload Archiving Server by changing the desired state to DOWN.

  4. Migrate Workload Archiving to the new Control-M/EM Distributed, as described in Migrating Control-M Workload Archiving.

    You can start the new Workload Archiving Server while the migration is running.

  5. Run a few archive searches to verify that jobs were moved to the new Workload Archiving Server and that new jobs are collected.

  6. Uninstall the old Workload Archiving Server, as described in Uninstalling Control-M Workload Archiving from Windows.

  7. Log in to Workload Archiving and run a few archive searches to verify that new jobs were moved and collected on the new Workload Archiving Server.

Upgrading the PostgreSQL Database Server on UNIX

This procedure describes how to upgrade the Workload Archiving PostgreSQL Database Server on UNIX.

Before You Begin

Begin

  1. On the new instance of Control-M/EM Distributed, do the following:

    1. Run the following command to set an environment variable:

      setenv WA_SECOND_FULL_INSTALL Y

    2. Run the following command to verify that the environment variable was set correctly:

      echo $WA_SECOND_FULL_INSTALL

      Verify that Y appears.

  2. On the new Control-M/EM Distributed host, install a new instance of Control-M Workload Archiving from <cdPath>/Linux-x86_64/setup.sh in the CD image, as described in Steps 3–5 of Installing Control-M Workload Archiving on UNIX.

  3. From the CCM, stop the original Workload Archiving Server by changing the desired state to DOWN.

  4. Migrate Workload Archiving to the new Control-M/EM Distributed, as described in Migrating Control-M Workload Archiving.

    You can start the new Workload Archiving Server while the migration is running.

  5. Run a few archive searches to verify that jobs were moved to the new Workload Archiving Server and that new jobs are collected.

  6. Uninstall the old Workload Archiving Server, as described in Uninstalling Control-M Workload Archiving from UNIX.

  7. Log in to Workload Archiving and run a few archive searches to verify that jobs were moved and collected on the new Workload Archiving Server.

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

Uninstalling Control-M Workload Archiving from UNIX

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

  • If you uninstall 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 uninstall 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 host.