Appendix D: Working with Connector ID Keys on IGEL Thin Clients

Updated Installation Instructions

Due to improvements with the integration of IGEL Thin Clients with the Liquidware Connector ID Keys, these updated installation instructions are much simpler and easier to implement than the legacy ones. To install the CID Key on your IGEL Thin Clients, complete the following steps:

  1. In IGEL, go to Accessories > Connector ID Key Software.
  2. Select the Enable Stratusphere UX CID Key checkbox in the right panel.
  3. In the Stratusphere hub field, enter the hub IP-address or DNS of the Stratusphere.
  4. In the Stratusphere machine group field, enter the machine group of the Stratusphere.
  5. In the Stratusphere user group field, enter the user group of the Stratusphere.
  6. Click Ok to finish.

Legacy Installation Instructions

Important: You should only use the following installation instructions if you have an older version of the thin client or if you want to run a version of the Liquidware product that is not available on the thin client itself. In all other cases, use the updated installation instructions at the start of this section.

To install the CID Key on your IGEL Thin Clients using IGEL Universal Management Suite (UMS) Console, complete the following steps:

  1. Log in to your machine where you have the UMS Console as an administrator.
  2. Using your local browser, log in to the Administration section of the Liquidware Stratusphere Hub.
  3. Navigate to the Hub Administration > Connector ID Keys > Connector ID Key Software tab and expand the Other versions section under the main download table. Use the IGEL link to download the IGEL ZIP from the Hub onto your local UMS machine.
  4. Navigate to the following location and create a new folder lwl under it:
    C:\Program Files (x86)\IGEL\RemoteManager\rmguiserver\webapps\ums_filetransfer\
    After you unzip the contents of the ZIP file into the new lwl folder, you should see three files:

    • disclaimer.txt
    • lwl.inf
    • lwl.tar.bz2
  5. Check the accessibility of the files by opening the INF file in your local browser using the following URL:
  6. http://[ums_server]:9080/ums_filetransfer/[name]/[name].inf
  7. Note: Keep this URL available as it will be needed in the step below.

  8. Log in to your UMS Console using your administrative credentials.
  9. In the left pane, navigate to your Server - <IP Address>, and expand IGEL Universal Management Suite 5 > Profiles.
  10. Select an existing profile or make a copy of this existing profile to use as a starting point for installing the Stratusphere CID Key on your IGEL Thin Clients. In this example, the profile is Thin Clients with CID Keys (Liquidware).
  11. Right-click the Thin Clients with CID Keys (Liquidware) profile and select the Edit Configuration option.
  12. In the left column of the window that pops up, navigate to Configuration > System > Firmware Customization. Within this section, we are going to work with the Custom Partition, Custom Commands, and Environment Variables sections to customize the CID Key installation.
  13. Expand the Custom Partition section and click the Partition link.
  14. In the right panel, select the Enable Partition checkbox.
  15. Set the size to 200MB.
  16. Use the default Mount Point, which should be set to /custom.
  17. Click Save.
  18. Return to the Custom Partition section and click the Download link.
  19. In the right panel, click the + button to add a new Partitions Data Sources entry. In the URL field, copy and paste the URL that you tested in Step 5 above.
  20. In the Username and Password fields, enter your credentials for UMS.
  21. In the Initializing Action field, enter sh /custom/init-lwl.sh.
  22. Click OK.
  23. The new entry for Partitions Data Sources should be visible in the right panel. Click Save.
  24. In the left column, navigate to the Configuration > System > Firmware Customization > Custom Commands section and click the Network option.
  25. In the right panel, enter the following in the After network DNS field:
  26. /opt/vdesktools/bin/vs-helper -c /opt/vdesktools/grd/grd.conf
  27. Click Save.
  28. Click the Apply and send to thin client button to apply this profile to the thin clients within the selected Profile. You can also assign this profile to other thin clients. The system then reboots.
  29. Log in to any of the thin clients within the applied profile to verify that the CID Key software is up and running by opening a terminal window and running the following command:
  30. ps -ef | grep vs
  31. The command lists all processes running on the machine, filtered by any process with vs in the process name, as shown in the image below.
  32. If you see /opt/vdesktools/bin/vs-helper displayed on your screen, this is confirmation that the CID Key is running.