Top
ETERNUS SF Storage Cruiser 14.0 User's Guide

C.2 sanma.conf Parameter

This file is saved at the following location as a detailed setting file of the storage management:

Platform of Manager

Location

Windows

$ENV_DIR\Manager\etc\opt\FJSVssmgr\current\sanma.conf
($ENV_DIR means "Environment Directory" specified at the Manager installation.)

Solaris OS,
Linux

/etc/opt/FJSVssmgr/current/sanma.conf


Reflecting the contents of the setting file

If the setting file is changed, select [Tool] - [Option] - [Re-read Definition File] from the resource view, or reactivate the Manager. This reflects the settings on this software.


Customization

Note

Note that the memory or the disk capacity may become insufficient when the number of generations or the maximum capacity of each log file is increased. Operation may stop when the memory or the disk capacity becomes insufficient.

Note when changing the number of generations or maximum capacity, secure the memory capacity and the disk capacity.

AUTODISCOVER_SUBNET

Specify the address of a subnet searched during an automatic device search. Use a "," (comma) to define multiple subnets.

Example:
AUTODISCOVER_SUBNET="10.12.13.255,133.134.13.255";

The administrative server issues SNMP broadcasts for automatic device detection in these subnets, but if the broadcast is limited by network settings, this function is not enabled.

LOGICAL_MANAGER_IP

If the administrative server is cluster system which has physical IPs and logical IP, logical IP address must be specified in this parameter.

Example:
LOGICAL_MANAGER_IP="10.12.13.14";

When a device is added to devices subject to fault monitoring, the parameter is used for automatically setting the SNMP Trap transmission place for the device. For details, see "5.2.5 SNMP Trap transmission place automatic setting function".

MANAGER_LAN_CARD_IP

Specify this parameter so that Manager recognizes the IP address of a LAN card in the administrative server.

The parameter must be set in order to search for a device during Manager operation where multiple LAN cards are used.

Example:
MANAGER_LAN_CARD_IP="10.12.13.14,100.101.102.103";
SET_SW_ZONING_ALWAYS

When an access path is set, if the zoning setting for the Fibre Channel switch need not be added because port zoning is set, this software does not generally set zoning for Fibre Channel. Specifying 1 in this parameter sets one-to-one WWPN zoning even in the above case (excluding cases in the No Security state):

Example:
SET_SW_ZONING_ALWAYS=1; (Default: 0)
DISPLAY_SNMP_STANDARD_EVENT

Specify whether the SNMP Trap common to devices from a device is indicated in the event log. Setting 1 for this parameter indicates the SNMP Trap common to devices. Setting 0 for this parameter does not indicate it. Default is 1 (indicate).

Example:
DISPLAY_ SNMP_STANDARD_EVENT = 0;
SNMP_COMMUNITY_NAME_FOR_IP

For communication using SNMP between this software and a device, "public"(READ-direction) and "private"(WRITE-direction) are used for the SNMP community name.

For such communication using any name other than "public" and "private", specify its community name in this parameter.

Specify the IP address of the device and the community name used for SNMP communication with the device, delimiting them with a space.

When setting "abc" as the community name used for SNMP communication with IP address 10.11.12.13, set as follows:

Example:
SNMP_COMMUNITY_NAME_FOR_IP="10.11.12.13 abc";

Wild card definitions in which "*" is used at the end of the IP address is permitted.

Example:
SNMP_COMMUNITY_NAME_FOR_IP="10.11.12.* abc";
SNMP_COMMUNITY_NAME_FOR_IP="20.21.*.* def";
SNMP_COMMUNITY_NAME_FOR_IP="30.*.*.* ghi";

To define community names for multiple devices, specify the names on as many definition lines as the number of devices.

Example:
SNMP_COMMUNITY_NAME_FOR_IP="10.11.12.13 abc";
SNMP_COMMUNITY_NAME_FOR_IP="10.11.14.15 def";

If community names must be different in the READ-direction and WRITE-direction of SNMP communication, specify a device IP address, community name used for READ-direction, and community name used for WRITE-direction, delimiting them with a space.

When setting "abc" as the READ-direction community name and "def" as the WRITE-direction community name used for SNMP communication with IP address 10.11.12.13, set as follows:

Example:
SNMP_COMMUNITY_NAME_FOR_IP="10.11.12.13 abc def";
SNMP_COMMUNITY_NAME_FOR_AUTODISCOVER

Using the SNMP protocol, the Intra-subnet device detection function detects devices. The "public" is used as the community name. To change the community name "public" to a required name, specify the name in this parameter. When specifying this parameter, be sure to specify SNMP_COMMUNITY_NAME_FOR_IP.

When community name is "abc," set as follows:

Example:
SNMP_COMMUNITY_NAME_FOR_AUTODISCOVER="abc";

In an environment where each device has a unique community name, not all devices can be detected even if the parameter is specified. In this case, specify only SNMP_COMMUNITY_NAME_FOR_IP to search for one device at a time.

LOG_CYCLE

