Cisco DCNM Fundamentals Guide, Release 5.x
Installing and Launching the Cisco DCNM-LAN Client
Downloads: This chapterpdf (PDF - 154.0KB) The complete bookPDF (PDF - 10.55MB) | Feedback

Installing and Launching the Cisco DCNM-LAN Client

Table Of Contents

Installing and Launching the Cisco DCNM-LAN Client

Information About Installing and Launching the DCNM-LAN Client

Prerequisites for Installing and Launching the DCNM-LAN Client

Secure Client Communications

Default Administrator Credentials

Downloading and Launching the DCNM-LAN Client

Using a Web Browser to Download and Launch the DCNM-LAN Client

Using a Command Prompt to Download and Launch the DCNM-LAN Client

Using a Command Prompt to Download and Launch the DCNM-LAN Client without using Java Web Start Launcher

Restarting the DCNM-LAN Client

Logging Into the DCNM-LAN Client

Uninstalling the DCNM-LAN Client

Additional References

Related Documents

Standards

Feature History for Installing and Launching the DCNM-LAN Client


Installing and Launching the Cisco DCNM-LAN Client


This chapter describes how to install and launch the Cisco Data Center Network Manager for LAN (DCNM-LAN) client.

This chapter includes the following sections:

Information About Installing and Launching the DCNM-LAN Client

Prerequisites for Installing and Launching the DCNM-LAN Client

Secure Client Communications

Default Administrator Credentials

Downloading and Launching the DCNM-LAN Client

Restarting the DCNM-LAN Client

Logging Into the DCNM-LAN Client

Uninstalling the DCNM-LAN Client

Additional References

Feature History for Installing and Launching the DCNM-LAN Client

Information About Installing and Launching the DCNM-LAN Client

The DCNM-LAN client is a Java application. When you finish installing the DCNM-LAN client on your system, the DCNM-LAN client automatically starts. After installing the DCNM-LAN client, whenever you need to restart the DCNM-LAN client, use the DCNM-LAN client software image on your system for the quickest start. If a more recent version of the DCNM-LAN client is available, the DCNM-LAN client automatically downloads that version to your system.

Prerequisites for Installing and Launching the DCNM-LAN Client

Installing and using the DCNM-LAN client have the following prerequisites:

Your system must be running a supported operating system to install and use the DCNM-LAN client software. For more information about client system requirements, see the Cisco DCNM Release Notes, Release 5.x, which are available at the following site:

http://www.cisco.com/en/US/products/ps9369/tsd_products_support_series_home.html

The installation process uses Java version 1.6.0_21. If your system does not have that version of Java, the installation process will install it to your system.

The DCNM-LAN client installer requires Internet access to download the Java version 1.6.0_21 JRE. If the system cannot access the Internet, use another system to download the Java installer and copy it to the system that you want to install the DCNM-LAN client on. You can download Java version 1.6.0_21 JRE from the Oracle Technology Network website.

If your network environment requires a proxy connection to permit the download of the Java installer, ensure that the proxy settings are configured in Internet Options, available from the Control Panel.

Some DCNM-LAN features require a license. Before you can use licensed features, install the DCNM-LAN license. For more information about licensed features or for more information about the license installation, see the Cisco DCNM Installation and Licensing Guide, Release 5.x.

Secure Client Communications

By default, communication between the DCNM-LAN client and server is unencrypted; however, you can enable Secure Sockets Layer (SSL) encryption to protect client-server communications. Enabling SSL encryption does not affect how users download, install, and log into the DCNM-LAN client.

For information about enabling secure client communication, see the Cisco DCNM Installation and Licensing Guide, Release 5.x.

Default Administrator Credentials

When you install DCNM-LAN, you specify the default administrator account, which is a DCNM-LAN local user. If you use RADIUS or TACACS+ authentication servers to control access to the DCNM-LAN client, the default administrator account provides you access if no authentication servers for the current authentication mode are reachable.

If no one has administrative access to DCNM-LAN, you can reset the local administrator account or change DCNM-LAN server authentication settings by reinstalling the DCNM-LAN server software. For more information, see the Cisco DCNM Installation and Licensing Guide, Release 5.x.

Downloading and Launching the DCNM-LAN Client

The DCNM-LAN client is available from the web server that is included on the DCNM-LAN server. You can download and launch the DCNM-LAN client either by using a web browser or by using a command prompt.

When you download and launch the DCNM-LAN client, it automatically saves an image of the software on your local system and starts the DCNM-LAN client. Later on, when you start the DCNM-LAN client, you can quickly start it by using the image on your local system.

This section includes the following topics:

Using a Web Browser to Download and Launch the DCNM-LAN Client

Using a Command Prompt to Download and Launch the DCNM-LAN Client

Using a Command Prompt to Download and Launch the DCNM-LAN Client without using Java Web Start Launcher

Using a Web Browser to Download and Launch the DCNM-LAN Client

You can use a web browser to download and launch the DCNM-LAN client.

BEFORE YOU BEGIN

The Java version 1.6.0_21 JRE must be installed on the computer that you want to run the DCNM-LAN client on.

The computer that you want to run the DCNM-LAN client on must meet the client system requirements. For details about the client system requirements, see the Cisco DCNM Release Notes, Release 5.x, available at the following site:

http://www.cisco.com/en/US/products/ps9369/tsd_products_support_series_home.html

DETAILED STEPS


Step 1 On the computer that you want to use the DCNM-LAN client on, open a web browser and go to the following address:

http://server_IP_address_or_DNS_name:web_server_port/dcnm-client/index.html

For example, if the DCNM-LAN server IP address is 172.0.2.1 and the web server port is 8080, use the following address:

http://172.0.2.1:8080/dcnm-client/index.html 

The browser shows the DCNM-LAN client page.

Step 2 Click Launch DCNM Client.

The DCNM-LAN server sends the dcnm.jnlp file to the browser. This file should be opened with the Java Web Start Launcher.

Step 3 If the browser prompts you, choose to open the dcnm.jnlp file. You do not need to save the file.

The DCNM-LAN client installer verifies that Java is already installed on your system. If the installer does not find the supported version of Java on the computer, the installer prompts you to install Java version 1.6.0_21.


Note The Cisco DCNM client installer requires Internet access to download the Java version 1.6.0_21 JRE. If the system cannot access the Internet, use another system to download the Java installer, copy it to the system that you want to install the Cisco DCNM client on, install Java, and restart the Cisco DCNM client installation. You can download Java version 1.6.0_21 JRE from the Oracle Technology Network website.

If your network environment requires a proxy connection to permit the download of the Java installer, ensure that the proxy settings are configured in Internet Options, available from the Control Panel.


Step 4 If the installer prompts you to install Java version 1.6.0_21, follow these steps:

a. Click OK to begin installing the supported version of Java.

b. If a security warning notifies you that the Java installer was digitally signed by an expired certificate, click Run to continue the installation.

c. Complete the Java installation wizard.


Tip To specify whether the supported version of Java is the default version used by browsers installed on the computer, choose Custom setup on the License Agreement dialog box. Later in the Java installation, on the Browser Registration dialog box, you can specify the browsers that should use the Java version that is supported by DCNM-LAN.


The DCNM-LAN client installs on the computer.


Note You might need to wait a minute or longer while the installer installs the software.


The DCNM-LAN client login window opens.

For detailed login steps, see the "Logging Into the DCNM-LAN Client" section.


Using a Command Prompt to Download and Launch the DCNM-LAN Client

You can use a command prompt to download and launch the DCNM-LAN client.

BEFORE YOU BEGIN

The Java version 1.6.0_21 JRE must be installed on the computer that you want to run the DCNM-LAN client on.

The computer that you want to run the DCNM-LAN client on must meet the client system requirements. For details about the client system requirements, see the Cisco DCNM Release Notes, Release 5.x, available at the following site:

http://www.cisco.com/en/US/products/ps9369/tsd_products_support_series_home.html

DETAILED STEPS


Step 1 On the computer that you want to use the DCNM-LAN client on, access a command prompt.

Step 2 Use the cd command to change the directory to the bin directory under the Java version 1.6.0_21 installation directory, as follows:

cd path

where path is the relative or absolute path to the bin directory. For example, on Microsoft Windows, the default path to the Java version 1.6.0_21 bin directory is C:\Program Files\dcm\Java\jre1.6.0_21\bin.

Step 3 Enter the applicable command as follows:

For Microsoft Windows:
javaws.exe server_IP_address_or_DNS_name:web_server_port/dcnm-client/dcnm.jnlp

