Important notice on upgrading Login Enterprise
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
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.
Important notice on upgrading Login Enterprise
When upgrading your Login Enterprise Virtual Appliance, it’s essential to follow a recommended upgrade path based on your current version and the underlying Debian version. This will help ensure a smoother transition and minimize potential compatibility issues.
Recommended upgrade path:
-
From 3.x:
Upgrade to 4.0-4.6 (Debian 9)
Then to 4.7-5.8 (Debian 10)
Finally to 5.9-5.13 (Debian 12) -
From 4.0:
Upgrade to the highest version on Debian 10 (5.8)
Then proceed to 5.9-5.13 (Debian 12)
Key notes:
- Upgrading directly from versions 3.x or 4.0 to 5.13 without following this path is not recommended, as updates from Debian 9 to 12 are unsupported.
- While you can choose to stay on an older Debian version, for example, Debian 9 or 10 when running Login Enterprise 5.13, updating Debian is strongly recommended for optimal performance and security.
Important considerations:
- The upgrade will not migrate the old license from the 3.x legacy database, nor will it carry over SLA report schedules configured in 4.0. After upgrading, you will need to upload a new license due to format changes and reconfigure your SLA report schedules (This only applies when updating from 3.x/4.0 directly to 5.13).
- Please review the release notes for any version-specific updates or changes.
If you have any questions or concerns about updating the Virtual Appliance, feel free to contact our support at support@loginvsi.com.
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:
An online update of the Login Enterprise
- Open the Appliance console and log in to access the Maintenance Menu.
- In the Maintenance Menu, select Updates.
3. In the Updates menu, select Update from the internet.
4. Wait until the ISO file download is complete.
5. Afterward, you'll see the following message:
Press Y to perform the update, or N to keep the current version.
6. Press Enter to continue.
7. Press Y to continue with the update.
8. Press Y to perform database maintenance or N to skip it.
9. Press Y for a system OS update or N to skip it.
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.
- In the Maintenance Menu, select Updates.
2. In the Updates menu, select Update from ISO.
Afterward, you'll see the following message:
3. After pressing Enter, you'll be prompted to confirm the update.
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.
- Using an SFTP client (such as WinSCP, ensuring you specify the SFTP protocol), upload the Login Enterprise update ISO to the /tmp directory.
- 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.
- Create the mount directory if it does not already exist:
mkdir /mnt/cdrom
- Mount the ISO you uploaded.
mount -o loop /tmp/enterprise-update.iso /mnt/cdrom
- Once that file is mounted, run the update process manually with this command:
loginvsid update offline
- 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.
- In the Maintenance Menu, select Updates.
2. In the Updates menu select System update from the internet.
Upon selection, it will promptly begin downloading and installing the latest updates from the internet.
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 Launchers
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.
- Disable all active environments to prevent them from launching sessions during the update process.
- Log in to the Launcher machine and close the 'Login Enterprise Launcher' application.
- 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.
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.
Additional resources
- For information on the Login Enterprise Launcher, see the Login Enterprise Windows Launcher.
- For information on the Debian update, see Updating Debian.
- For the Login Enterprise licensing information and updates, see Licensing.
- To learn about SLA reporting, see the SLA report.