Cisco DCNM Installation and Licensing Guide, Release 5.x
Installing and Administering Cisco DCNM VSB
Downloads: This chapterpdf (PDF - 259.0KB) The complete bookPDF (PDF - 3.69MB) | Feedback

Installing and Administering Cisco DCNM VSB

Table Of Contents

Installing and Administering Cisco DCNM VSB

Information About Cisco DCNM VSB

Installing Cisco DCNM VSB

System Requirements

Installing Cisco DCNM VSB

Installing a Cisco DCNM License on a Cisco Nexus 1010 Switch

Using a Silent Installer

Using the GUI to Install the License

Using a Remote Database Server for Standalone and Cluster installations

Using the Remote Database for a Standalone Installation

Using the Remote Database for an HA-Enabled Cluster Mode Installation

Using the Local Database for a Secondary Switch Cluster Installation

Administering the Cisco DCNM VSB

Verifying the Status of a Cisco DCNM VSB

Accessing Cisco DCNM VSB Using the CLI

Deleting a Cisco DCNM VSB

Managing Cisco DCNM VSBs Using the Attachmate Reflection Tool

Using the Attachmate Reflection Tool to Upgrade Cisco DCNM VSBs

Using the Attachmate Reflection Tool to Install Licenses

Using the Attachmate Reflection Tool to Reset User Credentials


Installing and Administering Cisco DCNM VSB


This chapter describes how to install and administer the Cisco Data Center Network Manager Virtual Service Blade (DCNM VSB) on a Cisco Nexus 1010 Virtual Services switch.

This chapter includes the following sections:

Information About Cisco DCNM VSB

Installing Cisco DCNM VSB

Administering the Cisco DCNM VSB

Information About Cisco DCNM VSB

The Cisco Nexus 1010 switch is a shell that hosts multiple Virtual Switch Modules (VSMs) and other service modules such as the Cisco DCNM and Network Analysis Module (NAM) but supresses all of the details about the multiple virtual machines running on a hypervisor. From a network management perspective, the hosted VSMs appear as a cluster. Each Virtual Supervisor Module (VSM) and its associated Virtual Ethernet Modules (VEMs) comprise one virtual switch.

In addition to VSMs, the Cisco Nexus1010 switch can host other service modules. Each of these components is known as a Virtual Service Blade (VSB). The Cisco DCNM VSB enables network administrators to manage the data center LAN infrastructure. The Cisco DCNM VSB is integrated with the Cisco Nexus 1010 switches. The Cisco DCNM VSB extends visibility and interconnects the virtual machines in the Cisco Nexus 1000V switch deployments.

Installing Cisco DCNM VSB

This section describes how to install Cisco DCNM VSB.

This section includes the following topics:

System Requirements

Installing Cisco DCNM VSB

Installing a Cisco DCNM License on a Cisco Nexus 1010 Switch

Using a Remote Database Server for Standalone and Cluster installations

System Requirements

The following table lists the system requirements for the Cisco DCNM VSB.

Table 14-1 Cisco DCNM VSB System Requirements

Component
Recommended Requirements

RAM (free)

4 GB

CPU speed

Dual-processor or dual-core CPU

Disk space (free)

80 GB for standalone installation

40 GB for cluster installation

Operating system

Wind River Linux 3.0


Installing Cisco DCNM VSB

Using the local database for stand alone installation. Figure 14-1 shows local database for stand alone installation.


Note When you install Cisco DCNM as a VSB, only DCNM-LAN server components are installed.


Figure 14-1 DCNM VSB with local database

BEFORE YOU BEGIN

You must log in to the Cisco Nexus 1010 switch using the CLI or a web browser.

DETAILED STEPS


Step 1 Copy the Cisco DCNM ISO file to the bootflash:repository location of the Cisco Nexus 1010 switch.

Step 2 Enter the configuration mode and create a VSB.

virtual-service-blade VSB-NAME
 
   

Step 3 Associate the ISO file with the VSB.

virtual-service-blade-type new FILE-NAME.iso
 
   

Step 4 Initiate the Cisco VSB installation as follows:

virtual-service-blade VSB-NAME

a. Set up a cluster with a redundant Cisco Nexus 1010 switch pair.

n1010(config-vsb-config)# enable

b. Set up a standalone DCNM VSB on the primary Cisco Nexus 1010 switch.

n1010(config-vsb-config)# enable primary

c. Set up a standalone DCNM VSB on the secondary Cisco Nexus 1010 switch.

n1010(config-vsb-config)# enable secondary

Step 5 Enter the name of the VSB image.

Enter vsb image: 
 
   

Step 6 Enter Y to set up a DCNM standalone VSB.

Setup a DCNM Standalone [Y/N]: [N]
 
   

Step 7 Enter the location of the VSB.

Choose the location of VSB[primary/secondary]:[primary]
 
   

Step 8 Enter the hostname.

Enter the hostname: [dcnm-vsb]
 
   

Step 9 Enter the management IP address.

Enter Mgmt IP address: 
 
   

Step 10 Enter the management subnet mask IP address.

Enter Mgmt subnet mask Ip address: [255.255.255.0]
 
   

Step 11 Enter the IP address of the default gateway.

Enter IP address of the default gateway: 
 
   

Step 12 Enter the location of the database.

Specify the location of the database [local/remote]: [local]
 
   

Step 13 Enter the DCNM database username.

Enter database username for DCNM[dcnmuser]: 
 
   

Step 14 Enter the DCNM database password:

Enter database password for DCNM: 
 
   

Step 15 Enter the database administrator username.

Enter database administrator username[admin]: 
 
   

Step 16 Enter the database administrator password

Enter database administrator password: 
 
   

Step 17 Specify whether or not you want to mount the network file system as a data archive.

Mount a network file system as data archive[Y/N]: 

Installing a Cisco DCNM License on a Cisco Nexus 1010 Switch

You can install a Cisco DCNM license on a Virtual Service Blade (VSB) by using one of the two methods:

Using a Silent Installer

Using the GUI to Install the License

Using a Silent Installer

You can use a silent installer on a Cisco Nexus 1010 switch.

BEFORE YOU BEGIN

You must log in to the Cisco Nexus 1010 switch using the CLI or a web browser.

DETAILED STEPS


Step 1 From the Cisco Nexus 1010 switch, log into the VSB.

login virtual-service-blade <name_of_VSB>
 
   

Step 2 Copy the license file to the root directory of the VSB.

In the root directory, you see a link to a script License_Install_DCNM.

Step 3 Execute the script as follows:

sh License_Install_DCNM

Using the GUI to Install the License

BEFORE YOU BEGIN

You must log in to the Cisco Nexus 1010 switch using the CLI or a web browser.

DETAILED STEPS


Step 1 Download the Reflection tool on a Windows machine.

Step 2 Double-click Reflection X Manager.

Step 3 Start a putty session to the VSB.


Note PuTTY is a free and open source terminal emulator application which can act as a client for the SSH, Telnet, rlogin, and raw TCP computing protocols and as a serial console client.


Step 4 From the VSB, enter the following command:

export DISPLAY=<ip_address_of_machine_with_reflection>:0.0 
 
   

Step 5 Open the DCNM installer file.

sh <name_of_DCNM_EXE> 
 
   

The DCNM installation dialog box appears.

Step 6 Choose DCNM-LAN and click Next.

Step 7 Browse to the folder where the license file is available and click Next.

The Cisco DCNM license is now installed.


Using a Remote Database Server for Standalone and Cluster installations

You can use a remote database for both standalone and cluster mode installations. In a standalone installation, you can configure the installation setup to use a remote Oracle database server. In a cluster mode installation, the remote database (PostgreSQL and Oracle) is shared by all of the nodes in the cluster.

Cisco DCNM installs PostgreSQL database on the Cisco Nexus 1010 switch by default. If you want to use an external database server, you can specify the URL instead of choosing the local database. The IP address entries of the slave nodes should exist in the pg_hba.conf file of the database that resides in the data folder where the PostgreSQL database is installed.

This section includes the following topics:

Using the Remote Database for a Standalone Installation

Using the Remote Database for an HA-Enabled Cluster Mode Installation

Using the Local Database for a Secondary Switch Cluster Installation

Using the Remote Database for a Standalone Installation

You can perform a standalone DCNM VSB installation using the remote database. Figure 14-2 shows standalone DCNM VSB installation using the remote database.,

Figure 14-2 DCNM VSB with remote database

BEFORE YOU BEGIN

You must log in to the Cisco Nexus 1010 switch using the CLI or a web browser.

DETAILED STEPS


Step 1 Copy the DCNM ISO file to the bootflash:repository location of the Cisco N1010 switch.

Step 2 Enter the configuration mode and create a VSB.

virtual-service-blade VSB-NAME
 
   

Step 3 Associate the ISO with the VSB.

virtual-service-blade-type new FILE-NAME.iso
 
   

Step 4 Initiate Cisco VSB installation as follows:

virtual-service-blade VSB-NAME

a. Set up a cluster with a redundant Cisco Nexus 1010 pair of switches.

n1010(config-vsb-config)# enable

b. Set up a standalone DCNM VSB on the primary Cisco Nexus 1010 switch.

n1010(config-vsb-config)# enable primary

c. Set up a standalone DCNM VSB on the secondary Cisco Nexus 1010 switch.

n1010(config-vsb-config)# enable secondary

Step 5 Enter the name of the VSB image.

Enter vsb image: 
 
   

Step 6 Enter Y to set up a DCNM standalone VSB.

Setup a DCNM Standalone [Y/N]: 
 
   

Step 7 Enter the location of the VSB

Choose the location of VSB[primary/secondary]:
 
   

Step 8 Enter the hostname.

Enter the hostname: [dcnm-vsb]
 
   

Step 9 Enter the management IP address.

Enter Mgmt IP address: 
 
   

Step 10 Enter the management subnet mask IP address.

Enter Mgmt subnet mask Ip address:
 
   

Step 11 Enter the IP address of the default gateway.

Enter IP address of the default gateway: 
 
   

Step 12 Enter the location of the database.

Specify the location of the database[local/remote]:

Note To use a remote database, you must specify the location of the database as remote.


 
   

Step 13 Enter the URL of the remote database.

Enter URL for remote database: 

Note You must enter the URL of the database in the following format: jdbc:postgresql://192.177.121.11:5432/dcmdb.
The pg_hba.conf file should contain the IP addresses of all the VSB nodes. You can locate the pg_hba.conf file in the PostgreSQL install folder /usr/local/cisco/dcm/db/data.
You must stop and start the database after making any changes to the pg_hba.conf file.


Step 14 Enter the DCNM database username.

Enter database username for DCNM[dcnmuser]: 
 
   

Step 15 Enter the DCNM database password.

Enter database password for DCNM: 
 
   

Step 16 Enter the database administrator username.

Enter database administrator username[admin]: 
 
   

Step 17 Enter the database administrator password.

Enter database administrator password: 
 
   

Step 18 Specify whether or not you want to mount the network file system as data archive.

Mount a network file system as data archive[Y/N]: 

Using the Remote Database for an HA-Enabled Cluster Mode Installation

You can perform an HA-enabled cluster mode DCNM VSB installation by using the remote database. Figure 14-3 shows the two node DCNM cluster.

Figure 14-3 Two node DCNM Cluster

BEFORE YOU BEGIN

You must log in to the Cisco Nexus 1010 switch using the CLI or a web browser.

DETAILED STEPS


Step 1 Copy the DCNM ISO file to the bootflash:repository location of the Cisco Nexus 1010 switch.

Step 2 Enter the configuration mode and create a VSB.

virtual-service-blade VSB-NAME
 
   

Step 3 Associate the ISO with the VSB.

virtual-service-blade-type new FILE-NAME.iso
 
   

Step 4 Initiate Cisco VSB installation as follows:

virtual-service-blade VSB-NAME

a. Set up a standalone DCNM VSB on the primary Cisco Nexus 1010 switch.

n1010(config-vsb-config)# enable primary

Step 5 Enter the name of the VSB image.

Enter vsb image[dcnm-installer.iso]: 
 
   

Step 6 Enter Y to set up a DCNM cluster.

Setup a DCNM Cluster [Y/N]: 

Note For the above scenario select Y for step 6. You must use the remote database and data archive directory on the network file system.


 
   

Step 7 Enter the hostname.

Enter the hostname: [dcnm-vsb]
 
   

Step 8 Enter the management IP address.

Enter Mgmt IP address[172.22.29.123]: 

Note The VSB and the master node must be under the same subnet.


 
   

Step 9 Enter the management IP address for DCNM standby.

Enter Management IP address for DCNM on standby N1010[172.22.29.124]:
 
   

Step 10 Enter the management subnet mask IP address.

Enter Mgmt subnet mask Ip address[255.255.255.0]:
 
   

Step 11 Enter the IP address of the default gateway.

Enter IP address of the default gateway[172.22.29.1]: 
 
   

Step 12 Use default multicast addresses for a cluster.

Use default multicast addresses for cluster (239.255.153.1-239.255.153.4)?[Y|N]:

Note For the first Cisco Nexus 1010 switch you can use the default multicast IP address, but for the second Cisco Nexus 1010 switch it should be same as the first one.



Note If you want to use the default multicast address, enter Y. However, you can override the current set of musticast addresses. If you choose the default settings, you can continue with Step 17.


 
   

Step 13 Enter the multicast IP address for cluster 1.

Enter multicast IP address for cluster (1 of 4)[239.255.153.1]: 
 
   

Step 14 Enter the multicast IP address for cluster 2.

Enter multicast IP address for cluster (2 of 4)[239.255.153.2]: 
 
   

Step 15 Enter the multicast IP address for cluster 3.

Enter multicast IP address for cluster (3 of 4)[239.255.153.3]: 
 
   

Step 16 Enter the multicast IP address for cluster 4.

Enter multicast IP address for cluster (4 of 4)[239.255.153.4]: 
 
   

Step 17 Enter the location of the database.

Specify the location of the database[local/remote]:

Note To use a remote database, you must specify the location of the database as remote.


 
   

Step 18 Enter the URL of the remote database.

Enter URL for remote database[jdbc:postgresql://,ip address of database 
machine>:5432/dcmdb]: 
 
   

Step 19 Enter the DCNM database username.

Enter database username for DCNM[dcnmuser]: 
 
   

Step 20 Enter the DCNM database password.

Enter database password for DCNM[dcnmuser]: 
 
   

Step 21 Enter the database administrator username.

Enter database administrator username[admin]: 
 
   

Step 22 Enter the database administrator password.

Enter database administrator password[admin]: 
 
   

Step 23 Specify whether or not you want to mount the network file system as a data archive.

Mount a network file system as data archive[Y/N]: 
 
   

Step 24 Enter the network file system path to mount.

Enter NFS share path to mount[Ip-Address of data archive machine:<path>]: 

Note If you want to use an Network File System (NFS) server as the repository for archiving configuration files and templates, you must specify the shared location. For example, you can specify 10.77.212.81:/opt/share/dcnm-repository where 10.77.212.81 is the NFS server and /opt/share/dcnm-repository is the shared directory.



Using the Local Database for a Secondary Switch Cluster Installation

BEFORE YOU BEGIN

You must log in to the Cisco Nexus 1010 switch using the CLI or a web browser.

DETAILED STEPS


Step 1 Deploy the secondary VSB using the following command:

virtual-service-blade <VSB_NAME>
enable secondary
 
   

Step 2 Deploy the secondary VSB in the standalone mode. Enter the following information:

