Cisco DCNM Fundamentals Configuration Guide, Release 4.2
Installing and Launching the DCNM Server
Downloads: This chapterpdf (PDF - 280.0KB) The complete bookPDF (PDF - 7.85MB) | Feedback

Installing and Launching the Cisco DCNM Server

Table Of Contents

Installing and Launching the Cisco DCNM Server

Cisco Fabric Manager Support

Database Support

Prerequisites for Installing the Cisco DCNM Server

Server Ports

Downloading the Cisco DCNM Server Software

Installing the Cisco DCNM Server

Starting the Cisco DCNM Server

Starting the Cisco DCNM Server (Windows Server 2003)

Starting the Cisco DCNM Server (RHEL 4 AS)

Installing Licenses

Upgrading the Cisco DCNM Server

Downgrading the Cisco DCNM Server

Reinstalling the Cisco DCNM Server

Stopping the Cisco DCNM Server

Stopping the Cisco DCNM Server (Windows Server 2003)

Stopping the Cisco DCNM Server (RHEL 4 AS)

Additional References

Related Documents

Standards

Feature History for Installing and Launching the Cisco DCNM Server


Installing and Launching the Cisco DCNM Server


This chapter describes how to install and launch the Cisco Data Center Network Manager (DCNM) server.

When you install the Cisco DCNM server, you initially install the software without applying a license. You can use many of the product features without using a license, but if you try to use a feature that requires a license, Cisco DCNM displays a message saying that a license is required for that feature. To use that feature and any other licensed feature, you must purchase and install the Cisco DCNM Enterprise LAN license.

If the server system is running the Windows Server 2003 operating system, the Cisco DCNM server runs as a Windows service. By default, the Cisco DCNM server starts automatically when you boot up the server system. You can manually stop, start, or pause this service. You can also change the startup instructions for Cisco DCNM to automatically start up when you start the operating system, start up manually, or be disabled from starting.

This chapter includes the following sections:

Cisco Fabric Manager Support

Database Support

Prerequisites for Installing the Cisco DCNM Server

Server Ports

Downloading the Cisco DCNM Server Software

Installing the Cisco DCNM Server

Starting the Cisco DCNM Server

Installing Licenses

Upgrading the Cisco DCNM Server

Downgrading the Cisco DCNM Server

Reinstalling the Cisco DCNM Server

Stopping the Cisco DCNM Server

Additional References

Feature History for Installing and Launching the Cisco DCNM Server

Cisco Fabric Manager Support

Beginning with Cisco DCNM Release 4.2(1), Cisco DCNM supports installing the Cisco DCNM server on a server system that has an installation of Cisco Fabric Manager Release 4.2(1) and later releases. If you install the Cisco DCNM server on a server system that already has an installation of Cisco Fabric Manager Release 4.2(1) and later releases, the Cisco DCNM installer detects the Fabric Manager installation, which has the following effects on the installation:

The installation folder is determined by the installer and cannot be configured.

The database that the installer configures the Cisco DCNM server to use is the database that Fabric Manager is configured to use. You cannot choose a database other than the database used by Fabric Manager.

The installer resolves port conflicts between the ports in use by Fabric Manager and the default ports that the Cisco DCNM server uses.

Database Support

Cisco DCNM supports the following databases:

PostgreSQL 8.1

PostgreSQL 8.2

Oracle Database 10g

Oracle Database 11g


Note If you plan to use an Oracle database, ensure that the Oracle database meets the prerequisites listed in the "Prerequisites for Installing the Cisco DCNM Server" section.


If the Cisco DCNM installer does not find a previous installation of a supported database, it can install PostgreSQL 8.2 for you.

Prerequisites for Installing the Cisco DCNM Server

Before you can install the Cisco DCNM server, ensure that the Cisco DCNM server system meets the following prerequisites:

The server system must meet the server system requirements published in the Cisco DCNM Release Notes, Release 4.x, available online at the following URL:

http://www.cisco.com/en/US/docs/switches/datacenter/sw/4_2/dcnm/release/notes/
dcnm_4_2_relnotes.html

If you plan to use an Oracle 10g database, configure the Oracle database as follows:

Increase the SYSTEM tablespace to 2 GB from the default 1 GB of space. For more information, see the "Increasing the SYSTEM Tablespace" section on page 19-9.

Increase the number of sessions and process to 150 each from the default of 50. For more information, see the "Increasing the Number of Sessions and Processes" section on page 19-9.

Increase the number of open cursors to 1000 from the default of 50. For more information, see the "Increasing the Number of Open Cursors" section on page 19-10.

If you plan to use an Oracle 11g database, configure the Oracle database as follows:

Increase the number of sessions and process to 150 each from the default of 50. For more information, see the "Increasing the Number of Sessions and Processes" section on page 19-9.

Increase the number of open cursors to 1000 from the default of 300. For more information, see the "Increasing the Number of Open Cursors" section on page 19-10.

For RHEL 4 AS, the maximum shared memory size must be 128 MB or more. To configure the maximum shared memory to 128 MB, use the following command:

sysctl -w kernel.shmmax=134217728

This setting, kernel.shmmax=134217728, should be saved in the /etc/sysctl.conf file. If this setting is not present or if it is less than 134217728, the Cisco DCNM server will fail after the server system is rebooted. For more information, see the following URL:

http://www.postgresql.org/docs/8.2/interactive/kernel-resources.html

The IP address of the server system should be statically assigned. The Cisco DCNM server binds to an IP address that you specify during installation. If the IP address of the server system changes after you install the Cisco DCNM server, Cisco DCNM clients are unable to connect to the Cisco DCNM server and you must stop and reinstall the Cisco DCNM server so that you can reconfigure the IP address.

The server system must be registered with the DNS servers.

A Perl environment must already be installed on the server system. We recommend Active Perl version 5.8.9.827. You can download ActivePerl for your server operating system from the following location:

http://www.activestate.com/activeperl/downloads/

The path to the Perl executable must be defined in the server system PATH environment variable.

Ensure that no other programs are running on the server, except for Cisco Fabric Manager Release 4.2(1) and later releases and the database software used by Fabric Manager.

Server Ports

A Cisco DCNM server must be able to receive the network traffic from Cisco DCNM clients on a number of ports. Any network gateway device that controls the traffic sent from a Cisco DCNM client to a Cisco DCNM server must permit the traffic sent to the ports that the Cisco DCNM server is configured to use.

Table 2-1 lists the default ports that services on a Cisco DCNM server listen to for client communications. You can configure two ports during installation. If a default port is already in use on the server system, the Cisco DCNM server installer resolves the port conflict automatically by assigning a different port to the service.

Table 2-1 Default TCP Ports for Client Communications 

Service Name
Default Port
Configurable?

RMI

1098

No

Naming Service

1099

During installation

EJB

3873

No

Server Bind 1

4445

No

Server Bind 2

4446

No

Syslog (system message) Receiver

5445

No

AJP Connector

8009

No

Web Server

8080

During installation

Web Service

8083

No

JMS

8093

No

RMI Object

14444

No


Downloading the Cisco DCNM Server Software

This section explains how to download the Cisco DCNM server software from Cisco.com. The file that you download is in tape archive (TAR) format. It contains the following files:

dcnm-k9.release.exe—Installation file for the supported Windows operating system.

dcnm-k9.release.bin—Installation file for the supported Linux operating system.

BEFORE YOU BEGIN

Downloading the Cisco DCNM server software requires a Cisco.com user account. If you do not have a Cisco.com user account, go to http://www.cisco.com/ and create one before you attempt to download the software.

DETAILED STEPS

To download the Cisco DCNM server software, follow these steps:


Step 1 Open a web browser and go to the following website:

http://www.cisco.com/

The Cisco web page opens.

Step 2 From the Support menu, choose Download Software.

The Download Software page appears.

Step 3 Under Select a Software Product Category, choose Network Management.

Step 4 If the Log In page appears now, enter your Cisco.com username and password, and then click Log In.

The Tools & Resources Download Software web page displays a tree of Cisco devices.

Step 5 From the tree, choose Data Center Management > Cisco Data Center Network Manager.

Step 6 If the Log In page appears now, enter your Cisco.com username and password, and then click Log In.

A tree of Cisco DCNM releases appears.

Step 7 From the tree, choose the Cisco DCNM release that you need.

To the right of the tree, the Download Now button appears beside the filename and information for the Cisco DCNM release that you chose.

Step 8 Click Download Now.

The Download Cart web page lists the Cisco DCNM release that you chose.

Step 9 Click Proceed with Download.

The browser lists a link to the software license agreement and the software download rules.

Step 10 Read the software license agreement and the rules, and then click Agree.

Step 11 Click Non Java Download Option.

A download list appears in a new browser window.

Step 12 Click the Download link that appears to the right of the Cisco DCNM release that you chose.

The download begins.

Step 13 After the download completes, extract the files from the downloaded TAR file by doing one of the following:

For Microsoft Windows, use a file archive utility, such as WinZip, to extract the contents of the TAR file.

For RHEL, use the following command to extract the contents of the TAR file:

tar -xvf dcnm-k9.release.tar 


Installing the Cisco DCNM Server

Use this procedure to install the Cisco DCNM server on a server system that does not have a previous installation of the Cisco DCNM server.

On server systems that run the Windows Server 2003 operating system, the installer adds the Cisco DCNM server as a Windows service.

By default, the Cisco DCNM server service automatically starts when you start the server operating system.

BEFORE YOU BEGIN

Ensure that the server system satisfies the prerequisites. For more information, see the "Prerequisites for Installing the Cisco DCNM Server" section.

Download the Cisco DCNM server software. See the "Downloading the Cisco DCNM Server Software" section.


Note Disable antivirus and instruction detection software on the server system. In general, disable any security software or feature that may interfere with the installation of the Cisco DCNM server software. After you have completed the installation, reenable the software or features.


DETAILED STEPS

To install the Cisco DCNM server software, follow these steps:


Step 1 Log into the server with a user account that has the required privileges, as follows:

For Windows Server 2003, the user account must be a member of the local administrators group.

For RHEL 4 AS, the user account must be root.

If you are installing Cisco DCNM on Windows and using Remote Desktop Connection (RDC) to access the Cisco DCNM server system, start RDC from a command prompt and use the /console option, as follows:

