################################################################################ # The daemon_options file contains parameters that can be set to control # the behavior of the various EMC Solutions Enabler daemons. Each daemon reads # this file as it starts and applies any settings within it that apply. # # # CAUTION: These parameters are intended for experienced users. In # most scenarios, the default values used by the daemons will be sufficient. # # CAUTION: This file should be protected so that only authorized users can # make changes to it. # # Lines in this file are allowed to have one of the following formats: # # NAME = VALUE Set the parameter 'NAME' for all # daemons that understand this parameter. # # stororad:NAME = VALUE Set the parameter 'NAME' for only the # stororad daemon. # # storora*:NAME = VALUE Set the parameter 'NAME' for all # daemons whose name begins with # storora. The asterick (*) character is # a wildcard - matching the remainder of # a daemon's name. # # Option values that are very long can extend to the next line by placing # a backslash at the very end of the line. For example: # stororad:NAME = VALUE1 : VALUE2 : VALUE3 : \ # VALUE4 : VALUE5 # ############################################################################### # ############################################################################### ### Common daemon parameters ### ### These common parameters apply to the core Solutions Enabler daemons: ### storapid [Base Daemon] ### storgnsd [GNS Daemon] ### storrdfd [RDF Daemon] ### storevntd [Event Daemon] ### storstpd [STP Daemon] ### storwatchd [Watchdog Daemon, UNIX only] ### storsrvd [SYMAPI Server Daemon] ############################################################################### # # Parameter: autorestart # # Allowed values: enable | disable # # Default value: enable # # Description: Specifies whether a watchdog mechanism # (UNIX: storwatchd daemon) should be used to # automatically restart a daemon if itcrashes. # # stor????:autorestart = disable #------------------------------------------------------------------------------ # # Parameter log_level # # Allowed values: error | info | debug | verbose | warning # # Default value: warning # # Description: Specifies a severity-based control over logging # volume. Messages that are issued with a severity # equal to or exceeding the level specified will be # recorded in the log file. Do not use debug or verbose # without direction from EMC Customer Support. # # stor????:log_level = error #------------------------------------------------------------------------------# # Parameter: logfile_type # # Allowed values: dated | wrap # # Default value: wrap # # Description: Specifies which style of log file the daemon will use. # Two styles are supported: # wrap: Two log files are maintained: stor????.log0 and # and stor????.log1. Logging alternates between # these -- switching to the other file each time # the maximum size specified by the logfile_size # parameter is reached. The modified time on the # files can be used to determine the current one. # # dated: A separate log file is used for each day: # stor????-YYYYMMDD.log. (e.g.: storapid-20041130.log). # There are no size limits on these files. # # Log files are written to the following directory: # UNIX: /var/symapi/log # Windows: c:\\Program Files\\EMC\\SYMAPI\\log # # stor????:logfile_type = dated #------------------------------------------------------------------------------ # # Parameter: logfile_size # # Allowed values: A number, in KB units # # Default value: 1000 (1000-KB) # # Description: For logfile_type=wrap style log files, how large each # log file is allowed to grow before wrapping to the # alternate file. # # stor????:logfile_size = 5000 #------------------------------------------------------------------------------ # # Parameter: logfile_retention # # Allowed values: A number of days, greater than zero. # # Default value: 3 (days) # # Description: For logfile_type=dated style log files, log files # more than this many days old will be automatically # deleted. # # stor????:logfile_retention = 5 #------------------------------------------------------------------------------ # # Parameter: logfile_perms # # Allowed values: r | n | rw # # Default value: rw # # Description: By default, daemon log files allow anyone to read or # write them (UNIX mode of rwxrwxrwx). This option can # be set to override that behavior, as follows: # # rw: Anyone can read or write (default). # r: The owner (root) can read/write, others can read. # n: The owner can read/write, no one else can access. # # stor????:logfile_perms = r # ############################################################################### ### storsrvd [SYMAPI server daemon] parameters ### ### This daemon handles remote SYMAPI client connections over TCP/IP ### to storage arrays. Storsrvd provides the same services as the former ### symapisrv command. ### Refer to the storsrvd(3) man page for additional details. ############################################################################### # # ########## # Parameter: log_filter # # Allowed values: SERVER | CONTROLS | SESSION | APIREQ # # Default value: None # # Description: Specifies category-based control over logging volume, # by selecting which types of storsrvd numbered log # messages are recorded in the storsrvd log files. # Each log message issued by storsrvd is associated with # a category, expressed by the filter names shown below. # # The numbered messages will appear in the storsrvd log # files and on a terminal if one is available. Numbered # messages issued by storsrvd use a message identifier # that precedes the message text: # # ANR0001I SYMAPI server ready to accept SECURE # connections # # The value to be specified for log_filter consists of a # series of keywords separated by a commas (,) or # plus signs {+). # # SERVER: Records high level events of the server: # initialization, termination, and other # events not directly related to a SYMAPI # session. # SESSION: Records arrival and termination of SYMAPI # sessions. # APIREQ: Records arrival and completion of SYMAPI # function requests. # CONTROLS: Records activity during execution of # management requests from stordaemon or the # system console in the z/OS environment. # # If log_filter specifies either SESSION or APIREQ # it is most useful to set log_level to info. # # storsrvd:log_filter = SESSION+APIREQ #------------------------------------------------------------------------------ # # Parameter: log_show_msgid # # Allowed values: disable | enable # # Default value: enable # # Description: Displays message identifiers in the log messages # issued by storsrvd. # # storsrvd:log_show_msgid = enable #------------------------------------------------------------------------------ # # Parameter: log_show_category # # Allowed values: enable | disable # # Default value: disable # # Description: Displays the category (see log_filter above) in the # output log messages, preceding the message identifier. # # storsrvd:log_show_category = disable #------------------------------------------------------------------------------ # # Parameter port # # Allowed values: 1 - 65534 | 2707 # # Default value: 2707 # # Description: Specifies the TCP/IP port on which storsrvd will # listen for connections from remote SYMAPI clients. # Generally, numbers less than 1000 are reserved for # well known daemon servers such as telnet, ftp, and # http. # # storsrvd:port = 2707 #------------------------------------------------------------------------------ # # Parameter security_level # # Allowed values: NONSECURE | ANY | SECURE # # Default value: SECURE # # Description: Specifies the security level for SYMAPI sessions. # The security level indicates the server's capability # and its expectation for remote clients to negotiate # negotiate secure sessions using SSL (Secure Sockets # Layer). # # NONSECURE indicates that the server will only accept # clients that agree to negotiate a session without # authentication and encryption provided by SSL. # # ANY indicates that the server will accept connections # from clients who can negotiate secure sessions, and # from clients who cannot negotiate secure sessions. # A client that cannot negotiate a secure session may # be using a version of SYMAPI that is less that 6.0, or # may be running on a platform which does not support # SSL, or may have been configured to bypass secure # sessions. # # SECURE indicates that the server will only accept # clients who agree to negotiate a secure session. # Clients who cannot negotiate secure sessions will be # refused access to remote SYMAPI services. # # storsrvd:security_level = SECURE #------------------------------------------------------------------------------ # # Parameter security_alt_cert_file # # Allowed values: Any valid simple file name. # # Default value: symapisrv_cert.pem # # Description: Specifies the name of an alternate certificate file # to be used by the server instead of the certificate # generated at installation, and will be paired with # the file specified in the security_alt_key_file option. # # If this option is used, the security_alt_key_file # option must also be used to specify an alternate key # file. # # The certificate file must be located in the # /var/symapi/config/cert directory. Do not specify # the directory in the value. # # storsrvd:security_alt_cert_file = symapisrv_cert.pem #------------------------------------------------------------------------------ # # Parameter security_alt_key_file # # Allowed values: Any valid simple file name. # # Default value: symapisrv_key.pem # # Description: Alternate key file. # # Specifies the name of an alternate private key file # to be used by the server instead of the key # generated at installation, and will be paired with the # file specified in the security_alt_cert_file option. # # If this option is used, the security_alt_cert_file # option must also be used to specify an alternate # certificate file. # # The key file must be located in the # /var/symapi/config/cert directory. Do not specify # the directory in the value. # # storsrvd:security_alt_key_file = symapisrv_key.pem #------------------------------------------------------------------------------ # # Parameter security_clt_secure_lvl # # Allowed values: MUSTVERIFY | NOVERIFY | VERIFY # # Default value: VERIFY # # Description: Client certificate verification level. # (This feature is not available on z/OS). # # This option controls the verification # of the client certificate by the server. # The following values may be specified: # # MUSTVERIFY: Indicates that the server # will only accept communications from a # version of the client that can send a # certificate to be verified. # # NOVERIFY: Indicates that the server # will not verify the client certificate. # # VERIFY: Indicates that the server will # verify a client certificate if the version # of the client can send a certificate. # # THIS OPTION IS IGNORED IF SECURE # COMMUNICATIONS ARE NOT ESTABLISHED. # # storsrvd:security_clt_secure_lvl = VERIFY storsrvd:security_clt_secure_lvl = NOVERIFY # ############################################################################### ### storapid [Base Daemon] parameters ### ### This daemon facilitates I/O accesses to Symmetrix storage arrays. ### Refer to the storapid(3) man page for additional details. ############################################################################### # # Parameter use_all_gks # # Allowed values: disable | enable # # Default value: disable # # Description: Specifies whether or not the storapid is free to use # all available gatekeepers, if the syscall volume is # high enough. When disabled, the storapid restricts # itself to using no more than 75% of the available # gatekeepers. # # If this parameter is changed, the storapid must be # restarted for the new value to take effect. # # storapid:use_all_gks = enable #------------------------------------------------------------------------------ # # Parameter gk_use # # Allowed values: dedicated_only | legacy # # Default value: legacy # # Description: # If set to 'dedicated_only', then the base daemon # restricts itself to using only dedicated gatekeepers. # This ensures that data devices will never be used as # gatekeepers without the need to maintain the gkselect # or gkavoid file. Note, even though VCM/ACLX devices # can be used as gatekeepers, they are not classified # as dedicated gatekeepers. # # If set to 'legacy', then the base daemon may # temporarily use a data device as a gatekeeper if the # syscall load is high enough. # # This parameter can be changed and reloaded while the # base daemon is running with the CLI stordaemon # action storapid -cmd reload. # # storapid:gk_use = dedicated_only #------------------------------------------------------------------------------ # # Parameter inquiry_timeout # # Allowed values: A number of seconds. # # Default value: 900 # # Description: Specifies how long priority inquiry results are to # remain in memory before expiring, and new data is # retrieved from the host and arrays. # # A value of -1 indicates the data never expires. # A value of zero indicates the data always expires. # # storapid:inquiry_timeout = 900 #------------------------------------------------------------------------------ # # Parameter background_audit_log # # Allowed values: disable | enable # # Default value: disable # # Description: Writes audit log entries on behalf of the requesting # client, and returns control back to the client while # the entry is being written. # # An audit log entry is preserved on disk until the # entry is written to the Symmetrix array. This ensures # no entries are lost if the base daemon is stopped and # restarted before all entries are written # # This parameter can be changed and reloaded while the # base daemon is running with the CLI stordaemon # action storapid -cmd reload. # # storapid:background_audit_log = enable #------------------------------------------------------------------------------ # # Parameter single_gk_policy # # Allowed values: pool | close # # Default value: close # # Description: If the base daemon only has one gatekeeper device, # this parameter tells the base daemon what to do # with the device after each use. # # A value of pool tells the daemon to put it back # into the gatekeeper pool. # # A value of close tells the daemon to close the # device after each use. # # This parameter is useful for device masking on # hosts that only see a single device. Setting # the value to close will slow down all commands, # so it is recommended that this setting only be # used for as short a time as possible. # # An example of how to use this setting follows: # # 1. Edit the daemon_options file and add: # storapid:single_gk_policy = close # # 2. Reload storapid settings with this command: # stordaemon action storapid -cmd reload # # 3. Perform all the device masking commands. # # 4. Edit the daemon_options file and set: # storapid:single_gk_policy = pool # # 5. Reload the storapid settings. # # 6. Verify that the setting is back to pool: # stordaemon action storapid -cmd show_gk_stats # # storapid:single_gk_policy = pool #------------------------------------------------------------------------------ # # Parameter internode_lock_information_export # # Allowed values: disable | enable # # Default value: enable # # Description: Makes SEL and DEL lock information available for all # base daemon hosts attached to the Symmetrix array for # use with available LockShow API functions. # # This parameter can be changed and reloaded # while the base daemon is running with the # CLI stordaemon action storapid -cmd reload. # # storapid:internode_lock_information_export = enable #------------------------------------------------------------------------------ # # Parameter internode_lock_recovery # # Allowed values: enable | disable # # Default value: disable # # Description: Enables internode lock recovery capabilities that # allows the daemon to recover SEL and DEL locks # previously acquired by another daemon if its determined # that daemon is no longer # active. # # This parameter can be changed and reloaded # while the base daemon is running with the # CLI stordaemon action storapid -cmd reload. # # storapid:internode_lock_recovery = disable #------------------------------------------------------------------------------ # # Parameter internode_lock_recovery_heartbeat_interval # # Allowed values: 0 - 65535 seconds # # Default value: 0 # # Description: Specifies the frequency to issue host heartbeats # to any Symmetrix array that the daemon has acquired a # SEL or DEL lock, and the lock is still held. The # heartbeat is the indication to any other base daemon # running on a host attached to the array that the lock # is recoverable. # # A base daemon must be configured to recover locks by # enabling the internode_lock_recovery option. # # A value greater than zero will enable the # internode_lock_information_export option. # # This parameter can be changed and reloaded # while the base daemon is running with the # CLI stordaemon action storapid -cmd reload. # # storapid:internode_lock_recovery_heartbeat_interval = 0 #------------------------------------------------------------------------------ # Parameter parallel_inquiry_size # # Allowed Values: 0, multiples of 2 # # Default Value: 6 # # Description: Indicates the number of threads to use when the base # is performing an inquiry. The device list is scattered # across those threads to potentially improve # performance. Devices that fail to respond within the # device_inquiry_timeout period get abandoned, with # inquiry data not provided to the requesting API client # for those devices. # # A value of zero keeps the inquiry process as a # single list, executed on the calling client's thread. # # To help determine the optimal setting for the host use # the CLI stordaemon action storapid -cmd scan -inquiry # # This parameter can be changed and reloaded # while the base daemon is running, with the # CLI stordaemon action storapid -cmd reload. # # This value can be viewed and set with the CLI # stordaemon getvar and setvar commands. # # storapid:parallel_inquiry_size = 6 #------------------------------------------------------------------------------ # # Parameter device_inquiry_timeout # # Allowed values: A number of seconds, >= 1 # # Default value 60 # # Description: Specifies how long a thread in the parallel inquiry # feature waits for a device to respond before abandoning # it during the inquiry process. The thread may or may # not complete, depending on why the device is not # responding. If a device is eventually made to respond # by other means and the nature of the OS does not # provide any indication to the waiting request in the # base daemon, the base daemon will need to be restarted. # # This parameter can be changed and reloaded # while the base daemon is running, with the # CLI stordaemon action storapid -cmd reload. # # This value can be viewed and set with the CLI # stordaemon getvar and setvar commands. # # storapid:device_inquiry_timeout = 60 #------------------------------------------------------------------------------ # # Parameter background_discovery # # Allowed values: disable | enable # # Default value: enable # # Description: Performs a discovery of select syscall data on behalf # of the requesting API client that initiated a # discovery. These syscalls are issued in parallel with # other syscalls being issued by the client. # # Syscall data is kept in cache until the client requests # the data, and then is discarded. # # This parameter can be changed and reloaded # while the base daemon is running, with the # CLI stordaemon action storapid -cmd reload. # # storapid:background_discovery = disable #------------------------------------------------------------------------------ # # Parameter file_transfer_timeout # # Allowed values: A number of seconds, >= 1 # # Default value: 3600 # # Description: Specifies how long a thread in the Enginuity code load # feature is to wait for the targeted SP to complete the # transfer of a file to its local disk. The transfer will # be aborted by the initiating base daemon upon # expiration. # # This parameter can be changed and reloaded # while the base daemon is running, with the # CLI stordaemon action storapid -cmd reload. # The new value will be effective on subsequent # transfers. # # storapid:device_inquiry_timeout = 3600 # ############################################################################### ### storgnsd [Group Name Service (GNS) Daemon] notes ### ### This daemon supports GNS (Group Name Services) on a host. ### Refer to the storgnsd(3) man page for additional details. ############################################################################### # # Parameter: autorestart # # Allowed values: disable | enable # # Default value: enable # # Description: Specifies whether to use a watchdog mechanism to # monitor and automatically restart storgnsd if it # crashes. # # storgnsd:autorestart = disable #------------------------------------------------------------------------------ # # Parameter: gns_device_poll_interval # # Allowed values: A number, in seconds. # # Default value: 15 # # Description: Specifies how frequently storgnsd polls for changes # made to groups from other hosts. The smaller this # value is, the more quickly a host will recognize # group changes made from other hosts. # # storgnsd:gns_device_poll_interval = 60 #------------------------------------------------------------------------------ # # Parameter: gns_ppath_poll_interval # # Allowed values: A number, in seconds. # # Default value: 60 # # Description: Specifies how frequently storgnsd checks to see whether # PowerPath or RDF consistency group updates are # necessary. # # storgnsd:gns_ppath_poll_interval = 30 #------------------------------------------------------------------------------ # # Parameter: gns_remote_mirror # # Allowed values: enable | disable # # Default value: disable # # Description: Specifies whether storgnsd should automatically mirror # RDF1 and RDF2 type DG and CG group definitions for # use on remote (SRDF) Symmetrix arrays. # # Limitations include: # - REGULAR type and type ANY groups are not mirrored. # - Mirrors will not be created if the remote # Symmetrix array is also directly attached to # the local host. (Refer to the gns_symavoid_local # option below.) # - For CG groups, BCV type devices are not mirrored. # # storgnsd:gns_remote_mirror = enable #------------------------------------------------------------------------------ # # Parameter: gns_rmtarr_update_interval # # Allowed values: A number, in seconds. # # Default value: 60 # # Description: Specifies how frequently storgnsd should attempt to # propagate device groups over to remote (SRDF) # Symmetrix arrays. This is only relevant if the # gns_enb_remote_mirror option is set to enable. # # storgnsd:gns_rmtarr_update_interval = 30 #------------------------------------------------------------------------------ # # Parameter: gns_init_remote_symms # # Allowed values: disable | enable # # Default value: enable # # Description: Initializes the GNS group repository on remote # Symmetrix arrays while remotely mirroring groups # (i.e.: the gns_remote_mirror option is enabled). # If disabled, a GNS daemon directly connected to such # remote arrays has to perform the initialization - when # it encounters the array. # # This option should be disabled if (a) remote mirroring # is enabled (gns_remote_mirror), (b) GNS daemons will be # actively running on both sides of the SRDF link, (c) # groups are being modified on both the local and remote # Symmetrix arrays and (d) GNS backup/restore is enabled # (gns_shadow_file). Failing to disable this option in # this scenario may result in data loss, due to # interaction between the backup/restore and remote # mirroring mechanisms. # # storgnsd:gns_init_remote_symms = disable #------------------------------------------------------------------------------ # # Parameter: gns_shadow_file # # Allowed values: enable | needed | disable # # Default value: disable # # Description: Specifies whether storgnsd should maintain backup # copies of GNS data for attached Symmetrix arrays. # These backups, maintained on the local disk, are # automatically restored to the GNS repository on a # Symmetrix array if storgnsd detects that the repository # there has been erased. This could occur, for example, # if the Symmetrix is VTOC'd or suffers a power loss # under ucode versions 5x67/5x68 or has a destructive # upgrade performed to it. Note that these backups will # only be maintained for local arrays - not ones that # are remote (SRDF). # # It is recommended that this option be enabled on a # subset of hosts running GNS daemons. Because of its # effect on performance, it usually does not make sense # to have more than 2-4 GNS daemons managing these # backup copies - assuming that they can see all the # relevant Symmetrix arrays. # If enable: Backup copies will be maintained for all # arrays. # If needed: Backup copies will only be maintained for # arrays with ucode versions below 5x71. # If disable: Backup copies will not be maintained. # # storgnsd:gns_shadow_file = enable storgnsd:gns_shadow_file = enable #------------------------------------------------------------------------------ # # Parameter: gns_symavoid # # Allowed values: A comma separated list of Symmetrix IDs. Note that # full IDs are required - shortcuts are not supported. # # Default value: None # # Description: Specifies a set of Symmetrix arrays, both local and # (SRDF) remote, that GNS should NOT manage. # Specifically, GNS will not examine these # arrays for group definitions and will fail if an # attempt is made to define a group containing devices # on one of these. Also, mirroring of groups will not # occur to remote Symmetrix arrays if they are in this # list. # # storgnsd:gns_symavoid = 000012345678,000012345679 #------------------------------------------------------------------------------ # # Parameter: gns_syminclude # # Allowed values: A comma separated list of Symmetrix IDs. Note that # full IDs are required - shortcuts are not supported. # # Default value: None # # Description: Specifies the only Symmetrix arrays, both local and # (SRDF) remote, that GNS will manage. Specifically, # GNS will only examine these arrays (and no others) # for group definitions and will only allow groups # to be defined that contain devices on one of these. # Also, mirroring of groups will not occur to remote # Symmetrix arrays if they are NOT in this list. # # If both gns_symavoid and gns_syminclude are supplied, # the effect is cumulative. Only arrays specified by # gns_syminclude but not in gns_symavoid will be managed. # # storgnsd:gns_syminclude = 000012345678,000012345679 #------------------------------------------------------------------------------ # # Parameter: gns_symavoid_local # # Allowed values: A comma separated list of Symmetrix IDs. Note that # full IDs are required - shortcuts are not supported. # # Default value: None # # Description: Specifies a set of local Symmetrix arrays that GNS # should NOT manage. Specifically, if an array listed # here can be accessed both locally and remotely # (by RDF) from this host, the local connection will be # ignored. This can be used to enable automatic group # mirroring where the remote array is also local to the # host (refer to the gns_remote_mirror option above). # # storgnsd:gns_symavoid_local = 000012345678,000012345679 # ################################################################################ ### storrdfd [RDF Daemon] notes ### ### This daemon provides consistency for SRDF/A MSC and RDF-ECA CGs in ### multi-Symmetrix environments. ### Refer to the storrdfd(3) man page for additional details. ################################################################################ # # # ################################################################################ ### storevntd [Event Daemon] notes ### ### This daemon acts as the clearing house for Solutions Enabler events ### on a host. ### Refer to the storevntd(3) man page for additional details. ################################################################################ # # Parameter symm_poll_interval # # Allowed values: A number of seconds. # # Default value: 60 # # Description: Specifies how often, in seconds, to poll Symmetrix # arrays for events that need to be delivered. # # storevntd:symm_poll_interval = 300 #------------------------------------------------------------------------------ # # Parameter event_listen_port # # Allowed values: An IP port number. # # Default value: 0 - means to let the OS pick an unused port # # Description: Which IP port to use when listening for events being # forwarded from remote hosts. By default, an unused # port picked by the OS is used. This option might # be needed if the presence of a firewall requires # the use of a particular port. # # storevntd:event_listen_port = 2222 #------------------------------------------------------------------------------ # # Parameter log_event_targets # # Allowed values: One or more (space separated) of: snmp, file, system, # syslog # # Default value: none # # Description: Controls whether events should be automatically logged. # One or more of the following may be supplied: # file: Events are written to a file on disk. # snmp: Events are mapped into SNMP traps. # system: Events are written to the Event Log (Windows) # or the local syslog service (otherwise). # syslog: Events are sent directly to a remote syslog # server, bypassing any local syslog service. # # Some of these possible targets can be configured by # options that are described below. # # storevntd:log_event_targets = snmp file storevntd:log_event_targets = syslog #------------------------------------------------------------------------------ # # Parameter log_symmetrix_events # # Allowed values: see above # # Default value: No events are logged. # # Description: Specifies events that are to be automatically logged. # Refer to the log_event_targets option above. # This option consists of a records separated by a # semicolon. Typically, each record will be placed on a # line by itself. Each of these records in turn consists # of a number of comma-separated fields. # # [sid=nnnnn,] CAT[, ...] [,ignore] [,tgt=xxx] # # sid=nnnnnnnnnnnn # Specifies a Symmetrix ID. By default, all known # Symmetrix arrays will be monitored. # # CAT # Specifies the event(s) to be monitored. This can # be either the name of an event category or a # numerical event ID. This is the only field that is # required. One or more values (comma separated) # may be present. # # Supported categories are: # status # events # array subsystem # checksum # diagnostic # environmental # device pool # service processor # srdf system # srdf link # srdfa session # srdf consistency group # director # device # disk # # comp=xxxx # "comp=aaa,bbb,ccc" # Certain events apply to specific sub-components # within the array: a device (4 digit hexadecimal), # disk, pool. This field specifies that only # events for the specified component (or components) # should be delivered. If more than one component # is being present, the entire field must be enclosed # in double quotes. e.g.: "comp=0004,0010,0100" # # thresh_critical=nn # thresh_major=nn (equivalent to: thresh=nn) # thresh_warn=nn # thresh_info=nn # Certain events correspond to numerical quantities # of some sort. A threshold is associated with # each severity level, and an event is generated # at that severity when the event's value exceeds # the associated threshold. These fields can be # used to override the default threshold values # controlling when an event is delivered. # # One example of this is the event that indicates the # percentage of space used for a pool. These fields # can be set to control when events are to be generated. # e.g.: thresh_critical=96, thresh_major=80, # thresh_warn=60 # # ignore # If present, these event(s) are not to be logged - # even if they are matched by a different record. # tgt=xxx # If present, these event(s) are sent to only the # specified target - which must be one of: # snmp, file, system, syslog. # The specified target must also be present in the # default target list given by the log_event_targets # option. # # storevntd:log_symmetrix_events = sid=111111111111, disk, device ;\ # sid=222222222222, device pool ;\ # sid=333333333333, device, "comp=0101,0102,0104" ;\ # array subsystem , tgt=file storevntd:log_symmetrix_events = \ sid=000190103986,audit;\ sid=000192600758,audit;\ sid=000192600785,audit;\ sid=000192602079,audit;\ sid=000192602179,audit;\ sid=000192603267,audit;\ sid=000192603525,audit;\ sid=000192603856,audit;\ sid=000192604682,audit;\ sid=000195702814,audit;\ sid=000192605245,audit;\ sid=000192605835,audit;\ sid=000195701397,audit;\ sid=000195701411,audit;\ sid=000195702004,audit;\ sid=000195702025,audit;\ sid=000195702690,audit;\ sid=000192606624,audit;\ sid=000195701427,audit; #------------------------------------------------------------------------------ # # Parameter log_event_file_name # # Allowed values: file name, without any suffix # # Default value: events # # Description: For event logging to a file (log_event_targets # contains 'file'): the base name of the file that is # used. This file is created within the standard log # file directory. # UNIX: /var/symapi/log # Windows: c:\\Program Files\\EMC\\SYMAPI\\log # Depending on the setting of the log_event_file_type # option, a suffix will added to this name. # # storevntd:log_event_file_name = my_event_file storevntd:log_event_file_name = symevents #------------------------------------------------------------------------------ # # Parameter log_event_file_type # # Allowed values: dated | wrap # # Default value: wrap # # Description: For event logging to a file # (log_event_targets contains 'file'): # the type of log file that is used. # Two styles are supported: # wrap: Two log files are maintained: ????.log0 and # and ????.log1. Logging alternates between # these -- switching to the other file each time # the maximum size specified by the log_event_file_size # parameter is reached. The modified time on the # files can be used to determine the "current" one. # # dated: A separate log file is used for each day: # ????-YYYYMMDD.log. (e.g.: events-200411 # There are no limits on how large these files # can become. # # storevntd:log_event_file_type = dated #------------------------------------------------------------------------------ # # Parameter log_event_file_size # # Allowed values: A number, in KB # # Default value: 1000 (1000-KB) # # Description: Specifies how large each log file is allowed to grow # before wrapping to the alternate file. # This option is for event logging to a file # (log_event_targets contains 'file'): # if log_event_file_type == wrap. # # storevntd:log_event_file_size = 5000 # storevntd:log_event_file_size = 20000 #------------------------------------------------------------------------------ # # Parameter log_event_file_retention # # Allowed values: A number of days, greater than zero. # # Default value: 3 (days) # # Description: Indicates that log files more than this many days old # will be automatically deleted. # This option is for event logging to a file # (log_event_targets contains 'file'): # if log_event_file_type == dated. # # storevntd:log_event_file_retention = 5 #------------------------------------------------------------------------------ # # Parameter log_event_file_perms # # Allowed values: n | rw | r # # Default value: r # # Description: Specifies the permissions to be applied to # new log files that are created. # This option is for event logging to a file # (log_event_targets contains 'file'). Possible values: # # rw: Anyone can read or write. # r: The owner (root) can read/write, others can read. # n: The owner can read/write, no one else can access. # # storevntd:log_event_file_perms = r #------------------------------------------------------------------------------ # # Parameter log_event_syslog_host # # Allowed values: A host name or IP address. # # Default value: None - a value is required. # # Description: Specifies the host on which the remote syslog server # is running. This option is for event logging to syslog # (log_event_targets contains 'syslog'). # # storevntd:log_event_syslog_host = jupiter or 10.4.12.34 storevntd:log_event_syslog_host = arcconnswdc-p06_eth1 #------------------------------------------------------------------------------ # # Parameter log_event_syslog_port # # Allowed values: A decimal port number. # # Default value: 514 # # Description: Specifies the port to which the remote syslog # server is listening. This option is for event logging # to syslog (log_event_targets contains 'syslog'). # # # storevntd:log_event_syslog_port = 1234 #------------------------------------------------------------------------------ # # Parameter snmp_trap_client_registration # # Allowed values: IP,port,filter,state - with no spaces # # Default value: none # # Description: Provides a list of target IPs and ports to send # SNMP traps to, when the log_event_targets option # specifies snmp. # # Format is: IP,port,filter,state, where filter # represents the trap sending filtering levels # as defined in the fcmgmt MIB, and state # represents the start up row state in the # trap_client_registration table in the fcmgmt MIB. # # Multiple entries should be on their own line, # delineated with a backslash (\) character # on the preceding line. # # This parameter can be changed and reloaded # while the event daemon is running, with the # CLI stordaemon action storevntd -cmd reload. # # storevntd:snmp_trap_client_registration = 11.22.33.44,162,10,ACTIVE \ # 55.66.77.88,162,10,ACTIVE #------------------------------------------------------------------------------ # # Parameter snmp_management_url # # Allowed values: <:port> # # Default value: none # # Description: Provides launch capability of a management application, # such as SMC or ECC, from within a third party # management framework. # # This parameter can be changed and reloaded # while the event daemon is running, with the # CLI stordaemon action storevntd -cmd reload # # storevntd:snmp_management_url=local:7070 # ################################################################################ ### storstpd [Statistics Collection (STP) Daemon] notes ### ### This daemon supports STP Statistics collection. ### Refer to the storstpd(3) man page for additional details. ################################################################################ # ################################################################################ # ################################################################################ ### storstpd daemon level options ### ### These options control how the daemon behaves. ################################################################################ # # Parameter: logfile_type # # Allowed values: dated | wrap # # Default value: wrap # # Description: Specifies which style of log file the daemon will use. # Two styles are supported: # wrap: Two log files are maintained: stor????.log0 and # and stor????.log1. Logging alternates between # these - switching to the other file each time # the maximum size specified by the logfile_size # parameter is reached. The modified time on the # files can be used to determine the current one. # # dated: A separate log file is used for each day: # stor????-YYYYMMDD.log. (storapid-20041130.log) # There are no size limits on these files. # # These log files are written to the following # directory: # UNIX: /var/symapi/log # Windows: c:\\Program Files\\EMC\\SYMAPI\\log # # The dated logfile_type is recommended for storstpd. # storstpd:logfile_type = dated #------------------------------------------------------------------------------ # # Parameter: dmn_service_processor_delay # # Allowed values: 0 - 30 # # Default value: 9 (minutes) # # Description: Tells storstpd, when running on the service processor, # to delay this many minutes before starting anything, # giving time for other applications or tasks that # execute at system boot to execute before collections # begin. This option is ignored when running on a host. # # storstpd:dmn_service_processor_delay = 0 #------------------------------------------------------------------------------ # # Parameter: dmn_run_spa # # Allowed values: disable | enable # # Default value: enable # # Description: Determines if storstpd starts the necessary # components for supporting the SPA application. # # Note: SPA support is not available on the service # processor and the setting of this option is ignored. # # storstpd:dmn_run_spa = disable # storstpd:dmn_run_spa = enable #------------------------------------------------------------------------------ # # Parameter: dmn_run_smc # # Allowed values: disable | enable # # Default value: enable # # Description: Determines if storstpd starts the necessary # components for supporting the SMC application. # # Note: SMC is supported on the service processor. # # storstpd:dmn_run_smc = disable # storstpd:dmn_run_smc = enable #------------------------------------------------------------------------------ # # Parameter: dmn_run_ttp # # Allowed values: disable | enable # # Default value: disable # # Description: Determines if storstpd starts the necessary # components for supporting TTP collection on a host. # # storstpd:dmn_run_ttp = enable # storstpd:dmn_run_ttp = disable #------------------------------------------------------------------------------ # # Parameter: dmn_run_ttp_on_sp # # Allowed values: disable | enable # # Default value: enable # # Description: Determines if storstpd starts the necessary # components for supporting TTP collection on the # service processor. # # Note: When enabled on the service processor, two # collections files will be created. One containing # the normal full collection and another containing # an SRDF/A only collection. # # storstpd:dmn_run_ttp_on_sp = disable #------------------------------------------------------------------------------ # # Parameter: dmn_run_rtc # # Allowed values: disable | enable # # Default value: enable # # Description: Determines if storstpd starts the necessary # components for real-time metrics collection. # # storstpd:dmn_run_rtc = disable #------------------------------------------------------------------------------ # # Parameter: dmn_rtc_data_encode # # Allowed values: enable | disable # # Default value: disable # # Description: Indicates that the real time data posted will be # compressed/encoded. # # storstpd:dmn_rtc_data_encode = disable #------------------------------------------------------------------------------ # # Parameter: dmn_root_location # # Allowed values: Full file path specification. # # Default value: UNIX: /var/symapi/stp # Windows: c:\\Program Files\\EMC\\SYMAPI\\stp # # Description: Specifies a full file/path location that storstpd # will use as its root directory for file creation. # # Note: This location MUST exist or will revert to # default location. # # storstpd:dmn_root_location = c:\\Program Files\\EMC\\SYMAPI\\stp #------------------------------------------------------------------------------ # # Parameter: dmn_symmids # # Allowed values: A comma-separated list of Symmetrix IDs; shortcuts # are supported. # # Default value: None (all symids) # # Description: Specifies a set of Symmetrix arrays for which the # storstpd should collect statistics. # If not present, storstpd will collect statistics # for all local symids found. # storstpd:dmn_symmids = 192603525,192603856,192604682,192605245,192605835,195701411 #------------------------------------------------------------------------------ # # Parameter: dmn_max_arrays # # Allowed values: 1 - 50 # # Default value: 6 # # Description: Specifies the maximum number of arrays on which # storstpd can collect. If the number of local arrays # listed in dmn_symmids exceeds, or if dmn_symmids is # null and the number of local arrays exceeds # dmn_max_arrays, no collections will run. # storstpd:dmn_max_arrays = 10 #------------------------------------------------------------------------------ # # Parameter: dmn_remote_mode # # Allowed values: enable | disable # # Default value: disable # # Description: Indicates that storstpd will establish a remote # connection, instead of operating locally. A valid # dmn_remote_address and dmn_remote_port must be # provided. This setting is ignored when running on a # service processor. # # storstpd:dmn_remote_mode = enable #------------------------------------------------------------------------------ # # Parameter: dmn_remote_address # # Allowed values: A valid IP address. # # Default value: None # # Description: Specifies a valid IP address used to establish a remote # SYMAPI connection. This setting is ignored if # dmn_remote_mode is disabled. # # storstpd:dmn_remote_address = 127.0.0.1 #------------------------------------------------------------------------------ # # Parameter: dmn_remote_port # # Allowed values: A valid IP port. # # Default value: 2707 # # Description: Specifies a valid IP port used to establish a remote # SYMAPI connection. This setting is ignored if # dmn_remote_mode is disabled. # # storstpd:dmn_remote_port = 2707 # #------------------------------------------------------------------------------ # # Parameter: sync_vp_data # # Allowed values: disable | enable # # Default value: enable # # Description: Determines if storstpd syncs Virtual Provisioning # information. The daemon_options parameter # "sync_vp_data_interval" determines the interval # at which this sync is done. # # storstpd:sync_vp_data = disable #------------------------------------------------------------------------------ # # Parameter: sync_vp_data_interval # # Allowed values: A number, in minutes. # Minimum of 5 minutes. # # Default value: 5 # # Description: Determines the interval at which storstpd syncs Virtual # Provisioning information if "sync_vp_data" is enabled. # # storstpd:sync_vp_data_interval = 5 #------------------------------------------------------------------------------ # ################################################################################ ### storstpd SMC Packager options ### ### These options control how the SMC Packager behaves. ################################################################################ # # Parameter: smc_collect_interval # # Allowed values: A number, in minutes (2-4, 5, 10, 15). # Minimum of 2 minutes. # # Default value: 5 # # Description: Specifies how frequently storstpd collects statistics # for the SMC application. # # storstpd:smc_collect_interval = 2 # ################################################################################ ### storstpd Real-time collector/Packager options ### ### These options control how the Real-time collector/Packager behaves. ################################################################################ # # Parameter: rtc_collect_interval # # Allowed values: A number, in seconds (2-4, 5, 10, 15). # Minimum of 2 seconds. # # Default value: 2 # # Description: Specifies how frequently storstpd collects real-time # statistics # # storstpd:rtc_collect_interval = 2 # ################################################################################ ### storstpd TTP Packager options ### ### These options control how the TTP Packager behaves. ################################################################################ # # Parameter: ttp_retention_days # # Allowed values: 0-365 # # Default value: 30 # # Description: Sets the current retention policy, in days. # # storstpd:ttp_retention_days = 7 #------------------------------------------------------------------------------ # # Parameter: ttp_disk_space_threshold # # Allowed values: 1 - 99 # # Default value: 80 # # Description: Tells storstpd not to allow ttp/btp disk space # consumption to rise about the threshold. # Must be an integer from 1 (percent) to 99 (percent). # # storstpd:ttp_disk_space_threshold = 80 #------------------------------------------------------------------------------ # # Parameter: ttp_collection_interval # # Allowed values: A number, in minutes [1-5, 10, 15]. # # Default value: 15 # # Description: How frequently storstpd collects TTP statistics. ## When running on the service processor the minimum # interval is 1 minute. # # IMPORTANT: # Using collection intervals of less than 5 minutes when # running on the Service Processor is not recommended and # usage of such intervals is for the discretion of a # qualified EMC Performance Guru. # # When running on a host with SPA enabled, the minimum # interval is 5 minutes. # # When running on a host with SPA disabled the minimum # interval is 2 if SMC is enabled, 1 if SMC is disabled. # # storstpd:ttp_collection_interval = 10 #------------------------------------------------------------------------------ # # Parameter: ttp_collect_iterations # # Allowed values: A number. If zero, ignored. # # Default value: 0 # # Description: Tells storstpd to collect n iterations of TTP # and then end the collection. # # storstpd:ttp_collect_iterations = 10 #------------------------------------------------------------------------------ # # Parameter: ttp_archive_time # # Allowed values: A time. HH:MM # # Default value: 00:00 # # Description: The time of day to archive TTP collection file. # # storstpd:ttp_archive_time = 00:00 #------------------------------------------------------------------------------ # # Parameter: ttp_archive_interval # # Allowed values: Number of hours, HH, from 0-24. # # Default value: 4 # # Description: Tells storstpd to archive every HH hours. # A setting of 4 will tell storstpd to archive # every 4 hours. auto_archive must be enabled. # hist_archive_time will be ignored. # # storstpd:ttp_archive_interval = 2 #------------------------------------------------------------------------------ # # Parameter: ttp_sys_metrics # # Allowed values: disable | enable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # system performance category. # # storstpd:ttp_sys_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_dev_metrics # # Allowed values: disable | enable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # device performance category. ################################################################################ ################################################################################ ### ### ### If ttp_dev_metrics is ENABLED, ttp_sgdev_metrics, ttp_dgdev_metrics and ### ### ttp_cpdev_metrics should be DISABLED. ### ### ### ################################################################################ ################################################################################ # # storstpd:ttp_dev_metrics = disable # # Parameter: ttp_dir_metrics # # Allowed values: disable | enable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # director performance category. # # storstpd:ttp_dir_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_disk_metrics # # Allowed values: disable | enable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # disk performance category. # # storstpd:ttp_disk_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_port_metrics # # Allowed values: disable | enable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # director port performance category. # # storstpd:ttp_port_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_rdfa_metrics # # Allowed values: disable | enable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # rdfa performance category. # # storstpd:ttp_rdfa_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_ors_metrics # # Allowed values: disable | enable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # Open Replicator performance category. # # storstpd:ttp_ors_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_dgdev_metrics # # Allowed values: enable | disable # # Default value: disable # # Description: Tells storstpd to collect device TTP counters for the # device group performance category. # ################################################################################ ### ### ### If ttp_dgdev_metrics is ENABLED, ttp_dev_metrics, ttp_sgdev_metrics and ### ### ttp_cpdev_metrics should be DISABLED. ### ### ### ################################################################################ # # storstpd:ttp_dgdev_metrics = enable #------------------------------------------------------------------------------ # # Parameter: ttp_sgdev_metrics # # Allowed values: enable | disable # # Default value: disable # # Description: Tells storstpd to collect device TTP counters for the # storage group performance category. # ################################################################################ ### ### ### If ttp_sgdev_metrics is ENABLED, ttp_dev_metrics, ttp_dgdev_metrics and ### ### ttp_cpdev_metrics should be DISABLED. ### ### ### ################################################################################ # # storstpd:ttp_sgdev_metrics = enable #------------------------------------------------------------------------------ # # Parameter: ttp_cpt_metrics # # Allowed values: enable | disable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # cache partition performance category. # # storstpd:ttp_cpt_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_cpdev_metrics # # Allowed values: enable | disable # # Default value: disable # # Description: Tells storstpd to collect device TTP counters for the # cache partition device performance category. # ################################################################################ ### ### ### If ttp_cpdev_metrics is ENABLED, ttp_dev_metrics, ttp_dgdev_metrics and ### ### ttp_sgdev_metrics should be DISABLED. ### ### ### ################################################################################ # # storstpd:ttp_cpdev_metrics = enable #------------------------------------------------------------------------------ # # Parameter: ttp_rdfsys_metrics # # Allowed values: enable | disable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # RDF system performance category. # # storstpd:ttp_rdfsys_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_rdfdir_metrics # # Allowed values: enable | disable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # RDF director performance category. # # storstpd:ttp_rdfdir_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_rdfdev_metrics # # Allowed values: enable | disable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # RDF device performance category. # # storstpd:ttp_rdfdev_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_rdfgrp_metrics # # Allowed values: enable | disable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # RDF group performance category. # # storstpd:ttp_rdfgrp_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_se_tcp_metrics # # Description: Tells storstpd whether to collect TTP counters for the # Dir-SE TCP connection statistics category. # # Allowed values: enable | disable # # Default value: disable # # storstpd:ttp_se_tcp_metrics = enable #------------------------------------------------------------------------------ # # Parameter: ttp_se_nw_metrics # # Allowed values: enable | disable # # Default value: disable # # Description: Tells storstpd whether to collect TTP counters for the # Dir-SE network statistics category. # # storstpd:ttp_se_nw_metrics = enable #------------------------------------------------------------------------------ # # Parameter: ttp_se_nwi_metrics # # Allowed values: enable | disable # # Default value: disable # # Description: Tells storstpd whether to collect TTP counters for the # Dir-SE N/W interface statistics category. # # storstpd:ttp_se_nwi_metrics = enable #------------------------------------------------------------------------------ # # Parameter: ttp_re_sg_metrics # # Allowed values: enable | disable # # Default value: disable # # Description: Tells storstpd whether to collect TTP counters for the # Dir-RE speedlimit group statistics category. # # storstpd:ttp_re_sg_metrics = enable #------------------------------------------------------------------------------ # # Parameter: ttp_re_nwc_metrics # # Allowed values: enable | disable # # Default value: disable ## # Description: Tells storstpd whether to collect TTP counters for the # Dir-RE N/W compression statistics category. # # storstpd:ttp_re_nwc_metrics = enable #------------------------------------------------------------------------------ # # Parameter: ttp_tp_dev_metrics # # Allowed values: enable | disable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # TP pool device statistics category. # # storstpd:ttp_tp_dev_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_tp_metrics # # Allowed values: enable | disable # # Default value: enable # # Description: Tells storstpd whether to collect TTP counters for the # TP pool statistics category. # # storstpd:ttp_tp_metrics = disable #------------------------------------------------------------------------------ # # Parameter: ttp_dev_local_metrics # # Allowed values: disable | enable # # Default value: disable # # Description: Tells storstpd whether to collect TTP counters for the # device locality category. # # storstpd:ttp_dev_local_metrics = enable #------------------------------------------------------------------------------ # ############################################################################### ### Database Daemon parameters ### ### These daemons are used by the EMC Solutions Enabler SRM component to ### communicate with various Database products (Oracle, Sybase, etc.). ### Refer to their man pages. ### Daemon names can be one of the following: ### stororad One of the Oracle DB Daemons ### storsqld One of the SQL-Server DB Daemons ### storsybsd One of the Sybase DB Daemons ### storudb One of the UDB DB Daemons ### storifmxd One of the Informix DB Daemons ### ### If a Database SID (Instance) is being used, that is appended ### to the daemon name as follows: ### stororadInst1 Instance (SID) 'Inst1' of Oracle DB Daemon ### ### As previously noted, wildcarding on the daemon name is possible: ### stororad Applies to the default (no SID) daemon. ### stororadInst1 Applies to the 'Inst1' instance of the daemon. ### stororad* Applies to any instance of the daemon - ### including the default (no SID) one. ###############################################################################