IBM Support

Late breaking updates to DataPower 7.2 documentation

News


Abstract

The version 7.2 documentation for IBM DataPower Gateway is not the latest available information. This document covers late breaking updates that are not in IBM Knowledge Center.

Last updated, October 2017.

Content

The late breaking updates in this document apply to DataPower version 7.2 documentation.



To access specific updates, click the appropriate link:

To view the change history of this document, see Change history

The corrections in the following sections apply to DataPower version 7.2 in IBM Knowledge Center.




Installation
    The command to troubleshoot power supplies states to use show other-sensors. The correct command is show sensors-other. This problem exists also exists in the available PDF versions of the installation documentation.






Administration
    When you shut down the appliance and the mode is halt, the documentation incorrectly states that the appliance, by default, restarts after 20 minutes. When you run this action or use the shutdown halt command, the appliance shuts down but the power to the appliance remains on.


    The use of an LDAP connection pool does not apply to RBM or the CRL update policy.







Virtual Edition
    When you define the address from the ILMT server, you must specify the IP address, not the DNS host name, of this server.






Document processing
    The return expired documents property of the document cache indicates whether to return expired, or stale, content. To return expired content, the client request must indicate that it is acceptable to receive a stale resource by using the Cache-Control max-stale directive as defined in RFC 7234 section 5.2.1.2.






Security
    The documentation does not have the new details for the support of SHA-256 as the hash algorithm, or digest, when you generate an RSA key.






Threat protection
    The documentation for the ignore option of the forbid-external-references command is incorrect. The documentation incorrectly states that this option "ignores external DTD references, and replaces external entities with the empty string". However, the correct information for this option is "accesses and resolves external references, but replaces each for further processing with an empty string."

    The forbid-external-references command and its peer XML External Reference Handling property are part of the configuration of parser limits for an XML manager and as an override to this setting in the configuration for a Multi-Protocol Gateway, Web Service Proxy, or XML Firewall service.






GatewayScript
    The documentation is missing for the following APIs. To view the documentation, follow the link.
    In 7.2.0.1 you can use the new options options with the urlopen.open function. The format of this attribute is as follows. By default, DataPower services attempt to resolve HTTP redirects. Specify this option when you want to prevent the resolution of HTTP redirects.
      options: ' donot-follow-redirect '

    In 7.2.0.5 you can use the APIs in GatewayScript json-xml-converter module to covert between JSON and XML objects. Click the previous link to view the 7.5.0 documentation in IBM Knowledge Center.






Extension elements and functions
    In 7.2.0.1 you can use the new options attribute with the url-open extension element. The format of this attribute is as follows. By default, DataPower services attempt to resolve HTTP redirects. Specify this option when you want to prevent the resolution of HTTP redirects.
      options=" donot-follow-redirect"






Variables





Status providers
    The RAID Physical Drive Status added Failure and Temperature data. The information is in the GUI on-line help, but not part of the show raid-physical-drive command.
      Failure - Indicates whether there is a hard disk failure. If Yes, replace this drive as soon as possible to avoid possible data loss.
      Temperature - The temperature of the hard disk drive.






File management
    The documentation provides inconsistent information about which directories of the DataPower Gateway you create and delete subdirectories. You can create and remove subdirectories in the following directories.
    • isamwebroot
    • local
    • policyframework






Monitors
    The documentation for the Message Filter Action type command incorrect states the block keyword instead of the shape keyword. For correct information see type command.





Change history
Last modified: 30 October 2017.
  • 30 October 2017: Added information about nonexisting block keyword for Message Filter Action type command.
  • 19 October 2017: Added information about which directories you can create and remove subdirectories.
  • 19 July 2016: Added data about the wrong command troubleshooting command in the installation documentation.
  • 22 March 2016: Added statement and links for new variables and GatewayScript module added in 7.2.0.5.
  • 16 March 2016: Added correction for XML external reference handling.
  • 19 January 2016: Clarified when the document cache can return and expired or stale document.
  • 12 January 2016: Added details about the donot-follow-redirect option for the XSLT url-open extension element and the GatewayScript urlopen.open function.
  • 25 August 2015: Added correction to ILMT server specification and use of LDAP connection pool.
  • 19 June 2015: Created for 7.2.

Document information

More support for: IBM DataPower Gateways
General

Software version: 7.2

Operating system(s): Firmware

Software edition: Edition Independent

Reference #: 1882643

Modified date: 30 October 2017