Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The local WSDL promotion replaces the current service WSDL and XSD with new files supplied by the user.


Warning

In some cases, depending on the WSDL contents, the old WSEndpointRewritePolicy that is attached to the WS-Proxy can not be used with the new WSDL.
In those cases, the Front-Side Handlers may need to be re-added manually to the WS-Proxy after the WSDL promotion is done.


Initiating a New Validate or Promote Local WSDL Request

Choose either Validate Local WSDL or Promote Local  WSDL from the DevOps Services List to initiate the process

Info
Changing a service with Local WSDL to a remote WSDL or vice versa is not supported

...

After clicking "Execute" the following message appears

DPOD's internal process will monitor and start executing pending requests every one minute.

Validation Flow

  1. DPOD will use a temporary domain on a monitored device that was chosen and created by the admin.
  2. First DPOD will execute a custom user script that will analyze the current service's WSDL and will return all the schema files used by the service
  3. DPOD will download all the WSDL/XSD files of the current service
  4. DPOD will execute a second custom user script to analyze the new WSDL/XSD files and replace all the references in the files so they point to the correct DataPower paths
  5. DPOD will upload the new altered WSDL/XSD files to the temporary domain and create a new service that uses this WSDL
  6. The new temporary service will be created without any front side handlers.
  7. After creating the temporary service, DPOD checks the DataPower's WSDL compilation status.
Info
Messages from the validation steps may return DataPower errors or messages about service with a random name such as DD0396FC-D428-40E8-B64C-913824FD16D4 - this is the name of the temporary service used by DPOD.
The same applies to messages about the WSDL/XSD validation, they will be uploaded to the temporary domain local storage in local:///temp-service-name/ (e.g. local:///DD0396FC-D428-40E8-B64C-913824FD16D4/)

Promotion Flow

  1. DPOD first runs the validation flow and will continue to step 2 only if the validation was successful
  2. DPOD uploads the altered files from the validation steps to the DataPower, and creates any directories if needed.
    Existing files with identical names may be overriden.
  3. DPOD exports the original service
  4. DPOD changes the WSDL address in the export
  5. DPOD imports the original service with the modified WSDL address.
  6. DPOD checks the WSDL status and the service operational state
  7. If the service is not up or the WSDL status is not ok - DPOD tries to rollback the operation by uploading the original WSDL/XSD files to local store and importing the service again with the original unchanged WSDL address

...