Back to Top
This task will run the "mqsiprofile" command within the specified ACE install location i.e. <aceMaintainACEBinaryInstallLocation>/bin/mqsiprofile. After running the profile the bespoke command specified within the parameter "aceMaintainBespokeMQSICommand" will be executed.
ACE Bespoke MQSI Command Runner
| Class Name | com.midvision.rapiddeploy.orchestration.tasks.ace.ACEBespokeMQSICommandTask |
| Category | IBM App Connect |
Description
This task allows you to run any bespoke command on an integration node environment.This task will run the "mqsiprofile" command within the specified ACE install location i.e. <aceMaintainACEBinaryInstallLocation>/bin/mqsiprofile. After running the profile the bespoke command specified within the parameter "aceMaintainBespokeMQSICommand" will be executed.
Parameters
The following parameters need be set on this task:Table of task Parameters
| Name | Type | Default Value | Optional | Description |
|---|---|---|---|---|
| aceMaintainACEBinaryInstallLocation | java.lang.String | /opt/IBM/ace-11.0.0.1/server | false | This is the ACE installation root directory. |
| aceMaintainBespokeMQSICommand | java.lang.String | mqsilist | false | This is the bespoke command that will be run on the target (https://www.ibm.com/support/knowledgecenter/en/SSTTDS_11.0.0/com.ibm.etools.mft.doc/an26180_.htm). |
| failOnError | java.lang.Boolean | true | false | This task will not fail the deployment on error if set to false. |
| integrationApiPath | java.lang.String | /opt/IBM/ace-11.0.0.12/common/classes/IntegrationAPI.jar | true | The full path to the IntegrationAPI.jar file in the ACE installation location. |
| skipOnFailure | java.lang.String | Previous Task Name | true | Skip current task based on the name of the previous task whether it has failed or not. |
Back to Top
ACE Default Manage Integration Node
| Class Name | com.midvision.rapiddeploy.orchestration.tasks.ace.ACEDefaultManageBrokerTask |
| Category | IBM App Connect |
Description
This task is used to manage IBM App Connect configurations. It can be used to perform local administration of the integration node during a deployment. For example an integration node can be created, deleted, started or stopped by specifying the appropriate option. This task is typically used in conjunction with other integration node tasks (such as the "ACE Deployment" task) to perform preparatory actions.Managed Operations
This single orchestration task can be used in a number of ways by specifying different operations. These are described below. This task depends upon a certain structure within the deployment package.| Operation | Description |
|---|---|
| createBroker | Creates an integration node using information from the deployment package. |
| createAndStartBroker | Creates and starts an integration node using information from the deployment package. |
| createAndStartBrokerAndListener | Creates and starts an integration node and additionally starts a queue manager listener. |
| startBroker | Starts an integration node. |
| stopBroker | Stops an integration node. |
| deleteBroker | Deletes an integration node. |
Configuration properties
This task needs the use of task entries of type "PROPERTY" to configure the desired maintain operation. This can be done by setting the property "ace.template.file" to the relative to the ${ARCHIVE_ROOT} path of a template XML file or by setting the "ace.broker.names" property to a comma-separated list of integration node names and the necessary "ace.broker.[BROKER_NAME].[PROPERTY_SUFFIX]" properties.Parameters
The following parameters may be set on this task:Table of task Parameters
| Name | Type | Default Value | Optional | Description |
|---|---|---|---|---|
| aceMaintainOperation | java.util.List | createAndStartBrokerAndListener | false | The integration node operation requested, i.e.: createBroker, createAndStartBroker, createAndStartBrokerAndListener, startBroker, stopBroker or deleteBroker |
| failOnError | java.lang.Boolean | true | false | This task will not fail the deployment on error if set to false. |
| integrationApiPath | java.lang.String | /opt/IBM/ace-11.0.0.12/common/classes/IntegrationAPI.jar | true | The full path to the IntegrationAPI.jar file in the ACE installation location. |
| skipOnFailure | java.lang.String | Previous Task Name | true | Skip current task based on the name of the previous task whether it has failed or not. |
Back to Top
ACE Deployment
| Class Name | com.midvision.rapiddeploy.orchestration.tasks.ace.ACEDeploymentTask |
| Category | IBM App Connect |
Description
This task is used to deploy IBM App Connect configuration and code. It can optionally be used to create integration nodes and their internal topology (such as integration servers). This task is used in conjunction with a prepared RapidDeploy deployment package which is required for deployments and is usually a source controlled folder structure that has been compressed into a single package.Managed Operations
This single orchestration task can be used in a number of ways by specifying different operations. These are described below. This task depends upon a certain structure within the deployment package.| Operation | Description |
|---|---|
| updateBroker | Performs a code (barfile) and configuration deployment to the integration node creating the topology if it does not exist. |
| updateBrokerConfig | Performs a configuration deployment to the integration node. |
| updateBrokerCode | Performs a code (barfile) deployment to the integration node and creates the topology if it does not exist. |
Parameters
The following parameters may be set on this task:Table of task Parameters
| Name | Type | Default Value | Optional | Description |
|---|---|---|---|---|
| aceMaintainDataRootRelativePath | java.lang.String | ace/topology | false | The relative path to the top of the data tree in the archive. |
| aceMaintainOperation | java.util.List | updateBroker | false | Operation to perform as shown in the table above. |
| configurationPropertyFilePath | java.lang.String | false | The absolute path to the properties file containing the configuration information for this environment. | |
| extraClasspath | java.lang.String | /opt/IBM/ace-11.0.0.1/common | true | The path to the folder where any extra library for the IntegrationAPI.jar is located. This folder will be searched recursively and any JAR file found will be loaded into the classpath. This parameter shouldn't be necessary from version 11.0.0.5 or above of IBM App Connect. |
| failOnError | java.lang.Boolean | true | false | This task will not fail the deployment on error if set to false. |
| integrationApiPath | java.lang.String | /opt/IBM/ace-11.0.0.12/common/classes/IntegrationAPI.jar | true | The full path to the IntegrationAPI.jar file in the ACE installation location. |
| searchReplacePropertyFilePath | java.lang.String | true | The absolute path to the properties file containing search/replace parameters for this environment. | |
| skipOnFailure | java.lang.String | Previous Task Name | true | Skip current task based on the name of the previous task whether it has failed or not. |