Top
ETERNUS SF Storage Cruiser 14.0 User's Guidefor Virtual Storage Conductor

3.2.2 Environmental settings for each node

This section describes the environmental settings required for each admin server.


3.2.2.1 Modifying system configuration files

Communication between an admin server and a virtualization switch is performed using the Transmission Control Protocol (TCP) of Internet Protocol (IP). Therefore, you must modify the following system configuration files:

%SystemRoot%\system32\drivers\etc\hosts file

Register the host name and IP address of Ethernet port for virtualization switch control of a virtualization switch in the %SystemRoot%\system32\drivers\etc\hosts file.

A virtualization switch must have a host name beginning with "vsce" as the first four characters. This character string should be followed by a number from 1 to 128 in ascending order.

For a virtualization switch in a redundant LAN configuration, enter a representative IP address of Ethernet port for virtualization switch control specified for the virtualization switch.

Example

Example of coding in the %SystemRoot%\system32\drivers\etc\hosts file

The following shows an example of coding in the %SystemRoot%\system32\drivers\etc\hosts file for virtualization switches with IP addresses 192.168.1.2 and 192.168.1.3.

192.168.1.2    vsce1                  # VS900 Model 300 No.1
192.168.1.3    vsce2                  # VS900 Model 300 No.2

%SystemRoot%\system32\drivers\etc\services file

In the %SystemRoot%\system32\drivers\etc\services file, register a service name and a port number.

Register the following two services:

Service name

Port number

protocol

ssvscme

7420

tcp
udp

The service name cannot be changed.

Port number 7420 can be changed if already used for another service. When doing so, change the port number specified in "VSCE_PORT" in the configuration data file and that for the virtualization switch. Specify a unique port number in the entire system of servers and peripheral devices.

Example

Example of coding in the %SystemRoot%\system32\drivers\etc\services file

The following shows an example of coding in the %SystemRoot%\system32\drivers\etc\services file.

ssvscme         7420/tcp           # VSC Manager - VSC Engine(TCP)
ssvscme         7420/udp           # VSC Manager - VSC Engine(UDP)

3.2.2.2 Creating a configuration data file

Note that "$ENV_DIR\Manager\etc\opt\FJSVssmgr\current\FJSVssvsc.ini" is the configuration data file.
($ENV_DIR means "Environment Directory" specified at the Manager installation.)

Also note that "$ENV_DIR\Manager\opt\FJSVssmgr\lib\sample\vsc\FJSVssvsc.ini.sample" contains samples of configuration data files.

#
# All Rights Reserved, Copyright (c) Fujitsu Ltd. 2004
#
# Storage Software Virtual Storage Conductor
#
# FJSVssvsc.ini: configuration file
#
########################################################

LOG_LEVEL=4

COPY_HISTORY_ROTATE_NUMBER=2

If no configuration data file is created, the default values are assumed specified for all settings in the system.

Note

Modifying a configuration data file

A configuration data file cannot be modified while the Manager is running. Be sure to stop the Manager before modifying the configuration data file.

You can modify a configuration data file as follows:


Coding format

Coding of a configuration data file is shown as follows:

Configuration items

The following table indicates the configuration item in a configuration data file.

Table 3.2 List of configuration items

Item

Item name

Outline of setting this item

Omission of item

LOG_LEVEL

Log level

Specifies the output level of a message.

Possible

COPY_HISTORY_ROTATE_NUMBER

Number of generations in the copy history

Specifies the number of generations retained in the copy history log file.

Possible

LOG_LEVEL

Specify the error type of messages to be output.

Messages are output via syslogd(1M). Therefore, the settings in eventlog determine whether messages are actually output and to what file messages are output. For information on how to make settings in eventlog, see syslog.conf(4).

If this item is omitted, messages with error type "ERR" are output.

Format

LOG_LEVEL={1 | 2 | 3 | 4}

Description of operands

1: Outputs messages for error type "ERR".

2: Outputs messages for error types "ERR" and "WARNING".

3: Outputs messages for error types "ERR", "WARNING", "NOTICE" and "INFO".

4: Outputs messages for error types "ERR", "WARNING", "NOTICE", "INFO" and "DEBUG".

