IBM Support

What is my AS2 URL?

Technical Blog Post


Abstract

What is my AS2 URL?

Body

Setting up an AS2 trading partner is well documented in this blog series:

/support/pages/node/1120821
/support/pages/node/1121541
/support/pages/node/1121709

A question often posed to IBM is why doesn't our documentation provide the URL to give to the trading partner? The reason for this is it depends on your network configuration. Out of the box, the default adapter used for AS2 inbound traffic is called the "HTTP Server Adapter" and it can be found via Deployment → Services → Configuration and then in the "Search by Service Type:" field, select "HTTP Server Adapter" and click Go!.

image

If you are using the default adapter, it is named "HTTP Server Adapter" . 

image

If you click on the adapter name it displays the configuration, note the values for the "HTTP Listen Port" and the "URI" that is assigned to the EDIINTParse Business Process. Again by default, the HTTP Server Adapter listens on base port + 33 (where "base port" is the port on which IBM Sterling B2B Integrator was installed ... this is the same port you use to access the administrator dashboard).

image

The tricky part is what is the full URL your trading partner will need to use to deliver an AS2 document. The reason IBM does not document this is many - you could be using an IBM Sterling B2B Integrator Remote Perimeter server so the reachable address might be the remote perimeter server's fully qualified domain name. Another possibility is that your network team might be using Network Address Translation, a load balancer or some other means to disguise the actual IBM Sterling B2B Integrator server. Generally speaking the URL you provide to your trading partner consists of the following:

For the default HTTP Server adapter this would look like:  FQDN:port/URI 

How do you find the FQDN? From a command line on a Unix box you can use:

 grep `hostname` /etc/hosts

On a Windows box you can use 

ipconfig /all

image
To construct the URL for this installation of SI take the FQDN (in the screenshot above that would be danal.ibm.com) , the port 42533 and the URI of /as2

"http://danal.ibm.com:42533/as2"

Troubleshooting

  • If your trading partner encounters a connection error (site can't be reached, connection refused, etc.) your first point of contact should be your network team. 
  • If your trading partner encounters a "Page not found or not allowed" error have them check the case - they may have entered something like "http://danal.ibm.com:42533/AS2when the URI is actually lower case "as2".
  • Is your HTTP Server Adapter started/enabled?

image

  • If they receive an HTTP 500 error the partner reached your server but did not attempt to deliver an AS2 document

image

If you've worked with your network team and performed basic troubleshooting of your own and still cannot determine the error then when you open a new PMR and provide the AS2 "must gather" : https://www-304.ibm.com/support/docview.wss?uid=swg21641008 and indicate whether this works for other AS2 trading partners, the error you're receiving and any other items you have ruled out.

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS3JSW","label":"IBM Sterling B2B Integrator"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

UID

ibm11121025