DataStage Create-Project Command

Purpose

This command either creates a DataStage project in a nominated environment or simply exist with a success code if the DataStage project already exists. It is used frequently at the beginning of pipelines to assert that a target environment with which the pipeline will deploy and execute code is present and available.

Syntax

Syntax : datastage create-project [options]

Description

• -domain

  Services Tier (required)

  Required

• -server

  Engine Tier (required)

  Required

• -project

  Project Name (required)

  Required

• -path

  Project path (optional - defaults to standard location beneath the DataStage Projects directory, must include project name in path and it must match the project parameter)

• -username

  User Name (required)

  Required

• -password

  Password (required)

  Required

Example

$> mettleci datastage create-project \
   -domain service_tier.datamigrators.io:59445 \
   -username isadmin -password mypassword \
   -server engine_tier.datamigrators.io \
   -project Test4

Test4 created successfully.
$>

Usage Notes

Due to a known issue with the DataStage dsadmin command itself it is not possible to distinguish between…

• a DataStage project that already exists, and

• a DataStage project that doesn’t exist in the DataStage repository, but for which the associated filesystem directories does exist.

There may be some situations in which this causes the create-project command to fail.

When faced with an inexplicable failure of this nature check to see if the project’s directory structure already exists on the filesystem. If so, and it’s safe to do so, remove the file structure and try again

See also

• The `mettleci datastage create-project` command fails