﻿1 SetAttributes

   setattributes enables you to change the attributes of an HP SUM node or
   session. This command might return an invalid parameter notice if the
   permissions are not correct, or if either the parameter is not part of the
   requested set or if the value is not allowed.


Node attributes:

     software, firmware, rewrite, downgrade, action, delay, message, 
     username, password, ignore_warnings, on_failed_dependency and baseline

     The following attributes are specific to Superdome 2/X nodes:

       update_type=[ALL/COMPLEX/PARTITIONS], device_list=[devicelist], and
       reboot_list=[rebootlist].

     The following attributes are Moonshot-specific ones meant for switch B
     if those credentials differ from switch A:

       switchb_username=<username>, switchb_password=<password> and
       switchb_enable=<option>


Session attributes:

   +---------------------------------------------------------------------------+
   |Attribute                   |Possible value                                |
   |----------------------------+----------------------------------------------|
   |auto_save_session           |[true|false]                                  |
   |----------------------------+----------------------------------------------|
   |auto_save_session_time      |<integer> - The time in minutes. The default  |
   |                            |is 15 minutes.                                |
   |----------------------------+----------------------------------------------|
   |engine_mode                 |[debug|release]                               |
   |----------------------------+----------------------------------------------|
   |software                    |[true|false]                                  |
   |----------------------------+----------------------------------------------|
   |firmware                    |[true|false]                                  |
   |----------------------------+----------------------------------------------|
   |rewrite                     |[true|false]                                  |
   |----------------------------+----------------------------------------------|
   |downgrade                   |[true|false]                                  |
   |----------------------------+----------------------------------------------|
   |language                    |[en|ja|cn]                                    |
   |----------------------------+----------------------------------------------|
   |reboot                      |[never|ifneeded|always]                       |
   |----------------------------+----------------------------------------------|
   |reboot_delay                |<integer> - Number of seconds HP SUM waits    |
   |                            |before rebooting, in the range of 30-3600.    |
   |----------------------------+----------------------------------------------|
   |reboot_message              |<string>  - Reboot message                    |
   |----------------------------+----------------------------------------------|
   |verbosity                   |[normal|verbose|veryverbose]                  |
   |----------------------------+----------------------------------------------|
   |use_proxy_script            |[true|false]                                  |
   |----------------------------+----------------------------------------------|
   |proxy_url                   |<string> - Proxy server URL.                  |
   |----------------------------+----------------------------------------------|
   |proxy_ftp_port              |<string> - Proxy server FTP port.             |
   |----------------------------+----------------------------------------------|
   |proxy_script                |<string> - Full path for the proxy script.    |
   |----------------------------+----------------------------------------------|
   |proxy_username              |<string> - Username for the proxy server.     |
   |----------------------------+----------------------------------------------|
   |proxy_password              |<string> - User's password for the proxy      |
   |                            |server.                                       |
   |----------------------------+----------------------------------------------|
   |open_firewall               |[yes|no]                                      |
   |----------------------------+----------------------------------------------|
   |report_dir                  |<string> - Directory path where you want HP   |
   |                            |SUM to save reports.                          |
   +---------------------------------------------------------------------------+

   The following table shows the combinations for software, firmware, downgrade
   and rewrite attributes:

   +------------------------------------------------------------------------+
   | GUI selection deploys | iCLI command example                           |
   |-----------------------+------------------------------------------------|
   | Software only         | rewrite=false downgrade=false firmware=false   |
   |                       | software=true                                  |
   |-----------------------+------------------------------------------------|
   | Firmware only         | rewrite=false downgrade=false firmware=true    |
   |                       | software=false                                 |
   |-----------------------+------------------------------------------------|
   | Firmware and software | rewrite=false downgrade=false firmware=true    |
   |                       | software=true                                  |
   |-----------------------+------------------------------------------------|
   | Downgrade software    | rewrite=false downgrade=true firmware=false    |
   |                       | software=true                                  |
   |-----------------------+------------------------------------------------|
   | Downgrade firmware    | rewrite=false downgrade=true firmware=true     |
   |                       | software=false                                 |
   |-----------------------+------------------------------------------------|
   | Downgrade both        | rewrite=false downgrade=true firmware=true     |
   |                       | software=true                                  |
   |-----------------------+------------------------------------------------|
   | Rewrite software      | rewrite=true downgrade=false firmware=false    |
   |                       | software=true                                  |
   |-----------------------+------------------------------------------------|
   | Rewrite firmware      | rewrite=true downgrade=false firmware=true     |
   |                       | software=false                                 |
   |-----------------------+------------------------------------------------|
   | Rewrite both          | rewrite=true downgrade=false firmware=true     |
   |                       | software=true                                  |
   |-----------------------+------------------------------------------------|
   | Rewrite and downgrade | rewrite=true downgrade=true firmware=false     |
   | software              | software=true                                  |
   |-----------------------+------------------------------------------------|
   | Rewrite and downgrade | rewrite=true downgrade=true firmware=true      |
   | firmware              | software=false                                 |
   |-----------------------+------------------------------------------------|
   | Rewrite and downgrade | rewrite=true downgrade=true firmware=true      |
   | both                  | software=true                                  |
   +------------------------------------------------------------------------+

Syntax

   hpsum setattributes --nodes [<nodelist>] attribute1=value1
   attribute2=value2

   hpsum setattributes --session attribute1=value1 attribute2=value2

Parameters

   The setattributes command provides the following options:

   +------------------------------------------------------------------------+
   | Parameter                 | Description                                |
   |---------------------------+--------------------------------------------|
   | hpsum                     | The HP SUM script initiates this action.   |
   |---------------------------+--------------------------------------------|
   | setattributes             | The command to set attributes pending HP   |
   |                           | SUM operations.                            |
   |---------------------------+--------------------------------------------|
   | --nodes [<nodelist>]      | Specify the nodes and attributes that you  |
   | attribute=value           | want to apply to nodes.                    |
   |---------------------------+--------------------------------------------|
   | --session attribute=value | Specify the session attribute you want to  |
   |                           | apply. Session attributes are global.      |
   +------------------------------------------------------------------------+


Return codes

   +------------------------------------------------------------------------+
   | Return Code            | Windows | Linux | Text                        |
   |------------------------+---------+-------+-----------------------------|
   | SUCCESS_NO_REBOOT      | 0       | 0     | The command was successful. |
   |------------------------+---------+-------+-----------------------------|
   | FAILURE_GENERAL        | -1      | 255   | A general failure occurred. |
   |                        |         |       | For details, see the logs.  |
   |------------------------+---------+-------+-----------------------------|
   |                        |         |       | A bad input parameter was   |
   | FAILURE_BAD_PARM       | -2      | 254   | encountered. For details,   |
   |                        |         |       | see the logs.               |
   |------------------------+---------+-------+-----------------------------|
   | FAILURE_COMMAND_FAILED | -4      | 252   | The command failed. For     |
   |                        |         |       | details, see the logs.      |
   +------------------------------------------------------------------------+

Example

    Windows sample command line

   C:\> hpsum setattributes /nodes 16.1.1.105 firmware=true 
   software=true rewrite=true downgrade=true

   C:\> hpsum setattributes /nodes 16.1.1.117 update_type=all

   C:\> hpsum setattributes /session open_firewall=yes

    Linux/HP-UX sample command line

   $ hpsum setattributes --nodes 16.1.1.105 firmware=true 
   software=true rewrite=true downgrade=true

   $ hpsum setattributes --nodes 16.1.1.117 update_type=all

   $ hpsum setattributes -session open_firewall=yes
