Control-M MFT Enterprise Installation

The following procedures describe how to install Control-M MFT Enterprise on a Control-M/EM server on UNIX and Windows:

After you install Control-M MFT Enterprise, you must install the Control-M MFT Enterprise Gateway on the Linux computer demilitarized zone (DMZ), or perimeter network, as described in Installing the Control-M MFT Enterprise Gateway on Linux or Installing the Control-M MFT Enterprise Gateway on Windows. The Gateway and Control-M MFT must be the same version.

Control-M MFT Enterprise System Requirements

This table lists the minimum system requirements for the Control-M MFT Enterprise Hub and Gateway.

Operating System

Specifications

Requirements

Windows

  • Up to 10,000 daily external file transfers.

  • Up to 20 GB of total volume per day.

  • Up to 50 concurrent sessions.

The Hub machine must meet the following minimum requirements:

  • CPUs: 4

  • RAM: 16 GB

  • Disk Space: 100 GB

  • Up to 150,000 daily external file transfers

  • Up to 250 GB of total volume per day

  • Up to 200 concurrent sessions

The Hub machine must meet the following minimum requirements:

  • CPUs: 8

  • RAM: 32 GB

  • Disk Space: 100 GB

  • Up to 1,000,000 daily external file transfers.

  • Up to 1 TB of total volume per day.

  • Up to 500 concurrent sessions.

You must set a High Availability environment with at least 3 Hubs and 3 Gateways to handle such loads. For higher loads, add additional Hubs and Gateways.

Each Hub machine must meet the following minimum requirements:

  • CPUs: 8

  • RAM: 32 GB

  • Disk Space: 100 GB

Linux

  • Up to 10,000 daily external file transfers.

  • Up to 20 GB of total volume per day.

  • Up to 50 concurrent sessions.

The Hub machine must meet the following requirements:

  • CPUs: 4

  • RAM: 16 GB

  • Disk Space: 100 GB

The Gateway machine must have the following requirements:

  • CPUs: 4

  • RAM: 16 GB

  • Disk Space: 50 GB

  • Up to 150,000 daily external file transfers.

  • Up to 250 GB of total volume per day.

  • Up to 200 concurrent sessions.

The Hub machine must meet the following requirements:

  • CPUs: 8

  • RAM: 32 GB

  • Disk Space: 100 GB

