Deploying packaged Web services
This section discusses the resources that are required in order to successfully deploy the Web services platform.
System files
In addition to the Redistributable Runtime Files required by all VAST Platform applications, Web services applications will need to access the resources described below.
(Required for ALL VAST Web services)
abtschem.map -- VAST mapping specification file that is required to parse XML schema definitions
abtxmap.dtd An XML document type definition file that describes the structure of VAST mapping specification files
sstsoenv.xsd - XML schema definitions for SOAP Envelope namespace.
sstsoenv.map -- VAST mapping specification file required to parse SOAP requests into Smalltalk objects
sstsoenc.xsd -- XML schema definitions for SOAP encoding namespace
sstsoenc.map -- VAST mapping specification file required to parse SOAP constructs (ie. SOAP:Array) into Smalltalk objects
sstwsdep.xsd -- XML schema definitions for VAST web service deployment
sstwsdep.map -- VAST mapping specification file required to parse Web service deployment descriptors into Smalltalk objects
sstwsdl.xsd -- XML schema definitions for the WSDL namespace
sstwsdl.map -- VAST mapping specification file required to parse WSDL files into Smalltalk objects
User files
Service-specific files are created and maintained by the service developer. These files are used to customize the behavior of the Web services platform and the services that are managed.
Container deployment descriptor - an XML file that describes the configuration for the Web services container.
Services deployment descriptor - an XML file that describes the resources required for one or more services.
Mapping specification files - XML files that conforms to the supplied DTD named abtxmap.dtd. Mapping specifications contain rules to enable conversion between XML and Smalltalk objects.
WSDL files - The WSDL files that describe the services to be deployed.
Creating runtime deployment descriptor files
If you plan to deploy Web services using image components, it is recommended that you create a separate copy of the service deployment descriptor for runtime usage. The development time deployment descriptor typically must not reference image components, but the runtime deployment descriptor should supply references to required image components.
After copying the deployment descriptor, add any necessary image components to the deployment file as shown below.
<imageComponentUrls>
<imageComponentUrl>wsinsurance.ic</imageComponentUrl>
</imageComponentUrls>
Any image components that are required by multiple services can be specified in the container deployment descriptor.
Modifying the .ini file for the Web services platform image
Prior to starting the Web services platform, make sure that all required system files are resolvable. By default, the XML parser attempts to resolve unqualified resources by checking the image directory. Resources not located in the image directory are assumed to be at the location described by the DefaultResourceQualifier entry of the [Xml] stanza in the application .ini file.
If XML system resources are to be shared among applications running on different machines, it is advisable to place the system files in a common location, and modify the DefaultResourceQualifier to point to that common location. It is also possible to override the absolute path for an unqualified resource by declaring an association in the ini file as shown below.
ie)
[Xml]
DefaultResourceQualifer=http://myfileserver/vastdocs
sstwsdl.map=http://myotherserver/sstwsdl.map
If using image components, make sure that any required system image components are copied along with the image components for your application. The default image component location can be modified in the .ini file stanza as shown below.
[Ic path]
IC_ROOT=j:\ICDirectory
Starting the Web services platform
When starting the Web services leaf IC, use the command line option '-ws:' to specify the location of a container deployment descriptor that is deployed when the image is started.
ie)
nodialog -isstwspfm.ic -lsstwspfm.log -ws:mycontainer.xml
After the sstwspfm.ic leaf image component is started, the container described by mycontainer.xml is created and configured. A walkback.log is created for errors that occur during deployment.
After successfully starting the image, it should be possible to invoke any services that were deployed during container initialization.
Last modified date: 04/11/2022