SAN Health Utility

SAN Health Device Names Options

by Moderator ‎04-30-2012 12:13 PM - edited ‎03-31-2014 03:28 PM (894 Views)

For a list of SAN Health Tabs and Options Help, please see SAN Health Tabs and Options.




This Options tab has three main functions: Choosing which value to use when naming your devices in the report, adding in a custom file of names and/or values, and loading in a DCFM or EFCM Nicknames file into the SAN Health audit. Please see the on-screen instructions for each.  Please see below for CSV file specifics.


pastedImage_0 (1).png


CSV file specifics:

SAN Health optionally allows you to load a CSV file to provide the device name-to-WWN information. This CSV file can contain up to 4 columns as follows:


Column 1) Device Port World Wide Name. Note that you must use the Port WWN and not the Node WWN. The Node WWN represents the device as a whole where the Port WWN is more granular and represents the actual port that the fiber cable is connected to. The difference may not always be apparent to you, as an HBA with a single port can be zoned by both Port and Node with little difference; however this is certainly not the case when using a dual ported HBA or any multiple port device. For this reason SAN Health is set to distinguish between different ports on a single device by using the Port WWN.


Column 2) The device name as you wish it to appear in the report and on the Visio diagram. Keeping the device names to fewer than 30 characters will ensure that they fit in some of the smaller locations in the Excel report.


Column 3) An optional column. This column can be used for extra descriptive information on the device that you wish to include in the report. For example, location, firmware level, server OS and patch level, etc. This information will be added to the port details section of the Excel report and to the custom properties of the Visio diagram. If the information in this column does not exist for a given device or SAN Health cannot find a match for the specified WWN then this information is not included in the report or Visio.


Column 4) An optional column. When a value is present for a matched WWN, SAN Health will create a hyperlink using the text provided in this column. Adding custom hyperlinks provides a very powerful mechanism for integrating SAN Health with your existing management applications and other applications. Hyperlinks can launch Telnet, open files, connect to web pages, run scripts, or any number of additional tasks. When hyperlink text is found in column 4 and a matching WWN is found, SAN Health will create a hyperlink on the Device icon in Visio and on the device text in Excel. Remember that Visio groups the switch and devices together, so you need to click once to select the group and then right click on the specific device within the group to display the drop down hyperlink menu.


Note: Column 3 does not need to be present for you to use column 4.


Note that hyperlinks that reference files will only work if the files exist in the same directory as the SAN Health Report and Visio diagram. This is because the hyperlinks are created without path information.


Example CSV File:






Note: If you load a CSV file, do not forget to use the "Diagram Format" tab to specify that you wish to use the CSV Device name as a label in the Visio diagram.