Installation Overview

WANdoc is provided as a tarball (gzipped tar file). To install, you should perform the following steps in order:

  1. If you don't already have them installed, then install:
  2. Make sure the WANdoc host (and a new user account, described below) can access copies of your router configs.
  3. Make sure that the WANdoc host has access to the syslog file that your routers log trouble to. This is optional but adds a lot of functionality.
  4. Create a new Unix account on the WANdoc host
  5. Login to the new account and untar the WANdoc tarball into the new account's home directory.
  6. Create a new username in the DBMS and grant it permission to create a database (scripts for this are provided).
  7. Run the Install.sh script (which only modifies the new home directory) and answer the questions which it asks.
  8. Modify rc.wandoc if you changed your mind about the answers to the Install.sh questions.
  9. Make sure that your http daemon will serve up data from the WANdoc output directory and will run the three WANdoc CGI programs.
  10. Run the WANdoc test program and correct any problems it may find.
  11. Run WANdoc and (optionally) add it into crontab.