C:\>mstsc /console /v:server

where server is the DNS name or IP address of the Cisco DCNM server system.

Step 2 Go to the directory where you downloaded the Cisco DCNM server software and run one of the following files:

For Windows Server 2003, run the dcnm-k9.release.exe file.

For RHEL 4 AS, use the following sh command:

sh dcnm-k9.release.bin

After the installer prepares the installation, the Introduction step appears in the Cisco DCNM installer window.

Step 3 Click Next.

Step 4 If the Choose Install Folder step appears in the Cisco DCNM installer window, do the following:


Note If the Cisco DCNM installer detects an installation of Cisco Fabric Manager Release 4.2(1) and later releases on the server system, the Choose Install Folder step does not appear.


a. (Optional) If you want to change the default installation folder, type or choose the desired installation folder.

b. Click Next.

The Database Options step appears in the Cisco DCNM installer window. You can use an exiting PostgreSQL installation, an existing Oracle installation, or if PostgreSQL is not installed on the server system, you can use the Cisco DCNM installer to add a PostgreSQL installation.


Note If the Cisco DCNM installer detects an installation of Cisco Fabric Manager Release 4.2(1) and later releases on the server system, the only database option that is available is the database that Fabric Manager is configured to use.


Step 5 If you want to install PostgreSQL, do the following:

a. Next to RDBMS, click Install PostgreSQL.

If your server system runs RHEL 4 AS, the System User dialog box appears.

b. (RHEL 4 AS only) In the System User dialog box, type the username for the user account that should be used to run the PostgreSQL software. This user account should not have administrator or root privileges.

c. In the DB Admin User field, type the username of a database administrator account. The installer will create the administrator account that you specify.

d. In the DB Admin Password field, type the password for the database administrator username that you specified.

e. In the DCNM DB User field, type the username that Cisco DCNM should use to access the database. The default username is dcnmuser. The installer will create the user account that you specify.

f. In the DCNM DB Password field, type the password for the database user account that you specified.

g. In the Confirm DCNM DB Password field, retype the password for the database user account that you specified.

h. (Optional) If you want to change the default PostgreSQL database installation folder, in the Install Location field, type or choose the desired installation folder.

Step 6 If you want to use an existing relational database management system (RDBMS) installation, do the following:

a. Next to RDBMS, click one of the following:

Use existing PostgreSQL 8.1/8.2

Use existing Oracle 10g/11g

If the Cisco DCNM installer detected an existing RDBMS installation, the DB URL field shows the URL to the database.


Note If the Cisco DCNM installer detects an installation of Cisco Fabric Manager Release 4.2(1) and later releases on the server system, the DB URL field shows the URL of the Fabric Manager database and cannot be configured.


b. If the DB URL field does not have the correct URL to the database, type the correct URL.

c. In the DB Admin User field, type the username of a database user account that has permissions to create the Cisco DCNM database schema and user account.

d. In the DB Admin Password field, type the password for the database administrator username that you specified.

e. In the DCNM DB User field, type the username that Cisco DCNM should use to access the database.

The installer will use the Cisco DCNM admin user that you specified to create the Cisco DCNM database user account.

f. In the DCNM DB Password field, type the password for the database user account that you specified.

g. In the Confirm DCNM DB Password field, retype the password for the database user account that you specified.

Step 7 Click Next.

Step 8 If the Choose Database (PostgreSQL/Oracle) Root Folder step appears in the Cisco DCNM installer window, do the following:

a. Type or choose the folder that contains the BIN directory for the existing RDBMS that you specified. The installer lists the default installation paths for the supported databases.

b. Click Next.

The Configuration Options step appears in the Cisco DCNM installer window.

Step 9 From the Server IP Address list, choose the IP address that you want to use for the Cisco DCNM server. The list shows only the IP addresses currently assigned to network interfaces on the server system.


Note The IP address of the server system should be statically assigned. The Cisco DCNM server binds to an IP address that you specify during installation. If the IP address of the Cisco DCNM server changes, Cisco DCNM clients are unable to connect to the Cisco DCNM server and you must reinstall the Cisco DCNM server so that you can reconfigure the IP address.


Step 10 If you want to change the port that the Cisco DCNM web server listens to, enter the new port number in the Web Server Port box. By default, the Cisco DCNM web server listens to TCP port 8080.


Note If you change the web server port number, it affects the URL that Cisco DCNM users use to download the Cisco DCNM client.


Step 11 If you want to change the port that the Cisco DCNM server accepts Cisco DCNM client connections on, enter the new port number in the Naming Service Port box. By default, the Cisco DCNM server accepts connections from Cisco DCNM clients on TCP port 1099.


Note If you change the Cisco DCNM server port number, it affects the port that Cisco DCNM users specify when they log into the Cisco DCNM client.


Step 12 Click Next.

The Choose Archive Folder step appears in the Cisco DCNM installer window.

Step 13 (Optional) If you want to change the archive folder, type or choose the desired archive folder.

Step 14 Click Next.

The Local User Credentials step appears in the Cisco DCNM installer window.

Step 15 In the Local Admin Username field, type a name for a Cisco DCNM server user. The installer will create the Cisco DCNM server user and assign the Administrator role to it.

