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 port=PortNumber
[ speed=<auto|10mb|100mb|1000mb|1gb|2500mb|2.5gb|10000mb|10gb> ]Parameters
| Name | Type | Description | Mandatory | Default |
|---|---|---|---|---|
| ipinterface | Object name | The 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 parameter 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 Ethernet ports. | Y | N/A |
| port | Integer | Port Number | Y | N/A |
| speed | Enumeration | Interface's speed, either automatic or explicit. An explicit speed turns 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.
Each iSCSI Ethernet port can be defined as an IP interface.
Access control
| User Category | Permission |
|---|---|
| Storage administrator | Allowed |
| Storage integration administrator | Disallowed |
| Application administrator | Disallowed |
| Security administrator | Disallowed |
| Read-only users | Disallowed |
| Technicians | Allowed |
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
- 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