The Gateway machine must meet the following minimum requirements:

  • CPUs: 8

  • RAM: 16 GB

  • Disk Space: 50 GB

  • Up to 1,000,000 daily external file transfers.

  • Up to 1 TB of total volume per day.

  • Up to 500 concurrent sessions.

  • You must set a High Availability environment with at least 3 Hubs and 3 Gateways to handle such loads. For higher loads, add additional Hubs and Gateways.

    		•

    Each Hub machine must meet the following minimum requirements:

    • CPUs: 8

    • RAM: 32 GB

    • Disk Space: 100 GB

    Each Gateway machine must meet the following minimum requirements:

    • CPUs: 8

    • RAM: 16 GB

    • Disk Space: 50 GB

    Installing Control-M MFT Enterprise on Windows

    This procedure describes how to install Control-M MFT Enterprise on a Control-M/EM server on Windows.

    Before You Begin

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

    • Download the MFT Enterprise installation files from EPD, as described in Obtaining Control-M Installation Files.

    Begin

    1. From the downloaded Control-M MFT Enterprise CD image, double-click the setup.exe file.

      The Control-M Managed File Transfer B2B wizard appears.

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

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

          The installation log can be found at the following location:

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

    3. Click Done.

    Installing Control-M MFT Enterprise on UNIX

    This procedure describes how to install Control-M MFT Enterprise on a Control-M/EM server on UNIX.

    Before You Begin

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

    • Download the MFT Enterprise installation files from EPD, as described in Obtaining Control-M Installation Files.

    Begin

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

    2. Log in to the Control-M/EM 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. Run the following command:

      <cdPath>/setup.sh

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

    Installing the Control-M MFT Enterprise Gateway on Linux

    This procedure describes how to install Control-M MFT Enterprise Gateway on Linux in the demilitarized zone (DMZ), also known as a perimeter network. The Gateway is a proxy server used to transfer files to and from the Control-M MFT Enterprise Hub by external users.

    Before You Begin

    Begin

    1. Copy the installation files to the host where you want to install the Gateway.

      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.

    2. From the MFT Gateway account home directory, run the following command:

      setup.sh

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

      The MFT Enterprise Gateway automatically restarts after the installation is complete.

      To manually start the Gateway, run the following command:

      mft-proxy/exe/start-mft-proxy.sh

      To manually stop the Gateway, run the following command:

      mft-proxy/exe/shut-mft-proxy.sh

    Installing the Control-M MFT Enterprise Gateway on Windows

    This procedure describes how to install Control-M MFT Enterprise Gateway on Windows in the demilitarized zone (DMZ), also known as a perimeter network. The Gateway is a proxy server used to transfer files to and from the Control-M MFT Enterprise Hub by external users.

    Before You Begin

    Begin

    1. Copy the installation files to the host where you want to install the Gateway.

    2. From the MFT Gateway account home directory, run the following command:

      setup.exe

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

      The MFT Enterprise Gateway automatically restarts after the installation is complete.

      • To manually start the Gateway, start the Control-M MFTE Gateway service.

      • To manually stop the Gateway, stop the Control-M MFTE Gateway service.

    Configuring the Control-M MFT Forward Proxy

    This procedure describes how to configure the Control-M MFT Forward Proxy that is included in the Control-M MFT Gateway installation. This proxy runs as a standalone process, separate from the Gateway, and you can use it to direct your file transfers via SFTP, FTPS, and S3 protocols.

    Begin

    1. Ensure that the data/forwardConfig.properties file contains the required settings (port and optional credentials).

    2. Run one of the following commands:

      • Linux: start-forward-proxy.sh

      • Windows: <MFTE Home>\ForwardProxy\exe\start_forward_proxy.cmd

    Configuring the Automatic Startup Procedure for Control-M MFT Enterprise Gateway

    This procedure describes how to configure the automatic startup procedure for Control-M MFT Enterprise Gateway on Linux.

    Begin

    1. Log in as root.

    2. Navigate to the following to location:

      /etc/systemd/system/

    3. Create a new unit service file with 644 permissions.

      The extension must be .service.

      b2b-gtw.service

    4. Open the file and type the following:

      Copy 
      [Unit]Description=B2B Gateway
      [Service]
      Type=forking
      RemainAfterExit=yes
      ExecStart=/[mft_proxy_exe_dir]/start-mft-proxy.sh
      ExecStop=/[mft_proxy_exe_dir]/shut-mft-proxy.sh
      User=[mft_proxy_user]
      Group=[mft_proxy_group]
      [Install]
      WantedBy=multi-user.target

    5. Save the file.

    6. From a command line, run the following commands:

      • systemctl daemon-reload

      • systemctl enable [unit service file].service

    7. Restart the Control-M MFT Enterprise Gateway computer and check that the Gateway is up and running.

    Configuring the Control-M MFT Enterprise Gateway as a Windows Service

    This procedure describes how to configure the Control-M MFT Enterprise Gateway as a Windows service, which enables the Gateway to automatically start up after the machine restarts.

    Begin

    1. Navigate to the following directory:

      <Gateway>\exe\svc

    2. Run the following command:

      install_gateway_as_service.cmd

    3. Right click on the Gateway home directory and select Properties > security > Edit.

    4. Verify that the LOCAL SERVICE user has full control to the directory and all its sub-directories.

    5. Open the service Properties window, select Recovery, and then select to Restart the service on 1st, 2nd or any subsequent failure.

      This ensures that the service restarts after a failure.

    6. Start up the Control-M MFT Enterprise Gateway service.

    To remove the MFT Enterprise service, navigate to <Gateway>\exe\svc and run the following command:

    uninstall_gateway_as_service.cmd

    Uninstalling Control-M MFT Enterprise from Windows

    This procedure describes how to uninstall Control-M MFT Enterprise from Windows.

    Begin

    1. From the Start menu, select Control Panel.

    2. Double-click Programs and Features.

    3. Select Control-M Managed File Transfer Enterprise B2B, and click Uninstall.

    4. Click OK to continue.

      Control-M MFT Enterprise is successfully removed from your computer.

    Uninstalling Control-M MFT Enterprise from UNIX

    This procedure describes how to uninstall Control-M MFT Enterprise from UNIX.

    Begin

    1. Log in as a Control-M user.

    2. Navigate to the following directory:

      <InstallFolder>/BMCINSTALL/uninstall/DRM2B

    3. Type one of the following commands:

      • Interactive Uninstall: ./uninstall.sh

      • Automatic Uninstall: ./uninstall.sh -silent

    4. Control-M MFT Enterprise B2B is successfully removed from your computer.

    Uninstalling Control-M MFT Enterprise Gateway from Linux

    This procedure describes how to uninstall Control-M MFT Enterprise Gateway from Linux.

    Begin

    1. Navigate to the following directory:

      <InstallFolder>/BMCINSTALL/uninstall/DRM2B.9.0.21.300

    2. Type one of the following commands:

      • Interactive Uninstall: ./uninstall.sh

      • Automatic Uninstall: ./uninstall.sh -silent

      The Control-M MFT Enterprise Gateway is successfully removed from your computer.