Checking the results of deployment

After you deploy a BAR file, you can check that the operation completed successfully.

About this task

You can check the results of a deployment by using any of the following methods: Also, check the system log on the target system where the integration node was deployed to make sure that the integration node did not report any errors.

If version or custom keyword information was included in the resources, you can also check the version of the resources that are deployed to your integration server; see Viewing version information and custom keyword values in your deployed solutions.

You can also view the active layout and view the endpoints of a deployed message flow. For more information, see Viewing the active flow layout of a deployed message flow in the IBM App Connect Enterprise Toolkit and Viewing endpoints.

Checking deployment by using the IBM App Connect Enterprise Toolkit

About this task

Follow these steps to check a deployment by using the IBM App Connect Enterprise Toolkit:

Procedure

  1. In the Integration Development perspective, open the Deployment Log view:
    1. Click Window > Show View > Other.
    2. In the Show View window expand Integration Development, and click Deployment Log.
  2. View the messages that relate to each deployment in the Deployment Log view.

Results

The Deployment Log is updated only after a deployment is processed completely by the integration node. If a deployment fails, the reasons for the failure are shown here.

Checking deployment by using the mqsideploy command

About this task

If you use the mqsideploy command to deploy, the command displays the results of the deployment. For example, if you type the following command for the default integration server of the integration node:
mqsideploy INODE -e default -a my.bar
The following response indicates that the deployment was successful:

BIP1039I: Deploying BAR file 'my.bar' to integration node 'INODE' (integration
server 'default') ...
BIP1092I: The integration node successfully processed the deployment request.

The command also returns a numeric completion code value to indicate the outcome. If the deployment completes successfully, the command returns 0. For more information about other values that you might see returned, see mqsideploy command.

Checking deployment by using the IBM Integration API

About this task

Code your application to test the results of the deployment actions that it takes. For example:
import com.ibm.integration.admin.model.common.LogEntry;
import com.ibm.integration.admin.model.server.DeployResult;
import com.ibm.integration.admin.proxy.IntegrationAdminException;
import com.ibm.integration.admin.proxy.IntegrationNodeProxy;
import com.ibm.integration.admin.proxy.IntegrationServerProxy;


public class DeployExample {

  public static void main(String[] args) {
    IntegrationNodeProxy node = new IntegrationNodeProxy("localhost",4414,"","",false);
    try {
      IntegrationServerProxy server = node.getIntegrationServerByName("server1");
      DeployResult result  = server.deploy("C:\\temp\\mybarfile.bar");
      int deployStatus = server.getLastHttpResponse().getStatusCode();
      if (deployStatus >= 400)
      {
        System.out.println("Http response error: " + deployStatus );
      }
      else
      { // deploy worked, check for any Log entries 
        LogEntry[] logEntries  = result.getLogEntry();
        if (logEntries != null)
        {
          for (LogEntry logEntry: logEntries)
          {
            System.out.println("Deploy log entry: "+logEntry.getDetailedText()); 
          }
        }
      }
    } catch (IntegrationAdminException e) {
      System.out.println("Error deploying: "+e);
    }
  }
}

If the deployment message could not be sent to the integration node, an IntegrationAdminException exception is thrown at the time of the deployment. If the integration node receives the deployment message, log messages for the overall deployment are displayed, followed by completion codes specific to each integration node that is affected by the deployment.

Checking deployment to IBM Integration Bus on Cloud

About this task

When you upload BAR files into IBM Integration Bus on Cloud, a list of integrations is created. You can then start and stop those integrations, and view information about them.

To check the status of your integrations on the cloud, complete the following steps.

Procedure

  1. Log in to IBM Integration Bus on Cloud.
    For more information, see Getting started.
  2. Click Integrations to open the Integrations view.
  3. Look at the status for the relevant integration.
    • If the status is Started, the BAR file has been deployed, and the integration is running.
    • If the status is Stopped, the BAR file has been deployed, but the integration has not yet been started.
    • If the status is Preparing, the BAR file is being deployed.