CTL-EXTENSION Command Reference

From ControlTier

Jump to: navigation, search

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:

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
Personal tools
Namespaces
Variants
Actions
Navigation
Communication
Development
Toolbox
Print/export