ZXTM Control API Overview and Reference 

Version 4.0

3.2.2  Snooping the SOAP traffic 

Your ZXTM Control API application will send SOAP requests to the ZXTM 

Admin server, which typically listens using SSL on port 9090.  If your 

SOAP toolkit does not support debugging or tracing, you can use a 

network snooping tool such as Ethereal

7

 to inspect the SOAP request and 

response, to verify that the request is sent correctly, and that the 

response does not contain any errors messages that are not reported by 

your application's interface code. 

Of course, if your SOAP transaction is encrypted with SSL, it will not be 

easy to inspect it: 

1.  Disable SSL on the ZXTM Admin Server as follows: 

a.  Edit the file ZEUSHOME/admin/website, and comment out the 

line `security!enabled yes' by prefixing it with a `#': 

#security!enabled yes 

b.  Restart the ZXTM software

8

: 

# /usr/local/zeus/restart zeus 

2.  Modify your ZXTM Control API application to use an `http://' url 

rather than an `https://' one. 

3.3  Debugging with Perl 

3.3.1  Problems with WSDL interfaces 

Because Perl's SOAP::Lite does not make explicit reference to the WSDL 

interface specification, it can be easy to make errors which are only 

detected at run time. 

Ensure that the URI in the SOAP::Lite objects you construct in your 

application is correct.  Refer to the URI tables in chapter 4. 

7

http://www.ethereal.com/

  Ethereal

TM

 is available for all major platforms, 

including Windows and Linux. 

8

 Alternatively, you can restart just the admin server component as follows: 

# export ZEUSHOME=/usr/local/zeus 

 # 

$ZEUSHOME/admin/rc restart 

  Set ZEUSHOME to the correct installation directory for your configuration. 

46