Mirroring Instructions

Because we've received some interest in mirroring our Guide, we thought we'd provide mirroring instructions to help make the process as easy as possible. You may find this page useful if you either want to host a mirror of the guide, or if you'd like to have an offline copy of the guide in case you need access to it without Internet access. We tested this using wget. Obviously you are free to use whatever app you want to retrieve the public files on our server, but we've only tested this using wget and won't vouch for any other app. If you don't have wget installed on your system, first install it (after becoming 'su') like so:

cd /usr/ports/ftp/wget
make install clean
exit

At this point you can download this script to mirror the guide with little hassle. If you take this route, be sure to edit the ~/web/ part of mirrordir to a directory of your choice, wherever you plan to put the mirror.

Alternatively you can go through this process manually. Create a directory to house our Guide files. The example given is a nice convention to follow:

mkdir ~/2005-05-23

By writing the date in this format (year-month-day), your mirrors will be properly sorted chronologically. In order to fetch a complete mirror of our Guide, you'll want to target the specific file on our server given below. Otherwise, you might get most of our Guide, but you won't get everything. (What good is a partial mirror?)

cd ~/2005-05-23
wget --mirror http://www.math.colostate.edu/~reinholz/freebsd/index.html

You can see 'man wget' for more details on wget flags, but the '--mirror' flag is sufficient for our purposes. You should now have a complete mirror of our FreeBSD Guide. Where you put them on your server and how you link to them is your business.

We highly recommend that you repeat this process about once a month. For your convenience, however, you can visit our website and browse http://www.math.colostate.edu/~reinholz/freebsd/updates.html to see the latest changes we've made to the Guide and when. This should give you a good idea of whether or not it's time to create a new mirror.

As a final note: while not required under our license agreement, we request that, as a courtesy, you create an html include or some other notation at the bottom of your mirrored pages to the effect of The original content mirrored on this server can be found at http://www.math.colostate.edu/~reinholz/freebsd/index.html. Perhaps a script could quite easily accomplish this task. . . Should we receive enough interest, we may decide to write one in the future that would automate the process of placing this notation at the bottom of each page.