1 add

  Description

   Adds baselines or nodes to the current working set for the current
   session.

  Syntax

   hpsum add --nodes

   hpsum add --baselines

  Parameters

   Parameters given immediately after the /nodes command, but used before a
   node, are considered global parameters. These parameters apply to all the
   nodes specified in the command. For example:

   hpsum add /nodes user=user1 password=password1 type=linux 192.168.1.2
   192.168.1.10

   The parameters user, password, and type apply to both nodes.

   Parameters used after a specified node apply to that node only.

   hpsum add /nodes 192.168.1.15 user=user2 password=password2 type=linux
   192.168.1.17 user=user3 password=password3 type=windows

   The parameters user2, password2, and linux apply to node 192.168.1.15,
   parameters user3, password3, and windows apply to 192.168.1.17.

   Node parameters

   --nodes <nodeslist>

           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

           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.

   type = <node type>

           This parameter defines the node type. Use this as both a local and
           global parameter. HP SUM supports node types:

              o windows

              o linux

              o ilo

              o virtual_connect

                Use the IP address of a primary Enet module. VC nodes require
                oa_username and oa_password.

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

              o oa

              o vmware

              o hpux

              o sas_switch

              o fc_switch

              o sd2

              o moonshot

              o unknown

   user=<user_name>

           Example: user=john_doe@example.com

           This provides the username credentials for the node. If you do not
           enter this on the command line, HP SUM prompts for the username.

           Use this as both local and global parameters.

   password=<password>

           Example: password=userpassword

           The user password credentials for the node. If you do not enter
           this on the command line, HP SUM prompts for the password.

           Use this as both local and global parameters.

   su_user=<super_userID>

           Example: user=su_john_doe@example.com

           The username for the super user.

   su_password=<super_user_password>

           Example: password=su_userpassword

           The password for the super user.

   use_sudo

           Use credentials as sudo credentials.

           Potential options:

              o true

              o false

   switch_username=<switch_a_username>

           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.

              -------------------------------------------------------------   
            NOTE: You can assign a switch B credentials using the             
            setattributes command.                                            
              -------------------------------------------------------------   

   switch_password=<switch_a_password>

           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.

              -------------------------------------------------------------   
            NOTE: You can assign a switch B credentials using the             
            setattributes command.                                            
              -------------------------------------------------------------   

   switch_enable=<enable_password>

           Enables switch A for the Moonshot node. You can use this value for
           the A and B switches if the password is the same.

   vcenter_host

           This is the address of the VMware vCenter when VMware is in
           lock-down mode. Use these parameter along with vcenter_username
           and vcenter_password to establish a connection with a VMware host
           that is in lock-down mode.

   vcenter_username

           This is the user account to establish a connection with a VMware
           host.

   vcenter_password

           This is the account password to establish a connection with a
           VMware host.

   use_sshkey

           Potential options:

              o true

              o false

           Linux nodes only. Use privatekeyfile and passphrase (optional)
           with this command.

   privatekeyfile=<PEM_file_absolute_path>

           Enter the absolute address for the private key. The private key
           must be in PEM format.

           Use this as both local and global parameters.

   passphrase=<passphrase>

           (Optional) Enter the passphrase for the private key.

           Use this as both local and global parameters.

   Baseline parameters

   --baselines <directory_path>

           Use this parameter to add local baselines by specifying the
           directory. If you are adding an HTTP baseline, use the
           save_location parameter.

   save_location=<working_location>

           Directory where you want to save HTTP baselines you
           download.

   type=<baseline_type>

           This parameter defines the baseline type. HP SUM supports baseline
           types:

           http

           ftp - HP SUM no longer supports downloading baselines from hpe.com

           unc (Windows only)

              -------------------------------------------------------------   
            NOTE: Make sure that the UNC directory is not open in the         
            localhost system.                                                 
              -------------------------------------------------------------   

   unc_username=<unc_username>

           Enter the username for the UNC directory path. Valid for (Windows
           only).

   unc_password=<unc_password>

           Enter the password for the UNC directory path. Valid for (Windows
           only).

   bundle=<bundle_name>

           Enter the bundle file name you want to add. Use the command
           getbaselines /list to display the list of bundle file names. For
           example, bundle=spp.2014.02.0.B.

   filter_os=<os_filter>

           (HTTP baselines only) This attribute allows you to filter the
           components HP SUM downloads based on operating system. The valid
           options are:

           windows

           linux

           vmware

           hp-ux

  Restrictions

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

     o Issue the getbaselines command to view a list of SPP baselines
       available. For more information on setattributes, see the
       setattributes help file.


     o 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.

  Usage

   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]

  Windows usage

  Windows sample command line

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

   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

   C:\>hpsum add /nodes 10.1.2.3 type=virtual_connect
   oa_username=Administrator oa_password=mypassword1

  Linux usage

   $ ./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 --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                                                             
      ---------------------------------------------------------------------   

  Return codes

   SUCCESS_NO_REBOOT

           Windows code: 0

           Linux code: 0

           Text: The command was successful.

   SUCCESS_NOT_REQUIRED

           Windows code: 3

           Linux code: 3

           Text: The command completed successfully, but was not required or
           everything was already current.

              ---------------------------------------   
            NOTE: The node or baseline already existed. 
              ---------------------------------------   

   FAILURE_GENERAL

           Windows code: -1

           Linux code: 255

           Text: A general failure occurred. For details, see the logs.

   FAILURE_BAD_PARM

           Windows code: -2

           Linux code: 254

           Text: A bad input parameter was encountered. For details, see the
           logs.

   FAILURE_COMMAND_FAILED

           Windows code: -4

           Linux code: 253

           Text: The command failed. For details, see the logs.