Installing the Desktop Client

Adding the Trusted Certificate to a Mac

Before communications between the Kanaka clients and Engine service work, the engine's certificate issuer, its Certificate Authority (CA), must be trusted.

NOTE: You will need local administrator access to the Mac for several of the steps in this process, so have those credentials ready before proceeding.

To add the Certificate Authority to your macOS trusted certificates list:

Obtain the CA public certificate.

IMPORTANT: The following steps assume the Kanaka Engine service TLS certificate was generated using the included kanaka-create-cert utility.

 

For all other cases using a custom 3rd party certificate, consult your Kanaka administrator for details on obtaining the necessary CA certificate.

  1. From the Mac where the Desktop Client or Plug-in is installed, access the following URL from a browser:

    https://Kanaka-Engine-server-address:3089/m/GetClientClient.html.

    IMPORTANT: Until the CA certificate has been trusted, you will need to manually trust access to the Kanaka Engine service site when accessing it via a browser.

  2. Click kanaka-ca.crt to download and save the certificate to the Mac.

  3. Open the Keychain Access system utility on the Mac.

  4. Select the System keychain in the left panel.

  5. Click Certificates in the toolbar at top.

  6. From the Keychain Access menu, select File > Import Items...

  7. Select the certificate downloaded earlier for import, then click Open.

  8. Open the imported certificate details by double-clicking the certificate item or selecting the Get Info context menu item for that certificate.

  9. Select the drop-down for When using this certificate:and select Always Trust.

  10. Close the details dialog to save the changes.

  11. You should now see the certificate listed with the proper badge indicating full system trust.

Retrieving the Installation File

  • Via the ISO File

    1. From the Kanaka ISO, select the DMG image file.

    2. Copy the DMG file to each Mac where the Plug-in or Desktop Client will be installed.

  • Via the Engine Web Service

    1. From the Mac where the Plug-in or Desktop Client will be installed, open a browser and navigate to https://Kanaka-Engine-server-address:3089/m/GetClientClient.html.

    2. Click the link to KanakaClient-24.4.dmg to copy the installation file to the Mac.

Installing the Desktop Client

  1. Double-click the KanakaClient-24.4.dmg file.

  2. Click Agree on the license screen.

  3. Drag the Kanaka Client icon over to the Applications folder icon.