15.5.1 Creation

The XML definition for network resources is shown below.

<?xml version="1.0" encoding="utf-8"?>
<Pool name="Resource Pool Name">
<Network name="Network resource name" label="label" auto="Automatic configuration">
  <Type>"Network Resource Type"</Type>
  <Comment>Comment</Comment>
  <Vlanid>VLAN ID</Vlanid>
  <PhysicalLANSegment>Physical LAN Segment Name</PhysicalLANSegment>
  <ExternalPorts vlanautosetting="Automatic VLAN configuration for external connection port">
    <NetworkSwitchPort number="LAN switch blade external port number" switch="LAN switch blade name"/>
    <NetworkSwitchPort name="External port name of the fabric type network device resource" switch="Name of the fabric type network device resource"/>
    <NetworkSwitchPort lag="Link Aggregation Group Name" switch="LAN Switch Blade Name"/>
  </ExternalPorts>
  <AddressSet name="Address set name" subnet="subnet address" mask="subnet mask">
    <Exclude>
      <AddressRange start="IP address range to exclude (Start IP address #1)" end="IP address range to exclude (End IP address #1)" />
      <AddressRange start="IP Address Range to Exclude (Start IP Address #2)" end="IP Address Range to Exclude (End IP Address #2)" />
    </Exclude>
    <DefaultGateway address="Default Gateway"/>
  </AddressSet>
  <SwitchConfiguration auto="Auto-Configuration">
    <Ruleset name="Ruleset Name"/>
  </SwitchConfiguration>
</Network>
</Pool>

The XXX.XXX.XXX.XXX format (period (".") -decimal notation) is used for the IP address, subnet address, and subnet mask.
The AddressSet tag is optional. If it is omitted, a network resource that cannot be assigned an address is created.

Table 15.11 List of Items Specified in XML Definitions for Network Resources
Element Name	Description	Remarks (Possible Values, Examples)
Resource pool name (Pool name)	Name of the resource pool to store the network resource	Specify a character string beginning with an alphanumeric character and containing up to 32 alphanumeric characters, underscores ("_"), and hyphens ("-").
Network resource name (Network name)	Name of the network resource	Specify a character string beginning with an alphanumeric character and containing up to 32 alphanumeric characters, underscores ("_"), and hyphens ("-").
Label (Network label)	Network resource label (optional)	Specify a character string of up to 32 alphanumeric characters or symbols.
Automatic configuration (Network auto)	Automatic configuration for network resources	Specify whether automatic configuration for virtual networks, virtual switches, or port groups, which are associated with the network resource, is to be performed. true If there are no virtual networks, virtual switches, or port groups associated with the network resource, the network is configured automatically. false Automatic configuration of networks is not performed. The virtual networks, virtual switches, or port groups created beforehand are used for the network resource. If left blank, "true" is set.
Network resource type (Type)	Network resource type	Specify the type of the network resource. For an admin LAN Specify "admin". Subnet information for admin LANs can be set using the AddressSet tag. For iSCSI boot Specify "iSCSI". For a public LAN Specify "<Type/>" (an empty element), or omit the Type element. If omitted, a public LAN is specified.
Admin LAN Subnet Name (ManagementLanSubnet name)	Admin LAN subnet name (optional)	This can be specified when the network resource type is an admin LAN. When a network resource is created using a registered admin LAN subnet, specify the admin LAN subnet name instead of the AddressSet element. Either use a character string beginning with an alphanumeric character and containing up to 32 alphanumeric characters and hyphens ("-"), or leave the field blank. If left blank, the admin LAN subnet directly connected from the manager is specified.
Comment (Comment)	Network resource comment (optional)	Specify a character string of up to 256 alphanumeric characters or symbols.
VLAN ID (Vlanid)	VLAN ID	Specify an integer between 1 and 4094.
Physical LAN segment name (PhysicalLANSegment)	Physical LAN segment name (optional)	Specify a physical LAN segment name. When using the NIC configuration specified in the server NIC definition, specify the physical LAN segment name specified in that server NIC definition.
External Connection Port Number (ExternalPorts)	A collection of LAN switch blade external connection port numbers (optional)	Specify one or more NetworkSwitchPort elements.
Automatic VLAN configuration for external connection ports (ExternalPorts vlanautosetting)	Specify whether to automatically perform VLAN setting for external connection ports. (optional)	Specify whether to automatically configure the VLAN of the external connection ports of the LAN switch blades or "Fabric" type network device resources. true Automatically configures the VLAN of the external connection ports of the LAN switch blades or "Fabric" type network device resources. false VLAN setting for external connection ports of a LAN switch blade is not automatically performed. If left blank, "false" is set.
Physical port number of LAN switch blade external connection port (NetworkSwitchPort number)	Physical port number of LAN switch blade external connection port for external communications A member port from a link aggregation cannot be specified as an external port for the LAN switch blade.	Specify a positive integer.
The port name of the external connection port of the Ethernet Fabric switch (NetworkSwitchPort name)	Physical port number of the external connection port of the Ethernet fabric switch used for external communication	Specify the port name.
Link aggregation port name of the external port of the LAN switch blade (NetworkSwitchPort lag)	Link aggregation group name of the external port of the LAN switch blade used for external communications When specifying the link aggregation group name of the external port of the LAN switch blade, there must be at least one member port.	Specify the link aggregation group name that was set up beforehand (e.g., linkaggregation1). Specify the link aggregation group name that is displayed in the [Resource Details] of the LAN switch blade on the ROR console.
The name of the LAN switch blade or "Fabric" type network device resource (NetworkSwitchPort switch)	The name of the LAN switch blade or "Fabric" type network device resource with external connection ports	-
Address set name (AddressSet name)	Name of the address set	Specify a character string beginning with an alphanumeric character and containing up to 32 alphanumeric characters, underscores ("_"), periods ("."), and hyphens ("-").
Subnet address (AddressSet subnet)	Subnet	Specify a subnet value.
Subnet mask (AddressSet mask)	Subnet mask	Specify a subnet mask value. The maximum value for a subnet mask is 255.255.255.255 (32-bit mask) and the minimum value is 255.255.0.0 (16-bit mask). However, 255.255.255.254 cannot be specified.
IP address to exclude (Exclude)	A collection of exclusion ranges of IP addresses (optional)	Specify one or more AddressRange elements.
IP address exclusion range (Start IP address, End IP address) (AddressRange)	IP address range (start and end) to exclude from the administration of Resource Orchestrator Start and end IP addresses are included in the exclusion range. Multiple ranges can be specified.	Specify start and end IP addresses. As the network address and broadcast address are automatically excluded, do not specify them in the IP address range (start and end) to exclude.
IP address exclusion range (Start IP address) (AddressRange start)	Starting point of exclusion range of IP addresses	Specify the IP address in IPv4 format.
IP address exclusion range (End IP address) (AddressRange end)	Endpoint of exclusion range of IP addresses	Specify the IP address in IPv4 format.
Default gateway (DefaultGateway address)	Default gateway	Specify the IP address.
Auto-configuration (SwitchConfiguration auto)	Enabling or disabling auto-Configuration for network devices	Specify whether to enable auto-Configuration. true Auto-configuration is enabled. false Auto-configuration is disabled.
Ruleset name (Ruleset name)	Name of the ruleset (This can be omitted, when "false" is set for Auto-Configuration)	Specify a character string up to 32 characters.

The created network resource varies depending on the values specified for External connection port number (ExternalPorts) and Automatic VLAN configuration for external connection port (ExternalPorts vlanautosetting).

Table 15.12 Network Resource Creation with the Values of ExternalPorts and vlanautosetting
No.	ExternalPorts Element	vlanautosetting Attribute Value	Number of External Connection Ports	Created Network Resources
1	None	Not specified	-	Internal networks
2	Specified	false or not specified	0	Internal networks
3	Specified	false or not specified	One or more	External networks
4	Specified	true	0	Internal networks (*)
5	Specified	true	One or more	External networks (*)

* Note: For network resource modification, when an external connection port is added, a tagged VLAN is automatically set to the external connection port.

Note

When specifying a subnet address and not specifying IP addresses for exclusion or a default gateway address, do not specify the end tag for the <AddressSet> tag.

Example

Do not specify an end tag as shown below.

<Pool name="NetworkPool">
  <Network name="sample">
     <Vlanid>10</Vlanid>
     <AddressSet name="sample" subnet="192.168.1.0" mask="255.255.255.0">
     </AddressSet>
  </Network>
</Pool>

Specify an empty element tag instead of the end tag.

<Pool name="NetworkPool">
  <Network name="sample">
     <Vlanid>10</Vlanid>
     <AddressSet name="sample" subnet="192.168.1.0" mask="255.255.255.0"/>
  </Network>
</Pool>

When specifying the <ExternalPorts> element, and not specifying the external port number or name of a LAN switch blade, do not specify the end tag of the <ExternalPorts> element. Specify an empty element tag instead of the end tag.

Example

<?xml version="1.0" encoding="utf-8"?>
<Pool name="NetworkPool">
<Network name="man_net" label="man_net_label">
    <Comment>comment</Comment>
  <Vlanid>4000</Vlanid>
  <PhysicalLANSegment>segmentA</PhysicalLANSegment>
  <ExternalPorts vlanautosetting="true">
    <NetworkSwitchPort number="11" switch="bx620-lan1"/>
    <NetworkSwitchPort number="12" switch="bx620-lan2"/>
    <NetworkSwitchPort lag="linkaggregation1" switch="bx900-lan1"/>
    <NetworkSwitchPort lag="linkaggregation2" switch="bx900-lan2"/>
  </ExternalPorts>
  <AddressSet name="192.168.99.0" subnet="192.168.99.0" mask="255.255.255.0">
    <Exclude>
      <AddressRange start="192.168.99.10" end="192.168.99.20" />
      <AddressRange start="192.168.99.30" end="192.168.99.40" />
    </Exclude>
    <DefaultGateway address="192.168.99.254"/>
  </AddressSet>
  <SwitchConfiguration auto="true">
    <Ruleset name="Ruleset1"/>
  </SwitchConfiguration>
</Network>
</Pool>