Choose the location of VSB[primary/secondary—[primary] secondary

Enter the IP address of the default gateway—Specify the IP address that you wish to configure for the secondary VSB.

Step 3 Once VSB is deployed, uninstall Cisco DCNM in the secondary module using the following command:

login virtual-service-blade <VSB_NAME> secondary
root@dcnm-vsb:/root> ./Stop_DCNM_LAN_Server
Shutdown message has been posted to the server.
Server shutdown may take a while - check logfiles for completion
root@dcnm-vsb:/root> ./Uninstall_DCNM
¢	cd /root
¢	./Stop_DCNM_LAN_Server
¢	./Uninstall_DCNM
 
   

Step 4 Login into the primary VSB and perform the following steps:

a. Change the directory to the postgres database installation using the following command:

	Cd /usr/local/Cisco/dcm/db/data

b. Enter the secondary VSB IP address into the pg_hba.conf file available under /usr/local/Cisco/dcm/db/data.

c. Stop and restart the DCNM server of the primary node to enable the changes.

Step 5 Using SFTP file transfer, copy the installer.properties file available in the primary node under /usr/local/Cisco/dcm/dcnm/config to /root/CSCOdcnm/install in the secondary node VSB.

Step 6 Install Cisco DCNM in the secondary VSB using the following commands:

Cd /root/CSCOdcnm/install
Sh dcnm.bin  -i silent -f installer.properties -DDCNM_IP_ADDRESS=<ip_Address> 
-DDATA_PATH=<Path_Loc>
 
   

Step 7 Once the installation is complete, restart the DCNM server using the following command:

root@dcnm-vsb:/root> ./Start_DCNM_LAN_Server

Administering the Cisco DCNM VSB

The Cisco DCNM installer binary file in the installer package is available at the following location: /root/CSCOdcnm/install. The default data archive location configured during installation is /root/CSCOdcnm/data_archive. You can override this value by specifying a different location during the Cisco DCNM VSB deployment.

The following table shows the soft links that are available in the /root directory of the Cisco DCNM VSB.

Table 14-2 Cisco DCNM Shortcuts

File Name
Purpose

Start_DCNM_LAN_Server

Starts the Cisco DCNM-LAN Server

Stop_DCNM_LAN_Server

Stops the Cisco DCNM-LAN Server

License_Install_DCNM

Installs the license. (You may need to specify the license file)

Uninstall_DCNM

Uninstalls the Cisco DCNM-LAN Server

DCNM_Location

Points to the Cisco DCNM-LAN installation directory


This section includes the following topics:

Verifying the Status of a Cisco DCNM VSB

Accessing Cisco DCNM VSB Using the CLI

Deleting a Cisco DCNM VSB

Verifying the Status of a Cisco DCNM VSB

You can verify the configuration and status of a deployed Cisco DCNM VSB.

DETAILED STEPS

 
Command
Purpose

Step 1 

show virtual-service-blade

Displays all the deployed Cisco DCNM VSBs and the configurations applied to each VSB.

Step 2 

show virtual-service-blade summary

Displays all the deployed Cisco DCNM VSBs and the summary of each VSB.

Step 3 

show virtual-service-blade-type summary

Displays all the Cisco DCNM VSBs that are aligned to a VSB type.

Accessing Cisco DCNM VSB Using the CLI

You can access a deployed Cisco DCNM VSB using the CLI.

DETAILED STEPS

 
Command
Purpose

Step 1 

login virtual-service-blade VSB_NAME [primary/secondary]

Logs in to the respective Cisco DCNM VSB.

Deleting a Cisco DCNM VSB

You can delete a Cisco DCNM VSB.

DETAILED STEPS

 
Command
Purpose

Step 1 

shutdown [primary/secondary]

Powers down the Cisco DCNM VSBs.

Step 2 

no enable [primary/secondary]

Disables the deployed Cisco DCNM VSBs.

Step 3 

no enable force

Force disables the deployed Cisco DCNM VSBs

Step 4 

no virtual-service-blade <VSB_NAME>

Deletes both the primary and secondary Cisco DCNM VSBs.

Managing Cisco DCNM VSBs Using the Attachmate Reflection Tool

Cisco DCNM supports the Attachmate Reflection tool on computers that run windows and connect to VSBs installed on Linux hosts. You can use the Attachmate Reflection tool to upgrade Cisco DCNM VSBs, install licenses, and manage user credentials. You must install the Attachmate Reflection tool on the computer from where you connect to the VSB node.

To access the Cisco DCNM VSB user interface on a computer that runs Windows, enter the following command on the VSB node:

export DISPLAY=<ip address>:0.0
 
   

where the IP address is the IP address of the computer on which the Attachmate Reflection tool is installed.

Using the Attachmate Reflection Tool to Upgrade Cisco DCNM VSBs

You can use the Attachmate Reflection tool to upgrade Cisco DCNM VSBs using the install manager script stored in the /usr/local/cisco/dcm/dcnm/bin.

DETAILED STEPS


Step 1 Run dcnm-install-manager.sh.

You see the DCNM Install Manager window.

Step 2 From the DCNM Installer Folder drop-down list, choose the installation folder.

Step 3 From the DCNM License Folder drop-down list, choose the license folder.

Step 4 Specify the Data Path Location, and then click Install.


Using the Attachmate Reflection Tool to Install Licenses

You can use the Attachmate Reflection tool to install licenses using the install manager script stored in the /usr/local/cisco/dcm/dcnm/bin.

DETAILED STEPS


Step 1 Run dcnm-install-manager.sh.

You see the DCNM Install Manager window.

Step 2 From the DCNM License Folder drop-down list, choose the license folder.

Step 3 Click Install.


Using the Attachmate Reflection Tool to Reset User Credentials

You can use the Attachmate Reflection tool to reset Cisco DCNM user credentials using the password reset script stored in the /usr/local/cisco/dcm/dcnm/bin.

To modify user credentials, run pwreset.sh.