Skip to main content
A newer release of this product is available.

system service-processor network modify

Contributors
Suggest changes
PDFs

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}] - 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::>