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 in the DMZ on a Linux computer, as described in Installing the Control-M MFT Enterprise Gateway on Linux. 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 have 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 have the following minimum requirements:

  • CPUs: 8

  • RAM: 32 GB

  • Disk Space: 100 GB

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

  • Up to 1TB 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 have 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 have 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 have the following requirements:

  • CPUs: 8

  • RAM: 32 GB

  • Disk Space: 100 GB

The Gateway machine must have the following minimum requirements:

  • CPUs: 8

  • RAM: 16 GB

  • Disk Space: 50 GB

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

  • Up to 1TB 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 have the following minimum requirements:

  • CPUs: 8

  • RAM: 32 GB

  • Disk Space: 100 GB

Each Gateway machine must have 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 (see Product Distribution in the Control-M Managed File Transfer Enterprise Release Notes).

Begin

  1. From the Control-M MFT Enterprise CD, 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. Ensure that the installation DVD is still in the DVD drive, and run the installation script, as follows:

        <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 (see Product Distribution in the Control-M Managed File Transfer Enterprise Release Notes).

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/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. Type 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 DMZ. 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

  • Download the MFT Enterprise B2B Gateway installation files (see Product Distribution in the Control-M Managed File Transfer Enterprise Release Notes).

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

  4.  

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 the following command:

    start-forward-proxy.sh

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.

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

  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.