INSTALL Command Reference

From ControlTier

Jump to: navigation, search

Contents

Synopsis

usage: install [options]
options:
 -D <property=value>   property=value pair used during software setup
 -c,--client           install just the client
 -d,--dir              ctier_root installation directory
 -f,--defaults         default.properties file
 -h,--help             print this message
 -p,--project          default project name name
 -v,--verbose          verbose mode

Overview

The install command is used after extracting the ControlTier software distribution to install and configure the ControlTier client or server deployments.

Options

OptionalternateargumentDescription
-Dkey=valSpecifies a key/value pair that overrides a property in the installer's defaults.properties file
-c--clientSpecifies only the client software be installed.
-d--dirdirectorySpecifies installation root directory. Defaults to $CTIER_ROOT
-f--defaults fileSpecifies a key/value pair that overrides a property in the installer's defaults.properties file
-h--helpPrints command usage info to the console
-p--projectnameThe name of the project name to create after installation.
-v--verboseVerbose mode provides more output from the installer

Default properties file

The installer installs the ControlTier software using configuration data located in the "default.properties" file at the root of the package extraction directory. The default.properties file contains several dozen configuration settings governing everything such as: install directories, network ports, smtp, hostname, user names, and project settings.

You can edit this file and customize any of the settings. When you run the installer, it loads the settings and then begins the installation process.

For users automating the installer, see #Overriding defaults

Running

Default install

You can run the installer without any arguments to install the ControlTier software according to the defaults.

Unix

sh ./install.sh

Windows

install.bat

Client install

You can instruct the installer to only install the client software via the "-c" flag.

Unix

sh ./install.sh -c

Windows

install.bat -c

Overriding defaults

Any property defined in defaults.properties can be overridden from the command line using the "-Dkey=val" option. Multiple pairs of key=val option can be specified at one time.

The example below shows how to install just the client but override two defaults:

sh ./install.sh --client\
  -Dserver.hostname=adminhost.domain \
  -Dclient.hostname=`hostname`
Personal tools
Namespaces
Variants
Actions
Navigation
Communication
Development
Toolbox
Print/export