Control-D/Agent Installation

The Agent installation installs Control-D/Agent, which enables you to transfer files and reports from Control-D for Distributed System computers to the Control-D Mainframe or to other distributed system computers. Control-D Agent monitors pre-defined directories to detect new files in the local file system. The Agent uses pattern matching to identify files that are available to transfer.

Control-D/Agent requires an external Java library. To ensure that Java libraries remain updated, Java library deliveries are decoupled from Control-D/Agent and not part of the installation. For more information, see Control-D External Java Installation.

Before you install the Agent, verify that your operating system and database software is compatible with the current version, as described in Control-D/Agent Compatibility for Version 9.0.21.100

The following procedures describe how install and uninstall Control-D/Agent on UNIX and Windows.

Installing Control-D/Agent on UNIX

This procedure describes how to install Control-D/Agent on UNIX.

Before You Begin

Ensure that you have met the following requirements:

Begin

  1. Login as the Control-D/Agent user.

  2. Copy the installation files from the temporary directory that you created in Obtaining Control-D installation files, to the home directory.

  3. Set your DISPLAY environment variable, as described in Setting Environment Variables in UNIX.

  4. From your home directory, type the following command:

    <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: Create a parameter file and then run the automatic install in a non-interactive mode:

      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 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 do an automatic installation.

      6. Type the following command to install Control-D/Agent:

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

        Type the following command when you want to encrypt a password in the installation:

        <source_path>/setup.sh -encrypt <password>

      7. The installation log is saved to the following location:

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

      Control-D/Agent is successfully installed on your computer.

Installing Control-D/Agent on Windows

This procedure describes how to install Control-D/Agent on Windows.

Before You Begin

  • Ensure that your operating system is compatible with the current version of Control-D/Agent.

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

Begin

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

  2. Copy the installation files from the temporary directory that you created in Obtaining Control-D Installation Files, to the home directory.

  3. From a command prompt window, type the following command:

    <source_path>\setup.exe.

  4. Do one of the following:

    • Interactive install: Continue with 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:

      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 to quit the installation.

        A confirmation message appears.

      4. Click Yes.

        The automatic installation XML parameters file that is created, such as <filename>.xml is relevant only for computers with the same agent instance name. Otherwise, you must create a separate <filename>.xml file for each computer, or modified manually for each computer.

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

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

      7. Type the following command:

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

        Type the following command when you want to encrypt a password in the installation:

        <source_path>\setup.exe -encrypt <password>

      8. The installation log is saved to at the following location:

        <installFolder>\BMCINSTALL\log\BMC_Control-D_AGENT_Install<date-time>.log

      Control-D/Agent is successfully installed on your computer.

Uninstalling Control-D/Agent on UNIX

This procedure describes how to completely remove all Control-D/Agent components from UNIX.

Begin

  • Type the following command to uninstall Control-D/Agent:

    <agentInstallFolder>/BMCINSTALL/uninstall/<LPnumber>/uninstall.sh [-silent]

    The uninstallation log is saved to in the Control-D/Agent home folder.

    <agentInstallFolder>/BMCINSTALL/log/BMC_Control-D_Agent_UnInstall_<date.time>.log

    Control-D/Agent is successfully removed from your computer.

Uninstalling Control-D/Agent on Windows

This procedure describes how to uninstall Control-D/Agent from Windows.

Before You Begin

Ensure that all jobs have ended.

Begin

  • Do one of the following:

    • Interactive uninstall:

      1. From the Start menu, select Settings.

      2. Select Apps, and then select Apps & Features.

      3. Select Control-D/Agent 9.0.21.000, and click Uninstall.

      4. Click OK to continue.

        Control-D/Agent is successfully removed from your computer.

    • Automatic uninstall: Type the following command:

      <agentInstallFolder>\BMCINSTALL\uninstall\<LPnumber>\uninstall.exe -silent

      Control-D/Agent is successfully removed from your computer.