# Install Distributed Index Handler on UNIX

Use the following procedure to install Distributed Index Handler in text mode on UNIX platforms.

To install Distributed Index Handler on UNIX

1. Open a terminal in the directory in which you have placed the installer, and enter the following command:

       ./IDOLServer_VersionNumber_Platform.exe --mode text

   where:

   `VersionNumber` | is the product version
   `Platform` | is the name of your UNIX platform

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

   The console installer starts and displays the Welcome screen.

2. Read the information and then press the `Enter` key.

   The license information is displayed.

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

4. 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.

5. Press `2` to select the Custom installation mode.

6. 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.

7. 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`.

8. 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 Distributed Index Handler. Press `Enter`.

9. 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 the DIH, you can specify the following ports:

   ACI Port | The port that client machines use to send ACI actions to the DIH. Default: 9070
   Index Port | The port that client machines use to send index actions to the DIH. Default: 9071
   Service Port | The port that client machines use to send service requests to the DIH. Default: 9072

   If you do not specify a value, the installer uses the specified default ports.

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

   The Init Scripts screen is displayed.

10. 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.

11. 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.

12. 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.

13. Press `Enter` to finish the installation.

_FT_HTML5_bannerTitle.htm