The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This section includes instructions for upgrading your Cisco DCNM Open Virtual Appliance installation in the following scenarios:
You can migrate Cisco DCNM with a local PostgreSQL database and an external Oracle database and Cisco DCNM in a High Availability (HA) environment.
Note Cisco DCNM Release 10.1(x) allows the HA setup for XMPP uses external oracle database. You must provide username and password for external oracle database. Create a new username and password for the XMPP application to use in the same remote Database instance, used by the Cisco DCNM.
Note Before upgrading Cisco DCNM, ensure that automatic failover is disabled. Otherwise, if one server within the federation is down, the devices discovered by the server will be moved to the other DCNM server which comes up first after upgrade. To prevent the automatic failover for DCNM upgrade, you need to disable the automatic failover on all DCNMs within the federation, and then upgrade the DCNM server one by one. Only after all the DCNMs upgrade successfully and run normally, then enable the automatic failover again.
To enable / disable automatic failover, go to Administration > DCNM Server > Federation from DCNM web page, click the check box at top left for Enable Automatic Failover.
Note When upgrading to a newer DCNM version, you should use the same administrative password (as used in the existing setup) for the new DCNM setup. If you want to use a different password in the new setup, change the password in the existing DCNM setup before taking a backup and initiating the upgrade process.
This chapter contains the following:
Perform this procedure if you need to retain the CA signed SSL Certificate after upgrade.
Step 1 Backup the signed certificate from the location
<DCNM_install_root>\dcm\jboss-as-7.2.0.Final\standalone\configuration\fmserver.jks
Step 2 Upgrade to Cisco DCNM Release 10.1(x) based on the requirement.
Step 3 After upgrade, copy the certificate to the same location on the upgraded version of the Cisco DCNM.
Note You must load the certificates to the same location as mentioned in Step 1.
Step 4 Open the following files:
Step 5 Search for key-alias =“sme” and replace with key-alias=<key-alias used to create CA signed SSL Certificate>
Step 6 Restart the DCNM Services.
Before you begin, make sure that Cisco DCNM 7.2(3) or 10.0(x) is up and running.
Step 1 Stop the DCNM services.
Step 2 Run the Cisco DCNM software for Release 10.1(x) executable file.
Upgrade Notification window appears
Step 3 Click OK to begin the upgrade.
Step 4 Click Done after the upgrade is complete.
The Cisco DCNM Release 10.1(x) services will start automatically.
Before you begin, make sure that Cisco DCNM Release 7.2(3) or 10.0(x) is up and running.
Note Cisco DCNM supports Silent installation and upgrade only on Local Authorization mode and not on Remote Authorization mode.
Step 1 Stop the DCNM services.
Step 2 Open the installer.properties file and update the following properties:
Step 3 Go to the directory where you downloaded the Cisco DCNM software and run the appropriate installer by using the following command:
The Cisco DCNM Release 10.1(x) services will start after the upgrade is complete.
Note For Windows upgrade, you can check the status of the upgrade in the Task Manager process.
For Linux upgrade, you can check the status of the upgrade process by using the following command: ps -ef | grep ‘LAX’. The prompt will return after the silent install is complete.
Before you begin, make sure that the Cisco DCNM 7.2(3) or 10.0(x) is up and running.
Note Ensure that both primary and secondary database properties are same.
Step 1 Stop both the primary and secondary DCNM services.
Step 2 On the primary server, run the Cisco DCNM Release 10.1(x) executable file.
Upgrade notification window appears.
Step 3 Click OK to begin the upgrade.
Step 4 On the secondary server, perform run the Cisco DCNM Release 10.1(x) executable file.
Upgrade notification window appears.
Step 5 Click OK to begin the upgrade.
Step 6 On the primary server, click Done after the upgrade is complete.
The Cisco DCNM Release 10.1(x) services will start automatically on the primary server.
Step 7 On the secondary server, click Done after the upgrade is complete.
The Cisco DCNM Release 10.1(x) services will start automatically on the secondary server.
Before you begin, make sure that the Cisco DCNM 7.2(3) or 10.0(x) is up and running.
Note Cisco DCNM supports Silent installation and upgrade only on Local Authorization mode and not on Remote Authorization mode.
Note Ensure that both primary and secondary database properties are same.
Step 1 Stop both the primary and secondary DCNM services.
Step 2 On the primary server, open the installer.properties file and update the following properties:
Step 3 Go to the directory where you downloaded the Cisco DCNM software and run the appropriate installer by using the following command:
Note For Windows upgrade, you can check the status of the upgrade in the Task Manager process.
For Linux upgrade, you can check the status of the upgrade process by using the following command: ps -ef | grep ‘LAX’. The prompt will return after the silent install is complete.
Step 4 On the secondary server, open the installer.properties file and update the following properties:
Step 5 Go to the directory where you downloaded the Cisco DCNM software and run the appropriate installer by using the following command:
Step 6 On the primary server, click Done after the upgrade is complete.
The Cisco DCNM Release 10.1(x) services will start automatically on the primary server.
Step 7 On the secondary server, click Done after the upgrade is complete.
The Cisco DCNM Release 10.1(x) services will start automatically on the secondary server.
Before you begin, make sure that Cisco DCNM 7.2(3) or 10.0(x) is up and running.
When upgrading from DCNM Release 10.0(1) to 10.1(2), ensure that you follow additional steps before and after the upgrade process to avoid loss of information.
Before the upgrade - Note down the names of the fabrics that you have created in the 10.0(1) release. In the DCNM GUI, go to Configure > LAN Fabric Settings > LAN Fabrics to see the list of fabrics.
Step 1 Use the appmgr backup all command to backup all applications associated with the installation of Cisco DCNM 10.0(x).
A prompt appears to provide the DCNM DB password and XMPP DB password. By default, this password is the administrative password provided during the Open Virtual Appliance installation.
Step 2 On Cisco DCNM 10.1(x), ensure that the MAC addresses along with all network settings such as the IP address, default gateway, hostname, etc., are identical to the Cisco DCNM 10.0(x) installation.
Step 3 Transfer the backup file to an external file system.
Step 4 Power off Cisco DCNM 10.0(x).
Step 5 Deploy the Cisco DCNM Open Virtual Appliance file for version 10.1(x).
Step 6 After Cisco DCNM 10.1(x) is deployed, right-click on VM > Edit Settings > Hardware.
For both Network Adapters, update the MAC address to be the same as Cisco DCNM 10.0(x). This ensures that the same MAC address is used for the new Virtual Machine (VM); licenses on Cisco DCNM will not need to be regenerated in the event of an upgrade.
Step 7 Power on DCNM 10.1(x) VM.
Step 8 Copy the Cisco DCNM 10.0(x) backup file from the external repository to Cisco DCNM 10.1(x).
Step 9 Use the appmgr status all status all command to make sure that all applications are up and running.
Step 10 Use the appmgr stop all to shut down all applications on Cisco DCNM 10.1(x).
Step 11 Use the appmgr upgrade <backup filename> command to run the upgrade script on Cisco DCNM 10.1(x).
The application displays the following message:
If you choose option [1] Standalone DCNM with Local PostgreSQL database, It will get upgraded successfully.
If you choose option [2] Standalone DCNM with External Oracle database, ensure that the external database is up and running. For more information, see Upgrading Cisco DCNM Virtual Appliance with External Oracle Database.
After the upgrade - If you upgraded from DCNM Release 10.0(1) to 10.1(2), do the following:
Step 1 Create a dfa.conf file for each fabric in the list of fabrics that you noted before the upgrade process.
touch /var/lib/dcnm/< fabric-name >-dfa.conf
Step 2 For each fabric, add the include statement in the dhcpd.conf file located in the /var/lib/dcnm folder.
include “/var/lib/dcnm/< fabric-name >-dfa.conf”;
Step 3 Open the dcnm-dfa.conf file.
vi /var/lib/dcnm/dcnm-dfa.conf
Step 4 In the dcnm-dfa.conf file, delete DHCP scopes relating to the user defined LAN fabrics.
Step 5 In the DCNM GUI ( Configure > LAN Fabric Automation > Networks ), update the range for the respective fabric scopes. You can use the deleted range from the previous step.
Perform the following procedure to upgrade Cisco DCNM Virtual Appliance with external Oracle database.
Note Ensure that you configure the timezone after installation or upgrade, before performing any other operations on the Cisco DCNM Appliance. For more information, see Setting the Timezone for Cisco DCNM Virtual Appliances.
When you select Option [2] in Step 12 of the procedure Upgrading Cisco DCNM Virtual Appliance with Local PostgreSQL Database, the following query appears:
Prior to upgrade, we strongly advise that you make a backup of your remote Oracle instance. Do you want to proceed with upgrade?
Press 'y' to continue [y/n] [n]
Enter it again for verification:
Step 5 Enter the administrative password provided during Virtual Appliance installation, when prompted for the root password.
The external DCNM database will be configured to access all the Fabric applications using the root password of this server.
Note You can change the password using the Cisco DCNM Web Client. To change the password, choose Administration > Management Users > Local.
Note Upgrading from Non-DFA to Cisco DCNM 10.1(1) with a Local PostgreSQL or External Oracle Database. Deploy the Cisco DCNM 10.1(1) with the Enhanced Fabric Management Network fields with default values (i.e., IP Address: 0.0.0.0, Subnet Mask: 0.0.0.0 and DNS IP: 1.1.1.1). Perform the procedure detailed in Upgrading Cisco DCNM Virtual Appliance with External Oracle Database.
Note Ensure that you configure the timezone after installation or upgrade, before performing any other operations on the Cisco DCNM Appliance. For more information, see Setting the Timezone for Cisco DCNM Virtual Appliances.
Before you begin, make sure that both the Cisco DCNM 7.2(x) Active and Standby peers are up and running.
Note For more information on Active and Standby peers in a High Availability environment, see “Managing Applications in a High-Availability Environment”.
Step 1 Verify if the appmgr backup all command was executed on both the Active and Standby peers. Check if separate tar archives are stored in an external file system.
Note If it is the non-DFA environment, please verify if the appmgr backup dcnm command was executed on both the Active and Standby peers.
Step 2 Power off the Cisco DCNM 7.2(x) Active peer.
Step 3 Power-on the Cisco DCNM 10.1(x) Active peer.
Step 4 Use the appmgr status all command to ensure that all the applications are up and running on the Cisco DCNM 10.1(x) Active peer.
Step 5 Stop all DCNM applications on the Cisco DCNM 10.1(x) Active peer, by using appmgr stop all command.
Step 6 Use the appmgr upgrade <active.tar.gz> command to run the upgrade script.
Step 7 Power off the Cisco DCNM 7.2(x) Standby peer.
Step 8 Power on the Cisco DCNM 10.1(x) Standby peer. Use the appmgr status all command to make sure that all applications are up and running.
Step 9 Stop all applications on the Cisco DCNM 10.1(x) Standby peer.
Step 10 Run the below NTP command on the standby to synchronize the time.
ntpdate -b -u NTP_SERVER_IPADDRESS
Step 11 Use the appmgr upgrade <standby.tar.gz> command to run the upgrade script on the Cisco DCNM 10.1(x) Standby peer.
a. Choose option [3] High Availability when prompted.
b. Select option [2] Standby when prompted.
To migrate the standby peer, perform the following:
a. Enter the active eth0 IP address.
Step 12 Invoke the following on the Active peer to establish SSH trust to the Standby peer:
Step 13 Restart the active Cisco DCNM, using the appmgr restart dcnm command.
Note Ensure that you configure the timezone after installation or upgrade, before performing any other operations on the Cisco DCNM Appliance. For more information, see Setting the Timezone for Cisco DCNM Virtual Appliances.
Before you begin, make sure that virtual appliance should be installed in Non Programmable Fabric mode.
Note For instruction about installing these applications with the Cisco DCNM Open Virtual Appliance, see DCNM installation without Enhanced Fabric Management capabilities.
For more information on NON DFA High Availability environment, see Managing Applications in a High-Availability Environment.
Step 1 Make sure that both Cisco DCNM 10.0(x) servers are deployed, powered on and made it as a First and Federated node by using the below commands.
appmgr setup ha -type first-node
appmgr setup ha -type federated-node
Step 2 Verify if the appmgr backup dcnm command was executed on both the First Node and Federated Node using the below command. Check if separate tar archives are stored in an external file system.
Step 3 Power off the Cisco DCNM 10.0(x) First and Federated Node virtual appliance.
Step 4 Power-on the Cisco DCNM 10.1(x) First and Federated Node virtual appliance which should be deployed in the same eth0 IP of 10.0(x).
Note While deploying Cisco DCNM 10.1(x) First and Federated Node virtual appliance, the Enhanced Fabric Management Network fields must contain default values (i.e., IP Address:0.0.0.0, Subnet Mask:0.0.0.0 and DNS IP:1.1.1.1)
Step 5 Use the appmgr status all command to ensure that DCNM applications are up and running on the Cisco DCNM 10.1(x) First and Federated Nodes.
Step 6 Stop the applications on the Cisco DCNM 10.1(x) First node, by using appmgr stop dcnm command.
Step 7 Use the command appmgr upgrade <first_node.tar.gz> on the Cisco DCNM 10.0(x) First node to run the upgrade script. After issuing appmgr upgrade <first_node.tar.gz> on First Node, user will be prompted for various inputs. Provide the inputs as per the sample given below.
Step 8 Stop DCNM applications on the Cisco DCNM 10.1(x) Federated Node by using appmgr stop dcnm command.
Step 9 Run the below NTP command on standby to sync the time.
Step 10 Use the appmgr upgrade <federated_node.tar.gz> command to run the upgrade script on the Cisco DCNM 10.1(x) Federated Node. After issuing appmgr upgrade <first_node.tar.gz> on First Node, user will be prompted for various inputs. Provide the inputs as per the sample given below.
Step 11 Verify whether HA Federation enabled after upgrade using appmgr show ha-role command.
Perform the following to upgrade the Cisco DCNM Native HA appliances from Release 10.0(x) to Release 10.1(x).
Before you begin, ensure that both the Cisco DCNM 10.0(1) Active and Standby peers are up and running.
Step 1 Verify if the appmgr backup all command was executed on both the Active and Standby peers. Check if separate .tar archives are stored in an external file system.
Note Ensure that you have taken a backup of /root/packaged-files/properties/ha-setup.properties file in Native HA. Otherwise, manually save a copy from DCNM 10.0(1) Active host to a local repository.
Step 2 Power off the Cisco DCNM 10.0(1) Standby host first and then power off the Active host.
Step 3 Power on the Cisco DCNM 10.1(1) Active host, and then power on the Standby host with the same IP and MAC address.
If both eth0 and eth1 interfaces are in the same subnet, edit the /etc/sysctl.conf file for DCNM ISO Virtual appliance Native HA installation on both active and standby nodes for both the appliances, as follows:
Save and close the file. On the SSH terminal, execute the sysctl --system command.
Step 4 Ensure that all the applications are up and running on the Cisco DCNM 10.1(1) Active host. Use the appmgr status all command to ensure that
Note Replace the file /root/packaged-files/properties/ha-setup.properties on DCNM 10.1(1) Active host, with the backup file from DCNM 10.0(1) Active Host.
Step 5 Stop all the DCNM applications on the Cisco DCNM 10.1(1) Active host, by using appmgr stop all command.
Step 6 Transfer the backup file from the external file system to the corresponding setup.
Step 7 Run the upgrade script on the Active host, by using the appmgr upgrade <active.tar.gz> command.
Step 8 Provide the inputs as per the sample given below.
Step 9 Stop all the DCNM applications on the Cisco DCNM 10.1(1) Standby host, by using appmgr stop all command.
Step 10 Run the upgrade script on the Standby host, by using the appmgr upgrade <standby.tar.gz> command.
Step 11 Provide the inputs as per the sample given below.
Utility scripts for Local PostgreSQL database that is installed in RHEL machine are:
Utility scripts for Local PG database that is installed in Windows machine are:
Irrespective of the platform, Cisco DCNM is installed (Windows or Linux), the following scripts to backup and restore the remote Oracle database.
Utility scripts for Oracle database that is installed on Linux platform are;
Utility scripts for Oracle database that is installed on Windows platform are:
2. restore-remote-oracledb.bat
Cisco DCNM host is configured to run with a remote Oracle database. As part of housekeeping, you can copy DCNM utility scripts to a remote Oracle database and restore the DCNM database schema.
To run the utility scripts, you need the database administrator credentials. These scripts will prompt you for:
1. DCNM database password (the user name is already present)
2. Username/password of the admin user.
While entering the DBA user credentials, ensure that you do not to enter “sys” as sysdba" because in some versions of Oracle, the presence of space might cause the backup/restore to fail. Instead, user should provide valid user credentials that does not have a space in the user name, for example, system or sysdba. The admin credentials are not saved/cached and hence they do not leak sensitive credential information.
Note User scripts under dcnm/bin can be run only by administrator user.