IBM WebSphere Adapter for FTP, version 7.0.0.4 notes

This document contains the following sections:
Enhancements and fixes
New and modified connector properties
Upgrade notes

This table lists the enhancements and fixes in fix pack version 7.0.0.4.
Enhancements
#CRAPARTitleDetails
1102647FTP Adapter should support commands chmod,chgrp,chown in script files for SFTP protocol
Symptom: FTP adapter does not support chmod,chgrp,chown commands in ExecuteFTPScript operation for SFTP protocol.
Resolution: FTP Adapter now supports these commands with SFTP protocol.
2103405FTP Adapter throws exception while performing list operation on an empty directory on SFTP server
Symptom: FTP adapter throws exception while performing list operation on an empty directory with certain SFTP servers.
Resolution: The problem occurs due to the JSch thirdparty library used to provided SFTP functionality. The issue is fixed in JSch 0.1.42 version. The Adapter now ships JSch v0.1.42.
3103409Enhance generate unique file feature to accept the user input for file prefix string and extension for the file
Symptom: The FTP Adapter currently creates unique files based on the "STOU" FTP command. If the "STOU" command is not supported by the FTP server, Adapter creates file starting with prefix "FTP" followed by a random number. The user does not have an option to configure the prefix string or a suffix for the unique file that is generated.
Resolution: With this feature, User can specify the prefix and suffix strings for the unique file. These properties can be set through the External Service wizard at Interaction Specification properties. If no values are provided for both these properties, the Adapter creates an unique file using the previous behaviour.
4102367FTP Adapter should support outbound and Inbound operations when the user is locked by the FTP server
Symptom: FTP adapter throws exception while checking for the permission of the output directory when user is locked in home directory. The user is not allowed to execute commands like CDUP and throws InvalidPropertyException.
Resolution: An option is provided in EMD to disable the checking for permission of output directory. When the property is unchecked, the Adapter does not check for the permissions of the directory before performing the operation. When the property is enabled, ensure that the listing permission is available on the parent directory to perform the permission check.
5103295FTP Adapter should support both public key and password authentication simultaneously with SFTP protocol
Symptom: SFTP servers like WinSSHd server provides options to authenticate users using both password and public key authentication. FTP Adapter does not support using both public key and password authentication simultaneously for authentication with SFTP protocol.
Resolution: FTP Adapter now supports providing both public key and password authentication to be used simultaneously for authentication with SFTP servers.
Fixes
#CRAPARTitleDetails
110340337394FTP Adapter throws NullPointerException when the content dataobject is not populated
Symptom: FTP adapter throws NullPointerException in FTPFileBaseDataBinding if the content dataobject in the request dataobject is not populated.
Resolution: Adapter now works fine when the content dataobject is not populated.
2103404JR37891When FilePassByReference=true,file was mistaken when failover occur
Symptom: When FilePassByReference is set to true, and if a fail over occurs, FTP adapter recovers the incorrect file from the archive directory if files in the archive directory have the same name.
Resolution: The issue has been resolved now. It archives the latest file from the archive directory if a failover occurs.
3103086JR39001FTP Adapter throws RecordNotFoundException when connection to the SFTP server is closed
Symptom: If the connection to the SFTP server is closed during an outbound request, the next request fails with a RecordNotFoundException.
Resolution: The FTP Adapter is fixed to throw appropriate exception if the connection to the SFTP server is closed during an outbound request.
4103407JR38131FTP Adapter does not return any warning message when user populates an inbound property like FTPServerHostName during an outbound request
Symptom: When user populates an inbound property like FTPServerHostName during an outbound operation request, there should be a warning message to the user.
Resolution: With the fix, the FTP Adapter now returns INFO level message to the user indicating that such property values will be ignored when set for an outbound operation.
5103408JR38702The files created by FTP Adapter using sequence file log on a clustered environment are not in a sequence
Symptom: When two Adapter instances are used in a clustered environment using the same sequence file, the files created are out of sequence. The RandomAccessFile API and file level locking on RedHat Linux are causing the issue.
Resolution: DataInputStream and DataOutputStream are used read/write data into the sequence file. Also, a lock file is created when an Adapter instance is accessing the sequence file for read/write.
6103381JR39530FTP Adapter incorrectly parses the file with space in file name when Custom parser class is set to FTPLongListEntryParser
Symptom: FTP Adapter Outbound list and exists operations fails when the Custom parser class is set to FTPLongListEntryParser and the file contains spaces in the filename.
Resolution: The issue occured due to the incorrect parsing of the file listing usign the FTPLongListEntryParser. The FTPLongListEntryParser is now fixed to parse the filenames correctly.
7102613JR38019Enable JCA timer capability for inbound polling
Symptom: Adapter uses a polling thread in the runtime, which will poll as per the pollperiod. The polling thread will be only submitted once and always being in the runtime environment. When there are no events for a longer duration, the polling thread will be hung and throws a warning message from the JCA container.
Resolution: Use JCA timer to schedule the polling thread, so the polling thread would be submitted according to the JCA scheduler, which will solve the thread hang issue.
8103162JR39129Duplicate messages are created in the event table by FTP Adapter due to unexpected database outage.
Symptom: During Adapter Inbound operation, after several unplanned database outages during event processing duplicate messages can be observed. This is due to the fact that the event is delivered but the overall transaction is marked failure and no rollback is called by the transaction manager.
Resolution: If the event is already delivered to the downstream components but the overall transaction is marked failure due to issues in downstream component, the event is deleted if no rollback is issued.


