IBM App Connect Enterprise plugin properties

Using a template XML file

The XML template approach is recommended, in this case you have to set the following property as a PROPERTY entry in the "ACE Default Manage Integration Node" task or in the configuration file used for the "ACE Deployment" task:

ace.template.file=ace/topology/ace-dg/template.xml

Using properties to define an integration node

As a less recommended alternative, you can use the old approach with a set of properties defining the integration nodes.

The following is an example of properties that can be set as PROPERTY entries in the "ACE Default Manage Integration Node" task:

ace.broker.names=RRP_NODE,PGU_NODE

ace.broker.RRP_NODE.createbroker=true
ace.broker.RRP_NODE.connection=@@QMGR_NAME@@:localhost:1414:@@QMQR_CHANNEL@@
ace.broker.RRP_NODE.version=11
ace.broker.RRP_NODE.name=RRP_NODE
ace.broker.RRP_NODE.serviceUserId=
ace.broker.RRP_NODE.servicePassword=
ace.broker.RRP_NODE.configurationChangeTimeout=
ace.broker.RRP_NODE.internalConfigurationTimeout=
ace.broker.RRP_NODE.workPath=
ace.broker.RRP_NODE.sharedWorkPath=
ace.broker.RRP_NODE.userLilPath=
ace.broker.RRP_NODE.mqFastPath=
ace.broker.RRP_NODE.migratePubSub=
ace.broker.RRP_NODE.statisticsMajorInterval=
ace.broker.RRP_NODE.httpListenerPort=
ace.broker.RRP_NODE.icuConverterPath=
ace.broker.RRP_NODE.ldapCredentials=
ace.broker.RRP_NODE.ldapPrincipal=
ace.broker.RRP_NODE.userExitPath=
ace.broker.RRP_NODE.operationMode=
ace.broker.RRP_NODE.adminSecurity=
ace.broker.RRP_NODE.MQService=
ace.broker.RRP_NODE.binaryinstalllocation=
ace.broker.RRP_NODE.listener=

ace.broker.PGU_NODE.createbroker=true
ace.broker.PGU_NODE.connection=@@QMGR_NAME@@:localhost:1414:@@QMQR_CHANNEL@@
ace.broker.PGU_NODE.version=11
ace.broker.PGU_NODE.name=PGU_NODE
ace.broker.PGU_NODE.serviceUserId=
ace.broker.PGU_NODE.servicePassword=
...

In this case "RRP_NODE" and "PGU_NODE" are the integration node names and need to be set in the "ace.broker.names" property, and this same string needs to be part of the key in the rest of the properties, as shown in the example.

And the following properties can be used for the configuration file used in the "ACE Deployment" task:

ace.broker.timeoutsecs # Default value: 30
ace.broker.retrycount # Default value: 3

#######################
# Mandatory properties
#######################
ace.broker.names=NODE_NAME

ace.broker.NODE_NAME.os
ace.broker.NODE_NAME.name # Default value: NODE_NAME
ace.broker.NODE_NAME.exectiongroups
ace.broker.NODE_NAME.connection
ace.broker.NODE_NAME.configmgrconn

#######################
# Other properties
#######################
ace.broker.NODE_NAME.rootfolder # Default value: NODE_NAME
ace.broker.NODE_NAME.deploymentmode
ace.broker.NODE_NAME.version # Default value: default
ace.broker.NODE_NAME.aclentries
ace.broker.NODE_NAME.sslciphersuite
ace.broker.NODE_NAME.sslpeername
ace.broker.NODE_NAME.sslkeystore
ace.broker.NODE_NAME.ssltruststore
ace.broker.NODE_NAME.channelname
ace.broker.NODE_NAME.requestqueuename
ace.broker.NODE_NAME.responsequeuename
ace.broker.NODE_NAME.setsslkeystorepassword
ace.broker.NODE_NAME.setssltruststorepassword
ace.broker.NODE_NAME.stopallflows # Default value: false
ace.broker.NODE_NAME.apitracefile
ace.broker.NODE_NAME.serviceUserId
ace.broker.NODE_NAME.servicePassword

Where "NODE_NAME" is the name of the integration node you want to deploy to and the "ace.broker.names" property defines all the integration node names separated by commas as in the previous example.