1 Add

   add adds baselines or nodes to the current working set for the current
   session.

      ---------------------------------------------------------------------   
    NOTE: Issue the getbaselines command to view a list of SPP baselines      
    available. For more information on setattributes, see the setattributes   
    help file.                                                                
                                                                              
    hpsum getbaselines --list hp.com                                          
                                                                              
    HP SUM returns a list of available baselines online, for example:         
                                                                              
    Web Baseline Information:                                                 
    1. Name: Service Pack for ProLiant                                        
                    Bundle File Name: spp.2014.02.0.B                         
                    Version: 2014.02.0.B                                      
                    Release Date: 2014-04-25                                  
    2. Name: Service Pack for ProLiant                                        
                    Bundle File Name: spp.2013.09.0.C                         
                    Version: 2013.09.0.C                                      
                    Release Date: 2014-04-30                                  
      ---------------------------------------------------------------------   

   You can supply passwords for all the nodes or baselines at the beginning
   of the list.

   hpsum add [--nodes n1 [type=<node_type>] [user=<username>]
   [password=<userpassword>] [su_user=<su_user>]
   [su_password=<suuser_password>] [use_sudo=true]
   [switch_username=<Moonshot_switchA_username>]
   [switch_password=<Moonshot_switchA_password>]
   [switch_enable=<Moonshot_switchA_enable>]

   --baselines b1 [save_location=<directory>] [type=<baseline_type]

      ---------------------------------------------------------------------   
    NOTE: HP SUM interactive CLI mode does not automatically add nodes or     
    baselines. The interactive CLI mode does not automatically add associated 
    nodes. Use GUI mode to add associated devices.                            
      ---------------------------------------------------------------------   

   If you add a VC node, include the following attributes: oa_username and
   oa_password.

  1.1 Syntax

   hpsum add --nodes n1 [type=<node_type>] user=<username>
   password=<userpassword>]

   hpsum add --baselines b1 [save_location=<directory>] [type
   <baseline_type>]

   hpsum add /baselines type=unc "\\UNC_PATH" unc_username=user
   unc_password=pwd

      ---------------------------------------------------------------------   
    NOTE: Do not add a baseline and node in the same command. Use two         
    separate commands.                                                        
      ---------------------------------------------------------------------   

  1.2 Parameters

   The add command provides the following options:

   +------------------------------------------------------------------------+
   | Parameter                                 | Description                |
   |-------------------------------------------+----------------------------|
   | hpsum                                     | The HP SUM script          |
   |                                           | initiates this action.     |
   |-------------------------------------------+----------------------------|
   |                                           | The command to add nodes   |
   | add                                       | or baselines to the HP SUM |
   |                                           | session.                   |
   |-------------------------------------------+----------------------------|
   |                                           | Object to perform the add  |
   |                                           | operation. The items in    |
   |                                           | the list should be         |
   |                                           | delimited by spaces. You   |
   |                                           | can specify the user and   |
   |                                           | password globally for all  |
   |                                           | nodes.                     |
   |                                           |                            |
   |                                           | domain_name: localhost     |
   |                                           |                            |
   |                                           | ip: 127.0.0.1              |
   |                                           |                            |
   | --nodes <nodeslist>                       | ipv6: ::1                  |
   |                                           |                            |
   |                                           | Add either nodes or        |
   |                                           | baselines. Do not add both |
   |                                           | in the same command.       |
   |                                           |                            |
   |                                           | If you are adding a VC     |
   |                                           | node, use the IP address   |
   |                                           | of the primary Enet        |
   |                                           | module. All VC modules     |
   |                                           | installed, including FC    |
   |                                           | modules, are updated       |
   |                                           | through the primary Enet   |
   |                                           | module.                    |
   |-------------------------------------------+----------------------------|
   |                                           | This parameter defines the |
   |                                           | node type. HP SUM supports |
   |                                           | node types:                |
   |                                           |                            |
   |                                           | windows                    |
   |                                           |                            |
   |                                           | linux                      |
   |                                           |                            |
   |                                           | ilo                        |
   |                                           |                            |
   |                                           | virtual_connect-Use the IP |
   |                                           | address of a primary Enet  |
   |                                           | module. VC nodes require   |
   |                                           | oa_username and            |
   |                                           | oa_password.               |
   | type = <node type>                        |                            |
   |                                           | oa                         |
   |                                           |                            |
   |                                           | vmware                     |
   |                                           |                            |
   |                                           | hpux                       |
   |                                           |                            |
   |                                           | sas_switch                 |
   |                                           |                            |
   |                                           | fc_switch                  |
   |                                           |                            |
   |                                           | sd2                        |
   |                                           |                            |
   |                                           | moonshot                   |
   |                                           |                            |
   |                                           | unknown                    |
   |-------------------------------------------+----------------------------|
   |                                           | This provides the username |
   | user=<user_name>                          | credentials for the node.  |
   |                                           | If you do not enter this   |
   | For example: user=john_doe@example.com    | on the command line, HP    |
   |                                           | SUM prompts for the        |
   |                                           | username.                  |
   |-------------------------------------------+----------------------------|
   |                                           | The user password          |
   | password=<password>                       | credentials for the node.  |
   |                                           | If you do not enter this   |
   | For example: password=userpassword        | on the command line, HP    |
   |                                           | SUM prompts for the        |
   |                                           | password.                  |
   |-------------------------------------------+----------------------------|
   | su_user=<super_userID>                    | The username for the super |
   |                                           | user.                      |
   | For example: user=su_john_doe@example.com |                            |
   |-------------------------------------------+----------------------------|
   | su_password=<super_user_password>         | The password for the super |
   |                                           | user.                      |
   | For example: password=su_userpassword     |                            |
   |-------------------------------------------+----------------------------|
   |                                           | Use credentials as sudo    |
   |                                           | credentials.               |
   |                                           |                            |
   | use_sudo                                  | Potential options:         |
   |                                           |                            |
   |                                           |   o true                   |
   |                                           |                            |
   |                                           |   o false                  |
   |-------------------------------------------+----------------------------|
   |                                           | Username for a Moonshot    |
   |                                           | switch A. If the username  |
   |                                           | for switch B is the same   |
   |                                           | as switch A, then this     |
   |                                           | value applies to both      |
   |                                           | switches.                  |
   | switch_username=<switch_a_username>       |                            |
   |                                           |    ---------------------   |
   |                                           |  NOTE: You can assign a    |
   |                                           |  switch B credentials      |
   |                                           |  using the setattributes   |
   |                                           |  command.                  |
   |                                           |    ---------------------   |
   |-------------------------------------------+----------------------------|
   |                                           | Password for a Moonshot    |
   |                                           | switch A. If the password  |
   |                                           | for switch B is the same   |
   |                                           | as switch A, then this     |
   |                                           | value applies to both      |
   |                                           | switches.                  |
   | switch_password=<switch_a_password>       |                            |
   |                                           |    ---------------------   |
   |                                           |  NOTE: You can assign a    |
   |                                           |  switch B credentials      |
   |                                           |  using the setattributes   |
   |                                           |  command.                  |
   |                                           |    ---------------------   |
   |-------------------------------------------+----------------------------|
   |                                           | Enables switch A for the   |
   |                                           | Moonshot node. You can use |
   | switch_enable=<enable_password>           | this value for the A and B |
   |                                           | switches if the password   |
   |                                           | is the same.               |
   |-------------------------------------------+----------------------------|
   |                                           | This is the address of the |
   |                                           | VMware vCenter when VMware |
   |                                           | is in lock-down mode. Use  |
   |                                           | these parameter along with |
   | vcenter_host                              | vcenter_username and       |
   |                                           | vcenter_password to        |
   |                                           | establish a connection     |
   |                                           | with a VMware host that is |
   |                                           | in lock-down mode.         |
   |-------------------------------------------+----------------------------|
   |                                           | This is the user account   |
   | vcenter_username                          | to establish a connection  |
   |                                           | with a VMware host.        |
   |-------------------------------------------+----------------------------|
   |                                           | This is the account        |
   | vcenter_password                          | password to establish a    |
   |                                           | connection with a VMware   |
   |                                           | host.                      |
   |-------------------------------------------+----------------------------|
   |                                           | Potential options:         |
   |                                           |                            |
   |                                           |   o true                   |
   |                                           |                            |
   | use_sshkey                                |   o false                  |
   |                                           |                            |
   |                                           | Linux nodes only. Use      |
   |                                           | privatekeyfile and         |
   |                                           | passphrase (optional) with |
   |                                           | this command.              |
   |-------------------------------------------+----------------------------|
   |                                           | Enter the absolute address |
   | privatekeyfile=<PEM_file_absolute_path>   | for the private key. The   |
   |                                           | private key must be in PEM |
   |                                           | format.                    |
   |-------------------------------------------+----------------------------|
   |                                           | (Optional) Enter the       |
   | passphrase=<passphrase>                   | passphrase for the private |
   |                                           | key.                       |
   |-------------------------------------------+----------------------------|
   |                                           | Use this parameter to add  |
   |                                           | local baselines by         |
   | --baselines <directory_path>              | specifying the directory.  |
   |                                           | If you are adding an FTP   |
   |                                           | or HTTP baseline, use the  |
   |                                           | save_location parameter.   |
   |-------------------------------------------+----------------------------|
   |                                           | Directory where you want   |
   | save_location=<working_location>          | to save FTP or HTTP        |
   |                                           | baselines you download.    |
   |-------------------------------------------+----------------------------|
   |                                           | This parameter defines the |
   |                                           | baseline type. HP SUM      |
   |                                           | supports baseline types:   |
   |                                           |                            |
   |                                           | http                       |
   |                                           |                            |
   |                                           | ftp                        |
   | type=<baseline_type>                      |                            |
   |                                           | unc (Windows only)         |
   |                                           |                            |
   |                                           |    ---------------------   |
   |                                           |  NOTE: Make sure that the  |
   |                                           |  UNC directory is not open |
   |                                           |  in the localhost system.  |
   |                                           |    ---------------------   |
   |-------------------------------------------+----------------------------|
   |                                           | Enter the username for the |
   | unc_username=<unc_username>               | UNC directory path. Valid  |
   |                                           | for (Windows only).        |
   |-------------------------------------------+----------------------------|
   |                                           | Enter the password for the |
   | unc_password=<unc_password>               | UNC directory path. Valid  |
   |                                           | for (Windows only).        |
   |-------------------------------------------+----------------------------|
   |                                           | Enter the bundle file name |
   |                                           | you want to add. Use the   |
   |                                           | command getbaselines /list |
   | bundle=<bundle_name>                      | to display the list of     |
   |                                           | bundle file names. For     |
   |                                           | example,                   |
   |                                           | bundle=spp.2014.02.0.B.    |
   |-------------------------------------------+----------------------------|
   |                                           | (HTTP baselines only) This |
   |                                           | attribute allows you to    |
   |                                           | filter the components HP   |
   |                                           | SUM downloads based on     |
   |                                           | operating system. The      |
   |                                           | valid options are:         |
   | filter_os=<os_filter>                     |                            |
   |                                           |   o windows                |
   |                                           |                            |
   |                                           |   o linux                  |
   |                                           |                            |
   |                                           |   o vmware                 |
   |                                           |                            |
   |                                           |   o hp-ux                  |
   +------------------------------------------------------------------------+

  1.3 Return codes

   +------------------------------------------------------------------------+
   | Return Code            | Windows | Linux | Text                        |
   |------------------------+---------+-------+-----------------------------|
   | SUCCESS_NO_REBOOT      | 0       | 0     | The command was successful. |
   |------------------------+---------+-------+-----------------------------|
   |                        |         |       | The command completed       |
   |                        |         |       | successfully, but was not   |
   |                        |         |       | required or everything was  |
   |                        |         |       | already current.            |
   | SUCCESS_NOT_REQUIRED   | 3       | 3     |                             |
   |                        |         |       |    ----------------------   |
   |                        |         |       |  NOTE: The node or baseline |
   |                        |         |       |  already existed.           |
   |                        |         |       |    ----------------------   |
   |------------------------+---------+-------+-----------------------------|
   | 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      | 253   | The command failed. For     |
   |                        |         |       | details, see the logs.      |
   +------------------------------------------------------------------------+

  1.4 Example

    Windows sample command line

   C:\>hpsum add /nodes 10.0.1.15 type=windows

   C:\>hpsum add /baselines type=ftp save_location=c:\temp\pfw
   bundle=spp.2014.02.0.B

   C:\>hpsum add /baselines type=http save_location=c:\temp\spp
   bundle=http://10.1.2.3/spp/hp/swpackages/bp002524.xml filter_os=linux

   C:\>hpsum add /nodes type=vc 10.0.1.16 user=Administrator password=12iso*help
   oa_username=Administrator oa_password=12iso*help

   C:\>hpsum add /nodes 10.0.1.4 type=vmware vcenter_host=10.0.1.20
   vcenter_username=Administrator vcenter_password=password

   hpsum add /nodes 10.1.2.3 type=virtual_connect oa_username=Administrator
   oa_password=mypassword1

    Linux sample command line

   $ ./hpsum add --nodes 10.0.1.16 type=linux

   $ ./hpsum add --baselines "/SPP/" "/tmp/myrepos/"

   $ ./hpsum add --baselines type=http save_location=c:\temp\spp
   bundle=http://10.1.2.3/spp/hp/swpackages/bp002524.xml filter_os=linux

   $ ./hpsum add --nodes type=vc 10.0.1.18 user=Administrator password=12iso*help
   oa_username=Administrator oa_password=12iso*help

   $ ./hpsum add --baselines type=ftp save_location=/tmp/pfw
   bundle=spp.2014.02.0.B

   $ ./hpsum add --nodes 10.0.1.4 type=vmware vcenter_host=10.0.1.20
   vcenter_username=Administrator vcenter_password=password

   $ ./hpsum add --nodes 10.1.2.3 type=virtual_connect
   oa_username=Administrator oa_password=mypassword1

      ---------------------------------------------------------------------   
    NOTE: If the node type is Linux or HP-UX, you can use su_user and         
    su_password, or use use_sudo.                                             
                                                                              
    For example:                                                              
                                                                              
    hpsum add /nodes 192.168.1.1 type=Linux user=user password=password       
    su_user=user1 su_password=password1                                       
                                                                              
    hpsum add /nodes 192.168.1.1 type=Linux user=user password=password       
    use_sudo=true                                                             
      ---------------------------------------------------------------------