Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Mobile AAA Server A.01.00 Administrator's Guide: HP-UX 11.00 and 11i version 1 > Chapter 8 Logging and Monitoring

Server Sessions

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Index

The Mobile AAA server stores the session ID and other information about the session in an active session record when the server software engine receives an AA-Mobile-Node-Answer with a success authentication.

Sessions

The Sessions screen allows you to retrieve the active session information recorded by the Mobile AAA server. None of the search filtering parameters are required. If no search parameters are specified, all active sessions will be retrieved.

Search Parameters

Table 8-3 Sessions Search Parameters

Search Parameter

Description

User

Only searches for sessions that used the specified user NAI.

Home Agent IP Address

Only searches for sessions for the specified home agent.

Mobile Node Home IP Address

Only searches for sessions from the specified mobile node’s home agent.

 

Selecting the Display button will display a list of users.

  • Selecting the  “X” icon will terminate the corresponding listed session.

  • Selecting a user name will retrieve the session that corresponds to the listed session. The information will appear in a Session Attributes screen. You can stop the session from this screen by selecting the Terminate or Dismiss buttons.

  • You will want to stop a normal active session with the Terminate button. This control synchronizes the session termination by sending an Abort-Session-Request message to the home agent.

  • You will only use the Dismiss button if you believe a displayed session is not actually active. This situation may occur if communication between the server and a peer has been disrupted and the server did not receive a peer-initiated message that the session had been stopped. The Mobile AAA server removes a dismissed session entry from the active session table, but it sends nothing to the home agent.

The attributes that appear include:

  • The user's name

  • The realms, addresses, and session IDs of the home and foreign agents used to access the mobile service

  • When the session started

  • Session hand off, session timeout

  • Key lifetime, authorization lifetime

Session History (with diamsesstab)

The diamsesstab command-line utility can print session history files. Each session is grouped by user and described by session attributes.

Syntax

diamsesstab -1 Filename -a After -b Before -d Directory -dd Directory -f {short|long} -fd
"String" -h -o Time -out Filename -x {nn|+|-}{on|off} -:attribute=value
-*attribute=regexp file ...

file

one or more files that diamsesstab will retrieve session information from. The default file is diameter_session.checkpoint and it contains lists of active sessions.

Table 8-4 diamsesstab command options

Option

Description

-1 Filename

Only outputs the first session record for each user listed in the specified text file. Filename must be created and lists each user, one per line. The users in this file must have a realm, because Diameter users must include their realm in the User-Name attribute.

-a After

The date and time of the session to begin retrieving data from. Must be string in format of %Y-%m-%d/%H:%M:%S; for example, 1997-12-01/15:01:30 means 3:01:30pm, December 1, 1997. Hour, minute, and second may be omitted, and each default to 0. Day and month may be omitted, and each default to 1.

-b Before

The date and time of the last session to retrieve data from. Must be string in format of %Y-%m-%d/%H:%M:%S; for example, 1997-12-01/15:01:30 means 3:01:30pm, December 1, 1997. Hour, minute, and second may be omitted, and each default to 0. Day and month may be omitted, and each default to 1.

-dd Directory

An alternate directory name containing the session files, instead of the default directory. If no -dd option is given, diamsesstab will look for the default /var/opt/aaa/diameter/data location. An error will be displayed if the session files cannot be found.

-f {short|long}

Outputs information in short or long format. In the long format each user session consists of several lines of output with one session value per line. The short format provides a subset of session values, all listed on one line per user session.

-fd "String"

Specifies the string that should be used to delimit session values listed in the short format. You can use the \n escape character to have the session values listed one per line, indented after the user name. By default the values are comma-delimited.

-h

Displays the help syntax.

-o Time

Selects sessions that were active at the specified date and time. Must be string in format of %Y-%m-%d/%H:%M:%S, as described for the -a and -b options.

-out Filename

Sends the output to the specified file, rather than to stdout.

-x {nn|+|-}{on|off}

{on|off} enables or disables debugging for diamsesstab. Debug output is written to the same directory as the output specified by file. {nn|+|-} controls the debug level (see 21 for description of debug levels).

-:attribute=value

Only search for sessions that contain the specified attribute-value pair(s). The Attribute-Value Pairs chapter describes the syntax for specifying an attribute-value pair and the HP-specific session attributes that appear in session records.

-*attribute=regexp

Only search for sessions that contain the attribute-value pair(s) that match the specified regular expression. The Attribute-Value Pairs chapter describes the syntax for specifying an attribute-value pair and the HP-specific session attributes that appear in session records. You can find a discussion of regular expressions in the man pages for sed or awk, which you can access by typing man sed or man awk at the command line.

 

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2001-2004 Hewlett-Packard Development Company, L.P.