Codebase list metche / 2ab46f8
trunk/README: updated to reflect the new VServer support intrigeri 18 years ago
1 changed file(s) with 20 addition(s) and 20 deletion(s). Raw diff Collapse all Expand all
7979 | CONFIGURATION
8080 `-------------------------------------------------------------------------------
8181
82 *** Without vservers support
83
8482 1. Copy metche.conf.default to /etc/metche.conf and edit it so that it suits
8583 your needs.
8684 2. Read the next sections of this document and the metche(8) manpage.
9088 See the cron (8) manpage for further explanations on how to create a cron
9189 job.
9290
93 *** With vservers support
91 ,-------------------------------------------------------------------------------
92 | VSERVERS SUPPORT
93 `-------------------------------------------------------------------------------
9494
95 You need one config file per system to be monitored (usually one for the host
96 system, and one per vserver). The "-h <host>" command-line option makes metche
97 use /etc/metche/<host>.conf config file instead of /etc/metche.conf.
95 Just add one (or more) VServer name to the VSNAMES configuration variable, and
96 metche will monitor it in addition to the host system:
97 - the WATCHED_DIR, CHANGELOG_DIR and CHANGELOG_FILE paths are also used,
98 relatively to your VServer's root directory;
99 - the "system state" backups will be saved in sub-directory in BACKUP_DIR's,
100 called the same as the VServer;
101 - all other configuration variables are used as it.
98102
99 1. mkdir /etc/metche
100 2. For each system to monitor, follow the next steps (replacing <host> by this
101 host's name) :
102 - copy metche.conf.default to /etc/metche/<host>.conf
103 - edit <host>.conf so that it suits your needs
104 - if the system to monitor is a vserver, edit <host>.conf to set
105 VSERVER_EXEC_PREFIX to something like "/usr/sbin/vserver <host> exec"
106 3. Read the next sections of this document and the metche(8) manpage.
107 4. For each system to monitor, add to /etc/cron.d/metche something like :
108 0-59/5 * * * * root test -x /usr/local/sbin/metche && \
109 /usr/local/sbin/metche -h <host> cron
110 See the cron (8) manpage for further explanations on how to create a cron
111 job.
112
103 Most of metche commands (namely: list, report and stabilize) support a
104 '-h <VSERVER>' option:
105 - if -h is specified, metche only operates on the VServer provided as an
106 argument;
107 - else, metche only operates on the host system.
108
109 Troubleshooting: in case you have a not-purely-Debianish VServer setup, you may
110 have to customize some of the VServers-related configuration variables. See the
111 comments in metche.conf for more details.
112
113113 ,-------------------------------------------------------------------------------
114114 | SECURITY WARNING
115115 `-------------------------------------------------------------------------------