D.2 File Format

The system configuration files (CSV format) used for pre-configuration are comma (",") delimited.
The format of each line is given below:

File format definition
The first line of the file must begin with the following:
RCXCSV,V3.0
Note
Refer to the "Systemwalker Resource Coordinator Virtual server Edition V13.2.0 Setup Guide" for details on RCXCSV V1.0 system configuration files, and to the "Systemwalker Resource Coordinator Virtual server Edition V13.3.0 Setup Guide" for details on RCXCSV V2.0 system configuration files. Although RCXCSV1.0, RCXCSV V2.0 and RCXCSV3.0 have different formats, those formats are retro-compatible (the RCXCSV V3.0 and RCXCSV V2.0 formats include all the information defined by the RCXCSV V1.0 format).
As detailed below, some sections (described in "D.3 Resource Definitions") are only available with the latest format(s).
- RCXCSV V2.0 and later
  "LanSwitchNet", "ServerAgent", "ServerVMHost", "PowerDevice", "Memo"
- RCXCSV V3.0
  "VManager"
Comments
The following lines are assumed to be comments and are skipped:
- Lines that begin with the symbol ("#")
  Example
  #Development environment definition
- Lines that consist of only blank spaces (" "), tab characters or linefeed code
- Lines that contain only commas (",")
- Unrecognized resource definition
Resource definitions
Create the resource definition using the following format. Describe the same type of resource in the same section. Optional section can be omitted.
- Resource definition format
  [Section name]
  Section header
  Operation column, Parameter [,parameter]...
- Section name
  This describes the resource type.
- Section header
  This describes the parameter type unique to the resource.
  Note
  Do not enter any comments between the section name and section header.
- Operation Column
  This describes the operation type for the resource. The following characters can be used in the operation column.
  "new": registration
  "change": change
  "-": do nothing
- Parameter
  This describes the parameter value to be set.
  Note
  The order of operation and parameter columns should follow the order defined in "Section header" under "D.3 Resource Definitions".

Allowed Characters

Refer to "D.3 Resource Definitions" for details on the characters allowed for each resource definition. Optional parameters can be omitted by using hyphens ("-").
However, hyphens ("-") are seen as valid characters for user names, passwords and SNMP communities. Note that if extra commas (",") are added to the end of a line, those will be simply ignored without errors.

Backslashes ("\") and double quotations ( " ) will be displayed differently in the RC console from how they appear in the system configuration file.
Refer to the following table for details on such differences.

Table D.1 Differences between system configuration files' contents and display in the RC console
Content of a system configuration file (CSV)	Display in the RC console
\\	\
\n	Line break
""	"
, (*1)	,

*1: The whole value must be enclosed by double quotations ( " ).

Example

CSV content
"a\nb,\\n"
Display in the RC console
a
b,\n

Order of section definition

Section order, section name and omission possible or not possible are shown below.
The section indicated as "Required" must be described in the system configuration file. Moreover, the section definition order is fixed.

Table D.2 Section order
Order	Section name	Required/Optional
1	Chassis	Optional
2	LanSwitch	Optional
3	LanSwitchNet	Optional
4	Server	Required
5	ServerNet	Optional
6	ServerWWNN (*1)	Optional
7	SpareServer (*1)	Optional
8	VMManager	Optional
9	ServerAgent (2, 3)	Optional
10	ServerVMHost (2, 3)	Optional
11	PowerDevice	Optional
12	Memo (*2)	Optional

*1: When loading from the system configuration template in the Excel format, the operation column information will be skipped.
*2: When loading from the system configuration template in the Excel format, the whole section will be skipped.
*3: Do not enter the information of the same physical server both in the "ServerAgent" and "ServerVMHost" section.

System backup information is automatically added to the end of the system configuration file when exporting in the CSV format. The sections after the line below contain the backup information. The backup information is skipped when loading from the system configuration template in the Excel format.

#Do not edit the following information, which is used to recover the manager.

Do not modify the backup information, as it is automatically created. Note that these sections do not have to be defined if the system configuration file is created for new system configuration.

Note

Importing a system configuration file in a format older than "RCXCSV,V3.0" and exporting it again will produce a file in "RCXCSV,V3.0" format.
If a system configuration file (CSV format) is imported and then exported, the line order after export may differ from the line order before import. The following information will also be deleted:
- Comments lines
- Strings enclosed in brackets "( )" indicating omitted values
- Extra commas at the end of lines (",")