Installing or Upgrading the Cisco Nexus Data Broker Software in Centralized Mode
Before proceeding with the installation, check the System Requirements section in the Overview chapter of this guide.
In Cisco NDB Release 3.10, JRE is unbundled from the NDB package. You need to install Java on the NDB server before starting NDB 3.10.0.
![]() Note |
Only Oracle Java is supported. |
-
Install Java version greater then 1.8.0_45
-
Set JAVA_HOME environment variable; command to be used- export JAVA_HOME=(jre_path)
Installing the Cisco Nexus Data Broker Software in Centralized Mode
Complete these steps to install Cisco Nexus Data Broker software in Centralized mode:
Procedure
Step 1 |
In a web browser, navigate to www.cisco.com. |
||||
Step 2 |
Under Support, click All Downloads. |
||||
Step 3 |
In the center pane, click Cloud and Systems Management. |
||||
Step 4 |
If prompted, enter your Cisco.com username and password to log in. |
||||
Step 5 |
In the right pane, click Network Controllers and Applications, and then click Cisco Nexus Data Broker. The file information for Release 3.10 is displayed: Cisco Nexus Data Broker Software Application: ndb1000-sw-app-k9-3.10.0.zip |
||||
Step 6 |
Download the Cisco Nexus Data Broker application bundle. |
||||
Step 7 |
Create a directory in your Linux machine where you plan to install Cisco Nexus Data Broker. For example, in your Home directory, create CiscoNDB. |
||||
Step 8 |
Copy the Cisco Nexus Data Broker zip file into the directory that you created. |
||||
Step 9 |
Unzip the Cisco Nexus Data Broker zip file. The Cisco Nexus Data Broker software is installed in a directory called ndb. The directory contains the following:
|
||||
Step 10 |
Start the NDB application using |
Upgrading the Application Software in Centralized Mode Using CLI
Use the upgrade command to upgrade to Cisco NDB Release 3.10.0.
![]() Note |
|
Hitless Upgrade
For hitless upgrade, configuration backup for releases prior to NDB Release 3.8, will always be the standard upgrade by re-configuring the devices during the upgrade.
Configuration backup taken for releases NDB 3.8 and after, will always be a Hitless upgrade using CLI.
Before you begin
-
Backup up the NDB configuration. See the Backup/ Restore section in the Cisco Nexus Data Broker Configuration Guide.
-
Back up your config.ini file.
![]() Important |
You should manually backup your config.ini file before upgrading, because the backup process does not back them up for you. If you do not backup your files before upgrading, any changes you made will be lost. |
![]() Note |
When you run runndb.sh script, there is a thread in the script that monitors the log and the Cisco Nexus Data Broker JAVA process to monitor the health of the Cisco Nexus Data Broker. The default value for this option is 30 Seconds. |
Procedure
Step 1 |
Backup your Cisco Nexus Data Broker release installation using your standard backup procedures. |
||||||||||||||
Step 2 |
In a web browser, navigate to Cisco.com. |
||||||||||||||
Step 3 |
Under Support, click All Downloads. |
||||||||||||||
Step 4 |
In the center pane, click Cloud and Systems Management. |
||||||||||||||
Step 5 |
In the right pane, click Network Controllers and Applications, and then click Cisco Nexus Data Broker. |
||||||||||||||
Step 6 |
Download the Cisco NDB Release 3.10 applicable bundle: Cisco Nexus Data Broker Software Application—ndb1000-sw-app-k9-3.10.0.zip |
||||||||||||||
Step 7 |
Create a temporary directory in your Linux machine where you plan to upgrade to Cisco NDB. |
||||||||||||||
Step 8 |
Unzip the Cisco NDB Release 3.10 zip file into the temporary directory that you created. |
||||||||||||||
Step 9 |
Navigate to the ndb directory that was created when you installed the Cisco Nexus Data Broker release (created in the previous step). |
||||||||||||||
Step 10 |
Stop the running Cisco Nexus Data Broker instance. |
||||||||||||||
Step 11 |
Navigate to the ndb/bin directory in the temporary directory that you created for Cisco NDB Release 3.10 upgrade software. |
||||||||||||||
Step 12 |
Upgrade the application by entering the ./ndb upgrade --perform --target-home {ndb_directory_to_be_upgraded} [--verbose] [--backupfile {ndb_backup_location_and_zip_filename}] command. You can use one of the following options:
|
||||||||||||||
Step 13 |
Navigate to the older folder (xnc in releases prior to Release 3.10) where you originally installed Cisco NDB. Rename the folder from xnc to ndb. |
||||||||||||||
Step 14 |
Start the application processes using runndb.sh -start. |
Upgrading the Application Software in Centralized Mode Using GUI
![]() Note |
The latest NDB zip file must be extracted in an empty directory. |
Hitless Upgrade
For hitless upgrade, configuration backup for releases prior to NDB Release 3.8, will always be the standard upgrade by re-configuring the devices during the upgrade.
Configuration backup taken for releases NDB 3.8 and after, will always be a Hitless upgrade using CLI.
Complete the following steps to upgrade the application software in the Centralized mode using GUI:
Procedure
Step 1 |
Login to the NDB GUI. |
Step 2 |
Navigate to Administration > Backup/Restore to download the configuration in zip file format. The default name of the zip file is configuration_startup.zip. |
Step 3 |
Stop the current NDB instance using the runxnc.sh -stop command. Example:
|
Step 4 |
If TLS certification is enabled between NDB server and NXOS switch, copy the tlsTrustStore and tlsKeyStore files to /ndb/configuration from the old ndb backup. |
Step 5 |
In a web browser, navigate to Cisco.com. |
Step 6 |
Under Support, click All Downloads. |
Step 7 |
In the center pane, click Cloud and Systems Management. |
Step 8 |
In the right pane, click Network Controllers and Applications, and then click Cisco Nexus Data Broker. |
Step 9 |
Download the Cisco NDB Release 3.10 applicable bundle: Cisco Nexus Data Broker Software Application—ndb1000-sw-app-k9-3.10.0.zip |
Step 10 |
Create a directory in your Linux machine where you plan to upgrade to Cisco NDB. |
Step 11 |
Unzip the Cisco NDB Release 3.10 zip file into the directory that you created. |
Step 12 |
Navigate to the ndb directory that was created when you installed the Cisco Nexus Data Broker release (created in the previous step). |
Step 13 |
Start the new NDB installation using the runndb.sh -start command. Example:
|
Step 14 |
Navigate to Administration > Backup/Restore. |
Step 15 |
To reconfigure the device during the upgrade, select the Restore option (by checking the check-box) during configuration upload. |
Step 16 |
Restart the new NDB instance using the runndb.sh -restart command. Example:
|