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