Loading

×Sorry to interrupt
Uncaught ReferenceError: addCTracking is not defined
throws at https://kb.vmware.com/resource/KM_TealiumTrackingJS?v=0.5:100:1

Refresh

Cookie Preference Center

General Information on cookies

When you visit our website, we use cookies to ensure that we give you the best experience. This information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies by clicking on the different category headings to find out more and change your settings. However, blocking some types of cookies may impact your experience on the site and the services we are able to offer. Further information can be found in our

Cookie Policy.

Strictly Necessary

Strictly Necessary

Always Active

Strictly Necessary

Strictly necessary cookies are always enabled since they are essential for our website to function. They enable core functionality such as security, network management, and website accessibility. You can set your browser to block or alert you about these cookies, but this may affect how the website functions. For more information please visit www.aboutcookies.org or www.allaboutcookies.org.

Cookie Details‎

Performance

Performance

Performance

Performance cookies are used to analyze the user experience to improve our website by collecting and reporting information on how you use it. They allow us to know which pages are the most and least popular, see how visitors move around the site, optimize our website and make it easier to navigate.

Cookie Details‎

Please confirm your settings by refreshing the page.

Functional

Functional

Functional

Functional cookies help us keep track of your past browsing choices so we can improve usability and customize your experience. These cookies enable the website to remember your preferred settings, language preferences, location and other customizable elements such as font or text size. If you do not allow these cookies, then some or all of these services may not function properly.

Cookie Details‎

Advertising

Advertising

Advertising

Advertising cookies are used to send you relevant advertising and promotional information. They may be set through our site by third parties to build a profile of your interests and show you relevant advertisements on other sites. These cookies do not directly store personal information, but their function is based on uniquely identifying your browser and internet device.

Cookie Details‎

Advertising Cookies

Consent Leg.Interest

Select All Vendors

Select All Vendors

Select All Hosts

Select All

Clear Filters

Information storage and access

Apply

Confirm My Choices Reject All Allow All

My Subscriptions

Loading

Knowledge Base

How to upgrade an NSX NDR appliance (formerly Lastline) to the Ubuntu 18.04 Bionic distribution (900004)

Last Updated: 9/15/2023Categories: InformationalTotal Views: 4089Language:
English

7 like this article

Subscribe to get an email
newsletter with new updates

7 people found this helpful Please provide article feedback:

Details

Summary

Starting with releases 2020.8 (hosted) and 9.4 (on-premises) VMware will release the Ubuntu 18.04 (Bionic) distribution upgrade for customers. This guide shows you how to upgrade your NSX NDR appliance from Ubuntu 16.04 (Xenial) to Ubuntu 18.04 (Bionic).

In this article, there are 2 sections that need to be followed for each NSX NDR appliance, the details are in the below sections:wil

Section 1.1: Prepare to Upgrade to Ubuntu Bionic 18.04 release

Section 2.1: Upgrade steps from Xenial to Bionic

Distribution upgrades require several steps and can be a complex operation. Please read the document completely before proceeding and follow the steps carefully.

IMPORTANT: VMware Technical Support will only provide support for this upgrade on a best-effort basis. The underlying OS distributions for Xenial (and prior) releases are no longer supported by Ubuntu and therefore also not supported by VMware's Engineering teams. Best-effort assistance by the VMware Technical Support team for the Xenial to Bionic upgrade will continue but if the problem cannot be solved within support, then the only option is to re-image the appliance with the latest version ISO will be offered.

Upgrading from previous Ubuntu distribution versions

If your Lastline appliances are running on versions older than Xenial 16.04, you need to upgrade the distribution to Xenial before these steps can be followed. Please see the upgrade overview guides in our Knowledge Base below.

To upgrade from Trusty to Xenial: No longer supported, you must re-install the latest ISO file.

To upgrade from Precise to Trusty: No longer supported, you must re-install the latest ISO file.

Note: Upgrading across multiple distributions is not recommended and is extremely time-intensive. If you are on a distribution older than Xenial, to avoid problems, we recommend migrating to a fresh Lastline Bionic 18.04 version by installing the system from scratch using the latest ISO file.

Please plan your maintenance windows accordingly based on the size of your environment and how many appliances will need to be upgraded. This process will require the appliances to be rebooted and some interruption is expected. It will take an average of 60 minutes per appliance (not including the preparation steps). All ISO installers from 1220 and later are already on the Ubuntu 18.04 (Bionic) release and do not need to follow this process.

1.1 Prepare to Upgrade to Ubuntu Bionic 18.04 release

The steps required in this article require root privileges. Be sure to run the steps below as root or with the sudo prefix.

In order to prepare your Lastline appliance for upgrade, this section will outline the following steps:

Install Updates

Understand the upgrade order for On-Premise appliances

Backup your On-Premise manager appliance (optional, but recommended).

Other preparation steps

Install Updates

The upgrade to the Ubuntu Bionic release requires that your Lastline appliance is first updated to the appliance versions mentioned in this chart.

Product

Required Version

Ready to upgrade to Bionic?

Sensor (Hosted)

1220

Yes

Analyst (On-Prem)

1110.8

Yes

