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 4 Server Administration Commands

Simulating Agents with diamTestClient

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Index

You can use the diamTestClient utility to test the Mobile AAA server configuration by simulating an agent sending Diameter messages to the server. It is possible to test user profiles for authentication, to simulate user sessions, and to generate authentication loads. The messages to performs these tests are constructed. After a script is written, you run the script with the diamTestClient utility to perform the scripted test.

Command Syntax

diamTestClient -d Cfg-dir -dl Log-dir -mfqdn My-fqdn -mrealm My-realm -mport My-port -o Filename -sfqdn Server-fqdn -sidport Server-ID-port -sconnport Server-conn-port -listen -tls -log Level -testcem -f Script-file

Command Options

Table 4-3 Options for the diamTestClient Command

Option

Description

-d Cfg-dir

Directory that contains the copy of the Diameter server's  dictionary and vendor files in this directory.

If TLS is to be tested, the specified directory must also contain the following files in a security subdirectory:

  • cipher_suite_order.txt

  • ca_list.pem

  • rsa_cert.pem

  • rsa_key.pem

  • dhparams.pem

  • index2

These TLS configuration files are described in the file: /etc/opt/aaa/diameter/security/cipher_suite_order.txt

-dl Log-dir

Log directory that the diamTestClient utility can write out to. The diamTestClient will record log messages in the specified directory in the file: /var/opt/aaa/diameter/logs/diameter.log.

-mfqdn My-fqdn

Fully qualified domain name for the diamTestClient. Defaults to the host name of the current host.

-mrealm My-realm

Realm name for the diamTestClient. Defaults to realm portion of My-fqdn.

-mport My-port

TCP port that the diamTestClient will use to listen for incoming connections. Defaults to 1812. The TCP port is also used to uniquely identify a diamTestClient client when multiple diamTestClient clients are running on the same hosts, so its value is important even when the diamTestClient is not listening for incoming connections.

-o Filename

Directs output to the specified file. This option can be useful if you are running the utility in the background (with the UNIX & switch).

-sfqdn Server-fqdn

Fully qualified domain name for the Mobile AAA server that the diamTestClient will send messages to.

-sidport Server-ID-port

TCP port contained in the Diameter Identity of the Mobile AAA Server. For our Mobile AAA Server, this will be the server's non-TLS TCP port. Defaults to 1812.

-sconnport Server-conn-port

TCP port that the Mobile AAA server will listen to for incoming TLS connections. Defaults to 1812.

-listen

Using this option causes the diamTestClient to listen for incoming connections instead of attempting to initiate a connection to the Mobile AAA Server.

-tls

Using this option causes the diamTestClient to use TLS on the TCP connection to the Mobile AAA server. When using this option with an anonymous cipher suite, diamTestClient uses the string “secret” as the shared secret.

-log Level

Sets the log level. This affects the types of messages that appear in the diameter.log file. Messages are classified as being one of the following: Alert (A), Critical (C), Error (E), Warning (W), Notice (N), Info (I), Debug (D).

Level may be set to a value between 1 and 7 (default is 6). The following list shows what types of messages are logged for each log level:

  • 1 - (A)

  • 2 - (A), (C)

  • 3 - (A), (C), (E)

  • 4 - (A), (C), (E), (W)

  • 5 - (A), (C), (E), (W), (N)

  • 6 - (A), (C), (E), (W), (N), (I)

  • 7 - (A), (C), (E), (W), (N), (I), (D)

-testcem

This option is used to test the Diameter Capabilities Exchange message. Capabilities Exchange negotiation occurs when the diamTestClient connection to the Mobile AAA Server is being brought up. The diamTestClient will by default advertise support for Mobile IP authentication and accounting. When the -testcem option is specified, this default behavior is disabled and a Capabilities Exchange Request message must be specified in the diamTestClient script file.Specifying this option will also disable the diamTestClient watchdog timer, which allows testig of some Mobile AAA Server watchdog logic.

-f Script-file

This option is used to specify a diamTestClient script file. diamTestClient script files contain commands that allow the diamTestClient to construct and send Diameter messages.

 

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