For RHEL:
./javaws server_IP_address_or_DNS_name:web_server_port/dcnm-client/dcnm.jnlp

The Java Web Start Launcher retrieves the dcnm.jnlp file from the DCNM-LAN server and installs the DCNM-LAN client on the computer.


Note You might need to wait a minute or longer while the installer installs the software.


The DCNM-LAN client login window opens.

For detailed login steps, see the "Logging Into the DCNM-LAN Client" section.


Using a Command Prompt to Download and Launch the DCNM-LAN Client without using Java Web Start Launcher

You can use a command prompt to download and launch the DCNM-LAN client in standalone mode without using the Java Web Start Launcher.

BEFORE YOU BEGIN

The Java version 1.6.0_21 JRE must be installed on the computer that you want to run the DCNM-LAN client on.

The computer that you want to run the DCNM-LAN client on must meet the client system requirements. For details about the client system requirements, see the Cisco DCNM Release Notes, Release 5.x, available at the following site:

http://www.cisco.com/en/US/products/ps9369/tsd_products_support_series_home.html


Note The Cisco DCNM-SAN cross launch feature is not supported when the DCNM-LAN client is installed in standalone mode. (The DCNM-LAN client in standalone mode is not a Java Web Start application.)


DETAILED STEPS


Step 1 Access a command prompt on the computer where the DCNM-LAN server is installed and navigate to the directory where the DCNM-LAN server is installed.

On a Windows DCNM-LAN server, the DCNM-LAN server is installed in <DCNM_INSTALL_LOCATION>\dcm\dcnm\ui-client directory.
The default for <DCNM_INSTALL_LOCATION> is C:\Program Files\Cisco Systems.

On a RHEL DCNM-LAN server, the DCNM-LAN server is installed in <DCNM_INSTALL_LOCATION>/dcm/dcnm/ui-client directory.
The default for <DCNM_INSTALL_LOCATION> is /usr/cisco.

Step 2 In the ui-client directory, locate and run the construct_DCNM_LAN_SA_Client script.

On a Windows DCNM-LAN server, run construct_DCNM_LAN_SA_Client.bat.

On a RHEL DCNM-LAN server, run construct_DCNM_LAN_SA_Client.sh.

Step 3 Copy the ui-client directory to the computer that you want to run the DCNM-LAN client on.

Step 4 On the computer that you are preparing for the DCNM-LAN client, access a command prompt and set JAVA_HOME to the location where the Java JRE is installed.
For example:

For Microsoft Windows:
set JAVA_HOME=C:\Program Files\Java\jre1.6.0_21

For RHEL:
export JAVA_HOME=/usr/java/jre1.6.0_21

Step 5 On the computer that you are preparing for the DCNM-LAN client, navigate to the ui-client directory that was copied from the DCNM-LAN server.

Step 6 In the ui-client directory, locate and run the dcnm-client-sa script to launch the DCNM-LAN client.

On a Windows DCNM-LAN server, run dcnm-client-sa.bat.

On a RHEL DCNM-LAN server, run dcnm-client-sa.sh.

The DCNM-LAN client login window opens.

For detailed login steps, see the "Logging Into the DCNM-LAN Client" section.


Restarting the DCNM-LAN Client

If you have previously downloaded and launched the DCNM-LAN client on a computer, you can later start the DCNM-LAN client by using one of the shortcuts that the installer added to the computer.

When you start the DCNM-LAN client, it connects to the DCNM-LAN server and checks if the DCNM-LAN client that is available on the DCNM-LAN server is a newer version than the locally installed DCNM-LAN client. How the DCNM-LAN client starts varies depending upon the result of the version check, as follows:

If the locally installed DCNM-LAN client is the same version as the DCNM-LAN client that is available on the DCNM-LAN server, the DCNM-LAN client window opens quickly.

If the locally installed DCNM-LAN client is older than the version of the DCNM-LAN client that is available on the DCNM-LAN server, the DCNM-LAN client automatically downloads from the DCNM-LAN server and replaces the locally installed DCNM-LAN client before the DCNM-LAN client window opens.

For detailed login steps, see the "Logging Into the DCNM-LAN Client" section.

Logging Into the DCNM-LAN Client

When you log into the DCNM-LAN client, you must specify a valid DCNM-LAN user account.

BEFORE YOU BEGIN

You should know the following information before logging into the DCNM-LAN client:

