CTL-EXTENSION Command Reference
From ControlTier
Contents |
Synopsis
ctl-extension [options]
Overview
The ctl-extension command installs an extension archive created by ProjectBuilder build-library command.
Extensions add CTL framework level functionality that is available to any other CTL user. Extensions can include the following:
- Java class libararies which may include Ant tasks and types, and their own APIs.
- CTL command modules
- framework commands that are installed in $CTL_HOME/bin
Options
| Option | alternate | argument | description |
|---|---|---|---|
| -h | --help | false | displays the usage information presented above |
| -S | --nosetup | false | do not run ctl-setup |
| -f | --file | true | file to install |
| -o | --overwrite | false | overwrite framework with files from extension |
Environment Variables
The following environment variables are assumed during execution:
| key | description |
|---|---|
| CTL_HOME | CTL installation directory |
| CTL_BASE | CTL framework instance directory |
Execution
Install an extension named "default"
ctl-extension -f default-extension.jar
Install an extension named "default" but don't run the ctl-setup command
ctl-extension --nosetup -f default-extension.jar
Files
Installation layout
Installed extensions can be found under $CTL_HOME/lib/extensions as described below:
ctl-home | +-bin // shell scripts | +-classes // bootstrap classes | +-lib | | | | | +-extensions // extensions base directory | | | +-myExtension //Example extension, "myExtension" | | | + bins | + jars | + modules | + properties | +-pkgs // pkgs home
| ||||||||||||||