Manual Pages


Table of Contents

NAME

na_system_node_service_processor - Manages the service processor

SYNOPSIS

system node service-processor show
{[-fields <field name>, ...] | [-instance]} [-node <node-name>]
[-type {RLM|SP}]
[-status {online|offline}]
[-ip-configured {true|false}]
[-address <IP address>]
[-mac <MAC address>]
[-fw-version <firmware-version>]
[-part-num <part-number>]
[-serial-num <serial-number>]
[-ipmi-ver <ipmi-version>]
[-dev-rev <device-revision>]
[-autoupdate-enabled {true|false}]
[-new-fw-available {true|false}]
[-new-fw-version <firmware version number>]

system node service-processor reboot-sp
[-node <node-name>]
[-image {primary|backup}]

system node service-processor image show {[-fields <field name>, ...] | [-instance]} [-node <node-name>]
[-type {RLM|SP}]
[-image {primary|backup}]
[-status {online|offline}]
[-is-current {true|false}]
[-running-version <firmware version>] [-autoupdate {true|false}]
[-last-update-status {online|offline}]

system node service-processor image modify [-node <node-name>]
[-autoupdate {true|false}]

system node service-processor image update [-node <node-name>]
[-package <package location>]
[-baseline {true|false}]
[-update-type {full|differential}]
[-clear-logs {true|false}]

system node service-processor image update-progress show {[-fields <field name>, ...] | [-instance]} [-node <node-name>]
[-start-time <update start time>]
[-end-time <update end time>]
[-percent-done <update completion percentage>] [-in-progress {yes|no}]

system node service-processor network show {[-fields <field name>, ...] | [-instance]} [-node <node-name>]
[-address-type {IPv4|IPv6}]
[-enable {true|false}]
[-type {RLM|SP}]
[-status {online|offline}]
[-link-status {up|down|disabled|unknown}] [-dhcp {v4|none}]
[-ip-address <IP address>]
[-mac <MAC address>]
[-netmask <netmask>]
[-prefix-length <mask prefix length>] [-router-ip <IP address>]
[-link-local-ip <IP address>]
[-gateway <IP address>]

system node service-processor network modify [-node <node-name>]
[-address-type {IPv4|IPv6}]
[-enable {true|false}]
[-dhcp {v4|none}]
[-ip-address <IP address>]
[-netmask <netmask>]

DESCRIPTION

The system node service-processor commands configure, modify and display information about the Service Processor in a node.

The show command displays information about the Service Processor.
The reboot-sp command reboots the Service Processor. The image show command displays information about the currently installed firmware images on the Service Processor.
The image modify command enables or disables automatic firmware update on the Service Processor. The image update command installs a new firmware version on the Service Processor.
The image update-progress show command displays the progress information of the firmware updates on the Service Processor.

The network show command displays the network configuration of the Service Processor. The network modify command modifies the network configuration of the Service Processor.

USAGE

system node service processor show

This command displays information about the Service Processor. The output can be limited to specific types of information or filter the result by specific field values. This command currently does not support the Remote LAN Module (RLM) completely. If the command is run on nodes that use RLM, the command output displays the device type as "RLM" and all the other fields as "-". This command supports the following options:

[-fields <field name>, ...] allows the user to limit the output by providing a list of field names. The output will only contain those fields. Cannot be used along with -instance option.

[-instance] displays detailed information about all fields. Cannot be used along with -fields option.

[-node <node-name>] accepts either "local" or the hostname of the current node as a value.

[-type {RLM|SP}] displays information only if the Service Processor is of the specified type. If the type provided is "RLM", the command output displays the device type as "RLM" and all the other fields as "-".

[-status {online|offline}] displays information only if the Service Processor whose status matches the specified value.

[-ip-configured {true|false}] displays information only if the Service Processor network is configured ("true") or network is not configured ("false").

[-address <IP address>] displays information only if the Service Processor uses the specified IP address or addresses.

[-mac <MAC address>] displays information only if the Service Processor uses the specified MAC address.

[-fw-version <firmware-version>] displays information only if the Service Processor is running the specified firmware version.

[-part-num <part-number>] displays information only if the Service Processor has the specified part number.

[-serial-num <serial-number>] displays information only if the Service Processor has the specified serial number.

[-ipmi-ver <ipmi-version>] displays information only if the Service Processor has the specified Intelligent Platform Management Interface version.

[-dev-rev <device-revision>] displays information only if the Service Processor has the specified revision number.

[-autoupdate-enabled {true|false}] displays information only if the Service Processor has the specified status for automatic firmware update.

