Cisco MDS 9000 Family Fabric Manager Configuration Guide, Release 1.3 (from Release 1.3(1) through Release 1.3(6)) - Troubleshooting Fabric Manager Issues [Cisco MDS 9000 NX-OS and SAN-OS Software]

Table Of Contents

Troubleshooting Fabric Manager Issues

Can I Set the Map Layout So It Stays After I Restart Fabric Manager?

Two Switches Show on my Map, But I Only Have One Switch

There is a Red Line Through the Switch. What's Wrong?

There is a Dotted Orange Line Through the Switch. What's Wrong?

Can I Upgrade Without Losing My Map Settings?

Are There Any Restrictions When Using Fabric Manager Across FCIP?

Running Cisco Fabric Manager with Multiple Interfaces

Specifying an Interface for Fabric Manager Server

Specifying an Interface for Performance Manager

Specifying an Interface for Fabric Manager Client or Device Manager

Configuring a Proxy Server

Clearing Topology Maps

Can I Use Fabric Manager in a Mixed Software Environment?

Troubleshooting Fabric Manager Issues

This chapter contains some common issues you may experience while using Cisco Fabric Manager, and provides solutions.

This chapter contains the following topics:

•Can I Set the Map Layout So It Stays After I Restart Fabric Manager?

•Two Switches Show on my Map, But I Only Have One Switch

•There is a Red Line Through the Switch. What's Wrong?

•There is a Dotted Orange Line Through the Switch. What's Wrong?

•Can I Upgrade Without Losing My Map Settings?

•Are There Any Restrictions When Using Fabric Manager Across FCIP?

•Running Cisco Fabric Manager with Multiple Interfaces

•Configuring a Proxy Server

•Clearing Topology Maps

•Can I Use Fabric Manager in a Mixed Software Environment?

Can I Set the Map Layout So It Stays After I Restart Fabric Manager?

If you have arranged the map to your liking and would like to "freeze" the map so that the objects stay as they are even after you stop Fabric Manager and restart it again, do the following:

Step 1 Right-click on a blank space in the map. A menu is displayed.

Step 2 Select Layout -> Fix All Nodes from the menu.

Two Switches Show on my Map, But I Only Have 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 have the same Domain ID. Fabric Manager 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 config checker will do this task.)

There is a Red Line Through the Switch. What's Wrong?

If a red line shows through your switch, this means Fabric Manger sees something wrong with the switch. Check the Switch->Inventory report. A module, fan, or power supply has failed or is offline and plugged in.

There is a Dotted Orange Line Through the Switch. What's Wrong?

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.

Can I Upgrade Without Losing My Map Settings?

When you upgrade from one version of Fabric Manager to another, there is a way to prevent the loss of map settings (enclosure names, placement on the map, etc.)

The $HOME/.cisco_mds9000/db directory contains all discovered fabrics (*.dat) and maps (*.map). These are upgradable between 1.1 and 1.2. 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.

Are There Any Restrictions When Using Fabric Manager Across FCIP?

Fabric Manager will work with no restriction across an FCIP tunnel, as long as the tunnel is up. However, Fabric Manager 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.

Running Cisco Fabric Manager with Multiple Interfaces

If your PC has multiple interfaces (NICs), the four Cisco Fabric Manager applications detect these interfaces automatically (ignoring loopback interfaces). Fabric Manager Client and Device Manager detect all interfaces on your PC each time you launch them, and allow you to select one. Fabric Manager 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 Fabric Manager 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 Fabric Manager applications did not detect multiple interfaces

Refer to the following sections, depending on which application you want to recognize the interface.

•Specifying an Interface for Fabric Manager Server

•Specifying an Interface for Fabric Manager Client or Device Manager

•Specifying an Interface for Performance Manager

Specifying an Interface for Fabric Manager Server

To specify an interface for Fabric Manager Server, perform the following steps:

Step 1 Go to the .cisco_mds9000 folder.

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 this 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 Fabric Manager Server.

Specifying an Interface for Performance Manager

To specify an interface for Performance Manager, perform the following steps:

Step 1 Go to the .cisco_mds9000 folder.

Step 2 Edit the PMCollector.conf file with a text editor.

Step 3 Scroll until you find the line wrapper.java.additional.2=-Dmds.nmsAddress=

Step 4 If the line is commented, remove the comment character.

Step 5 Set this 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 Performance Server.

Specifying an Interface for Fabric Manager Client or Device Manager

To specify an interface for the Fabric Manager Client or Device Manager, perform the following steps:

Step 1 Go to the .cisco_mds9000/bin folder.

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 -Dmds.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 Fabric Manager Client or Device Manager.

Configuring a 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.

To configure a proxy server in the Java Web Start Application Manager, follow these steps:

Step 1 Double-click the Java Web Start application manager icon on your Windows desktop, or choose Program Files > Java Web Start.

Step 2 Select File > Preferences from the Java WebStart Application Manager.

Step 3 Click 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.

Clearing Topology Maps

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 Fabric Manager client, or from the Fabric Manager server (which will clear the information for all clients) without having to reboot the switch.

To clear information from topology maps, follow these steps:

Step 1 In the Map pane, click on the Refresh Map icon. This clears the information from the client.

Step 2 Choose Server > Purge. This clears the information from the server.

Can I Use Fabric Manager in a Mixed Software Environment?

You can use Fabric Manager version 1.3(x) to manage a mixed fabric of Cisco MDS 9000 switches. Certain 1.3 feature tabs will be empty for any switches running a software version that does not support those features.

	Cisco MDS 9000 Family Fabric Manager Configuration Guide, Release 1.3 (from Release 1.3(1) through Release 1.3(6))
	Troubleshooting Fabric Manager Issues