Step 16 In the Password field, type a password for the user, and then in the Confirm Password field, type the password again.


Note We recommend that you use a strong password. Common guidelines for strong passwords include a minimum password length of eight characters and at least one letter, one number, and one symbol. For example, the password Re1Ax@h0m3 has ten characters and contains uppercase and lowercase letters in addition to one symbol and three numbers.


Step 17 Click Next.

The Authentication Settings step appears in the Cisco DCNM installer window.

Choose the authentication method that the Cisco DCNM server should use to authenticate users who log into the Cisco DCNM client. You can choose one of the following:

Local—Cisco DCNM client users will be authenticated by the Cisco DCNM server user accounts only.

RADIUS—Cisco DCNM client users will be authenticated by a RADIUS server.

TACACS+—Cisco DCNM client users will be authenticated by a TACACS+ server.

For RADIUS or TACACS+, you can specify up to three servers.

Step 18 If you chose RADIUS or TACACS+, for each server that you want to specify, do the following:

a. In the server address field, type the IPv4 address of the server in dotted-decimal format.

b. In the secret key field, type the shared secret of the server.

c. (Optional) If you want to ensure that Cisco DCNM can communicate with the server, click Verify.

Step 19 Click Next.

If you are using Windows Server 2003, the installer asks you to specify a shortcut to the application. If you are using RHEL 4 AS, the installer asks you to specify a link folder.

Step 20 Choose the shortcut or link options that you want.

Step 21 (Optional) If you want the installer to create the shortcuts for all users who can log into the server system, check the Create Icons for All Users check box.

Step 22 Click Next.

The Pre-Installation Summary step appears in the Cisco DCNM installer window.

Step 23 Carefully review the summary of your choices. If you need to change anything, click Previous until the the Cisco DCNM installer window displays the step that you need to change.

Step 24 When you are ready to install the Cisco DCNM server software, click Next.

The installer installs the Cisco DCNM server software.

The Start DCNM Server dialog box appears.

Step 25 Choose whether you want to start the Cisco DCNM server now. If you start the Cisco DCNM server now, a splash screen appears while the server starts.

The Install Complete step appears in the Cisco DCNM installer window, which also shows a Cisco DCNM instance ID number.

Step 26 (Optional) If you plan to install a license for Cisco DCNM, record the instance ID number. The licensing process requires that you enter that number.


Note You can begin using Cisco DCNM without a licence but some features are not available unless you purchase and install a license and apply the license to managed devices that you want to use licensed features with.


Step 27 Click Done.

If you chose in Step 25 to start the Cisco DCNM server after installation, a splash screen appears while the server starts.

Step 28 (Optional) If you need to start the Cisco DCNM server, see the "Starting the Cisco DCNM Server" section.

Step 29 (Optional) If you want to install a Cisco DCNM license, see the "Installing Licenses" section.


Starting the Cisco DCNM Server

You can manually start the Cisco DCNM server. The manual procedures for starting the Cisco DCNM server differ for systems using the Windows Server 2003 and RHEL 4 AS operating systems, as described in the following topics:

Starting the Cisco DCNM Server (Windows Server 2003)

Starting the Cisco DCNM Server (RHEL 4 AS)

Starting the Cisco DCNM Server (Windows Server 2003)

On a server system running Windows Server 2003, you can start the Cisco DCNM server through the Windows services or by clicking the Start Cisco DCNM Server icon.

BEFORE YOU BEGIN

You must have installed the Cisco DCNM server (see the "Installing the Cisco DCNM Server" section).

DETAILED STEPS

To manually launch the Cisco DCNM server on a system running the Windows Server 2003 operating system, follow these steps:


Step 1 Open the Control Panel window and choose Administrative Tools > Services.

The Services window opens.

Step 2 Right-click Cisco DCNM Server and choose Start.


Note Alternatively, you can choose Start > All Programs > Cisco DCNM Server > Start DCNM Server; however, the location of shortcuts depends upon the choices you made when you installed the Cisco DCNM server.


A splash screen opens while the Cisco DCNM server starts. This screen closes once the Cisco DCNM server is running.


Starting the Cisco DCNM Server (RHEL 4 AS)

You can start the Cisco DCNM server on a RHEL 4 AS server system by using the Start_DCNM_Server command.

BEFORE YOU BEGIN

The Cisco DCNM server must be installed (see the "Installing the Cisco DCNM Server" section).

DETAILED STEPS

To manually launch the Cisco DCNM server on a system running the RHEL 4 AS operating system, follow this step:


Step 1 Use the Start_Cisco DCNM_Server script to start the Cisco DCNM server.

sh Start_DCNM_Server 

You can find this script in your home folder or the folder that you specified when setting up the link folder during your installation of Cisco DCNM.

The Cisco DCNM server opens a server console window and displays the processes it runs to start the server. The server is running when you see a "Started in Xm:XXs:XXXms" message.


Installing Licenses

To use the licensed Cisco DCNM server features, you must purchase and install Cisco DCNM Enterprise LAN licenses for each managed device that works with those features. To purchase a license, submit the Cisco DCNM Instance ID number and the number of devices to license to the Cisco Technical Assistance Team (TAC). TAC will e-mail you the license file that you need for installing the license.

