Server-setup Command Reference

From ControlTier

Synopsis

usage: server-setup [options]
options:
 -D <property=value>   property=value pair used during software setup
 -f,--defaults         default.properties file
 -h,--help             print this message
 -v,--verbose          verbose mode
Examples:
server-setup -f defaults.properties -Dkey=val
server-setup -Dserver.jetty.hostname=development

Overview

The server-setup.sh command is used after installing the ControlTier software distribution to reconfigure server configuration.

Options

Default properties file

The Zip installer installs the ControlTier software using configuration data located in the "default.properties" file at the root of the package extraction directory. The Rpm installer places it in: $CTIER_ROOT/pkgs/configure/default.properties.

The default.properties file contains several dozen configuration settings governing everything such as: install directories, network ports, smtp, hostname, user names, passwords, 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.

Reconfiguration

By default the server is installed with these pertinent configuration values:

Server hostname

value of the hostname command.

Server node name

value of the hostname command.

Server port

default 8080

These values can be changed, but require running the "server-setup.sh" script. Make sure the server is stopped prior to executing this script.

The setup script takes a properties file as input, and you can also override specific property values on the commandline using the -Dname=value construction.

The default.properties file is the same format as the one used with the normal script based CLI installer. When you install the server rpm, a copy of this file is placed in: $CTIER_ROOT/pkgs/configure/default.properties. You can either duplicate this file and modify it, or you can simply use it as the basis for the setup, and override selected properties on the commandline.

For example, to override only the port used by the server, execute:

 $ server-setup.sh -f $CTIER_ROOT/pkgs/configure/default.properties -d $CTIER_ROOT \
   -Dserver.jetty.port=9090

Or to change only the server hostname:

 $ server-setup.sh -f $CTIER_ROOT/pkgs/configure/default.properties -d $CTIER_ROOT \
   -Dserver.hostname=myserver

Refer to the "$CTIER_ROOT/pkgs/configure/default.properties" file for further configuration properties.

Make sure that the server is stopped prior to running this command.

See also

• For client reconfiguration see CTL-SETUP Command Reference