ETERNUS SF XL-DATA/MV V13 User's Guide

2.6.1.4 Set the Data Transfer Environment Settings File

The data transfer environment settings file is the file that sets the environment settings that XL-DATA/MV requires during data transfer.
Information set to this file includes information regarding the following function:

• Data Transfer Statistical Information Output Function
• Operation of Cluster System("virtual node name" (UNIX server) or "virtual computer name" (IA server))

This file is created to the following locations during installation:

For UNIX servers	:	/etc/mftf/env/mftfenv.conf
For IA servers	:	installation directory $mftfenv.ini (Note: "$" means a backslash.)

[Syntax]

Set the data transfer environment settings file according to the following rules.

0                                                    256 bytes

Environment item name = value    <-information line  
#Comments
    :



• Up to 256 bytes of characters can be specified per line.
• Comments begin with # and continue to the end of the line.
• Use spaces or tabs to separate each piece of the information line (left, =, and right).
• Multiple information lines cannot be specified in a single line.
• Comments cannot be added after the right side.
• Multiple instances of an environment item cannot be specified.
• The environment item name must be in upper case.
• The environment item name, "=", and value are all required.

[Information]

Environment Item Name

The following are the environment item names.

Environment Item Name	Definition
PUTDIR	This sets the output directory of the data transfer statistical information output file.
PUTLINE	This sets the switch of the data transfer statistical information output file.
SERVERNAME	This sets the "virtual node name" (UNIX server) or the "virtual computer name" (IA server). When the XL-DATA/MV is operated on the cluster system,this information is used.

Setting Values

The following discusses the setting values for each environment item name.

PUTDIR = directory name

Set the full path of the output directory of the data transfer statistical information output file within 200 bytes.
The data transfer statistical information is not output when omitting both this environment item and the PUTLINE.
This setting is commented out during installation.

When setting this value, take into consideration the PUTLINE setting value and select a directory that has sufficient space.
Refer to "Calculating the Dat4a Size Required for the Output of the Data Transfer Statistical Information" for the space required for the output of the data transfer statistical information.

PUTLINE = {n | DATE}

There are three output files of the data transfer statistical information that are used for cyclic operations.
Set the timing when to change these output files.
The data transfer statistical information is not output when omitting both this environment item and the PUTDIR.
This setting is commented out during installation.

The following are the two types contents that can be specified:




n

This performs the switch of each output file based on the number of outputs.
Specify a number of outputs to each of the output files within the range of 500 - 10000.
When the number of outputs meets the value specified here, the output file is switched.
This cannot be specified with the "DATE".

DATE

This performs the switch of each output file each day.
When the date changes, the output file is switched after the completion of the first data transfer.
This cannot be specified with the "n" (number of output).

SERVERNAME = {virtual node name | virtual computer name}

The setting is a necessary item to operate the XL-DATA/MV on the cluster system.
This environment item must be set on both nodes.
Set the "virtual node name" (UNIX server) or the "virtual computer name" (IA server) in ASCII code within 15 bytes.

Refer to Appendix F: Operation of Cluster System for the operation of the XL-DATA/MV on the cluster system.

---

The values specified for PUTDIR and PUTLINE are setting values used by the data transfer statistical information output function.
Each time data transfer is performed and the data transfer volume is used, statistical information is output to the data transfer statistical information output file.
Therefore, these values must be set taking into consideration the usage of XL-DATA/MV and the amount of free disk space.
If a value that doesn't match the environment is specified, the output directory may run out of free space. In the event if insufficient disk space, an error is output to the console each time data transfer is executed (although data transfer completes normally).
The following is the calculation for determining the data amount used by the data transfer statistical information output function.

[Calculating the Data Size Required for the Output of the Data Transfer Statistical Information]

(1)	Information size of 1 data transfer		[maximum path name length of the client file] + [maximum path name length of the server file] + 288 bytes
(2)	Size of three data transfer statistical information output files used by a single data transfer volume.	When PUTLINE = n	[value of (1)] x [number of output specified in PUTLINE] x 3
		When PUTLINE = DATE	[value of (1)] x [number of data transfer per day for the data transfer volume] x 3
(3)	Size used by the data transfer statistical information output file.		[value of (2)] x [number of times the data transfer volume is used]

Based on the above, the value obtained for (3) is the required disk space.

---

Handling the data transfer environment settings file and the data transfer statistical information output file.

• Make changes to the data transfer environment file after the data transfer command, the daemon, and the service have stopped.
• When changing the setting values in the data transfer environment settings file, back up the data transfer statistical information output files that were previously output if necessary, then delete them.