After you install a license, you must specify which managed devices that it applies to. For more information, see Chapter 8, "Administering DCNM Licensed Devices".

BEFORE YOU BEGIN

You must have installed the Cisco DCNM server.

Ensure that there are no executable files in the folder where you plan to install the licenses file.

DETAILED STEPS

To install the Cisco DCNM Enterprise LAN license, follow these steps:


Step 1 Copy the Cisco DCNM Instance ID number by doing one of the following:

When you finish installing the server, copy the number when it is displayed at the end of the Cisco DCNM installation process.

When running the Cisco DCNM client, choose Help > Show DCNM Instance ID.

Step 2 Contact TAC and purchase one or more Cisco DCNM licenses. Present the Cisco DCNM Instance ID number and specify the number of devices that you want to license.

TAC will send you a license pack file that you can use for each installation that you ordered.

Step 3 Log into the server system that runs the Cisco DCNM server.

Step 4 Download the license pack file into a directory on the server system.


Caution Make sure that there are no other executable files in the directory where you download the license pack file. Having other files in the directory where you download the license pack file can disrupt the installation of the licenses.

Step 5 Go to the directory where you downloaded the Cisco DCNM server software and run one of the following files:

For Windows Server 2003, run the dcnm-k9.release.exe file.

For RHEL 4 AS, use the following sh command:

sh dcnm-k9.release.bin

When the Cisco DCNM installer starts, a warning dialog box indicates that the existing installation of the Cisco DCNM server was found.

Step 6 Click OK.

The Reinstall step appears in the Cisco DCNM installer window.

Step 7 Choose License Install and click Next.

The Choose DCNM License Folder step appears in the Cisco DCNM installer window.

Step 8 In the Please Choose a Folder field, type or choose the folder that contains the license file, and then click Next.

The Pre-Installation Summary step appears in the Cisco DCNM installer window. The License files(s) field shows the licenses that the Cisco DCNM installer found in the folder that you specified.

Step 9 Click Next.

The Installation Complete step appears in the Cisco DCNM installer window.

Step 10 Click Done.

You can now specify the managed devices that you want to use licensed Cisco DCNM features with. For more information, see Chapter 8, "Administering DCNM Licensed Devices."


Upgrading the Cisco DCNM Server

You can upgrade the DNCM server. The upgrade process requires that you stop the Cisco DCNM server before you begin the upgrade.


Note Data migration is not supported if you are upgrading to Cisco DCNM Release 4.2 from any release prior to Release 4.2. The Release 4.2 installer includes the option to back up the database prior to cleaning the database during the upgrade.


BEFORE YOU BEGIN

Ensure that the server system satisfies the prerequisites. For more information, see the "Prerequisites for Installing the Cisco DCNM Server" section.

Download the updated Cisco DCNM server software by following the procedure listed in the "Downloading the Cisco DCNM Server Software" section.

Stop the Cisco DCNM server. The upgrade cannot proceed until you stop the Cisco DCNM server. For more information, see the applicable topic:

Stopping the Cisco DCNM Server (Windows Server 2003)

Stopping the Cisco DCNM Server (RHEL 4 AS)


Note Disable antivirus and instruction detection software on the server system. In general, disable any security software or feature that may interfere with the installation of the Cisco DCNM server software. After you have completed the installation, reenable the software or features.


DETAILED STEPS

To upgrade the Cisco DCNM server software, follow these steps:


Step 1 Log into the server with a user account that has the required privileges, as follows:

For Windows Server 2003, the user account must be a member of the local administrators group.

For RHEL 4 AS, the user account must be root.

If you are installing Cisco DCNM on Windows and using Remote Desktop Connection (RDC) to access the Cisco DCNM server system, start RDC from a command prompt and use the /console option, as follows:

C:\>mstsc /console /v:server

where server is the DNS name or IP address of the Cisco DCNM server system.

Step 2 If you have not already done so, stop the Cisco DCNM server.

Step 3 Go to the directory where you downloaded the updated Cisco DCNM server software and run one of the following files:

For Windows Server 2003, run the dcnm-k9.release.exe file.

For RHEL 4 AS, use the following sh command:

sh dcnm-k9.release.bin

When the Cisco DCNM installer starts, a warning dialog box indicates that the existing installation of the Cisco DCNM server was found.

Step 4 Click OK.

If the Choose PostgreSQL Folder step appears in the Cisco DCNM installer window, the installer could not locate the PostgreSQL database files.

Step 5 If the Choose PostgreSQL Folder step appears, type or choose the path to the folder that contains the PostgreSQL database files and then click Next.

The Database Options step appears in the Cisco DCNM installer window.

Step 6 Specify the database administrator username and password. To do so, follow these steps:

a. In the DB Admin User field, follow these guidelines:

If you are upgrading from a release of Cisco DCNM earlier than Cisco DCNM Release 4.2(1), type the username for a new database administrator account. The installer will create the administrator account that you specify.

If you are upgrading from Cisco DCNM Release 4.2(1) or a later release, type the username of the existing database administrator account.

b. In the DB Admin Password field, type the password for the database administrator username that you specified.

c. Click Next.

The Local User Credentials step appears in the Cisco DCNM installer window.

Step 7 In the Local Admin Username field, type a name for a Cisco DCNM server user. The installer will create the Cisco DCNM server user and assign the Administrator role to it.

Step 8 In the Password field, type a password for the user, and then in the Confirm Password field, type the password again.


Note We recommend that you use a strong password. Common guidelines for strong passwords include a minimum password length of eight characters and at least one letter, one number, and one symbol. For example, the password Re1Ax@h0m3 has ten characters and contains uppercase and lowercase letters in addition to one symbol and three numbers.


Step 9 Click Next.

The Authentication Settings step appears in the Cisco DCNM installer window.

Choose the authentication method that the Cisco DCNM server should use to authenticate users who log into the Cisco DCNM client. You can choose one of the following:

Local—Cisco DCNM client users will be authenticated by the Cisco DCNM server user accounts only.

RADIUS—Cisco DCNM client users will be authenticated by a RADIUS server.

TACACS+—Cisco DCNM client users will be authenticated by a TACACS+ server.

For RADIUS or TACACS+, you can specify up to three servers.

Step 10 If you chose RADIUS or TACACS+, for each server that you want to specify, do the following:

a. In the server address field, type the IPv4 address of the server in dotted-decimal format.

b. In the secret key field, type the shared secret of the server.

c. (Optional) If you want to ensure that Cisco DCNM can communicate with the server, click Verify.

Step 11 Click Next.

The Pre-Installation Summary step appears in the Cisco DCNM installer window.

Step 12 Carefully review the summary of your choices. If you need to change anything, click Previous until the the Cisco DCNM installer window displays the step that you need to change.

Step 13 When you are ready to install the Cisco DCNM server software, click Next.

If you are upgrading from a release prior to Release 4.2(0), the DB Migration dialog box appears.


Note Upgrading Cisco DCNM from a release prior to Release 4.2(0) is not supported.


Step 14 If the DB Migration dialog box appears, choose whether you want the installer to back up the database.

If you are upgrading from a release prior to Release 4.2(0), the installer backs up the database if you chose to do so. The installer then clears all data from the database.

If you are upgrading from Release 4.2 to a later version of Release 4.2, the installer migrates the database from the previous installation to the new installation.

After database migration is complete, the installer installs but does not start the Cisco DCNM server software.

The Install Complete step appears in the Cisco DCNM installer window, which also shows a Cisco DCNM instance ID number.

Step 15 Click Done.

The Cisco DCNM server is not running.

Step 16 If you need to start the Cisco DCNM server, do one of the following:

If you are using Windows Server 2003, see the "Starting the Cisco DCNM Server (Windows Server 2003)" section.

If you are using RHEL 4 AS, see the "Starting the Cisco DCNM Server (RHEL 4 AS)" section.


Downgrading the Cisco DCNM Server

The Cisco DCNM installer does not support downgrading to earlier releases.

To downgrade the Cisco DCNM server, follow these steps:


Step 1 Uninstall the Cisco DCNM server that you want to downgrade from.

Step 2 Install and deploy the earlier release of the Cisco DCNM server that you want to downgrade to. For more information, see the "Deploying Cisco DCNM" section on page 1-4.


Reinstalling the Cisco DCNM Server

You can reinstall the Cisco DCNM server and the download service for the Cisco DCNM client. When you reinstall the Cisco DCNM server, you must choose one of the following types of reinstallation:

Custom—Reinstalls the components that you select, without allowing you to change anything that you specified when you previously installed the Cisco DCNM server. Choose this reinstallation type when you want to do any of the following:

Reinstall the Cisco DCNM server without changing database or configuration options.

Reinstall the Cisco DCNM client download service.

Reinstall the Cisco DCNM license, either from the same folder that previously contained the Cisco DCNM license file or from a different folder.

Full Reinstall—Reinstalls the Cisco DCNM server and the Cisco DCNM client download service. Choose this reinstallation type when you want to do any of the following:

Perform password recovery for the local administrator account.

Change Cisco DCNM server authentication settings.

Create a PostgreSQL installation.

Change the database URL, database username, or database password for the existing PostgreSQL installation.

Change the Cisco DCNM server IP address.


Note If you are using RHEL 4 AS and you change the Cisco DCNM server IP address, you must also manually change the IP address in the INSTALL_DIR/bin/stopDCNM.sh script.


Change the port that the Cisco DCNM web server listens to.


Note If you change the web server port number, it affects the URL that Cisco DCNM users use to download the Cisco DCNM client.


Change the port that the Cisco DCNM server accepts Cisco DCNM client connections on.


Note If you change the Cisco DCNM server port number, it affects the port that Cisco DCNM users specify when they log into the Cisco DCNM client.


Neither reinstallation type allows you to change the installation folder or archive folder.

BEFORE YOU BEGIN

Stop the Cisco DCNM server. The upgrade cannot proceed until you stop the Cisco DCNM server. For more information, see the applicable topic:

Stopping the Cisco DCNM Server (Windows Server 2003)

Stopping the Cisco DCNM Server (RHEL 4 AS)


Note Disable antivirus and instruction detection software on the server system. In general, disable any security software or feature that may interfere with the installation of the Cisco DCNM server software. After you have completed the installation, reenable the software or features.


DETAILED STEPS

To reinstall the Cisco DCNM server, set up a web start copy of the Cisco DCNM client, or do both, follow these steps:


Step 1 Log into the server with a user account that has the required privileges, as follows:

For Windows Server 2003, the user account must be a member of the local administrators group.

For RHEL 4 AS, the user account must be root.

If you are installing Cisco DCNM on Windows and using Remote Desktop Connection (RDC) to access the Cisco DCNM server system, start RDC from a command prompt and use the /console option, as follows:

C:\>mstsc /console /v:server

where server is the DNS name or IP address of the Cisco DCNM server system.

Step 2 If you have not already done so, stop the Cisco DCNM server.

Step 3 Go to the directory that contains the Cisco DCNM installer software and run one of the following files:

For Windows Server 2003, run the dcnm-k9.release.exe file.

For RHEL 4 AS, use the following sh command:

sh dcnm-k9.release.bin

When the Cisco DCNM installer starts, a warning dialog box indicates that the existing installation of the Cisco DCNM server was found.

Step 4 Click OK.

The Reinstall step appears in the Cisco DCNM installer window.

Step 5 Choose the type of reinstallation that you to perform by doing one of the following:

If you want to reinstall both the Cisco DCNM server and the Cisco DCNM client download service, click Full Reinstall.

If you want to reinstall only the Cisco DCNM server or only the Cisco DCNM client download service, click Custom.

Step 6 If you chose Custom, follow these steps:

a. Click Next.

The Reinstall Cisco DCNM step appears in the Cisco DCNM installer window. Under Install Set, check boxes for the components that you can reinstall appear.

b. Check the check boxes for the components that you want to reinstall and click Next.

If you chose the License component, the Choose DCNM License Folder step appears in the Cisco DCNM installer window.

c. If the Choose DCNM License Folder step appears, type or choose the path to the folder that contains the Cisco DCNM license file, and then click Next.

The Pre-Installation Summary step appears in the Cisco DCNM installer window.

d. Skip to Step 25.

Step 7 If you chose Full Reinstall, click Next.

The Database Options step appears in the Cisco DCNM installer window. You can use the existing PostgreSQL installation or you can use the Cisco DCNM installer to add a PostgreSQL installation.

Step 8 Next to RDBMS, click the option for the existing database that you want to use.

If the Cisco DCNM installer detected the existing database installation, the DB URL field shows the URL to the database.


Note If the Cisco DCNM installer detects that the existing installation of Cisco DCNM shares a database system with an installation of Cisco Fabric Manager Release 4.2(1) and later releases, the DB URL field shows the URL of the Fabric Manager database and cannot be configured.


Step 9 If the DB URL field does not have the correct URL to the Cisco DCNM database, type the correct URL. If you previously used the Cisco DCNM installer to create a PostgreSQL installation, the URL is typically as follows:

jdbc:postgresql://localhost:5432/dcnmdb

where 5432 is the default PostgreSQL server port number and dcnmdb is the default database name that the Cisco DCNM installer creates.

If you previously used a Oracle 10g database installation, the URL is typically as follows:

jdbc:oracle:thin:@localhost:1521:XE

where 1521 is the default Oracle server port number.

If you previously used a Oracle 11g database installation, the URL is typically as follows:

jdbc:oracle:thin:@localhost:1521:ORCL

where 1521 is the default Oracle server port number.

Step 10 In the DB Admin User field, type the username of a database user account that has administrator permissions in the database.

Step 11 In the DB Admin Password field, type the password for the database administrator username that you specified.

Step 12 In the DCNM DB User field, type the username that Cisco DCNM should use to access the database.

Step 13 In the DCNM DB Password field, type the password for the database user account that you specified.

Step 14 In the Confirm DCNM DB Password field, retype the password for the database user account that you specified.

Step 15 Click Next.

The Configuration Options step appears in the Cisco DCNM installer window.

Step 16 From the Server IP Address list, choose the IP address that you want to use for the Cisco DCNM server. The list shows only the IP addresses currently assigned to network interfaces on the server system.


Note The IP address of the server system should be statically assigned. The Cisco DCNM server binds to the IP address that you specify. If the IP address of the server system changes after you install the Cisco DCNM server, Cisco DCNM clients are unable to connect to the Cisco DCNM server and you must stop and reinstall the Cisco DCNM server so that you can reconfigure the IP address.


Step 17 If you want to change the port that the Cisco DCNM web server listens to, enter the new port number in the Web Server Port box. By default, the Cisco DCNM web server listens to TCP port 8080.


Note If you change the web server port number, it affects the URL that Cisco DCNM users use to download the Cisco DCNM client.


Step 18 If you want to change the port that the Cisco DCNM server accepts Cisco DCNM client connections on, enter the new port number in the Naming Service Port box. By default, the Cisco DCNM server accepts connections from Cisco DCNM clients on TCP port 1099.


Note If you change the Cisco DCNM server port number, it affects the port that Cisco DCNM users specify when they log into the Cisco DCNM client.


Step 19 Click Next.

The Local User Credentials step appears in the Cisco DCNM installer window.

Step 20 In the Local Admin Username field, type a name for a Cisco DCNM server user. The installer will create the Cisco DCNM server user and assign the Administrator role to it.

