Windows installation and upgrade

This topic describes how to install Micro Focus Connect Core for Windows and how to upgrade an existing installation. Make sure to review the planning documents described in Planning guide and worksheet.

Before you install

Perform the following before you install Micro Focus Connect:

  1. Check the Support Matrix.
  2. Download Micro Focus Connect Core for Windows from the Micro Focus Marketplace.

Back to top

Install Micro Focus Connect

Perform the following steps to install Micro Focus Connect:

  1. Double click the installer named MicroFocusConnect-<version-OS_Info>.exe.
    The Introduction page opens.
  2. Click Next.
    The License Agreement page opens.
  3. Choose I accept the terms of the License Agreement and click Next.
    The Choose Install Folder page opens.
  4. Accept the default or click Choose to select a new location. Click Next.
    The Choose Shortcut Folder page opens.
  5. Select where you want the Shortcut Folder and click Next to configure Micro Focus Connect for your system.
    The Pre-Installation Summary page opens.
  6. Click Install. The Installing Connect page opens and the installation process starts.
    When the installation is done, the Install Complete page opens.

  7. Click Done. The installation is complete and the Micro Focus Connect Web service starts automatically.

Back to top

Upgrade Micro Focus Connect

This section guides you through the steps for upgrading to a later version of Micro Focus Connect on Windows.

We recommend using the latest versions of Micro Focus Connect and its connectors, which provide you with more capabilities and enhanced stability.

To upgrade to the latest version:

  1. Download the latest version of Micro Focus Connector Core from Micro Focus Marketplace.
  2. Download the latest version of the relevant connectors from Micro Focus Marketplace.
  3. Download all connector dependencies as specified in the connector readme files. The readme files are included in the download packages.
  4. Open Micro Focus Connect and stop all of the running connections to prevent data loss in those connections.

  5. Open the Services console and stop the Micro Focus Connect Web Server service.

  6. In the utilities folder, run the Purge script as an administrator. For details, see Batch utility scripts.
  7. Stop the Micro Focus Connect Web Server again.
  8. Zip and backup the entire Connect folder as a safety measure.
  9. Delete the entire contents of the AppData/backup, AppData/Connectors folders.
  10. Launch and run the Micro Focus Connect installer of the new version.
  11. When complete, copy the relevant connectors with their dependencies into the AppData/Connectors folder.

  12. If you have modified utility scripts (for example the .bat or .sh files), merge the modifications into the newly installed utilities. The utilities are installed together with Micro Focus Connect.

    Caution: Do not copy over or merge older .jar files back into the new/upgraded install.

  13. If you have installed security certificates, copy the certificates from the backup and replace cacerts in <install path>/Connect/jre/lib.

  14. If you changed the running port or are using https/ssl, copy the server.xml file from the backup, and use it to replace server.xml in <install path>/Connect/WebServer/conf.

  15. Open the Services console and start the Micro Focus Connect Web Server service.

  16. We recommend running the Purge script on a regular basis. Use Windows Task Scheduler to set up a nightly run of the utility at a convenient time. For details, see Purge files on Windows as a nightly task.
  17. Log in to Micro Focus Connect. Click the Info button and select About. Verify that all builds and connectors match the latest version that you installed.
  18. Start up the connections, one connection at a time. Verify that each connection is running correctly before starting the next one.

Back to top

Increase maximum allocated memory

Micro Focus Connect is configured to run with 8 GB of memory during a standard installation. As the number of connections and usage grow, you may require more memory.

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

To increase the allocated memory for Micro Focus Connect:

  1. Open a command prompt window as an administrator in the C:\Program Files\Micro Focus\Connect\WebServer\bin folder.
  2. Run the command tomcat9w.exe //ES/ConnectWebServer. This launches the Micro Focus Connect Web Server Properties dialog box.
  3. Select the Java tab.
  4. In the Maximum memory pool box, change the value to reflect a reasonable percentage of the available memory on the machine. For example, on a 16 GB machine change the value to 12288 MB (12 GB). On a 32 GB machine, change the value to 28672 MB (28 GB).
  5. Click OK.

