Creating a deployment definition

Use the New Deployment Definition wizard to define a deployment definition.

Before you begin

To use the deployments component, you must have a Developer for IBM® Enterprise Platforms client access license (CAL). Also, you must create a package by following the steps in the Creating a package definition task. Finally, you must have the following permissions:
Save Build Engine, Save Build Definition, Request Build, Save Build Result.
Request Deployment.
A project administrator can modify these permissions by right-clicking your project area, clicking Open, and then expanding the Team Configuration node from the Process Configuration tab in the Project Area editor.
Note: For Rational Team Concert™ version 4 or version 5, the IBM i and z/OS® scripts are consolidated, so the directory structure changed. If you upgrade from V3.0.1.x to V4.0 or later but continue to use the V3.0.1.x package and deployment definitions, the old scripts are used. If you create new package and deployment definitions, the new scripts are used. If you customized the scripts for version 3.0.1.x, make the same changes to the new V4.0 or later scripts. For more information, see


  1. In the Team Artifacts view, expand the Enterprise Extensions node, right-click Deployments, and select New Deployment Definition. The New Deployment Definition wizard opens.
  2. In the New Deployment Definition wizard, browse to a project or team area.
    Note: Usually, the project or team area is the same as the project or team area that contains the related package definition.
  3. Select Create a new deployment. (If another deployment definition is available, you can also choose Create a deployment by copying an existing deployment.) Click Next.
  4. Enter an ID and description, select the file system that you are using, and click Next. The following file system options are available:
    • IBM i
    • Linux/UNIX
    • z/OS
  5. Choose any additional configuration options and click Finish.


The new deployment definition opens in the Deployment Definition editor.

What to do next

Configure your deployment definition according to the steps required for your operating system.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki