Installation Issues
When installing Cisco DCNM-SAN from windows, why does clicking install fail?
You can make sure that Java Web Start is installed properly.
DETAILED STEPS
Step 1 Go to the Programs menu and see if Java Web Start is there.
Step 2 Start the Java Web Start program to make sure there is no problem with the Java Runtime installation.
Step 3 Click the Preferences tab, and make sure the proxies settings are fine for Web Start.
Step 4 Check that your browser is set up to handle JNLP settings properly (see the “How do I manually configure a browser for Java Web Start?” section).
If you had older versions of the application and you see an error pop-up window saying cannot open the JNLP file (in the error details), this could be because the Java Web Start cache is messed up. To work around this, clear the cache and retry. To clear the cache, see the “How do I clear the Java Web Start cache?”.
Why do I have trouble launching Cisco DCNM-SAN on Solaris?
If you are using Solaris 2.8 and are logged in as root and are using Netscape Navigator 6, you will not be able to register the mime-type. Regular users can register the mime-type with Netscape Navigator 6 by manually adding it. Netscape 4.x works fine for all users.
What do I do if I see a "Java Web Start not detected" error?
If you installed Java Web Start but still see an error message (in red) saying “Java Web Start not detected...” on the switch home page, it could be a simple JavaScript error. We try to detect a Java Web Start installation by running some JavaScript code tested for Internet Explorer and Mozilla (newer versions). On some browsers (for example, Netscape 6.0, Opera) this code does not work properly although the links still work.
How do I upgrade to a newer version of Cisco DCNM-SAN or Device Manager?
DETAILED STEPS
Step 1 Close all running instances of Cisco DCNM-SAN or Device Manager.
Step 2 Point your browser at the switch running the new version and click the appropriate install link. Cisco DCNM-SAN or Device Manager prompts you to upgrade if the switch is running a newer version.
The installer checks your local copies and updates any newer versions of the software.
How do I downgrade Cisco DCNM-SAN or Device Manager?
As of Cisco MDS NX-OS Release 4.x, downgrades are not supported through the installer. To downgrade Cisco DCNM-SAN or Device Manager to an earlier release, you need to manually uninstall first and then install the previous version of Cisco DCNM-SAN or Device Manager.
What do I do if an upgrade is not working?
If you are trying to upgrade because Cisco DCNM-SAN or Device Manager prompted you saying that the switch version is higher, and the upgrade failed, it might be because your default browser settings are incorrect. Some error must have occurred during your last browser upgrade/install. To work around this, launch the browser independently and click on install.
On rare occasions, we have seen the upgrade happen but the version does not change. This is because of HTTP caching in the network. During the upgrade, HTTP requests for files on the switch get cached in the local machine. Even though the switch is in a higher version, the management software installed is at the old version. The workaround for this is to uninstall the Fabric/Device Manager, clear the Java Web Start cache, and then do a clean install.
What do I do if Java Web Start hangs on the download dialog?
You can make sure Java Web Start is set up to access the switch in the same way your browser is set up.
DETAILED STEPS
Step 1 Start
Java Web Start
(
javaws.exe
or
javaws
). You see the Java Web Start Application Manager.
Step 2 Choose File > Preferences > General and make sure your proxy settings are correct. For example, if you are using an HTTP proxy, set it up here.
Step 3 Choose Use Browser.
Step 4 Click
OK
.
How do I manually configure a browser for Java Web Start?
For browsers like Opera, certain versions of Mozilla, or Konqueror, you must manually register Java Web Start as the helper application for the JNLP files. To do this, the data you need is:
-
Description=Java Web Start
-
File Extension=jnlp
-
Mime Type=application/x-java-jnlp-file
-
Application=path-to-javaws (e.g. /usr/local/javaws/javaws)
After setting this up, you may need to restart the browser. If you see "Java Web Start not detected" warnings, you can ignore them. These warnings are based on JavaScript, and not all browsers behave well with JavaScript. Click on the install links to install Cisco DCNM-SAN or Device Manager.
Note For Windows Users: To set up Java Web Start on *.jnlp files, select Windows Explorer > Tools > Folder Options > File Types. Either change the existing setting for JNLP or add one so that *.jnlp files are opened by javaws.exe. This executable is under Program Files\Java Web Start
How do I run Java Web Start from the command line?
If you cannot get your browser to run Java Web Start, you can still run Java Web Start from the command line (javaws.exe or javaws) giving it the URL of the Cisco DCNM-SAN or Device Manager on the switch as an argument. For example, if your switch IP address is 10.0.0.1, you would use these commands to start Cisco DCNM-SAN and Device Manager:
javaws http://10.0.0.1/cgi-bin/fabric-manager.jnlp javaws http://10.0.0.1/cgi-bin/element-manager.jnlp
How do I clear the Java Web Start cache?
DETAILED STEPS
Step 1 Start the Java Web Start Application Manager (
javaws.exe
or
javaws
).
Step 2 Go to File > Preferences > Advanced and clear the applications folder or cache. You can manually delete the .javaws or cache directory. On Windows this is under Documents and Settings, and on UNIX this is under $HOME.
What do I do if during a Cisco DCNM-SAN upgrade, the installer doesn’t display a prompt to create a shortcut?
Clear the Java Web Start cache as described in
How do I clear the Java Web Start cache?
in this chapter.
What do I do if my login does not work in Cisco DCNM-SAN or Device Manager?
Make sure you have done the Initial Setup Routine on the switch.
Quick checks:
What do I do if I cannot install Cisco DCNM-SAN or Device Manager, or run Java, when pcAnyWhere is running?
You can either stop the pcAnyWhere service and install Cisco DCNM-SAN or Device Manager, or install/update DirectX. For more information,refer to the website at
www.oracle.com
What do I do if the Cisco DCNM-SAN or Performance Manager service shows up as “disabled” in the Services menu?
This could happen if:
-
The service menu for Cisco DCNM-SAN or Performance Manager was open during an uninstall/upgrade.
-
The Cisco DCNM-SAN client or Device Manager was running while doing an uninstall/upgrade.
This error happens when Windows is unable to delete a service completely. A reboot of the host should fix the problem.
What do I do if I am unable to install Cisco DCNM-SAN or Device Manager, or run Java, when McAfee Internet Suite 6.0 Professional is running?
The McAfee internet suite comes with a virus scanner, firewall, antispam, and privacy management. The privacy management can interfere with the Cisco DCNM-SAN server-client interactions. To work around this you must shut down the privacy service.
General
What do I do if I see errors while monitoring Area chart graphing?
When doing the area chart graphing from the monitor window, if you move the mouse over the Area chart before the first data comes back, you see a java.lang.ArrayIndexOutOfBoundsException error on the message log from JChart getX(). This is because JChart tries to locate a value that does not exist yet. This might be fixed in a future version of JChart.
What do I do if I see "gen error" messages?
Usually a "gen error" means that the SNMP agent on the switch had an unexpected error in the process of serving an SNMP request. However, when you are accessing the switch through a VPN connection or any sort of NAT scheme, all errors are reported as gen error. This is a known problem and will be fixed in a future release. You can verify whether this was the reason behind your gen error by trying to reproduce this error in an environment where there is no network address translation (where you are on the same network as the switch).
What do I do if disk images in the Device Manager Summary View are not visible?
On some occasions the Summary View table in the Device Manager does not show the icons for disks attached to a Fx port. This is because the FC4 features are empty for this port. A LUN discovery must be issued to discover information about these hosts/disks that do not register their FC4 types. You can do this in the Device Manager by clicking FC > Advanced > LUNs.
What do I do if I am unable to set both the D_S_TOV and E_D_TOV timers in Device Manager?
If you modify both E_D_TOV and D_S_TOV at the same time, and the new D_S_TOV value is larger than the old E_D_TOV value, you will get a WrongValue error. To work around this, you must change the values separately.
What do I do if columns in Device Manager tables are too small?
If Device Manager is trying to display a large table and your switch is running slowly, the table will come up with the tabs being hidden. To work around this, you must resize the window to see the data.
What do I do if fabric changes are not propagated onto the map (for example, links don't disappear)?
Cisco DCNM-SAN shows that a device or port is down by displaying a red cross on that port or device. However, Cisco DCNM-SAN does not remove any information that's already discovered. You must rediscover to correctly update the map.
What do I do if the PortChannel creation dialog becomes too small after several uses?
After several uses, the MemberList TextBox (in the PortChannel Create Window) does not display as it should. It changes from a long TextBox with a ComboBox for choosing ports, to a small square TextBox that is too small to choose ports. This is a known problem and will be fixed in a future release. To work around this problem, stop and restart Cisco DCNM-SAN or Device Manager.
What do I do if I see errors after IPFC configuration?
When IPFC and out of band management are configured, the Device Manager might not work using SNMPv3 if you use the IPFC address. The workaround is either to use the management interface (mgmt0) address, or to use SNMPv1/v2c over IPFC.
What do I do if Cisco DCNM-SAN or Device Manager is using the wrong network interface?
The problem happens because the underlying Java library picks a local interface arbitrarily. To work around this, supply a command line argument before starting the Fabric/Device Manager. In the desktop shortcut or shell script or batch file, add the following parameter "-Device Managerds.nmsAddress="
For example, in Windows the line looks like ".javaw.exe -Device Managerds.nmsAddress=X.X.X.X -cp .".
In desktop shortcuts, this length could exceed the maximum characters allowed. If this happens, delete the "-Dsun.java2d.ddoffscreen=false" portion to make more space. Releases 1.2 and later allow you to pick a preferred network interface.
What do I do if I see display anomalies in Cisco DCNM-SAN or Device Manager?
If you see Cisco DCNM-SAN or Device Manager submenus detached from menus, the mouse pointer in Cisco DCNM-SAN Map is slow to react to mouse movement, or a wrong tooltip is displayed, these are display anomalies, not problems with Cisco DCNM-SAN or Device Manager.
Some older video cards exhibit these display anomalies. To fix this, first try updating the video drivers. If this doesn't solve the problem, replace the video card.
What do I do if most of my Physical Attributes catagories disappear?
You have somehow turned off advanced features. Look for the check box Advanced Features in the upper right of the Cisco DCNM-SAN screen. Check the box.
What do I do if I can’t see the Information pane?
The information pane should be in the upper half of the screen above the map in Cisco DCNM-SAN. The map my be covering it. Drag the edge of the map window down or use the black triangles to reorganize the display.
Why is the active zone set in edit zone always shown in bold (even after successful activation)?
A member of this VSAN must be participating in IVR zoning. Because the IVR zones get added to active zones, the active zone set configuration is always different from the local zone set configuration with the same name. The zone set name is always bold.
Can I create a zone with prefix IVRZ or a zone set with name nozonset?
Do not use these special names. These names are used by the system for identifying IVR zones.
What do I do when One-Click License Install fails, and I cannot connect to the Cisco website?
The one-click license install tries to open an HTTP connection to the Cisco website. If you do your browsing using an HTTP proxy then the following command- line variables need to be added to your Cisco DCNM-SAN client scripts:
-Dhttps.proxyHost and -Dhttps.proxyPort.
In case your one-click install URL starts with "http://" (and not "https://"), the variables are:
-Dhttp.proxyHost and -Dhttp.proxyPort.
For example, in Windows, edit the MDS 9000\bin\FabricManager.bat file and add to the JVMARGS "-Dhttps.proxyHost=HOSTADDRESS -Dhttps.proxyPort=HOSTPORT".
How do I increase the log window size in Cisco DCNM-SAN Client?
To limit the memory usage by FM Client, the log window is limited to 500 lines by default. If you want to increase this, edit sm.properties in < install directory>/db/<user> directory and change LogBufferSize.
When do I do when the FM Server Database fails to start or has a file locking error?
In the database log (FMPersist.log) you will see an error message "The database is already in use by another process". The HsqlDB 1.7.1 version has this problem. The file lock problem seems to happen occasionally, and can be resolved by shutdown and restart of the db server. On windows this can be done by stopping and starting the FMPersist service and on Unix just run the FMPersist.sh script with the argument restart.
How do I re-synchronize Cisco DCNM-SAN Client with Cisco DCNM-SAN Server?
On some occasions, when the Cisco DCNM-SAN Client in not in sync with the Cisco DCNM-SAN Server, you may need to re-synchronize the client and server. To re-synchronize Fabrix Manager Client with Cisco DCNM-SAN Server, click Resync All Open Fabrics from the File menu,
How do I rediscover the current fabric?
When the Cisco DCNM-SAN Server is not in sync with the switches in the fabric, you may need to initiate an on- demand discovery to update the Cisco DCNM-SAN Client with the most recent changes from the switches in the fabric. To rediscover the fabric switches, click Rediscover from the File menu.
How do I rediscover SCSI Targets?
When the Cisco DCNM-SAN Server is not in sync with the SCSI Target switches in the fabric, you may need to initiate an on- demand discovery to update the Cisco DCNM-SAN Client with the most recent changes from the SCSI Target switches in the fabric. To rediscover the fabric switches, click Rediscover SCSI Targets from the File menu.
Other
How do I set the map layout so it stays after Cisco DCNM-SAN restarted?
You can arrange the map to your liking and would like to “freeze” the map so that the objects stay as they are even after you stop Cisco DCNM-SAN and restart it again.
DETAILED STEPS
Step 1 Right-click in a blank space in the map. You see a menu.
Step 2 Select Layout > Fix All Nodes from the menu.
What do I do when two switches show on the map, but there is only one switch?
If two switches show on your map, but you only have one switch, it may be that you have two switches in a non-contiguous VSAN that have the same Domain ID. Cisco DCNM-SAN uses <vsanId><domainId> to look up a switch, and this can cause the fabric discovery to assign links incorrectly between these errant switches.
The workaround is to verify that all switches use unique domain IDs within the same VSAN in a physically connected fabric. (The fabric configuration checker will do this task.)
What does a red/orange/dotted line through the switch mean?
If a red line shows through your switch, this means Fabric Manger sees something wrong with the switch. Choose Switches in the Physical Attributes pane to see a status report in the information pane. A module, fan, or power supply has failed or is offline and plugged in.
If a dotted orange line shows through your switch, this indicates a minor status warning for that switch. Usually it means an issue with one of the modules. The tooltip should say exactly what is wrong. Hold the mouse over the switch to see the tooltip.
Below are tables of color settings and tooltip definitions for Cisco DCNM-SAN and Device Manager.
Table 1-1 Cisco DCNM-SAN Client and Device Manager Color Definitions
|
|
Red Slash
|
Cannot communicate with a switch via SNMP.
|
Red X
|
Cannot communicate with or see a switch in the Domain Manager/Fabric Configuration Server list of fabric switches.
|
|
|
Green Square with Mode (e.g., F, T, TE, U/I for FICON)
|
Port up.
|
Orange Square with Mode
|
Trunk incomplete.
|
Orange Cross
|
Ols or Nos received.
|
Brown Square
|
Port is administratively down.
|
Light Gray Square
|
Port is not manageable.
|
Red Cross
|
HardwareFailure/LoopbackDiagFailure/LinkFailure
|
Red Square
|
Any other kind of configuration failure.
|
No Square or Black Square
|
Port not yet configured.
|
Table 1-2 Device Manager Tooltip Definitions
|
|
adminDown
|
The port is administratively down.
|
bitErrRTThresExceeded
|
Bit error rate too high.
|
bundleMisCfg
|
Misconfiguration in PortChannel membership detected.
|
channelAdminDown
|
This port is a member of a PortChannel and that PortChannel is administratively down.
|
channelConfigurationInProgress
|
This port is undergoing a PortChannel configuration.
|
channelOperSuspended
|
This port is a member of a PortChannel and its operational parameters are incompatible with the PortChannel parameters.
|
deniedDueToPortBinding
|
Suspended due to port binding.
|
domainAddrAssignFailureIsolation
|
The elected principal switch is not capable of performing domain address manager functions so no Nx_port traffic can be forwarded across switches, hence all Interconnect_Ports in the switch are isolated.
|
domainInvalidRCFReceived
|
Invalid RCF received.
|
domainManagerDisabled
|
Domain manager is disabled.
|
domainMaxReTxFailure
|
Domain manager failure after maximum retries.
|
domainOtherSideEportIsolation
|
The peer E port is isolated.
|
domainOverlapIsolation
|
There is a overlap in domains while attempting to connect two existing fabrics.
|
elpFailureClassFParamErr
|
Isolated for ELP failure due to class F parameter error.
|
elpFailureClassNParamErr
|
Isolated for ELP failure due to class N parameter error.
|
elpFailureInvalidFlowCTLParam
|
Isolated for ELP failure due to invalid flow control parameter.
|
elpFailureInvalidPayloadSize
|
Isolated for ELP failure due to invalid payload size.
|
elpFailureInvalidPortName
|
Isolated for ELP failure due to invalid port name.
|
elpFailureInvalidSwitchName
|
Isolated for ELP failure due to invalid switch name.
|
elpFailureInvalidTxBBCredit
|
Isolated for ELP failure due to invalid transmit B2B credit.
|
elpFailureIsolation
|
During a port initialization the prospective Interconnect_Ports find incompatible link parameters.
|
elpFailureLoopbackDetected
|
Isolated for ELP failure due to loopback detected.
|
elpFailureRatovEdtovMismatch
|
Isolated for ELP failure due to R_A_TOV or E_D_TOV mismatch.
|
elpFailureRevMismatch
|
Isolated for ELP failure due to revision mismatch.
|
elpFailureUnknownFlowCTLCode
|
Isolated for ELP failure due to invalid flow control code.
|
ePortProhibited
|
Port down because FICON prohibit mask in place for E/TE port.
|
eppFailure
|
Trunk negotiation protocol failure after maximum retries.
|
errorDisabled
|
The port is not operational due to some error conditions that require administrative attention.
|
escFailureIsolation
|
During a port initialization the prospective Interconnect_Ports are unable to proceed with initialization as a result of Exchange Switch Capabilities (ESC).
|
fabricBindingDBMismatch
|
fabric bindingactive database mismatch with peer.
|
fabricBindingDomainInvalid
|
Peer domain ID is invalid in fabric binding active database.
|
fabricBindingNoRspFromPeer
|
Fabric binding no response from peer.
|
fabricBindingSWWNNotFound
|
Peer switch WWN not found in fabric binding active database.
|
fcipPortAdminCfgChange
|
FCIP port went down due to configuration change.
|
fcipPortKeepAliveTimerExpire
|
FCIP port went down due to TCP keep alive timer expired.
|
fcipPortMaxReTx
|
FCIP port went down due to max TCP retransmissions reached the configured limit.
|
fcipPortPersistTimerExpire
|
FCIP port went down due to TCP persist timer expired.
|
fcipPortSrcAdminDown
|
FCIP port went down because the source ethernet link was administratively shutdown.
|
fcipPortSrcLinkDown
|
FCIP port went down due to ethernet link down.
|
fcipSrcModuleNotOnline
|
FCIP port went down due to source module not online.
|
fcipSrcPortRemoved
|
FCIP port went down due to source port removal.
|
fcotChksumErr
|
FSP SPROM checksum error.
|
fcotNotPresent
|
SFP (GBIC) not present.
|
fcotVendorNotSupported
|
FSP (GBIC) vendor is not supported.
|
fcspAuthenfailure
|
Fibre Channel security protocol authorization failed.
|
ficonBeingEnabled
|
FICON is being enabled.
|
ficonNoPortnumber
|
No FICON port number.
|
ficonNotEnabled
|
FICON not enabled.
|
ficonVsanDown
|
FICON VSAN is down.
|
firstPortNotUp
|
In a over subscribed line card, first port cannot be brought up in E mode when the other ports in the group are up.
|
firstPortUpAsEport
|
In a over subscribed line card, when the first port in a group is up in E mode, other ports in that group cannot be brought up.
|
hwFailure
|
Hardware failure.
|
incomAdminRxBBCreditPerBuf
|
Disabled due to incompatible admin port rxbbcredit, performance buffers.
|
incompatibleAdminMode
|
Port admin mode is incompatible with port capabilities.
|
incompatibleAdminRxBBCredit
|
Receive BB credit is incompatible.
|
incompatibleAdminRxBufferSize
|
Receive buffer size is incompatible.
|
incompatibleadminSpeed
|
Port speed is incompatible with port capabilities.
|
initializing
|
The port is being initialized.
|
interfaceRemoved
|
Interface is being removed.
|
invalidAttachment
|
Invalid attachment.
|
invalidConfig
|
This port has a misconfiguration with respect to port channels.
|
invalidFabricBindExh
|
Invalid fabric binding exchange.
|
linkFailCreditLoss
|
Link failure due to excessive credit loss indications.
|
linkFailCreditLossB2B
|
Link failure when link reset (LR) operation fails due to queue not empty.
|
linkFailDebounceTimeout
|
Link failure due to re-negotiation failed.
|
linkFailLineCardPortShutdown
|
Link failure due to port shutdown.
|
linkFailLinkReset
|
Link failure due to link reset.
|
linkFailLIPF8Rcvd
|
Link failure due to F8 LIP received.
|
linkFailLIPRcvdB2B
|
Link failure when loop initialization (LIP) operation fails due to non empty receive queue.
|
linkFailLossOfSignal
|
Link failure due to loss of signal.
|
linkFailLossOfSync
|
Link failure due to loss of sync.
|
linkFailLRRcvdB2B
|
Link failure when link reset (LR) operation fails due to non-empty receive queue.
|
linkFailNOSRcvd
|
Link failure due to non-operational sequences received.
|
linkFailOLSRcvd
|
Link failure due to offline sequences received.
|
linkFailOPNyRETB2B
|
Link failure due to open primitive signal returned while receive queue not empty.
|
linkFailOPNyTMOB2B
|
Link failure due to open primitive signal timeout while receive queue not empty.
|
linkFailPortInitFail
|
Link failure due to port initialization failure.
|
linkFailPortUnusable
|
Link failure due to port unusable.
|
linkFailRxQOverFlow
|
Link failure due to receive queue overflow.
|
linkFailTooManyINTR
|
Link failure due to excessive port interrupts.
|
linkFailure
|
Physical link failure.
|
loopbackDiagFailure
|
Loopback diagnostics failure.
|
loopbackIsolation
|
Port is connected to another port in the same switch.
|
noCommonVsanIsolation
|
Trunk is isolated because there are no common vsans with peer.
|
none
|
No failure.
|
nonParticipating
|
During loop initialization, the port is not allowed to participate in loop operations
|
offline
|
Physical link is in offline state as defined in the FC-FS standards.
|
ohmsExtLBTest
|
Link suspended due to external loopback diagnostics failure.
|
other
|
Undefined reason.
|
parentDown
|
The physical port to which this interface is bound is down.
|
peerFCIPPortClosedConnection
|
Port went down because peer FCIP port closed TCP connection.
|
peerFCIPPortResetConnection
|
Port went down because the TCP connection was reset by the peer FCIP port.
|
portBindFailure
|
Port got isolated due to port bind failure.
|
portBlocked
|
Port blocked due to FICON.
|
portChannelMembersDown
|
No operational members.
|
portFabricBindFailure
|
Port isolated due to fabric bind failure.
|
portGracefulShutdown
|
Port shutdown gracefully.
|
portVsanMismatchIsolation
|
An attempt is made to connect two switches using non-trunking ports having different port VSANs.
|
rcfInProgres
|
An isolated xE_port is transmitting a reconfigure fabric, requesting a disruptive reconfiguration in an attempt to build a single, non-isolated fabric. Only the Interconnect_Ports can become isolated.
|
srcPortNotBound
|
No source port is specified for this interface.
|
suspendedByMode
|
Port that belongs to a port channel is suspended due to incompatible operational mode.
|
suspendedBySpeed
|
Port that belongs to a port channel is suspended due to incompatible operational speed.
|
suspendedByWWN
|
Port that belongs to a port channel is suspended due to incompatible remote switch WWN.
|
swFailure
|
Software failure.
|
tooManyInvalidFLOGIs
|
Suspended due to too many invalid FLOGIs.
|
tovMismatch
|
Link isolation due to TOV mismatch
|
trunkNotFullyActive
|
Some of the VSANs which are common with the peer are not up.
|
upgradeInProgress
|
Line card upgrade in progress.
|
vsanInactive
|
Port VSAN is inactive. The port becomes operational again when the port VSAN is active.
|
vsanMismatchIsolation
|
This VSAN is not configured on both sides of a trunk port.
|
zoneMergeFailureIsolation
|
The two Interconnect_Ports cannot merge zoning configuration after having exchanged merging request for zoning.
|
zoneRemoteNoRespIsolation
|
Isolation due to remote zone server not responding.
|
How do I upgrade without losing map settings?
When you upgrade from one version of Cisco DCNM-SAN to another, there is a way to prevent the loss of map settings (enclosure names, placement on the map, etc.)
The MDS 9000/db directory contains subfolders for each user (and one for fmserver). In these subfolders are files for all discovered fabrics (*.dat) and maps (*.map). These are upgradable between versions. If you need to clear the fabric cache, you should first export the enclosures to a file to avoid losing them. Everything else aside from enclosures and map coordinates are stored on the switch. The preferences, last opened, and site_ouis.txt format doesn’t change from release to release.
How do I preserve historical data when moving Cisco DCNM-SAN server to new host?
DETAILED STEPS
Step 1 Export the enclosures to a file.
Step 2 Reinstall Cisco DCNM-SAN (if you are installing on a new host, install Cisco DCNM-SAN).
Step 3 After the installation is complete, stop Cisco DCNM-SAN Server.
Step 4 Copy the
RRD files
from the old host to the new host. Place it in the database directory (on a Windows PC, the default installation location for this directory is C:\Program Files\Cisco Systems\DCM\fm\pm\db).
Step 5 On the new host, run
PM.bat sync
from the $INSTALLDIR\dcm\fm\bin folder. This creates files and a new directory structure. There is a directory for each switch for which you have collected data.
Step 6 Continue to collect data on a specific switch by copying the
db
subfolder from that switch’s folder to the
pm
folder.
Step 7 Restart Cisco DCNM-SAN Server.
Step 8 Add the fabric to Performance Manager Collection.
Step 9 Reimport the enclosures on the new host.
Step 10 Be sure to turn off the original service on the old host.
Are there restrictions when using Cisco DCNM-SAN across FCIP?
Cisco DCNM-SAN will work with no restriction across an FCIP tunnel, as long as the tunnel is up. However, Cisco DCNM-SAN cannot automatically discover a Cisco SN5428 mgmt IP address in the fabric. For that switch, it will display a red slash through an FCIP device because of a timeout error. It will still see all targets, initiators, and ISLs attached to a Cisco SN5428 (or any other switch) as long as they appear in the name server or FSPF.
To work around this, you can manually enter the IP address in the Switches table, and click Apply. If the community string is correct, the red slash will go away. Even if the community string is incorrect, double-clicking on the Cisco SN5428 will launch the web tool.
How do I fix a "Please insure that FM server is running on localhost" message?
You may see this error message if you cannot connect to the fabric and your PC has multiple network interface cards. The problem may be that Cisco DCNM-SAN is trying to communicate through the wrong interface (you can verify this by checking the FMServer.log file).
Generally it is best to let Cisco DCNM-SAN choose the interface on startup. If you are getting the above error, something may have gone wrong.
DETAILED STEPS
Step 1 Open the server.properties file in the Cisco DCNM-SAN installation directory. On a Windows platform, this file is in C:\Program Files\Cisco Systems\dcm by default.
Step 2 Comment out the line: snmp.localaddress.
Step 3 Save and exit the file.
Step 4 Restart Cisco DCNM-SAN server.
Note There are some cases where you would not want to do this, and should manually select the interface that Cisco DCNM-SAN uses. For more information, see the“How do I run Cisco DCNM-SAN with multiple interfaces?” section.
How do I run Cisco DCNM-SAN with multiple interfaces?
If your PC has multiple interfaces (NICs), the four Cisco DCNM-SAN applications detect these interfaces automatically (ignoring loopback interfaces). Cisco DCNM-SAN Client and Device Manager detect all interfaces on your PC each time you launch them, and allow you to select one. Cisco DCNM-SAN Server and Performance Manager detect on initial install, and allows you to select one. You are not prompted again to choose an interface with these two applications.
There may be circumstances where you will want to change the interface you are using. For example:
-
If you add an interface after you have installed Cisco DCNM-SAN Server and/or Performance Manager
-
If you decide to use a different interface than the one you initially selected
-
If for any reason one of the Cisco DCNM-SAN applications did not detect multiple interfaces
Refer to the following sections, depending on which application you want to recognize the interface.
Manually specifying an interface for Cisco DCNM-SAN Server
DETAILED STEPS
Step 1 Go to the MDS 9000 folder. On a Windows platform, this folder is at C:\Program Files\Cisco Systems\MDS 9000 by default.
Step 2 Edit the server.properties file with a text editor.
Step 3 Scroll until you find the line: snmp.localaddress.
Step 4 If the line is commented, remove the comment character.
Step 5 Set the local address value to the IP address or interface name of the NIC you want to use.
Step 6 Save the file.
Step 7 Stop and restart Cisco DCNM-SAN Server.
Manually specifying an interface for Cisco DCNM-SAN Client or Device Manager
DETAILED STEPS
Step 1 Go to the MDS 9000/bin folder. On a Windows platform, this folder is at C:\Program Files\Cisco Systems\MDS 9000 by default.
Step 2 Edit the DeviceManager.bat file or the FabricManager.bat file.
Step 3 Scroll to the line that begins with set JVMARGS=
Step 4 Add the parameter -Device Managerds.nmsaddress=
ADDRESS
, where
ADDRESS
is the IP address or interface name of the NIC you want to use.
Step 5 Save the file and relaunch Cisco DCNM-SAN Client or Device Manager.
How do I configure an HTTP proxy server?
If your network uses a proxy server for HTTP requests, make sure the Java Web Start Application Manager is properly configured with the IP address of your proxy server.
DETAILED STEPS
Step 1 Launch the Java Web Start application.
Step 2 Choose File > Preferences from the Java WebStart Application Manager.
Step 3 Choose the Manual radio button and enter the IP address of the proxy server in the HTTP Proxy field.
Step 4 Enter the HTTP port number used by your proxy service in the
HTTP Port
field.
Step 5 Click OK.
How do I clear the topology map?
If you have a switch that you have removed from the fabric, there will be a red X through the switch’s icon. You can clear this information from the Cisco DCNM-SAN client, or from the Cisco DCNM-SAN server (which will clear the information for all clients) without having to reboot the switch.
DETAILED STEPS
Step 1 Click the Refresh Map icon in the Fabric pane.
This clears the information from the client.
Step 2 Click Purge Down Elements in the Server menu.
This clears the information from the server.
Caution Any devices not currently accessible (may be offline) are purged.
How can I use Cisco DCNM-SAN in a mixed software environment?
You can use Cisco DCNM-SAN version 2.0(x) to manage a mixed fabric of Cisco MDS 9000 switches. Certain 2.0 feature tabs will be empty for any switches running a software version that does not support those features.
How do I fix a "corrupted jar file" error when Launching Cisco DCNM-SAN?
If you get the following error:
An error occurred while launching the application Cisco DCNM-SAN. download error:corrupted jar file at <ipaddress>\Device Managerboot.jar
(Where <ipaddress> is that of the switch)
The error message you are getting indicates that the Java Web Start cache is corrupted. You can try clearing your Java Web Start cache first. To clear the Cache either run Java Web Start (from the Programs menu) and under the preferences select clear cache. Or do it manually by first making sure all Cisco DCNM-SAN or Device Manager instances are closed and then deleting .javaws/cache. In the newer JREs this directory is created under Documents and Settings\USERNAME and in the older ones it used to be under Program Files\Java Web Start.
You can also browse beneath the cache folder and delete the offending IPAddress folder (e.g. cache/http/D10.0.0.1).
Also, check to make sure that the host is not running a virus checker / java blocker?
You also can run the uninstall program and delete .cisco_mds directory, and then reinstall Cisco DCNM-SAN.
How do I search for Devices in a Fabric?
In Cisco DCNM-SAN, you can search for one or more devices by different attributes, including pWWN.
DETAILED STEPS
Step 1 Right-click the map and choose
Find Elements
from the drop-down menu.
You see the Find Fabric dialog box as shown in Figure 1-1.
Step 2 Choose
End Device
from the left drop-down list.
Step 3 Choose
Port WWN
from the right drop-down list.
You can also enter only part of the WWN and use a wildcard (*) character (for example, you can enter
*fb*f8
).
Figure 1-1 Find Fabric Dialog Box with End Device and Port WWN Selected
Step 4 Click
Find
in Map.
To search for devices in a zone, click Find in Zones. You see the device highlighted in the Fabric pane. Right-click any device to see the attributes for that device. You can also select a link leading to a device to see the attributes for the link.
How do I search in a table?
In Cisco DCNM-SAN, you can search for devices having one or more attributes. You can enter a search string in the Find dialog box and then use Next and Previous buttons to navigate through the results.
DETAILED STEPS
Step 1 Click the Find icon from the tool bar.
You see the Find dialog box.
Step 2 Enter the search string in the Find text box.
Step 3 Click Selection to search in selected row(s).
Step 4 Check Ignore Case to ignore case sensitivity.
Step 5 Check Exact Match to search for the data value exactly matching the search string.
Step 6 Click Next to search.
Step 7 Click Cancel to close the dialog box.
How do I manage Multiple Fabrics?
To monitor and manage multiple fabrics, you must persist one or more fabrics. Do this by checking the Persist checkbox on the Server>Admin dialog Fabric tab. You must also use switches running SAN-OS Release 1.3.x or later in both fabrics, and you must use the same user/password on both fabrics. Both fabrics must not be physically connected.
How can I clear an Orange X Through a Switch caused by license expiration?
If you are using a licensed feature and that license is allowed to expire, Cisco DCNM-SAN shows a license violation, and an orange X is placed through the switch on the Cisco DCNM-SAN map.
To clear the license violation message and the orange X, stop the Cisco DCNM-SAN service on the host, and restart it again.
How can I set a consistent unit of measure for the Performance Manager data export?
You can set Performance Manager traffic data to be exported in the same unit of measure throughout the system. The unit of measure is used for data exported to Microsoft Excel. Having a consistent unit of measure helps in sorting and analyzing the exported data.
DETAILED STEPS
Step 1 In the DCNM Web client, choose Admin > Server Properties.
Step 2 Set export.unitless to false.
Step 3 Specify the unit by setting export.unit to GB, Gb, MB, Mb, KB, Kb, B, or b, as required. Here, B denotes Bytes and b denotes Bits.
If you do not specify a unit here, or if you specify an invalid unit, then the default unit used in the web client's display will be used instead.
Note The DCNM server refers the export.unitless and export.unit properties when exporting the data to a Microsoft Excel file. If you set export.unitless to true (which is the default value), the export.unit property will be ignored by the server.
Step 4 Click Apply Changes.