[-new-fw-available {true|false}] displays information only if the Service Processor has the specified status for new firmware availability.

[-new-fw-version <firmware version number>] displays information only if the new firmware version of the Service Processor matches the specified value.

system node service-processor reboot-sp

This command reboots the Service Processor of the current node. This command does not support the Remote LAN Module (RLM). This command supports the following commands :

[-node <node-name>] accepts either "local" or the hostname of the current node as a value.

[-image {primary|backup}] specifies the image type to be used for booting after the Service Processor reboots.

system node service-processor image show

This command displays information about the currently installed firmware images on the Service Processor of the current node. The output can be limited to specific types of information or filter the result by specific field values.This command currently does not support the Remote LAN Module (RLM) completely. If the command is run on nodes that use RLM, the command output displays the device type as "RLM" and all the other fields as "-". This command supports the following options:

[-fields <field name>, ...] allows the user to limit the output by providing a list of field names. The output will only contain those fields. Cannot be used along with -instance option.

[-instance] displays detailed information about all fields. Cannot be used along with -fields option.

[-node <node-name>] takes either "local" or the hostname of the current node as values.

[-type {RLM|SP}] displays information only if the Service Processor is of the specified type. If the type provided is "RLM", the command output displays the device type as "RLM" and all the other fields as "-".

[-status {online|offline}] displays information only if the Service Processor whose status matches the specified value.

[-is-current {true|false}] displays information only if the Service Processor current image matches the specified status.

[-running-version <firmware version>] displays information only if the Service Processor is running the specified firmware version.

[-autoupdate {true|false}] displays information only if the automatic firmware status of the Service Processor matches the specified status.

[-last-update-status {online|offline}] displays information only if the last status update of the Service Processor is of the specified value.

system node service-processor image modify

This command enables or disables automatic firmware updates on the Service Processor. This command currently does not support the Remote LAN Module (RLM). This command supports the following options:

[-node <node-name>] accepts either "local" or the hostname of the current node as a value.

[-autoupdate {true|false}] displays information only if the automatic firmware status of the Service Processor matches the specified status.

system node service-processor image update

This command installs a new firmware version on the Service Processor of the current node. This command also allows the user to specify which firmware to install and how. The command system node serviceprocessor image update-status show can be used to track the progress of the update. This command does not currently support Remote LAN Module (RLM). This command supports the following options:

[-node <node-name>] accepts either "local" or the hostname of the current node as a value.

[-package <package name>] specifies the package to be installed. The package file can be found in the SP Update Repository field of the system node service-processor image show command. If this parameter is not specified, the Service Processor is updated to the most recent version of the firmware that is available in the update repository. This option must be used if -baseline option is either omitted or is specified as false.

[-baseline {true|false}] option when true, installs the Service Processor firmware version that is bundled with the currently running release of Data ONTAP. This is a safety mechanism which allows the user to revert the SP firmware to the version that was qualified and bundled with the currently running version of Data ONTAP on the current node. If this option is not used, then it reverts to the default value of false.

[-update-type {full|differential}] specifies the type of firmware update on the Service Processor. full results in the entire firmware image being updated and differential results in only the changed portions of the firmware image being updated on the Service Processor.

[-clear-logs {true|false}] option resets the log setting to factory default and clears contents of all logs maintained by the Service Processor, including event logs, IPMI logs and forensics logs (true).

system node service-processor image update-progress show

This command displays the progress information of firmware updates on the Service Processor. The "InProgress" field displays no if no update is in progress. This command does not currently support Remote LAN Module (RLM) completely. If this command is run on a node that uses RLM, the output will always display no for the "In-Progress" field. This command supports the following options:

[-fields <field name>, ...] allows the user to limit the output by providing a list of field names. The output will only contain those fields. Cannot be used along with -instance option.

[-instance] displays detailed information about all fields. Cannot be used along with -fields option.

[-node <node-name>] accepts either "local" or the hostname of the current node as a value.

[-start-time <update start time>] displays the status of the Service Processor firmware update if the update start time matches the specified value.

[-end-time <update end time>] displays the status of the Service Processor firmware update if the update end time matches the specified value.

[-percent-done <update completion percentage>] displays the status of the Service Processor firmware update if the update completion percentage matches the specified value.

[-in-progress {yes|no}] displays the status of the Service Processor firmware update if the update status matches the specified value.

system node service-processor network show

This command displays the network configuration of the Service Processor of the current node. The output can be limited to specific types of information or filter the result by specific field values. This command currently does not support the Remote LAN Module (RLM) completely. If the command is run on nodes that use RLM, the command output displays the device type as "RLM" and all the other fields as "-". This command supports the following options:

[-fields <field name>, ...] allows the user to limit the output by providing a list of field names. The output will only contain those fields. Cannot be used along with -instance option.

[-instance] displays detailed information about all fields. Cannot be used along with -fields option.

[-node <node-name>] accepts either "local" or the hostname of the current node as a value.

[-address-type {IPv4|IPv6}] displays network configuration information only if the Service Processor has the specified IP address type.

[-enable {true|false}] displays network configuration information only if the network interface status of the Service Processor for the given address type matches the specified value.

[-type {RLM|SP}] displays information only if the Service Processor is of the specified type. If the type provided is "RLM", the command output displays the device type as "RLM" and all the other fields as "-".

[-status {online|offline}] displays network configuration information only if the status of the Service Processor matches the specified value.

[-link-status {up|down|disabled|unknown}] displays network configuration information only if the Service Processor network interface link status matches the specified value.

[-dhcp {v4|none}] displays network configuration information only if the Service Processor DHCP status matches the specified value.

[-ip-address <IP address>] displays network configuration information only if the Service Processor IP address matches the specified value.

[-mac <MAC address>] displays network configuration information only if the Service Processor MAC address matches the specified value.

[-netmask <netmask>] displays network configuration information only if the Service Processor netmask matches the specified value.

[-prefix-length <mask prefix length>] displays network configuration information only if the prefix length of the Service Processor network mask matches the specified value.

[-router-ip <IP address>] displays network configuration information only if the routerassigned IP address of the Service Processor matches the specified value.

[-link-local-ip <IP address>] displays network configuration information only if the link local IP address of the Service Processor matches the specified value.

[-gateway <IP address>] displays network configuration information only if the gateway IP address of the Service Processor matches the specified value.

system node service-processor network modify

This command modifies the network configuration of the Service Processor of the current node. This command does not currently support the Remote LAN Module (RLM).

[-node <node-name>] accepts either "local" or the hostname of the current node as a value.

[-address-type {IPv4|IPv6}] modifies the Service Processor IP address type to the specified value.

[-enable {true|false}] modifies the network interface of the Service Processor by enabling (true) or disabling (false) for the specified address type (-address-type).

[-dhcp {v4|none}] modifies the dhcp status in the network configuration of the Service Processor to the specified type.

EXAMPLES

system node service-processor show

  Node-A> system node service-processor show



                                 Node: Node-A
                       Type of Device: SP
                               Status: online
                Is Network Configured: true
                    Public IP Address: 10.238.142.96
                          MAC Address: 00:a0:98:18:df:2c
                     Firmware Version: 2.2X12
                          Part Number: Not Applicable
                        Serial Number: Not Applicable
                         IPMI Version: 2.0
                      Device Revision: Not Applicable
       Is Firmware Autoupdate Enabled: true

  Node-A> system node service-processor show -fields type,status,fw-version,ipmi-ver


  node         type status fw-version ipmi-ver
  ------------ ---- ------ ---------- --------
  Node-A       SP   online 2.2X12     2.0

system node service-processor reboot-sp

  Node-A> system node service-processor reboot-sp



  Note: If your console connection is through the SP, it will be disconnected.
        Do you want to reboot the SP ? {y|n}: y

system node service-processor image show

  Node-A> system node service-processor image show


                                             Is
  Node             Type  Image   Status      Current Version
  ---------------- ----- ------- ----------- ------- --------
  Node-A           SP
                         primary installed   true    2.2X12
                         backup  installed   false   2.1.1X1
  2 entries were displayed.

  Node-A> system node service-processor image show -instance



                 Node: Node-A
                Image: primary
                 Type: SP
         Image Status: installed
     Is Image Current: true
     Firmware Version: 2.2X12
  Firmware Autoupdate: true
   Last Update Status: passed

                 Node: Node-A
                Image: backup
                 Type: SP
         Image Status: installed
     Is Image Current: false
     Firmware Version: 2.1.1X1
  Firmware Autoupdate: true
   Last Update Status: passed
  2 entries were displayed.

system node service-processor image modify

  Node-A> system node service-processor image show -instance



                 Node: Node-A
                Image: primary
                 Type: SP
         Image Status: installed
     Is Image Current: true
     Firmware Version: 2.2X12
  Firmware Autoupdate: true
   Last Update Status: passed

                 Node: Node-A
                Image: backup
                 Type: SP
         Image Status: installed
     Is Image Current: false
     Firmware Version: 2.1.1X1
  Firmware Autoupdate: true
   Last Update Status: passed
  2 entries were displayed.

  Node-A> system node service-processor image modify -autoupdate false




  Node-A> system node service-processor image show -instance



                 Node: Node-A
                Image: primary
                 Type: SP
         Image Status: installed
     Is Image Current: true
     Firmware Version: 2.2X12
  Firmware Autoupdate: false
   Last Update Status: passed

                 Node: Node-A
                Image: backup
                 Type: SP
         Image Status: installed
     Is Image Current: false
     Firmware Version: 2.1.1X1
  Firmware Autoupdate: false
  Last Update Status: passed
  2 entries were displayed.

system node service-processor image update

  Node-A> system node service-processor image update -node local -update-type full -baseline true -clear-logs true



  Note: Firmware update will need to reboot the SP on completion. If your console
        connection is through the SP, it will be disconnected
        Do you want to proceed with the firmware update ? {y|n}: y

system node service-processor image update-progress

  Node-A> system node service-processor image update-progress show



                                       Node: Node-A
  Latest SP Firmware Update Start Timestamp: 11/19/2010 03:06:56
  Latest SP Firmware Update Percentage Done: 97
    Latest SP Firmware Update End Timestamp: -
                      Is Update in Progress: yes

system node service-processor network show

  Node-A> system node service-processor network show


                               Address
  Node          Status         Type      Link State  IP Address
  ------------- -------------- --------- ----------- ------------------------
  Node-A        online         IPv4      up          10.238.142.96

                                   DHCP: none
                            MAC Address: 00:a0:98:18:df:2c
                        Network Gateway: 10.238.142.1
               Network Mask (IPv4 only): 255.255.254.0
              Prefix Length (IPv6 only): -


  Node-A        online         IPv6      disabled    -

                                   DHCP: none
                            MAC Address: 00:a0:98:18:df:2c
                        Network Gateway: -
               Network Mask (IPv4 only): -
              Prefix Length (IPv6 only): -


  2 entries were displayed.

  Node-A> system node service-processor network show -instance



                          Node: Node-A
                  Address Type: IPv4
             Interface Enabled: true
                Type of Device: SP
                        Status: online
                   Link Status: up
                   DHCP Status: none
                    IP Address: 10.238.142.96
                   MAC Address: 00:a0:98:18:df:2c
                       Netmask: 255.255.254.0
  Prefix Length of Subnet Mask: -
    Router Assigned IP Address: -
         Link Local IP Address: -
            Gateway IP Address: 10.238.142.1

                          Node: Node-A
                  Address Type: IPv6
             Interface Enabled: false
                Type of Device: SP
                        Status: online
                   Link Status: disabled
                   DHCP Status: none
                    IP Address: -
                   MAC Address: 00:a0:98:18:df:2c
                       Netmask: -
  Prefix Length of Subnet Mask: -
    Router Assigned IP Address: -
         Link Local IP Address: -
            Gateway IP Address: -
  2 entries were displayed.

  Node-A> system node service-processor network show -address-type IPV4



                          Node: Node-A
                  Address Type: IPv4
             Interface Enabled: true
                Type of Device: SP
                        Status: online
                   Link Status: up
                   DHCP Status: none
                    IP Address: 10.238.142.96
                   MAC Address: 00:a0:98:18:df:2c
                       Netmask: 255.255.254.0
  Prefix Length of Subnet Mask: -
    Router Assigned IP Address: -
         Link Local IP Address: -
            Gateway IP Address: 10.238.142.1

system node service-processor network modify

  Node-A> system node service-processor network show -address-type IPV4



                          Node: Node-A
                  Address Type: IPv4
             Interface Enabled: true
                Type of Device: SP
                        Status: online
                   Link Status: up
                   DHCP Status: none
                    IP Address: 10.238.142.96
                   MAC Address: 00:a0:98:18:df:2c
                       Netmask: 255.255.254.0
  Prefix Length of Subnet Mask: -
    Router Assigned IP Address: -
         Link Local IP Address: -
            Gateway IP Address: 10.238.142.1

  Node-A> system node service-processor network modify -node local -address-type IPv4 -ip-address 192.168.1.202 -netmask 255.255.255.0 -gateway 192.168.1.1

  Node-A> system node service-processor network show -address-type IPV4



                          Node: Node-A
                  Address Type: IPv4
             Interface Enabled: true
                Type of Device: SP
                        Status: online
                   Link Status: up
                   DHCP Status: none
                    IP Address: 192.168.1.202
                   MAC Address: 00:a0:98:18:df:2c
                       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

SEE ALSO

na_sp(1)


Table of Contents