Before you can starting using the CAST Architecture, you must ensure that you meet the following requirements:
|An installation of CAST AIP Core is required, which must be located on the machine you wish to run the CLI from.|
How does it work?
The CAST Architecture Checker CLI can perform the following actions:
- Check an Architecture Model against an Application
To execute an action via the command line, you must specify the CAST-ArchiChecker-CLI.exe executable (rather than the CAST-ArchiChecker.exe executable which is used for the GUI). Command arguments are expressed as verbs introduced by a dash (-), followed by various mandatory arguments that must be enclosed with double quotes (") if containing blank spaces. Some command arguments should appear only once (such as -connectionProfile for example), whereas others can appear as many times as necessary.
For options which require a file path, if the given path is not absolute, the file will be created into, or read from, the same CAST AIP temporary directory as used by the CAST Management Studio.
Boolean format: [YES|NO|CANCEL]
String format: enclose with double quotes if containing blank spaces
- The examples listed below should be placed on one line if they are being used in a batch file.
This option allows you to run a check model action (the same action available in the GUI) against an Application. Results are displayed in text format.
|-connectionProfile ["]<connection-profile-name>["]||Specifies the name of connection profile to use to connect to the CAST Management Service on which your Application is stored.|
|Specifies the Application you want to check the Architecture model against.|
-model ["]<path to Architecture model>["]
|Specifies the location (full path) on disk/network storage of the .CASTArchitect file containing the Architecture model you want to check.|
|-noGUI||Forces the command line to be run without the GUI.|
Results with violations
The -checkModel results (i.e. the violations to the Architecture Model) will be printed in the standard output, using the following format (note that all the lines containing a violation element will have the prefix "VIOLATION:"). The separator that will be used between the different fields will be a tabulation ('\t'):
Results without violations
If the -checkModel action does not return any violations, this will be displayed:
|Action ran successfully.|
|EXIT_CONNECTION_FAILURE(1)||An error was raised while attempting to connect to the Management Service schema defined in the connection profile.|
|EXIT_FAILURE(2)||General error code.|
|EXIT_INIT_FAILURE(3)||An error occurred during the initialization phase.|
|EXIT_OPEN_MODEL_FAILURE(4)||An error occurred while attempting to access the Architecture model file (.CASTArchitect).|
|EXIT_SELECT_APP_FAILURE(5)||An error occured while attempting to access the Application.|
|EXIT_SPA_FAILURE(6)||An error occurred during the prepare snapshot operation (this will only occur when running the action against an Application that does not contain any snapshots.|
|EXIT_CHECK_MODEL_FAILURE(7)||An error occured during the check model operation.|
All logs for the -checkModel action are stored in: