IBM Tivoli Monitoring, Version 6.3

tacmd tepsLogin

Description

Use the tacmd tepsLogin command to log on to the Tivoli Enterprise Portal Server. For ITM v6.2.3 or later, the IBM HTTP Server (IHS) serves as the default HTTP server at port 15200. However, the portal server is still compatible with the KDH HTTP server at port 1920.

CLI syntax

tacmd tepsLogin
                      {-s|--server} TEPS_HOSTNAME
                      {-u|--username} USERNAME
                      {-p|--password} TEPS_PASSWORD
                      [{-t|--timeout} TIMEOUT ]

Standard input option:

tacmd tepsLogin
{-stdin|--stdin}

where:

-s|--server: Specifies the Tivoli® Enterprise Portal Server hostname to connect to. Use either -s <TEPS_HOSTNAME> or -s http://<TEPS_HOSTNAME>
-u|--username: Specifies the username to log on to the Tivoli Enterprise Portal Server. The software prompts you for the username if you do not specify one.
-p|--password: Specifies the password for user authentication. The software prompts you for the password if you do not specify one.
-t|--timeout: Specifies the maximum number of minutes that can elapse between invocations of the tacmd tepsLogin command before the user is denied access to the Teps credentials file. The default timeout is 15 minutes. The maximum timeout is 1440 minutes (24 hours).
-stdin|--stdin: Indicates that all command-line parameters are processed from standard input (in the same command-line format) instead of being parsed from the command-line arguments.

CLI example

The following example shows how to log in on the command line with a specific username. The user is prompted to enter a password. The log in is valid for 24 hours (1,440 minutes):

C:\IBM\ITM\bin>tacmd tepslogin -s lever -u sysadmin -t 1440

 Password?
 KUICTL001I Validating user credentials...

KUIC00007I: User sysadmin logged on to server on http://lever:15200.

The following example shows how to log in with only the server and time specified. The user is prompted to enter a username and a password. The log in is valid for 1 hour (60 minutes).

C:\IBM\ITM\bin>tacmd tepslogin -s lever  -t 60

 Username?  sysadmin

 Password?
 KUICTL001I Validating user credentials...

KUIC00007I: User sysadmin logged on to server on http://lever:15200.

The following example shows how to log on to the KDH HTTP server at port 1920.

tacmd tepslogin -s ip-address:1920 -u sysadmin -p mypwd

Related commands

Attention: A variety of commands that communicate with the Tivoli Enterprise Portal Server are authenticated using one of two methods:

Use the tacmd tepsLogin command with -u, -p, and -s options to autenticate to the Tivoli Enterprise Portal Server. Then use the related command (for example, the tacmd createUser command or the tacmd listworkspaces command), or
Use the related command you want to use (for example, the tacmd createUser command or the tacmd listworkspaces command). However, you should specify the -u, -p, and -s options. If you don't specify the -s option, but you specify the -w and -u options for a command that communicates with the Tivoli Enterprise Portal Server, then the command uses the default value for the hostname (-s localhost:15200).

Return to Table 1.

Feedback