Known Issues, Limitations and Fixes

Known Issues and Limitations

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:

  • IBM Host On-Demand will not support Zlinux due to IBM Semuru JRE 17.0.17 unsupported OS.

  • Administrative utilities and the embedded server require Java 17 as a prerequisite. Since Java 17 is not officially supported on PPC BE OS, the embedded server cannot be used on this platform. To avoid upgrade issues, deployments on PPC BE OS must use an external web server.

  • 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:
  • After installation of HOD v16.0.0, the DirUtil will work because the <Installation Directory>/lib/samples/Dirutil/Sample.xml file is corrupted.
  • IBM Java 8 will not support TLS v1.3.
  • When the FIPS 140-3 profile is enabled through the config.properties file, the HODLauncher application fails to launch over a secure (HTTPS) connection.

Fixes

IBM Host On-Demand v16.0.2.0 support Modify Installation only on OS/400and z/OS operating systems