Back to top

Set the locale to English

Micro Focus Connect must be configured to the run on the US English locale, for all operating systems.

The following procedure describes how to set the locale to US English on a Windows machine. This applies to both new installations and upgrades.

To set the locale to English:

  1. Open a command prompt window as an administrator in the C:\Program Files\Micro Focus\Connect\WebServer\bin folder.
  2. Run the command tomcat9w.exe //ES/ConnectWebServer. This launches the Micro Focus Connect Web Server Properties dialog box.
  3. Select the Java tab.

  4. Append the following to the bottom of the Java settings area. Add them to the upper area—not the bottom Java 9 Options area:

    -Duser.language=EN

    -Duser.country=US

  5. Select the General tab.

  6. Click Stop to stop the service.

  7. Click Start to restart the service.

  8. Click OK.

Back to top

Migrate to a new machine

This section describes how to migrate Micro Focus Connect to a new Windows machine.

On the source machine:

  1. Log in to the Micro Focus Connect and stop all running connections.
  2. Run C:\Program Files\Micro Focus\Connect\Utilities\mfcpurge.bat as an administrator.
  3. Open services.msc and stop the Micro Focus Connect Web Server service.
  4. Right click the service and click Properties. Select Disabled and click OK. This prevents simultaneous writing to endpoints from two Micro Focus Connect instances.
  5. Compress C:\Program Files\Micro Focus\Connect\AppData and all its contents into a zip file.
  6. Open a command prompt as an Administrator and run C:\Program Files\Micro Focus\Connect\WebServer\bin\tomcat9w.exe //ES/ConnectWebServer
  7. Navigate to the Java tab. Copy all of the contents in the Java Options section and paste into a text file. Save the file.
  8. Note the value of the Maximum Memory Pool.
  9. Back up C:\Program Files\Micro Focus\Connect\jre\bin\security\cacerts.
  10. Refer to the server.xml file to see if your connection was set up to be secure. If you had made modifications to secure Micro Focus Connect with SSL, then back up C:\Program Files\Micro Focus\Connect\WebServer\conf\server.xml and all certificate files that were in use.
  11. Back up the contents of C:\Program Files\Micro Focus\Connect\war.

On the target machine:

  1. Download and install the same build of Micro Focus Connect used on the source server.
  2. Copy the files you saved from the source machine to the target machine.
  3. Delete the C:\Program Files\Micro Focus\Connect\AppData folder and replace it with the copy from the source machine.
  4. Open a command prompt as an Administrator and run C:\Program Files\Micro Focus\Connect\WebServer\bin\tomcat9w.exe //ES/ConnectWebServer
  5. Navigate to the Java tab.
  6. Paste of the contents of the Java Options box that you saved to a text file above (step 7), into the Java Options section. Make sure to paste them into the Java Options section and not the Java 9 Options section.
  7. If the target machine has the same memory installed as the source machine, adjust the Maximum Memory Pool to match the source's value. If the machine has less memory, request that it be increased. If the machine has more memory than the source machine, it can be increased further. Check the Task Manager on the target machine to see how much memory is available on the machine.
  8. Overwrite C:\Program Files\Micro Focus\Connect\jre\bin\security\cacerts with the source machine version, from step 9 above.
  9. If you have an SSL Secured Micro Focus Connect, overwrite C:\Program Files\Micro Focus\Connect\WebServer\conf\server.xml with the copy from the source machine in step 10. If you saved any certificate files, copy them over too.
  10. Overwrite the contents of C:\Program Files\Micro Focus\Connect\war with the files saved from the source machine in step 11 above.
  11. Open services.msc and start the Micro Focus Connect Web Server service.
  12. Log in and start the connections.

Back to top

Next steps: