Deploying the REST service mediation sample project

Following this guide, you can deploy and test the sample project REST service mediation in IPS.


If you haven’t already done so,

  • define a container image with user adroitlogic, name ips-worker and tag 17.07 (you can utilize the Select Existing button on the container image creation page to use the already defined image from the image repository).

  • create a cluster using the abovementioned container image.


  1. Navigate to the project creation page.

  2. Click the Select a Sample button and select the REST Service Mediation sample.

  3. Click Next and wait for IPS to download the sample XPR from the repository, after which you will be automatically navigated to the Configure page.

    rest service
  4. Click Next again on the Configure page as we do not want to change any of the default project properties.

  5. In the Assign page, select the cluster you have created previously, and click Deploy Now.

  6. You will be directed to the Deployments perspective of the selected cluster, with the new project added automatically to the Pending Updates list.

    If you had already deployed a project in the selected cluster, which exposes the same port as the REST Service Mediation sample (i.e. 8280), the project will not be added to the pending updates list and an error message indicating the port conflict will be displayed (as two projects in the same deployment cannot bind to the same port). In that case, you can manually Delete the conflicting project from the Deployed Projects list and use the Add Project button on the upper right hand corner to select the RestServiceMediation project for deployment.
  7. Map an external port (e.g. 30040) to the exposed port of the sample project, using the Configure button.

  8. Click Deploy and wait for the progress bar to indicate successful completion of the deployment.


  1. Find the IP address on the host-only interface of your IPS virtual machine using the ips_installer ip command (which would usually be

  2. Send a GET request to using an HTTP client (such as the HTTP/S Client in Ultra Studio Toolbox) or by entering the URL into a web browser, as explained in the sample documentation, where is the IP address found earlier and 30040 is the external port mapped during project deployment.

  3. The response from the OpenWeatherMap website will be received as the response payload.

    rest service mediation response in browser
In this topic
In this topic
Contact Us