DataStage Deploy Command

Purpose

This command deploys a specified directory containing one or more DataStage ISX files to a specified target DataStage environment (project).

the datastage deploy command performs incremental deployment.
the -assets parameter specifies the deployment source directory containing ISX files.
the -project value is the name of the DataStage target project.
the -project-cache parameter specifies a shared directory containing state information for this DataStage target project. These are the DataStage asset fingerprints which are used to identify changes in your DataStage code. See our more detailed explanation.
the -threads parameter specifies how many concurrent compilation operations will be performed.
DataStage compilation results are converted to test results in JUnit format.

See Repeatable DataStage Project Deployments for more details on how the -project-cache parameter is used to implement incremental deployment.

Syntax

Syntax : datastage deploy [options]

Description

-domain
Services tier
Required
-server
Engine tier
Required
-username
User name
Required
-password
Password
Required
-project
Project name
Required
-assets
Root directory containing ISX assets to be deployed
Required
-parameter-sets
Root directory containing Parameter Set Value files to be deployed with ISX files
-project-cache
Project cache directory
Required
-threads
Number of execution threads
-include-job-in-test-name
Test case names will include the job name in the compilation jUnit report

Example

BASH

c:\> mettleci datastage deploy
     -domain datastage-services.myorganization.com:59445
     -server datastage-engine.myorganization.com
     -project wwi_jenkins_ds_115_ci
     -username isadmin
     -password ****
     -assets datastage
     -parameter-sets "config\Parameter Sets"
     -threads 1
     -project-cache "C:\MettleCI\cache\datastage-engine.myorganization.com\jenkins_project" 

MettleCI Command Line (build 128)
(C) 2018-2022 Data Migrators Pty Ltd
Analyzing datastage-engine.myorganization.com/myproject
Attempting to identify changes with 4 working threads.
Inspecting DataStage assets for changes...
* Check datastage-engine.myorganization.com/myproject/Jobs/Transform/TR_CITY.pjb - CHANGED
Change identification complete, 1 asset changes detected in project
Deleting assets...
* Delete 'datastage-engine.myorganization.com/myproject/Jobs/Transform/TR_CITY.pjb' - COMPLETED
Deletion complete
Optimising assets for import
* Update 'Jobs/ParameterSets/pGlobal.pst' - COMPLETED
* Update 'Jobs/ParameterSets/pDMSqlServer_DW.pst' - COMPLETED
s* Update 'Jobs/ParameterSets/pDMSqlServer_OLTP.pst' - COMPLETED
Attempting to import with 1 working threads.
Importing DataStage assets...
* Import 'datastage-engine.myorganization.com/myproject/Jobs/ParameterSets/pDMSqlServer_OLTP.pst' - COMPLETED
* Import 'datastage-engine.myorganization.com/myproject/Jobs/ParameterSets/pDMSqlServer_DW.pst' - COMPLETED
* Import 'datastage-engine.myorganization.com/myproject/Jobs/ParameterSets/pGlobal.pst' - COMPLETED
* Import 'datastage-engine.myorganization.com/myproject/Jobs/Transform/TR_CITY.pjb' - COMPLETED
Import complete
Compiling DataStage jobs...
* Compile 'datastage-engine.myorganization.com/myproject/Jobs/Transform/TR_CITY.pjb' - COMPLETED
Compilation complete
sCreating JUnit test suite
JUnit test suite (mettleci_compilation.xml) created successfully
Attempting to identify last change with 4 working threads.
Inspecting DataStage assets for last change...
Last change to project occurred at 2023-12-17 22:07:00 GMT