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!.
If you are using the default adapter, it is named "HTTP Server Adapter" .
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).
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:
- Fully qualified domain name (FQDN) or IP address that is accessible from the Internet.
- Port number
- Uniform Resource Identifier (URI)
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
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/AS2" when the URI is actually lower case "as2".
- Is your HTTP Server Adapter started/enabled?
- If they receive an HTTP 500 error the partner reached your server but did not attempt to deliver an AS2 document
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.
UID
ibm11121025