Kevin Greene > releasesystem-1.00 > deploy_content

Download:
releasesystem-1.00.tar.gz

Annotate this POD

View/Report Bugs
Source  

NAME ^

deploy_content - Perform the tasks associated with deploying a new package

SYNOPSIS ^

deploy_content [ -t num ] [ -T file ] [ -c file ] mirror_group file

DESCRIPTION ^

The deploy_content application is the second stage on the server-side of the release manager process. It is generally called by rlsmgrd when there is a package in the incoming area that requires deployment.

The role of this tool is to validate the new package file, verify the checksum, dissolve the archive into a staging area, and invoke the third-stage tool to manage the relocation of data from the staging area to the actual web server directories.

OPTIONS ^

deploy_content requires that a mirror group be specified on the command-line. This group name uniquely identifies a group of one or more servers that handle a given externally-visible hostname. Following this, there needs to be the name of the info file for the package being processed. This will be sought in either the incoming or staging directories (which are defined in the mirror group specification). In addition to these required values, the following options are recognized:

-t num

Specify a tracing level to be used for diagnostics (see the -T option below). The value is used internally as a bit-mask, so a value of 5 is in fact specifying the combination of 1 and 4, while exluding 2. Currently, only the first four bits are used. (A detailed description of what each bit does will soon follow.)

-T file

Specifiy the file that diagnostics are written to. Not to be confused with the general tool logfile, which generally only notes the very high-level events. If not specified, and a non-zero value for -t is specified, this will default to ``rlsmgrd-trace'' in the same logging directory as other logs are written to.

-c file

Instruct the tool to read configuration from the specified file rather than the Oracle database. This is meant mainly for debugging and for mirror groups that contain only one host. This is not a good idea for mirror groups with two or more hosts, as the database is specifically utilized so as to avoid configurations diverging from one host to the next. (Description of the configuration file format will be added later.)

CONFIGURATION SPECIFICATION ^

In order to read configuration data from the Oracle RDBMS, the tool must have a database name/address, and a user ID and password. It would be insecure to pass these either on the command-line or via environment variables. To that end, if the tool attempts to use the Oracle data source (in the absence of a -c option, above) then it looks for a control file in the same directory as the tool itself resides in. The name of the control file must be the mirror group name as passed on the command line, with a suffix of ``.rc'' added.

The file itself should contain only one or two lines. The first line should be of the form:

        username:password

The password should not be encrypted. The second line, if specified, should be the database name. If this is not specified, the value of the environment variable ORACLE_SID is used. It is assumed that the environment variable ORACLE_HOME is already set.

This specification will be used by all release manager tools located in the same directory.

FILES ^

$TOOL_DIR/*.rc

Where $TOOL_DIR is the directory in which the tool is installed, the files that provide Oracle information, for the sake of connecting to the Oracle server. This file is not referenced if the -c option is passed.

SEE ALSO ^

rlsmgrd, process_content

AUTHOR ^

Randy J. Ray

syntax highlighting: