Updating Login Enterprise

Overview

Update notifications

An online update of the Login Enterprise

An offline update of the Login Enterprise

An offline update without a virtual CD-ROM drive

A system update of the Login Enterprise operating environment

Updating the Launchers

Overview

While we recommend reviewing the details below, here's a brief video on updating your Login Enterprise virtual appliance and launchers.

The Login Enterprise appliance can be updated directly from the appliance console. Please note that an internet connection from the appliance is required to establish a connection to the public Login VSI software repository. Ensure the following URLs are whitelisted in your environment:

https://loginvsidata.s3-eu-west-1.amazonaws.com/LoginPI3_ISO/public/ 
https://loginvsidata.s3.eu-west-1.amazonaws.com/LoginPI3_ISO/public/ 

We recommend backing up the appliance before performing the update. One suggested method is to take a snapshot using the hypervisor management system.

Update notifications

When a new version of the virtual appliance is available, Login Enterprise shows a system notification on the Dashboard page.

This feature is exclusively available for online appliances. Notifications will not be displayed for offline appliances or online appliances lacking internet access.

Find an example of a dedicated system notification below:

Frame 152.png

An online update of the Login Enterprise

  1. Open the appliance console and log in to access the Maintenance Menu.
  2. In the Maintenance Menu, select Updates.

Frame 145.png

3. In the Updates menu, select Update from the internet.

Frame 417.png

4. Wait until the ISO file download is complete.

Frame 418.png

5. Afterward, you'll see the following message:

Frame 419.png

Press Y to perform the update, or N to keep the current version.

6. Press Enter to continue.

Frame 420.png

7. Press Y to continue with the update.

Frame 421.png

8. Press Y to perform database maintenance or N to skip it.

Frame 422.png

9. Press Y for a system OS update or N to skip it.

Frame 423.png

10. Once the update is initiated, please wait for it to complete. Press Enter once finished to return to the menu.

For optimal performance, reboot the Login Enterprise virtual appliance after the update is complete.

Your Login Enterprise appliance is now updated. Remember to update/upgrade all existing launchers after each appliance update.

Please note that you need to confirm the update multiple times: steps 5, 6, and 7.

An offline update of the Login Enterprise

If the appliance doesn’t have access to the internet, you can perform the updates using a locally mounted ISO file. Please refer to your Hypervisor vendor for instructions on successfully mounting an ISO to the virtual appliance.

We recommend shutting down the virtual appliance, attaching the ISO, and then starting the appliance. Once the machine is started, log in to the appliance as usual.

  1. In the Maintenance Menu, select Updates.

Frame 145.png

2. In the Updates menu, select Update from ISO.

Frame 148.png

Afterward, you'll see the following message:

Frame 149.png

3. After pressing Enter, you'll be prompted to confirm the update.

Frame 150.png

Typing 'N' in the menu will cancel the update sequence while typing 'Y' will initiate the update process.

Once the update is initiated, please wait for it to complete. Press Enter when finished to return to the menu.

For optimal performance, reboot the Login Enterprise virtual appliance after the update.

Your Login Enterprise appliance is now updated. Remember to update/upgrade all existing launchers after each appliance update.

An offline update without a virtual CD-ROM drive

In some cases, certain hypervisors may not offer a virtual CD-ROM device to attach the ISO file to. However, you can still manually perform the update by copying the ISO file into the appliance itself.

  1. Using an SFTP client (such as WinSCP, ensuring you specify the SFTP protocol), upload the Login Enterprise update ISO to the /tmp directory.
  2. Log in to the appliance as the admin account via SSH or the console, and navigate to the Troubleshooting > Open bash shell menu entries, to get to the Linux Bash prompt.
  3. Create the mount directory if it does not already exist:

    mkdir /mnt/cdrom

  4. Mount the ISO you uploaded.

    mount -o loop /tmp/enterprise-update.iso /mnt/cdrom

  5. Once that file is mounted, run the update process manually with this command:

    loginvsid update offline

  6. Reboot the appliance. After the reboot, the ISO file will no longer be mounted, and you can delete it from /tmp to save space. (The /tmp folder is not special, you could instead choose to upload it to any other unprotected folder, such as /home/admin).

A system update of the Login Enterprise operating environment

Within Login Enterprise, there's a built-in feature in the update menu called 'System update from the Internet.' This option facilitates the download of Linux/Debian security and other updates. We recommend integrating this into your default update schedule for infrastructure servers.

To utilize this update, navigate to the virtual appliance and log in until you see the Maintenance Menu.

  1. In the Maintenance Menu, select Updates.

Frame 145.png

2. In the Updates menu select System update from the internet.

Frame 146.png

Upon selection, it will promptly begin downloading and installing the latest updates from the internet.

Frame 147.png

After completion, press Enter to return to the Maintenance Menu.

For optimal performance, reboot the Login Enterprise virtual appliance after the update completes.

Congratulations, you have now successfully updated the appliance system.

Updating the Launchers

The launchers do not update automatically. You must manually update the launchers, which is a straightforward task. We strongly recommend updating the launchers after each appliance update.

  1. Disable all active environments to prevent them from launching sessions during the update process.
  2. Log in to the launcher machine and close the 'Login Enterprise Launcher' application.
  3. Once completed, you can download the new Launcher files from the Login Enterprise sidebar menu > Launchers > Download launcher setup, e.g. https://myvirtualappliance/configuration/launchers location.

Frame 31.png

4. After downloading, extract the ZIP file and run the 'Setup.msi'.

5. Once installed, you can enable the environments to resume operation, and the appliance will continue from where it left off.

For more information on the Login Enterprise Launcher, see Launchers.