IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > FTP > Troubleshooting and support
Frequently Asked Questions
Answers to a set of frequently asked questions about WebSphere Adapter for FTP.
- How to configure a local event directory and a sequence file in a clustered environment?
- How to make the file listing of FTP sever (ls –l) compatible with the adapter?
- What are the pre-requisites for the adapter to work properly?
- How to check for access permissions in an output, remote event, or remote archive directory?
- What is HA Active-Active and Active-Passive configuration?
How to configure a local event directory and a sequence file in a clustered environment?
- In a clustered environment, the local event directory and the sequence file must be configured in a mapped drive so that it is accessible by all nodes in the cluster.
- The user must have the write and read permission for the local event directory and the sequence files.
How to make the file listing of FTP sever (ls –l) compatible with the adapter?
Ensure that the FTP server is set to provide responses in UNIX format so that the adapter can parse them.
What are the pre-requisites for the adapter to work properly?
For the adapter to communicate with the FTP server and work properly, ensure the following settings are configured.
- FTP server must be set to provide responses in UNIX format so that the adapter can parse the response.
- Adapter must have the right access permissions (read, write, and execute) to access the output directory, remote event directory, and remote archive directory on the FTP server. For more information about how to verify the access permission, refer How to check for access permissions in an output, remote event, or remote archive directory?.
- While configuring the adapter to work with an SFTP server running on a non-standard port (other than port number 22), the host key must be in the following format in the host key file.
[Hostname]:Portnumber hostkeyentry
How to check for access permissions in an output, remote event, or remote archive directory?
To check if the userID that the adapter uses has the right access permissions to access the FTP server, the adapter performs the following actions:
- Check for the existence of the directories by using the following command:
cd <path>- Go to parent directory using the command:
cd..- Check for the permissions of the particular directory using the following command:
ls –lThe directory must have the read permissions. The ls –l listing must conform to UNIX type listing. The event directory listed should show up in the listing with the correct permissions.
- Go to the target directory using the following command:
Cd <target directory>- Check for permissions of the files to be processed using the following command:
ls –lThe directory must have the read and write permissions.
What is HA Active-Active and Active-Passive configuration?
WebSphere adapter supports High Availability (HA) Active-Active configuration during inbound processing in a clustered environment.
An HA Active-Active configuration,
- Enables all adapter instances deployed in a clustered environment to be active and each instance is allowed to process the events independently.
- Enables distribution of events to be processed between the available instances without any duplicate events being delivered to the endpoint.
- Improves the overall event handling performance in a clustered environment.
In a HA Active-Passive configuration,
- Only one of the adapter instances starts polling for events.
- Other adapter instances in the cluster are started, but they remain dormant with respect to the active event until the active adapter instance finishes processing the event.
- If the server on which the polling thread was started shuts down for some reason, an adapter instance that is running on one of the backup servers is activated.