NAME

dev_release.cfg - Configuration file for the developer release tools

SYNOPSIS

Text file used to control the configuration of developer release tools

DESCRIPTION

The second-generation release manager tools introduced a more flexible approach to system configuration in the form of a central file that manages the various parameters that affect the overall system. Each line in the file is one of three types:

blank

Used for the sake of readability, to separate sections from each other.

a comment

Lines that start with the "#" character are treated as comments and ignored.

a key/value assignment

All lines of the form, "KEY=VALUE" are treated as assignment lines. The tag up to the "=" sign is treated as the key name, and all characters from after the (first) "=" to the end of the line are assigned as the value.

FILE CONTENTS

The following are the fields currently in use, and where applicable the default value is shown:

ACL_DIR (/home/idsweb/etc/acl)

The directory in which Access Control Lists (ACLs) are kept. If not specified as an absolute path, then assumed to be relative to the home directory of the user specified below in OWNER.

PROJECT_ROOT (/opt/ims/htdocs)

This directory specifies the root directory under which project files are checked-out for the populate step.

STAGE_ROOT (/opt/ims/staging)

The directory root of the staging area used by projects prior to release.

EVENT_LOG (/opt/ims/htdocs/development-log.txt)

All tool actions record one line to this file, to act as a simple log of activities.

CVSROOT (/opt/ims/repository)

This allows for the specification of the CVS base repository root. This is in case the person running the tools has not already set the value in their environment.

DEVHOST (webdev.nafohq.hp.com)
CVS (/opt/ims/bin/cvs)

Path to the base CVS utility cvs. This is used to create the CVS interface commands

TAR (/opt/ims/bin/tar)

Path to the UNIX tar utility to use in creating archives. Soon to be obsoleted by the Perl Archive::Tar package.

FTP (/opt/ims/bin/ftp)

The path to the local ftp application to use. Allows for configuration of altername tools or versions of ftp compiled with SOCKS support.

TOPICLIST (.topiclist)

This file is the internal topiclist file used by the tools. The topiclist is used only to define the project name and owner for e-mail purposes.

BUILDLIST (.buildlist)

The buildlist file, used to determine automatic building of projects and exlude release of specific directories or files (sourcecode).

WEBLIST (.weblist)

The internal weblist file, used to track the project manifest and modification times of individual files.

RELEASE (.release)

The name of the internal release tracking file used by the tools. This file marks when the last actual release was done of a given project.

HALTFILE_PREFIX (etc/halt-)

This value is used in the construction of the path to a potential "haltfile" for a given tool. If a haltfile exists for a tool, then execution of that tool is blocked until the halt is removed. If the file has length other than zero, then the contents are displayed on the terminal as an informative message to the user. If this value is not an absolute path, it is assumed to be relative to the home directory of the user specified in OWNER.

OWNER (idsweb)

This defines the user ID that internal and system files should be owned by. This should be the ID under which all the tools run, so that access to the files is always a given.

GROUP (idsweb)

As above, this defines a group ID for ownership of any systems files or internal files.

HTTP_PROXY (http://web-proxy:8088)

When HTTP file upload (the default) is used to send a release package to a server, this value is used as the proxy for the connection request. Without this it would not be possible to make the connections beyond the corporate firewall.

CAVEATS

None (yet).

SEE ALSO

dev_rls_tool, populate, stage, release

AUTHOR

Randy J. Ray <randyr@nafohq.hp.com>

ENHANCEMENTS

Kevin Greene

1 POD Error

The following errors were encountered while parsing the POD:

Around line 32:

You forgot a '=back' before '=head1'