Step 21 In the Password field, type a password for the user, and then in the Confirm Password field, type the password again.


Note We recommend that you use a strong password. Common guidelines for strong passwords include a minimum password length of eight characters and at least one letter, one number, and one symbol. For example, the password Re1Ax@h0m3 has ten characters and contains uppercase and lowercase letters in addition to one symbol and three numbers.


Step 22 Click Next.

The Authentication Settings step appears in the Cisco DCNM installer window.

Choose the authentication method that the Cisco DCNM server should use to authenticate users who log into the Cisco DCNM client. You can choose one of the following:

Local—Cisco DCNM client users will be authenticated by the Cisco DCNM server user accounts only.

RADIUS—Cisco DCNM client users will be authenticated by a RADIUS server.

TACACS+—Cisco DCNM client users will be authenticated by a TACACS+ server.

For RADIUS or TACACS+, you can specify up to three servers.

Step 23 If you chose RADIUS or TACACS+, for each server that you want to specify, do the following:

a. In the server address field, type the IPv4 address of the server in dotted-decimal format.

b. In the secret key field, type the shared secret of the server.

c. (Optional) If you want to ensure that Cisco DCNM can communicate with the server, click Verify.

Step 24 Click Next.

Step 25 Carefully review the summary of your choices. If you need to change anything, click Previous and return to the applicable step, above.

Step 26 When you are ready to install the Cisco DCNM server software, click Next.

The installer installs the Cisco DCNM server software.

The Start DCNM Server dialog box appears.

Step 27 Choose whether you want to start the Cisco DCNM server now. If you start the Cisco DCNM server now, a splash screen appears while the server starts.

The Install Complete step appears in the Cisco DCNM installer window.

Step 28 Click Done.

Step 29 If you need to start the Cisco DCNM server, see the "Starting the Cisco DCNM Server" section.

Step 30 (RHEL 4 AS only) If you are using RHEL 4 AS and you changed the Cisco DCNM server IP address during the reinstallation, open the INSTALL_DIR/bin/stopDCNM.sh script in a text editor and change the IP address to the new Cisco DCNM server IP address.


Stopping the Cisco DCNM Server

You can manually stop the Cisco DCNM server. The manual procedures for stopping the Cisco DCNM server differ for systems using the Windows Server 2003 and RHEL 4 AS operating systems, as described in the following topics:

Stopping the Cisco DCNM Server (Windows Server 2003)

Stopping the Cisco DCNM Server (RHEL 4 AS)

Stopping the Cisco DCNM Server (Windows Server 2003)

On a server system running Windows Server 2003, you can stop the Cisco DCNM server through the Windows services or by clicking the Stop DCNM Server icon.

DETAILED STEPS

To manually stop the Cisco DCNM server on a system running the Windows Server 2003 operating system, follow these steps:


Step 1 Open the Control Panel window and choose Administrative Tools > Services.

A window opens listing the Windows services.

Step 2 Right-click Cisco DCNM Server and choose Stop.


Note Alternatively, you can choose Start > All Programs > Cisco DCNM Server > Stop DCNM Server; however, the location of shortcuts depends upon the choices you made when you installed the Cisco DCNM server.


A splash screen opens while the Cisco DCNM server begins to shut down. When the Cisco DCNM server has stopped, the splash screen closes.


Stopping the Cisco DCNM Server (RHEL 4 AS)

On a server system running RHEL 4 AS, you can stop the Cisco DCNM server with the Stop_DCNM_Server command.

DETAILED STEPS

To manually stop the Cisco DCNM server on a system running the RHEL 4 AS operating system, follow this step:


Step 1 Use the Stop_Cisco DCNM_Server script to stop the server on a RHEL operating system.

sh Stop_DCNM_Server 

You can find this script in your home folder or the folder that you specified when setting up the link folder during your installation of Cisco DCNM.

The Cisco DCNM server opens a server console window and displays the processes that it runs to start the server. The server is running when you see a "Stopped at Xm:XXs:XXXms" message.


Additional References

For additional information related to installing and launching the Cisco DCNM server, see the following sections:

Related Documents

Standards

Related Documents

Related Topic
Document Title

Overview of the Cisco DCNM environment

Information About Cisco DCNM, page 1-1

The process of deploying Cisco DCNM in your organization

Deploying Cisco DCNM, page 1-4


Standards

Standards
Title

No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.


Feature History for Installing and Launching the Cisco DCNM Server

Table 2-2 lists the release history for this feature.

Table 2-2 Feature History for Installing and Launching the Cisco DCNM Server 

Feature Name
Releases
Feature Information

Support for shared server system with Cisco Fabric Manager Release 4.2(1) and later releases.

4.2(1)

This feature was introduced.

Support for Oracle 10g and 11g databases.

4.2(1)

This feature was introduced.

Cisco DCNM server installer

4.2(1)

This feature was preexisting.

Server installer includes a step for configuring the DCNM server IP address, web server listening port, and DCNM server listening port

4.1(2)

This feature was introduced.

Server installer includes a step for choosing an archive folder

4.1(2)

This feature was introduced.

DCNM server installer

4.1(2)

This feature was introduced.