The OpenEdge ESB Adapter is included in the OpenEdge installation package. The OpenEdge installation program on Linux machines presents a series of dialog boxes in which you enter your choices in each dialog box and advance at your own pace. The specific controls you use to advance to the next dialog box or return to a previous dialog box are identified on each dialog box.

Select a menu option using the spacebar, the TAB key, the cursor keys, or the accelerator keys that are highlighted in each selection on the dialog box.

Press CTRL+T to quit the installation at any time.

To get help on a dialog box, follow the instruction provided on the dialog box. Generally, you enter the control-key sequence or highlight the menu option, and then press ENTER. In the Help window, use the Up and Down arrow keys to scroll through the contents. Press ESC twice to return to the installation program.

Follow these steps to proceed:
  1. Log in to the machine as root.
  2. If you have any applications running, then stop them.

    Running applications or tasks may interfere with the installation because they could use files that OpenEdge needs to complete the installation.

  3. From a browser, access the Progress Software Download Center and navigate to the Electronic Software Distribution (ESD) software image you intend to download. An ESD download supports downloading software images from the Progress Download Center. This website requires a valid account with Progress for accessing OpenEdge products and updates.

    Extract the contents of the downloaded .tar.gz file to a suitable location on your system before starting the installation.

  4. To start the installation, run the following command:
    ./<path>/proinst

    The Welcome dialog box appears.

    Note: In the command, path represents the complete path of the directory that contains the downloaded software image. You cannot run proinst from either the directory where you have downloaded the software image, or from the target directory in which you are installing OpenEdge.
  5. Read the information in the Welcome dialog box and press ENTER.
  6. In the Product Configuration Data dialog box:
    1. (Optional) Type the company name in the Company Name field.
    2. Type the serial number in the Serial Number field.
    3. Type the control number in the Control Number field.
    4. Press CTRL+E to submit your configuration information.

      The Done Configuration Data Confirmation dialog box appears.

    5. Type Y to confirm.

      The JavaHome Pathname dialog box appears.

      Note: Enter N to cancel and return to the Product Configuration Data dialog box.
  7. Specify the JDK installation location in the JavaHome Pathname and press ENTER.
    Note: Ensure that you have the correct JDK version installed. Otherwise, an error message is displayed, and you cannot proceed with the installation. For details about JDK requirements on each supported platform, see the OpenEdge 13 Platform Compatibility Guide.

    The Install Type and Destination dialog box appears.

  8. In the dialog box:
    1. Specify the type of installation. The options are Complete or Custom. The default is Complete.
    2. Specify the installation directory. The default is /usr/dlc.
    3. Specify the working directory. The default is /usr/wrk.
    4. Specify the OpenEdge Management installation directory. The default is /usr/oemgmt.
    5. Specify the OpenEdge Management working directory. The default is /usr/wrk_oemgmt.
    6. Press ENTER.
  9. If the Select Server Engine dialog box appears, specify whether or not you want to install the SQL Server database engine and continue with the installation. By default, the database engine is installed.
  10. In the Sonic ESB Properties dialog box:
    1. Type the container name in the Container Name field.
    2. Type the domain name in the Domain Name field.
    3. Type the connection URL in the Connection URL field.
    4. Type your user credentials in the User Name and Password fields.
    5. If you have Sonic ESB installed on the machine, then type the Sonic ESB installation directory in the SonicESB Home Directory field.

    6. Press ENTER.

      The Complete Installation dialog box appears.

      Note: If the SonicESB Home Directory field is empty, then a message appears that states that you must manually configure the Sonic Management console on the remote machine.
  11. In the Complete Installation dialog box:
    1. Review your installation choices.
    2. Type Y to confirm.

      If you want to modify your choices, then type N to return to the previous dialog box.

  12. In the Copy Scripts dialog box, confirm whether you want to copy the OpenEdge ESB adapter product scripts and program modules to the default location /usr/bin.
    Note: If you are maintaining two versions of OpenEdge on the same machine, then type N to avoid overwriting files.
  13. When the installation is complete, a message is displayed. Select End the OpenEdge Installation, and press ENTER to close the message box.
Note: When installing the OpenEdge ESB Adapter as an individual component, an error indicating the ESAM registration failure is encountered, prompting you to review the esam.log file. You can ignore this error and the corresponding message in esam.log, as ESAM registration does not affect the functionality of OpenEdge ESB Adapter. You can proceed with the installation without any issues.