Known Issues, Limitations and Fixes

  • IBM Host On-Demand 16.0.0 includes the following limitations:
    • The IBM WebSphere Application Server HACPEE and License Manager configuration is not supported on OS/400, zLinux, and z/OS operating systems.
    • The Host On-Demand v16.0.0.0 does not support Modify Installation on OS/400, zLinux, and z/OS operating systems.
    • Installing and uninstalling Host On-Demand Windows Server 2025:
      • Limitation: While installing or modifying (Add, Remove, Configure, Uninstall) Host On-Demand, the Deployment Wizard and HACL Toolkit display an error message.
      • Workaround:
        • For Installation of Host On-Demand execute the following workaround steps:
          1. Open command prompt and set the environment variable set JAVA_TOOL_OPTIONS="-Dos.name=Windows 2022".

          2. Run the Host On-Demand setup HOD_Windows_x64.exe.

        • For modify installation (Add/Remove/Configure/Uninstall) of Host On-Demand:
          1. Open command prompt and set the environment variable set JAVA_TOOL_OPTIONS="-Dos.name=Windows 2022".
          2. Navigate to installation path of Host On-Demand (Ex: C:\Program Files\IBM\HOD_16.0.0.0\install).

          3. Run the Host On-Demand modify Setup.exe.

  • IBM Host On-Demand 16.0.1 includes the following limitations:
    • Java 17 is not officially supported on the PPC BE operating system. Starting with HOD 16.0.1 onwards, the product requires Java 17 or later. As a result, the PPC BE operating system is no longer compatible with HOD 16.0.1 and subsequent releases for product installation.
    • The embedded server supports Jakarta EE–based applications only. Legacy Java EE–based WAR files will not load. If HEX or LM applications were deployed using the Host On-Demand installer, upgrading to newer versions will fail unless the WAR files are updated. You must download and deploy the Jakarta EE–compatible WAR files for this release.

      Maintaining a backup of the existing installer before upgrading is strongly recommended.

    • When the FIPS 140-3 profile is enabled through the config.properties file, the HODLauncher application fails to launch over a secure (HTTPS) connection.
      • In Greek operating system, the console mode installation needs to perform only in English Locale.
      • Bin directory removal during upgrade

        During an upgrade installation, custom files in the <InstallDir>\bin directory are removed.

        Users must back up any custom files before starting the upgrade.

      • Jakarta EE deployment support

        Starting with v16.0.1, Jakarta EE–based WAR files are provided. These applications cannot be deployed on WebSphere Application Server (WAS).

        If the Host On-Demand was previously deployed on WAS, users must configure a Java EE–based web application server obtained from Fix Central after the upgrade.

  • IBM Host On-Demand 16.0.2 includes the following limitations:
    • Java 17 is not officially supported on the PPC BE operating system. Starting with HOD 16.0.1 onwards, the product requires Java 17 or later. As a result, the PPC BE operating system is no longer compatible with HOD 16.0.2 and subsequent releases for product installation.
    • After installation of HOD v16.0.0, the DirUtil will not work because the <Installation Directory>/lib/samples/Dirutil/Sample.xml file is corrupted.
      Note:
      This limitation is applicable only for installation on z/OS.
    • IBM Java 8 will not support TLS v1.3.

Fixes

  • IBM Host On-Demand v16.0.2.0 now support Modify Installation on OS/400 and z/OS operating systems.
  • IBM Host On-Demand v16.0.3.0 now supports DirUtil.