server - LCFG server component
The profile server component for LCFG. This component manages the mxkprof daemon which compiles configuration protocols. Note that the server resources control the actions of the server and are only required on hosts running a server component. However, the server does require some resources for each client that it compiles; these resources are the profile resources.
The run method sends a HUP to the mkxprof daemon to initiate a recompilation. Option -r sends a HUP to the daemon after creating a flag file which causes it to completely rebuild all dependencies and profiles.
An Apache "allow from" specification for the access file corresponding to access_file, specifying hosts which should be permitted to access this directory without authentication.
A list of tags representing Apache web access files to be created in the directory corresponding to tag (see linkdirs).
A set of mkxprof debug flags.
A space separated list of directory pathnames in which to search for component default files. The directories are searched in the given order. The default is /usr/lib/lcfg/defaults/server. Default files must have the extension .def.
If this resource is non-null, mkxprof will generate derivation attributes in the profile (-r option).
The destination directory to be created for the given tag (see linkdirs).
A space separated list of specifications of the form dst=src, where src and dst are rsync specifications. Rsync will be called for each item in this list before starting a compilation cycle. This allows source directories to be collated from multiple remote servers.
The name of the Apache access file for the given access_file. Normally, this will be .htaccess, but Apache may be configured to use multiple different access files in different circumstances: for example, a different access file may be used for SSL and plain HTTP.
A space separated list of directory pathnames in which to search for header files. The directories are searched in the given order. The default is /var/lcfg/conf/server/include,/usr/lib/lcfg/server/include. Header files must have the extension .h.
Normally, hosts with compilation errors will have all their contributions removed from any spanning maps. This can be inconvenient because transient errors in client profiles can trigger reconfiguration of related servers - for example, firewall holes for a web server may be removed if a mistake is made in the profile (even though the web server continues to function). Specifying this option will cause the server to preserve spanning map entries for clients with broken profiles. This option is not the default, since the server is using the "last known" good value of the spanning map entries. If there are multiple servers which have been reset at different times, then it is possible that they will return different values for the same map entries.
A (space-separated) list of tags representing directories to be created in the root web directory. Each directory is automatically populated with links to the contents of some other directory, and one or more Apache access control files may be automatically created. By default, this is used to export the icons used by the status pages, and the CGI scripts. Other tags can be added to export, for example, an RPM repository, or some other static pages.
The lockfiles resource is comma-separated list of full pathnames for lock files. In daemon mode, mkxprof will not compile source files while any of these lockfiles are non-empty; the compilation will be deferred until the next poll, or notification. This provides a mechanism to allow several synchronized changes to be made to related files, in an atomic way.
The poll (-p) argument for mkxprof.
A space separated list of directory pathnames in which to search for package lists. The directories are searched in the given order. The default is /var/lcfg/conf/server/packages. Package lists must have the extension .pkgs or .rpms.
A shell command to execute before starting a compilation pass, and before fetching any sources with rsync, as specified by the <F> option. (The mkxprof -m option).
A shell command to execute before starting a compilation pass, but after fetching any sources with rsync, as specified by the <F> option. (The mkxprof -M option).
The name of an Apache DB password file which will be used to to authenticate requests for files in this directory when the access control conditions are not satisified (see acl_access_file), or not present. Any valid user in the password file will be permitted to connect. The special value auto can be supplied in which case the server will use the password file created automatically from the profile.passwd resources.
Additional rsync options for mkxprof (-o option).
The FQDN of the server to be used in status messages and profiles. The default is obtained from the hostname command.
The source directory to be created for the given tag (see linksdirs). All items in this directory will be symbolically linked to corresponding items in the destination directory.
A space separated list of directory pathnames in which to search for source files. The directories are searched in the given order. The default is /var/lcfg/conf/server/source. Source files must have no extension.
This option generates static HTML pages containing status information (-s option). Normally, the status resource should be used instead .
If this option is present, status information, including all errors and warnings are stored for display on an HTML status page. Normally, the CGI scripts status and index will be used to display this status information. The statichtml resource can be used to automatically generate static HTML pages which do not require the CGI sripts, however this is less flexible and results in slower compilations (-h option).
If this resource is non-null, mkxprof will write statistics to the logfile /var/lcfg/log/server.stats (-x option).
A space separated list of directory pathnames in which to search for validation files. The directories are searched in the given order. The default is /var/lcfg/conf/server/validation. These files are used by the vINFILE macro for validating strings.
Non-null for mkxprof verbose logging.
mkxprof warning flags.
The web directory for the -w option of mkxprof. The default is /var/lcfg/conf/server/web.
The definition of client resources used by the server.
Redhat9, Solaris9, Fedora3
Paul Anderson <dcspaul@inf.ed.ac.uk>