Virtual Appliance Release Notes Version 124.0.0.125 - Netskope Technical Documentation

Release Date: May 27, 2025

This release provides several improvements for Netskope’s Virtual Appliance, such as new features, enhancements, known issues, and fixed issues.

Requirements for Virtual Appliance Version 124.0.0.125

Upgrading to Version 124.0.0.125

Before downloading the upgrade package, ensure the following:

You are running a minimum version of 117.0.0. If you are running appliance versions older than 117.0.0, or if the root (/) partition is less than or equal to 64 GB, you must deploy a new Virtual Appliance and import configurations from the old appliance. To learn more: Install a Virtual Appliance.

There is at least 42 GB of free space on the /opt/ns/upgrades partition where the upgrade package is downloaded. You can delete older versions of the appliance from the upgrades folder to free up disk space.

To learn more: Upgrade the Virtual Appliance.

All the dhcp interfaces on the appliance are configured with a static IP, netmask and gateway.

Export the current appliance configurations to a different host. To learn more: Exporting Configurations.

To verify that the host is reachable, run the following telnet command.

nsappliance> telnet host cz.archive.ubuntu.com port 80
Executing telnet as: ['telnet', 'cz.archive.ubuntu.com', '80']
Trying 217.31.202.63...
Connected to mirror-r-01.nic.cz.
Escape character is '^]'.

Important

Due to space limitations on the /opt/ns/upgrades partition, you must complete the following steps to upgrade to Appliance software version 124.0.0.125.

To upgrade to Appliance software version 124.0.0.125:

Log in to nsshell.
Use the following command to download the appliance software AUP package: upgrade download software version 124.0.0.125
You must delete all other packages. For DPoP, you must delete the urldb, threat-feed, and software packages. For OPLP, you must delete the threat-feed and software packages.
- Use the following commands to see all listed versions of the packages:
  - upgrade urldb list
  - upgrade threat-feed list
  - upgrade software list
- Use the following commands to delete all listed versions:
  
  Note
  
  Do not delete the 124.0.0.125 software package.
  
  For all package types, you must delete the locally available packages. You cannot delete the remotely available packages.
  - upgrade urldb delete version $version
  - upgrade threat-feed delete version $version
  - upgrade software delete version $version
To prepare the software package, run the following commands:
```
upgrade software prepare version 124.0.0.125
upgrade software status prepare
```
If you are unable to prepare the software package, you must contact Netskope Support.
For DPoP, you must download the urldb package before installing Appliance version 124.0.0.125. Use the upgrade urldb list command, then download the latest version with the upgrade urldb download $Version command.
Use the following command to upgrade to Appliance version 124.0.0.125: upgrade software install version 124.0.0.125

The following are the minimum hardware requirements to install and run the Virtual Appliance.

Component	Requirements
Physical RAM	32 GB
Processor	8-Core
Hard disk space	400 GB is the total disk space required across all partitions. This includes 96 GB for storing and processing logs and 304 GB for the root partitions which store the Netskope software, configuration files, and data files. You must increase the disk capacity depending on the size of the logs that are processed daily. For information on increasing the partition size, see “Increase the Size of the Partition” under Optional Configurations topic on the Knowledge Portal. Note Netskope recommends that you increase the disk capacity by 5 times the expected daily log collection size.

Component

Requirements

Physical RAM

32 GB

Processor

8-Core

Hard disk space

400 GB is the total disk space required across all partitions. This includes 96 GB for storing and processing logs and 304 GB for the root partitions which store the Netskope software, configuration files, and data files.

You must increase the disk capacity depending on the size of the logs that are processed daily.

For information on increasing the partition size, see “Increase the Size of the Partition” under Optional Configurations topic on the Knowledge Portal.

Note

Netskope recommends that you increase the disk capacity by 5 times the expected daily log collection size.

Rolling Back Version 124.0.0.125

To roll back Appliance software version 124.0.0.125:

Log in to nsshell and use the following command: rollback software-image
Note that the status for mongodb will be FATAL.
Exit nsshell and select bash using a one-time token.

Run the following commands:

lcgo lcmongo-infrastructure
nsadmin@lcmongo-infrastructure:~$ sudo rm -rf /var/lib/mongodb/*
nsadmin@lcmongo-infrastructure:~$ sudo supervisorctl restart mongodb
mongodb: ERROR (not running)
mongodb: started

Appliance Software Version Support

Netskope Appliance software releases are available every 4-months and will have Netskope support up to two previous versions. Direct software upgrades are supported as long as the “from” and “to” software releases are within two versions apart.

Netskope appliance releases are numbered in the form of X.X.X.X where the Xs represent the major, minor, hotfix, and build release numbers, respectively. For example, appliance release 113.0.0 and older releases are deprecated when appliance release 124.0.0.125 goes live. Release numbers are not sequential like 101, 102, and 103. Instead, release numbers jump numerically, like 117.0.0, 121.0.0, and 124.0.0.125, to reflect parity with the Netskope Cloud Releases.

The following table provides the upgrade path to the latest software version.

Current version	Upgrade to version
Any version before 117.0.0	117.0.0
117.0.0	124.0.0.125
121.0.0	124.0.0.125

Releases that are outside the Netskope support period:

Are not guaranteed to work with the latest cloud releases.
Are no longer tested by Netskope.
Do not receive hotfixes.
Do not receive new feature updates.

At our discretion, we may provide support for releases outside our support period. If a customer encounters an error in a version of software that is other than the latest release, Netskope may require the customer to upgrade to a specified later version to obtain a correction of the error.

Hash Values for Virtual Appliance Installation Files

The following table provides the md5sum and sha256sum values for the Virtual Appliance installer files on VMware ESX, Microsoft Hyper-V, and Linux KVM platforms for version 124.0.0.125.

File Type	md5sum	sha256sum
ESX OVA	ff4d3c96c1cfbee011dbe860c43f0025	a10363c549beff758a4e17aae16f12aa3b6f1c033eeba13c7aa67f1dc8611877
Hyper-V Image	85e77ad9955df58ecfb8190d908fbcff	0d251976c73ba60554b98cce14d587341d4b9a3bd3de8cf995535f03fdf1c8a3
KVM Image	1b63c72e4294c7c66876b4a6409de8de	40a54b018cc8319e3a6918747615a5f70bd859398cd2d01467b262d10cfba1d0

Netskope MIB File

The following is the Netskope MIB file for 124.0.0.125:

NETSKOPE-APPLIANCE-MIB-124.0.0.125 Download