Installing Cisco DCNM VSB
This section describes how to install Cisco DCNM VSB.
This section includes the following topics:
System Requirements
The following table lists the system requirements for the Cisco DCNM VSB.
Table 1-1 Cisco DCNM VSB System 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 1-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 1-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.
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.
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
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:
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.
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
You can perform a standalone DCNM VSB installation using the remote database. Figure 1-2 shows standalone DCNM VSB installation using the remote database.,
Figure 1-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.
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.
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 1-3 shows the two node DCNM cluster.
Figure 1-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>
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
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 1-2 Cisco DCNM Shortcuts
|
|
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
You can verify the configuration and status of a deployed Cisco DCNM VSB.
DETAILED STEPS
|
|
|
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
|
|
|
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
|
|
|
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.