Skip to main content

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