Home

Sun StorEdge Enterprise Storage Manager 1.0 Topology Reporter

1. p password password ip address sstr remove credential This command deletes a profile associated with a device Execute the sstr credentials command after using this command to confirm that the IP address and user is removed Syntax sstr remove address ip address Chapter 3 The sstr Command 105 Managing Storage This section describes the commands that enable the admin user to show and manage the storage devices ports and logical unit numbers LUNs in the SAN or DAS environment m sstr storage list on page 107 m sstr storage on page 107 m sstr storage luns on page 108 m sstr storage ports on page 108 m sstr remove storage on page 108 106 Topology Reporter Administration and Operations Guide July 2002 sstr storage list This command enables you to display information about the storage in your environment Syntax sstr storage list sstr storage This command enables you to display information about a specific storage device in your environment Information includes the device World Wide Name WWN IP address vendor or model type and firmware revision level Syntax sstr storage a annotation annotation i ip address ip address device name where annotation Text message to associate with this device Include this text in double quotes ip address IP address of the device device name device name is a name such as t 3 49 Chapt
2. 2000 SUNW qlc 1 fp 0 0 devctl sstr hba ports This command enables you to display information about HBA ports in your SAN or DAS environment Syntax sstr hba ports device path Chapter 3 The sstr Command 109 where device path device path is a device path such as devices pci 1lf 1f 2000 SUNW qlc 1 fp 0 0 devctl 110 Topology Reporter Administration and Operations Guide July 2002 Managing Discovery This command enables the admin user to show the last time asset discovery occurred last or to start asset discovery See also Setting the Discovery Interval on page 117 sstr discover Syntax sstr discover 1 last SAN and DAS Changes and Discovery Discovery is the process where software agents on agent stations retrieve information about devices in your environment The agents report it to the software and you can then view this information by using the UI or CLI at a management station The first discovery process occurs at system startup time after you install the software The software then performs its discovery process according to a set interval If you add or delete assets like hosts switches HBAs and storage in your environment you can perform a manual discovery to ensure that the new asset is reporting its status to the software v To Perform a Manual Discovery After a Change to Your SAN or DAS Configuration 1 Change add or delete an asset 2 Wait five to seven min
3. The Show Paths page under the Topology tab is displayed A graphic showing all SAN and DAS paths from the host to the storage device appears on this page The SAN graphic also displays partial paths View zone level informationby selecting a zone from the View Zones drop down menu The SAN Paths graphic might span multiple fabrics and displays both full and partial paths A DAS Path graphic appears only if the host and storage device are directly connected Chapter 2 Using the Web browser User Interface 29 v To View Zone Details 1 Click the Topology tab The Fabrics summary table is displayed 2 Click a link in the Zones column The Zone Details summary table is displayed The Zone Details summary table shows the following m Switch name Switch port Connected device name click this link for device details Connected device vendor and model number The table title includes a clickable link for the zone fabric Click this link to show graphical zone topology v To Display a Fabric s Zone 1 Click the fabric link in the Zone Details Summary table title to display the fabric topology graphic for this zone You can also click the fabric name in the Fabric column shown on the Topology page See To Show the Topology Graph or Device Details on page 29 2 From the View Zones pull down menu select one of the following a View zonename Zone where zonename is a zone name Other zones appear grayed out m View Without Zones
4. The software displays messages showing each software process stopping 8 Topology Reporter Administration and Operations Guide July 2002 Hard and Nameserver Zones The topology reporter software can display information for hard zones and name server zones Some switches enable you to configure devices within your fabric or hard zone to be part of a name server zone also known as a soft zone This section describes two zone naming situations to avoid a A Hard and Nameserver Zone Sharing the Same Name on page 10 a Nameserver Zones Sharing the Same Name on page 11 Note When creating zones use a unique name for each zone Switches from Brocade Communications Systems force you to use unique names Switches such as the Sun StorEdge Network FC Switch 8 and Switch 16 switch and Qlogic Corp switches allow you to configure nonunique nameserver zone names Chapter 1 Introduction to the Topology Reporter 9 10 A Hard and Nameserver Zone Sharing the Same Name When you create zones using a switch management tool such as the SANsurfer Switch Manager software you might create hard and nameserver zones with the same name In this case a hard zone might include an identically named nameserver zone For example FIGURE 1 1 shows m One hard zone named ZONE1 m One hard zone named ZONE2 m One nameserver zone consisting of hard ZONE2 member devices also named ZONE2 When you view these identically named zon
5. email pager interval locale The email address of the user to be notified The notification identification Use the sstr email notifications command without options to display the related notification id The severity level of the alarm Valid levels are 0 1 2 3 where 0 Down A fatal nonrecoverable error has occurred 1 Critical A serious error has occurred 2 Major A somewhat serious error has occurred 3 Minor An annoying error has occurred The medium to use to send the notification where email is 0 and pager is 1 If not specified the default is 0 email The minimum time between messages in minutes The default is 0 The user locale of sent messages locale is one of the following English French Japanese German Topology Reporter Administration and Operations Guide July 2002 sstr delet mail notification This command deletes the email notification by ID Syntax sstr delete email notification id where The notification identification Use the sstr email notifications command without options to display the related notification id Chapter3 The sstr Command 89 90 Administering SNMP Trap Notification This section describes the sst r commands that enable the admin user to manage the Simple Network Management Protocol SNMP servers and notification These commands enable the admin user to manage the SNMP trap notification service This server routes SNMP tr
6. s list of users The software then stores the user information in the software s data base Topology Reporter Administration and Operations Guide July 2002 sstr modify user This command enables the admin user to change a user s current role Syntax sstr modify user r role role user name sstr remove user This command enables the admin user to remove a user from the software s list of authorized users Syntax sstr remove user user name sstrusers Use this command to show information about all users who have been added by the software administrator using the sstr add user command This command shows the user name and role Syntax sstr users Chapter3 The sstr Command 85 86 Managing User Email Notification When a device alarm occurs email is sent by the software to users designated by the admin user These commands enable the admin user to manage this capability a sstr email notifications on page 87 m sstr create email notification on page 87 a sstr email notification on page 88 a sstr delete email notification on page 89 See also Enabling and Disabling Notification on page 118 Topology Reporter Administration and Operations Guide July 2002 sstremail notifications sstrcr This command enables you to display all users who are currently configured to receive email notification of alarms and notification ID information Syntax sstr email
7. 23 SAN and DAS Changes and Discovery 24 v To Perform a Manual Discovery After a Change to Your SAN or DAS Configuration 24 Viewing Your SAN or DAS Environment Topology Tab 25 If The Topology Page Displays An Error 27 v ToSetthe Display 27 v To Show the Topology Graph or Device Details 29 iv Topology Reporter Administration and Operations Guide July 2002 lt lt lt v To Show Host to Storage Device Paths 29 To View Zone Details 30 To Display a Fabric s Zone 30 To Show the DAS Inventory 31 Administering Users 32 Before You Add a User 33 v v v v To Add a User 33 To Modify a User s Role 33 To Delete a User 34 To Display Information About Users 34 If An Admin User Password is Lost or Forgotten 35 v To Erase User Login Information from the Data Base 35 Managing User Email Notification 36 v v v v To Create a User Email Notification Profile 37 To Modify a User Notification Profile 38 To Delete a User Notification Profile 38 To Add a Contact Email Address for the admin User 39 Administering Email Servers and Network Host Notification 40 v v v v v To Enable and Manage SMTP Email Notification 41 To Enable SNMP Ndotification 41 To Add SNMP Notification 42 To Modify SNMP Ndotification Attributes 43 To Delete an SNMP Notification Host 44 Managing Applications 45 Using the Configuration Service for Sun StorEdge T3 and T3 Arrays 46 v v To Add the Sun Storag
8. Button on page 17 a Summary Tables on page 18 Search For Drop down Menu The Search For drop down menu appears on each page in the UI This menu enables you to search for assets in your SAN or DAS environment To Search for Assets Choose one of the following from the drop down menu m Hosts m Switches m Storage m HBAs If you do not select an asset the software searches across all assets with the asset name you specify in the text field Type an asset name in the text field and click Go to search for a particular asset The UI opens the Assets page and displays a table summarizing the asset or assets found Discover Button Note See Discovery on page 2 for information about how the software gets status about your SAN or DAS environment Also Setting the Discovery Polling Interval on page 23 describes the relationship between polling intervals and alarm intervals The Discover button appears on each page in the UI Next to the Discover button is a message showing the last time the software retrieved status about the assets and alarms in your SAN or DAS environment Chapter 2 Using the Web browser User Interface 17 v 1 2 To Update the Asset and Alarm Information Click Discover Wait a few minutes for the software to update the information on the Asset and Alarms pages Summary Tables The icons shown in FIGURE 2 2 indicate that you can sort items in ascending or desce
9. Click the option button in the table to select one of the devices 8 Click Finish The Show Paths page is displayed A graphic showing all SAN and DAS paths from the host to the storage device appears on this page The SAN graphic also displays partial paths View zone level informationby selecting a zone from the View Zones drop down menu The SAN Paths graphic might span multiple fabrics and displays both full and partial paths A DAS Path graphic appears only if the host and storage device are directly connected See also Viewing Your SAN or DAS Environment Topology Tab on page 25 Chapter 2 Using the Web browser User Interface 65 v To View Storage Device Port Connections 1 Click the Assets tab The Assets page is displayed 2 Click the Storage link under the Assets tab A Storage summary table is displayed which shows the port WWN and node WWN 3 Click the link in the Name column to select a device 4 Choose Show Ports from the Storage Actions drop down menu 5 Click the option button in the table to select a device 6 Click the Attached FPorts button The Attached Ports page is displayed showing a Ports summary table The table includes the Port Type Port WWN Device Type and Device columns Note that the device in the Device column is a clickable link This link displays switch or other device details table v To View Storage Device LUNs 1 Click the Assets tab The Assets page is displayed 2 Click the
10. More SNMP Features button to access SNMP server and alarm features The More SNMP Features page is displayed This page also displays a summary table of host machines that receive SNMP alarm traps that occur in the SAN or DAS 3 Click the Add button The Add SNMP Contract page is displayed 4 Select an alarm level to trap from the Alarm Level drop down menu 5 Enter the IP address or host name of an SNMP host machine in the Hostname text field The host name of the management station machine where SNMP traps are routed must be the fully qualified host name including the domain For example martha xyzcorp com 6 Enter a port number in the Port Number text field The default SNMP port is 162 7 Choose one of the following locales from the drop down menu m English m French m German m Japanese 8 Click Save A confirmation message is displayed 42 Topology Reporter Administration and Operations Guide July 2002 v To Modify SNMP Notification Attributes 1 Click the Administration tab to display the Administration page 2 Click the More SNMP Features button to access SNMP server and alarm features The More SNMP Features page is displayed This page also displays a summary table of host machines that receive SNMP alarm traps that occur in the SAN or DAS 3 Click the Modify button The Modify SNMP Contract page is displayed You can change the SNMP host s host name SNMP port and alarm level from this page 4 Ente
11. Performing SSTR PostgreSQL database backup SSTR PostgreSQL database backup process complete Performing SSTR CRE backup SSTR CRE backup process complete SSTR backup process complete 2 Restart the software opt SUNWnsm bin sstr_ctl start The software displays messages showing each software process starting 126 Topology Reporter Administration and Operations Guide July 2002 v To Restore the Database 1 At the management station restore the database by typing opt SUNWnsm bin sstr_ctl restore The software displays messages showing each software process stopping It also displays the following messages when it starts restoring up the database Performing SSTR PostgreSQL database restore SSTR PostgreSQL database restore process complete Performing SSTR CRE restore SSTR CRE restore process complete SSTR restore process complete 2 Restart the software opt SUNWnsm bin sstr_ctl start The software displays messages showing each software process starting Displaying Software Properties The sstr_ctl printcfg command displays the current software properties such as configured ports Apache and Tomcat server names and so on The command prints the contents of the opt SUNWnsm etc sstr properties file Chapter 4 The sstr_ctl Command 127 Checking for Running Software Components Perform the following steps to ensure that th
12. Reporter 11 12 Topology Reporter Administration and Operations Guide July 2002 CHAPTER 2 Using the Web browser User Interface This section describes how to log into and to navigate the Web browser user interface UI The topology reporter enables you to view and manage your storage area network SAN or direct attached storage DAS environment through a Web browser You can also add and launch external applications such as the Storage Automated Diagnostic Environment software This chapter includes the following topics Logging into the Web Browser on page 14 Browser User Interface on page 15 Setting the Discovery Polling Interval on page 23 Viewing Your SAN or DAS Environment Topology Tab on page 25 Administering Users on page 32 Managing User Email Notification on page 36 Administering Email Servers and Network Host Notification on page 40 Managing Applications on page 45 Managing Alarms on page 48 Viewing and Managing Assets on page 52 Launching the Storage Automated Diagnostic Environment Software Health Tab on page 70 Logging into the Web Browser If you have successfully installed and started the software log in through a Web browser 1 Open the Netscape Communicator Web browser version 4 7x 2 Type the following URL in the URL text field m For an HTTP server http your hostname port nsm where your hostna
13. SAN Fabric Table 26 Topology Reporter Administration and Operations Guide July 2002 If The Topology Page Displays An Error If the Web browser displays an error on the Topology page such as following message set the display as described Topology images are not available To Set the Display From the machine where you are trying to display the topology graphics type the following usr openwin bin xhost mgmt station hostname 0 0 Where mgmt station hostname is the host name of the management station machine This step enables the management station to access your display Log into the management station machine as the root user If the topology reporter software is running stop it etc init d sstrd stop Edit the opt SUNWnsm sbin sstr tomcat file and update the DISPLAY variable to the host name where you executed the xhost command in Step 1 Change Set display DISPLAY localhost 0 0 export DISPLAY to Set display DISPLAY UlI hostname 0 0 export DISPLAY Where Ul hostname is the host name of the machine where you wish to display the topology graphics Chapter 2 Using the Web browser User Interface 27 5 Start the topology reporter software etc init d sstrd start Note Once the topology reporter software has started you can reset the xhost settings on your machine and the DISPLAY setting on the manageme
14. Storage link under the Assets tab A Storage summary table is displayed 3 Click the option button next to the Name column to select a device 4 Choose Show LUNs from the More Actions drop down menu The LUNs summary table is displayed 66 Topology Reporter Administration and Operations Guide July 2002 v To Launch a Software Application to Manage a Storage Device 1 Click the Assets tab The Assets page is displayed 2 Click the Storage link under the Assets tab A Storage summary table is displayed 3 Click an option button next to the device name to select that device 4 Click the Launch Device Manager button The software launches the related storage management application in another Web page For example the launched configuration service software for Sun StorEdge T3 storage arrays requires that you provide a user name and password to log in to the software See Managing Applications on page 45 and Using the Configuration Service for Sun StorEdge T3 and T3 Arrays on page 46 Note If you already have a configuration service Web browser window open and click the Launch Device Manager button a new window does not open That is another instance of the software is not launched v To Remove a Storage Device from the Software 1 Click the Assets tab The Assets page is displayed 2 Click the Storage link under the Assets tab A Storage summary table is displayed 3 Click the option bu
15. by id Use the sstr alarms command to list all current alarms with their IDs Syntax sstr alarm id where id The alarm identification Use the sstr alarms command without options to display the related alarm id sstr delete alarm This command enables the admin user to delete alarms according to their IDs Syntax sstr delete alarm id where id The alarm identification Use the sstr alarms command without options to display the related alarm id 94 Topology Reporter Administration and Operations Guide July 2002 Viewing Asset Status and Topology These commands enable you to display the assets and the system view of assets also known as topology m sstr assets on page 96 a sstr fabrics on page 96 a sstr fabric on page 96 m sstr das on page 97 Chapter3 The sstr Command 95 sstrassets This command displays a brief summary of all assets host host bus adapter HBA switch and storage devices Syntax sstr assets sstr fabrics This command displays all fabrics in the SAN Syntax sstr fabrics sstr fabric This command enables you to display a system view of all assets in the specified SAN fabric Syntax sstr fabric fabric name zone name Where fabric name Shows only the specified SAN fabric by name If the name includes a space character for example Primary 1 enclose the name in double quotes Primary 1 zone name Shows only the sp
16. can delete alarms The Administration page in the UI is not available to this user guest A guest has read only privileges and can use most features of the software except those that add modify or delete users attributes and devices The guest user can launch applications if the user has login access to them The Administration page in the UI is not available to this user The topics described include the following a Before You Add a User on page 33 a To Add a User on page 33 a To Modify a User s Role on page 33 a To Delete a User on page 34 a To Display Information About Users on page 34 a If An Admin User Password is Lost or Forgotten on page 35 32 Topology Reporter Administration and Operations Guide July 2002 Before You Add a User Before you add a user consider the following m Add only those users that already have a user account on the management station m Users can use their Solaris UNIX passwords to log in They can safely use these passwords because they are encrypted before verification m root and bin cannot be added to or use the software To Add a User Click the Administration tab to display the Administration page Click the Users link under the Administration tab The Manage Users page is displayed Click the Add User button Type the user name of the user you are adding in the User Name text field The user name is the user s login name for the
17. in your SAN or DAS environment It also describes how to launch a software application in another Web browser to manage a switch To View More Detail About a Switch Click the Assets tab The Assets page is displayed Click the Switches link under the Assets tab A Switches summary table is displayed This table includes switch name links IP address World Wide Name WWN vendor and model name and firmware revision level Also displayed are the Remove Launch Device Manager and Show Ports buttons Click a switch name link in the Name column The Device Detail page is displayed The detail includes m IP address and WWN m Vendor or model name m Firmware revision level m Domain ID a Annotation text field that is used to include additional information or messages about the device To add a comment about the asset type message text in the Annotation text field Click Save A confirmation page is displayed Topology Reporter Administration and Operations Guide July 2002 v 1 To View Switch Ports Click the Assets tab The Assets page is displayed Click the Switches link under the Assets tab A Switches summary table is displayed This table includes switch name links IP address World Wide Name WWN vendor and model name and firmware revision level Also displayed are the Remove Launch Device Manager and Show Ports buttons Click a switch name link in the Name column The Devic
18. into the configuration service software in a separate Web browser window you must log in and discover the device in the launched Web browser window For instance the array must already be configured for discovery by the configuration service or discovery fails If the device is already configured for discovery log in and the device is discovered automatically See the configuration service documentation listed in Related Documentation on page xvii v To Add the Sun Storage Automated Diagnostic Environment Software Application 1 Click the Administration tab 2 Scroll down the page to the Applications section The Applications section shows the Applications area 3 Type the Storage Automated Diagnostic Environment software application uniform resource locator URL address in the SADE text field This application launches when you click the Launch Health Application button on the Health page 4 Click Save 46 Topology Reporter Administration and Operations Guide July 2002 v To Select an Application for Managing Sun StorEdge T3 and T3 Arrays 1 Click the Administration tab 2 Scroll down the page to the Applications section The Applications section shows the T3 Management drop down menu 3 Choose an application for managing Sun StorEdge T3 and T3 arrays from the T3 Management drop down menu m SCCS configuration service a HiCommand Sun StorEdge 9900 Series HiCommand software 4 Type the related applica
19. machine where the software is installed The software authenticates the user against the machine s list of users The software then stores the user information in the software s data base Choose a user role from the Role drop down menu See TABLE 2 1 for a user role description Click Save A confirmation message is displayed The user can now log in to the software using his or her normal user name and password To Modify a User s Role Click the Administration tab to display the Administration page Click the Users link under the Administration tab The Manage Users page is displayed Click the button in the Users table to select the user to modify Click the Modify User button Choose a user role from the Role drop down menu See TABLE 2 1 for a user role description Chapter 2 Using the Web browser User Interface 33 34 Click Save A confirmation message is displayed The user can now log in to the software To Delete a User Click the Administration tab to display the Administration page Click the Users link under the Administration tab The Manage Users page is displayed Click the button in the Users table to select the user to delete Click the Delete User button Click the Delete button To Display Information About Users Click the Administration tab to display the Administration page Click the Users link under the Administration tab The Manage Users pa
20. to add the system administrator contact email address to the link on the Login page Status Page The Status page is the default start page for the software This page lists any current alarms in the Alarms table showing the number and severity of alarms This page also shows any installed applications that you can launch from the UI See FIGURE 2 3 Assets Page The Assets page enables you to manage and display information about your hosts switches storage and host bus adapters HBAs The default Assets page shows an Assets Summary table of all assets To Show Details about an Asset Click one of the links under the Assets page tab Summary default view for this page Hosts m Switches m Storage m HBAs Chapter 2 Using the Web browser User Interface 19 X Sun StorEdge tm Topology Reporter Status Netscape File Edit View Go Communicator Help Z 3 a ow s BO F Back Forward Reload Home Search Netscape Print Security Shop Stop Boms Gof SSCS Ws Rete EA Topology Reporter Log Out Help C Sun microsystems Status E O E O e e CT Health Administration Search for M Last Discovery Apr 17 2002 1 10 PM Status gt 0 Down 0 O Critical 0 Major 0 Minor Available Applications Application Information Webtools This application is supplied by the Web Server on the Brocade Switch Document Done 33 agag FIGURE 2 3 Status Page 20 Topology Reporte
21. ARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE Y COMPRIS NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE A L APTITUDE A UNE UTILISATION PARTICULIERE OU A L ABSENCE DE CONTREFA ON o m Ca Adobe PostScript Contents Preface xv Introduction to the Topology Reporter 1 What is the Topology Reporter 2 Discovery 2 Notification Services 3 Launching Related Applications 4 Management and Agent Station Host Machines 5 Management Station 5 Agent Station 6 Log Files 6 Getting Started 7 Starting and Stopping the Software 8 Hard and Nameserver Zones 9 A Hard and Nameserver Zone Sharing the Same Name 10 Nameserver Zones Sharing the Same Name 11 Using the Web browser User Interface 13 Logging into the Web Browser 14 Browser User Interface 15 Navigation Tips 15 Items Common to Each Page 17 Search For Drop down Menu 17 v To Search for Assets 17 Discover Button 17 v To Update the Asset and Alarm Information 18 Summary Tables 18 v To Sort Items in the Summary Table 18 Login Page 19 Status Page 19 Assets Page 19 v To Show Details about an Asset 19 Alarms Page 21 v To Show Details about Alarms by Severity Level 21 Topology Page 21 Health Tab 21 Administration Page 22 The Show Paths Button 22 Setting the Discovery Polling Interval 23 Coordinating the Discovery Polling Interval and Alarm Expiration Threshold 23 v To Set the Discovery Polling Interval
22. Also displayed are the Remove and Launch Device Manager buttons and the More Actions drop down menu 3 Click a storage name link in the Name column The Device Detail page is displayed The detail includes m Status m IP address and node WWN m Vendor or model name m Firmware revision level a Annotation text field that is used to include additional information or messages about the device m Storage Actions drop down menu 4 Type the IP address of the device in the IP Address field The IP address is displayed in summary tables when you click Save 5 To add a comment about the asset type message text in the Annotation text field 6 Click Save A confirmation page is displayed 64 Topology Reporter Administration and Operations Guide July 2002 v To View the Connection Path of the Storage Device in the SAN or DAS Environment 1 Click the Assets tab The Assets page is displayed 2 Click the Storage link under the Assets tab A Storage summary table is displayed 3 Click the link in the Name column to select a device 4 Choose Show Paths from the Storage Actions drop down menu 5 Perform one of the following at the displayed page m Click the option button and type a host name in the Host Name text field m Click the option button in the table to select one of the hosts 6 Click Next 7 Perform one of the following m Click the option button and type a storage name in the Storage Device Name text field m
23. Diagnostic Environment software Sun StorEdge Configuration Service software for the Sun StorEdge T3 and T3 storage arrays Sun StorEdge 9900 Series HiCommand software for the Sun StorEdge T3 and T3 storage arrays SANsurfer Switch Manager SUNWsmgr software for Sun switches Web servers that reside on devices such as switches such as Brocade Communications Systems WebTools Note You must install these launchable applications on all relevant platforms in your environment Topology Reporter Administration and Operations Guide July 2002 Management and Agent Station Host Machines Each machine is considered a station in your environment and can have a different role Management station Agent station You can also install the software on one machine that acts as a management station and an agent station Management Station Note Only one machine per Service Locator Protocol SLP scope can be a management station Do not install the software on more than one machine designated as a management station per scope The management station and agent stations are considered to be in the same SLP scope when each machine has the same scope setting The Sun StorEdge Enterprise Storage Manager 1 0 Topology Reporter Installation Guide describes configuring the SLP scope The management station is the machine where you can view information about and administer your devices using the UI or CLI You can also in
24. ENTATIONS AND WARRANTIES INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT ARE DISCLAIMED EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID Copyright 2002 Sun Microsystems Inc 4150 Network Circle Santa Clara California 95054 Etats Unis Tous droits r serv s Sun Microsystems Inc a les droits de propri t intellectuels relatants la technologie incorpor e dans le produit qui est d crit dans ce document En particulier et sans la limitation ces droits de propri t intellectuels peuvent inclure un ou plus des brevets am ricains num r s http www sun com patents et un ou les brevets plus suppl mentaires ou les applications de brevet en attente dans les Etats Unis et dans les autres pays Ce produit ou document est prot g par un copyright et distribu avec des licences qui en restreignent l utilisation la copie la distribution et la d compilation Aucune partie de ce produit ou document ne peut tre reproduite sous aucune forme parquelque moyen que ce soit sans l autorisation pr alable et crite de Sun et de ses bailleurs de licence s il y ena ls Le logiciel d tenu par des tiers et qui comprend la technologie relative aux polices de caract res est prot g par un copyright et licenci par des fournisseurs de Sun Des parties de ce produit pourront tre d riv es des syst mes Berkeley BSD licenci s par l Universit de C
25. NIX passwords to log in They can safely use these passwords because they are encrypted before verification m root and bin cannot added to or use the software Chapter3 The sstr Command 83 84 sstr add user Note The superuser user root has a default role of guest a user with read only privileges This command enables the software administrator a user with a role of admin to add users to the software database of authenticated users Once added a user can log into the software using his or her username and password Syntax sstr add user r role role user name where the user role is as follows admin An admin user has all administration privileges The admin user can add modify and delete users attributes and devices in the software operator An operator user can use most of the software features except those that add modify or delete users attributes and devices This user can delete alarms The Administration page in the UI is not available to this user guest A guest has read only privileges and can use most features of the software except those that add modify or delete users attributes and devices The guest user can launch applications if the user has login access to them The Administration page in the UI is not available to this user The user name is the user s login name for the machine where the software is installed The software authenticates the user against the machine
26. NMP Notification on page 42 To Modify SNMP Notification Attributes on page 43 To Delete an SNMP Notification Host on page 44 Topology Reporter Administration and Operations Guide July 2002 v 1 2 To Enable and Manage SMTP Email Notification Click the Administration tab to display the Administration page Select the On or Off buttons in the Notification E mail section These buttons enable or disable the email notification feature See also Managing User Email Notification on page 36 Click the More E Mail Features button to access SMTP server and alarm features The More E mail Features page is displayed This page also displays a summary table of users who receive notification of alarms Enter the IP address or host name of the SMTP server machine in the IP or Host text field The host name of the machine that will manage the notification feature must be the fully qualified host name including the domain For example martha xyzcorp com Click Save A confirmation message is displayed To Enable SNMP Notification Click the Administration tab to display the Administration page Select the On or Off buttons in the Notification SNMP section These buttons enable or disable the SNMP alarm trap notification feature Chapter 2 Using the Web browser User Interface 41 v To Add SNMP Notification 1 Click the Administration tab to display the Administration page 2 Click the
27. PTER 1 Introduction to the Topology Reporter This chapter describes the following topics What is the Topology Reporter on page 2 Management and Agent Station Host Machines on page 5 Log Files on page 6 Getting Started on page 7 Starting and Stopping the Software on page 8 Hard and Nameserver Zones on page 9 The Sun StorEdge Enterprise Storage Manager 1 0 Topology Reporter enables you to view and manage your storage area network SAN or direct attached storage DAS environment Using a Web browser user interface UI or the command line interface CLI you can View hardware assets such as hosts host bus adapters switches and storage devices including a graphical view of your environment Manage users alarms and assets Configure user email notification and network host notification Manage asset reporting also known as discovery Launch other management software applications related to devices in your environment What is the Topology Reporter The topology reporter includes agent management and database software installed on host machines in your environment The agent software continuously collects information from devices in your environment and stores the information in a database This database contains the information needed to build a data model of your environment The agent software updates the data model depending on discovered changes in device status You ca
28. SUNWnsm bin sstr_ct1 command is the command line interface for administrative control of the software It does not control the features of the software See the sst r 1M man page Type this command with its subcommands from a terminal command line Syntax sstr_ctl start stop s b r c p v h help TABLE 4 1 sstr_ctl Subcommands Option Description start stop s status b backup r restore c configure p printcfg v version h help Starts all software components See Starting and Stopping the Software on page 122 Stops all software components See Starting and Stopping the Software on page 122 Displays the currently running software components Backs up the database information See Backing Up and Restoring the Database on page 126 Restores the database information See Backing Up and Restoring the Database on page 126 Configures the software See Configuring the Software on page 123 Displays the current software properties such as configured ports Apache and Tomcat server names and so on See Displaying Software Properties on page 127 Displays the version information Shows a syntax usage statement 120 Topology Reporter Administration and Operations Guide July 2002 Short and Long Option Names Note When you use a double hyphen option do not type a space between hyphens The
29. Switch credentials The Show Paths Button The Show Paths button or drop down menu selection is available from many topology reporter pages For example the button is available from the Host and Storage Assets pages and HBA port details page Perform the following procedure to view the connection path of the device in your SAN or DAS environment 1 Click the Show Paths button or select Show Paths from the More Actions drop down menu 2 Perform one of the following m Click the option button and type a host name in the Host Name text field The name might already be in this field m Click the option button in the table to select one of the hosts 3 Click Next 4 Perform one of the following m Click the option button and type device name in the Storage Device name text field The name might already be in this field m Click the option button in the table to select one of the devices 5 Click Finish The Show Paths results page displays all existing paths between the selected host and storage device The SAN Paths graphic might span multiple fabrics and displays both full and partial paths A DAS Path graphic appears only if the host and storage device are directly connected 22 Topology Reporter Administration and Operations Guide July 2002 Setting the Discovery Polling Interval The Administration page enables the admin user to set the discovery polling interval Once set this polling interval determines how often
30. alifornie UNIX est une marque d pos e aux Etats Unis et dans d autres pays et licenci e exclusivement par X Open Company Ltd Sun Sun Microsystems le logo Sun AnswerBook2 docs sun com Sun StorEdge Sun StorEdge iPlanet Sun Fire Ultra Java et Solaris sont des marques de fabrique ou des marques d pos es de Sun Microsystems Inc aux Etats Unis et dans d autres pays Toutes les marques SPARC sont utilis es sous licence et sont des marques de fabrique ou des marques d pos es de SPARC International Inc aux Etats Unis et dans d autres pays Les produits protant les marques SPARC sont bas s sur une architecture d velopp e par Sun Microsystems Inc L interface d utilisation graphique OPEN LOOK et Sun a t d velopp e par Sun Microsystems Inc pour ses utilisateurs et licenci s Sun reconna t les efforts de pionniers de Xerox pour la recherche et le d ve oppment du concept des interfaces d utilisation visuelle ou graphique pour l industrie de l informatique Sun d tient une license non exclusive do Xerox sur l interface d utilisation graphique Xerox cette licence couvrant galement les licenci es de Sun qui mettent en place l interface d utilisation graphique OPEN LOOK et qui en outre se conforment aux licences crites de Sun Netscape est une marque de Netscape Communications Corporation aux Etats Unis et dans d autres pays LA DOCUMENTATION EST FOURNIE EN L TAT ET TOUTES AUTRES CONDITIONS DECLARATIONS ET G
31. aps that occur in the SAN or DAS to a particular machine hosting applications that can receive the traps m sstr snmp notifications on page 91 m sstr create snmp notification on page 91 m sstr snmp notification on page 92 a sstr delete snmp notification on page 92 See also Enabling and Disabling Notification on page 118 and Specifying the SMTP Mail Server on page 117 Topology Reporter Administration and Operations Guide July 2002 sstr snmp notifications This command enables you to display the SNMP details alarm level host name port number and locale of all machines that are currently configured to receive SNMP trap information Syntax sstr snmp notifications sstr create snmp notification This command enables the admin user to add the type of alarm notifications reported to the specified SNMP host name by alarm level port number and locale Syntax sstr create snmp notification h hostname a severity p portnumber 1 locale where hostname The host name of the machine receiving the SNMP trap information hostname must be the fully qualified hostname including the domain For example martha xyzcorp com severity The severity level of the alarm Valid levels are 0 1 2 3 where 0 Down A fatal nonrecoverable error has occurred 1 Critical A serious error has occurred 2 Major A somewhat serious error has occurred 3 Minor An annoying error has occurred portnu
32. ay information about all host bus adapters HBAs in your SAN Display information about a specific HBA Display information about HBA ports Managing Host Bus Adapters on page 109 76 Topology Reporter Administration and Operations Guide July 2002 TABLE 3 1 sstr Subcommands Sorted By Function Continued Subcommand Description See This Section Managing Switches switches Display a list of switches Managing Switches on page 101 switch Display detailed information about the switch ports port connections remove switch specified switch named switch name Display detailed information about the switch ports for the specified switch named switch name Display information about the storage device ports such as status World Wide Name WWN and so on Deletes the specified switch from the device set being managed by the software Chapter 3 The sstr Command 77 TABLE 3 1 sstr Subcommands Sorted By Function Continued Subcommand Description See This Section Managing Switch IP Addresses and Users add credential credential credentials remove credential Add a credential profile the user name password and IP address for the out of band switches currently configured in the software Change existing settings Display the user name password and IP address for the out of band switches currently configured in the software Deletes a switch credentia
33. device port Display information about the storage device ports such as status World Wide Name WWN and so on Deletes a switch credential profile IP address and associated user information Managing Discovery on page 111 Managing User Email Notification on page 86 Managing User Email Notification on page 86 Viewing Asset Status and Topology on page 95 P Managing Host Bus Adapters on page 109 Managing Host Bus Adapters on page 109 a Managing Host Bus Adapters on page 109 Managing Host Machines on page 98 a Managing Host Machines on page 98 Managing Switch Credentials IP Addresses and User Login on page 104 Administering Users on page 83 Managing Host Machines on page 98 Managing Switches on page 101 Managing Switch Credentials IP Addresses and User Login on page 104 80 Topology Reporter Administration and Operations Guide July 2002 TABLE 3 2 sstr Subcommands Sorted By Alphabetical Order Continued Command and Subcommand Description See This Section remove host remove storage remove switch remove user set property property where property is one of alarm expiration contact email discovery interval email notification logging threshold snmp notification smtp server t3 application show properties snmp notification storage
34. discovery in addition to automatic discovery 2 Topology Reporter Administration and Operations Guide July 2002 Each page in the UI includes a Discover button Next to the button is the date and time of the most recent discovery The CLI includes commands to report the most recent discovery date and time and start discovery Caution Do not click the Discover button or use the CLI to start discovery until the initial or any previous discovery process is finished See the following topics for more information about discovery m Discover Button on page 17 m Setting the Discovery Polling Interval on page 23 a Viewing Asset Status and Topology on page 95 m Managing Discovery on page 111 Notification Services The software uses the Simple Mail Transfer Protocol SMTP to send email to users each time an alarm occurs You can decide which alarm severity level gets reported to the user and how often it is reported The software also enables you to send information to applications that are able to receive Simple Network Management Protocol SNMP traps See Administering Email Servers and Network Host Notification on page 40 and Administering SNMP Trap Notification on page 90 Chapter 1 Introduction to the Topology Reporter 3 4 Launching Related Applications The software enables you to launch applications related to the devices in your SAN These applications include Storage Automated
35. down menu Choose Minutes Hours or Days This option sets how long the alarm remains active is reported on the Alarms page and then is closed by the software 3 Choose an alarm severity level from the Log Threshold drop down menu in the Logging section Note All topology reporter alarm events are at the Minor level The level that you choose enables the software to log alarms of that level and below to the log file For example select Critical to see all Critical Major and Minor alarms 4 Click Save 50 Topology Reporter Administration and Operations Guide July 2002 v To Delete Alarms 1 Click the Alarms tab The Alarms page is displayed The default view in the Alarms table shows all alarms 2 Select one or more alarms in the All Alarms table by clicking the check box to the left of the Alarm Severity column 3 Click the Delete Alarms button A confirmation page is displayed 4 Click the Delete button 5 To delete alarms by alarm severity level choose one of the following links below the Alarms tab to view alarms of that severity level Down a Critical m Major m Minor See TABLE 2 2 for a description of alarm severity levels 6 Repeat Step 2 to Step 5 Chapter 2 Using the Web browser User Interface 51 Viewing and Managing Assets This section describes the procedures that enable the admin user to view and manage assets such as hosts switches storage and host bus adapters HBAs The As
36. e 118 Topology Reporter Administration and Operations Guide July 2002 Setting the Alarm Expiration Interval This command enables the admin user to set the alarm expiration time That is how long the alarm remains active and is then closed Use this command without options to display the current alarm expiration interval If you specify more than one option the largest unit is used Note See also Coordinating the Discovery Polling Interval and Alarm Expiration Threshold on page 23 sstr set property alarm expiration Syntax sstr set property alarm expiration m minutes minutes h hour hours a days days where minutes Specifies how long the alarm remains active in minutes hours Specifies how long the alarm remains active in hours days Specifies how long the alarm remains active in days Chapter 3 The sstr Command 115 Setting the Alarm Logging Threshold Level This command enables the admin user to set the alarm severity level to log into the var sadm install logs SUNWnsm 1og file When the alarm reaches the specified or a greater severity level it is logged sstr set property logging threshold Syntax sstr set property logging threshold severity where severity The severity level of the alarm Valid levels are down A fatal nonrecoverable error has occurred critical A serious error has occurred major A somewhat serious error has occurred minor An annoying err
37. e Automated Diagnostic Environment Software Application 46 To Select an Application for Managing Sun StorEdge T3 and T3 Arrays 47 Contents v vi Managing Alarms 48 Alarm Severity Levels 48 v To Display Alarm Information 49 v To Set the Alarm Expiration Time and Threshold 50 v To Delete Alarms 51 Viewing and Managing Assets 52 v To Show Asset Details 52 Searching for Assets 54 Host Machines 54 v To View More Detail About a Host Machine 54 v To View More Detail About Host Machine HBA Connectivity 55 v To View the Paths Between the Host Machine and Its Storage Devices 56 v ToRemovea Host 57 Switches 58 v To View More Detail About a Switch 58 v To View Switch Ports 59 v To Launch a Software Application To Manage a Switch 60 v To Remove a Switch From the Software 60 Managing Switch Credentials 61 Finding the Switch IP Address User Name and Password 61 v To Add Switch Credentials 62 v To Modify Switch Credentials 62 v To Delete Switch Credentials 63 Storage 64 v To View More Detail About a Storage Device 64 v To View the Connection Path of the Storage Device in the SAN or DAS Environment 65 lt To View Storage Device Port Connections 66 lt To View Storage Device LUNs 66 Topology Reporter Administration and Operations Guide July 2002 v To Launch a Software Application to Manage a Storage Device 67 v To Remove a Storage Device from the Software 67 Host Bus Adapters 68 v To View More Detai
38. e Detail page is displayed Choose Show Ports from the Switch Actions drop down menu The Ports summary table is displayed Click the option button in the table to select a port Click the Show Attached Ports button The Attached Ports table is displayed FIGURE 2 6 Note that the device in the Device column is a clickable link For example this link displays the HBA Device Details page See To View More Detail About an HBA on page 68 Ports Attached To 200000606920280f Port Type Port WWN Device Type Device HBA 210000e08b02fdce HBA C7 FIGURE 2 6 Attached Ports Detail Table Chapter 2 Using the Web browser User Interface 59 v To Launch a Software Application To Manage a Switch 1 Click the Assets tab The Assets page is displayed 2 Click the Switches link under the Assets tab A Switches summary table is displayed 3 Click an option button next to the device name to select that device 4 Click the Launch Device Manager button The software launches the related switch management application in another Web page For example the launched software for Brocade Communications Systems switches require that you provide a user name and password to log in to the Web server residing in the switch For switches using the SANsurfer software a window opens requiring you to enter a host name for example hostname 0 0 where the application will display v To Remove a Switch From the Software 1 Click the A
39. e assets like hosts switches HBAs and storage in your environment you can perform a manual discovery to ensure that the new asset is reporting its status to the software v To Perform a Manual Discovery After a Change to Your SAN or DAS Configuration 1 Change add or delete an asset 2 Wait five to seven minutes Waiting a few minutes gives the operating environment a chance to register changes to the SAN or DAS environment This discovery takes a few minutes depending on the size of your SAN or DAS environment 3 Manually perform a discovery a If you have not done so already log into the software using the Netscape Communicator v4 7x Web browser b Click the Assets tab c Click the Discover button The asset information is displayed on the Assets page 24 Topology Reporter Administration and Operations Guide July 2002 Viewing Your SAN or DAS Environment Topology Tab Available from the Topology tab the Topology page enables you to view your SAN or DAS environment This page enables you to display up to five topology views Direct attached storage DAS shows a table with clickable links for the host and its attached storage device Storage area network SAN shows a table of fabrics in the SAN The table includes clickable links for the Fabric Name Switches and Zones Show Paths button shows SAN and DAS paths between the hosts and storage devices Fabric Graph shows a graphic representation of you
40. e in the SAN or DAS Environment on page 65 To View Storage Device Port Connections on page 66 To View Storage Device LUNs on page 66 To Launch a Software Application to Manage a Storage Device on page 67 To Remove a Storage Device from the Software on page 67 Host Bus Adapters on page 68 To View More Detail About an HBA on page 68 To View HBA Path and Port Connections on page 69 Chapter 2 Using the Web browser User Interface 53 Searching for Assets To search for assets in your environment see Search For Drop down Menu on page 17 Host Machines This section describes how to view and manage hosts machines in your SAN or DAS environment v To View More Detail About a Host Machine 1 Click the Assets tab The Assets page is displayed 2 Click the Hosts link under the Assets tab A Hosts summary table is displayed This table includes links for the host machine and vendor name 3 Click a host machine link in the Name column The Device Detail page is displayed The detail includes m Vendor and model name Operating environment revision level m Clickable links to the host machine s HBAs a Annotation text field that is used to include additional information or messages about the device a Drop down Host Actions menu with Remove View Connectivity and Show Paths as the choices 4 To associate a comment with an asset type message text in the Annotation text fi
41. e required software application processes are running v To Check for Running Components Check for running components opt SUNWnsm bin sstr_ctl status The following messages are displayed if the machine is both station types all messages display m If the machine is a management station Status of Sun StorEdge IM Topology Reporter Components Core Components PostgreSOL for SSIR i wie eee running he CRE FOr SST Revie sdeve i sa aiee running Tomcat For OSTRI wets botnet eee running Supporting Applications SPPA cee Se ait ene a a a O E A running TP PANS IMOT a euas aceon E a EE running m If the machine is an agent station Status of Sun StorEdge IM Topology Reporter Components Core Components Apache Tor SSIR G anade nE s ee running SA AO E EE E EEA running 128 Topology Reporter Administration and Operations Guide July 2002 Index A Administration page 22 32 add users 32 33 alarm threshold 23 delete users 34 email notification 36 enable SMTP 41 enable SNMP 41 modify users 33 polling interval 23 Users link 32 Adminstration page SNMP and SMTP notification 40 agent station 6 Alarms page 21 applications launching 4 assets searching for 17 Assets page 19 backing up the software database 126 browser user interface 13 logging in 14 navigation 15 C configuring the software 123 properties 124 reconfig
42. e subcommands shown in TABLE 3 1 72 Topology Reporter Administration and Operations Guide July 2002 Short and Long Option Names Note When you use a double hyphen option do not type a space between hyphens The sstr command can accept a short or long name for each option A short name option requires a single hyphen A long name option requires a double hyphen This section shows the short name option followed by the long name option in parentheses For example sstr add user r role guest user name sstr Subcommand Tables TABLE 3 1 shows the sst r subcommands sorted by function TABLE 3 2 shows the subcommands sorted by alphabetical order You can also see the sst r 1M man page Chapter 3 The sstr Command 73 TABLE 3 1 sstr Subcommands Sorted By Function Subcommand Description See This Section Administering Users and Email users add user modify user remove user create email notification email notifications email notification delete email notification set property email notification set property contact email Display information about all users added by the administrator Add a user to the database of users authorized to use the software Change existing user attributes Delete a current user Add a user who will receive notification of an alarm according to the alarm severity level by email or pager Display all users who are currently conf
43. ecified SAN fabric zone If the name includes a space character for example Zone 1 enclose the name in double quotes Zone 1 96 Topology Reporter Administration and Operations Guide July 2002 sstr das This command displays DAS direct attached storage topology instead of SAN topology Syntax sstr das Chapter3 The sstr Command 97 Managing Host Machines This section describes the commands that enable the admin user to show and manage host machines in the SAN or DAS configuration m sstr hosts on page 99 m sstr host on page 99 m sstr paths on page 99 m sstr remove host on page 100 98 Topology Reporter Administration and Operations Guide July 2002 sstr hosts This command enables you to display information about all host machines host name vendor or model and operating environment Syntax sstr hosts sstr host This command enables the admin user to show information about a specific host machine and include a text message to associate with the host Syntax sstr host a annotation annotation hostname where annotation Text message to associate with this host Include this text in double quotes hostname Name of host machine to display sstr paths This command enables you to show the storage device path for the named host and storage device Syntax sstr paths h hostname hostname s storage storage name where host
44. eld 5 Click Save A confirmation page is displayed 54 Topology Reporter Administration and Operations Guide July 2002 v To View More Detail About Host Machine HBA Connectivity 1 Click the Assets tab The Assets page is displayed 2 Click the Hosts link under the Assets tab A Hosts summary table is displayed This table includes links for the host machine and vendor name 3 Click the option button to select the host machine 4 Click the View Connectivity button The Connectivity Detail page is displayed This page shows HBA details for the HBAs installed in this host FIGURE 2 5 Host Connectivity for Host1 HBA Status Address ID World Wide Name PortType GBIC Type Node WWN AY AY AY AY AY AY AY c2 OK 0 210000e08b0286fe Unknown 210000e08b0286fe c3 Unknown 0 210100e08b24f9a2 Other 210100e08b24f9a2 c4 Unknown 0 210000e08b04f9a2 Unknown 210000e08b04f9a2 FIGURE 2 5 Host Connectivity Detail Table Chapter 2 Using the Web browser User Interface 55 v To View the Paths Between the Host Machine and Its Storage Devices 1 Click the Assets tab The Assets page is displayed 2 Click the Hosts link under the Assets tab A Hosts summary table is displayed This table includes links for the host machine and vendor name 3 Click a host machine link in the Name column The Device Detail page is displayed 4 Choose Show Paths from the Host Actions drop down menu The Show Paths page is displayed 5 Perfo
45. er 3 The sstr Command 107 sstr storage luns This command enables you to display a list of LUNs for the specified device Syntax sstr storage luns device name where device name device name is a name such as t 3 49 sstr storage ports This command enables you to display a list of storage device ports Syntax sstr storage ports device name where device name device name is a name such as t 3 49 sstr remove storage This command enables the admin user to remove the storage device from the list of devices managed by the software Syntax sstr remove storage device name where device name device name is a name such as t 3 49 108 Topology Reporter Administration and Operations Guide July 2002 Managing Host Bus Adapters This section describes the commands that enable the admin user to show and manage the host bus adapters HBAs in each host machine sstr hbas This command enables you to display information about all HBAs in your SAN or DAS environment including device path host name vendor or model name and driver or firmware revision level Syntax sstr hbas sstr hba This command enables you to display information about a specific HBA in your SAN or DAS environment including device path host name vendor or model name and driver and firmware revision Syntax sstr hba device path where device path device path is a device path such as devices pci 1lf 1f
46. es in the topology reporter UI the hard zone names include the phrase hard as part of the name For example ZONE2 hard Switch gt Hard zone ZONE2 Hard zone Wp ZONE1 aus im Nameserver zone ZONE2 Sa FIGURE 1 1 Hard and Nameserver Zone Naming To Avoid Example 1 P Topology Reporter Administration and Operations Guide July 2002 Nameserver Zones Sharing the Same Name When you create zones using a switch management tool such as the SANsurfer Switch Manager software you might create two nameserver zones in two different hardzones with the same name In this case each hard zone might include an identically named nameserver zone For example FIGURE 1 2 shows m One hard zone named ZONE1 with a nameserver zone named NSVR1 m Another hard zone named ZONE2 with a nameserver zone named NSVR1 In this case when you view the nameserver zones using the topology reporter Web browser UI or CLI only one nameserver zone named NSVR1 is shown or reported and contains the port members of both nameserver zones Hard zone names include the phrase hard as part of the name For example ZONE2 hard Switch Sun a Hard zone ZONE2 Hard zone ZONE1 2 Nameserver Nameserver zone zone NSVR1 NSVR1 FIGURE 1 2 Hard and Nameserver Zone Naming To Avoid Example 2 Chapter 1 Introduction to the Topology
47. ge on page 106 Managing Switches on page 101 Chapter3 The sstr Command 81 TABLE 3 2 sstr Subcommands Sorted By Alphabetical Order Continued Command and Subcommand Description See This Section switches Display a list of switches Managing Switches on page 101 switch ports Display detailed information about the Managing Switches on switch ports for the specified switch page 101 named switch name users Display information about all users added Administering Users on by the administrator page 83 82 Topology Reporter Administration and Operations Guide July 2002 Administering Users This section describes the sst r commands for administering users adding modifying deleting and displaying them When added a user can log into the software using his or her user name and password The user role determines user privileges See also If An Admin User Password is Lost or Forgotten on page 35 Note Do not add the superuser root user to the list of authorized users The software cannot authenticate this user a Before You Add a User on page 83 m sstr add user on page 84 a sstr modify user on page 85 m sstr remove user on page 85 m sstr users on page 85 Before You Add a User Before you add a user consider the following m Add only those users that already have a user account on the management station m Users can use their Solaris U
48. ge is displayed This page displays all users currently authorized to use the software and their role Topology Reporter Administration and Operations Guide July 2002 If An Admin User Password is Lost or Forgotten If a user with the role of admin forgets or loses his or her password and no other users with the admin role exist the administrator of the management station machine must clear the user database Caution This procedure erases all user login information for the software v To Erase User Login Information from the Data Base 1 Log into the management station as user sst r001 rlogin hostname sstr001 Password sstr Note You changed the default password shown when you installed the software 2 Source the database environment file to configure the database environment variables Bourne or Korn shell opt SUNWnsm util pgsql nsm1 bin postgres env C shell source opt SUNWnsm util pgsql nsm1 bin postgres env 3 Access the database psql 4 At the database prompt delete the user table information and exit The pound sign in this case does not indicate a root user Solaris prompt nsm1 delete from userpo nsm1 q Chapter 2 Using the Web browser User Interface 35 Managing User Email Notification Note You must enable email notification for the software to use this feature See Administering Email Servers and Network Ho
49. h port number Syntax sstr switch ports device name where device name device name is a name such as brocade55 102 Topology Reporter Administration and Operations Guide July 2002 sstr port connections This command enables you to display information about ports attached to switches Syntax sstr port connections WWN where WWN WWN is a port World Wide Name of the device such as 200000c0dd006e31 sstr remove switch This command enables the admin user to remove the switch device from the list of devices managed by the software Syntax sstr remove switch device name where device name device name is a name such as brocade55 Chapter 3 The sstr Command 103 Managing Switch Credentials IP Addresses and User Login The discovery agent of the software contacts the hardware switch for its status and identification The switch then requires a user name and password to access the devices Use these procedures to manage the IP addresses of the switch hardware and add authorized users so that the switch can report its status to the software Note If the switch requires a user name and password to access the devices and you have not entered this information through the browser user interface or command line interface you might see error messages related to XML parsing or other exceptions To fix this you need to enter the switch information into the software The typical out of the b
50. he sstr snmp notification command shows the ID Specifying the SMTP Mail Server on page 117 Administering SNMP Trap Notification on page 90 Administering SNMP Trap Notification on page 90 Managing Applications applications application set property t3 application Display the existing external applications that are launchable from the browser interface Modify the path or URL of the existing launchable applications such as the Storage Automated Diagnostic Environment software Set or change the name of the application that manages the Sun StorEdge T3 storage arrays Managing Applications on page 93 Specifying the Sun StorEdge T3 Array Application on page 118 Managing Alarms alarms alarm delete alarm set property alarm expiration Display a list of all current alarms in your SAN or DAS Display details about a specific alarm by alarm id Use the sstr alarms command to list all current alarms with their IDs Delete an alarm by its ID number Use the sstr alarms command to show alarm IDs Set alarm expiration time Managing Alarms on page 94 Managing Alarms on page 94 Setting the Alarm Expiration Interval on page 115 Chapter 3 The sstr Command 75 TABLE 3 1 sstr Subcommands Sorted By Function Continued Subcommand Description See This Section set property logging threshold Set the alarm severi
51. ice software for the Sun StorEdge T3 and T3 storage arrays m Storage Automated Diagnostic Environment software m Sun StorEdge 9900 Series HiCommand software This section describes the procedures that enable the admin user to add Web browser based launchable applications to the UI m Using the Configuration Service for Sun StorEdge T3 and T3 Arrays on page 46 m To Add the Sun Storage Automated Diagnostic Environment Software Application on page 46 m To Select an Application for Managing Sun StorEdge T3 and T3 Arrays on page 47 See also m To Launch a Software Application To Manage a Switch on page 60 m To Launch a Software Application to Manage a Storage Device on page 67 Chapter 2 Using the Web browser User Interface 45 Using the Configuration Service for Sun StorEdge T3 and T3 Arrays You can use the configuration service software as the device management tool for Sun StorEdge T3 and T3 arrays Consider the following a If you have already logged into the configuration service software in a separate Web browser window this separate window displays information about the device when you click the Launch Device Manager button from the storage Assets page Note If you already have a configuration service Web browser window open and click the Launch Device Manager button a new window does not open That is another instance of the software is not launched a If you have not logged
52. icrosystems Sun StorEdge Enterprise Storage Manager 1 0 Topology Reporter Administration and Operations Guide Sun Microsystems Inc 4150 Network Circle Santa ree A 95054 U S A 650 960 Part No ne July 2002 Revision Send comments about this document to docfeedback sun com Copyright 2002 Sun Microsystems Inc 4150 Network Circle Santa Clara California 95054 U S A All rights reserved Sun Microsystems Inc has intellectual property rights relating to terhinolopy embodied in the product that is described in this document In particular and without limitation these intellectual property rights may include one or more of the U S patents listed at ttp www sun com patents and one or more additional patents or pending patent applications in the U S and in other countries This document and the product to which it pertains are distributed under licenses restricting their use copying distribution and decompilation No part of the product or of this document may be reproduced in any form by any means without prior written authorization of Sun and its licensors if any Third party software including font technology is copyrighted and licensed from Sun suppliers Parts of the product may be derived from Berkeley BSD systems licensed from the University of California UNIX is a registered trademark in the U S and in other countries exclusively licensed through X Open Company Ltd Sun Sun Microsystems the Sun
53. igured to receive email notification of alarms and notification ID information Enables the admin user to change the attributes of a user who will receive notification of an alarm Remove a notification Enable email notification Set the administrator email contact address Administering Users on page 83 Administering Users on page 83 Managing User Email Notification on page 86 Enabling and Disabling Notification on page 118 Setting the Administrator Email Contact Address on page 116 Software Status Summary and Properties show properties Display all current software settings Showing Properties on page 113 74 Topology Reporter Administration and Operations Guide July 2002 TABLE 3 1 sstr Subcommands Sorted By Function Continued Subcommand Description See This Section Administering Email Servers and Network Host Notification set property smtp server snmp notifications create snmp notification snmp notification delete snmp notification Set the SMTP email server Use this command without options to display SNMP alarm notification details alarm level host name port number and locale Enables you to add the type of alarm notifications and host machine to report to the SNMP client by alarm level hostname port number and locale Change existing settings Deletes an email or SNMP alarm notification by its ID T
54. il Notification on page 86 Administering SNMP Trap Notification on page 90 Chapter 3 The sstr Command 79 TABLE 3 2 sstr Subcommands Sorted By Alphabetical Order Continued Command and Subcommand Description See This Section discover email notification email notifications fabric fabrics hba hbas hba ports host hosts modify address modify user paths port connections remove credential Enables the admin user to start asset discovery to retrieve the current status about hosts HBA switches and storage devices in the SAN or DAS environment or to show the last time asset discovery occurred Enables the admin user to change the attributes of a user who will receive notification of an alarm Display a list of email alarm notifications or enable or disable the notification feature Enables you to display a system view of all assets in the specified SAN fabric Display information about a specific HBA Display information about all host bus adapters HBAs in your SAN Display information about HBA ports Display information about the host specified by hostname Display information about all hosts in your environment Change existing settings Change existing user attributes Display the paths between the host and its attached storage The information shown includes the fabric zone switch name switch port device name device type and
55. iscovery Polling Interval and Alarm Expiration Threshold on page 23 Administering Email Servers and Network Host Notification on page 40 To Set the Alarm Expiration Time and Threshold on page 50 Managing Applications on page 45 Administering Users on page 32 To Add a Contact Email Address for the admin User on page 39 Starting and Stopping the Software on page 8 Not applicable Setting the Discovery Interval on page 117 Specifying the SMTP Mail Server on page 117 Administering SNMP Trap Notification on page 90 Setting the Alarm Expiration Interval on page 115 Setting the Alarm Logging Threshold Level on page 116 Managing Applications on page 93 Administering Users on page 83 Setting the Administrator Email Contact Address on page 116 Chapter 1 Introduction to the Topology Reporter 7 Starting and Stopping the Software Ensure that you start the software on the management station and each agent station after you install and configure the software as described in the Sun StorEdge Enterprise Storage Manager 1 0 Topology Reporter Installation Guide To start the software open a terminal window and type etc init d sstrd start The software displays messages showing each software process starting To stop the software open a terminal window and type etc init d sstrd stop
56. isplay or add the external applications that are launchable from the browser interface Display a brief summary of your SAN or DAS assets host host bus adapter HBA switch and storage devices Add a user who will receive notification of an alarm according to the alarm severity level by email or pager Enables you to add the type of alarm notifications and host machine to report to the SNMP client by alarm level hostname port number and locale Display the user name password and IP address for the out of band switches currently configured in the software Display DAS direct attached storage topology instead of SAN topology Delete an alarm by its ID number Use the sstr alarms command to show alarm IDs Remove a notification Deletes an email or SNMP alarm notification by its ID The sstr snmp notification command shows the ID Administering Users on page 83 Managing Switch Credentials IP Addresses and User Login on page 104 Managing Alarms on page 94 Managing Alarms on page 94 Managing Applications on page 93 Viewing Asset Status and Topology on page 95 Managing User Email Notification on page 86 Administering SNMP Trap Notification on page 90 Managing Switch Credentials IP Addresses and User Login on page 104 Viewing Asset Status and Topology on page 95 u Managing Alarms on page 94 u Managing User Ema
57. l About an HBA 68 v To View HBA Path and Port Connections 69 Launching the Storage Automated Diagnostic Environment Software Health Tab 70 v To Launch the Sun Storage Automated Diagnostic Environment Software 70 The sstr Command 71 Command Syntax and Usage Summary 72 v To Display a List of Subcommands 72 v To Display a Usage Summary of the Subcommands 72 Short and Long Option Names 73 sstr Subcommand Tables 73 Administering Users 83 Before You Adda User 83 sstradd user 84 sstrmodify user 85 sstrremove user 85 sstrusers 85 Managing User Email Notification 86 sstremail notifications 87 sstr create email notification 87 sstremail notification 88 sstr delete email notification 89 Administering SNMP Trap Notification 90 sstr snmp notifications 91 sstrcreate snmp notification 91 Contents vii ss ss tr snmp notification 92 tr delete snmp notification Managing Applications 93 ss ss trapplications 93 trapplication 93 Managing Alarms 94 ss ss ss tralarms 94 tralarm 94 trdelete alarm 94 Viewing Asset Status and Topology 95 Ss Ss Ss Ss Manag Ss ss ss ss trassets 96 tr fabrics 96 tr fabric 96 tr das 97 ing Host Machines 98 trhosts 99 trhost 99 trpaths 99 tr remove host 100 Managing Switches 101 ss ss ss ss ss Managing Switch Credentials IP Addresses and User Login ss ss viii Topology Reporter Administration a
58. l profile IP address and associated user information Managing Switch Credentials IP Addresses and User Login on page 104 Managing Storage storage list storage n torage luns n torage ports remove storage Display a list of storage devices in the environment Display information for a specific storage device Display a list of logical unit numbers LUNs for a specified storage device Display a list of ports for the specified storage device Deletes a storage device from the set of devices being managed by the software Managing Storage on page 106 78 Topology Reporter Administration and Operations Guide July 2002 TABLE 3 2 sstr Subcommands Sorted By Alphabetical Order Command and Subcommand Description See This Section add user add credential alarm alarms application applications assets create email notification create snmp notification credentials credential das delete alarm delete email notification delete snmp notification Add a user to the database of users authorized to use the software Add a credential profile the user name password and IP address for the out of band switches currently configured in the software Display details about a specific alarm by alarm id Use the sstr alarms command to list all current alarms with their IDs Display a list of all current alarms in your SAN or DAS D
59. logo AnswerBook2 docs sun com Sun StorEdge iPlanet Sun Fire Ultra Java and Solaris are trademarks or registered trademarks of Sun Microsystems Inc in the U S and in other countries All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International Inc in the U S and in other countries Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems Inc The OPEN LOOK and Sun Graphical User Interface was developed by Sun Microsystems Inc for its users and licensees Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry Sun holds a non exclusive license from Xerox to the Xerox Graphical User Interface which license also covers Sun s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun s written license agreements Netscape is a trademark or registered trademark of Netscape Communications Corporation in the United States and other countries Use duplication or disclosure by the U S Government is subject to restrictions set forth in the Sun Microsystems Inc license agreements and as provided in DFARS 227 7202 1 a and 227 7202 3 a 1995 DFARS 252 227 7013 c 1 ii Oct 1998 FAR 12 212 a 1995 FAR 52 227 19 or FAR 52 227 14 ALT III as applicable DOCUMENTATION IS PROVIDED AS IS AND ALL EXPRESS OR IMPLIED CONDITIONS REPRES
60. mber The SNMP port of the specified machine The default port is 162 locale The user locale of sent messages locale is one of the following English French Japanese German Chapter3 The sstr Command 91 sstr snmp notification This command enables the admin user to change the attributes of the machine that receives the SNMP trap notification information Syntax sstr snmp notification id h hostname a severity p portnumber 1 locale where id The notification identification Use the sstr snmp notifications command without options to display the related notification id hostname The host name of the machine receiving the SNMP trap information hostname must be the fully qualified hostname including the domain For example martha xyzcorp com severity The severity level of the alarm Valid levels are 0 1 2 3 where 0 Down A fatal nonrecoverable error has occurred 1 Critical A serious error has occurred 2 Major A somewhat serious error has occurred 3 Minor An annoying error has occurred portnumber The SNMP port of the specified machine The default port is 162 locale The user locale of sent messages locale is one of the following English French Japanese German sstr delete snmp notification This command enables the admin user to delete the SNMP notification by ID Syntax sstr delete snmp notification id where id The notification identification Use the sstr snmp no
61. me is your machine s hostname and port is its port number you configured the default is 8180 Note If you are concerned about password security use the SSL HTTP URL m For an SSL HTTP server https your hostname port nsm where your hostname is your machine s hostname and port is its port number you configured typically 8543 The Login window is displayed 3 Log in as follows User Name admin Password none leave blank 4 Click the Log In button to log in As soon as you add a user with admin mode privileges the default admin user is deleted See Administering Users on page 32 Note After users are added by the admin user and users with admin mode privileges they can log in using a normal user name and password 14 Topology Reporter Administration and Operations Guide July 2002 Browser User Interface After you log in you can access each page of the software by clicking its labelled tab m Navigation Tips on page 15 m Items Common to Each Page on page 17 m Login Page on page 19 m Status Page on page 19 a Assets Page on page 19 m Alarms Page on page 21 m Topology Page on page 21 m Health Tab on page 21 m Administration Page on page 22 m The Show Paths Button on page 22 Note The Administration tab and page is not accessible for users with a role of operator or guest Navigati
62. n view and manage this information at any time by using a Web browser or CLI For example you can view a graphic representing your environment and click parts of the graphic to see details about that host machine or device For information on the roles of host machines see Management and Agent Station Host Machines on page 5 Chapter 2 and Chapter 3 describe how to use the Web browser and CLI Discovery Note See also Setting the Discovery Polling Interval on page 23 Discovery is the process where software agents on agent stations retrieve information about devices in your environment The agents report it to the management station and the information is stored in the software s database You can then view this information by using the UI or CLI at a management station The first discovery process occurs at system startup time after you install the software After shutting down and restarting your machine the initial discovery process begins When you can first view device status depends on the size of your environment In a small SAN or DAS environment you might see information immediately In larger environments the initial discovery might take a few minutes Also discovery depends on the agents being started on agent station machines Automatic discovery always occurs at a set interval The software also enables you to m Set an interval for the software to start discovery automatically a Manually start
63. name Name of host machine to display storage name Name of the storage device to display Chapter3 The sstr Command 99 sstr remove host This command enables you to remove the specified host from the list of devices managed by the software Syntax sstr remove host hostname where hostname Name of host machine to remove 100 Topology Reporter Administration and Operations Guide July 2002 Managing Switches This section describes the commands that enable the admin user to show and manage the switch hardware in the SAN or DAS environment m sstr switches on page 102 m sstr switch ports on page 102 m sstr port connections on page 103 m sstr remove switch on page 103 a Managing Switch Credentials IP Addresses and User Login on page 104 Chapter 3 The sstr Command 101 sstr switches This command enables you to display information about all switches in your environment including device name WWN vendor or model name and firmware revision level Syntax sstr switches sstr switch This command enables you to display information about a specific switch Syntax sstr switch a annotation annotation device name where annotation Text message to associate with this device Include this text in double quotes device name device name is a name such as ancor155 sstr switch ports This command enables you to display information about a specific switc
64. nd Operations Guide July 2002 tr switches 102 tr switch 102 tr switch ports 102 tr port connections 103 tr remove switch 103 trcredentials 104 tr add credential 105 92 104 ss ss tr credential 105 tr remove credential 105 Managing Storage 106 ss ss ss ss ss tr storage list 107 tr storage 107 tr storage luns 108 tr storage ports 108 tr remove storage 108 Managing Host Bus Adapters 109 ss ss ss trhbas 109 trhba 109 trhba ports 109 Managing Discovery 111 ss tr discover 111 SAN and DAS Changes and Discovery 111 v To Perform a Manual Discovery After a Change to Your SAN or DAS Configuration 111 Showing Properties 113 ss tr show properties 113 Setting Software Properties 114 Setting the Alarm Expiration Interval 115 ss tr set property alarm expiration 115 Setting the Alarm Logging Threshold Level 116 ss tr set property logging threshold 116 Setting the Administrator Email Contact Address 116 ss tr set property contact email 116 Setting the Discovery Interval 117 ss tr set property discovery interval 117 Specifying the SMTP Mail Server 117 Contents ix sstr set property smtp server 117 Enabling and Disabling Notification 118 sstr set property email notification 118 sstr set property snmp notification 118 Specifying the Sun StorEdge T3 Array Application 118 sstr set property t3 application 118 4 Thes
65. nding order in summary tables found on the pages The light colored icon indicates the current sort order of the selected column To Sort Items in the Summary Table Click the dark colored icon to sort in the opposite order Click an icon in another column to sort that column Most tables such as the Users summary table include a button to select that table item After selecting an item you can perform a task related to that item For example see a To Modify a User s Role on page 33 Most tables also include a clickable link to see more detail about a particular device See FIGURE 2 2 Indicates that this column is currently selected to sort Asset Summary Clickable link to Quantity pi Yendor amp Model show more information AY AT AF about a device S HBA Sun Microsystems Inc qgl Switch FIGURE 2 2 Table Sorting Icons 18 Topology Reporter Administration and Operations Guide July 2002 Login Page The Login page includes the User Name and Password fields to enable the admin operator and guest users to use the UI Administering Users on page 32 describes user roles See also Logging into the Web Browser on page 14 Note If you have a user role of operator or guest and do not have access to the software click the System Administrator link on the Login page to send email to the admin user To Add a Contact Email Address for the admin User on page 39 describes how
66. notifications at mail notification This command enables the admin user to add a user who will receive notification of an alarm according to the alarm severity level The user receives the notification by email or a pager Syntax sstr create email notification e email address email address a alarm level severity m medium email pager t min interval interval 1 locale locale where email address The email address of the user to be notified severity The severity level of the alarm Valid levels are 0 1 2 3 where 0 Down A fatal nonrecoverable error has occurred 1 Critical A serious error has occurred 2 Major A somewhat serious error has occurred 3 Minor An annoying error has occurred email The medium to use to send the notification where email is 0 and pager pager is 1 If not specified the default is 0 email interval The minimum time between messages in minutes The default is 0 locale The user locale of sent messages locale is one of the following English French Japanese German Chapter 3 The sstr Command 87 88 sstremail notification This command enables the admin user to change the attributes of a user who will receive notification of an alarm Syntax sstr email notification e email address email address id m medium email pager t min interval interval 1 locale locale where email address id severity
67. nsm pgsql nsmdb log This log contains warnings and error messages from the database m var opt SUNWnsm cre cre_log This log contains messages from the Container Runtime Environment m var opt SUNWnsm tomcat eventtranslator log This log contains messages from software about events that have occurred m opt SUNWnsm util tomcat logs catalina out This log contains messages from the software about any Java servlets used in the application and any errors associated with the event translator SLP registration 6 Topology Reporter Administration and Operations Guide July 2002 Getting Started After you start the software and log in through a Web browser you can perform the following tasks to get started See Chapter 3 for command line interface equivalents for these tasks TABLE 1 1 Getting Started Tasks List Task Web Browser Command line Interface 1 Start the software 2 Log in through a Web browser 3 Set the device polling interval for the software 4 Configure email and SNMP notification 5 Set the alarm expiration interval and alarm logging threshold 6 Add the device management applications you can launch from a Web browser 7 Add users who can use the software 8 Set the system administrator contact email address The default setting for this address is blank Starting and Stopping the Software on page 8 Logging into the Web Browser on page 14 Coordinating the D
68. nt station Use the sstr_ct1 s status command to check that the topology reporter software components are running See Checking for Running Software Components on page 128 28 Topology Reporter Administration and Operations Guide July 2002 v To Show the Topology Graph or Device Details 1 Click the Topology tab The Fabrics summary table is displayed 2 Perform one of the following steps m Click a link in the Fabric Name column to show the fabric graphic A graphic representing your environment is displayed a Scroll down in the browser to see more if you have a larger environment a Click a device name or graphic icon to display the Device Detail page for that device m Click a link in the Switches column to show switch device details The page displays device details From this page you can perform switch actions See Switches on page 58 v To Show Host to Storage Device Paths 1 Click the Topology tab The Fabrics summary table is displayed 2 To view device paths click the Show Paths button 3 Perform one of the following m Click the option button and type a host name in the Host Name text field m Click the option button in the table to select one of the hosts 4 Click Next 5 Perform one of the following m Click the option button and type a storage device name in the Storage Device Name text field m Click the option button in the table to select one of the devices 6 Click Finish
69. on Tips The UI enables you to show various levels of detail about your SAN or DAS environment Typically you click links and buttons as on any other Web page to navigate the software The software also displays the navigation path on each page to show how you arrived at a page This path includes clickable underlined links so that you can return to a certain point in your navigation instead of starting at a top level page or tab For example if you just enabled a user to receive email notification of alarms and want to quickly add more users you can click the More E Mail Features link to return to the Add User button See FIGURE 2 1 The alternate method is to perform the procedure from the top level as described in To Create a User Email Notification Profile on page 37 Chapter 2 Using the Web browser User Interface 15 Click the More E mail Features link to quickly add another user Administration gt More E mail Features gt Add E mail Address The new E mail address was added Alarm Level Down gt Medium E mail gt E mail Address ftestuser somedomain com Minimum Time Between Messages 5 Minute s Locale English FIGURE 2 1 Navigation Links Example 16 Topology Reporter Administration and Operations Guide July 2002 Items Common to Each Page Navigation and status items that are common to each UI page are as follows m Search For Drop down Menu on page 17 m Discover
70. opt SUNWnsm bin sstr_ctl1 command can accept a short or long name for each option A short name option requires a single hyphen A long name option requires a double hyphen You can use the short or long name options when using this command For example to show software status type one of the following m sstr_ctl s m sstr_ctl status Chapter 4 The sstr_ctl Command 121 Starting and Stopping the Software Ensure that you start the software on the management station and each agent station after you install and configure the software as described in the Sun StorEdge Enterprise Storage Manager 1 0 Topology Reporter Installation Guide To start the software open a terminal window and type opt SUNWnsm bin sstr_ctl start The software displays messages showing each software process starting To stop the software open a terminal window and type opt SUNWnsm bin sstr_ctl stop The software displays messages showing each software process stopping 122 Topology Reporter Administration and Operations Guide July 2002 Configuring the Software Use the opt SUNWnsm bin sstr_ct1 command to configure the software on your management station and each agent station the command detects the station type The command displays a series of prompts to set your configuration In most cases you can accept the default answers The example in CODE EXAMPLE 4 1 shows the user responses in bold te
71. or has occurred Setting the Administrator Email Contact Address This command shows or sets the admin user contact email address To show the current address use the command without options sstr set property contact email Syntax sstr set property contact email admin email address where admin email address The email address of the admin user 116 Topology Reporter Administration and Operations Guide July 2002 Setting the Discovery Interval This command enables the admin user to set the interval at which discovery occurs Note See also Coordinating the Discovery Polling Interval and Alarm Expiration Threshold on page 23 sstr set property discovery interval Syntax sstr set property discovery interval polling interval where polling interval The interval in minutes when the software starts polling all assets Specifying the SMTP Mail Server This command enables the admin user to specify the mail server to use for notification Use this command without options to display the current mail server sstr set property smtp server Syntax sstr set property smtp server hostname where ip address The IP address of the mail server machine hostname The host name of the mail server machine hostname must be the fully qualified hostname including the domain For example martha xyzcorp com Chapter 3 The sstr Command 117 Enabling and Disabling Notification These command
72. own menu You can choose to send notification through email or to a pager address 6 Type the user email address in the E mail Address text field Click the Send Test E mail button to ensure that the email address is correct and operating 7 Type the minimum time between notification messages in the text field Choose the time interval from the drop down menu Minutes Hours or Days 8 Choose the user s locale from the Locale drop down menu 9 Click Save A confirmation message is displayed Chapter 2 Using the Web browser User Interface 37 v 1 2 To Modify a User Notification Profile Click the Administration tab to display the Administration page Click the More E mail Features button The More E mail Features page is displayed This page also displays a summary table of users who receive notification of alarms Click the button in the Alarm Level table to select the user to modify Click the Modify button The Modify E mail Address page is displayed You can change the medium email address notification interval and locale Click Save A confirmation message is displayed To Delete a User Notification Profile Click the Administration tab to display the Administration page Click the More E mail Features button The More E mail Features page is displayed This page also displays a summary table of users who receive notification of alarms Click the button in the Alarm Level
73. ox default login information for a switch is Username admin Password password To find out the IP address contact your system administrator or click the switch graphic in the Topology page to see the switch IP address The user name and password must match the settings you entered for the switch when you used the switch s management tool Note These commands make the software aware of switch user names and passwords and does not change existing switch settings sstr credentials This command displays the user name and IP address of all switch users currently configured in the software Syntax sstr credentials 104 Topology Reporter Administration and Operations Guide July 2002 sstr add credential This command adds and specifies a user name password and IP address profile to associate with a switch device and its related settings Syntax sstr add credential u username user name p password password ip address where user name User name to associate with an IP address password Password to assign to the user The default is a blank password if you do not use this option ip address IP address of the user sstr credential This command enables the admin user to change a user name password and IP address associated with a switch If you do not specify a password the current password is replaced with a blank password Syntax sstr credential u username user name
74. r Administration and Operations Guide July 2002 Alarms Page The Alarms page enables you to display information about any current alarms in your SAN or DAS environment To Show Details about Alarms by Severity Level Click one of the links under the Alarms page tab a All default view for this page m Down m Critical m Major a Minor Topology Page The Topology provides a top level table view of your SAN or DAS environment This page also enables you to view asset details through links to the Assets page and search for full and partial paths between a host and a storage device See Viewing Your SAN or DAS Environment Topology Tab on page 25 Health Tab When you click the Health tab another Web browser opens to enable you to use the Storage Automated Diagnostic Environment software This software requires a user name and password See Launching the Storage Automated Diagnostic Environment Software Health Tab on page 70 If this software is not installed it can be added as described in Managing Applications on page 45 Chapter 2 Using the Web browser User Interface 21 Administration Page Note The Administration tab and page is not accessible for users with a role of operator or guest Administering Users on page 32 describes user roles The Administration page enables a user with the admin role to manage m Users a Email notification m Applications m Discovery intervals m
75. r SAN when you click a Fabric Name in the fabric table Zone Details shows a summary table when you click a Zones link in the fabric table This table includes clickable links in the Device column and for the fabric in a link above the table The default view is a summary table view of the SAN fabric See FIGURE 2 4 This section describe procedures for the following m To Show the Topology Graph or Device Details on page 29 a To Show Host to Storage Device Paths on page 29 a To View Zone Details on page 30 m To Display a Fabric s Zone on page 30 a To Show the DAS Inventory on page 31 See also a Hard and Nameserver Zones on page 9 m If The Topology Page Displays An Error on page 27 a SAN and DAS Changes and Discovery on page 24 Chapter 2 Using the Web browser User Interface 25 Sun StorEdge tm Topology Reporter SAN Topology Netscape ol x Ele Edit view Go Communicator Help Z 3 4 a s BO Back Foward Reload Home Search Netscape Print Security Shop Stop 3 Bookmarks A C7 Topology Reporter Log Out Help BOOS EEM Topology SCEL E liter lice SAN DAS Search for x l Last Discovery Apr 17 2002 1 10 PM SAN Topology gt Fabrics Fabric Name Status Switches Hosts Storage Zones Aav brocade102 brocade102 brocade108 brocadeii2 brocadeii2 brocadeii3 af D Document Done FIGURE 2 4 Example Topology Page
76. r the IP address or host name of an SNMP host machine in the Hostname text field The host name of the management station machine where SNMP traps are routed must be the fully qualified host name including the domain For example martha xyzcorp com 5 Enter a port number in the Port Number text field The default SNMP port is 162 6 Choose one of the following locales from the drop down menu m English m French m German m Japanese 7 Click Save A confirmation message is displayed Chapter 2 Using the Web browser User Interface 43 v To Delete an SNMP Notification Host 1 Click the Administration tab to display the Administration page 2 Click the More SNMP Features button to access SNMP server and alarm features The More SNMP Features page is displayed This page also displays a summary table of host machines that receive SNMP alarm traps that occur in the SAN or DAS 3 Choose a host machine to delete in the SNMP Notification summary table 4 Click the Delete button A delete confirmation page is displayed 5 Click the Delete button to delete the host machine from the database 44 Topology Reporter Administration and Operations Guide July 2002 Managing Applications Users can launch software applications associated with devices in the software from the Assets page For example you can launch the following software that helps manage devices m Sun StorEdge Enterprise Storage Manager Configuration Serv
77. requires your immediate attention Minor An error or user action has occurred that requires your attention For example the admin user might have removed an asset However the error does not require your immediate attention 48 Topology Reporter Administration and Operations Guide July 2002 v To Display Alarm Information 1 Click the Alarms tab The Alarms page is displayed The default view in the Alarms table shows all alarms 2 Perform one of the following m Choose one of the following links below the Alarms tab to view alarms of that severity level a All a Down a Critical a Major a Minor m Click the link in the Description column to view details about that alarm The page shows the alarm details See TABLE 2 2 for a description of alarm severity levels 3 If the number of alarms requires more than one page to display scroll down the page and select the next page to display If a large number of alarms exist it might take a few minutes to display them all 4 To return to the alarm summary table click the All link Chapter 2 Using the Web browser User Interface 49 v To Set the Alarm Expiration Time and Threshold Note See Coordinating the Discovery Polling Interval and Alarm Expiration Threshold on page 23 1 Click the Administration tab 2 Set the alarm expiration time in the Alarms section a Type a number in the Expiration Time text field b Choose a time interval from the drop
78. rm one of the following m Click the option button and type a host name in the Host Name text field m Click the option button in the table to select one of the hosts 6 Click Next 7 Perform one of the following m Click the option button and type a storage device name in the Storage Device Name text field m Click the option button in the table to select one of the devices 8 Click Finish The Show Paths page is displayed A graphic showing all SAN and DAS paths from the host to the storage device appears on this page The SAN graphic also displays partial paths View zone level informationby selecting a zone from the View Zones drop down menu The SAN Paths graphic might span multiple fabrics and displays both full and partial paths A DAS Path graphic appears only if the host and storage device are directly connected See also Viewing Your SAN or DAS Environment Topology Tab on page 25 56 Topology Reporter Administration and Operations Guide July 2002 v To Remove a Host 1 Click the Assets tab The Assets page is displayed 2 Click the Hosts link under the Assets tab A Hosts summary table is displayed This table includes links for the host machine and vendor name 3 Click the option button to select the host machine 4 Click the Remove button to remove the host from the software Chapter 2 Using the Web browser User Interface 57 58 Switches This section describes how to view and manage switches
79. rt 1024 y n y Do you want to use the Apach mail address drew hostname domain y n y Do you want to use the SLP scope nsmscope y n y Configuration successful 124 Topology Reporter Administration and Operations Guide July 2002 v 1 2 To Configure the Software Log into your machine as the root user Configure the software opt SUNWnsm bin sstr_ctl c Respond to the prompts shown in CODE EXAMPLE 4 1 with your system information See Starting and Stopping the Software on page 122 and Logging into the Web Browser on page 14 Chapter 4 The sstr_ctl Command 125 Backing Up and Restoring the Database The agent software collects information from devices in your environment and stores it in a database This database then contains information to build a data model of your environment The agent software polls your environment and updates the data model based on any new events or changes in device status You can manually back up and restore the database information using the sstr_ct1 command To automatically back up the database use these commands as part of a cron 1M job v To Back Up the Database 1 At the management station back up the database by typing opt SUNWnsm bin sstr_ctl backup The software displays messages showing each software process stopping It also displays the following messages when it starts backing up the database
80. s Device Details page is displayed The table shown includes two buttons m Show Paths button m Show Attached Ports button Click the Show Paths button Perform one of the following at the displayed page m Click the option button and type a host name in the Host Name text field m Click the option button in the table to select one of the hosts Click Next Perform one of the following m Click the option button and type an IP address in the Storage Device IP Address text field m Click the option button in the table to select one of the devices Click Finish The Show Paths page under the Topology tab is displayed A graphic showing the path from your host to the storage device appears on this page See Viewing Your SAN or DAS Environment Topology Tab on page 25 Perform Step 1 to Step 4 Click the Show Attached Ports button The Attached Ports table is displayed See FIGURE 2 6 for an example of this table Note that the device in the Device column is a clickable link This link displays the Device Details page related to the device attached to the HBA port For example if the device is a switch see To View More Detail About a Switch on page 58 Chapter 2 Using the Web browser User Interface 69 Launching the Storage Automated Diagnostic Environment Software Health Tab When you click the Health tab another Web browser opens to enable you to use the Storage Automated Diagnostic Environmen
81. s column to select a user 8 Click the Modify button 9 Type the required information in the related text field m User Name tThe user s login name for the switch Typically this field is admin m Password The default is a blank password if you choose not to use one m Verify Password If you use a password type it again 10 Click Save A confirmation page is displayed 62 Topology Reporter Administration and Operations Guide July 2002 v To Delete Switch Credentials 1 Click the Administration tab to display the Administration page 2 Click the Out of band Credentials link under the Administration tab The Out of band Credentials page is displayed 3 Click the option button next to the IP Address column to select a user 4 Click the Delete button A confirmation page is displayed 5 Click the Delete button 6 Click Save Chapter 2 Using the Web browser User Interface 63 Storage This section describes how to view and manage storage devices in your SAN or DAS environment It also describes how to launch a software application in another Web browser to manage a storage device v To View More Detail About a Storage Device 1 Click the Assets tab The Assets page is displayed 2 Click the Storage link under the Assets tab A Storage summary table is displayed This table includes storage name links status IP address which you enter in Step 4 vendor and model name and firmware revision level
82. s enable the admin user to turn email SMTP and trap SNMP notification on Use the command without options to see the current setting sstr set property email notification Syntax sstr set property email notification on off sstr set property snmp notification Syntax sstr set property snmp notification on off Specifying the Sun StorEdge T3 Array Application This command enables the admin user to set or display the name of the management application for the Sun StorEdge T3 storage arrays Use this command without options to see the current name sstr set property t3 application Syntax sstr set property t3 application app name where app name The name of the software application SCCS or HiCommand 118 Topology Reporter Administration and Operations Guide July 2002 CHAPTER 4 The sstr_ctl Command This chapter describes the sst r_ct1 1M command Use this command to configure start and stop the topology reporter software You can also back up and restore the software database This chapter includes the following topics Command Syntax and Usage Summary on page 120 Starting and Stopping the Software on page 122 Configuring the Software on page 123 Backing Up and Restoring the Database on page 126 Displaying Software Properties on page 127 Checking for Running Software Components on page 128 119 Command Syntax and Usage Summary The opt
83. sets page initially shows an Assets summary table that provides a top level view of all devices in your SAN or DAS environment See Summary Tables on page 18 for a description of summary tables v To Show Asset Details Click one of the links under the Assets page tab a All default view for this page Hosts m Switches m Storage m HBAs A summary table for the selected asset is displayed TABLE 2 3 list the assets and sections that describe the details TABLE 2 3 Managing and Viewing Assets Asset See This Section All Searching for Assets on page 54 Host machine Host Machines on page 54 To View More Detail About a Host Machine on page 54 To View More Detail About Host Machine HBA Connectivity on page 55 To View the Paths Between the Host Machine and Its Storage Devices on page 56 Switches Switches on page 58 To View More Detail About a Switch on page 58 To View Switch Ports on page 59 To Launch a Software Application To Manage a Switch on page 60 To Remove a Switch From the Software on page 60 Managing Switch Credentials on page 61 52 Topology Reporter Administration and Operations Guide July 2002 TABLE 2 3 Managing and Viewing Assets Continued Asset See This Section Storage HBAs Storage on page 64 To View More Detail About a Storage Device on page 64 To View the Connection Path of the Storage Devic
84. ssets tab The Assets page is displayed 2 Click the Switches link under the Assets tab A Switches summary table is displayed This table includes switch name links IP address World Wide Name WWN vendor and model name and firmware revision level Also displayed are the Remove Launch Device Manager and Show Ports buttons 3 Click an option button next to the device name to select that device 4 Click the Remove button A confirmation page is displayed 5 Click the Remove button The switch is removed from the software database of devices in your SAN or DAS environment 60 Topology Reporter Administration and Operations Guide July 2002 Managing Switch Credentials The discovery agent of the software contacts the hardware switch for its status and identification The switch then requires a user name and password to access the devices Use these procedures to manage the IP addresses of the switch hardware and add an authorized user so that the switch can report its status to the software Note If the switch requires a user name and password to access the devices and you have not entered this information through the browser user interface or command line interface you might see error messages related to XML parsing or other exceptions To fix this you need to enter the switch information into the software Finding the Switch IP Address User Name and Password The typical out of the box default login informa
85. st Notification on page 40 When a device alarm occurs email is sent by the software to users designated by the admin user The Notification section of the Administration page enables the admin user to manage this capability This section describes the procedures that enable the admin user to manage user email notification a To Create a User Email Notification Profile on page 37 a To Modify a User Notification Profile on page 38 a To Delete a User Notification Profile on page 38 a To Add a Contact Email Address for the admin User on page 39 36 Topology Reporter Administration and Operations Guide July 2002 v To Create a User Email Notification Profile 1 Click the Administration tab to display the Administration page 2 Click the More E mail Features button The More E mail Features page is displayed This page also displays a summary table of users who receive notification of alarms 3 Click the Add button in the Alarm Levels section The Add E mail Address page is displayed 4 Choose an alarm level from the Alarm Level drop down menu The user you create receives email notification of alarms occurring at this level For example select Critical to send all Critical alarms Tip If you want the user to receive notification of other alarms levels repeat all steps in this section for each alarm level for that user 5 Choose how the user receives notification from the Medium drop d
86. stall the agent software on this machine and use it as a management and agent station The management station runs Web server software that enables you to access the UI through a Web browser You can use the Web browser on the management station or from any machine that has access to the management station Chapter 1 Introduction to the Topology Reporter 5 Agent Station The agent station can be one or more machines in your environment where the software collects information about your devices such as hosts host bus adapters switches and storage devices You then use the UI or CLI on the management station to view this information This information collection process is known as discovery You must install the agent station portion of the software on each host connected to a SAN or switch fabric that is switch and storage devices and their attributes If you install the software on some hosts but not all you will only partially discover information Log Files Over time the var opt SUNWnsm cre cre_log and opt SUNWnsm util tomcat logs catalina out files can become large Make sure that you check these files occasionally so that they do not consume more disk space than desired The software logs information to the following log files m var sadm install logs SUNWnsm log This log contains error or informational messages m var adm messages This log contains general system error or informational messages m var opt SUNW
87. storage list storage luns storage ports switch Remove the specified host from the list of devices managed by the software Deletes a storage device from the set of devices being managed by the software Deletes the specified switch from the device set being managed by the software Delete a current user Set software settings such as alarm expiration time alarm logging threshold asset discovery interval and so on Display all current software settings Enables the admin user to change the attributes of the machine that receives the SNMP trap notification information Display information for a specific storage device Display a list of storage devices in the SAN To show information for a single storage device use the device name where device name is a name such as t3 49 Display a list of logical unit numbers LUNs for a specified storage device Display a list of ports for the specified storage device Display detailed information about the specified switch named switch name Managing Host Machines on page 98 Managing Storage on page 106 Managing Switches on page 101 Administering Users on page 83 Setting Software Properties on page 114 Showing Properties on page 113 Administering SNMP Trap Notification on page 90 Managing Storage on page 106 Managing Storage on page 106 Managing Storage on page 106 Managing Stora
88. str_ctl Subcommands 120 xiii xiv Topology Reporter Administration and Operations Guide July 2002 Preface This document describes the administration and operation of the Sun StorEdge Enterprise Storage Manager 1 0 Topology Reporter The intended audience for this document includes Sun support engineers storage area network SAN administrators and direct attached storage DAS administrators How This Book Is Organized Chapter 1 describes the software and its features Chapter 2 describes the Web browser user interface and how to perform related tasks through this interface Chapter 3 describes the command line interface and how to perform related tasks through this interface Chapter 4 describes the sst r_ct1 command and database backup and restore procedures XV Using UNIX Commands This document might not contain information on basic UNIX commands and procedures such as shutting down the system booting the system and configuring devices See one or more of the following for this information m Solaris Handbook for Sun Peripherals xvi AnswerBook2 TM online documentation for the Solaris operating environment Other software documentation that you received with your system Typographic Conventions Typeface Meaning Examples AaBbCc123 AaBbCc123 AaBbCc123 arg arg The names of commands files and directories on screen computer output What you
89. str_ctlCommand 119 Command Syntax and Usage Summary 120 sstr_ctl start stop s b r c l p v hl help 120 Short and Long Option Names 121 Starting and Stopping the Software 122 Configuring the Software 123 If You Configure the Software More Than Once 123 Default Ports for Installation 123 Where Configuration Information is Stored 124 v To Configure the Software 125 Backing Up and Restoring the Database 126 v To Back Up the Database 126 v To Restore the Database 127 Displaying Software Properties 127 Checking for Running Software Components 128 v To Check for Running Components 128 x Topology Reporter Administration and Operations Guide July 2002 Figures FIGURE 1 1 FIGURE 1 2 FIGURE 2 1 FIGURE 2 2 FIGURE 2 3 FIGURE 2 4 FIGURE 2 5 FIGURE 2 6 Hard and Nameserver Zone Naming To Avoid Example 1 10 Hard and Nameserver Zone Naming To Avoid Example 2 11 Navigation Links Example 16 Table Sorting Icons 18 Status Page 20 Example Topology Page SAN Fabric Table 26 Host Connectivity Detail Table 55 Attached Ports Detail Table 59 xi xii Topology Reporter Administration and Operations Guide July 2002 Tables TABLE 1 1 TABLE 2 1 TABLE 2 2 TABLE 2 3 TABLE 3 1 TABLE 3 2 TABLE 4 1 Getting Started Tasks List 7 User Roles 32 Alarm Severity Levels 48 Managing and Viewing Assets 52 sstr Subcommands Sorted By Function 74 sstr Subcommands Sorted By Alphabetical Order 79 s
90. t software This software requires a user name and password You add this application as described in Managing Applications on page 45 Note If you already have a Storage Automated Diagnostic Environment Web browser window open and click the Launch Health Application button a new window does not open That is another instance of the software is not launched v To Launch the Sun Storage Automated Diagnostic Environment Software 1 Click the Health tab 2 Click the Launch Health Application button A new Web browser opens 3 Enter a user name and password The Master Configuration window is displayed See the Storage Automatic Diagnostic Environment User Guide for more information 70 Topology Reporter Administration and Operations Guide July 2002 CHAPTER 3 The sstr Command Note Issue these commands from the management station This chapter describes the topology reporter opt SUNWnsm bin sstr command line and options The sst r command enables you to perform the same software operations as you can by using the Web browser user interface UI Any changes you make by using this command are shown in the UI when you refresh or reload the related page in your browser This chapter includes the following topics Command Syntax and Usage Summary on page 72 Administering Users on page 83 Managing User Email Notification on page 86 Administering SNMP Trap No
91. table to select the user to delete The Delete E mail Address page is displayed and asks if you want to delete the user Click the Delete button A confirmation message is displayed 38 Topology Reporter Administration and Operations Guide July 2002 v To Add a Contact Email Address for the admin User 1 Click the Administration tab to display the Administration page 2 Scroll down the page to the Miscellaneous section 3 Type an email address for the admin user in the Contact E mail text field This email address is the address associated with the system administrator link on the Login page see Login Page on page 19 4 Click Save Chapter 2 Using the Web browser User Interface 39 40 Administering Email Servers and Network Host Notification When a device alarm occurs email is sent by the software to users designated by the admin user The host machine where the alarm occurred also routes the alarm information to a management station machine You can then view this alarm information on the Alarm page The Notification section of the Administration page enables the admin user to manage this capability This section describes the procedures that enable the admin user to manage the Simple Mail Transfer Protocol SMTP and Simple Network Management Protocol SNMP servers and notification To Enable and Manage SMTP Email Notification on page 41 To Enable SNMP Notification on page 41 To Add S
92. the software retrieves information and status about devices in your SAN or DAS environment You can set the interval in minutes Depending on your environment size you can have the software poll devices more or less frequently In a small SAN or DAS environment where the device configuration is stable and device state does not change very often you might set the polling interval to 15 minutes In an environment where device configuration is less stable or in a large SAN environment where the device configuration is complex you might set the polling interval to a longer time perhaps 30 minutes Coordinating the Discovery Polling Interval and Alarm Expiration Threshold You might need to coordinate the polling interval time and the alarm expiration threshold For example if you set the polling interval at 10 minutes and alarm expiration threshold at 5 minutes it is possible that alarms might have occurred and expired that is not been reported to the software You would not see alarms in the UI but they would have occurred Note See To Set the Alarm Expiration Time and Threshold on page 50 v To Set the Discovery Polling Interval 1 Click the Administration tab to display the Administration page 2 Scroll down to the Miscellaneous region 3 Enter a number in the Polling Interval text field 4 Click Save Chapter 2 Using the Web browser User Interface 23 SAN and DAS Changes and Discovery If you add or delet
93. tification on page 90 Managing Applications on page 93 Managing Alarms on page 94 Viewing Asset Status and Topology on page 95 Managing Host Machines on page 98 Managing Switches on page 101 Managing Storage on page 106 Managing Host Bus Adapters on page 109 Managing Discovery on page 111 Showing Properties on page 113 Setting Software Properties on page 114 71 Command Syntax and Usage Summary The sstr 1M command is the command line interface CLI for the software The sstr command enables you to display your storage area network SAN and direct attached storage DAS host host bus adapter HBA switch and storage device information It also enables you to manage users alarms and user email options These commands are the CLI equivalent of functions that are also available from the UI You can type this command with its subcommands and options from a terminal command line from the management station Depending on your role as identified by the administrative user admin you might not be able to execute all commands The three roles associated with the software permissions are admin operator and guest TABLE 2 1 v To Display a List of Subcommands Type sstr help v To Display a Usage Summary of the Subcommands Type sstr subcommand help where subcommand is one of th
94. tifications command without options to display the related notification id 92 Topology Reporter Administration and Operations Guide July 2002 Managing Applications This section describes the commands that enable the admin user to manage software applications Users can launch these external applications from the software UI See also Specifying the Sun StorEdge T3 Array Application on page 118 sstr applications This command enables you to show the software application that is currently configured in the software The application information includes its name and its path or Uniform Resource Locator URL location Syntax sstr applications sstr application This command enables the admin user to change the application path or URL Syntax sstr application 1 location app name where location The path or URL where the software application is located app name The name of the software application Chapter3 The sstr Command 93 Managing Alarms This section describes the sst r commands that enable the admin user to manage alarms according to their ID and severity level See also Setting the Alarm Expiration Interval on page 115 and Setting the Alarm Logging Threshold Level on page 116 sstr alarms The commands enables you to display a list of current alarms in your SAN or DAS Syntax sstr alarms sstr alarm This command enables you to display details about a specific alarm
95. tion for a switch is Username admin Password password To find the IP address contact your system administrator or click the switch graphic in the Topology page to see the switch IP address The user name and password must match the settings you entered for the switch when you used the switch s management tool Note This step makes the software aware of switch user names and passwords and does not change existing switch settings Chapter 2 Using the Web browser User Interface 61 v To Add Switch Credentials Note These steps makes the software aware of switch user names and passwords and does not change existing switch settings 1 Click the Administration tab to display the Administration page 2 Click the Out of band Credentials link under the Administration tab The Out of band Credentials page is displayed 3 Click the Add button 4 Type the required information in the related text field a Address IP address of the switch m User Name tThe user s login name for the switch Typically this field is admin m Password The default is a blank password if you choose not to use one m Verify Password If you use a password type it again 5 Click Save A confirmation page is displayed v To Modify Switch Credentials 6 Click the Out of band Credentials link under the Administration tab The Out of band Credentials page is displayed 7 Click the option button next to the IP Addres
96. tion s uniform resource locator URL address in the HiCommand or SSCS text field This application launches when you click the Launch Device Manager button associated with storage devices from the storage Assets page See Using the Configuration Service for Sun StorEdge T3 and T3 Arrays on page 46 and To Launch a Software Application to Manage a Storage Device on page 67 5 Click Save Chapter 2 Using the Web browser User Interface 47 Managing Alarms This section describes the procedures that enable the admin user to view and manage alarms The Status page is the default page shown after you log in and it shows an Alarms summary table a Alarm Severity Levels on page 48 a To Display Alarm Information on page 49 a To Set the Alarm Expiration Time and Threshold on page 50 m To Delete Alarms on page 51 Alarm Severity Levels The software reports alarms occurring at four alarm levels shown in TABLE 2 2 TABLE 2 2 Alarm Severity Levels Alarm Severity Level Description Down A fatal nonrecoverable error has occurred For example this error level occurs when a storage array is offline or unreachable Critical A serious error has occurred For example this alarm type might occur if one or more subsystems fail This alarm type requires your immediate attention Major A serious error has occurred For example this alarm type might occur if one subsystem has failed This alarm type
97. torEdge Enterprise Storage Manager 1 0 816 4294 Configuration Service Installation Guide Sun StorEdge Network FC Switch 8 and Switch 16 816 0830 Installation and Configuration Guide Sun StorEdge SAN 3 0 Release Sun StorEdge SAN 4 0 Release Installation Guide 816 4469 System administration Sun StorEdge Enterprise Storage Manager 1 0 816 4295 Configuration Service Administrator s Guide Service Location Protocol Administration Guide 806 1412 Diagnostic Storage Automatic Diagnostic Environment User 816 3142 Guide Preface xvii Application Title Part Number User manual SANbox 8 16 Segmented Loop Switch Management 875 3060 User s Manual SANbox 8 16 Segmented Loop Fibre Channel Switch 875 1881 Installer s User s Manual SANbox 16 Segmented Loop Fibre Channel Switch 875 3059 Installer s User s Manual Accessing Sun Documentation Online A broad selection of Sun system documentation is located at http www sun com products n solutions hardware docs A complete set of Solaris documentation and many other titles are located at http docs sun com Sun Welcomes Your Comments Sun is interested in improving its documentation and welcomes your comments and suggestions You can email your comments to Sun at docfeedback sun com Please include the part number 816 4293 10 of your document in the subject line of your email xviii Topology Reporter Administration and Operations Guide July 2002 CHA
98. tton next to the Name column to select a device 4 Click the Remove button A confirmation page is displayed 5 Click the Remove button The storage device is removed from the software database of devices in your SAN or DAS environment Chapter 2 Using the Web browser User Interface 67 Host Bus Adapters This section describes how to view and manage HBAs in your SAN or DAS environment v To View More Detail About an HBA 1 Click the Assets tab The Assets page is displayed 2 Click the HBAs link under the Assets tab An HBA summary table is displayed This table includes device path device name links host name vendor or model name and firmware revision level 3 Click a device name link in the Path column The Device Detail page is displayed The detail includes Host name of the machine where the HBA is installed m Device path m Vendor or model name m Firmware revision level m Show Ports button to view HBA port details 68 Topology Reporter Administration and Operations Guide July 2002 v 1 10 11 To View HBA Path and Port Connections Click the Assets tab The Assets page is displayed Click the HBAs link under the Assets tab An HBA summary table is displayed This table includes device path device name links host name vendor or model name and firmware revision level Click the option button next to the Device Path column to select a device Click the Show Ports button A Port
99. ty level to log Setting the Alarm Logging Threshold Level on page 116 Viewing Assets and Managing Discovery assets discover das fabric fabrics set property discovery interval Display a brief summary of your SAN or DAS assets host host bus adapter HBA switch and storage devices Forces the software to retrieve the current status about hosts HBA switches and storage devices in the SAN or DAS environment Display DAS direct attached storage topology instead of SAN topology Enables you to display a system view of all assets in the specified SAN fabric Set the interval at which discovery occurs Viewing Asset Status and Topology on page 95 Managing Discovery on page 111 Viewing Asset Status and Topology on page 95 Setting the Discovery Interval on page 117 Managing Host Machines hosts host paths remove host Display information about all hosts in your environment Display information about the host specified by hostname Display the paths between the host and its attached storage The information shown includes the fabric zone switch name switch port device name device type and device port Remove the specified host from the list of devices managed by the software Managing Host Machines on page 98 Managing Host Machines on page 98 Managing Host Bus Adapters hbas hba hba ports Displ
100. type when contrasted with on screen computer output Book titles new words or terms words to be emphasized Replace command line variables with real names or values In syntax brackets indicate that an argument is optional In syntax braces and pipes indicate that one of the arguments must be specified At the end of a command line the backslash indicates that the command continues on the next line Edit your login file Use 1s a to list all files o You have mail su Password Read Chapter 6 in the User s Guide These are called class options You must be superuser to do this To delete a file type rm filename scmadm d sec r n n L n z sndradm R b p s atm90 dev md rdsk d5 dev md rdsk d1 atm89 dev md rdsk d5 bitmaps map2 ip sync Topology Reporter Administration and Operations Guide July 2002 Shell Prompts Shell Prompt C shell C shell superuser machine name machine name Bourne shell and Korn shell s Bourne shell and Korn shell superuser Related Documentation Application Title Part Number Man pages sstr N A sstr_ctl Release Sun StorEdge Enterprise Storage Manager 1 0 816 4292 Topology Reporter Release Notes Sun StorEdge Enterprise Storage Manager 1 0 816 4296 Configuration Service Release Notes Installation Sun StorEdge Enterprise Storage Manager 1 0 816 4291 Topology Reporter Installation Guide Sun S
101. uring 123 script responses 124 sstr_ctl 123 D Discover button 17 discovery 2 17 Discover button 17 polling interval 23 H Health tab 21 L launching applications 4 log files 6 logging in 14 management station 5 129 N navigation 15 notification 3 add user 38 delete user email profile 38 email 36 enable and manage 41 SNMP and SMTP 40 P polling interval 23 R restoring the software database 127 S Search For menu 17 searching for assets 17 software backup 121 126 configure 121 configuring 123 print configuration information 121 restore 121 127 start 120 121 status 121 stop 121 version 121 web browser 14 sstr_ctl 119 back 126 configure 123 restore 127 start 8 122 stop 8 syntax 120 starting the software 122 station agent 6 management 5 Status page 19 stopping the software 122 summary tables 18 T Topology page 21 25 troubleshooting installation running software components 128 U users add 33 add admin contact email 39 add an email notification profile 38 create an email notification profile 37 delete 34 delete an email notification profile 38 modify 33 130 Topology Reporter Administration and Operations Guide July 2002
102. utes Waiting a few minutes gives the operating environment a chance to register changes to the SAN or DAS environment This discovery takes a few minutes depending on the size of your SAN or DAS environment Chapter3 The sstr Command 111 3 Manually perform a discovery and check for the new asset a Type opt SUNWnsm bin sstr discover b Check for the new asset by typing opt SUNWnsm bin sstr assets 112 Topology Reporter Administration and Operations Guide July 2002 Showing Properties This command enables you to show the current settings for the software including the following m Alarm expiration time a Alarm logging threshold m Discovery interval m Sun StorEdge T3 array launchable application a Email SMTP and Trap SNMP notification status a SNMP server m Email contact address sstr show properties Syntax sstr show properties Chapter 3 The sstr Command 113 114 Setting Software Properties This command enables the admin user to set properties such as the following Setting the Alarm Expiration Interval on page 115 Setting the Alarm Logging Threshold Level on page 116 Setting the Administrator Email Contact Address on page 116 Setting the Discovery Interval on page 117 Specifying the SMTP Mail Server on page 117 Enabling and Disabling Notification on page 118 Specifying the Sun StorEdge T3 Array Application on pag
103. which shows the entire fabric The zone graphic appears Note See also Hard and Nameserver Zones on page 9 30 Topology Reporter Administration and Operations Guide July 2002 v To Show the DAS Inventory 1 Click the Topology tab 2 Click the DAS link under the Topology tab The Direct Attached Storage summary table appears Each host with directly attached storage is shown 3 Click one of the following to show device details Host link in the Host column m Storage device link in the Storage column 4 Click the Show Paths button to show details about the connection paths between a host and its storage See The Show Paths Button on page 22 Chapter 2 Using the Web browser User Interface 31 Administering Users The following sections describe how to administer users through the Administration page As the admin user you can add modify and delete users that you authorize to use the software Once added a user can log into the software using his or her user name and password The user role determines user privileges TABLE 2 1 describes user roles TABLE 2 1 User Roles User Role Description admin An admin user has all administration privileges The admin user can add modify and delete users attributes and devices in the software operator An operator user can use most of the software features except those that add modify or delete users attributes and devices This user
104. xt If You Configure the Software More Than Once If you install and configure the software and then want to reconfigure it later you must stop the software If you do not stop the software and it is running while you attempt to configure it the software detects that ports are in use When you run the sstr_ct1 c command the software allows you to choose the next available port number For example it will allow you to choose port 8280 but not port 8180 To stop the software type the following on the management station and each agent station opt SUNWnsm bin sstr_ctl stop Default Ports for Installation The default ports for the software are Port Number Description 8180 Non Secure Socket Layer SSL port For example http hostname 8180 nsm 8543 SSL port For example https hostname 8543 nsm 1024 Apache HTTP server port 5437 Postgres SQL data base port Chapter 4 The sstr_ctl Command 123 Where Configuration Information is Stored When you successfully complete the procedures in this section the software writes this information to the opt SUNWnsm etc sstr properties file Caution Do not manually edit this file Use the sstr_ct1 c command only CODE EXAMPLE 4 1 Configuration Script Example Responses Run PostgreSQL server on port 5437 y n y Run Tomcat non SSL server on port 8180 y n y Run Tomcat SSL server on port 8543 y n y Run Apache server on po

Sun StorEdge Enterprise Storage Manager 1.0 Topology Reporter

Contents

Download Pdf Manuals

Related Search

Related Contents