IBM Integration Bus, Version 10.0.0.2 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Packaging and deploying a REST API

Package your REST API into a BAR file and deploy it to an integration server.

Before you begin

You must create a REST API in the IBM® Integration Toolkit, see Creating a REST API.

About this task

REST APIs can be deployed to integration servers that are configured to use the integration server HTTP listener only. REST APIs cannot be deployed to integration servers that are configured to use the integration node HTTP listener. If the integration node does not have a queue manager specified for it, the integration server defaults to using the integration server HTTP listener.

If you plan to deploy more than one REST API to an integration server, the REST APIs must have different base paths.

Procedure

To package a REST API into a BAR file and deploy it to an integration server, complete the following steps:

  1. Package the REST API into a BAR file. You can use either the BAR file editor, or you can use the command line. Both the mqsicreatebar and mqsipackagebar commands package a REST API into a BAR file. When you use these commands, pass the name of the REST API in as the application name. For example:
    mqsicreatebar -data workspaceDirectory -b restApiName.bar -a restApiName
    mqsipackagebar -a restApiName.bar -k restApiName
  2. If your integration node is configured to use the integration node HTTP Listener, then you must:
    1. Run the following command:
      mqsichangeproperties integrationNodeName -e integrationServerName -o ExecutionGroup -n httpNodesUseEmbeddedListener -v true
    2. Restart the integration server.
  3. Deploy the REST API to the integration server. You can use the IBM Integration Toolkit, the web user interface, or the mqsideploy command:
    mqsideploy integrationNodeName -e integrationServerName -a restApiName.bar
    If another REST API is deployed to the integration server and that REST API has a clashing base path, the deployment of the REST API fails. You cannot deploy REST APIs that have clashing base paths to the same integration server.

Results

Your REST API is deployed.

What to do next

You can view and manage the deployed REST API by using the command line or a web browser, see Managing a deployed REST API.

bi12025_.htm | Last updated 2015-09-24 12:54:16