Cisco MDS 9000 Family Fabric Manager Configuration Guide, Release 1.3 (from Release 1.3(1) through Release 1.3(6)) Index New and Changed Information Preface Product Overview Getting Started with Cisco Fabric Manager Overview of Fabric Manager Components Before You Begin Obtaining and Installing Licenses Initial Configuration Configuring High Availability Software Images Managing Modules Managing System Hardware Configuring and Managing VSANs Configuring Interfaces Configuring Trunking Configuring PortChannels Configuring and Managing Zones Configuring Inter-VSAN Routing Managing FLOGI, Name Server, FDMI, and RSCN Databases Configuring Switch Security Configuring Fabric Security Configuring Port Security Configuring Fibre Channel Routing Services and Protocols Configuring IP Services Configuring FICON Configuring IP Storage Configuring Call Home Configuring Domain Parameters Configuring Traffic Management Configuring System Message Logging Discovering SCSI Targets Monitoring Network Traffic Using SPAN Advanced Features and Concepts Configuring Fabric Configuration Servers Monitoring System Processes and Logs Troubleshooting the Fabric Troubleshooting Fabric Manager Issues	Download this chapter Troubleshooting Fabric Manager Issues Download the complete book Full Book PDF (PDF - 7 MB) Feedback Table Of Contents Troubleshooting Fabric Manager Issues Can I Set the Map Layout So It Stays After I Restart Fabric Manager? Two Switches Show on my Map, But I Only Have One Switch There is a Red Line Through the Switch. What's Wrong? There is a Dotted Orange Line Through the Switch. What's Wrong? Can I Upgrade Without Losing My Map Settings? Are There Any Restrictions When Using Fabric Manager Across FCIP? Running Cisco Fabric Manager with Multiple Interfaces Specifying an Interface for Fabric Manager Server Specifying an Interface for Performance Manager Specifying an Interface for Fabric Manager Client or Device Manager Configuring a Proxy Server Clearing Topology Maps Can I Use Fabric Manager in a Mixed Software Environment? Troubleshooting Fabric Manager Issues This chapter contains some common issues you may experience while using Cisco Fabric Manager, and provides solutions. This chapter contains the following topics: •Can I Set the Map Layout So It Stays After I Restart Fabric Manager? •Two Switches Show on my Map, But I Only Have One Switch •There is a Red Line Through the Switch. What's Wrong? •There is a Dotted Orange Line Through the Switch. What's Wrong? •Can I Upgrade Without Losing My Map Settings? •Are There Any Restrictions When Using Fabric Manager Across FCIP? •Running Cisco Fabric Manager with Multiple Interfaces •Configuring a Proxy Server •Clearing Topology Maps •Can I Use Fabric Manager in a Mixed Software Environment? Can I Set the Map Layout So It Stays After I Restart Fabric Manager? If you have arranged the map to your liking and would like to "freeze" the map so that the objects stay as they are even after you stop Fabric Manager and restart it again, do the following: Step 1 Right-click on a blank space in the map. A menu is displayed. Step 2 Select Layout -> Fix All Nodes from the menu. Two Switches Show on my Map, But I Only Have 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 have the same Domain ID. Fabric Manager 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 config checker will do this task.) There is a Red Line Through the Switch. What's Wrong? If a red line shows through your switch, this means Fabric Manger sees something wrong with the switch. Check the Switch->Inventory report. A module, fan, or power supply has failed or is offline and plugged in. There is a Dotted Orange Line Through the Switch. What's Wrong? 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. Can I Upgrade Without Losing My Map Settings? When you upgrade from one version of Fabric Manager to another, there is a way to prevent the loss of map settings (enclosure names, placement on the map, etc.) The $HOME/.cisco_mds9000/db directory contains all discovered fabrics (.dat) and maps (.map). These are upgradable between 1.1 and 1.2. 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. Are There Any Restrictions When Using Fabric Manager Across FCIP? Fabric Manager will work with no restriction across an FCIP tunnel, as long as the tunnel is up. However, Fabric Manager 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. Running Cisco Fabric Manager with Multiple Interfaces If your PC has multiple interfaces (NICs), the four Cisco Fabric Manager applications detect these interfaces automatically (ignoring loopback interfaces). Fabric Manager Client and Device Manager detect all interfaces on your PC each time you launch them, and allow you to select one. Fabric Manager 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 Fabric Manager 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 Fabric Manager applications did not detect multiple interfaces Refer to the following sections, depending on which application you want to recognize the interface. •Specifying an Interface for Fabric Manager Server •Specifying an Interface for Fabric Manager Client or Device Manager •Specifying an Interface for Performance Manager Specifying an Interface for Fabric Manager Server To specify an interface for Fabric Manager Server, perform the following steps: Step 1 Go to the .cisco_mds9000 folder. 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 this 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 Fabric Manager Server. Specifying an Interface for Performance Manager To specify an interface for Performance Manager, perform the following steps: Step 1 Go to the .cisco_mds9000 folder. Step 2 Edit the PMCollector.conf file with a text editor. Step 3 Scroll until you find the line wrapper.java.additional.2=-Dmds.nmsAddress= Step 4 If the line is commented, remove the comment character. Step 5 Set this 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 Performance Server. Specifying an Interface for Fabric Manager Client or Device Manager To specify an interface for the Fabric Manager Client or Device Manager, perform the following steps: Step 1 Go to the .cisco_mds9000/bin folder. 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 -Dmds.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 Fabric Manager Client or Device Manager. Configuring a 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. To configure a proxy server in the Java Web Start Application Manager, follow these steps: Step 1 Double-click the Java Web Start application manager icon on your Windows desktop, or choose Program Files > Java Web Start. Step 2 Select File > Preferences from the Java WebStart Application Manager. Step 3 Click 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. Clearing Topology Maps 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 Fabric Manager client, or from the Fabric Manager server (which will clear the information for all clients) without having to reboot the switch. To clear information from topology maps, follow these steps: Step 1 In the Map pane, click on the Refresh Map icon. This clears the information from the client. Step 2 Choose Server > Purge. This clears the information from the server. Can I Use Fabric Manager in a Mixed Software Environment? You can use Fabric Manager version 1.3(x) to manage a mixed fabric of Cisco MDS 9000 switches. Certain 1.3 feature tabs will be empty for any switches running a software version that does not support those features.
	Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks