Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Assumptions

This page will provide provides an illustrated walk through of the installation and configuration of MettleCI’s components on a simple DataStage v11.7 topology using a Unix Engine tier. It is geared towards users who have seen the MettleCI demo video and have some understanding of how the following functions are accessed and used…

  • MettleCI Workbench (including DataStage Designer menus)

  • MettleCI Compliance

  • MettleCI Unit testing

  • MettleCI Git Commit (including Work Item lookup)

Contents

Table of Contents
minLevel1
maxLevel2
exclude(Assumptions|Contents)

Topology

Gliffy
imageAttachmentIdatt2293858307
macroIdf5a5ab41-6250-4933-bd5f-73a99ae74bf4
baseUrlhttps://datamigrators.atlassian.net/wiki
nameInstallation Demo
diagramAttachmentIdatt2293366805
containerId2293497857
timestamp1661911966853

Introduction and Prerequisites

  • Support resources

  • Scope

  • Introduce installation demo environment

  • Acquiring MettleCI download assets

  • Introducing the MettleCI download assets

    • Data Migrators Customers

    • IBM Customers (link)

  • Install OpenJDK v8 (non-IBM JVM) (link)

    • On the DataStage Engine (for MettleCI Workbench)

    • On the Agent Host (for MettleCI CLI)

    • Status
      colourBlue
      titleWINDOWS
      Using .msi installer (not demonstrated)

    • Status
      colourYellow
      titleUNix
      Using package manager(e.g., yum)

Widget Connector
overlayyoutube
_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vm
width640px
urlhttps://www.youtube.com/watch?v=vjIt8fY9yyE
height360px

Running time: 17m 00s


Install MettleCI Workbench

  • Install Workbench Service

    • Status
      colourBlue
      titleWINDOWS
      Using .msi within .zip file (not demonstrated)

    • Status
      colourYellow
      titleUNix
      Using .rpm file

  • Deploy mettleci.lic license file

    • Rename from license.txt

  • HTTPS Configuration (link)

    • Generate Java KeyStore

    • Update config.yml to add Server section, then restart Workbench service

    • Add certificate to Windows client and restart browser

Widget Connector
overlayyoutube
_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vm
width640px
urlhttps://www.youtube.com/watch?v=0IJo4Tu90f0
height360px

Running time: 19m 17s


Deploy Git Repositories and Register Workbench Project

  • DataStage & Compliance Repositories

    • Create remote repository

    • Extract supplied repository template locally

  • Configure Authentication to Remote Repository

    • Register workbench.key.pub against Git repository

  • Populate Remote Repositories

    • Associate local repository with remote repository

    • Synchronize with git add, git commit, and git push

  • Repeat for Compliance Repository

    • Create Remote, Create Local, Authenticate, Push

  • Test Workbench Access to Git Repositories

    • MettleCI Compliance fetches from the Compliance repository

    • MettleCI Commit pushes to the DataStage repository

Widget Connector
overlayyoutube
_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vm
width640px
urlhttps://www.youtube.com/watch?v=1o6qWsqdGIQ
height360px

Running time: 19m 28s


DataStage Designer Menus

  • Automatically using .exe (link)

  • Manually using Designer’s Tools → Customize option (link)

Widget Connector
overlayyoutube
_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vm
width640px
urlhttps://www.youtube.com/watch?v=-2stJ7Epz04
height360px

Running time: 3m 31s


Define Work Item Management System

  • Authentication to Jira (link)

    • Generation of .pcks8 and .pem files for Workbench and Jira

    • Creating a Jira Application Link to Workbench

  • Define a Jira Work Item Management System in Workbench

  • Associate our Jira Project with our DataStage Project in Workbench

  • Test Work Item lookup using the Workbench Commit page

COMING SOON!


Install Unit Test Harness

  • Install Parallel Test Harness

    • Status
      colourBlue
      titleWINDOWS
      Using .exe file (not demonstrated)

    • Status
      colourYellow
      titleUNix
      Using .rpm file

  • Add $DM_ENABLE_UNIT_TESTING environment variable to DSParams

    • For demo project + template DSParams for future projects

  • Test Parallel Test Harness

    • Interception

    • Test

COMING SOON!


Onboarding a DataStage Project into Git

  • Use git pull to align your local Git repository with the remote repository

  • Export your DataStage project to the local Git repository

  • Use mettleci isx cut to separate it into individual assets

  • git add, git commit, and git push to get all your assets into Git

COMING SOON!