Upgrading Enterprise Connector from an earlier version

The Infor Cloud team can update ION CE to a later version. After such an update, the Enterprise Connector version in the ION Enterprise Location page is shown in red. This indicates that a later version is available. For details of the newer version, see the ION CE release notes.

During the upgrade, the integration between ION CE and the connection points for this location is unavailable. Run the Enterprise Connector upgrade on one of the Enterprise Connector hosts.

Before you begin

  • Scaled-out environments: If you have scaled out Enterprise Connector across multiple hosts, run the upgrade on one host. The other hosts are updated automatically as part of the process. JDK updates are not propagated; update the JDK on each host. See Updating the JDK version.
  • JDK compatibility:
    • JDK 17 support was introduced in 2024.04.
    • JDK 17 is required from 2024.10 onward.
    • If your current version is earlier than 2024.04:
      1. Upgrade Enterprise Connector to 2024.09.
      2. Update to JDK 17 on all hosts.
      3. Run the ChangeJDK process on all hosts.
      4. Ensure Enterprise Connector launches successfully.
      5. Upgrade to the required later version (2024.10 or later).
  • Ensure that you have the ION Runtime Database password available.
  • Plan a maintenance window for the downtime.
  1. In ION, select Connect > Enterprise Locations.
  2. Click the Download Enterprise Connector icon and save the file com.infor.ion.cloud.enterprise.connector.installer-<version>.jar.
  3. Copy the .jar file to the system where Enterprise Connector is upgraded.
    In scaled-out environments, identify the host for running the installer. The other hosts are updated automatically. Perform any JDK updates separately on each host.
  4. Start the installation by double-clicking the .jar file.

    Alternatively, run this command in an elevated command prompt after navigating to the download location:

    java -jar com.infor.ion.cloud.enterprise.connector.installer-<version>.jar
  5. During the upgrade, specify this information:

    • Grid installation directory

      Default: C:\Program Files\Infor\IONEnterpriseConnector

      Select the installation folder of the current Enterprise Connector.

    • JDK path

      Specify the JDK currently in use. If you upgrade to 2024.10 or later, this path must point to JDK 17.

    • ION Runtime Database password

  6. After the upgrade finishes, verify that the Enterprise Connector service is running and that message processing has resumed.
    • Confirm that the Enterprise Connector status is green in Connect > Enterprise Locations.
    • Verify that connection points resume processing, that they appear in the Active Connection Points menu, and that logs show no errors.
    • In scaled-out environments, confirm that each host shows the updated version. If any host still uses an older JDK, update the JDK path on that host to JDK 17 and restart the service (required for 2024.10 and later).
  7. If your current version is earlier than 2024.04, complete this special upgrade path.
    1. Upgrade Enterprise Connector to 2024.09.
    2. Update to JDK 17 on each host. See Updating the JDK version.
    3. Upgrade Enterprise Connector again to the required later version (2024.10 or later).
  8. In scaled-out environments, run the installer on one host because the other hosts are updated automatically. Update the JDK manually on every host when required.