IBM Support

Resolving IBM Content Navigator 3.1.0 Configuration Error on AIX: realpath: not found Issue

Troubleshooting


Problem

The configmgr_cl command for IBM Content Navigator (ICN) version 3.1.0 fails to execute on AIX systems, displaying the error message: realpath: not found. This prevents the configuration manager from starting and executing tasks.

Symptom

When attempting to run the configmgr_cl command on an AIX system, users encounter the following error:
  • realpath: not found
  • Error: Could not find or load main class com.ibm.ecm.configmgr.app.xxxxxxxxxxxx

Cause

The issue is caused by the absence of the realpath utility on the AIX system. This utility is required by the configmgr_cl script to resolve absolute paths necessary for the configuration process.

Environment

- IBM Content Navigator version 3.1.0
- AIX operating system
- Java version 8

Diagnosing The Problem

  1. - Attempt to run the configmgr_cl command and observe the error message.
    - Check for the presence of the realpath utility by executing which realpath in the terminal. If the command returns no path, the utility is not installed.

Resolving The Problem

  1. Install the 'realpath' Utility:
    • Use the AIX package manager to install the 'realpath' utility. If it's not available via the package manager, consider compiling it from source.
    • Verify the installation by running 'which realpath' to ensure the command is now available.
  2. Verify Environment Variables:
    • Ensure that the 'LIBPATH 'and 'JAVA_HOME' environment variables are correctly set to include the necessary paths for Java and ICN libraries.
  3. Re-run the "configmgr_cl" Command:
    • After installing realpath", attempt to execute the configmgr_cl command again to verify that the issue is resolved.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB18","label":"Miscellaneous LOB"},"Business Unit":{"code":"BU056","label":"Miscellaneous"},"Product":{"code":"SSEUEX","label":"IBM Content Navigator"},"ARM Category":[{"code":"a8m3p000000LRz9AAG","label":"IBM Content Navigator"}],"ARM Case Number":"TS017072543","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Product Synonym

IBM Content Navigator; Configuration Manager; AIX

Document Information

Modified date:
31 July 2025

UID

ibm17166852

Page Feedback