Community articleInstalling IBM Forms API on AIX, IBM i, Linux, and Solaris
Added by IBM contributorIBM on May 2, 2012
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

You can install the API using the installer in graphical mode or in console mode. To use the graphical installer, you must have X-Windows.



You can install the API using the installer in graphical mode or in console mode. To use the graphical installer, you must have X-Windows.

You must be logged in as root user when running the installer.

Parent topic: Installing IBM Forms API

Starting the installer on IBM i

You must have a user profile that has *ALLOBJ and *SECADM special authorities. 
  1. Locate the zip file for the installer that applies to IBM i, and extract all of the files and folders to a convenient temporary directory on your system.
  2. In the Qshell environment, change to one of the following directories:
    • <unzip directory>/64-bit/ if you are using a 64-bit system
    • <unzip directory>/32-bit/ if you are using a 32-bit system

  3. Issue the appropriate command to start the installer:
  4. Table 1. Commands for starting the installer on IBM i

    64-bit32-bit
    V6R1/QIBM/ProdData/Java400/jdk15/bin/java -jar FormsServer_800_i5OS.jar -i console/QIBM/ProdData/Java400/jdk15/bin/java -jar FormsServer_800_i5OS.jar -i console
    V7R1/QOpenSys/QIBM/ProdData/JavaVM/jdk60/64bit/bin/java -jar FormsServer_800_i5OS.jar -i console/QOpenSys/QIBM/ProdData/JavaVM/jdk60/32bit/bin/java -jar FormsServer_800_i5OS.jar -i console



    Note: For IBM i, the installer is only available in console mode.
To complete the installation process, follow the instructions in the "Completing the installation" section below.

Starting the installer on Linux or zLinux

  1. Locate the zip file for the installer that applies to your operating system, and extract all of the files and folders to a convenient temporary directory on your system.
  2. Open a terminal window and start the installer by running the executable for your operating system. Use one of the following commands:
  3. Table 2. Installer executable file names
    Operating system64-bit32-bit
    Linux./FormsServer_800_LinuxX64.bin./FormsServer_800_Linux.bin
    zLinux./FormsServer_800_LinuxS390x.bin./FormsServer_800_LinuxS390.bin



    Note: To run the installer in console mode, start the installer with the command line parameter -i console.
To complete the installation process, follow the instructions in the "Completing the installation" section below.

Starting the installer on AIX

Make sure that you have the latest version of the XL C runtime installed. To check the version, at the command line type:

lslpp -La | grep -i xlC


On AIX® 5.3, the version must be 8.0 or greater. On AIX 6.1 the version must be 9.0 or greater.

To download and install the latest version of the XL C runtime PTF for AIX, see http://www-01.ibm.com/support/docview.wss?uid=swg21215669
  1. Locate the zip file for the installer that applies to AIX, and extract all of the files and folders to a convenient temporary directory on your system.
  2. Open a terminal window and start the installer by running the executable for your operating system. Use one of the following commands:
    • On 64-bit systems: ./FormsServer_800_AIXPPC64.bin
    • On 32-bit systems: ./FormsServer_800_AIXPPC32.bin
    Note: To run the installer in console mode, start the installer with the command line parameter -i console.
To complete the installation process, follow the instructions in the "Completing the installation" section below.

Starting the installer on Solaris

Make sure that you have the libstdc++.so.6 library before installing the API. To obtain and install libstdc++.so.6, download the following file: ftp://ftp.sunfreeware.com/pub/freeware/sparc/10/libgcc-3.4.6-sol10-sparc-local.gz
  1. Locate the zip file for the installer that applies to AIX, and extract all of the files and folders to a convenient temporary directory on your system.
  2. Open a terminal window and start the installer by running the executable for your operating system. Use one of the following commands:
    • For 64-bit systems: .FormsServer_800_SolarisSparc64.bin
    • For 32-bit systems: ./FormsServer_800_SolarisSparc.bin
    Note: To run the installer in console mode, start the installer with the command line parameter -i console.
To complete the installation process, follow the instructions in the "Completing the installation" section below.

Completing the installation

To finish installing the API:
  1. Select a language and click OK.
  2. Click Next and read the license agreement.
  3. Click I accept the terms in the license agreement then click Next. The installer configures the IBM Autonomic Deployment Engine. If the Autonomic Deployment Engine is not on your system, the installer installs it for you. When configuration is complete, the Select Destination Folder panel opens.
  4. Enter or select a location for the API then click Next.
  5. Choose an installation type set then click Next.
  6. Select API then click Next.
  7. If you want the installer to deploy the API to an existing WebSphere® Application Server, WebSphere Process Server, or Portal Server:
    1. Select the check box then click Next.
    2. Enter the location of the server then click Next.
    3. The WebSphere Application Server Settings panel opens, and the installer populates the profile, cell, node, and server information fields.
    4. Select the profile that you want to use, and make sure that the cell, node, and server information is correct.
    5. Enter the User Name and Password information, then click Next. The installer verifies the WebSphere Application Server information.
    Note: If you are not sure about this option, or you do not have the information available, do not select it. You can manually deploy to a WebSphere server after installing the API. See Configuring WebSphere Application Server to use IBM Forms API.
  8. Click Install.
After the API is installed, you must configure it for use.

Related tasks
Configuring the API on AIX, Linux, and Solaris