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.

Checking deployment by using the IBM Integration Toolkit

About this task

Follow these steps to check a deployment by using the IBM® Integration 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:
mqsideploy IBNODE -e default -a my.bar
the following response indicates that the deployment was successful:

BIP1039I: Deploying BAR file 'my.bar' to integration node 'IBNODE' (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 details of 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:
DeployResult dr = eg.deploy("MyBAR.bar", true, 30000);
System.out.println("Overall result = "+dr.getCompletionCode());

// Display log messages
Enumeration logEntries = dr.getLogEntries();
while (logEntries.hasMoreElements()) {
  LogEntry le = (LogEntry)logEntries.nextElement();
  System.out.println("General message: " + le.getDetail());
}

The deploy method blocks other processes until the integration node responds to the deployment request. When the method returns, the DeployResult object represents the outcome of the deployment at the time when the method returned; the object is not updated by the IBM Integration API.

If the deployment message could not be sent to the integration node, a ConfigManagerProxyLoggedException 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. The completion code that is shown in the following table is one of the static instances from the CompletionCodeType class.

Completion code Description
pending The deployment is held in a batch and is not sent until you call BrokerProxy.sendUpdates().
submitted The deployment message was sent to the integration node, but no response was received before the timeout period expired.
success The integration node successfully completed the deployment.
failure The integration node generated one or more errors during deployment. You can call the getLogEntries() method of the DeployResult class to get more information about the deployment failure. This method returns a list of available LogEntry objects.

Checking deployment to IBM App Connect on IBM Cloud

About this task

When you upload a BAR file into IBM App Connect on IBM Cloud, an integration server is created to run the contents of that BAR file. The integration server is represented by a tile on the App Connect on IBM Cloud dashboard. You can start and stop the integration servers, and view information about them.

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

Procedure

  1. Log in to App Connect on IBM Cloud.
  2. The App Connect on IBM Cloud dashboard should open automatically, but if it does not, click Dashboard.
  3. Look at the status for the relevant integration server:
    • If the status is Preparing, the BAR file is being deployed.
    • If the status is Stopped, the BAR file has been deployed, but the integration server has not yet been started.
    • If the status is Started, the BAR file has been deployed, and the integration server is running.

What to do next

You can administer your integration node, integration server, and deployed resources; see Administering integration nodes and associated resources.