This section describes the environmental settings required for each admin server.
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:
/etc/hosts
/etc/services
/etc/hosts file
Register the host name and IP address of Ethernet port for virtualization control of a virtualization switch in the /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 control specified for the virtualization switch.
Example
Example of coding in the /etc/hosts file
The following shows an example of coding in the /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
/etc/services file
In the /etc/services file, register a service name and a port number.
Register the following two services:
Service name | Port number | protocol |
|---|---|---|
ssvscme | 7420 | tcp |
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 /etc/services file
The following shows an example of coding in the /etc/services file.
ssvscme 7420/tcp # VSC Manager - VSC Engine(TCP) ssvscme 7420/udp # VSC Manager - VSC Engine(UDP)
Note that "/etc/opt/FJSVssmgr/current/FJSVssvsc.ini" is the configuration data file.
Also note that "/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:
Enter one item per line. You cannot enter one item extending beyond one line or place more than one item on a line.
A line that begins with "#" in the first column is handled as a comment line.
Do not insert any character (such as a blank) between an item name and "=", or between "=" and a setting value.
Configuration items
The following table indicates the configuration item in a configuration data file.
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 |
Specify the error type of messages to be output.
Messages are output via syslogd(1M). Therefore, the settings in /etc/syslog.conf determine whether messages are actually output and to what file messages are output. For information on how to make settings in /etc/syslog.conf, see syslog.conf(4).
If this item is omitted, messages with error type "ERR" are output.
LOG_LEVEL={1 | 2 | 3 | 4}
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".
Specifies the number of generations retained in the copy history log file.
The default number of generations is 2.
COPY_HISTORY_ROTATE_NUMBER={2|3|4|5}
Specify a value ranging from 2 to 5.
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 "/etc/opt/FJSVssmgr/current/VscCommitScript" and give it an execution right.
Note that "/opt/FJSVssmgr/lib/sample/vsc/VscCommitScript.sample" contains samples of commit scripts.
Commit script sample
#!/bin/sh
#
# All Rights Reserved, Copyright (c) Fujitsu Ltd. 2004
#
# Storage Software Virtual Storage Conductor
#
# CommitScript Sample
#
########################################################
CURRENT_DIR=/var/opt/FJSVssmgr/current
BKUP_DIR=/var/opt/FJSVssmgr/current/vsclog/VSCCOMPOSE_BAK
COMPOSE_DIR=vsccompose
if [ ! -d $BKUP_DIR ]; then
mkdir -p $BKUP_DIR
fi
if [ $? -eq 0 ]; then
cd $CURRENT_DIR
tar cf $BKUP_DIR/compose.BAK.tar ./$COMPOSE_DIR
if [ $? -eq 0 ]; then
echo "Backup Complete."
exit 0
fi
fi
echo "Backup failed."
exit 1Notes
The configuration information of VSC Manager is stored in the "/var/opt/FJSVssmgr/current/vsccompose/" directory. Backup all directories and files in this directory. When you restore the configuration information, restore directories and files in the same configuration as when backed up.
Note that a commit script may cause a delay in the processing time of VSC Manager depending on its coding, because the script always starts up whenever the resource status of virtual storage changes.
Do not change the coding in "/opt/FJSVssmgr/lib/sample/vsc/VscCommitScript.sample".
Precautions on use
If you do not make a commit script, message "ssvsc0906" is output and no commit script is executed. Therefore, no backup or copy of the virtual storage configuration information is created. Moreover, the virtual storage configuration information cannot be restored if lost for some reason.
If a commit script terminates abnormally for some reason, message "ssvsc0905", "ssvsc0907", or "ssvsc0908" is output. Take action as instructed by these messages and re-execute the commit script.