Introduction
Login Enterprise Launcher is a host used as an endpoint to communicate between the Login Enterprise virtual appliance running a Test and the Targets (VMware, Citrix, etc.). This article describes the installation, configuration, and best practices for the Login Enterprise IGEL OS 10 Launcher.
To learn about the Launcher’s role in Login Enterprise, what it does, how it works, and more, see Launchers: Overview and best practices.
Requirements
-
2 files are required and provided via download
- .inf (LoginPI.Launcher.Console)
- Tarball (LoginPI.Launcher.Console.tar.bz2)
-
IGEL UMS (Management UI)
- These files typically go into the following folder on the UMS server. "C:\Program Files\IGEL\RemoteManager\rmguiserver\webapps\ums_filetransfer\LoginVSI\"
- This can be placed on any file share, but you’d have to point it at that file share manually.
- If you are using IGEL OS 11 and UMS 6, you will need to install an Enterprise Management Pack license.
- A custom partition is created on the endpoint device. IGEL allows for a custom partition, which makes integration easy.
Steps
- Boot IGEL endpoint device
- Scan the network subnet with UMS and pick up the endpoint you wish to configure (VM or Physical)
- Create a new Profile (you can do this before Steps 1 and 2).
(note… look for the blue triangles denoting changes you're making)
New Profile (this is all the stuff that comes with the profile if you import it versus building it yourself)
- Create a new partition, setting the Size to 100 MB and the Mount Point to /loginpi.
-
Add new partition parameters. Click on the "+" (white plus) icon to create them. This will be written into appsettings.json when the launcher is initialized:
- serverurl - the URL of the Login Enterprise virtual appliance (e.g., https://loginenterprise.lab.com)
- secret - see below for instructions on how to get the secret
To get the secret, go to Portainer, open the identity server container,
open console,
- Type “cd /run/secrets/” and “cat LAUNCHER_SECRET &&echo” copy the secret and paste it into the secret field (below).
- Or, with Login Enterprise 4.1 and higher, you can find the Launcher secret in the Launcher overview under the download section of the Launcher files.
- Setting the proper UMS password to access the share. Note the URL below should be the full path to the .inf file that is on the UMS share (e.g., http://192.168.1.101:9080/ums_filetransfer/LoginVSI/Login.Launcher.Linux.inf)
Click Add custom application if the Launcher doesn’t exist. This next step adds the Launcher to the desktop. The Autostart enables the Launcher to automatically run with the endpoint boots up. Add a new Custom Application and fill in the details as follows:
Other settings
Making an icon
The command above is “xterm -bg "black" -fg "white" -iconic -hold -e /loginpi/start.sh”
Making it work with the desktop integration
- Here’s how you can change the hostname of the endpoint IGEL client (Terminal Name). This step isn't required if name resolution works and can always be tested by running ping from the terminal.
- For the dual-homed PI server, you'll need to set up another NIC. If you don't have a name resolution for the physical client, you can add host entries to the client config.
Additional resources
- For information on the Login Enterprise IGEL OS 11 Launcher, see the Login Enterprise IGEL Launcher.