Creating a new IP interface
Use the ipinterface_create command to create a new IP interface for iSCSI.
ipinterface_create ipinterface=IPInterfaceName address=Address netmask=NetworkMask
[ gateway=DefaultGateway ] [ mtu=MTU ] module=ModuleNumber ports=<P1,...>
[ speed=<auto|10mb|100mb|1000mb|1gb|2500mb|2.5gb|10000mb|10gb> ]
Parameters
| Name | Type | Description | Mandatory | Default |
|---|---|---|---|---|
|
ipinterfac
e |
Object name | Name of the IP interface to be created. Do not use the names Management or VPN.
|
Y | N/A |
| address | N/A | IP address of the interface. | Y | N/A |
| netmask | N/A | Network mask of the interface. | Y | N/A |
| gateway | N/A | IP address of the default gateway for this interface. This is optional. | N | None |
| mtu | Integer | Maximum Transmission Unit: The supported packet size by the connecting Ethernet switch. This is optional when the default equals 1536. MTU of up to 4500 is supported. |
N | 4500 for iSCSI and 1536 for Management and VPN. |
| module | N/A | Component identifier (rack and module) of the module containing the Ethernet ports. | Y | N/A |
| ports | Integer | Comma-separated list (one or more) of port numbers. | Y | N/A |
| speed | Enumeration | Interface speed, either automatic or an explicit speed. An explicit speed will turn off auto-negotiation. | N | auto |
This command defines a new IP interface for iSCSI traffic. Gateway, MTU, network mask and IP are the standard IP definitions.
The IP interface is defined on a port group, where a port group is one or more ports (all on the same module) that are linked together as an 802.3ad link aggregation group.
Each iSCSI Ethernet port can be defined as an IP interface, or groups of Ethernet iSCSI ports on the same module can be defined as a single link aggregation group. Ports defined as a link aggregation must be connected to the same Ethernet switch, and the parallel link aggregation must be defined on that switch.
Access control
| User Category | Permission |
|---|---|
| Storage administrator | Allowed |
| Application administrator | Disallowed |
| Security administrator | Disallowed |
| Read-only users | Disallowed |
| Operations administrator | Allowed |
| Host side accelerator client | Disallowed |
Return codes
- IPINTERFACE_EXISTS
IP interface name already used.
- ILLEGAL_PORT_NUMBER
Port number is out of range.
- PORT_IS_USED_IN_ANOTHER_IP_INTERFACE
One of the physical ports specified is already assigned to an IP interface.
- PORT_REPEATS_TWICE
Port list contains the same value more than once.
- FORCE_NO_AGGREGATION_ALLOWED_FOR_SINGLE_PORT_ONLY
More than one port specified for non-aggregated IP interface.
- IP_ADDRESS_ALREADY_USED_IN_ANOTHER_INTERFACE
IP address is already assigned to another interface.
- IPADDRESS_AND_GATEWAY_ARE_NOT_ON_SAME_SUBNET
IP address specified for the default gateway is not in the subnet of the IP interface.
- MTU_TOO_LARGE
Specified MTU value is too large.
- MTU_TOO_SMALL
Specified MTU value is too small
- BAD_PORTS_FORMAT
Port list should be a comma separated list of positive integers.
- ILLEGAL_COMPONENT_ID
Component ID is illegal.
- TOO_MANY_PORTS_IN_AGGREGATION_GROUP
Too many physical ports for one IP interface.
- ILLEGAL_IPADDRESS
Illegal IP address was entered.
- DUPLICATE_IPADDRESSES
Duplicate IP addresses were specified.
- ILLEGAL_GATEWAY_IPADDRESS
Illegal IP address was specified for default gateway.