Linux installation

This topic describes how to install Micro Focus Connect on a Linux machine.

You can install Micro Focus Connect to run either as a background service, or as a standalone application.

Caution: Micro Focus Connect for Linux is distributed as a tgz/tar.gz bundle, as opposed to a Linux package manager format like RPM or DEB. As such, installation, un-installation, and upgrade require manual activities.

You should not attempt these actions if you do not have suitable knowledge in Linux.

Before you install

Perform the following before you install Micro Focus Connect:

  1. Check the Support Matrix.
  2. Download Micro Focus Connect Core for Linux from the Micro Focus Marketplace.
  3. If you are upgrading an existing installation, to prevent data loss, stop any connections that are running in the existing installation.

Back to top

Install Micro Focus Connect

Perform the following steps to install the Micro Focus Connect application and service.

This is the standard mode of installation.

  1. Extract the archive in a directory of your choice:

    tar -zxvf mfconnect-linux-<build>.tar.gz

  2. Open the deployment directory:

    cd MicroFocusConnect

  3. Using the sudo user, deploy the Micro Focus Connect service:

    sudo ./install_service.sh

  4. Start the Micro Focus Connect service:

    sudo systemctl start connect

  5. To verify the installation, check the service's status:

    sudo systemctl status connect

    The system should return an "Active" message.

    Back to top

    Install the standalone Micro Focus Connect application

    You can install Micro Focus Connect as an application only. This means that the service will not run continuously in the background.

    Use this typically if you are trying out Micro Focus Connect.

    Run the following commands:

    cd MicroFocusConnect/WebServer/bin/

    ./startup.sh

    Back to top

    Stop and uninstall Micro Focus Connect

    Use the following commands to stop or uninstall Micro Focus Connect:

    Action Command
    Stop the Micro Focus Connect service sudo systemctl stop connect
    Start the service after system boot systemctl enable connect
    Do not start the service automatically after system boot systemctl disable connect
    Uninstall Micro Focus Connect sudo ./uninstall_service.sh
    Remove the Micro Focus Connect files rm -rf MicroFocusConnect/

    Back to top

    Increase maximum allocated memory

    The following procedure describes how to increase the Tomcat maximum allocated memory on Linux deployments.

    1. Locate the file "setenv.sh" in the /MicroFocusConnect/WebServer/bin directory.
    2. Open the file and modify the value for -Xmx in JAVA_OPTS parameters.
    3. Restart the Micro Focus Connect service.

    Back to top

    Next steps: