Install Distributed Action Handler on Windows

Use the following procedure to install Distributed Action Handler on Microsoft Windows operating systems, by using the IDOL Server installer.

The IDOL Server installer provides the major IDOL components. It also includes License Server, which Distributed Action Handler requires to run.

To install Distributed Action Handler

  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. Navigate to the folder where you extracted the ZIP, and double-click the installer package:

    IDOLServer_VersionNumber_Platform.exe

    The installer loads and the Introduction dialog box opens.

  3. Click Next.

    The License Agreement dialog box opens.

  4. Read the license agreement. Select I accept the agreement, and then click Next.

    The Installation Directory dialog box opens.

  5. Specify the directory to install Distributed Action Handler (and optionally other components such as License Server) in. By default, the system installs on C:\OpenText\IDOLServer-VersionNumber. Click to choose another location. Click Next.

    The Installation Mode dialog box opens.

  6. Select Custom, and then click Next.

    The OEM installation dialog box opens.

  7. Choose whether to install IDOL for OEM usage.

    • To install IDOL for OEM usage

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

        • Copy from file, then click to find the licensekey.dat file to use.
        • Copy the licensekey.dat manually after the installation.
      3. Click Next.

        The Component Selection dialog box opens. Skip to Step 8.

    • To install IDOL for standard usage, click Next.

      The License Server dialog box opens. Proceed to Step 7.

  8. Choose whether you have an existing License Server.

    • To use an existing License Server

      1. On the License Server dialog box, click Yes, and then click Next. The Existing License Server dialog box opens.
      2. Specify the host and ACI port of your License Server, and then click Next.
    • To install a new instance of License Server

      1. On the License Server dialog box, click No, and then click Next. The Service Name dialog box opens.

      2. In the Service name box, type the name of the Windows service to use for the License Server, and then click Next. The License Server dialog box opens.

      3. Specify the ports that you want License Server to listen on, then click Next.

      4. Select how you want to provide your IDOL license key file (licensekey.dat) and version key file (versionkey.dat). You obtain the license key when you purchase IDOL, and you obtain the version key file from the Software Licenses and Downloads portal (SLD) as a separate download package.

        You can select one of the following options:

        • Copy from file. Type the file locations for your licensekey.dat and versionkey.dat, or click and navigate to the locations.

        • Copy the licensekey.dat manually after the installation. In this case, you must add the licensekey.dat and versionkey.dat files to the License Server directory after installation is complete.

        Click Next.

    The Component Selection dialog box opens.

  9. Click Next.

  10. Select the check boxes for the components that you want to install, and specify the port information for each component, or leave the fields blank to accept the default port settings.

    For the DAH, you can specify the following ports:

    ACI Port The port that client machines use to send ACI actions to the DAH.
    Default: 9060
    Service Port The port that client machines use to send service requests to the DAH.
    Default: 9062

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

    Click Next or Back to move between components.

  11. After you have specified your settings, the Summary dialog box opens. Verify the settings you made and click Next.

    The Ready to Install dialog box opens.

  12. Click Next.

    The Installing dialog box opens, indicating the progress of the installation. If you want to end the installation process, click Cancel.

  13. After installation is complete, click Finish to close the installation wizard.