﻿1 Add

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

      ---------------------------------------------------------------------   
    NOTE: Before you add an ftp type baseline, add a hp-passport-token        
    parameter in the setattributes command. 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: HP Service Pack for ProLiant                                     
                    Bundle File Name: spp.2014.02.0.B                         
                    Version: 2014.02.0.B                                      
                    Release Date: 2014-04-25                                  
    2. Name: HP 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.

   For example, 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>]

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

      ---------------------------------------------------------------------   
    NOTE: Do not add baselines in the same command as nodes. 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 or   |
   | add                                    | 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        |
   |                                        |                               |
   | --nodes <nodeslist>                    | ip: 127.0.0.1                 |
   |                                        |                               |
   |                                        | 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 an 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_user and oa_password.      |
   |                                        |                               |
   | type = <node type>                     | oa                            |
   |                                        |                               |
   |                                        | vmware                        |
   |                                        |                               |
   |                                        | hpux                          |
   |                                        |                               |
   |                                        |                               |
   |                                        |                               |
   |                                        | sas_switch                    |
   |                                        |                               |
   |                                        | fc_switch                     |
   |                                        |                               |
   |                                        | sd2                           |
   |                                        |                               |
   |                                        | moonshot                      |
   |                                        |                               |
   |                                        | unknown                       |
   |----------------------------------------+-------------------------------|
   | user=<user_name>                       | This username credentials for |
   |                                        | the node.                     |
   | For example: user=john_doe@example.com |                               |
   |----------------------------------------+-------------------------------|
   |                                        | The user password credentials |
   | password=<password>                    | for the node. If you do not   |
   |                                        | enter this on the command     |
   | For example: password=userpassword     | line, HP SUM prompts for the  |
   |                                        | password.                     |
   |----------------------------------------+-------------------------------|
   | su_user=<super_userID>                 |                               |
   |                                        | The username for the super    |
   | For example:                           | user.                         |
   | 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.   |
   |                                        |    ------------------------   |
   |----------------------------------------+-------------------------------|
   | switch_enable=<enable_password>        | Enables switch A for the      |
   |                                        | Moonshot node.                |
   |----------------------------------------+-------------------------------|
   | vcenter_host                           | Use these parameters to       |
   |                                        | establish a connection with a |
   | vcenter_username                       | VMware host that is in        |
   |                                        | lock-down mode.               |
   | vcenter_password                       |                               |
   |----------------------------------------+-------------------------------|
   |                                        | Potential options:            |
   |                                        |                               |
   | --use_sshkey                           |   o true                      |
   |                                        |                               |
   |                                        |   o false                     |
   |----------------------------------------+-------------------------------|
   |                                        | Enter the address for the     |
   | privatekeyfile                         | private key. The private key  |
   |                                        | must be in PEM format.        |
   |----------------------------------------+-------------------------------|
   |                                        | (Optional) Enter the          |
   | passphrase                             | passphrase for the private    |
   |                                        | key.                          |
   |----------------------------------------+-------------------------------|
   |                                        | Use this parameter to add     |
   |                                        | local baselines by specifying |
   | --baselines                            | the directory. If you are     |
   |                                        | adding an FTP or HTTP         |
   |                                        | baseline, use the             |
   |                                        | save_location parameter.      |
   |----------------------------------------+-------------------------------|
   | save_location=<working_location>       | Directory where you want to   |
   |                                        | save a baseline you download. |
   |----------------------------------------+-------------------------------|
   |                                        | This parameter defines the    |
   |                                        | baseline type. HP SUM         |
   |                                        | supports baseline types:      |
   |                                        |                               |
   |                                        | http                          |
   |                                        |                               |
   |                                        | ftp                           |
   | 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).               |
   |----------------------------------------+-------------------------------|
   |                                        | This is the bundle file name  |
   |                                        | you want to add. Use the      |
   | bundle                                 | command getbaselines /list to |
   |                                        | display the list of bundle    |
   |                                        | file names. For example,      |
   |                                        | bundle=spp.2014.04.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                              |                               |
   |                                        |   o windows                   |
   |                                        |                               |
   |                                        |   o linux                     |
   |                                        |                               |
   |                                        |   o vmware                    |
   |                                        |                               |
   |                                        |   o hpux                      |
   +------------------------------------------------------------------------+

  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

   hpsum add /nodes type=vc 15.154.117.94 user=Administrator
   password=12iso*help oa_username=Administrator oa_password=12iso*help

   C:\>hpsum add /nodes 15.212.143.4 type=vmware vcenter_host=15.212.143.112 
   vcenter_username=Administrator vcenter_password=12iso*help
    Linux sample command line

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

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

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

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

   $ ./hpsum add --nodes 15.212.143.4 type=vmware vcenter_host=15.212.143.112 
   vcenter_username=Administrator vcenter_password=12iso*help
      ---------------------------------------------------------------------   
    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                                                             
      ---------------------------------------------------------------------   
