Follow these steps to get up and running with MettleCI as quickly and easily as possible.
1. Gather your required information
Note that before you proceed with MettleCI installation and configuration you should have the following information to hand:
Your DataStage settings (Engine and Service Tier endpoints and credentials)
Your Git settings (endpoint and public SSH key)
Your Work Item Management settings (endpoint and public SSH key)
Perhaps you’ll need to create your first project Git repository. This will depend upon the Git technology you use, and will be subtly different for GitHub, GitLab, Bitbucket, Azure DevOps, etc. Follow the instructions for your preferred system and ensure you capture the information.
MILESTONE: You’ve verified that you can connect to DataStage, Git, and Work Item Management using your credentials/SSH keys.
2. Install MettleCI Workbench
Start by installing MettleCI Workbench on your DataStage development Engine tier host.
See our super-simple instructions for Engine tiers hosted on Unix and Windows platforms.
MILESTONE: You can log in to the MettleCI Workbench using your DataStage credentials.
3. Register your first DataStage project
MettleCI Workbench uses a selected DataStage Project for its context. A DataStage project needs to be registered with the Workbench before you can use MettleCI with it. Follow the instructions for registering a DataStage Project with MettleCI Workbench.
MILESTONE: Your MettleCI workbench know about your DataStage project, and it is listed in the drop-down project list at the top of the Workbench.
4. Try MettleCI Compliance
a. Create your compliance rule Git repository
Follow the steps required to create your Compliance Rule Git repository.
MILESTONE: You have an operational Git repository containing a set of template MettleCI Compliance Rules.
b. Execute Compliance against a DataStage Job
Follow the steps to execute compliance against a selected DataStage job.
Note that you’ll definitely get some Compliance failures with your first execution! At the very least expect the supplied Job and Stage naming standards to differ to yours!
MILESTONE: Compliance results for one of your DataStage jobs.
5. Try MettleCI Unit Testing
a. Install the Parallel Unit Test Harness (if you use Parallel jobs)
Follow the steps to install the Parallel Unit Test harness.
b. Create your first Unit Test
Follow the steps to configure your environment for Unit Testing, then create your first Unit Test.
You’ll then need to either manually create Unit Test data, or capture it from existing Unit Test data, after which you can execute your Unit Test.
MILESTONE: You can use MettleCI Workbench to observe Unit Test results for your selected DataStage job.