When Bamboo needs to execute one or more MettleCI tasks (e.g. export from a DataStage Project), the following steps occur:
MettleCI-relevant Bamboo Tasks will identify which version of a DataStage client or Engine they require
Bamboo will allocate any available Bamboo Agent that has been configured with the DataStage Capability for the required DataStage version.
The Tasks will then execute on the allocated Agent.
| Note |
|---|
If you are using Bamboo for the first time, we recommend that you start with Local Agents only. |
...
| Warning |
|---|
You will not be able to use MettleCI until at least one Bamboo Agent is configured with a DataStage Capability. |
Defining a DataStage Capability on the Bamboo Server (Local Agent)
Bamboo Server Capabilities are inherited by all Local Agents (Defining a Bamboo Capability).
Before defining a DataStage Capability you must have installed an IBM Information Server client and all relevant fix packs on the Bamboo Server.
Steps
Click the cog icon in the Bamboo header and choose Overview.
Click Server Capabilities in the left navigation panel.
Choose Capability Type > DataStage in the 'Add Capability' section at the end of the page.
If you can't find the DataStage Capability type, check the add-on MettleCI - DataStage Capability Plugin (dm-Capability-plugin.jar) has been /wiki/spaces/AET/pages/291733561.
In the Install Label field, type a name/label for this version of DataStage. MettleCI uses this name in the Executables dropdown list whenever a MettleCI task is configured.
NOTE: When setting the Install Label, we recommend following a DataStage v<version number> naming standard, for example, DataStage v11.5. There is no need to distinguish between DataStage clients and engines, MettleCI Tasks automatically determine if they can run on a DataStage client, engine or both.
In the Path field, type the path to the DataStage client "classic" folder or to the engine home directory (e.g. 'C:\IBM\InformationServer\Clients\Classic' or '/opt/IBM/InformationServer/Server/DSEngine').
Click Add.
...
Defining a DataStage Capability on a Remote Agent
An Agent-specific Capability applies to one Agent only. Before defining a DataStage Capability on a remote Agent, you must either:
Install an IBM Information Server client and all relevant fix packs on the same box where you have an existing Remote Agent.
Install a new Remote Agent on an existing DataStage engine tier. We recommend that you install the Remote Agent as a Windows Service.
While all MettleCI Professional tasks can use a DataStage client or engine during execution, most MettleCI enterprise tasks require a client. When possible, we recommend using DataStage clients to prevent resource contention when the DataStage engine is executing heavy jobs and to provide maximum flexibly when using MettleCI enterprise tasks.
Steps
Click the cog icon in the Bamboo header and choose Overview.
Click Agents in the left panel.
Click the name of the required Agent.
Click the Capabilities tab, and then Add Capability (to the right of 'Agent-Specific Capabilities').
Choose Capability Type > DataStage in the 'Add Capability' section at the end of the page.
If you can't find the DataStage Capability type, check the add-on MettleCI - DataStage Capability Plugin (dm-Capability-plugin.jar) has been installed and is enabled.
In the Install Label field, type a name/label for this version of DataStage. MettleCI uses this name in the Executables list whenever a MettleCI task is configured.
NOTE: When setting the Install Label, we recommend following a DataStage v<version number> naming standard, for example, DataStage v11.5. There is no need to distinguish between DataStage clients and engines, MettleCI Tasks automatically determine if they can run on a DataStage client, engine or both.
In the Path field, type the path to the DataStage client "classic" folder or to the engine home directory (e.g. 'C:\IBM\InformationServer\Clients\Classic' or '/opt/IBM/InformationServer/Server/DSEngine').
Click Add.
...