Community articleUpdating the PureEdgeAPI.ini file on AIX, Linux, and Solaris
Added by IBM contributorIBM on July 26, 2013
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

You must create the PureEdgeAPI.ini file if it does not exist. If the file already exists then you must update it to add the location of the new API.
The contents of the PureEdgeAPI.ini file determine which applications use which version of the API. The API will not work without a PureEdgeAPI.ini file.

The file can exist in one or more of the following locations:
  • the calling application's directory
  • the current working directory
  • the /etc directory
When the API starts, it searches the folders in the order shown and uses the first PureEdgeAPI.ini file that it finds.

Note: If you chose to automatically deploy the API to WebSphere® Application Server during installation of the API, then the PureEdgeAPI.ini file already exists. The installer creates the file and adds the location of the API for you. You should verify that the location is correct.

To update the PureEdgeAPI.ini file:

Go to the directory where you want the PureEdgeAPI.ini file to exist.
  • If no PureEdgeAPI.ini file exists, create the file with a text editor and add one of the following lines, depending on your operating system:
  • If you are using AIX®:

       8.0.1.* = /usr/IBM/FormsServer/8.1/API/redist/AIX/PureEdge/81

    If you are using Linux™:

       8.0.1.* = /opt/ibm/FormsServer/8.1/API/redist/Linux/PureEdge/81

    If you are using Solaris:

       8.0.1.* = /opt/IBM/FormsServer/8.1/API/redist/SunOS/PureEdge/81

  • If a PureEdgeAPI.ini file already exists, make sure that the correct <path to API> for your operating system is in the [API] section.

Note: The file path shown is the default installation location. If you did not install the API in the default location, then you must adjust the file path to match the location of the API on your system.

Parent topic: Configuring the API on AIX, Linux, and Solaris