Deploying integration solutions to a production environment
After you create and populate a BAR file with the development resources, you can deploy the integration solution to an integration server.
Before you begin
- Review the deployment rules and guidelines; see Deployment rules and guidelines.
- Package your integration solution in a BAR file; see Packaging integration solutions.
- Configure your packaged solution for the target deployment environment; see Preparing packaged solutions for deployment.
The mode in which your integration node is working can affect the number of integration servers and message flows that you can deploy, and the types of node that you can use. See Restrictions that apply in each operation mode.
About this task
If you change a BAR file, and want to propagate those changes to one or more integration nodes, you can redeploy the updated BAR file; see Redeploying integration solutions to a production environment.
By default, BAR file deployment is incremental, but you can choose to do a complete BAR file deployment if you prefer. For an explanation of the difference between a complete and an incremental BAR file deployment, see BAR file deployment.
Deploying a BAR file by using the web user interface
About this task
You can select a BAR file and deploy it to an integration server by using the web user interface.
You can also select an overrides file, which defines the BAR file properties that you want to change for a specific deployment. For more information, see mqsiapplybaroverride command.
Procedure
- Start the web user interface for your integration node; see Accessing the web user interface. The navigator is displayed on the left side of the pane, showing the servers (integration servers), message flows, and other resources that are owned by your integration node.
- Expand the Servers section and click the arrow beside the integration server (where you want to deploy the BAR file) to display the menu.
- Click Deploy. The Deploy BAR File dialog is displayed.
-
To select a BAR file, click Browse,
navigate to your BAR file and click
Open.
The BAR file properties and the associated values are displayed in the dialog.
- Optional:
To select an overrides file, click the down arrow beside Overrides and
click Select overrides file, navigate to the overrides file, and click
Open.
For information about the format of an overrides file, see mqsiapplybaroverride command.Any property values that are specified in the overrides file are displayed in the dialog, in place of the original property values. If you want to restore the original property values from the BAR file, click the down arrow beside Overrides and click Clear overrides file.
- Click Deploy.
Results
Deploying a BAR file by using the IBM Integration Toolkit
About this task
To deploy a BAR file by using the IBM® Integration Toolkit, complete the following steps. You can deploy to only one integration server at a time.
Procedure
Results
Deploying a BAR file by using the mqsideploy command
About this task
To deploy a BAR file by using the mqsideploy command, complete the following steps.
Procedure
Results
The command reports when responses are received from the integration node. If the command completes successfully, it returns 0 (zero).
Deploying a BAR file by using the IBM Integration API
About this task
To deploy a BAR file by using the IBM Integration API, use the deploy method of the ExecutionGroupProxy class.
import com.ibm.broker.config.proxy.*;
public class DeployBAR {
public static void main(String[] args) {
BrokerConnectionParameters bcp =
new IntegrationNodeConnectionParameters("localhost", 4414);
try {
BrokerProxy b = BrokerProxy.getInstance(bcp);
ExecutionGroupProxy eg = b.getExecutionGroupByName("default");
DeployResult dr = eg.deploy("MyBAR.bar", true, 30000);
System.out.println("Result = "+dr.getCompletionCode());
} catch (Exception e) {
e.printStackTrace();
}
}
}
By
default, the deploy method completes an incremental deployment. To do a complete
deployment, use a variant of the method that includes a false value for the Boolean
isIncremental parameter. For example, eg.deploy("MyBAR.bar", false,
30000)
. Deploying a BAR file to IBM App Connect on IBM Cloud
Before you begin
About this task
App Connect on IBM Cloud provides a fully managed environment that you can use to deploy integration solutions to the cloud without the need to acquire and maintain an IT infrastructure.
You deploy a solution to App Connect on IBM Cloud by uploading the BAR file to the cloud. When you upload your BAR file to the cloud, an integration server is created in the cloud, and the contents of the BAR file are unpackaged and run on that integration server. Each integration server in App Connect on IBM Cloud contains the contents of a single BAR file. You can see your integration servers on the App Connect on IBM Cloud dashboard, where you can start and stop them. You can also configure authentication and secure connectivity between your resources in the cloud and on premises.
For detailed instructions about how to upload BAR files to the cloud, see IBM App Connect Enterprise on IBM Cloud.