microsoft/vsts-ibm-integration-bus-extension

Visual Studio Team Services Extension for IBM Integration Bus

Visual Studio Team Services Extension for IBM Integration Bus

This extension provides build tasks to manage and deploy Broker Archive (BAR) files to IBM Integration Bus v10.

This extension installs the following components:

• A service endpoint for connecting to IBM Integration Bus on Visual Studio Team Services and Team Foundation Server 2017.
• A build task to run commands on IBM Integration Bus.
• A build task to deploy BAR files to IBM Integration Bus.

Prerequisites

• In order to automate the deployment of BAR files to IBM Integration Bus, the build agent must have access to the 'mqsi*' commands. Please follow the IBM Integration Bus document to setup the command environment.

  • If the build agent is running on Windows, the "Batch Script" task can be used to run the 'mqsiprofile.cmd' script and setup the command environment. Make sure 'Modify Environment' is checked.

    

IBM Integration Bus Deployment Task

1. Open your build definition and add the "IBM Integration Bus Deployment" task. The task can be found in the 'Deploy' section.

   

2. Details of the deployment task.

   

   • Setup Connection Options.
   • Enter the path to a BAR file. Wildcards can be used, but the pattern must resolve to exactly one file.
   • Enter the Integration Server Name. This is called "Execution Group" in prior versions of Integration Bus. This Integration Server will be created if it does not exist.
   • By default mqsideploy command does a delta or incremental deployment. Check the "Run a Complete Deployment" box if you want to override the behavior and run a complete deployment.
   • You can add additional arguments to mqsideploy in the Optional Arguments field. Refer to IBM's documentation for all options mqsideploy supports.

IBM Integration Bus Command Task

1. Open your build definition and add the "IBM Integration Bus Command" task. The task can be found in the 'Utility' section.

   

2. Details of the command task.

   

   • Setup Connection Options.
   • Enter the command and any arguments

Setup Connection Options

The tasks provide three options to connect to IBM Integration Bus:

1. Connecting with an "IBM Integration Service Bus" endpoint.

   • This option is supported on Visual Studio Team Services and Team Foundation Server 2017. On Team Foundation Server 2015, please use other options to connect.

   

   • Connection name: name used to identify this connection.
   • Integration Node: name of the Integration Node. This is called "Broker" in prior versions of Integration Bus.
   • Hostname / IP Address: IP address or the hostname of the computer on which the Integration Bus is running. The hostname must be resolvable by the build agent. Do not prefix with protocol names if username and/or password is also supplied.
   • Port: optional, port of the Integration Bus.
   • Queue Manager: optional, the name of the queue manager.
   • Username and Password: optional, if supplied, will be used with values of hostname or ip address to construct the connection URL in the form of tcp://${username}:${password}@${hostname}.

2. Manually enter credentials.

   • The same fields from "IBM Integration Service Bus" endpoint section are repeated within the task.

3. Select a .broker file.

   • The supplied .broker file must contain all connection information required for automated deployment, including deployment credentials.

Contact Us

Report an issue

vsts-ibm-integration-bus-extension's Issues

Time out issue for restart option

When you select the restart intergration server check box and you have a value in the Timeout in Seconds for mqsideploy , You should add the -w option to the start and stop.

The only option now is the default 60 sec

[command]C:\Windows\system32\cmd.exe /D /S /C ""C:\Program Files\IBM\IIB\10.0.0.12\server\bin\mqsistartmsgflow.bat" IIBDV01 -i tcp://:@entintdev.corelinkadmin.com -e Provider"
2018-11-16T16:46:50.3028326Z BIP1060I: Connecting to the integration node...
2018-11-16T16:46:50.3028898Z BIP1115I: Connected to the integration node 'IIBDV01'.
2018-11-16T16:46:50.5481008Z BIP1186I: Starting the integration server 'Provider'...
2018-11-16T16:47:51.1663996Z BIP1047E: The operation timed out waiting for a response.
2018-11-16T16:47:51.1666635Z
2018-11-16T16:47:51.1841878Z The utility did not receive an expected response from the integration node within a designated amount of time. The operation might have completed successfully, even though the response was not received.
2018-11-16T16:47:51.1843163Z
2018-11-16T16:47:51.1844082Z Ensure that the integration node is running and that the correct connection parameters have been supplied to the utility. Use the -w flag to increase the amount of time to wait for responses.

Installation of IBM Integration Bus toolkit or run-time in VSTS

In order to automate maven build for IBM Integration Bus Bar file, we need to install IIB toolkit or IIB run-time in VSTS, our VSTS server is Unix. Please advise how to install? or you have any alternative solution to do maven build for IIB. Thanks