5.2 Installing the Kanaka Engine

IMPORTANT:These procedures do not work unless you have first generated a certificate and created a PEM file. If you have not done so already, do so now by following the procedures in Section 3.5, Generating Certificates.

  1. From the ISO image, copy the RPM file that is applicable to the operating system and architecture of the server that will host the Kanaka Engine.

  2. From the server that will host the Kanaka Engine, open a terminal session.

  3. Navigate to the RPM file you copied in Step 1.

  4. At the terminal console, run the following command:

    rpm –i microfocus-kanaka-engine-3.1.x-x.x~.rpm

  5. At the terminal console, run the following command:


    This launches the Micro Focus Kanaka for Mac Engine Configuration utility.

  6. Press Enter to select the default data path.


    Specify a new data path.

  7. Press 0 to select the displayed IP address.


    Specify a new IP address.

    If multiple addresses are listed, select the desired address for your network configuration.

  8. When the HTTP Port [0] option appears, type 0.

  9. Unless there is a conflict, accept the default HTTP port number of 3089.

    If you need to use another port number, provide the new port number.

  10. Press Enter to continue.

  11. (Conditional) Link the Kanaka Engine hostname with the certificate.

    If you created your certificates to use IP or FQDN instead of the NCP server name, when the engine loads, the name won't match and the Engine start will fail. You can resolve this by editing the name of the server to match the name or IP address used on the server certificate.

    1. Type N.

    2. Type C to clear the address.

    3. Type N.

    4. Type S and then enter the server name or IP address you used for your certificate.

  12. Type Q to quit and save the configuration.

  13. When are asked if you want to restart the service, do not do so until completing Step 14.

  14. Copy the PEM file that you created in Step 9 to the following location:


  15. Restart the service by selecting Y.