NonStop SOAP User's Manual

NonStop SOAP Features and Functions
NonStop SOAP User’s Manual—520501-012
4-21
Dynamic Refresh of the SOAP Server
Dynamic Refresh of the SOAP Server
Dynamic refresh of the Pathway_CGI server means that the SOAP server reads any
changes made to the Service Definition Repository (SDR) without you having to restart
the server. The SDR is a persistent store of the SDL specified by the service provider.
The service provider can alter the SDR at run time and send multicast messages to all
instances of the SOAP server either by running the SOAP Admin tool with a multicast
option, see Explicit Multicast on page 5-7, or implicitly when any changes are made to
the SDR or an associated DDL definition, see Using SoapAdminCL with Implicit
Multicast on page 5-7. The Cache attribute must be set to “yes” when using multicast.
The DDL definitions associated with the SDL entries are also dynamically refreshed as
part of this feature.
The multicast commands are:
•
UPDT_SDR_PW < service name >*
Informs the SOAP server that the specified service names (separated by spaces)
have been added and updated in the SDR.
•
UPDT_NSSOAP_CONFIG < path to soap config file with new
parameters >*.
The SOAP server updates the configuration values specified in the configuration
file ( nssoap.config ) without having to restart the server. See the NonStop SOAP
Configuration File on page 4-60.
On receiving the multicast command, the NonStop SOAP server updates the
configuration values with the values specified in the configuration file. For each
parameter present in the new SOAP config file, the NonStop SOAP server uses
this methodology when updating internal configuration parameters:
•
The existing parameter's value in NonStop SOAP server context is replaced
with the new parameter value (except in case of invalid values)
•
If the new parameter's value is empty (that is "") or if the parameter is not
present, then the existing parameter value in the NonStop SOAP server
context is replaced with the default value for that particular parameter (except
in the case of SOAP_SDLDB_LOC, wherein an error message is displayed).
•
The value of the new parameter undergoes the same validity check defined in
the NonStop SOAP Configuration File on page 4-60. In case of an invalid
value, an error message is displayed.
•
In case of an error, none of the new config file values are used. The NonStop
SOAP server proceeds with the configuration unchanged.
Note. In case of a change in the SOAP_SDL_DBLOC parameter value the
NonStop SOAP server might experience a delay in processing incoming
requests. This occurs because services from the new SDR location might need
to be cached.