IDOL 24.2

# Install IDOL on UNIX

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.

Copyright 2024 Open Text
Version 24.2 | Last updated March 2024

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL 24.2

Topic Title: Install IDOL on UNIX