Installing CoIP Launcher

CoIP Launcher is a browser based user portal, which displays a user’s available resources, allowing them to initiate connections.

Installing on Windows and Mac

When a user authenticates to the CoIP Launcher user portal, zCenter will attempt to automatically install the necessary user-side client on the client machine. Privileged installation may or may not be required, depending on the type of resources and access methods granted.

CoIP Access - Network and GPMA

For built-in RDP and VNC, no special privileges are required; users may install the CoIP Launcher client by themselves.

CoIP Access network and GPMA access methods require privileged installation. This can be performed by IT remotely on behalf of users who do not have administrator privilege, using Zentera’s silent installation packages.

Installing on Linux

As with Windows and Mac, the typical installation process is automated, but in some cases, or on certain variants of Linux, user intervention may be required - for example to execute some steps with sudo privileges, or install required OS libraries. This article describes the typical flow, and possible scenarios where user intervention may be needed.

Linux Installation Steps

1. Login to the CoIP Launcher web application.

   

2. If you see a dialog to "Open xdg-open" click the button for "Open xdg-open"

   

3. Launcher components should then download and install automatically. If this lasts for more than a minute, additional steps may be required. Please refer to the Manual Install section.

   

Manual Installation

If the automated installation did not succeed, the below steps can be performed manually.

1. Select the “Download Launcher” link at the bottom of the Launcher screen

2. In Terminal navigate to the Download directory and run “tar xvf coiplauncher.<unique-string>.tar.gz”

3. Please note in some cases, it is necessary to set the execute file permissions on thie downloaded file, using "sudo chmod a+x ./coiplauncher.<unique-string>.run”

4. Execute CoIP Launcher NOT using sudo “./coiplauncher.<unique-string>.run”

   1. Creating directory coiplauncher-2
      Verifying archive integrity... 100% MD5 checksums are OK. All good.
      Uncompressing Zentera CoIP Launcher 2.0 100% 
      coiplauncher-2 is installed in /home/<user>/Zentera/coiplauncher-2

5. Log out and back into Launcher. Make sure to select “Open xdg-open” button if presented

Troubleshooting Linux Installation

1. If not able to run “./coiplauncher.<unique-string>.run”

   1. DO NOT USE sudo. This must be ran as local user.

   2. Verify “coiplauncher.<unique-string>.run” has execute permission

      1. Run command "sudo chmod a+x coiplauncher.<unique-string>.run"

2. Warning - zenity is not installed. Follow directions to install zenity and login to Launcher again

3. If you want to use RDP with linux you must install "freerdp". Install freerdp using yum/apt-get/dnf with sudo.