The number of generations of log files (log.* and event.*) of the whole storage management is specified by an arbitrary decimal number. Default is two. It circulates in the second generation (log.0 and log.1 or event.0 and event.1), when 2 is set.

Example for circulating in the fifth generation:
LOG_CYCLE = 5;
Location of the log file

Platform of Manager

Location

Windows

$TMP_DIR\Manager\var\opt\FJSVssmgr\current
($TMP_DIR means "Work Directory" specified at the Manager installation.)

Solaris OS,
Linux

/var/opt/FJSVssmgr/current

LOG_MAX_SIZE

The maximum capacity of the log file (log.* and event.*) of the whole storage management is specified within the range of 0-2147483647 (KB). When 0 is specified, the log is not output. Moreover, when the value is specified outside the range, it becomes a default value. Default capacity is 1024(KB).

Example for setting the maximum capacity to 2MB:
LOG_MAX_SIZE = 2048;

For location of the log files, refer to LOG_CYCLE.

SNMPTH_LOG_COUNT

The number of generations of log files (snmpth.*) related to SNMP Trap is specified by an arbitrary decimal number.

Default is 2.

It circulates in the second generation (snmpth.0 and snmpth.1), when 2 is set.

Example for circulating in the fifth generation:
SNMPTH_LOG_COUNT = 5;

For location of the log files, refer to LOG_CYCLE.

SNMPTH_LOG_LIMIT

The maximum capacity of the log file (snmpth.*) related to SNMP Trap is specified within the range of 0-2147483647 (KB).

Default capacity is 1024 (KB).

When 0 is specified, the log is not output. Moreover, when the value is specified outside the range, it becomes a default value.

Example for setting the maximum capacity to 2MB:
SNMPTH_LOG_LIMIT = 2048;

For location of the log files, refer to LOG_CYCLE.

SILKWORM_ZONING_DELAY_TIMER

The waiting time to command execution of the zoning setting for the ETERNUS SN200 series Fibre Channel switch is specified by unit of milliseconds. Default value is 3000 (3 seconds).

When setting the waiting time to 5 seconds, set as follows:

Example:
SILKWORM_ZONING_DELAY_TIMER = 5000;

Less than 3000 (3 seconds) cannot be specified. When it was set less than 3000 or when setting is inaccurate, 3000 which is a default is assumed. In addition, this setting is required when the following events are reported from the ETERNUS SN200 series Fibre Channel switch at the time of an access path setup.

ZONE-TRANSCOMMIT Transaction Commit failed. Reason code 10 - "Fabric Merging"
ZONE-TRANSCOMMIT Transaction Commit failed. Reason code 2 - "Aca Was Rejected"

This event shows the error about the zoning setting command of a Fibre Channel switch. By setting a large value as the waiting time of command execution, the error is avoidable.

FIRMWARE_VERSION_CHECK

Any "Unsupported Firmware Version" message output to the event log indicates that a device with firmware not supported by ETERNUS SF Storage Cruiser has been detected. This message is output at the time of an operation such as "Refresh".

To suppress output of the message, make the following setting:

FIRMWARE_VERSION_CHECK = 0;

Since new firmware can be supported by applying certain patches to ETERNUS SF Storage Cruiser, be sure to delete this setting after applying the patches.

SILKWORM_SUPPORTED_FIRMWARE_VERSION

In consideration of incompatibility of Fibre Channel switch firmware, if unsupported firmware is detected, all functions including the configuration management functions are restricted. Normally, in such cases, patches need to be applied to ETERNUS SF Storage Cruiser. However, when such firmware has no incompatibility, it can be handled without applying patches.

Note

Make this setting only for firmware that is confirmed to have no incompatibility.
The procedure for upgrading firmware is described in the firmware upgrade manual.
If it is impossible to confirm that firmware has no incompatibility, contact your Fujitsu CE or SE.

For example, to handle the firmware that has no incompatibility and whose version is v12.34.56a, make settings as follows.

First, change each of the three numeric values in firmware version v12.34.56a to a two-digit value in hexadecimal notation.
Characters such as the first "v" and the last "a" need not be considered.

12 -> 0C
34 -> 22
56 -> 38

Then, these three two-digit values are concatenated to produce a six-digit value in hexadecimal notation.

0C2238

Specify this value as follows:

SILKWORM_SUPPORTED_FIRMWARE_VERSION = "0C2238";

When specifying multiple versions, delimit them with a comma ",".
To specify both v2.4.1 and v5.0.1, describe them as follows:

SILKWORM_SUPPORTED_FIRMWARE_VERSION = "020401,050001";

The hyphen "-" can be used to specify a range of version.
To specify versions v4.0.0 to v4.2.2, describe them as shown below. Be sure to describe the smaller version number first.

SILKWORM_SUPPORTED_FIRMWARE_VERSION = "040000-040202";

Also, the above description methods can be combined.

SILKWORM_SUPPORTED_FIRMWARE_VERSION = "020401,040000-040202,050001";