OK this topic may seem obvious for some people, but for some others (including me), enabling SNC was not exactly a piece of cake.
Actually there are plenty of resources about how to install the SAP adapter (where to find the DLLs needed, where to place them, etc…), like this one:
(or you can simply follow the instructions from the installation guide of the BizTalk Adapter Pack, which can be found in this folder on your BizTalk box: C:\Program Files\Microsoft BizTalk Adapter Pack\Documents\ ), but I found very little accurate information on how to configure a receive or send port in order to use SNC. So, here is my recipe.
SAP configuration
· Check that SNC is enabled. Use transaction RZ10 and check the value of parameter snc/enable. It should be set to 1.
· Use transaction SU01 to edit the properties of the user under which your BizTalk Host Instance runs (for instance: UsrBTS). Edit the SNC configuration of this user and edit its SNC Name. Set it to UsrBTS@mydomain.com.
Also, note down the values of the snc/gssapi_lib and snc/identity/as parameters, you will need them when configuring the Send Port or Receive location.
Note : if you intend to receive data from SAP (ie: through an RFC Destination), there is no need to enable SNC on this RFC Destination.
BizTalk configuration
Again, I assume you have already and properly installed the SAP Adapter. If not, refer to the BizTalk Adapter Pack installation guide.
Edit the properties of the send port or receive location you wish to configure :
· First, add UseSnc=True in the connection string. Therefore, it should look like :
sap://CLIENT=120;LANG=en;UseSnc=True;@a/devecc1.mydomain.com/00?ListenerProgramID=BTSRFCTEST&ListenerGwHost=devecc1.mydomain.com&ListenerGwServ=sapgw00
(as you may have guessed, this is the connection string of a receive location)
· In the binding properties, set the sncLibrary property according to the value of the snc/gssapi_lib SAP parameter :
|
snc/gssapi_lib
|
sncLibrary
|
|
C:\Windows\System32\gx64krb5.dll
|
gsskrb5.dll (for a 32bit host instance)
gx64krb5.dll (for a 64bit host instance)
|
|
C:\Windows\System32\gx64ntlm.dll
|
gssntlm.dll (for a 32bit host instance)
gx64ntlm.dll (for a 64bit host instance)
|
· In the binding properties, set the sncPartnerName property to the value of the snc/identity/as SAP parameter.
· Restart the host instance hosting the port, and start the port.
TIP : Testing an RFC Destination
In the case where you want to send data to BizTalk through an RFC Destination (using SNC or not), it is possible to check whether the configuration is OK by using transaction SM59, selecting the desired TCP/IP destination and then using the Test Connection button.
Just remember to start the Receive Location before testing the connection... 