Remstats Home


  About remstats
  Release Notes
  FAQ
  Conventions
  Prerequisites
  Installation
      the remstats user
      cookies
      private functions
      remstats servers
      your web-server
  Configuration
  Configuration Tools
  Servers
  Collectors
  Updater
  Monitors
  run-remstats
  CGIs
  do-traceroutes
  Miscellany
  Thank-you
  Index


  Live Data

  Remstats was written by
  Thomas Erskine at the
  CRC in Canada and now
  at SourceWorks.

[Top] [Prev] [Next]

The remstats user

You must choose a userid to run the remstats processes under. By default, it will be the user remstats, but you'll have to create it manually, as I'm not going to risk damaging someone's /etc/passwd file. Many operating-systems have a script called useradd or adduser or some variant on that.

NOTE: Don't run the remstats programs except as the remstats users. Many of the programs write extra files you won't know about unless you read the source, and when you do run them as the remstats user, it won't be able to modify the files that were created by the other user. This will probably cause the program to die, with a meaningful error message I hope, and you'll have to modify the owner by hand, as root. If you need to do this, go back to the source directory and do:

	% su -c 'make install-owner'

The remstats user must be able to write files within the remstats directory trees rooted at /var/lib/remstats, /var/lib/remstats/data and /var/lib/remstats/cgi. The collection/update processes will also create files under /var/lib/remstats/tmp and /var/lib/remstats/data. The pagemakers write files under /var/lib/remstats/cgi. It's simplest to have all the remstats files and directories(except multiping and traceroute) owned by the remstats user.

You must also ensure that the CGI scripts (and almost every web-page remstats creates is a CGI script) get run by the remstats user. The CGI scripts read files under /var/lib/remstats/data and /var/lib/remstats/datapage. (See also the web-server installation.


Last updated Thu Mar 17 16:59:13 UTC 2005 by <thomas.erskine@sourceworks.com>.
[SourceWorks] [Top] [RRDtool]