August 15, 2007 Update/Patch for the following components: 

* XML-Relational Connectors (HTTP, SOAP, File)

This update applies to the 5.0 SP2 version of:
  MetaMatrix Enterprise Server
  MetaMatrix Enterprise Designer 
  MetaMatrix Dimension Designer

The following cases/defects are addressed by this update:
	Case 5884/Defect 24692 Add the abilty to access the XML InputStream.
	Case 5885/Defect 24690 Add the ablilty to provide a HostnameVerifier.

Update Contents:
	p502_070815.jar


Update Instructions - MetaMatrix Server
  1. Launch the MetaMatrix Enterprise Console and connect to the target server.
  2. In the MetaMatrix Console, navigate to Configuration > Integration Server > Extension Modules.
  3. Select p502_070815.jar in the list and click the Import button.
  4. In the Import Extension Module Wizard dialog, browse to the location of p502_070815.jar and select it.
  5. Click Next and follow the remaining prompts to complete the import process.
  6. Identify the connector bindings using the XML-Relational SOAP and/or XML-Relational HTTP connector that you wish to patch.
  7. For each binding:
  	a) stop the binding if it is running
  	b) edit the binding
  	b) update the Connector Class Path binding property adding the following text at the beginning of the classpath:
  		extensionjar:p502_070815.jar;
  	c) save the changes
    d) (re)start the binding

Update Instructions - MetaMatrix Enterprise Designer 
  1. In Model Explorer, select a VDB and open it.
  2. Select the Execute tab at the bottom of the VDB view.
  3. On the Execution Status page, click "Open the configuration manager...".
  4. In the Configuration Manager view, under Extension Modules click "Import an extension jar (.jar)".
  5. Browse to the location of p502_070815.jar file, select it and click Open.
  6. Click OK to acknowledge the file was imported.
  7. Identify the connector bindings using the XML-Relational SOAP and/or XML-Relational HTTP connector that you wish to patch.
  8. For each binding:
  	a) edit the binding by highlighting it on the Execute tab for your VDB and choosing Edit.
  	b) update the Connector Class Path binding property adding the following text at the beginning of the classpath:
  		extensionjar:p502_070815.jar;
  	c) save the changes
  9. Re-execute your VDB to test.
 
Update Instructions - MetaMatrix Dimension Designer 
  1. Select Models->Edit Connector Bindings.
  2. On the Execution Status page, click "Open the configuration manager...".
  3. In the Configuration Manager view, under Extension Modules click "Import an extension jar (.jar)".
  4. Browse to the location of the new p502_070815.jar file, select it and click Open.
  5. Click OK to acknowledge the file was imported.
  6. Identify the connector bindings using the XML-Relational SOAP and/or XML-Relational HTTP connector that you wish to patch.
  7. For each binding:
  	a) edit the binding by highlighting it on the Execute tab for your VDB and choosing Edit.
  	b) update the Connector Class Path binding property adding the following text at the beginning of the classpath:
  		extensionjar:p502_070815.jar;
  	c) save the changes
  8. Re-execute your VDB to test.

Special Instructions for use.

Case 5884/Defect 24692 Add the abilty to access the XML InputStream.

	The XML-Relational File, XML-Relational HTTP, and XML_Relational SOAP Connectors will look in the connector definition 
for a property with the Name of InputStreamFilterClass.  This property does not exist in any of the connector definitions supplied 
by MetaMatrix and must be manually created.  The value for the property must be a fully qualified name of a Java class extending 
the java.io.FilterInputStream class.  The class must provide a constructor with the following signature:
		public <classname>(java.io.InputStream instream, com.metamatrix.data.api.ConnectorLogger logger);

The class shoud be supplied to the connector classpath by adding a jar containing the class as an extension jar and editing the 
connector classpath to include the jar.  If the property is found in the connector definition and the class is found in the 
connector classpath, the class will be loaded and will be inserted before the SAX parser enabling the class to edit the raw 
XML input stream before it is parsed.

Case 5885/Defect 24690 Add the ablilty to provide a HostnameVerifier.
	The XML-Relational HTTP and XML_Relational SOAP Connectors will look in the connector definition for a property with the 
Name of HostnameVerifier.  This property does not exist in any of the connector definitions supplied by MetaMatrix and must be 
manually created.  The value for the property must be a fully qualified name of a Java class implementing the 
javax.net.ssl.HostnameVerifier interface.  The class must have a default parameterless constructor.  The class shoud be supplied 
to the connector classpath by adding a jar containing the class as an extension jar and editing the connector classpath to include 
the jar.  If the property is found in the connector definition and the class is found in the connector classpath, the class will 
be loaded and set as the default HTTP HostnameVerifier for the connector.