This table lists the enhancements and fixes in fix pack version 7.0.0.3.
Enhancements
#CRAPARTitleDetails
There are no enhancements in this fix pack.
Fixes
#CRAPARTitleDetails
178095Remove the support for SeverToServer operation with FTPS protocol.
Symptom: Null pointer exception was being thrown when ftps or sftp protocol for ServerToSeverFileTransfer operation.
Resolution: The issue has been resolved.It now throws InvalidPropertyException.
2101458Error message need to remove the reference to ftps:// sftp:// support during ServerToServer operation.
Symptom: Incorrect exception message throw when SecondServerDirectory value is incorrectly set on the wrapper.
Resolution: The exception message has been corrected.
3101036The word "properties" has not been translated for RootNameFunctionSelector option while running external service wizard.
Symptom: The word "properties" is not translated for RootNameFunctionSelector option.
Resolution: This has been fixed so that the messages appears correctly for different languages.
4101025The word "Advanced" is not translated in the helper message displayed when Truststore properties are not provided.
Symptom: The word "Advanced" is not translated in the helper message displayed when Truststore properties are not provided.
Resolution: This has been fixed so that the messages appears correctly for different languages.


This table lists the enhancements and fixes in fix pack version 7.0.0.1.
Enhancements
#CRAPARTitleDetails
There are no enhancements in this fix pack.
Fixes
#CRAPARTitleDetails
199888When adapter gets ARM transaction factory name to process ARM transaction a WAS internal private API is being used. It should be replaced with public interfaces.
Symptom: When adapter gets ARM transaction factory name to process ARM transaction a WAS internal private API is being used. It should be replaced with public interfaces.
Resolution: Switched to Invoke PmiRmJmxService MBean, a set of public interfaces exposed by WAS to get ARM transaction fatory name.
2100356Adapter throws NullPointerException when working with two or more modules with the sme business obeject name but different namespace and structure.
Symptom: When adapter creates 2 or more different modules with BO having same name but different namespace and structure, inbound and outbound operations of those modules will throw NullPointerException.
Resolution: Redefined the methods of "hashCode()" and "equals()" in the SDOV1Type class. Then individual adapter can distinguish those BO correctly by "namespace + name" if those BOs name are equal.
3100406When an application is restarted with Adapter deployed in standalone mode, Adapter throws NullPointerException when querying the ASI information from the cache.
Symptom: For Adapter inbound and outbound operation(standalone deployment), after the application is restarted, the NullPointerException will appear when the adapter tries to query the ASI from cache.
Resolution: The Business Object's namespace and name has been preserved as Business Object instance's fields. After the application is restarted, adapter can still get them from those instance's field rather than the stale data cache.
4100418The description of RootNameFunctionSelector is missing from EMD.properties file causing an exception when getting the display name in External service wizard.
Symptom: The description of RootNameFunctionSelector is missing from EMD.properties file causing an exception when getting the display name in External service wizard.
Resolution: The description for the RootNameFunctionSelector property in EMD.properties file has been added.
5100567Adapter throws a FFDC with NumberFormatException during Inbound when splitting is not enabled.
Symptom: Adapter throws a FFDC with NumberFormatException during Inbound when splitting is not enabled.
Resolution: The Adapter doesnt throw any FFDC when the splitting is not enabled in Inbound.
677930Printing out the AdapterFoundationClasses version in the Logs/traces.
Symptom: Currently with all the adapters , The AFC version is not printed out in the logs/traces. It would be really helpful to have this information printed out to the logs/traces especially in debugging issues due to conflicting AFC being loaded at runtime.
Resolution: Print AFC version in the trace
7100676FTP Adapter throws IOException during Create operation
Symptom: FTP adapter throws IOException during create operation when both "FileInLocalDirectory" and "LocalArchiveforCreate" properties are enabled.
Resolution: The Adapter now performs the create operation successfully. The Adapter handles the closing of the InputStream after the successful read operation.


This table lists new connector properties
#VersionPlatformAdd or RemoveProperty (Note that property names are case sensitive)
1 7.0.0.4 All Property added for outbound create operation to generate unique file with suitable prefix. uniqueFilePrefix
2 7.0.0.4 All Property added for outbound create operation to generate unique file with suitable suffix. uniqueFileSuffix
3 7.0.0.4 All Property added to disable to check for permission of output directory during request. isPermissionCheckEnabled


To upgrade to the fix pack version 7.0.0.4, do the following:
1. Ensure you have followed the 'Installation Instructions' section in the download link before proceeding further.
2. If you need to use the Fix Pack for EMD, delete the connector project in the WID, import the new rar and apply the EIS specific dependency files. The following steps describe how to do the same.
   a. Open the Java Build Path for the SCA module and remove the Connector project selected on projects tab.
   b. Open the dependency editor and remove the connector project.
   c. Delete the connector project from workspace.
   d. Import the new rar file. Add any dependency files from EIS specific APIs as needed.
   e. Open Java build path for the SCA module and select the Connector project selected on projects tab.
   f. Open the dependency editor and add the connector project if it is not already present and check "Deploy with Module".
3. If you need to update deployed applications on the WPS.
   a. Select "Update" for the corresponding application on the WPS Admin Console.
   b. Select "Single Module" with relative path as name of the rar file - CWYFT_FTPFile.rar.
   c. Click the "Browse" button on local file system to select the updated rar file that has the changes.
   d. Select the default values in the remaining steps and click 'Finish'. This will ensure that existing configurations e.g. MCF, are not changed and jars will be merely updated.


July 08th, 2011 6:00 PM
(C) 2011 IBM Corporation. Proprietary and Confidential. All Rights Reserved.