FAQ note for initiating Support related to ISpeak Adapters
1) How do I enable and increase the trace levels for RNIF 2.0, RNIF 1.1 and CIDX Adapters in separate files other than defaultTrace file in order to send them to development support for further analysis?.
Follow the below steps:
i. Login to Visual Administrator tool.The path is usrsap<server_ID>JC<server_instance>j2eeadmingo.bat under windows and /usr/sap/<server_ID>/JC<server_instance>/j2ee/admin/ go.sh under UNIX.
ii. Expand Server available in the cluster list by double clicking on it.
iii. Expand Kernel and choose LogManager.
iv. Change the values of property 'ForceSingleTraceFile' to 'NO' and
'SingleTraceFile_UnrestrictedLocations' to 'service_com.sap.aii.af.ispeak.svc_ISpeakAdapterTrace' and save the settings.
v. Re-boot the server node and wait for it to re-start.For this, go to Visual Admin and right click on server (available under the cluster list) and select the reboot option.
vi. Login to Visual admin tool again.
vii. Expand Services under server instance and select Log Configurator from the list.
viii. Select the Locations tab in Log Configurator.
ix. Click on the button To advanced mode at the top.
x. Double click on Root Location (Severity = Error) available in Log Controllers list.
xi. Expand com -> sap -> ai -> adapter -> cidx
xii Repeat the following steps for the following also .
a)com-> sap-> aii -> adapter -> rnif->ms(Severity = error)
b)com-> sap-> aii -> adapter->rnif1.1->ms(Severity = error)
c)com-> sap-> aii -> adapter->rnif1.1->impl(Severity = error)
d)com-> sap-> aii -> adapter->rnif1.1->sdk->impl(Severity = error)
e)com-> sap->aii ->af ->protocol->ispeak(Severity = error)
f)com-> sap->aii ->af ->sdk->cidx->impl(Severity = error)
g)com-> sap->aii ->af ->sdk->rnif->impl(Severity = error)
xiii.Select ms(Severity = error) appearing under cidx.
xiv. On the right hand side,change the value for Severity from 'Error' to 'ALL'.
xv. On the right hand side, click on the Add button to add new destinations .
xvi. Select the value
the pop up list appearing after clicking on the Add button.
xvii.Click the save button on top and select 'Apply to all server nodes' from the pop-up appearing on clicking the save button.
The log files would be saved as a ispeak_trc_*.trc file under the folder '/usr/sap/<instance ID>/<server ID>/J2ee/cluster/server0/log/services/com.sap.aii.af.ispeak.svc'
2) How can I change the start up mode for the SSL provider for dispatcher,sothat it starts automatically?
Use the Configtool to change the startup mode for the SSL Provider.
Steps to follow:
i. Login to ConfigTool by clicking on configtool.bat (configtool.sh for UNIX) that is present in 'usrsap<instance ID><serverID>j2eeconfigtool'
ii. Choose Instance_ID*->dispatcher_ID*->services->ssl
iii.On the right-hand side, goto Drop-down of startup mode.
iv. Switch from manual to always and save the settings.
3) What is the solution if the F4 help to select the Partner Certificates in the Integration directory does not work ?
The F4 help of the Integration directory will not recognize the Certificate if the Subjectkeyidentifier field of the certificate is left unfilled . The issue can be dealt with in 3 different ways .
i. Type in the Certificate name with out the use of F4 help (OR)
ii. Regenerate the certificate with a valid value for the subjectkeyidentifier . (OR)
iii. Edit the adapter meta data which is present in the Integration repository and get the F4 help working .
For this,remove the following tag from the adapter meta data file
This will be inside the <HelpServiceQueryAttributes> tag .
This method has the disadvantage that any upgrade will result in the adapter metadata being overwritten and hence the above change will be reverted.
4) How can I turn off User ID and Password Authentication for the CIDX/RNIF1.1/RNIF2.0 adapters?
Following procedure needs to be followed :
i. Locate the file SAPXIAF*.sca specific to the XI SP version being used in your system. This sca file contains aii_af_ms_app.sda .
ii. Open aii_af_ms_app.sda and you would find aii_af_ms_app.war file. Open this file also. You would find web.xml. Make the following changes .
iii. Comment out the following section as follows:
iv. Add the following section immediately either below or above the commented section.
v. Put back web.xml in to aii_af_ms_app.sda.
vi. Close the SAPXIAF*.sca and open it again to check whether the change that you made is there in the file.
vii. Deploy the modified SDA using SDM tool.
5) Are there any Module Attributes for non-standard deviations in Industry Speak adapters?. If so, how do I enable them in Integration directory?
SP14 onwards, there are five module atributes available in Industry speak adapters for non-standard deviations.:
a)SupportHTTPResponseCode200And202 : This attribute if configured as '200' in directory would enable RNIF 2.0 adapter to accept HTTP response code 200 in addition to standard HTTP code 202 that is accepted by default.
Possible values for this attribute are 200 and 202.
b)GlobalUsageCode : This attribute if configured as 'Test' in directory enables users to run their scenarios in 'Test' mode.
Possible values are 'Test' and 'Production'. Default value is 'Production'.
c)AcceptNonReceiptAckSignalsWithoutSignature :This attribute if configured as 'true'in the directory enables the adapter to accept those signals other than receipt acknowledgement messages for eg. exception and acceptance acknowledgement messages with optional signature, when sign signal option is enabled.
Possible values are 'true' and 'false'.
d)IgnorePerformanceControlInMessage : This attribute if configured as 'true' in the directory enables the adapter to ignore the 'time to acknowledge receipt' and 'time to perform'fields.These two fields are a part of the service header.
Possible values are true and false. This attribute is applicable for RNIF 1.1 and CIDX adapter configurations.
e) SkipDocTypeInclusionInPayload : This attribute if configured as 'true' in the directory enables the adapter to exclude the DOCTYPE element within the payload of the rosettanet messages.
Possible values are true and false. This attribute is applicable for RNIF 2.0 adapter configurations above SP19 only.
f) MessageStandardFreeFormText : This attribute if configured in the directory enables the adapter to fill the MessageStandard in service header part for all outbound messages(that originate from XI) carrying non-RosettaNet content (for example,PIDX Content).This attribute configuration is available from SP19, patch 1 only. Typical value to be entered is PIDX.
g)StandardVersionIdentifier : This attribute if configured in the directory enables the adapter to fill the MessageStandard in service header part for all outbound messages(that originate from XI) carrying non-RosettaNet content (for example,PIDX Content).This attribute configuration is available from SP19, patch 1 only. Typical value to be entered for PIDX content is 1.0.
h)partnerDefinedPIPPayloadBindingId : This attribute if configured in the directory enables the adapter to fill the partnerDefinedPIPPayloadBindingId in service header part for all outbound messages(that originate from XI) carrying non-RosettaNet content (for example,PIDX Content).This attribute configuration is available from SP19, patch 1 only. This can be any value which is agreed upon between the trading partners.
The above module attributes can be configured in Integration directory as follows:
i) Switch to edit mode for the communication channel.
ii) Go to 'Module' tab.
iii)Go to 'Processing Sequence',select the required adapter module name and then enter the above module attributes against the 'ParameterNames' and 'ParameterValues' fields in the 'Module Configuration' table. XI 3.0 SP16 onwards, the processing sequence table and the module configuration table can be configured with the adapter types against the 'Module Key' field. Presently the adapter types that are supported will be 'RNIF' for RNIF 2.0 adapters,'RNIF11' for RNIF 1.1 adapters and 'CIDX' for CIDX adapters
6) Where can I find answers regarding enabling the Industry Speak adapters to use HTTPS protocol ?
Refer Note 816022 (Question No. 15)
7) Where can i find answers regarding the setting up of HTTP/s proxy for enabling communication between the Adapter Engine and the partner systems ?
Refer Note 816022 (Question No. 19)
8) What are the SAP Notes that are currently available to the Customers with respect to Industry Speak Adapters.?
Currently the following are the notes available related to Adapter Framework:
1) Note 839673: Error during XI Adapter Framework 3.0 deployment
2) Note 847757: RNIF20 Adapter Non repudiation-Incorrect message Digest
3) Note 834728: CIDX Adapter- Inbound Acknowledgement failure
4) Note 825460: URL for B2B Adapters (RNIF2.0 & CIDX)
5) Note 817894: Fixes for CIDX Adapter XI 3.0, SP-10
6) Note 788690: RNIF2.0/CIDX Adapter Authentication problem with HTTPS
7) Note 538405: Composite SAP Note on the SAP Web Dispatcher
8) Note 724719: How to enable HTTP tracing in SAP J2EE Engine
9) Note 816022: FAQ: XI 3.0 J2EE Adapter Engine / Messaging System
10)Note 761921: Creating an XI adapter framework trace file
11)Note 803145: Received HTTP response code 503
9) Where can I find XI Trouble shooting Guide?
This can be downloaded from the following link.
10) Where can I get 'How-to' guides in XI?