Integrating SoftwareAG X-Registry
Appvance and SoftwareAG took the Appvance As A Service concept into reality. A proof of concept (POC) project for adding governance information to SoftwareAG’s X-Registry. In the POC, Appvance IQ monitors a service registered in X-Registry and sends that service's governance results statistics information to the X-Registry governance’s registry system, including current up / down service status, time since the last problem, and average response times. Within X-Registry, the statistics appear as the registered service's metadata.
Introduction
AIQ has the capacity to work as a soap-based Web service known as Appvance As A Service (PAAS). SoftwareAG owns webMethods, a company providing business process integration to the world's largest corporations and government agencies. SoftwareAG publishes X-Registry (formerly WebMethods and Infravio X-Registry). X-Registry is a commercial software product providing registry, repository, and governance essentials for successful company-wide adoption of service-oriented architecture (SOA). The integration of AIQ and X-Registry delivers necessary functions to X-Registry users needing to govern services, by enabling X-Registry to realize the current state of a service and other governance information by adding PAAS to the governance platform. PAAS runs tests to the Web Services registered in X-Registry and stores governance information about the quality of those services. To accomplish this, several architectural and functional issues needed to be resolved:
Who will write the test?
How will PAAS information be accessed?
Who will update the governance repository’s information?
How often must governance information be updated?
How will the security issues be managed?
Does the monitor test only check the system or should it also update the repository information?
Specification of the Appvance IQ / X-Registry Integration
This figure illustrates the implementation of the Proof of Concept.
The following steps demonstrate the integration.
The user adds SendSMS to X-Registry
Start X-Registry
Start SendSMS
Compile SendSMS project
To compile SendSMS, use an ant jar in the SendSMS folder.
In file SendSMS/dist/TOMCAT/bin run startup.sh or startup.cmd according your OS.
Add SendSMS to X-Registry
Log in to the X-Registry system as a provider manager:
Click Add New Service:
Add SendSMS service information. In the POC the service is named SendSMS and the WSDL
is:
http://localhost:8686/SendSMS/ws/SMS?wsdl
where localhost is the name of the system hosting the SendSMS service
Connect to X-Registry
Start PAAS using the command startup.sh or startup.cmd according to your OS. The files are located in the directory TRUNK/AIQ/TestNetwork/TestNode/bin
Start the PAAS test using the command PAASTest.bat or PAASTest.sh according to your OS. The files are located in the folder TRUNK/SendSMS
The program will connect to X-Registry
Connect to PAAS
The program PAASTest will connect to both systems using web services:
PAAS check SendSMS Status
PAAS system will periodically check the Service SendSMS by a user-specified time; for POC this time is 2 minutes
If the SendSMS test works, the system will state there were no errors
If the service is not running or is not working as expected, PAAS will state the test failed with the reason for the failure
Get GSRS information from PAAS
The PAAS test will automatically get historical service information from PAAS
The service information is XML data known as GSRS (Governance Statistics ResultSet)
The GSRS is known as Appvance-Governance and the document Appvance_Governance.pdf describes its specification and design
This is a sample GSRS for a correctly running service:
Update SendSMS information
PAAS will send the GSRS to X-Registry. Currently, it is posted in the description place, but being restricted to 255 characters is a problem. The future plan is to have the GSRS file added as a separate file and a new field added to indicate the service status
This figure shows a POC display of a service running as expected:
This figure shows a POC display of service not running as expected:
The preceding steps demonstrated how Appvance IQ monitors a service registered in X-Registry and sends service Governing SOA Through Test Automation information, to X-Registry governance registry system, such as current up / down service status, time since the last problem, and average response times as well as how X-registry stores and displays registered service information as metadata.
Further information can be found at:
X-Registry description (Adobe Acrobat PDF format)
WebMethods
Last updated: July 28, 2023
If you have any feedback on this topic, please contact us at documentation@appvance.ai