Control-M for IBM InfoSphere DataStage Installation

The following procedures describe how to install and uninstall Control-M for IBM InfoSphere DataStage:

If you want to install multiple instances of Control-M for IBM InfoSphere DataStage on several computers using the same configuration, use the automatic installation, as described in these procedures.

Installing Control-M for IBM InfoSphere DataStageon Control-M/Agent on UNIX

This procedure describes how to install Control-M for IBM InfoSphere DataStage on Control-M/Agent on UNIX.

The default installation is interactive and uses a GUI display. XServer must be running and configured using the DISPLAY environment variable. If you do not have XServer available, BMC recommends that you continue with the console installation or perform an automatic installation.

Before You Begin

  • Verify that the IBM InfoSphere DataStage Client or the IBM InfoSphere DataStage engine is installed on the Control-M/Agent machine.

  • Verify that Control-M/Agent has access and permission to run the IBM InfoSphere DataStage DSJOB command line utility.

    The Control-M/Agent account must have all paths defined in order to run the DSJOB command line utility.

  • Verify that all jobs running on the Control-M/Agent have ended.

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

Begin

  1. Log in as the Control-M/Agent user.

  2. Type the following command to stop the Control-M/Agent:

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

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

    • If you use an AIX operating system, then remove unused libraries from memory, by typing the following command as a root user:

      /usr/sbin/slibclean

  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. Type the following command to activate the installation script:

    <source_path>/setup.sh

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

      5. Type the following command to activate the installation script:

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

    The installation log is saved to the following location:

    $HOME/BMCINSTALL/log/cmdatastage/BMC_Control-M_For_IBM_InfoSphere_DataStage_Install_<date-time>.log

  6. Log out of the Control-M/Agent.

  7. Set up the location of the IBM InfoSphere DataStage engine for Control-M for IBM InfoSphere DataStage.

    1. Navigate to:

      <Agent dir>/cm/DATASTAGE/exe

    2. Run the following command:

      ./ctmdatastage_container setds <ds engine path>

      ./ctmdatastage_container setds /opt/IBM/InformationServer/Server/DSEngine

  8. Log in and start the Control-M/Agent with the following command:

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

Installing Control-M for IBM InfoSphere DataStage on Control-M/Agent on Windows

This procedure describes how to install Control-M for IBM InfoSphere DataStage on Control-M/Agent on Windows.

Before You Begin

  • Verify that the IBM InfoSphere DataStage Client or the IBM InfoSphere DataStage Engine is installed on the Control-M/Agent machine.

  • Verify that Control-M/Agent has access and permission to run the IBM InfoSphere DataStage DSJOB command line utility.

    The Control-M/Agent account must have all paths defined in order to run the DSJOB command line utility.

  • Verify that all jobs running on the Control-M/Agent have ended.

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

Begin

  1. Log in as a user with Administrator privileges and stop the Control-M/Agent.

  2. Open the command prompt as Administrator and type the following command:

    <source_path>/Setup.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 computers with the same Control-M/Agent instance name. A separate <filename>.xml file must be created or modified manually for each Control-M/Agent instance name.

      4. Copy the automatic installation parameters file to a network location that is accessible to all Control-M/Agent computers where you want to perform an automatic installation.

  4. Run the installation script, as follows:

    <installation_path>\Setup.exe -silent <silent.xml>

    The installation log can be found at the following location:

    BMCINSTALL\log\cmdatastage\BMC_Control-M_For_IBM_InfoSphere_DataStage_Install_<timestamp>.log

  5. Set up the location of the IBM InfoSphere DataStage Engine for Control-M for IBM InfoSphere DataStage.

    1. Navigate to:

      <Agent dir>/cm/DATASTAGE/exe

    2. Run the following command:

      ctmdatastage_container setds <dsjob path>

      ctmdatastage_container setds c:\IBM\InformationServer\Clients\Classic

      Provide only the path to the dsjob.exe file (without the file name).

  6. Restart the Control-M/Agent.

    Control-M for IBM InfoSphere DataStage restarts automatically.

Installing Control-M for IBM InfoSphere DataStage on the Control-M Client on Windows

This procedure describes how to install Control-M for IBM InfoSphere DataStage on Control-M/Agent on Windows.

Before You Begin

  • Verify that all jobs running on the Control-M/Agent have ended.

  • Shut down Control-M/Agent.

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

Begin

  1. Log in as a user with Administrator privileges and stop the Control-M/Agent.

  2. Open the command prompt as Administrator and type the following command:

    <source_path>/Setup.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 computers with the same Control-M/Agent instance name. A separate <filename>.xml file must be created or modified manually for each Control-M/Agent instance name.

      4. Copy the automatic installation parameters file to a network location that is accessible to all Control-M/Agent computers where you want to perform an automatic installation.

  4. Run the installation script, as follows:

    <installation_path>\Setup.exe -silent <silent.xml>

    The installation log can be found at the following location:

    $HOME\BMCINSTALL\log\cminfosphere\BMC_Control-M_For_IBM_INFOSPHERE_Install_<timestamp>.log

  5. Restart the Control-M/Agent.

    Control-M for IBM InfoSphere DataStage restarts automatically.

Uninstalling Control-M for IBM InfoSphere DataStage from UNIX

This procedure describes how to uninstall Control-M for IBM InfoSphere DataStage from UNIX.

Before You Begin

  • Stop all jobs running on Control-M/Agent.

  • Verify that all jobs have ended.

Begin

  1. From a Control-M/Agent computer, log in as a Control-M/Agent user, and type the following command to shut down Control-M/Agent:

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

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

    • If you use an AIX operating system, then remove unused libraries from memory, by typing the following command as a root user:

      /usr/sbin/slibclean

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

  3. Navigate to the following directory:

    $HOME/BMCINSTALL/uninstall/LPX90.8.0.00

  4. Type one of the following commands:

    • Interactive Uninstall: $HOME/BMCINSTALL/uninstall/LPX90.8.0.00/uninstall.sh

    • Automatic Uninstall: ./uninstall.sh -silent$HOME/BMCINSTALL/uninstall/LPX90.8.0.00/uninstall.sh -silent

  5. To restart Control-M/Agent, type the following command:

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

Uninstalling Control-M for IBM InfoSphere DataStage from Windows

This procedure describes how to uninstall Control-M for IBM InfoSphere DataStage from Windows.

Before You Begin

  • Stop all jobs running on Control-M/Agent.

  • Verify that all jobs have ended.

Begin

  1. From the Start menu, select Control Panel.

  2. Double-click Add/Remove Programs.

  3. Select Control-M for IBM InfoSphere DataStage.

  4. Click OK to continue.

Performing an Automatic Uninstall from Windows

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

Before You Begin

  • Stop all jobs running on Control-M/Agent.

  • Verify that all jobs have ended.

Begin

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

  2. Navigate to the following directory:

    $HOME\BMCINSTALL\uninstall\LPX90.8.0.00

  3. Open a command prompt window as an Administrator and type the following command:

    uninstall.exe-silent