Manager (On-Prem)

1110.8

Yes

Standby Manager (On-Prem)

N/A

No, a standby appliance must be reinstalled after the primary manager has been upgraded to Bionic. Upgrading a standby manager is not supported.

Data Node (On-Prem)

1110.8

Yes

Engine (On-Prem)

1110.8

Yes

Sensor (On-Prem)

1221.8

Yes

Pinbox (On-Prem)

1110.8.4

Yes

If your appliances are not on the versions listed in the above table, please upgrade each appliance using the Quick Links->Upgrade button on the Appliance Overview screen as needed.

You can also use the Batch Upgrade button if more than one appliance needs to be updated to a new Lastline version.

Understand the upgrade order for On-Premise appliances

The recommended upgrade order for On-Premise appliances is listed below. These appliances should be upgraded one at a time unless otherwise noted.

Manager/Pinbox/Analyst

Engine(s)

Data Node(s) and Sensor(s) - these can be done simultaneously if needed

Backup your On-Premise manager appliance (optional, but recommended)

It’s a good idea to backup your appliances before performing a major distribution upgrade. If anything goes wrong during the upgrade process, you have a recovery option should it be needed. Please review the Backup Page from the Lastline Portal Guide in your environment or on our hosted portal for instructions on configuring a backup.

Other preparation steps (for each appliance):

We recommend following these steps to verify that each appliance is meeting the recommended versions and that all appliances are in a Healthy state prior to beginning the upgrade steps.

Verify the Manager, Analyst, Pinbox, or Hosted Sensor has the current GPG key/SSL Key as described in the article here. This does not need to be applied to the Engine or Data Node

Verify that your appliance is on the Ubuntu Xenial 16.04 release. This can be done by checking one of the following:

By running the following command on the Command Line Interface (CLI):

lsb_release -a

Or from the Lastline UI, open the Status of the appliance and look for the “Base Distribution” version

Set the “Auto-Update” toggle to “Disabled” on the appliance (if enabled). Then select the “Save and Deploy” or “Retrigger Configuration” button. Once disabled the system will automatically trigger a configuration update, please wait for this to finish before proceeding. Please see the Portal Guide steps for further information.

Check that the appliance is functional and no ERRORS are reported by the test appliance utility. On the CLI run:

sudo lastline_test_appliance

Note: If you are unable to get your appliance to the minimum supported version prior to the update or your appliance is in an "Error" state, please contact VMware Technical Support if you have any questions before proceeding.

2.1 Upgrade steps from Xenial to Bionic

After completing the preparation steps above, you are now ready to upgrade to the Bionic 18.04 version. Perform the following steps on the Command Line Interface (CLI) of each appliance:

Start the distribution upgrade by running:

sudo lastline_distribution_upgrade

Note: The script will display the steps required during this upgrade. Please enter ‘y’ when prompted on the "Ok to continue" step, when you are ready.

For some appliances, you may be prompted to configure GRUB in some circumstances. Please select the default selection device.
e.g. /dev/sd[x] where sda or sdb is most commonly seen across our customers. Please contact VMware Technical Support if you need any help with this selection.

Once the script completes successfully, the system will require a reboot. Reboot the appliance when prompted by the system. Enter ‘y’ to continue and press “Enter”. Once the system reboots continue to step 3.

Log back into the CLI of the appliance

If you have a VIP (virtual IP) configured, please do this step after the reboot, otherwise skip to step 3.2:

Run lastline_setup

Set a password for ha_password (see Manager Manual)

Set a value for ha_active_priority (see Manager Manual)

Save lastline_setup

Run the distribution upgrade command again:

sudo lastline_distribution_upgrade

Once the system has finished step 3 and applies the final configuration you should see a successful completion

Verify the system is running on Bionic 18.04 by running:

lsb_release -a

Check the NSX Lastline UI to ensure the “Base Distribution” version reports as “Bionic”

Once all steps are completed successfully, re-enable the “Auto-Update” setting. Toggle Auto-Update to “Enabled”

Your appliance is now running the Bionic 18.04 Release.

If you encounter issues or errors during the upgrade

If you encounter errors during the steps above, please do not reboot the system or make any changes until you engage the VMware Technical Support team at VMware Technical Support. Please provide as much of the details possible below to aid in a quick solution:

Describe the step/command where you encountered an issue

Provide a screenshot of the error on the CLI

Provide the appliance UUID, FQDN

Provide the primary account email for your Lastline account

Provide ALL log files in the following directories:

/var/log/lastline/

/var/log/dist-upgrade/

Detectable by VMware SkylineTM

Actions

Copy

link to clipboard
copied!

Print

Language:
English

Attachments

update-gpg-key

Additional Resources

KB
•
End Of General Availability of the Free vSphere Hypervisor (ESXi 7.x and 8.x) (2107518)

KB
•
Download and Install VMware Fusion (2014097)

Results 1-2 of 2

Ask The Community

Get answers quickly from VMware experts in the community

Post Subject

CONTINUE IN COMMUNITIES

Related Products:

VMware NSX Detonator

VMware NSX Defender

Related Versions:

Take Our Survey

Support Assistant