1 Login

   The Login command enables you to set the credentials used for the current
   session.

  1.1 Syntax

    Authenticating with credentials for the first time:

   hpsum login [--username <username> --password <password>] [--port <port>]
   [--ssl_port <sslport>] [--ftp_port <ftpport>] [--open_firewall]

    Authenticating with current credentials:

   hpsum login

  1.2 Parameters

   +------------------------------------------------------------------------+
   | Parameter       | Description                                          |
   |-----------------+------------------------------------------------------|
   | hpsum           | The HP SUM script initiates this action.             |
   |-----------------+------------------------------------------------------|
   | login           | The command to set credentials for the HP SUM        |
   |                 | session.                                             |
   |-----------------+------------------------------------------------------|
   | --username      | Optional parameter for adding username.              |
   |-----------------+------------------------------------------------------|
   | --password      | Optional parameter for adding user password.         |
   |-----------------+------------------------------------------------------|
   |                 | Optional parameter to define a port that HP SUM      |
   |                 | uses.                                                |
   | --port          |                                                      |
   |                 | The allowed values are:                              |
   |                 |                                                      |
   |                 | 80, 1024-65535                                       |
   |-----------------+------------------------------------------------------|
   |                 | Optional parameter to define an SSL port that HP SUM |
   |                 | uses.                                                |
   | --ssl_port      |                                                      |
   |                 | The allowed values are:                              |
   |                 |                                                      |
   |                 | 443, 1024-65535                                      |
   |-----------------+------------------------------------------------------|
   |                 | Optional parameter to define the FTP port that HP    |
   |                 | SUM uses.                                            |
   | --ftp_port      |                                                      |
   |                 | The allowed values are:                              |
   |                 |                                                      |
   |                 | disabled, 21, 1024-65535                             |
   |-----------------+------------------------------------------------------|
   |                 | Optional parameter that allows HP SUM to open the    |
   | --open_firewall | HTTP and HTTPS ports used by HP SUM for external     |
   |                 | access. Also used to open the ports for remote node  |
   |                 | functionality and for remote browser access.         |
   +------------------------------------------------------------------------+

  1.3 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.      |
   +------------------------------------------------------------------------+

  1.4 Example

    Windows sample command line

   C:\> hpsum login /username rono /password pwd123 /ssl_port 9091

    Linux sample command line

   $ ./hpsum login --username rono --password pwd123 --ssl_port 9091