Linux upgrade

This topic describes how to upgrade an existing installation on Linux. We recommend using the latest version of of the product and its connectors to benefit from the added capabilities and enhanced stability.

Note: 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.

Important note before upgrading to 25.3

Starting with version 25.2, Connect exclusively supports only PostgreSQL as the database. Derby is officially deprecated.

If you are currently using a version earlier than 25.2 please first consult the documentation on how to upgrade to 25.2. For details, see Linux upgrade.

Database installation, upgrade, and management are the responsibility of the administrator.

Back to top

Upgrade process

This section lists the steps for performing an upgrade.

To perform the upgrade:

  1. Download Connect Core for Linux from the AppDelivery Marketplace.
  2. Download the latest version of the relevant connectors from AppDelivery Marketplace.
  3. Download all connector dependencies as specified in the connector Readme files. The Readme files are included in the download packages.

  4. Stop any connections that are running in the existing installation to prevent data loss.

  5. Stop the Connect web server:

    sudo systemctl stop connect

  6. Go to the directory where Connect is installed. Zip and back up the entire Connect folder:

    tar -czvf mfconnect-backup.tar.gz MicroFocusConnect/

  7. Go to the Connect directory:

    cd MicroFocusConnect

  8. Uninstall the Connect web server:

    sudo ./uninstall_service.sh

  9. Go to the parent directory:

    cd ..

  10. Remove the Connect files:

    rm -rf MicroFocusConnect/

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

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

  12. Copy the downloaded relevant connectors with dependencies to the AppData/connectors directory.

  13. Restore required configuration files from the backup copy:

    rm -rf ./previous-connect
    mkdir previous-connect
    tar -xf mfconnect-backup.tar.gz -C ./previous-connect

  14. If you have modified the Connect environment in the file ./previous-connect/MicroFocusConnect/WebServer/bin/setenv.sh, merge the modifications into the newly installed setenv.sh file.

  15. Copy all configuration files:

    cp -r ./previous-connect/MicroFocusConnect/AppData/data/* ./MicroFocusConnect/AppData/data

  16. Copy the sso configuration files:

    cp -r ./previous-connect/MicroFocusConnect/AppData/osp-server-configuration/* ./MicroFocusConnect/AppData/osp-server-configuration/
    cp ./previous-connect/MicroFocusConnect/AppData/osp-filter-configuration.properties ./MicroFocusConnect/AppData/

  17. If you have modified logging configuration files (for example log4j2.xml), merge the modifications into the newly installed configuration file. The files are installed together with Connect.

    Caution: Do not copy older configuration files and replace new configuration files with them, as this overwrites new version configurations.

  18. 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 Connect.

    Caution: Do not copy over or merge older .jar files back into the new (upgraded) installation files.

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

    cp ./previous-connect/MicroFocusConnect/jre/lib/security/cacerts ./MicroFocusConnect/jre/lib/security/

  20. 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:

    cp ./previous-connect/MicroFocusConnect/WebServer/conf/server.xml ./MicroFocusConnect/WebServer/conf/

  21. Change the directory to the deployment folder:

    cd MicroFocusConnect

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

    ./prepare_database.sh

  23. Using the sudo user, deploy the Connect service:

    sudo ./install_service.sh

  24. Start the Connect service with one of the following commands:

    sudo systemctl start connect

    sudo systemctl enable connect

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

    sudo systemctl status connect

    Wait for the system to return an Active status.

  26. To secure the database, refer to PostgreSQL database.

  27. Log in to Connect using the URL and the credentials provided to you. For example, log in using the URL http://my_server:8081/ConnectWeb/index.html.

Back to top

See also: