﻿1 Login

     ----------------------------------------------------------------------

   Enables you to log in using a set of user credentials for the HP SUM
   session.

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

   When you run HP SUM from the same host that runs the hpsum_server, you
   have three possible login cases.

   Authenticating with credentials for the first timeOffline mode with no
   credentials - In this case you do not need the credentials because there
   is no user interaction. The command creates a session if the IP address of
   the request is the same as the hpsum_server. This is an anonymous session.
    1. Authenticating with credentials for the first time

    2. Offline mode with no credentials - In this case you do not need the
       credentials because there is no user interaction. The command creates
       a session if the IP address of the request is the same as the
       hpsum_server. This is an anonymous session.

  1.1 Syntax

   Authenticating with credentials for the first time:hpsum [.cmd] login
   [--username rono --password pwd123 --host 10.0.0.1 --port 63002 --ssl_port
   63002]Offline mode with no credentials:hpsum [.cmd] [--ssl_port 9091
   --mode offline_automatic]Authenticating with previous session:hpsum [.cmd]
   login
    1. Authenticating with credentials for the first time:

       hpsum [.cmd] login [--username rono --password pwd123 --host 10.0.0.1
       --port 63002 --ssl_port 63002]

    2. Offline mode with no credentials:

       hpsum [.cmd] [--ssl_port 9091 --mode offline_automatic]

    3. Authenticating with previous session:

       hpsum [.cmd] login

  1.2 Parameters

   The login command provides the following options:

   +----------------------------------------------------------------------+
   | Option      | Description                                            |
   |-------------+--------------------------------------------------------|
   | hpsum[.cmd] | The HP SUM script initiates this action.               |
   |-------------+--------------------------------------------------------|
   | login       | The command to set credentials for the HP SUM session. |
   +----------------------------------------------------------------------+

  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.cmd login /username=rono /password=pwd123 /host=localhost
   /ssl_port=9091

    Linux/HP-UX sample command line

   $ hpsum login --username=rono --host=localhost --ssl_port=9091
