Cisco SCMS SM LEGs User Guide, Release 3.6.x

Using the Simple Object Access Protocol Login Event Generator Command-Line Utility

Introduction

This chapter describes the command-line utility (CLU) commands when the Simple Object Access Protocol (SOAP) Login Event Generator (LEG) software is installed on the Subscriber Manager (SM).

Information About the p3soap Utility

The SOAP LEG contains its own CLU commands, called p3soap, for retrieving information and statistics about the LEG.

The p3soap utility displays the LEG configuration and statistics. The command format is p3soap <operation> [OPTIONS].

Table 30-1 lists the p3soap operations.

--show 

--show-statistics 

--reset-statistics 

--show-version 

--set-username 

--reset-username 

Table 30-2 lists the p3soap user options.

--username=USER-NAME 

-u 

--password=USER-PASSWORD 

-P 

Table 30-3 lists the p3soap miscellaneous options.

--remote=IP[:port] 

-r 

•Viewing the SOAP LEG Status

•Viewing the SOAP LEG Statistics

•Viewing the SOAP LEG Version

•Setting the username and password for Secure Requests

•Resetting the username and password for Secure Requests

Viewing the SOAP LEG Status

The following is an example of using the p3soap CLU with the show operation:

>p3soap --show  
SOAP LEG: 
========= 
Active:   true 
Url:      http://1.1.1.1:8080/services/ProvisioningServiceSoap.asmx 
Username: N/A 
Logging: 
Log all queries:    true 
Log failed queries: true 
Command terminated successfully 
>

Viewing the SOAP LEG Statistics

The following is an example of using the p3soap CLU with the show-statistics operation:

>p3soap --show-statistics  
SOAP LEG statistics 
=================== 
Successful logins:          3 
Failed queries:             1 
Failed package association: 0 
Queries in process:         0 
Max-Concurrent queries:     0 
Command terminated successfully 
>

Viewing the SOAP LEG Version

The following is an example of using the p3soap CLU with the show-version operation:

>p3soap --show-version  
SOAP LEG 3.5.0 Build 490 
Command terminated successfully 
>

Setting the username and password for Secure Requests

The following is an example of using the p3soap CLU with the set-username operation:

>p3soap --set-username --username=cisco --password=cisco  
Command terminated successfully 
>

Resetting the username and password for Secure Requests

The following is an example of using the p3soap CLU with the reset-username operation:

>p3soap --reset-username  
Command terminated successfully 
>