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, but not in a Linux package manager format such as RPM or DEB. Therefore, installation, uninstallation, and upgrades require manual intervention. Only attempt these actions if you have extensive knowledge in Linux.

In this topic:

## Before you install Micro Focus Connect

Perform the following before you install Micro Focus Connect on a Linux machine:

1. Check the Support Matrix to make sure that your environment is supported.
2. Download Micro Focus Connect Core for Linux from the Micro Focus Marketplace.

3. Create a folder for the Connect installation, and unpack the files from the downloaded archive:

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

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

4. If you are upgrading an existing installation, stop any connections that are running in the existing installation, to prevent data loss.

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

Back to top

## Perform a full Linux installation

This section describes how to perform a full installation of Micro Focus Connect either as a single node or a multi-server node installation.

- As a single node: This installation contains the Micro Focus Connect service and database, but does not allow other machines to access the database.

- As a multi-server node: This configuration allows multiple server nodes to access the same database. To work in multi-server mode, you can perform a full installation and configure the database to allow other connections. Alternatively, you can install the database on a separate machine and install multiple server nodes accessing that database. For details, see Perform a database installation.

Note: When performing a multi-server installation, make sure that the database machine and all server node machines are set to the same time zone.

To perform a full installation:

1. For multi-server node installations only: Set the database to an open connection:

   1. Change the directory to the installation's Database/bin folder.

   2. Open the <installPath>/Database/bin/setenv file and change the value of the derby.drda.host system variable from 127.0.0.1 to the relevant private network. For details, see the Derby documentation.

2. Change the directory to the deployment folder:

   cd MicroFocusConnect

3. Run the database configuration:

   ./configure_database_server.sh

4. Install the Derby database service:

   sudo ./install_database_service.sh

5. Run one of the following commands to start the Derby service:

   sudo systemctl start connect-database

   sudo systemctl enable connect-database

6. Prepare the database. Run the prepare_database.sh script:

   ./prepare_database.sh

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

   sudo ./install_service.sh

8. Start the Micro Focus Connect service with one of the following commands:

   sudo systemctl start connect

   sudo systemctl enable connect

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

   sudo systemctl status connect

   Wait for the system to return an Active status.

10. Secure the database. For details, see Install SSL certificates and secure the database.

11. Using the URL, for example, http://my_server:8081/ConnectWeb/index.html and the credentials provided to you, log into Micro Focus Connect.

Back to top

## Perform a database installation

When using a multi-server configuration, you can install the database on a separate machine, without the Micro Focus Connect server. After installing the database sever, you install Micro Focus Connect server nodes on multiple machines. For each of the server nodes, you specify the same database machine.

This section describes how to install an Apache Derby database that can be accessed by one or more Micro Focus Connect server nodes.

Note: When performing a multi-server installation, make sure that the database machine and all server node machines are set to the same time zone.

To perform a new database installation:

1. Set the database to an open connection:

   1. Change the directory to the installation's Database/bin folder.

   2. Open the setenv file and change the value of the derby.drda.host” system variable from 127.0.0.1 to the relevant private network. For details, see the Derby documentation.

2. Change the directory to the deployment folder:

   cd MicroFocusConnect

3. Run the database configuration:

   ./configure_database_server.sh

4. Install the Derby database service (If you are using a non-admin user account, you will need to prefix the command with sudo.):

   sudo ./install_database_service.sh

5. Run one of the following commands to start the Derby service:

   sudo systemctl start connect-database

   sudo systemctl enable connect-database

6. Secure the connection to the Derby database service. For details, see Secure the connection to the database server.

To upgrade a database:

1. Stop the database service:

   sudo systemctl stop connect-database

2. Drop the old database into the new installation folder ../AppData/data.

3. Uninstall the database service:

   sudo ./uninstall_database_service.sh

4. Continue with step 1 of performing a new database installation, as shown above, To perform a new database installation:.

Back to top

## Perform a server node installation - Linux

This section describes how to install Micro Focus Connect server nodes on a Linux machine, accessing an existing database. Before installing a server node, make sure that you have a database installed either through a full installation with the multi-server capability enabled, or through a standalone database installation. For details, see Perform a full Linux installation and Perform a database installation.

To install a Micro Focus Connect server node:

1. Navigate to the deployment directory:

   cd MicroFocusConnect

2. Prepare the database:

   1. Edit the connect_database.env file and change the default host value to the name of the database machine. Do not keep the default value, localhost.

   2. Run the prepare_database.sh script.

      ./prepare_database.sh

3. Remove extraneous example folders. The content of these folders may interfere with Micro Focus Connect.

   1. Stop the tomcat server.

      sudo systemctl stop connect

   2. Delete the webserver\webapps\examples folder and if present, the webserver\work\Catalina\localhost\examples folder.

   3. Restart the tomcat server.

      sudo systemctl start connect

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

   sudo ./install_service.sh

5. Start the Micro Focus Connect service with one of the following commands:

   sudo systemctl start connect

   sudo systemctl enable connect

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

   sudo systemctl status connect

   Wait for the system to return an Active status.

7. Using the URL, for example, http://my_server:8081/ConnectWeb/index.html and the credentials provided to you, log into Micro Focus Connect.

8. Open the Servers tab to view a list of the Micro Focus Connect server nodes.

Back to top

## Install the standalone Micro Focus Connect application

You can install Micro Focus Connect as an application only, and not as a service that runs continuously in the background.

This option is useful 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 Micro Focus Connect service after system boot | `systemctl enable connect`
Start the Micro Focus Connect service | `systemctl start 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 in Linux

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

To increase the maximum allocated memory:

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

- User maps and 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.5AllView 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: