Setting up SOAP Web Services

Above and beyond the basic setup tasks required for a language, here are some specific tips to help you get started using TrueSight Server Automation SOAP web services.

Prerequisite assumptions

This topic assumes that you are an experienced developer who:

  • Is already using web services.
  • Has already set up your environment for one of the following programming languages:
    • Java
    • C#
    • Perl
    • Python
    • Ruby
    • Visual Basic

Java setup tips

To use the TrueSight Server Automation SOAP web services, you must download and install Metro 2.2 or later. The Metro 2.2 zip archive is available at https://metro.java.net/2.2/, along with installation instructions.

In addition, you must download JAX-WS version 2.1.10 or later. The JAX-WS 2.1.10 .jar file is available from https://jax-ws.java.net/2.1.10/.

Ruby setup tips

We recommend using Ruby 1.8. You also need rubygems. TrueSight Server Automation - SOAP Web Services includes the following WSDL files:

  • BSAAssumeRoleService.wsdl
  • BSACLITunnelService.wsdl
  • BSALoginService.wsdl
  • BSARESTRequestService.wsdl

Your client uses these files by accessing the TrueSight Server Automation Application Server, as described in Performing-operations-with-SOAP-Web-Services.

Note

Although the WSDL file names start with the BSA prefix, references to services in URLs might not contain the BSA prefix.

  • In a URL that includes the ?= string, the name of the web service includes the BSA prefix (and matches the name of the corresponding .wsdl file).
  • In a URL that does not contain the ?= string, the name of the web service does not include the BSA prefix.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*