BETA ONLY: products are not yet available.

All GroupWyse software products are currently in a 'beta' development program and are not yet available. The content below is likely to change, and product availablilty has yet to be determined.  Some download links are currently unavailable.

Extending PVProxy

What's the Purpose?

Downloading and installing PVProxy allows you to test targets that are visible in the context of the proxy using ICMP pings and TCP port probes.  But what if you want to test that your database server is fully functional?  Or if you want to check if there is sufficient disk space on a vital hard drive?

A PVProxy extension module can do those things and more.  In essence, an extension is merely a name, such as 'db_ok', that you give to a test.  Then you use the instructions below to add the details of your test to either the Windows or Mac OS X version of the proxy, as desired.

Because the two platforms are so distinct, the internal details of creating an extension are different.

Technical Information

As stated above, a PVProxy extension is a simple name which when sent as part of a URL to an extended PVProxy (along with the hostname and port numbers), invokes code that you have written.  The results of your test are packaged and returned to the initiating iPhone automatically.

Please set the technical details page for more information on the interaction between ProbeView and PVProxy.

To understand the interaction between PVProxy, PingView and ProbeView, see the page "Understanding Collection Storage".

Extending Windows PVProxy

On Windows, PVProxy is a .Net 4.0 application written in C#.  An extension is a user-supplied .Net assembly (DLL) that the proxy server loads at run-time.  Any number of extensions can be packaged into a single extension, if desired.

To learn how extend the Windows version, download the document "Extending PVProxy" and the sample extension project DemoExtension.  The Windows version of PVProxy has a special 'client test' form that allows you to generate a test URL, send it to the proxy of your choice, and then view and parse the results.

The DemoExtension source code defines two extensions.  The first replies with a simple 'ack' response and is only for testing.  The other executes arbitrary Windows batch files and returns the result code to ProbeView.   In other words, it can be used to execute any standard Windows script.  These sources are for demonstration purposes only-- please do not expose them to the open internet unless you have a precise reason.

Extending Mac OS X PVProxy

On Mac OS X, PVProxy is an Objective-C Cocoa application.  To add an extension, you will need to download and build your own version of PVProxy from the sources, which are available from the link below.   Then read the document "Extending PVProxy" and add the source files for your extensions to the proxy server project.

To build PVProxy you will need the XCode 3.2+ development tools package, which is available from Apple for registered Apple developers.

Click here to download the compressed PVProxy XCode project.

Click here to download the OSX executable for PVProxy.

Testing Your Extensions

As explained in the extensions documentation, you can test your extension using any web browser.  You can also test your extension with the 'client' form of the Windows version of PVProxy.

Copyright ® GroupWyse Consulting, 2010-2017
All Rights Reserved