| VMware Smart Assurance Network Configuration Manager 10.1.11 | 31OCT 2023 Check for additions and updates to these release notes. |
Product Description
This hotfix provides information detailing changes or enhancements to Network Configuration Manager Device Services Support (DSr). It also includes information on hardware and software requirements, as well as fixed and known issues.
Note: This hotfix can be installed on NCM versions 10.1.11 or lower. 9.6 is the lowest version supported for this DSr installation.
Related publication
VMware Smart Assurance Network Configuration Manager Device Services Support (DSr) 33.1 Support Matrix.
What's New
New device drivers
No new driver added.
Modified driver
The following driver that has been modified in this release:
-
Cisco Wireless Controller
-
Added support for model C9800-L-C-K9.
-
-
Fortinet FortiManager
-
Modified the model FortiManager-2000E.
-
Software components
This hotfix contains the following third-party software components:
-
SHA256
-
Sort table
Before You Begin
The following prerequisites are needed to upgrade to Network Configuration Manager Device Services Support (DSr) hotfix:
Platform-specific requirements:
-
You must be running Network Configuration Manager Versions 9.5 or later.
-
If you are running any other version lower than Network Configuration Manager 9.5, you must first upgrade to Network Configuration Manager Versions 9.5 or later. For additional hardware and software requirements, refer to the VMware Smart Assurance Network Configuration Manager Installation Guide for Red Hat Enterprise Linux 4 and 5.
Installing Device Services Support(DSr) Hotfix
The installation instructions included in this section are for the Linux, CentOS, Windows Server 2008 R2, Windows Server 2012 and Windows Server 2016 operating environments.
Note: In the examples in both the Install and Uninstall instructions, [Product Directory] is used; however you must substitute [Product Directory] with your actual installation directory path. Windows Server 2008 is only supported on NCM releases prior to 9.5:
-
For both Linux, you can determine your product installation directory by examining /etc/voyence.conf, and looking for the text VOYENCE_HOME.
-
For Windows, you can determine your product installation directory by accessing the Registry key at: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Voyence\Control\Configuration\VOYENCE_HOME.
In Windows environment, if the DSr hotfix installation fails with an error message stating that the Java virtual machine could not be found, you must verify that the PATH system variable under Environment Variables contains the location of the Java installation on your computer. The following sections provide details regarding installing the hotfix in different environments.
Installation instructions for a cluster environment
Use the following steps to install this hotfix for a cluster environment on an application or device server.
Note: If any files in the custom package folder conflict with files in the DSr Hotfix, a warning appears. For cluster environment DSR should be installed on both Application Server and Device Server.
On an application server (Linux)
Follow these steps :
| Step |
Action |
Command |
|---|---|---|
| 1 |
Stop the cluster. |
clusvcadm -d [service name]For example: clusvcadm -d app_service |
| 2 |
Mount the disk |
mount [Partition] [Product Directory]For example: mount /dev/sdc1 /opt/smarts-ncm |
| 3 |
Run the DSr Hotfix installer (for Linux or Solaris) |
bash NCM_Device_Drivers_xx_HFy_Linux.bin(Follow the prompts to install.) Where xx is the release number and y is the hotfix number. |
| 4 |
Stop the services. |
/etc/init.d/vcmaster stop |
| 5 |
Unmount the disk. |
umount [Product Directory]("lsof -l [Product Directory]" and stop processes if the drive is busy). |
| 6 |
Start the cluster. |
clusvcadm -e [service name]For example: clusvcadm -e app_service |
On a device server (Linux)
Note: Any jobs in progress on the Device Server will be cancelled.
Follow the step:
| Step |
Action |
Command |
|---|---|---|
| 1 |
Run the DSr Hotfix installer for Linux. |
bash NCM_Device_Drivers_xx_HFy_Linux.binFollow the prompts to install. Where xx is the release number and y is the hotfix number. |
Installation instructions for a non-clustered environment
Use the following steps to install this Hotfix for a non-clustered environment on Linux, Solaris, and Windows.
Note: If any files in the custom package folder conflict with files in the DSr Hotfix, a warning appears.
On an application, device, or combination server (Linux)
Note: Any jobs in progress on the Device Server will be cancelled.
Follow the step:
| Step |
Action |
Command |
|---|---|---|
| 1 |
Run the DSr Hotfix installer. |
bash NCM_Device_Drivers_xx_HFy_Linux.bin. Where xx is the release number and y is the hotfix number. |
On an application, device, or combination server (Windows Server 2003/2008 R2/2012/2016)
Note: Any jobs in progress on the Device Server will be cancelled.
Follow these steps:
| Step |
Action |
Command |
|---|---|---|
| 1 |
Run the .exe file. |
Double-click the NCM_Device_Drivers_xx_HFy_Windows.exe file. Where xx is the release number and y is the hotfix number. |
| 2 |
The installer will load. |
Follow the prompts by clicking Next. |
| 3 |
The install is complete. |
Click Done when the install completes. |
Verifying the installation
To verify the Network Configuration Manager Device Services Support (DSr) Hotfix installation, follow these steps:
| Step |
Action |
Command |
|---|---|---|
| 1 |
Open the Help menu. |
Click the Help option on the Network Configuration Manager menu bar. |
| 2 |
Open the About window. |
Select About. The About VMware Smart Assurance Network Configuration Manager window will open. |
| 3 |
Verify the version of the Device Services release. |
The version of this release is displayed. |
Uninstalling Device Services Support (DSr) Hotfix
The uninstall process reverts all files modified by the Device Services Support (DSr) Hotfix installation to their pre-installation state.Only use these uninstall procedures if you are sure you want to uninstall Device Services Support (DSr) Hotfix.
Note: In the examples in both the Install and Uninstall instructions, [Product Directory] is used; however you must substitute [Product Directory] with your actual installation directory path.
-
For both Linux you can determine your product installation directory by examining /etc/voyence.conf, and looking for the text VOYENCE_HOME.
-
For Windows, you can determine your product installation directory by accessing the Registry key at: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Voyence\Control\Configuration\VOYENCE_HOME. The following sections provide details regarding installing the hotfix in different environments:
Uninstall instructions for a cluster environment
Use the following steps to uninstall this Hotfix for a clustered environment on Linux and Windows.
On an application server (Linux only)
Follow these steps to uninstall this Hotfix:
| Step |
Action |
Command |
|---|---|---|
| 1 |
Stop the cluster. |
clusvcadm -d [service name]For example: clusvcadm -d app_service |
| 2 |
Mount the disk. |
mount [Partition] [Product Directory]For example: mount /dev/sdc1 /opt/smarts-ncm |
| 3 |
Navigate to the Hotfix directory. |
cd [Product Directory]/software/Uninstall_Device_Drivers_HF/ |
| 4 |
Run the Hotfix Uninstall script. |
bash Uninstall_Network_Configuration_Manager_Device_Drivers |
| 5 |
Stop the services. |
/etc/init.d/vcmaster stop |
| 6 |
Navigate to the root directory. |
cd/ |
| 7 |
Unmount the disk. |
umount [Product Directory]("lsof -l [Product Directory]" and stop processes if the drive is busy) |
| 8 |
Start the cluster. |
clusvcadm -e [service name]For example: clusvcadm -e app_service |
On a device server
Follow these steps to uninstall this Hotfix:
| Step |
Action |
Command |
|---|---|---|
| 1 |
Navigate to the Hotfix directory. |
cd [Product Directory]/software/Uninstall_Device_Drivers_HF/ |
| 2 |
Run the Hotfix Uninstall script. |
bash Uninstall_Network_Configuration_Manager_Device_Drivers |
Uninstall instructions for a non-clustered environment
Use the following steps to uninstall this Hotfix for a non-clustered environment on Linux and Windows.
On an application, device, or combination server (Linux)
Follow these steps to uninstall this Hotfix:
| Step |
Action |
Command |
|---|---|---|
| 1 |
Navigate to the Hotfix directory. |
cd [Product Directory]/software/Uninstall_Device_Drivers_HF/ |
| 2 |
Run the Hotfix Uninstall script. |
bash Uninstall_Network_Configuration_Manager_Device_Drivers |
On an application, device, or combination server (Linux) for NCM 9.5.1 onwards
Note: This section is only applicable for the NCM base release 9.5.1 onwards.
To uninstall the Hotfix completely, you must extract the jre-dsr.tar.gz files manually before uninstalling the Hotfix.Follow these steps to uninstall this Hotfix:
| Step |
Action |
Command |
|---|---|---|
| 1 |
Navigate to the Hotfix directory. |
cd [Product Directory]/software/Uninstall_Device_Drivers_HF/ |
| 2 |
Unzip the folder. |
Unzip jre-dsr.tar.gz folder in the following location:$VOYENCE_HOME/jre-dsr.tar.gz |
| 3 |
Run the Hotfix Uninstall script. |
bash Uninstall_Network_Configuration_Manager_Device_Drivers |
On an application, device, or combination server (Windows only)
Follow these steps to uninstall this Hotfix:
| Step |
Action |
Command |
|---|---|---|
| 1 |
Open Add or Remove Programs. |
Open Add or Remove Programs located under the Control Panel in Windows. |
| 2 |
Run the Hotfix Uninstaller. |
|
On an application, device, or combination server (Windows) for NCM 9.5.1 onwards
Note: This section is only applicable for the NCM base release 9.5.1 onwards.
To uninstall the Hotfix completely, you must extract the jre-dsr.zip files manually before uninstalling the Hotfix.Follow these steps to uninstall this Hotfix:
| Step |
Action |
Command |
|---|---|---|
| 1 |
Navigate to the Hotfix directory. |
[Product Directory] |
| 2 |
Unzip the folder. |
Unzip jre-dsr.zip folder. |
| 3 |
Navigate to the Hotfix directory. |
[Product Directory]/software/Uninstall_Device_Drivers_HF/ |
| 4 |
Run the Hotfix Uninstaller |
Double-click Uninstall VMware Smart Assurance Network Configuration Manager Device Drivers.exe to start the uninstall process. This portion of the uninstaller may take several minutes |
Verifying the uninstall
To verify Network Configuration Manager Device Services Support (DSr) Hotfix is uninstalled, follow these steps:
| Step |
Action |
Command |
|---|---|---|
| 1 |
Open the Help menu. |
Click the Help option on the Network Configuration Manager menu bar. |
| 2 |
Open the About window. |
Select About. The About VMware Smart Assurance Network Configuration Manager window will open. |
| 3 |
Verify the version of the Device Services release. |
The previous version of DSr installed on your machine is displayed. |