A valid DCNM-LAN username and password.

The IP address or DNS name of the DCNM-LAN server. In a clustered-server deployment, this should be the IP address or DNS name of the master server.

The DCNM-LAN server port number. By default, the server port number is 1099.

Proxy server address, HTTP port number, and Socks port number, if a proxy server is required by your network environment.

DETAILED STEPS


Step 1 Start the DCNM-LAN client. If you have previously downloaded and launched the DCNM-LAN client on the computer, you can start the client by using one of the shortcuts added to the computer by the client installer. For more information about downloading and launching the client, see one of the following topics:

Using a Web Browser to Download and Launch the DCNM-LAN Client

Using a Command Prompt to Download and Launch the DCNM-LAN Client

The DCNM-LAN client login window opens.

Step 2 In the DCNM-LAN Server field, enter the DNS name or the IP address of the DCNM-LAN server. By default, this field lists the address or name specified the last time the client logged into a server. If you are logging into the client after downloading it, this field lists the address of the server that you downloaded the client from.


Note If your DCNM-LAN deployment uses a clustered-server environment, enter the DNS name or IP address of the master DCNM-LAN server.


Step 3 In the Username field, enter your DCNM-LAN username. If you are logging into DCNM-LAN for the first time after installing the server, enter the local administrator name that you specified during the server installation. For more information, see the "Default Administrator Credentials" section.

Step 4 In the Password field, enter the password for the DCNM-LAN username that you specified.

Step 5 (Optional) If you need to change the DCNM-LAN server port, do the following:

a. If the Port field is not visible, click More >>.

b. Enter the port number in the Port field.

The default DCNM-LAN server port number is 1099; however, you can specify a different port number when you install or reinstall the DCNM-LAN server.

Step 6 (Optional) If you need to use a proxy server to connect to the DCNM-LAN server, do the following:

a. If the "Connect to the DCNM-LAN server with a proxy server" check box is not visible, click More >>.

b. Check Connect to the DCNM-LAN server with a proxy server.

The Proxy Server area appears below the check box.

c. In the Address field, enter the IP address of the proxy server.

d. In the HTTP Port and Socks Port fields, enter the port numbers on which the proxy server accepts HTTP and Socks connections.

e. (Optional) If the proxy server requires authentication, check Authentication and enter a valid username and password in the fields provided.

Step 7 Click Login.

The DCNM-LAN client opens. For information on how to use the DCNM-LAN client, see Chapter 14 "Using the Cisco DCNM-LAN Client."


Uninstalling the DCNM-LAN Client

You can uninstall the DCNM-LAN client from a computer.

DETAILED STEPS


Step 1 Click Start > Control Panel > Java.

The Java Control Panel dialog box opens.

Step 2 In the General tab, under Temporary Internet Files, click Settings.

The Temporary File Settings dialog box appears.

Step 3 Click View Applications.

The Java Application Cache Viewer dialog box opens.

Step 4 Select the DCNM-LAN Client application and click Remove Selected Application.

Java uninstalls the DCNM-LAN client image from your computer.

Step 5 Close the Java Application Cache Viewer.

Step 6 On the Temporary File Settings dialog box, click OK.

Step 7 On the Java Control Panel dialog box, click OK.

Step 8 If you want to reinstall the DCNM-LAN client, see the "Downloading and Launching the DCNM-LAN Client" section.


Additional References

For additional information related to installing and launching the DCNM-LAN client, see the following sections:

Related Documents

Standards

Related Documents

Related Topic
Document Title

How to use the DCNM-LAN client

Chapter 14 "Using the Cisco DCNM-LAN Client"

Starting or stopping a DCNM-LAN server

Chapter 28 "Starting and Stopping Cisco DCNM-LAN Servers"

The process of deploying DCNM-LAN in your organization

Cisco DCNM Installation and Licensing Guide, Release 5.x

Installing a DCNM-LAN server

Cisco DCNM Installation and Licensing Guide, Release 5.x


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 DCNM-LAN Client

Table 13-1 lists the release history for this feature.

Table 13-1 Feature History for Installing and Launching the DCNM-LAN Client 

Feature Name
Releases
Feature Information

Using a command prompt to download the client.

5.0(2)

Support was added for this feature.

Proxy support for the DCNM-LAN client.

5.0(2)

Support was added for this feature.