COPY_HISTORY_ROTATE_NUMBER

Specifies the number of generations retained in the copy history log file.

The default number of generations is 2.

Format

COPY_HISTORY_ROTATE_NUMBER={2|3|4|5}

Description of operands

Specify a value ranging from 2 to 5.


3.2.2.3 Creating a commit script

When you perform an operation on VSC Manager to modify the configuration information of virtual storage, VSC Manager executes a program or script to create a backup or copy of the virtual storage configuration information. This program or script is called a "Commit Script".

If the virtual storage configuration information is lost due for some reason, no virtual disk can be supplied to a transaction server. Even in case of such unexpected trouble, you must restore the virtual storage configuration information to resume operation. A commit script is intended to create a backup or copy of the virtual storage configuration information in case of any unexpected trouble.

Create a commit script in "$ENV_DIR\Manager\etc\opt\FJSVssmgr\current\VscCommitScript.bat" and give it an execution right.

Note that "$INS_DIR\Manager\opt\FJSVssmgr\lib\sample\vsc\VscCommitScript.bat.sample" contains samples of commit scripts.

Information

  • $INS_DIR means "Program Directory" specified at the Manager installation.

  • $ENV_DIR means "Environment Directory" specified at the Manager installation.

  • $TMP_DIR means "Work Directory" specified at the Manager installation.

Commit script sample

@echo off
rem #
rem # All Rights Reserved, Copyright (c) Fujitsu Ltd. 2006-2009
rem #
rem # Storage Software Virtual Storage Conductor
rem #
rem # CommitScript Sample
rem #
rem ########################################################
setlocal

set VARDIR=$TMP_DIR\Manager
if not exist "%VARDIR%" goto fail
set CURRENT_DIR=%VARDIR%\var\opt\FJSVssmgr\current
set BKUP_DIR=vsclog\VSCCOMPOSE_BAK
set COMPOSE_DIR=vsccompose

set /a listflag=0
set /a delflag=0
set /a copyflag=0

cd "%CURRENT_DIR%"

:: backup check
if not exist "%BKUP_DIR%" mkdir "%BKUP_DIR%"
if errorlevel 1 goto fail

if not exist "%BKUP_DIR%\*.repository" goto allbackup

:: commitlist check
set COMMITLIST_DIR=commitlist
set INSERT_UPDATE_FILE=%COMMITLIST_DIR%\addlist.vsc
set DELETE_FILE=%COMMITLIST_DIR%\deletelist.vsc

if not exist "%COMMITLIST_DIR%" goto allbackup
if not exist "%COMMITLIST_DIR%\*.vsc" goto allbackup

if exist "%INSERT_UPDATE_FILE%" (for %%F in ( %INSERT_UPDATE_FILE% ) do if not %%~zF==0 set /a listflag =  1 && set /a copyflag = 1)
if exist "%DELETE_FILE%" (for %%F in ( %DELETE_FILE% ) do if not %%~zF==0 set /a listflag = 1 && set /a delflag = 1)

if %listflag% == 0 (goto allbackup) else goto diffbackup

:allbackup
if exist "%BKUP_DIR%\*.repository" del "%BKUP_DIR%\*.repository"
copy /y "%COMPOSE_DIR%\*.repository" "%BKUP_DIR%" > nul
if errorlevel 1 goto fail
if errorlevel 0 goto success

:diffbackup
if %delflag% == 1 (for /f "tokens=* delims=" %%F in ( %DELETE_FILE% ) do ((del "%BKUP_DIR%\%%F") & (if exist "%BKUP_DIR%\%%F" goto allbackup)))
if %copyflag% == 1 (for /f "tokens=* delims=" %%F in ( %INSERT_UPDATE_FILE%  ) do ((copy /y "%COMPOSE_DIR%\%%F" "%BKUP_DIR%" > nul) & (if errorlevel 1 goto allbackup)))

:success
if exist "%INSERT_UPDATE_FILE%" (del "%INSERT_UPDATE_FILE%")
if exist "%DELETE_FILE%" (del "%DELETE_FILE%")
echo "Backup Complete."
exit 0

:fail
echo "Backup failed."
exit 1

Notes

Precautions on use