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 7.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 7.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 7.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
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 7.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 7.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 7.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.
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:
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 Chapter1, “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.