Install IDOL on UNIX

DEPRECATED: The IDOL Server installer is deprecated in IDOL version 24.3 and later. OpenText recommends that you use another installation method. For example, you can deploy IDOL components from zip packages or using containers. The installer is still available from IDOL support, but will be discontinued in future.

Use the following procedure to install IDOL in text mode on UNIX platforms.

To install IDOL on UNIX

  1. Download and extract the appropriate installer package ZIP file:

    IDOLServer_VersionNumber_Platform.zip

    where:

    VersionNumber is the product version.
    Platform is your software platform.

    This ZIP package contains the installer EXE and the files required for download.

  2. Open a terminal in the directory in which you have extracted the installer, and type the following command:

    ./IDOLServer_VersionNumber_Platform.exe --mode text

    NOTE: Ensure that you have execute permission for the installer file.

    The console installer starts and displays the Welcome screen.

  3. Read the information and then press the Enter key.

    The license information is displayed.

  4. Read the license information, pressing Enter to continue through the text. After you finish reading the text, type Y to accept the license terms.

  5. Type the path to the location where you want to install the servers, or press Enter to accept the default path.

    The Installation Mode screen is displayed.

  6. Press 2 to select the Custom installation mode.

  7. Choose whether to install IDOL for OEM usage.

    • To install IDOL for OEM usage

      1. Press 2 to select the OEM installation mode.
      2. Select how to provide your license key file by choosing one of the following options:

        • Copy from file. Press 1, and then type the location of your licensekey.dat file.
        • Copy the licensekey.dat manually after the installation. Press 2.

      The Component Selection dialog box opens. Go to Step 9.

    • To install IDOL for standard usage, click Next.

      The License Server screen is displayed. Proceed to Step 7.

  8. Choose whether you have an existing License Server.

    • To use an existing License Server, type Y. Specify the host and port details for your License Server (or press Enter to accept the defaults), and then press Enter. Go to Step 9.
    • To install a new instance of License Server, type N.
  9. If you want to install a new License Server, provide information for the ports that the License Server uses.

    1. Type the value for the ACI Port and press Enter (or press Enter to accept the default value).

      ACI Port The port that client machines use to send ACI actions to the License Server.
    2. Type the value for the Service Port and press Enter (or press Enter to accept the default value).

      Service Port

      The port by which you send service actions to the License Server. This port must not be used by any other service.

    3. Type the location of your IDOL license key file (licensekey.dat), which you obtained when you purchased IDOL. Press Enter.
    4. Type the location of your IDOL version key file (versionkey.dat), which you obtain from the Software Licenses and Downloads portal (SLD) as a separate download package. Press Enter.
    5. Click Next.

  10. The Component Selection screen is displayed. Press Enter. When prompted, type Y for the components that you want to install. Specify the port information for each component, and then press Enter. Alternatively, leave the fields blank and press Enter to accept the default port settings.

    For each component, you can optionally provide port information to specify the ports that the component must use. The port that you choose must not be used by any other service. The installer allows you to set the following port types:

    ACI Port The port that client machines use to send ACI actions to the component.
    Index Port The port that client machines use to send index actions to the component. This port is available only for the Content, Agentstore, and DIH components.
    Service Port The port that client machines use to send service requests to the component. This port is also the port that the component uses for License Server communication.

    The following table lists the components and subcomponents that you can install, and the default port that the installer uses if you do not provide an alternative value. You must change the port information if the default port value is already in use.

    Component Default port information
    Content ACI Port: 9100
    Index Port: 9101
    Service Port: 9102
    Agentstore ACI Port: 9050
    Index Port: 9051
    Service Port: 9052
    Category ACI Port: 9020
    Service Port: 9022
    Community ACI Port: 9030
    Service Port: 9032
    View ACI Port: 9080
    Service Port: 9082
    QMS ACI Port: 16000
    Service Port: 16002
    Statistics Server ACI Port: 19870
    Service Port: 19872
    Controller ACI Port: 41200
    Service Port: 41202
    Coordinator ACI Port: 40200
    Service Port: 40202
    DAH ACI Port: 9060
    Service Port: 9062
    DIH ACI Port: 9070
    Index Port: 9071
    Service Port: 9072
    CFS ACI Port: 7000
    Service Port: 17000
    File System Connector ACI Port: 7002
    Service Port: 17002
    Web Connector ACI Port: 7006
    Service Port: 17006
    Media Server ACI Port: 14000
    Service Port: 14001
    Knowledge Graph ACI Port: 10300
    Service Port: 10302
    Find HTTP Port: 8080
    IDOL Site Admin HTTP Port: 8080

    For more information about these components, see IDOL Core Components.

    NOTE: These ports must not be used by any other service.

    The Init Scripts screen is displayed.

  11. Type the user that the server should run as, and then press Enter.

    NOTE: The installer does not create this user. It must exist already.

  12. Type the group that the server should run under, and then press Enter.

    NOTE: If you do not want to generate init scripts for installed components, you can simply press Enter to move to the next stage of the installation process without specifying a user or group.

    The Summary screen is displayed.

  13. Verify the settings that you made, then press Enter to begin installation.

    The Installing screen is displayed.

    This screen indicates the progress of the installation process.

    The Installation Complete screen is displayed.

  14. Press Enter to finish the installation.