system service-processor network modify
Modify the network configuration
Availability: This command is available to cluster administrators at the admin privilege level.
Description
The system service-processor network modify
command modifies the network configuration of the Service Processor of specified node or nodes in a cluster.
If the SP automatic network configuration has been enabled, the system service-processor network modify
command allows you to only enable or disable the SP IPv4 or Ipv6 network interface.
Parameters
-node {<nodename>|local}
- Node-
This parameter specifies the node whose Service Processor's network configuration is to be modified.
-address-family {IPv4|IPv6}
- Address Family-
This parameter specifies whether the IPv4 or the IPv6 configuration is to be modified.
[-enable {true|false}]
- Interface Enabled-
This parameter enables or disables the underlying network interface for the specified
address-family
. This is a mandatory parameter. [-dhcp {v4|none|v6}]
- DHCP Status-
If this parameter is set to v4, the Service Processor uses network configuration from the DHCP server. Otherwise, the Service Processor uses the network address you specify. If this parameter is not set to v4 or is not specified, you must specify the IP address, netmask, prefix-length, and gateway in the command. DHCP is not supported for IPv6 configuration.
[-ip-address <IP Address>]
- IP Address-
This parameter specifies the public IP address for the Service Processor. You must specify this parameter when the
–dhcp
parameter is not set to v4. - {
[-netmask <IP Address>]
- Netmask -
This parameter specifies the netmask for a Service Processor that uses an IPv4 address. This parameter has no effect if the IP address family is set to IPv6. You must specify this parameter when DHCP is not v4 and the address family is IPv4.
- |
[-prefix-length <integer>]
- Prefix Length of Subnet Mask } -
This parameter specifies the network prefix-length of the Service Processor if the address family is set to IPv6. The parameter has no effect when the address family is set to IPv4. You must specify this parameter when DHCP is not set to v4 and when the address family is set to IPv6.
[-gateway <IP Address>]
- Gateway IP Address-
This parameter specifies network gateway of the Service Processor. You must specify this parameter when DHCP is not set to v4.
Examples
The following example enables the network interface for IPv4 on the Service Processor of the local node. It first displays the current network configuration information of the local node to show the network interface is initially disabled, and then enables it with IP address 192.168.1.202, netmask as 255.255.255.0 and gateway as 192.168.1.1. It displays the interim state with SP Network Setup Status field showing "in-progress". It finally displays the network configuration again to confirm the specified values took effect.
cluster1::> system service-processor network show -instance -node local Node: node2 Address Family: IPv4 Interface Enabled: false Type of Device: SP Status: online Link Status: disabled DHCP Status: - IP Address: - MAC Address: ab:cd:ef:fe:ed:02 Netmask: - Prefix Length of Subnet Mask: - Router Assigned IP Address: - Link Local IP Address: - Gateway IP Address: - Time Last Updated: Fri Jun 13 16:29:55 GMT 2014 Subnet Name: - Enable IPv6 Router Assigned Address: - SP Network Setup Status: succeeded SP Network Setup Failure Reason: - Node: node2 Address Family: IPv6 Interface Enabled: false Type of Device: SP Status: online Link Status: disabled DHCP Status: none IP Address: - MAC Address: ab:cd:ef:fe:ed:02 Netmask: - Prefix Length of Subnet Mask: - Router Assigned IP Address: - Link Local IP Address: - Gateway IP Address: - Time Last Updated: Fri Jun 13 16:29:55 GMT 2014 Subnet Name: - Enable IPv6 Router Assigned Address: - SP Network Setup Status: not-setup SP Network Setup Failure Reason: - 2 entries were displayed. cluster1::>
cluster1::> system service-processor network modify -node local -address-family IPv4 -enable true -ip-address 192.168.1.202 -netmask 255.255.255.0 -gateway 192.168.1.1
cluster1::> cluster1::> system service-processor network show -instance -node local Node: node2 Address Family: IPv4 Interface Enabled: false Type of Device: SP Status: online Link Status: disabled DHCP Status: - IP Address: - MAC Address: ab:cd:ef:fe:ed:02 Netmask: - Prefix Length of Subnet Mask: - Router Assigned IP Address: - Link Local IP Address: - Gateway IP Address: - Time Last Updated: Fri Jun 13 16:29:55 GMT 2014 Subnet Name: - Enable IPv6 Router Assigned Address: - SP Network Setup Status: in-progress SP Network Setup Failure Reason: - Node: node2 Address Family: IPv6 Interface Enabled: false Type of Device: SP Status: online Link Status: disabled DHCP Status: none IP Address: - MAC Address: ab:cd:ef:fe:ed:02 cluster1::> system service-processor network show -instance -node local Node: node2 Address Family: IPv4 Interface Enabled: true Type of Device: SP Status: online Link Status: up DHCP Status: none IP Address: 192.168.1.202 MAC Address: ab:cd:ef:fe:ed:02 Netmask: 255.255.255.0 Prefix Length of Subnet Mask: - Router Assigned IP Address: - Link Local IP Address: - Gateway IP Address: 192.168.1.1 Time Last Updated: Fri Jun 13 16:29:55 GMT 2014 Subnet Name: - Enable IPv6 Router Assigned Address: - SP Network Setup Status: succeeded SP Network Setup Failure Reason: - Node: node2 Address Family: IPv6 Interface Enabled: false Type of Device: SP Status: online Link Status: disabled DHCP Status: none IP Address: - MAC Address: ab:cd:ef:fe:ed:02 Netmask: - Prefix Length of Subnet Mask: - Router Assigned IP Address: - Link Local IP Address: - Gateway IP Address: - Time Last Updated: Fri Jun 13 16:29:55 GMT 2014 Subnet Name: - Enable IPv6 Router Assigned Address: - SP Network Setup Status: not-setup SP Network Setup Failure Reason: - 2 entries were displayed. cluster1::>