Parameter file SYSPAR.SHC-OSD.<ver> for configuring SHC-OSD is supplied with SHC-OSD. Changes in the parameter file become effective only when the SHC-OSD subsystem is restarted.
Global parameters
DISCOVER-MODE=
This parameter controls which storage systems are to be registered and administered with SHC-OSD.
DISCOVER-MODE=FULL
All supported storage systems (default setting).
DISCOVER-MODE=BY-SYMAPI
Only storage systems administered via SYMAPI are taken into account (Symmetrix/VMAX3).
DISCOVER-MODE=BY-STORMAN
Only storage systems administered via StorMan are taken into account (ETERNUS DX/AF).
SYSTEM-ADMIN-SCOPE=
The parameter defines the global security settings for executing actions. Depending on the setting, such actions may be performed only for devices attached or defined (generated) in BS2000 or for any devices of a storage system.
DETACHED-DEVICE=REJECT
Actions are rejected for detached devices.
DETACHED-DEVICES=ACCEPT
Actions are executed for detached devices.
NOT-DEFINED-DEVICES=REJECT
Actions are rejected for devices not generated.
NOT-DEFINED-DEVICES=ACCEPT
Actions are executed for devices not generated.
LOG-FILE-RETENTION=10 / <integer 1..999>
This parameter enables you to preset a value in days after which an SHC-OSD logging file is automatically deleted (see also "Diagnostic aids").
THIN-POOL-MONITORING=
This parameter controls the monitoring of thin pools for ETERNUS DX/AF and Symmetrix/VMAX3. The SHC-OSD information commands display whether the thin pool is monitored by SHC-OSD.
THIN-POOL-MONITORING=ON
All thin pools are monitored.
A message is displayed on the console when the threshold values are reached.
THIN-POOL-MONITORING=OFF
Thin pools are not monitored.
No messages are issued when threshold values are reached.
THIN-POOL-MONITORING=BS2-VOLUMES
Default setting. Only thin pools containing BS2000 volumes are monitored. For VMAX3, all thin pools are monitored.
THIN-POOL-MONITORING=BY-AVOID-FILE
Thin pools which are entered in the thinpoolavoid file (in the /var/shcosd/config directory are not monitored (not for VMAX3).
Parameters for operating ETERNUS DX/AF
STORMAN-HOST=
This parameter specifies up to eight StorMan servers by means of their BCAM names or their IP addresses. IPv4 and IPv6 connections are supported. Multiple StorMan servers are separated by commas. The entry is also case-sensitive.
The values *MU1 and *MU2 can be used for SE servers. When these values are specified, SHC-OSD automatically connects the StorMan server of the relevant Management Unit (MU). *MU1 specifies the MU which exists by default, *MU2 an optional redundant MU.
SHC-OSD requires this entry before it starts.
When it starts, SHC-OSD activates the or the first StorMan server defined in the SHC-OSD parameter file which is in the OK status (StorMan server is running).
The StorMan port is not listed in the parameter file anymore. It always has the standard value 4178.
STORMAN-SSL=DISABLE / ENABLE
This parameter defines whether communication between SHC-OSD and StorMan is safeguarded with SSL. Multiple parameters (like the StorMan servers specified) are separated by commas.
Example
STORMAN-HOST=SERVER1,SERVER2,SERVER3,SERVER4 STORMAN-HOST=111.222.123.123,1234:123::1::0,10:123 STORMAN-SSL=DISABLE,ENABLE,ENABLE,ENABLE,ENABLE,DISABLE
When a single line is not long enough, the parameter name must be repeated in a new line. The number and order of the parameter values in STORMAN-SSL must match the specifications in STORMAN-HOST.
CLONE-TYPE=
The parameter globally controls which clone type in the START-CLONE-SESSION command is to be used as default.
CLONE-TYPE=COPY
The COPY clone type (complete clone, QuickOPC replication function) is used.
CLONE-TYPE=MIRROR
The MIRROR clone type (mirrored clone, EC replication function) is used (default setting).
STORAGE-CLUSTER-MONITORING=
The parameter controlls the monitoring of storage clusters and offers the following options:
STORAGE-CLUSTER-MONITORING=BS2-VOLUMES
This is the dafault value. Just storage clusters that contain BS2000 volumes are monitored
Changes are logged via messages in the BS2000-console.
STORAGE-CLUSTER-MONITORING=ON
All storage clusters are monitored.
Changes are logged via messages in the BS2000-console.
STORAGE-CLUSTER- MONITORING=OFF
All storage clusters are not monitored.
Changes aren't logged via messages in the BS2000-console.
FLEX-POOL-MONITORING=
This parameter controls the monitoring of flex pools (ETERNUS DX/AF). The SHC-OSD information commands display whether the flex pool is monitored by SHC-OSD.
FLEX-POOL-MONITORING=ON
All flex pools are monitored.
A message is displayed on the console when the threshold values are reached.
FLEX-POOL-MONITORING=OFF
Flex pools are not monitored.
No messages are issued when threshold values are reached.
FLEX-POOL-MONITORING=BS2-VOLUMES
Only flex pools containing BS2000 volumes are monitored (default setting).
FLEX-POOL-MONITORING=BY-AVOID-FILE
Flex pools which are entered in the thinpoolavoid file (in the /var/shcosd/config directory) are not monitored.
BS2-VOLUME-ATTR=
This parameter controls the transfer of BS2000 device data (mnemonic, VSN, catalog ID) to the StorMan server.
BS2-VOLUME-ATTR=YES
The BS2000 device data is transferred to the StorMan server.
This setting is recommended on SE servers with StorMan on an MU to enhance performance (default setting).
BS2-VOLUME-ATTR=NO
The BS2000 device data is not transferred to the StorMan server.
Parameters for operating Symmetrix/VMAX3
SYMAPI-HOST=
This parameter specifies up to four SYMAPI servers by means of their BCAM names or their IP addresses. The IPv4 protocol is supported. Multiple SYMAPI servers are separated by commas. The entry is also case-sensitive.
SHC-OSD requires this entry before it starts.
When it starts, SHC-OSD uses the SYMAPI server or the first SYMAPI server defined in the SHC-OSD parameter file which is in the OK status (SYMAPI server is running).
SYMAPI-PORT=
This parameter specifies up to four port numbers of the SYMAPI servers. Multiple port numbers (corresponding to the SYMAPI servers specified) are separated by commas.
The default value is 2707.
Example
SYMAPI-HOST=SYMAPI1,SYMAPI2 SYMAPI-HOST=111.222.123.123,1234:123::1::0 SYMAPI-PORT=2707,2707
The number and order of the parameter values in SYMAPI-PORT must match the specifications in SYMAPI-HOST.
PRESELECTED-SAVE-POOL=*STD / <poolname>
This parameter (not for VMAX3) enables a save pool to be preset when using TimeFinder/Snap on Symmetrix (see also "Snap units (Symmetrix)" and the /START-SNAP-SESSION command on "START-SNAP-SESSION Creates a snap pair"). The default value specifies the default save pool.
MULTI-SNAP=ENABLED / DISABLED
The parameter (not for VMAX3) defines the maximum number of snap units which are supported for an original unit.
MULTI-SNAP=ENABLED
The default setting ENABLED permits up to 127 snap units.
MULTI-SNAP=DISABLED
The DISABLED setting permits up to 15 snap units. This setting is a prerequisite for the RESTART-SNAP-SESSION command.
SAVE-POOL-SATURATION=
This parameter (not for VMAX3) enables a percentage threshold value to be preset to monitor the save pools when using TimeFinder/Snap on Symmetrix. The default is 80%. In other words, when the save pool is 80% full, this is displayed on the console by a message which must be acknowledged (see also "Snap units (Symmetrix)").
THIN-POOL-SATURATION=
This parameter enables a percentage threshold value to be preset to monitor thin pools for each storage system when using virtual provisioning on Symmetrix/VMAX3. The default is 80%. In other words, when a thin pool is 80% full, this is displayed on the console by a message which must be acknowledged (see also "Virtual provisioning and BS2000").
THIN-DEV-SATURATION=
This parameter (nor for VMAX3) enables a percentage threshold value to be preset to monitor thin devices when using virtual provisioning on Symmetrix/VMAX3. The default is 80%. In other words, when a thin device is 80% full, this is displayed on the console by a message which must be acknowledged (see also "Virtual provisioning and BS2000").
Current delivery file for SHC-OSD
#====================================================================== # Parameter file for SHC-OSD V14.0: SYSPAR.SHC-OSD.140 #====================================================================== # #====================================================================== # Global Parameters: #---------------------------------------------------------------------- # Parameter defining the discovery mode # # - these settings define if a discovery is performed by # StorMan (ETERNUS DX / AF), by SYMAPI (EMC SYMMETRIX / VMAX3), # or a complete discovery by SYMAPI and StorMan. # # DISCOVER-MODE= Discover storage arrays # VALUES: FULL (DEFAULT) SYMAPI and StorMan # BY-SYMAPI SYMAPI only # BY-STORMAN StorMan only # DISCOVER-MODE=FULL #---------------------------------------------------------------------- # Parameter defining the setting for log file management: # - retention in days to delete old shcosd log-files # # LOG-FILE-RETENTION= Retention period (days) for shcosd log-files # VALUES: 0 = unlimited # DEFAULT = 10 days # <int_1..999> # LOG-FILE-RETENTION=10 # # --------------------------------------------------------------------- # Parameter defining the setting for SYSTEM-ADMIN-SCOPE # # DETACHED-DEVICES= Defines the command processing for # detached devices # VALUES: REJECT (DEFAULT) # ACCEPT # # NOT-DEFINED-DEVICES= Defines the command processing for # not defined devices # VALUES: REJECT (DEFAULT) # ACCEPT # DETACHED-DEVICES=REJECT NOT-DEFINED-DEVICES=REJECT #---------------------------------------------------------------------- # Parameter defining the monitoring for Thin Provisioning # # THIN-POOL-MONITORING= Monitor the used space of Thin-Pools # VALUES: ON for all Thin-Pools # OFF monitoring is turned off # BS2-VOLUMES only for Thin-Pools # containing BS2000-Volumes # and all Thin-Pools of VMAX3. # (DEFAULT) # BY-AVOID-FILE no monitoring of Thin-Pools # defined by pool name and # storage serial number in # AVOID-FILE. # THIN-POOL-MONITORING=BS2-VOLUMES # #====================================================================== # Parameters for ETERNUS DX/AF Support: #---------------------------------------------------------------------- # Parameters defining the connection for up to 8 StorMan Server. # Specify names, port numbers, SSL setting as comma separated lists. # Continue the list in next line starting with operand keyword. # # STORMAN-HOST= Name of the StorMan Server # VALUES: *MU1 (keyword) on MU (Management Unit) # *MU2 (keyword) on redundant MU # <IP_address_15> e.g. 111.111.111.111 # <IPv6_address> e.g. 2001:DB8:0:1::10:1FF # a list of max. 8 STORMAN Server # separated by comma is supported. # # STORMAN-SSL= SSL setting of the StorMan Server # VALUES: DISABLE (DEFAULT), ENABLE # a list of max. 8 STORMAN-SSL values # separated by comma is supported. # They have to correspond to the specific # STORMAN-HOST values (list). # # STORMAN-HOST=*MU1 # or # STORMAN-HOST=111.111.111.111 # STORMAN-SSL=ENABLE # or # STORMAN-HOST=*MU1,111.111.111.111,MY_HOST,YOUR_HOST # STORMAN-SSL=ENABLE,DISABLE,ENABLE,DISABLE # #---------------------------------------------------------------------- # Parameter defining the CLONE method preselected for commands # # CLONE-TYPE= Preselected CLONE method # VALUES: MIRROR Mirror based CLONES (EC) # are preselected # (DEFAULT) # COPY Full copy CLONES (QuickOPC) # are preselected # CLONE-TYPE=MIRROR # #---------------------------------------------------------------------- # Parameter defining the monitoring of Storage Clusters # # STORAGE-CLUSTER-MONITORING= Monitor the usage of Storage Clusters # VALUES: ON monitor all Storage Clusters # (DEFAULT) # OFF monitoring is turned off # BS2-VOLUMES monitor only Storage Clusters # with BS2000 volumes # STORAGE-CLUSTER-MONITORING=BS2-VOLUMES # #---------------------------------------------------------------------- # Parameter defining the monitoring for Automated Storage Tiering # # FLEX-POOL-MONITORING= Monitor the used space of Flex-Pools # VALUES: ON for all Flex-Pools # OFF monitoring is turned off # BS2-VOLUMES only for Flex-Pools # containing BS2000-Volumes # (DEFAULT) # BY-AVOID-FILE no monitoring of Flex-Pools # defined by pool name and # storage serial number in # AVOID-FILE. # FLEX-POOL-MONITORING=BS2-VOLUMES # #---------------------------------------------------------------------- # Parameter defining if the BS2000 volume attributes MN, VSN and catid # are supplied to StorMan. # # BS2-VOLUME-ATTR = BS2000 volume attributes # VALUES: YES (DEFAULT) provided to StorMan # recommended for SE-Servers # with StorMan on *MU # NO not provided to StorMan # BS2-VOLUME-ATTR=YES # #====================================================================== # Parameters for EMC SYMMETRIX/VMAX3 Support: #---------------------------------------------------------------------- # Parameters defining the connection for up to 4 SYMAPI Server. # Specify names and port numbers as comma separated lists. # Continue the list in next line starting with operand keyword. # # SYMAPI-HOST= Name of the SYMAPI Server # VALUES: <host_name_1..48> e.g. MY_HOST,YOUR_HOST,X # <IP_address_15> e.g. 111.111.111.111 # <IPv6_address> e.g. 2001:DB8:0:1::10:1FF # a list of max. 4 SYMAPI Server # separated by comma is supported. # # SYMAPI-PORT= Port number of the SYMAPI Server # VALUES: 2707 (DEFAULT) # <port_number_1..4> e.g. 1234,5678,9876 # a list of max. 4 SYMAPI-PORT numbers # separated by comma is supported. # They have to correspond to the specific # SYMAPI-HOST values (list). # # SYMAPI-HOST=LOCALHOST,127.0.0.1,MY_HOST,YOUR_HOST # SYMAPI-PORT=2707,2707,2707,2707 # # --------------------------------------------------------------------- # Parameter defining the preselected SAVE-POOL for TimeFinder/Snap. # # PRESELECTED-SAVE-POOL= Name of the SAVE-POOL # VALUES: *STD (DEFAULT) # <name_1..32> e.g. MY_SAVE_POOL # PRESELECTED-SAVE-POOL=*STD # #---------------------------------------------------------------------- # Parameter defining the MULTI-SNAP mode for TimeFinder/Snap. # # MULTI-SNAP= Controls maximum number of Snap mirror # pairs allowed to one original unit. # VALUES: ENABLED max. 127 Snap pairs (DEFAULT) # DISABLED max. 15 Snap pairs # MULTI-SNAP=ENABLED # #---------------------------------------------------------------------- # Parameters defining threshold values for storage pool monitoring: # # - threshold value in percent for the saturation of SAVE-POOLs for # TimeFinder/Snap. # # SAVE-POOL-SATURATION= Saturation level in percent # VALUES: 80 (DEFAULT) # <int_1..100> # SAVE-POOL-SATURATION=80 # # - threshold value in percent for the saturation of THIN-POOLs for # Virtual Provisioning. # # THIN-POOL-SATURATION= Saturation level in percent # VALUES: 80 (DEFAULT) # <int_1..100> # THIN-POOL-SATURATION=80 # # - threshold value in percent for the saturation of THIN volumes for # Virtual Provisioning. # # THIN-DEV-SATURATION= Saturation level in percent # VALUES: 80 (DEFAULT) # <int_1..100> # THIN-DEV-SATURATION=80 # #----------------------------------------------------------------------