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 > Flat Files > Troubleshooting and support
Frequently Asked Questions
This section provides you with answers to common questions about WebSphere Adapter for Flat Files.
- How to configure a local event directory and a sequence file in a clustered environment?
- Does WebSphere Adapter for Flat Files provide exclusive locking to files that are processed by the adapter?
- How to check for access permissions in an output, remote event, or remote archive directory in the UNIX environment?
- What is HA Active-Active and Active-Passive configuration?
- How to replace the adapter RAR file?
- Does WebSphere Adapter for Flat Files support the staging directory with the generateUniqueFile option?
How to configure a local event directory and a sequence file in a clustered environment?
The local event directory and the sequence file must be configured in a mapped drive to make it accessible by all nodes in the cluster. The user must have read and write permissions to the local event directory and the sequence files.
Does WebSphere Adapter for Flat Files provide exclusive locking to files that are processed by the adapter?
No. The WebSphere Adapter for Flat Files does not have exclusive access to the files that are being processed. The process of locking or lack of locking on the files is dependent on the operating system.
How to check for access permissions in an output, remote event, or remote archive directory in the UNIX environment?
To check if the user ID that the adapter uses has the right access permissions to access a server in the UNIX environment, the adapter performs the following actions:
- Check for the existence of the directories by using the following command:
cd <path>- Go to parent directory by using the command:
cd..- Check for the permissions of the particular directory by 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 shows up in the listing with the correct permissions.
- Go to the target directory by using the following command:
Cd <target directory>- Check for permissions of the files to be processed by 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 for Flat Files 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 in a dormant state with respect to the active instance till the active instance is processing the events.
- If the active instance of the adapter shuts down for some reason, one of the standby instances in the cluster is made the active one.
How to replace the adapter RAR file?
The WebSphere Adapter for Flat Files RAR files can be replaced on the server side by using the Process Administrative Console. The RAR file can be either a fix or a new version of the adapter. The following link contains a video with details about the process http://publib.boulder.ibm.com/infocenter/ieduasst/v1r1m0/index.jsp?topic=/com.ibm.iea.wa_v7/wa/7.0/Overview/WBPMV70_IEA_Adapters_InstallRarOnServer/wbpmv70_iea_adapters_installraronserver_viewlet_swf.html.
Does WebSphere Adapter for Flat Files support the staging directory with the generateUniqueFile option?
The combination of generateUniqueFile option and staging directory is not a supported combination. Ensure that staging directory is not specified, if you select the generateUniqueFile option.