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
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. 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.
THIN-POOL-MONITORING=BY-AVOID-FILE
Thin pools which are entered in the thinpoolavoid file (in the /var/shcosd/config directory are not monitored.
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, *MU2, *SE1MU1, *SE1MU2, *SE2MU1, *SE2MU2, *SE3MU1, *SE3MU2, *SE4MU1 and *SE4MU2 can be used for SE servers. When the values *MU1 or *MU2 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.
When the values *SE1MU1 to *SE4MU2 are specified, SHC-OSD connects the StorMan server on exactly the specified Management Unit (MU) of the specified SE-Unit.
This parameter specifies on or multiple redundant StorMan servers.
This parameter is required during the start of subsystem SHC-OSD to open a socket connection to one StorMan server. The first active StorMan server (status OK) from the SHC-OSD parameter file is connected. The status of all StorMan server defined in the parameter file is updated during subsystem start and again latest after failure detection of the connected StorMan server. An automatic failover of the StorMan server is processed if there are mulitple StorMan server defined and active.
The port of StorMan Server is static: 4178.
StorMan should be installed and active on each MU of the SE Servers (Add-On STORMAN). Up to eight StorMan server can be defined by their MU name, BCAM name, or IP adress. IPv4 and IPv6 connections are supported.
Multiple StorMan servers are separated by commas. The entry is also case-sensitive.
MUs of SE server can be specified with these keywords: *MU1 and *MU2, or *SE1MU1, *SE1MU2, *SE2MU1, *SE2MU2, *SE3MU1, *SE3MU2, *SE4MU1 and *SE4MU2.
*MU1 oder *MU2
The setting supports two redundant Management Units (MUs) in the Cluster.
SSHC-OSD automatically connects to an active StorMan server of a Management Unit (MU) in the Management Cluster. *MU1 means the first online MU, *MU2 specifies an optional second available online MU. MUs of the own SE Server are preferred for connections.
*SE1MU1 bis *SE4MU2
The setting supports up to 8 Management Units (MUs) on multiple SE servers according to the internal SE and MU notation.
SHC-OSD automatically connects to the StorMan server on the specified Management Unit (MU) of the specified SE-Unit. The first MU with active StorMan server is selected from the list.
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.
HOLD-IO-TIMEOUT=
This parameter defines the timeout value in seconds for the HOLD-IO option.
HOLD-IO-TIMEOUT = <int_1..999>
The IO activity is resumed after reaching the timeout.
The default setting is 180 seconds.
Current delivery file for SHC-OSD
#====================================================================== # Parameter file for SHC-OSD V15.0: SYSPAR.SHC-OSD.150 #====================================================================== # #====================================================================== # Global Parameters: #---------------------------------------------------------------------- # 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 # *SE1MU1 (keyword) on MU1 of SE1 # *SE1MU2 (keyword) on MU2 of SE1 # *SE2MU1 (keyword) on MU1 of SE2 # *SE2MU2 (keyword) on MU2 of SE2 # *SE3MU1 (keyword) on MU1 of SE3 # *SE3MU2 (keyword) on MU2 of SE3 # *SE4MU1 (keyword) on MU1 of SE4 # *SE4MU2 (keyword) on MU2 of SE4 # <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 # #---------------------------------------------------------------------- # Parameter defining the HOLD-IO timeout in seconds # - after this timeout the hold IOs are resumed anyway even if the # action is not yet terminated by StorMan # # HOLD-IO-TIMEOUT= timeout value for HOLD-IO # VALUES: <int_1..999> timeout in sec. (DEFAULT=180) # HOLD-IO-TIMEOUT=180 # #----------------------------------------------------------------------