Disabling WS-Resource and WS-Addressing in Verastream Host Integrator

  • 7021336
  • 13-Oct-2011
  • 11-Mar-2018

Environment

Verastream Host Integrator version 7.1 or higher

Situation

Beginning in Verastream Host Integrator (VHI) version 7.1, WS-Resource (Web Services Resource 1.2 Framework) can be disabled for compatibility with technologies that do not use this standard.

Resolution

To disable WS-Resource in the VHI web services SOAP stack, the steps vary by product version.

Version 7.5.1030 (7.5 Service Pack 1) or Higher

WS-Resource and WS-Addressing are already disabled by default. (If your SOAP client supports these standards, they can be enabled on a server-, model-, or pool-basis as described in the next section, or in a deployment descriptor’s model or pool configuration ws-config section.)

Version 7.1.1142 (7.1 Service Pack 1) through 7.5.70 (7.5 Original Release)

In Administrative Console, unselect the option "Enable WS-Resource and WS-Addressing." This option can be set globally (in Session Server Properties), on a non-pooled model-specific basis (in Model Properties), or on a pool-specific basis (in Pool Properties). In the Properties dialog left pane, click the Web Services category.

Figure 1. Administrative Console: Session Server Properties dialog > Web Services category

Version 7.1.221 (7.1 Original Release)

Complete the following steps:

  1. Edit the service-ctx.xml file, typically located in C:\Program Files (x86)\Attachmate\Verastream\HostIntegrator\sesssrvr\services\ws\META-INF (on Windows) or /opt/attachmate/verastream/hostintegrator/lib/container/services/ws/META-INF (on UNIX).
  2. Uncomment the wsResourceEnabled property (by removing the “!--“ and “--“ characters) and change its value to false as shown below:
                <!-- Enables WS-Resource features. -->
                <property name="wsResourceEnabled" value="false"/>

  1. After saving changes to the service-ctx.xml file, you must restart the session server service for changes to take effect. For information about manually restarting the service, see KB 7021352.

Note: When you upgrade to a later version (hotfix or major release) in the future, this setting is not retained.

Potential Impacts of Disabling WS-Resource

Be aware of the following:

  • After disabling WS-Resource, if you use stateful web service operation (multiple SOAP client calls using the same host session), the SessionId environment variable parameter must be passed in the data payload (in-band support) instead of using the standard WS-Resource mechanism (wsResourceCreate returns a SessionID, which is used in the header of subsequent web method requests with wsa:isReferenceParameter="true" until wsResourceDestroy releases the session).
  • Disabling WS-Resource also disables WS-Addressing.

Additional Information

Legacy KB ID

This article was originally published as Attachmate Technical Note 10130.