CIMSubscription Command | Q-Logic SANBOX2-16, 59022-11 A 4-13

A – Command Line Interface	0
A – Command Line Interface
CIMSubscription Command

CIMSubscription Command

Creates, edits, or removes CIM subscriptions.

Authority Admin session and a CIM Edit session. Refer to the ”CIM Command” on page A-11for information about opening a CIM edit session.

Syntax cimsubscription

create [subscription_name] delete [subscription_name] edit [subscription_name]

Keywords create [subscription_name]

Prompts you in a line-by-line fashion to create a CIM subscription with the name given by [subscription_name]. [subscription_name] can have up to 32 characters: 0-9, A-Z, a-z, _, $, ^, and -. Table A-4describes the CIM subscription configuration parameters.

Table A-4. CIM Subscription Configuration Parameters

Parameter	Description

Name	Subscription name.
FilterID	Event type for which the switch monitors and sends an indication to
	the CIM client. The event types are as follows:
	CreateComputerSystem – A switch is added to the fabric. This
	is the default.
	ModifyComputerSystem – A switch state change.
	DeleteComputerSystem – A switch is removed from the fabric.
	CreateFCPort – Not supported.
	ModifyFCPort – A Fibre Channel port state change.
	DeleteFCPort – Not supported.
EnabledState	Enable (True) or disable (False) the subscription. The default is
	True.
Duration	Subscription life span in seconds. The subscription life span begins
	when the subscription is created. Expired subscriptions do not send
	indications to the CIM client though they remain in the CIM
	database. Values can be 1–720000. 0 indicates indefinite, which is
	the default.

delete [subscription_name]

Deletes the subscription given by [subscription_name] from the CIM database.

edit [subscription_name]

Opens an editing session in which you can modify the CIM subscription given by [subscription_name]. Refer to Table A-4for a description of the CIM subscription configuration parameters.

A-14	59022-11 A

Image 188

Q-Logic SANBOX2-16, 59022-11 A 4-13 manual CIMSubscription Command, Table A-4. CIM Subscription Configuration Parameters

Contents

SANbox2-8c/16 Switch Management User’s Guide SANbox2-8c/16 Switch Management User’s Guide Document Revision History Table of Contents Section Managing Fabrics SANbox2-8c/16 Switch Management Working with Device Information and Nicknames Zoning a Fabric Section Managing Switches Changing a User Account Password Changing the Default Performance View File Encryption Key Section Managing Ports Appendix a Command Line Interface 103106 109 Glossary Index Figures Tables Port Threshold Alarm Configuration Defaults 131 Intended Audience Related Materials Jdom License Technical Support AvailabilityTraining Contact Information Introduction Technical Support 59022-11 a Using SANsurfer Switch Manager Workstation Requirements Installing the Management ApplicationWorkstation Requirements SANsurfer Switch Manager Change directory to the location of the install programFor a Windows platform For a Linux platform SMS Installation for Windows SANsurfer Management SuiteFor a Mac OS X platform Open the CD and move to the following folder Chglax.bat SMS Installation for Linux SMS Installation for Solaris Locate and execute the file sbmoversms.sh Install the new SANsurfer Switch Manager packageChange directories to the package location Starting SANsurfer Switch Manager ‰ For Linux or Solaris enter the SANsurfer command Initial Startup Dialog SANsurfer Switch Manager Window Save Default Fabric View File Dialog Exiting SANsurfer Management Suite Uninstalling SANsurfer Switch Manager Load Default Fabric File Dialog SMS Uninstall Installdirectory/UninstallData/SANsurferUninstaller Standalone Uninstall Changing the Encryption Key for the Default Fabric View File Setting SANsurfer Switch Manager Preferences Saving and Opening Fabric View Files Preferences Dialog SANsurfer Switch Manager Using Online Help Viewing Software Version and Copyright Information Faceplate Display SANsurfer Switch Manager User InterfaceTopology Display Menu options in the topology display are shown in Figure Menu BarTopology Display Menu Menu options in the faceplate display are shown in Figure Faceplate Display MenuShortcut Keys Tool Bar Tool Bar Buttons Fabric Tree Fabric Tree Data Window and Tabs Working Status IndicatorGraphic Window Using the Topology Display Switch and Link Status Arranging Switches in the Display Working with Switches and LinksSelecting Switches and Links Opening the Faceplate Display and Topology Popup Menus Topology Data Windows Using the Faceplate Display Port Views and Status Working with Ports Selecting Ports Opening the Faceplate Popup Menu Faceplate Data Windows Page Managing Fabrics Radius Servers Adding a Radius Server Add Server Managing Fabrics Removing a Radius Server Remove Server Editing Radius Server Information Edit Radius Server Information Modifying Authentication Order Radius Server Information Modify Authentication Order Radius Server Information Fabric security consists of the following Securing a FabricConnection Security Security Consistency Checklist User Account Security Device Security Edit Security Dialog Edit Security Dialog Creating a Security Set Create Security Group Dialog Create Security Group Dialog Creating a Security Group Create Security Group Member Dialog Create a Security Group Member Dialog Creating a Security Group Member Editing the Security Configuration on a Switch Using the Security Config Dialog Viewing Properties of a Security Set, Group, or Member Deactivating a Security Set Archiving a Security Configuration to a FileActivating a Security Set Configured Security Data Window Fabric ServicesEnabling Snmp Configuration Active Security Data Window Click the In-band Management Enable button Enabling In-band ManagementTracking Fabric Firmware and Software Versions Saving a Version Snapshot Viewing and Comparing Version Snapshots Exporting Version Snapshots to a File Managing the Fabric Database Adding a Fabric Removing a Fabric Opening a Fabric View File Rediscovering a Fabric Adding a New Switch to a FabricSaving a Fabric View File Replacing a Failed Switch Deleting Switches and Links Displaying Fabric Information Topology Display Switch and Status Icons Fabric Status Displaying the Event Browser 11. Events Browser Severity Levels Icon Filtering the Event Browser 12. Filter Events Dialog Sorting the Event Browser Saving the Event Browser to a File Devices Data Window Devices Data Window Entries Active Zone Set Data Window 13. Active Zone Set Data Window SANsurfer Switch Manager enables you to do the following Link Data WindowWorking with Device Information and Nicknames Displaying Detailed Device Information Creating a Nickname Exporting Device Information to a FileManaging Device Port Nicknames Exporting Nicknames to a File Editing a NicknameDeleting a Nickname Zoning Concepts Importing a Nicknames FileZoning a Fabric Zones Soft Zones Zone Sets Access Control List Hard ZonesAliases Zoning Database Managing the zoning database consists of the following Using the Zoning WizardManaging the Zoning Database Editing the Zoning Database 15. Edit Zoning Dialog Edit Zoning Dialog Tool Bar Buttons and Icons Configuring the Zoning Database 16. Zoning Config Dialog Default Visibility Interop Auto SaveDiscard Inactive Saving the Zoning Database to a File Removing All Zoning Definitions Restoring the Default Zoning DatabaseRestoring the Zoning Database from a File Managing Zone Sets Creating a Zone Set Activating and Deactivating a Zone Set Copying a Zone to a Zone Set Removing a Zone from a Zone Set or from All Zone Sets Removing a Zone Set Managing zones involves the following Managing ZonesCreating a Zone in a Zone Set Adding Zone Members Renaming a Zone or a Zone Set Removing a Zone MemberRemoving a Zone from a Zone Set Click the OK button to add the member and save the change Managing Aliases Removing a Zone from All Zone SetsChanging Zone Types Creating an Alias Adding a Member to an Alias Zone Merge Failure Removing an Alias from All ZonesMerging Fabrics and Zoning Zone Merge Failure Recovery Managing Switches Managing User Accounts Factory User Accounts User Account Administration Dialog Add Account Creating User Accounts User Account Administration Dialog Remove Account Removing a User Account Changing a User Account Password User Account Administration Dialog- Change Password User Account Administration Dialog Modify Account Modifying a User Account Displaying Switch Information Faceplate Display Switch Data Window Switch Data Window Entries Ratov Switch Data Window Entries Displaying Detailed Device Information on page 3-34for Port Statistics Data Window Port Information Data Window Faceplate Display Port Information Configured and Active Zonesets Data Window Configured Zonesets Data Window Configuring Port Threshold Alarms Port Threshold Alarm Configuration Dialog Paging a Switch EventCount Sample Window Setting the Date/Time and Enabling NTP Client Resetting a Switch Switch Resets Type Description Configuring a Switch Using the Configuration Wizard Switch Properties 10. Switch Properties Dialog Switch Administrative States Symbolic NameSwitch Administrative States Domain ID and Domain ID Lock Fabric Device Management Interface Broadcast Support In-band Management Advanced Switch Properties Interop Mode for Zoning Legacy Port Address Format Timeout ValuesTimeout Values System Services Dialog 12. System Services Dialog Security Consistency Checklist Dialog Network Properties 13. Network Properties Dialog IP Configuration IP Configuration Parameters Remote Logging NTP Client Snmp Properties 14. Snmp Properties Dialog Snmp Configuration Snmp Configuration Parameters Snmp Trap Configuration Snmp Trap Configuration Parameters Archiving a Switch Restoring a Switch 15. Restore Dialogs Full and Selective Managing Switches Restoring the Factory Default Configuration Factory Default Configuration Settings Downloading a Support File Installing Firmware Displaying Hardware Status 16. Hardware Status LEDs Managing Switches Displaying Hardware Status 59022-11 a Managing Ports Displaying Port Information Port Types Monitoring Port StatusDisplaying Port Types Displaying Port Operational States Displaying Port SpeedsPort Operational States Port Speeds Displaying Transceiver Media Status Transceiver Media View Port Statistics Data Window Entries LIP ALPD,ALPS Port Information Data Window Entries Port Information Data Window Entries Port Information Data Window Entries Configuring Ports Port Properties Dialog Changing Port Administrative States Port Administrative States Changing Port Speeds Changing Port Types Stream Guard Device Scan Changing Port Symbolic NameUsing the Extended Credits Wizard Designate Donor Ports Resetting a Port Testing Ports Testing Ports Graphing Port Performance Fabric View Graphs This section describes how to do the following Starting SANsurfer Performance Viewer Save Default Performance View File Dialog Exiting SANsurfer Performance Viewer Saving and Opening Performance View Files Displayed Changing the Default Performance View File Encryption Key Setting SANsurfer Performance Viewer Preferences Setting the Polling Frequency Displaying Graphs Arranging Graphs in the Display Customizing Graphs Managing Ports Setting Global Graph Type Rescaling a Selected GraphPrinting Graphs Saving Graph Statistics to a File Command Line Interface Logging On to a Switch Working with Switch Configurations User Accounts Modifying a Configuration Backing up and Restoring Switch Configurations Ftp ipaddress Commands Table A-1. Command-Line Completion Table A-2. Commands Listed by Authority Level Admin Session Commands Admin Command AuthoritySyntax Keywords Alias Command Syntax alias Rename aliasold aliasnew Members aliasRemove alias memberlist CIM Command CIMListener Command Table A-3. CIM Listener Configuration Parameters Following is an example of the CIMListener Create command Enter CIMSubscription Command Table A-4. CIM Subscription Configuration Parameters Must be Saved with the cim save command Config Command Syntax configKeywords activate configname Edit configname Restore Manager Archive function are not compatible with the ConfigRestore command Save configname # ftp symbolicname or ipaddress Create Command CreateCertificate Support Command Line Interface Create Command Following is an example of the Create Certificate command Keywords MMDDhhmmCCYY Date CommandSyntax date Syntax firmware install Firmware Install CommandAuthority Admin Group Command Syntax group Keywords add group Table A-5. ISL Group Member Attributes Table A-6. Port Group Member Attributes Copy groupsource groupdestination Create group type Edit group member Table A-8. Group Member Attributes Members group Remove group memberlistRename groupold groupnew Securitysets group Following is an example of the Group Edit command ISL Following is an example of the Group List command Following is an example of the Group Members command Hardreset Command Syntax Help Command Keywords commandSyntax help command keyword Authority None History Command Authority None Syntax history Hotreset Command Hotreset Image Command FTP. Enter one of the following on the command line Switch name associated with the IP addressEnter the following account name and password Are running the same version of firmware Open an Admin session to acquire the necessary authority Wait for the unpack to complete Lip Command Following is an example of the Lip commandReinitializes the specified loop port Lip portnumber Passwd Command Syntax passwd accountname Keywords accountname Ping Command Syntax ping ipaddress Keywords ipaddress Ps Command Following is an example of the Ps commandSyntax Examples Displays current system process information Syntax quit, exit, or logout Quit CommandCloses the Telnet session Reset Command Config configname Services SwitchSnmp System Table A-9. Switch Configuration Defaults Values Table A-10. Port Configuration Defaults Arbff Table A-11. Port Threshold Alarm Configuration Defaults Table A-12. Zoning Configuration Defaults Table A-13. Snmp Configuration Defaults Table A-14. Radius Configuration Defaults Table A-15. Services Configuration Defaults Table A-16. System Configuration Defaults Table A-17. Security Configuration Defaults Security Command Keywords active Following is an example of the Security Active command History Following is an example of the Security History command Following is an example of the Security Limits command Following is an example of the Security List command Securityset Command Delete securityset Groups securitysetRemove securityset group Rename securitysetold securitysetnew Set Command Syntax set Setup option Switch statePagebreak state Port option Set Config Command Set configTable A-18. Set Config Port Parameters Port portnumber Table A-18. Set Config Port Parameters Security Table A-19. Security Configuration Parameters Table A-20. Set Config Switch Parameters Ratov Table A-21. Set Config Threshold Parameters Threshold Table A-22. Set Config Zoning Parameters Arbff Following is an example of the Set Config Security command Following is an example of the Set Config Switch command Following is an example of the Set Config Threshold command Following is an example of the Set Config Zoning command Set Log Command Set logArchive Component filterlist Snmp Display filter Level filter Port portlistStart Stop Alarms are always logged and always displayed on the screen Set Port Command EnableKeywords portnumber Bypass alpa State state Set Setup Command Set setupRadius Services Snmp System Configuration fields Table A-23. Radius Service Settings Table A-24. Switch Services Settings Table A-24. Switch Services Settings Table A-25. Snmp Configuration Settings Table A-26. System Configuration Settings Table A-25. Snmp Configuration Settings Table A-26. System Configuration Settings Following is an example of the Set Setup Services command Following is an example of the Set Setup Snmp command Following is an example of the Set Setup System command SANbox2 admin # set setup system Show Command Keywords about Alarm option Cimlistener listenernameCimsubscription subscriptionname Fdmi portwwn Log option LsdbNs option Pagebreak Table A-27. Show Port Parameters Tbuf LIPF8ALPS Post log Steering domainid Table A-28. Switch Operational Parameters WhoamiZoneset Active, List „ Zoning History, Limits, List Displays the current time zone setting TopologyDisplays all connected devices Users Following is an example of the Show Domains command Following is an example of the Show Fabric command Following is an example of the Show Fdmi command Following is an example of the Show Fdmi WWN command Following is an example of the Show NS portID command Following is an example of the Show NS local domain commandFollowing is an example of the Show NS domainID command Following is an example of the Show Interface command Collisions0 txqueuelen100 Following is an example of the Show Port command PL-XPL-VC-SG3-22 Following is an example of the Show Switch command Following is an example of the Show Topology command 59022-11 a 101 Following is an example of the Show Version command Show Config Command Show config Following is an example of the Show Config Switch command Following is an example of the Show Config Threshold command Following is an example of the Show Config Zoning command Show Log Command NoneShow log Keywords numberofevents Settings LevelOptions Port Following is an example of the Show Log command Following is an example of the Show Log Level commandFollowing is an example of the Show Log Options command Show Perf Command Following is an example of the Show Perf Byte command Mfg Show Setup CommandShow setup Following is an example of the Show Setup Services command Following is an example of the Show Setup Radius command Following is an example of the Show Setup Snmp command Following is an example of the Show Setup System command Shutdown Shutdown CommandPower from the switch Test Command TestPort portnumber testtype Status Admin start Test port x online Authority None Syntax uptime Uptime CommandExamples The following is an example of the Uptime command User Command UserAccounts Add Following is an example of the User Add command Following is an example of the User Edit command Following is an example of the User Delete command Following is an example of the User List command Whoami Whoami CommandFollowing is an example of the Whoami command Zone Command Syntax zone Members zone Remove zone memberlistRename zoneold zonenew Type zone zonetype Following is an example of the Zone Members command Following is an example of the Zone Zonesets command Zoneset Command Syntax zoneset Zones zoneset Remove zoneset zonelistRename zonesetold zonesetnew Zoning Command Opens a Zoning Edit session Table A-29. Zoning Database Limits Limit Description Following is an example of the Zoning Limits command E1JBOD1 E2JBOD2 Following is an example of the Zoning List command Command Line Interface Zoning Command 134 59022-11 a Access Control List Zone Administrative StateAlarm BootP Class 3 Service Configured Zone SetsDefault Visibility Fabric Management Switch Input Power LED Inter-Switch LinkMaintenance Button Maintenance Mode Power On Self Test Post Principal SwitchSANsurfer Switch Manager Small Form-Factor Pluggable Index Index-2 59022-11 a 59022-11 a Index-3 Index-4 59022-11 a 59022-11 a Index-5 Index-6 59022-11 a 59022-11 a Index-7 Index-8 59022-11 a 59022-11 a Index-9 Index-10 59022-11 a