Share this page

# Linux installation

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

You can install Micro Focus Connect to run as a background service, which is the standard installation, or as a standalone application, commonly used when trying out the product.

Note: Micro Focus Connect for Linux is distributed as a tgz/tar.gz bundle— not in a Linux package manager format such as RPM or DEB. Therefore, installation, un-installation, and upgrades require manual intervention. Only attempt these actions if you have suitable knowledge in Linux.

In this topic:

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

Tip: For an overview of the Micro Focus Connect system resource utilization and other installation considerations, see Windows installation and upgrade. Instead of the Windows Task Scheduler, use cron jobs to schedule your tasks.

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:

   - Install connectors
   - Create a data source

   - Create user maps and apply user matching

   - Create and manage connections
   - Log in to Micro Focus Connect

https://admhelp.microfocus.comMicro Focus Connect8942
Tips to improve your search results... Micro Focus Connect Help CenterMF Connect Help4.0-4.4.3AllView Local Help CenterView Online Help CenterbackGo back in browser historyforwardGo forward in browser historyRemove search highlightsnext topicGo to next topicprevious topicGo to previous topicPrint the current topicVersion: