soapUI | DataPower | SOMA | AMP | Endpoints

If you’re like me and you also use IBM AMP / SOMA api’s to help manage DataPower IDG appliances, then this problem may sound familiar. 

It seems like whenever I start working for a new client I run into this problem. Most environments don’t seem to create DNS entries for the numerous DataPower appliances in use. Or, if they do, they don’t give them very meaningful names. I see names based on serial numbers and even names that identify the rack locations in data centers. More often than not, we simply use the management interface IP addresses to connect to the Web Management Consoles on port 9090, am I right?

That’s fine for the accessing the Web Management Consoles for the various devices in a web browser. Most of us just create a heirarchy of bookmarks to organize the links into different environments with meaningful names (like below). We even color code the Web Management Console banners in all the appliances to remind us where we are (red for production, yellow for staging, green for development, etc.). 

But soapUI doesn’t have a “bookmarks” tool for organizing endpoints for the SOMA / AMP API’s you use to querry your devices. All you can do is use the IP addresses or meaningless DNS names and soon your endpoints drop-down becomes a confusing hot-mess that can lead to a lot of errors and mistakes! 

So here’s your Quick Tip:  Use your computers “hosts” file and create your own meaningful names for each of the devices! (If you don’t know how to get to your “hosts” file, read up here.)

I like to create meaningful names for each of the devices that I querry so that it’s easy to see what environment they belong to, their regional location,  or even the data center they reside in.  You can see from my example hosts entries that it’s easy to identify which IP’s belong to production appliances in the DMZ of the Chicago data centers.  

You can now have much more readable endpoints in the drop-down of soapUI which will lead to less squinting and far fewer mistakes! And not just in soapUI, but anywhere on your machine and in any tool you use to access those devices.

Hope this helps and, as usual, if you have any questions or comments, feel free to use the form below.  Happy coding!