- Created by James Hurrell, last modified on Apr 27, 2021
This documentation is no longer maintained and may contain obsolete information. You should instead refer to https://github.com/CAST-Extend/com.castsoftware.aip.console.tools for more information about automating source code delivery/analysis with AIP Console.
In this section:
Target audience:
- CAST administrators
- Delivery Managers
Introduction
Delivering source code for analysis with CAST AIP is achieved using the web based CAST AIC Portal and the CAST Delivery Manager Tool (DMT). These tools allow Delivery Managers to configure the extraction, validation and delivery of the source code of an Application that is the target of a CAST AIP analysis - you can find out more details about this in Onboarding an Application in CAST AIP.
If you, as a Delivery Manager, need to automate the delivery of your Application's source code for scheduled analysis with CAST AIP, then you can do so by using the CLI (Command Line Interface) provided with the DMT. This document explains how.
How does it work?
The CLI for the CAST Delivery Manager Tool has two modes, just like the GUI:
- With a CAST AIC Portal > i.e. when working with a CAST AIC Portal (via JNLP)
- Without a CAST AIC Portal > i.e. when working directly with the Delivery folder when no CAST AIC Portal is deployed (in GUI mode this is achieved using the CAST Management Studio)
The documentation is therefore divided into two distinct sections, listing commands that work with a CAST AIC Portal and those that work without a CAST AIC Portal.
CAST AIC Portal mode
In CAST AIC Portal mode, the CAST Delivery Manager Tool GUI is launched from the CAST AIC Portal using the Java Network Launch Protocol (JNLP). The same is true for the command line utility and as such, CAST highly recommends that you use batch files containing the required instructions to run your operations in this mode. The batch file requires certain common configuration parameters, and then commands and parameters that are specific to each action. These are explained below.
Please note that when launching the CAST Delivery Manager Tool using the CLI mode for the first time, you may be prompted that the application represents a security risk - which can hinder command line operations. Please do the following to prevent this dialog box displaying again in subsequent command line operations:
- Tick the "Do not show this again..." option
- Click Run.
Prerequisites
Before you can starting using the CLI in CAST AIC Portal mode you must ensure that you meet the following requirements:
All Delivery Managers must be working in CAST AIC Portal mode (i.e. using the DMT as a standalone tool installed from the CAST AIC Portal). | |
All Delivery Managers must have already downloaded and installed the CAST Delivery Manager Tool from the CAST AIC Portal and have the corresponding Application in their local cache of the DMT data. |
Required common batch file parameters
Each batch file you create requires the following common parameters to launch the CAST Delivery Manager Tool in command line mode - you should modify them all (except the JNLP_FILE parameter) and match them to your local environment:
Windows
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=<name of machine hosting CAST AIC Portal - see below> set AICPORTAL_PORT=<port used by the application server hosting the CAST AIC Portal, e.g.: 8080> set AICPORTAL_WEBAPP=<Name of the CAST AIC Portal web application, e.g.: CAST-AICPortal> set APPLICATION_ID=<Application ID - this can be found in the DMT in the Application screen and will consists of a string of random characters and letters - see below> set AUTH=<The DMT requires authentication with CAST AIC Portal credentials prior to launch - see below for format> set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%
Linux
AICPORTAL_HOST=<name of machine hosting CAST AIC Portal - see notes below> AICPORTAL_PORT=<port used by the application server hosting the CAST AIC Portal, e.g.: 8080> AICPORTAL_WEBAPP=<Name of the CAST AIC Portal web application, e.g.: CAST-AICPortal> APPLICATION_ID=<Application ID - this can be found in the DMT in the Application screen and will consist of a string of random characters and letters - see notes below> AUTH=<The DMT requires authentication with CAST AIC Portal credentials prior to launch - see notes below for format> JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP
Notes on parameters
AICPORTAL_HOST
Please note that the value used in the AICPORTAL_HOST variable is case sensitive. Ensure that you use the SAME case for the CAST AIC Portal host name as used when accessing the CAST AIC Portal in your web browser to download the GUI version of the CAST Delivery Manager Tool. This can be determined by looking at the start menu item for the GUI version of the CAST Delivery Manager Tool installed on your workstation.
For example - the host name is displayed as highlighted below:
Failure to do so will cause a second instance of the CAST Delivery Manager Tool to be downloaded when you run the batch file, and this will point to a different local workspace.
APPLICATION_ID
You can determine the APPLICATION_ID value in the CAST Delivery Manager Tool:
AUTH
The DMT requires authentication with the CAST AIC Portal credentials prior to launch - and this applies in command line mode as well as in GUI mode. Use the following format to define the credentials that you wish to use to authenticate when the command line is run - the example below shows the default "cast" username with the default "cast" password (modify this as required):
set AUTH=-username cast -password cast
This will send the username and password in clear-text - if you need to encrypt the password to improve security (highly recommended), you should instead generate an encryption key (please see Encrypting the password for the CAST Delivery Manager Tool command line for more information) for your password and use it as follows:
set AUTH=-username cast -authkey <your encrypted key>
For example:
set AUTH=-username cast -authkey u0tjM5qkCZO8IpzrD0CYUw==
If the authentication fails (incorrect username/password, or user not authorised), then the action specified in the command line will fail. If any errors occur, they will be logged in the latest CAST-jnlpInstaller.CastLog2 file created in C:\Users\<user_name>\AppData\Local\Temp, as shown by the following dialog:
Clicking OK will cause another dialog to be displayed:
By clicking the Details button you can see the java exception stack trace:
Command arguments
AutomateVersion
This option will automate:
- the creation of a new Version (copied from an existing version)
- the packaging of the exact same packages in the copied Version
- delivery of the new Version with the "close" option (i.e. the delivery is complete).
In other words this is a complete "rescan" mode".
application<string> | The name of the Application which contains the Version to copy. |
[version<string>] | The name of the version to copy. This parameter is optional. If you omit it, then the most recent Version will always be used as the source for the copy. |
name<string> | The name of the new Version. |
[releaseDate<date>] | The release date. This parameter is optional (defaults to current date if not set). |
[logFilePath<string>] | Specifies the exact log file path or a log directory path. This path must exist already! |
[username<string>] | Specifies the username to authenticate against the CAST AIC Portal. |
[password<string>] | Specifies the password to authenticate against the CAST AIC Portal. |
[authkey<string>] | Specifies the authentication key to decode and authenticate against the CAST AIC Portal. |
[proxy<string>] | Specifies the proxy to be used to connect to the CAST AIC Portal. |
[pxUsername<string>] | Specifies the username to authenticate against the proxy. |
[pxPassword<string>] | Specifies the password to authenticate against the proxy. |
[pxAuthkey<string>] | Specifies the authentication key to decode and authenticate against the proxy. |
Example batch files
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = AutomateVersion REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== set APPLICATION=MEUDON set VERSION=V1 set NAME=V2 set RELEASE_DATE=201809211700 set LOG_FILE_PATH=C:\TEMP set ACTION_AUTOMATE=AutomateVersion -application \"%APPLICATION%\" -version \"%VERSION%\" -name \"%NAME%\" -releaseDate \"%RELEASE_DATE%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_AUTOMATE%"
AICPORTAL_HOST=ceiriad AICPORTAL_PORT=8080 AICPORTAL_WEBAPP=CAST-AICPortal APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe AUTH=-username cast -password cast JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP APPLICATION=MEUDON VERSION=V1 NAME=V2 DATE=`date '+%Y%m%d%H%M'` RELEASE_DATE=$DATE LOG_FILE_PATH="log1" ACTION_AUTOMATE="AutomateVersion -application \"$APPLICATION\" -version \"$VERSION\" -name \"$NAME\" -releaseDate $RELEASE_DATE -logFilePath \"$LOG_FILE_PATH\"" "/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_AUTOMATE"
AddVersion
This option will automate the creation of a new Version (copied from an existing version).
[application<string>] | The name of the Application which contains the Version to copy. This parameter is optional. |
[version<string>] | The name of the version to copy. This parameter is optional. If you omit it, then the most recent Version will always be used as the source for the copy. |
name<string> | The name of the new Version. |
[releaseDate<date>] | The release date. This parameter is optional (defaults to current date if not set). |
[logFilePath<string>] | Specifies the exact log file path or a log directory path. This path must exist already! |
[username<string>] | Specifies the username to authenticate against the CAST AIC Portal. |
[password<string>] | Specifies the password to authenticate against the CAST AIC Portal. |
[authkey<string>] | Specifies the authentication key to decode and authenticate against the CAST AIC Portal. |
[proxy<string>] | Specifies the proxy to be used to connect to the CAST AIC Portal. |
[pxUsername<string>] | Specifies the username to authenticate against the proxy. |
[pxPassword<string>] | Specifies the password to authenticate against the proxy. |
[pxAuthkey<string>] | Specifies the authentication key to decode and authenticate against the proxy. |
Example:
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = AddVersion REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== set APPLICATION=MEUDON set VERSION=V1 set NAME=V2 set RELEASE_DATE=201809211700 set LOG_FILE_PATH=C:\TEMP set ACTION_AUTOMATE=AddVersion -application \"%APPLICATION%\" -version \"%VERSION%\" -name \"%NAME%\" -releaseDate \"%RELEASE_DATE%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_AUTOMATE%"
AICPORTAL_HOST=ceiriad AICPORTAL_PORT=8080 AICPORTAL_WEBAPP=CAST-AICPortal APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe AUTH=-username cast -password cast JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP APPLICATION=MEUDON VERSION=V1 NAME=V2 DATE=`date '+%Y%m%d%H%M'` RELEASE_DATE=$DATE LOG_FILE_PATH="log1" ACTION_AUTOMATE="AddVersion -application \"$APPLICATION\" -version \"$VERSION\" -name \"$NAME\" -releaseDate $RELEASE_DATE -logFilePath \"$LOG_FILE_PATH\"" "/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_AUTOMATE"
Generate
This option will automate the packaging action in the CAST Delivery Manager Tool.
[application<string>] | The name of the Application which contains the Version to package. This parameter is optional. |
[version<string>] | The name of the version to package. This parameter is optional. If you omit it, then the most recent Version will always be used as the source for the package action. |
[package<string>] | The name of the package to generate (if you want to generate a single package). |
[reset[<boolean>]] | If true, forces extraction of the package content (equivalent to the GUI option "Force extraction"). Default: false. |
[forceScan[<boolean>]] | If true, this option ensures the re-scanning of the source code (equivalent to the GUI option "Force scan"). This is necessary only when updating CAST AIP Extentions and the re-extraction of the source code is not needed. Default: false. |
[logFilePath<string>] | Specifies the exact log file path or a log directory path. This path must exist already! |
[username<string>] | Specifies the username to authenticate against the CAST AIC Portal. |
[password<string>] | Specifies the password to authenticate against the CAST AIC Portal. |
[authkey<string>] | Specifies the authentication key to decode and authenticate against the CAST AIC Portal. |
[proxy<string>] | Specifies the proxy to be used to connect to the CAST AIC Portal. |
[pxUsername<string>] | Specifies the username to authenticate against the proxy. |
[pxPassword<string>] | Specifies the password to authenticate against the proxy. |
[pxAuthkey<string>] | Specifies the authentication key to decode and authenticate against the proxy. |
Example:
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = Generate REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== set APPLICATION=MEUDON set VERSION=V1 set PACKAGE=TEST_PACKAGE set LOG_FILE_PATH=C:\TEMP set ACTION_GENERATE=Generate -application \"%APPLICATION%\" -version \"%VERSION%\" -package \"%PACKAGE%\" -reset -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_GENERATE%"
AICPORTAL_HOST=ceiriad AICPORTAL_PORT=8080 AICPORTAL_WEBAPP=CAST-AICPortal APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe AUTH=-username cast -password cast JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP APPLICATION=MEUDON VERSION=V1 PACKAGE=TEST_PACKAGE LOG_FILE_PATH="log1" ACTION_GENERATE="Generate -application \"$APPLICATION\" -version \"$VERSION\" -package \"$PACKAGE\" -reset -logFilePath \"$LOG_FILE_PATH\"" "/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_GENERATE"
Deliver
This option will automate the delivery action in the CAST Delivery Manager Tool.
application<string> | The name of the Application which contains the Version to deliver. |
[version<string>] | The name of the version to deliver. This parameter is optional. If you omit it, then the most recent Version will always be used as the source for the delivery action. |
[package<string>] | The name of the package to deliver (if you want to deliver a single package). |
[close[<boolean>]] | If true, closes the delivery and makes it read-only (equivalent to the GUI option "Close"). Default: false. |
[logFilePath<string>] | Specifies the exact log file path or a log directory path. This path must exist already! |
[username<string>] | Specifies the username to authenticate against the CAST AIC Portal. |
[password<string>] | Specifies the password to authenticate against the CAST AIC Portal. |
[authkey<string>] | Specifies the authentication key to decode and authenticate against the CAST AIC Portal. |
[proxy<string>] | Specifies the proxy to be used to connect to the CAST AIC Portal. |
[pxUsername<string>] | Specifies the username to authenticate against the proxy. |
[pxPassword<string>] | Specifies the password to authenticate against the proxy. |
[pxAuthkey<string>] | Specifies the authentication key to decode and authenticate against the proxy. |
Example:
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = Deliver REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== set APPLICATION=MEUDON set VERSION=V1 set LOG_FILE_PATH=C:\TEMP set ACTION_DELIVER=Deliver -application \"%APPLICATION%\" -version \"%VERSION%\" -close -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_DELIVER%"
AICPORTAL_HOST=ceiriad AICPORTAL_PORT=8080 AICPORTAL_WEBAPP=CAST-AICPortal APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe AUTH=-username cast -password cast JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP APPLICATION=MEUDON VERSION=V1 LOG_FILE_PATH="log1" ACTION_DELIVER="Deliver -application \"$APPLICATION\" -version \"$VERSION\" -close -logFilePath \"$LOG_FILE_PATH\"" "/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_DELIVER"
Refresh
This option will automate the refresh action in the CAST Delivery Manager Tool - i.e. to "download" any changes (i.e. new Versions or Packages, or changes to Versions or Packages) that may have been made by other Delivery Managers.
application<string> | The name of the Application which contains the Version to deliver. |
[version<string>] | The name of the version to deliver. This parameter is optional. If you omit it, then the most recent Version will always be used as the source for the delivery action. |
[package<string>] | The name of the package to deliver (if you want to deliver a single package). |
[logFilePath<string>] | Specifies the exact log file path or a log directory path. This path must exist already! |
[username<string>] | Specifies the username to authenticate against the CAST AIC Portal. |
[password<string>] | Specifies the password to authenticate against the CAST AIC Portal. |
[authkey<string>] | Specifies the authentication key to decode and authenticate against the CAST AIC Portal. |
[proxy<string>] | Specifies the proxy to be used to connect to the CAST AIC Portal. |
[pxUsername<string>] | Specifies the username to authenticate against the proxy. |
[pxPassword<string>] | Specifies the password to authenticate against the proxy. |
[pxAuthkey<string>] | Specifies the authentication key to decode and authenticate against the proxy. |
Example:
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = Refresh REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== set APPLICATION=MEUDON set VERSION=V1 set LOG_FILE_PATH=C:\TEMP set ACTION_REFRESH=Refresh -application \"%APPLICATION%\" -version \"%VERSION%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_REFRESH%"
AICPORTAL_HOST=ceiriad AICPORTAL_PORT=8080 AICPORTAL_WEBAPP=CAST-AICPortal APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe AUTH=-username cast -password cast JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP APPLICATION=MEUDON VERSION=V1 LOG_FILE_PATH="log1" ACTION_REFRESH="Refresh -application \"$APPLICATION\" -version \"$VERSION\" -logFilePath \"$LOG_FILE_PATH\"" "/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_REFRESH"
CreateVersionForLocal
Only available in CAST AIP ≥ 8.3.6.
This option will create a new Version (from scratch) via the CAST AIC Portal. There is no need to clone an existing Version.
application<string> | The name of the Application which contains the Version to deliver. |
name<string> | The name of the new Version to create from scratch. |
[logFilePath<string>] | Specifies the exact log file path or a log directory path. This path must exist already! |
[username<string>] | Specifies the username to authenticate against the CAST AIC Portal. |
[password<string>] | Specifies the password to authenticate against the CAST AIC Portal. |
[authkey<string>] | Specifies the authentication key to decode and authenticate against the CAST AIC Portal. |
[proxy<string>] | Specifies the proxy to be used to connect to the CAST AIC Portal. |
[pxUsername<string>] | Specifies the username to authenticate against the proxy. |
[pxPassword<string>] | Specifies the password to authenticate against the proxy. |
[pxAuthkey<string>] | Specifies the authentication key to decode and authenticate against the proxy. |
Example:
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = CreateVersionForLocal REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== set APPLICATION=MEUDON set NAME=V1 set LOG_FILE_PATH=C:\TEMP set ACTION_CREATEVERSIONFORLOCAL=CreateVersionForLocal -application \"%APPLICATION%\" -name \"%NAME%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEVERSIONFORLOCAL%"
AICPORTAL_HOST=ceiriad AICPORTAL_PORT=8080 AICPORTAL_WEBAPP=CAST-AICPortal APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe AUTH=-username cast -password cast JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP APPLICATION=MEUDON VERSION=V1 LOG_FILE_PATH="log1" ACTION_CREATEVERSIONFORLOCAL="CreateVersionForLocal -application \"$APPLICATION\" -name \"$NAME\" -logFilePath \"$LOG_FILE_PATH\"" "/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_REFRESH"
CreatePackageForLocal
Only available in CAST AIP ≥ 8.3.6.
This option will create a new Package via the CAST AIC Portal. You can configure all aspects of the package.
dmtdevdbtechno.SQLCASTDatabasePackage > Oracle Server
Requires the following options:
extractorType<string> | dmtdevsqlcastextractororacle.SQLCASTExtractor > CAST extractor for Oracle |
host<string> | Used to configure the host name of your Oracle Server. You can also enter an IP address if required. |
port<string> | Used to configure the port number for accessing your Oracle Server. The default port number for Oracle Server is 1521. |
service<string> or sid<string> | Choose either -service or -sid, i.e. the Service/SID name for accessing your database server. Please note that when connecting to a "pluggable database" (for example in Oracle 12c and above) you MUST use the Service option - the SID option will not function. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the required schemas on the selected server for packaging purposes. Please see the CAST Delivery Manager Tool help for more information about required privileges. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the database access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions of the same schemas on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
[rootPaths<string>] | Use this option to select the schemas you wish to extract.
|
Example
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = CreatePackageForLocal REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="dmtdevdbtechno.SQLCASTDatabasePackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevsqlcastextractororacle.SQLCASTExtractor" SET HOST="ORASERVER" SET PORT="1521" SET SERVICE="ORADB1" SET LOGIN_NAME="system" SET LOGIN_PASSWORD="my_password" SET REMEMBER_PASSWORD="Server" SET ROOT_PATHS="CASTPUBS;COOLCLUBS;BI" SET LOG_FILE_PATH="C:\TEMP" SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -host \"%HOST%\" -port \"%PORT%\" -service \"%SERVICE%\" -loginName \"%LOGIN_NAME%\" -loginPassword \"%LOGIN_PASSWORD%\" -rememberPassword \"%REMEMBER_PASSWORD%\" -rootPaths \"%ROOT_PATHS%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"
dmtdevmainframetechno.MainframePackage > Mainframe (IBM zOS PDS (Partitioned Data Set) dump extraction)
extractorType<string> | dmtdevmainframeextractor.MainframeExtractor > IBM zOS PDS (Partitioned Data Set) dump extraction |
libraryFilePath<string> | Enter the absolute location of your PDS dump file. |
extension<string> | This option enables you to choose the content of the PDS dump file that will be extracted an packaged. Filters are based on file extensions and can be one of the following:
|
banner<text> | Indicates the left hand part of the banner in the PDS dump excluding the member name. This determines the start of each member - this is used by the CAST Delivery Manager Tool to identify each member. |
leftMargin<integer> | Indicates the line column(s) in which system characters are present. This column (or columns) are ignored during the extraction and packaging process and are not transferred to file. |
lineMaxLength<integer> | For each member line that will be extracted, this value indicates the line max size that will be retained during the extraction to file. Any characters that are located in the line beyond the line max size will be ignored during the extraction and packaging process and are not transferred to file. |
Example
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = CreatePackageForLocal REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="dmtdevmainframetechno.MainframePackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevmainframeextractor.MainframeExtractor" SET LIBRARY="C:\PDS_DUMP" SET EXTENSION="CobolProgram" SET BANNER="VMEMBER NAME" SET LEFT_MARGIN="1" SET MAX_LENGTH="80" SET LOG_FILE_PATH="C:\TEMP" SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName "%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -libraryFilePath \"%LIBRARY%\" -extension \"%EXTENSION%\" -banner \"%BANNER%\" -leftMargin \"%LEFT%\" -lineMaxLength \"%MAX_LENGTH%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"
delivery.SourceFilesPackage > Files on your system
Requires the following options:
extractorType<string> | dmtdevfolderextractor.SourceFolderExtractor > Folder on your local file system |
folderPath<string> | Enter the absolute location of the folder that contains your target source code. This can be a network location or a folder on your local machine. |
[originalLocation<string>] | If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path). |
Example
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = CreatePackageForLocal REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="delivery.SourceFilesPackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevfolderextractor.SourceFolderExtractor" SET FOLDER_PATH="C:\SOURCE_CODE" SET LOG_FILE_PATH="C:\TEMP" SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -folderPath \"%FOLDER_PATH%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"
delivery.SourceFilesPackage > Subversion using svnkit
extractorType<string> | dmtdevsvnextractor.SVNExtractor > Folder on your local file system |
connectionURL<string> | Enter the URL of your Subversion repository. You can use either the https:// or svn:// protocols. |
revision<string> | Enter the specific revision of source code that you require, for example HEAD. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the SVN repository. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the SVN access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
[originalLocation<string>] | If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path). |
Example
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = CreatePackageForLocal REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="delivery.SourceFilesPackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevsvnextractor.SVNExtractor" SET CONNECTION_URL="svn://server/trunk/test" SET REVISION="HEAD" SET LOGIN_NAME="svn_user" SET LOGIN_PASSWORD="my_password" SET REMEMBER_PASSWORD="Server" SET LOG_FILE_PATH="C:\TEMP" SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -connectionURL \"%CONNECTION_URL%\" -revision \"%REVISION%\" -loginName \"%LOGIN_NAME%\" -loginPassword \"%LOGIN_PASSWORD%\" -rememberPassword \"%REMEMBER_PASSWORD%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"
dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven HTTP repository
extractorType<string> | dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor > Maven Http repository |
connectionURL<string> | Enter the URL of your Maven repository. You can use either the https:// or http:// protocols. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the Maven repository. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the Maven access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
Example
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = CreatePackageForLocal REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor" SET CONNECTION_URL="https://server/test" SET LOGIN_NAME="maven_user" SET LOGIN_PASSWORD="my_password" SET REMEMBER_PASSWORD="Server" SET LOG_FILE_PATH="C:\TEMP" SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -connectionURL \"%CONNECTION_URL%\" -loginName \"%LOGIN_NAME%\" -loginPassword \"%LOGIN_PASSWORD%\" -rememberPassword \"%REMEMBER_PASSWORD%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"
dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven repository on your file system
extractorType<string> | dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor > Maven repository on your file system |
folderPath<string> | Enter the absolute location of the folder that contains your Maven repository. This can be a network location or a folder on your local machine. |
Example
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = CreatePackageForLocal REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor" SET FOLDER_PATH="C:\MAVEN\REPO" SET LOG_FILE_PATH="C:\TEMP" SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -folderPath \"%FOLDER_PATH%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"
dmtdevmicrosofttechno.NetResourceFilesPackage > Automated extraction of required .NET assemblies
Requires the following:
extractorType<string> | dmtdevnetresourcesextractor.NetResourceFolderExtractor > Maven repository on your file system |
folderPath<string> | Enter the absolute location of the folder that contains your Microsoft .NET Framework system assemblies. This can be a network location or a folder on your local machine, e.g.: "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>". If "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>" is NOT available on the machine, please use the most recent framework installed on the machine instead: "C:\Windows\Microsoft.NET\Framework64\<use the most recent>". |
Example
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = CreatePackageForLocal REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="dmtdevmicrosofttechno.NetResourceFilesPackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevnetresourcesextractor.NetResourceFolderExtractor" SET FOLDER_PATH="C:\Windows\Microsoft.NET\Framework64\v4.0.30319" SET LOG_FILE_PATH="C:\TEMP" SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -folderPath \"%FOLDER_PATH%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"
UpdatePackageForLocal
Only available in CAST AIP ≥ 8.3.6.
This option will update an existing Package via the CAST AIC Portal. . You can configure all aspects of the existing package:
application<string> | The name of the Application which contains your existing Version/Package. | |
versionName<string> | The name of the Version which contains your existing Package. | |
storagePath<string> | The location (path) of the Delivery folder that contains the Application/Version/Package. | |
packageName<string> | The name of the package you want to update. | |
[logFilePath<string>] | Specifies the exact log file path or a log directory path. This path must exist already! |
Depending on the type of package you are updating, additional parameters will be necessary to make the updates as follows:
dmtdevdbtechno.SQLCASTDatabasePackage > Oracle Server
Requires the following options:
extractorType<string> | dmtdevsqlcastextractororacle.SQLCASTExtractor > CAST extractor for Oracle |
host<string> | Used to configure the host name of your Oracle Server. You can also enter an IP address if required. |
port<string> | Used to configure the port number for accessing your Oracle Server. The default port number for Oracle Server is 1521. |
service<string> or sid<string> | Choose either -service or -sid, i.e. the Service/SID name for accessing your database server. Please note that when connecting to a "pluggable database" (for example in Oracle 12c and above) you MUST use the Service option - the SID option will not function. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the required schemas on the selected server for packaging purposes. Please see the CAST Delivery Manager Tool help for more information about required privileges. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the database access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions of the same schemas on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
[rootPaths<string>] | Use this option to select the schemas you wish to extract.
|
dmtdevmainframetechno.MainframePackage > Mainframe (IBM zOS PDS (Partitioned Data Set) dump extraction)
extractorType<string> | dmtdevmainframeextractor.MainframeExtractor > IBM zOS PDS (Partitioned Data Set) dump extraction |
libraryFilePath<string> | Enter the absolute location of your PDS dump file. |
extension<string> | This option enables you to choose the content of the PDS dump file that will be extracted an packaged. Filters are based on file extensions and can be one of the following:
|
banner<text> | Indicates the left hand part of the banner in the PDS dump excluding the member name. This determines the start of each member - this is used by the CAST Delivery Manager Tool to identify each member. |
leftMargin<integer> | Indicates the line column(s) in which system characters are present. This column (or columns) are ignored during the extraction and packaging process and are not transferred to file. |
lineMaxLength<integer> | For each member line that will be extracted, this value indicates the line max size that will be retained during the extraction to file. Any characters that are located in the line beyond the line max size will be ignored during the extraction and packaging process and are not transferred to file. |
delivery.SourceFilesPackage > Files on your system
Requires the following options:
extractorType<string> | dmtdevfolderextractor.SourceFolderExtractor > Folder on your local file system |
folderPath<string> | Enter the absolute location of the folder that contains your target source code. This can be a network location or a folder on your local machine. |
[originalLocation<string>] | If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path). |
delivery.SourceFilesPackage > Subversion using svnkit
extractorType<string> | dmtdevsvnextractor.SVNExtractor > Folder on your local file system |
connectionURL<string> | Enter the URL of your Subversion repository. You can use either the https:// or svn:// protocols. |
revision<string> | Enter the specific revision of source code that you require, for example HEAD. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the SVN repository. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the SVN access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
[originalLocation<string>] | If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path). |
dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven HTTP repository
extractorType<string> | dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor > Maven Http repository |
connectionURL<string> | Enter the URL of your Maven repository. You can use either the https:// or http:// protocols. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the Maven repository. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the Maven access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven repository on your file system
extractorType<string> | dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor > Maven repository on your file system |
folderPath<string> | Enter the absolute location of the folder that contains your Maven repository. This can be a network location or a folder on your local machine. |
dmtdevmicrosofttechno.NetResourceFilesPackage > Automated extraction of required .NET assemblies
Requires the following:
extractorType<string> | dmtdevnetresourcesextractor.NetResourceFolderExtractor > Maven repository on your file system |
folderPath<string> | Enter the absolute location of the folder that contains your Microsoft .NET Framework system assemblies. This can be a network location or a folder on your local machine, e.g.: "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>". If "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>" is NOT available on the machine, please use the most recent framework installed on the machine instead: "C:\Windows\Microsoft.NET\Framework64\<use the most recent>". |
Example
REM =============================================== REM = DMT - Configuration REM = Please do not change the JNLP_FILE parameter REM =============================================== set AICPORTAL_HOST=ceiriad set AICPORTAL_PORT=8080 set AICPORTAL_WEBAPP=CAST-AICPortal set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe set AUTH=-username cast -password cast set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP% REM ======================================================== REM = UpdatePackageForLocal REM = Please only modify the path to your Java JRE "bin" folder REM = note the quote marks that must be used for this path REM = if it contains spaces. REM ======================================================== SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_NAME="test_package" SET HOST="ORASERVER1" SET PORT="1521" SET SERVICE="ORADB2" SET LOGIN_NAME="system" SET LOGIN_PASSWORD="my_password" SET REMEMBER_PASSWORD="Server" SET ROOT_PATHS="CASTPUBS;COOLCLUBS;BI;NEW" SET LOG_FILE_PATH="C:\TEMP" SET ACTION_UPDATEPACKAGEFORLOCAL=UpdatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageName \"%PACKAGE_NAME%\" -host \"%HOST%\" -port \"%PORT%\" -service \"%SERVICE%\" -loginName \"%LOGIN_NAME%\" -loginPassword \"%LOGIN_PASSWORD%\" -rememberPassword \"%REMEMBER_PASSWORD%\" -rootPaths \"%ROOT_PATHS%\" -logFilePath \"%LOG_FILE_PATH%\" "C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_UPDATEPACKAGEFORLOCAL%"
Without CAST AIC Portal mode
To execute an action via the command line in this mode you must specify the DeliveryManagerTool-CLI.exe executable available in the DeliveryManagerTool folder in the CAST AIP installation folder. Command arguments are expressed as verbs and then various mandatory and optional (enclosed in square brackets) options. Each command argument verb and various examples is listed and explained below.
Prerequisites
Before you can starting using the CLI in CAST AIC Portal mode you must ensure that you meet the following requirements:
Ensure you have access to the Delivery folder. |
Miscellaneous information
Boolean format: [true|false]
String format: enclose with double quotes if containing blank spaces
- Date format: [yyyyMMdd|yyyyMMddHHmm]
- The examples listed below should be placed on one line if they are being used in a batch file.
- Use the -help command to list all possible parameters for an argument, for example:
DeliveryManagerTool-CLI.exe AddVersion -help
Output codes
The CLI will return two output codes:
- 0 = No error
- 2 = Error exists
Command arguments
CreateServerApplication
Only available in CAST AIP ≥ 8.3.6.
This option will create a new Application directly in the Delivery folder.
name<string> | The name of the Application you want to create. |
storagePath<string> | The location (path) of the Delivery folder you want to create the Application in. |
[logFilePath<string>] | Specifies the exact log file path or a log directory path. This path must exist already! |
[username<string>] | Specifies the username to authenticate against the CAST AIC Portal. |
[password<string>] | Specifies the password to authenticate against the CAST AIC Portal. |
[authkey<string>] | Specifies the authentication key to decode and authenticate against the CAST AIC Portal. |
[proxy<string>] | Specifies the proxy to be used to connect to the CAST AIC Portal. |
[pxUsername<string>] | Specifies the username to authenticate against the proxy. |
[pxPassword<string>] | Specifies the password to authenticate against the proxy. |
[pxAuthkey<string>] | Specifies the authentication key to decode and authenticate against the proxy. |
Example
SET APPLICATION="MEUDON" SET STORAGE_PATH="E:\CAST\Delivery" SET LOG_FILE_PATH="C:\TEMP" "%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" createServerApplication -name %APPLICATION% -storagePath %STORAGE_PATH% -logFilePath %LOG_FILE_PATH%
CreateVersionForServer
Only available in CAST AIP ≥ 8.3.6.
This option will create a new Version directly in the Delivery folder.
application<string> | The name of the Application in which you want to create the new Version. |
name<string> | The name of the new Version to create. |
[releaseDate<date>] | The release date. This parameter is optional (defaults to current date if not set). |
storagePath<string> | The location (path) of the Delivery folder that contains the Application in which you want to create the new Version. |
[logFilePath<string>] | Specifies the exact log file path or a log directory path. This path must exist already! |
[username<string>] | Specifies the username to authenticate against the CAST AIC Portal. |
[password<string>] | Specifies the password to authenticate against the CAST AIC Portal. |
[authkey<string>] | Specifies the authentication key to decode and authenticate against the CAST AIC Portal. |
[proxy<string>] | Specifies the proxy to be used to connect to the CAST AIC Portal. |
[pxUsername<string>] | Specifies the username to authenticate against the proxy. |
[pxPassword<string>] | Specifies the password to authenticate against the proxy. |
[pxAuthkey<string>] | Specifies the authentication key to decode and authenticate against the proxy. |
Example
SET APPLICATION="MEUDON" SET NAME="V1" SET RELEASE_DATE=201809211700 SET STORAGE_PATH="E:\CAST\Delivery" SET LOG_FILE_PATH="C:\TEMP" "%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreateVersionForServer -application %APPLICATION% -name %NAME% -releaseDate %RELEASE_DATE% -storagePath %STORAGE_PATH% -logFilePath %LOG_FILE_PATH%
CreatePackageForServer
Only available in CAST AIP ≥ 8.3.6.
This option will create a new Package directly in the Delivery folder. You can configure all aspects of the package.
dmtdevdbtechno.SQLCASTDatabasePackage > Oracle Server
Requires the following options:
extractorType<string> | dmtdevsqlcastextractororacle.SQLCASTExtractor > CAST extractor for Oracle |
host<string> | Used to configure the host name of your Oracle Server. You can also enter an IP address if required. |
port<string> | Used to configure the port number for accessing your Oracle Server. The default port number for Oracle Server is 1521. |
service<string> or sid<string> | Choose either -service or -sid, i.e. the Service/SID name for accessing your database server. Please note that when connecting to a "pluggable database" (for example in Oracle 12c and above) you MUST use the Service option - the SID option will not function. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the required schemas on the selected server for packaging purposes. Please see the CAST Delivery Manager Tool help for more information about required privileges. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the database access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions of the same schemas on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
[rootPaths<string>] | Use this option to select the schemas you wish to extract.
|
Example
SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="dmtdevdbtechno.SQLCASTDatabasePackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevsqlcastextractororacle.SQLCASTExtractor" SET HOST="ORASERVER" SET PORT="1521" SET SERVICE="ORADB1" SET LOGIN_NAME="system" SET LOGIN_PASSWORD="my_password" SET REMEMBER_PASSWORD="Server" SET ROOT_PATHS="CASTPUBS;COOLCLUBS;BI" SET LOG_FILE_PATH="C:\TEMP" "%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -host %HOST% -port %PORT% -service %SERVICE% -loginName %LOGIN_NAME% -loginPassword %LOGIN_PASSWORD% -rememberPassword %REMEMBER_PASSWORD% -rootPaths %ROOT_PATHS% -logFilePath %LOG_FILE_PATH%
dmtdevmainframetechno.MainframePackage > Mainframe (IBM zOS PDS (Partitioned Data Set) dump extraction)
extractorType<string> | dmtdevmainframeextractor.MainframeExtractor > IBM zOS PDS (Partitioned Data Set) dump extraction |
libraryFilePath<string> | Enter the absolute location of your PDS dump file. |
extension<string> | This option enables you to choose the content of the PDS dump file that will be extracted an packaged. Filters are based on file extensions and can be one of the following:
|
banner<text> | Indicates the left hand part of the banner in the PDS dump excluding the member name. This determines the start of each member - this is used by the CAST Delivery Manager Tool to identify each member. |
leftMargin<integer> | Indicates the line column(s) in which system characters are present. This column (or columns) are ignored during the extraction and packaging process and are not transferred to file. |
lineMaxLength<integer> | For each member line that will be extracted, this value indicates the line max size that will be retained during the extraction to file. Any characters that are located in the line beyond the line max size will be ignored during the extraction and packaging process and are not transferred to file. |
Example
SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="dmtdevmainframetechno.MainframePackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevmainframeextractor.MainframeExtractor" SET LIBRARY="C:\PDS_DUMP" SET EXTENSION="CobolProgram" SET BANNER="VMEMBER NAME" SET LEFT_MARGIN="1" SET MAX_LENGTH="80" SET LOG_FILE_PATH="C:\TEMP" "%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -libraryFilePath %LIBRARY% -extension %EXTENSION% -banner %BANNER% -leftMargin %LEFT% -lineMaxLength %MAX_LENGTH% -logFilePath %LOG_FILE_PATH%
delivery.SourceFilesPackage > Files on your system
Requires the following options:
extractorType<string> | dmtdevfolderextractor.SourceFolderExtractor > Folder on your local file system |
folderPath<string> | Enter the absolute location of the folder that contains your target source code. This can be a network location or a folder on your local machine. |
[originalLocation<string>] | If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path). |
Example
SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="delivery.SourceFilesPackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevfolderextractor.SourceFolderExtractor" SET FOLDER_PATH="C:\SOURCE_CODE" SET LOG_FILE_PATH="C:\TEMP" "%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -folderPath %FOLDER_PATH% -logFilePath %LOG_FILE_PATH%
delivery.SourceFilesPackage > Subversion using svnkit
extractorType<string> | dmtdevsvnextractor.SVNExtractor > Folder on your local file system |
connectionURL<string> | Enter the URL of your Subversion repository. You can use either the https:// or svn:// protocols. |
revision<string> | Enter the specific revision of source code that you require, for example HEAD. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the SVN repository. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the SVN access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
[originalLocation<string>] | If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path). |
Example
SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="delivery.SourceFilesPackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevsvnextractor.SVNExtractor" SET CONNECTION_URL="svn://server/trunk/test" SET REVISION="HEAD" SET LOGIN_NAME="svn_user" SET LOGIN_PASSWORD="my_password" SET REMEMBER_PASSWORD="Server" SET LOG_FILE_PATH="C:\TEMP" "%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -connectionURL %CONNECTION_URL% -revision %REVISION% -loginName %LOGIN_NAME% -loginPassword %LOGIN_PASSWORD% -rememberPassword %REMEMBER_PASSWORD% -logFilePath %LOG_FILE_PATH%
dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven HTTP repository
extractorType<string> | dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor > Maven Http repository |
connectionURL<string> | Enter the URL of your Maven repository. You can use either the https:// or http:// protocols. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the Maven repository. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the Maven access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
Example
SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor" SET CONNECTION_URL="https://server/test" SET LOGIN_NAME="maven_user" SET LOGIN_PASSWORD="my_password" SET REMEMBER_PASSWORD="Server" SET LOG_FILE_PATH="C:\TEMP" "%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -connectionURL %CONNECTION_URL% -loginName %LOGIN_NAME% -loginPassword %LOGIN_PASSWORD% -rememberPassword %REMEMBER_PASSWORD% -logFilePath %LOG_FILE_PATH%
dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven repository on your file system
extractorType<string> | dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor > Maven repository on your file system |
folderPath<string> | Enter the absolute location of the folder that contains your Maven repository. This can be a network location or a folder on your local machine. |
Example
SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor" SET FOLDER_PATH="C:\MAVEN\REPO" SET LOG_FILE_PATH="C:\TEMP" "%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -folderPath %FOLDER_PATH% -logFilePath %LOG_FILE_PATH%
dmtdevmicrosofttechno.NetResourceFilesPackage > Automated extraction of required .NET assemblies
Requires the following:
extractorType<string> | dmtdevnetresourcesextractor.NetResourceFolderExtractor > Maven repository on your file system |
folderPath<string> | Enter the absolute location of the folder that contains your Microsoft .NET Framework system assemblies. This can be a network location or a folder on your local machine, e.g.: "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>". If "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>" is NOT available on the machine, please use the most recent framework installed on the machine instead: "C:\Windows\Microsoft.NET\Framework64\<use the most recent>". |
Example
SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_TYPE="dmtdevmicrosofttechno.NetResourceFilesPackage" SET PACKAGE_NAME="test_package" SET EXTRACTOR_TYPE="dmtdevnetresourcesextractor.NetResourceFolderExtractor" SET FOLDER_PATH="C:\Windows\Microsoft.NET\Framework64\v4.0.30319" SET LOG_FILE_PATH="C:\TEMP" "%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -folderPath %FOLDER_PATH% -logFilePath %LOG_FILE_PATH%
UpdatePackageForServer
Only available in CAST AIP ≥ 8.3.6.
This option will update an existing Package directly in the Delivery folder. You can configure all aspects of the existing package:
application<string> | The name of the Application which contains your existing Version/Package. | |
versionName<string> | The name of the Version which contains your existing Package. | |
storagePath<string> | The location (path) of the Delivery folder that contains the Application/Version/Package. | |
packageName<string> | The name of the package you want to update. | |
[logFilePath<string>] | Specifies the exact log file path or a log directory path. This path must exist already! |
Depending on the type of package you are updating, additional parameters will be necessary to make the updates as follows:
dmtdevdbtechno.SQLCASTDatabasePackage > Oracle Server
Requires the following options:
extractorType<string> | dmtdevsqlcastextractororacle.SQLCASTExtractor > CAST extractor for Oracle |
host<string> | Used to configure the host name of your Oracle Server. You can also enter an IP address if required. |
port<string> | Used to configure the port number for accessing your Oracle Server. The default port number for Oracle Server is 1521. |
service<string> or sid<string> | Choose either -service or -sid, i.e. the Service/SID name for accessing your database server. Please note that when connecting to a "pluggable database" (for example in Oracle 12c and above) you MUST use the Service option - the SID option will not function. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the required schemas on the selected server for packaging purposes. Please see the CAST Delivery Manager Tool help for more information about required privileges. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the database access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions of the same schemas on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
[rootPaths<string>] | Use this option to select the schemas you wish to extract.
|
dmtdevmainframetechno.MainframePackage > Mainframe (IBM zOS PDS (Partitioned Data Set) dump extraction)
extractorType<string> | dmtdevmainframeextractor.MainframeExtractor > IBM zOS PDS (Partitioned Data Set) dump extraction |
libraryFilePath<string> | Enter the absolute location of your PDS dump file. |
extension<string> | This option enables you to choose the content of the PDS dump file that will be extracted an packaged. Filters are based on file extensions and can be one of the following:
|
banner<text> | Indicates the left hand part of the banner in the PDS dump excluding the member name. This determines the start of each member - this is used by the CAST Delivery Manager Tool to identify each member. |
leftMargin<integer> | Indicates the line column(s) in which system characters are present. This column (or columns) are ignored during the extraction and packaging process and are not transferred to file. |
lineMaxLength<integer> | For each member line that will be extracted, this value indicates the line max size that will be retained during the extraction to file. Any characters that are located in the line beyond the line max size will be ignored during the extraction and packaging process and are not transferred to file. |
delivery.SourceFilesPackage > Files on your system
Requires the following options:
extractorType<string> | dmtdevfolderextractor.SourceFolderExtractor > Folder on your local file system |
folderPath<string> | Enter the absolute location of the folder that contains your target source code. This can be a network location or a folder on your local machine. |
[originalLocation<string>] | If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path). |
delivery.SourceFilesPackage > Subversion using svnkit
extractorType<string> | dmtdevsvnextractor.SVNExtractor > Folder on your local file system |
connectionURL<string> | Enter the URL of your Subversion repository. You can use either the https:// or svn:// protocols. |
revision<string> | Enter the specific revision of source code that you require, for example HEAD. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the SVN repository. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the SVN access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
[originalLocation<string>] | If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path). |
dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven HTTP repository
extractorType<string> | dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor > Maven Http repository |
connectionURL<string> | Enter the URL of your Maven repository. You can use either the https:// or http:// protocols. |
loginName<string> | Used to configure the user name that has sufficient privileges to access the Maven repository. |
loginPassword<string> | Used to configure the password that corresponds to your User name configured in -loginName<string>. |
rememberPassword<string> | This option enables you to save the Maven access credentials you have entered. Choose one of:
Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information. |
dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven repository on your file system
extractorType<string> | dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor > Maven repository on your file system |
folderPath<string> | Enter the absolute location of the folder that contains your Maven repository. This can be a network location or a folder on your local machine. |
dmtdevmicrosofttechno.NetResourceFilesPackage > Automated extraction of required .NET assemblies
Requires the following:
extractorType<string> | dmtdevnetresourcesextractor.NetResourceFolderExtractor > Maven repository on your file system |
folderPath<string> | Enter the absolute location of the folder that contains your Microsoft .NET Framework system assemblies. This can be a network location or a folder on your local machine, e.g.: "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>". If "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>" is NOT available on the machine, please use the most recent framework installed on the machine instead: "C:\Windows\Microsoft.NET\Framework64\<use the most recent>". |
Example
SET APPLICATION="MEUDON" SET VERSION_NAME="V1" SET STORAGE_PATH="E:\CAST\Delivery" SET PACKAGE_NAME="test_package" SET HOST="ORASERVER1" SET PORT="1521" SET SERVICE="ORADB2" SET LOGIN_NAME="system" SET LOGIN_PASSWORD="my_password" SET REMEMBER_PASSWORD="Server" SET ROOT_PATHS="CASTPUBS;COOLCLUBS;BI;NEW" SET LOG_FILE_PATH="C:\TEMP" "%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" UpdatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageName %PACKAGE_NAME% -host %HOST% -port %PORT% -service %SERVICE% -loginName %LOGIN_NAME% -loginPassword %LOGIN_PASSWORD% -rememberPassword %REMEMBER_PASSWORD% -rootPaths %ROOT_PATHS% -logFilePath %LOG_FILE_PATH%
- No labels