This article presents an alternative approach to the document Tech Tip: Using the SOAP Control API with Ruby. An alternative method for using Riverbed's Control api with Ruby is to use the soap4r SOAP implementation. This may be found at http://dev.ctor.org/soap4r. Note: At the time of writing the use of soap4r depends on the 'httpclient' Ruby library, formerly known as 'http-access2'. Getting started The first thing you have to do is obtain the published specification for Stingray's API. You can download this from the product's admin interface, Diagnose > Technical Support, clicking "Control API WSDL Files". Extract this zip file to get the WSDL files we are looking for. Soap4r comes with a tool 'wsdl2ruby.rb' which will take our WSDL files and produce Ruby files which we can import into our scripts. T he invocation you will use will look something like this: $ wsdl2ruby.rb --wsdl VirtualServer.wsdl --type client ... to create the following files: VirtualServerClient.rb VirtualServerDriver.rb VirtualServerMappingRegistry.rb Once this is done you can include these in the programs or scripts you write. The important difference here, from our previous Ruby example, is that we no longer have to define every function that we intend to use and the arguments it expects. Here is the analogous listing enabled virtual servers example using soap4r: #!/usr/local/bin/ruby require "VirtualServerDriver.rb" require "VirtualServer.rb" endpoint = "https://zxtm:9090/soap" username = "admin" pass = "somepass" driver = VirtualServerPort.new(endpoint) driver.options["protocol.http.ssl_config.verify_mode"] = OpenSSL::SSL::VERIFY_NONE driver.options["protocol.http.basic_auth"] << [endpoint,username,pass] vslist = driver.getVirtualServerNames enabled = driver.getEnabled(vslist) vslist.length.times do |i|    if enabled       puts vslist    end end Read more Collected Tech Tips: SOAP Control API examples ... View more

Scala, Stingray Traffic Manager and Java Extensions (06/30/2009) There has been a lot of talk over the past few years about new and different languages targeting the JVM as their runtime platform. Scala has been one of the most high-profile languages in the JVM vanguard. Most notably, in the past year Twitter has announced that it is migrating away from Ruby on Rails to Scala because of RoR's lack of scalability. Scala is a neat hybrid language which is both object oriented and functional. Its best aspect is that you can utilize all of the standard Java libraries without writing any Java code. Check out http://www.scala-lang.org/  for more information on the language itself, as I'm just going to talk about how to get a simple 'Hello World' example working with Stingray. Why is it possible for us to use Scala in place of Java with Stingray? Well, since Scala targets the JVM we can just import the compiled class files into Stingray and they are recognized in the same way as any Java class file. The only extra step we need to take is to import the Scala libraries into Stingray, so that they are available to the same Java runtime. This additional file, scala-library.jar, can be found in your Scala distribution and all you have to do is upload it to Stingray using the Java Extensions Catalog. If you want more information on Java Extensions in Stingray, then have a look at the related articles Introducing Java Extensions and "Hello, World!" Java Extension. Ok, let's look at a simple hello world example in Scala. import javax.servlet.http._; import com.zeus.ZXTMServlet._; class MyServlet extends HttpServlet {    override def doGet(zreq: HttpServletRequest, zres: HttpServletResponse)    {       zres.setContentType("text/html");       var out = zres.getWriter();       out.println("Hello World");    } } Quite simple and no magic, we just extend an HttpServlet as we would using Java and act on the Response object providing some content. Put this in a file MyServlet.scala and compiling is just a matter of invoking the Scala compiler. > scalac MyServlet.scala This will produce a class file, MyServlet.class, which you will need to upload to Stingray. Stingray looks at class files and determines which can be called via TrafficScript, creating stub TrafficScript rules as necessary. Attach this new rule to the HTTP VirtualServer of your choosing as a request rule and see your Scala code in action. Now you are all set to work with Scala in Stingray! UPDATE: Incorporated changes suggested by James Iry. ... View more

(Originally posted Aug 19 2009) Accessing Zeus' Control API from Scala is a relatively straightforward process. It is almost identical to the process you use for Java. Currently the best way to access the control API is using the Apache axis library which you can obtain here . You will also need the WSDL files describing the API. To download the WSDL files go to the Zeus Admin Server then to the online help, and look for the "Zeus Control API WSDL Files" link on the 'Manuals' page. One final dependency that needs to be satisfied is that we need the javamail package, which can be found here . Once you have downloaded and extracted these files we need to convert the WSDL files to Java code, compile them and package them up. On a Unix system you need to issue these commands, > for F in wsdl/.wsdl ; do java –cp :axis-1_4/lib/:javamail-1.4.1/lib/* \ org.apache.axis.wsdl.WSDL2Java $F ; done mkdir obj javac –d obj com/zeus/soap/zxtm//.java cd obj jar cf ZXTM-API.jar com/zeus This will produce ZXTM-API.jar which you will need to add to your classpath. We are ready to write a Scala program to list the running Virtual Servers. This mirrors our Java example quite closely which you can look at <a href="http://www.zeus.com/community/code-samples/list-running-virtual-servers-using-scala#" target=_blank>here</a>.</p> listVS.scala import com.zeus.soap.zxtm._1_0._; import java.security.Security; import java.security.KeyStore; import java.security.Provider; import java.security.cert.X509Certificate; import javax.net.ssl.ManagerFactoryParameters; import javax.net.ssl.TrustManager; import javax.net.ssl.TrustManagerFactorySpi; import javax.net.ssl.X509TrustManager; objectVSList{ def main(args:Array[String]){ Security.addProvider(newMyProvider) Security.setProperty("ssl.TrustManagerFactory.algorithm", "TrustAllCertificates") val vsl =newVirtualServerLocator vsl.setVirtualServerPortEndpointAddress( "https://user:[email protected]:9090/soap") val port = vsl.getVirtualServerPort val vs_names = port.getVirtualServerNames val enabled_vs = port.getEnabled( vs_names ) for( i <-0until vs_names.length ) if( enabled_vs(i)) println(vs_names(i)) } } // Below is TrustManager boiler-plate objectMyTrustManagerFactoryextendsTrustManagerFactorySpi{ overridedef engineInit(keystore:KeyStore){} overridedef engineInit(mgrparams:ManagerFactoryParameters){} overridedef engineGetTrustManagers ={ Array[TrustManager](newMyX509TrustManager) } } classMyX509TrustManagerextends X509TrustManager { overridedef checkClientTrusted(chain:Array[X509Certificate], authType:String){} overridedef checkServerTrusted(chain:Array[X509Certificate], authType:String){} overridedef getAcceptedIssuers :Array[X509Certificate]=null } classMyProviderextendsProvider("MyProvider",1.0,"Trust certificates"){ put("TrustManagerFactory.TrustAllCertificates", MyTrustManagerFactory.getClass.getName ) } Running the example is pretty simple, first compile it, > scalac -classpath ZXTM-API.jar listVS.scala then run it, > scala -classpath ZXTM-API.jar listVS Main website Mail servers Test site ... View more