Build your own FOTW copy or mirror

Last modified: 1999-10-22 by skip at vexillum
Keywords: fotw | mirror | web | ftp |
Links: FOTW homepage | search | disclaimer and copyright | write us | mirrors

• Build your local copy of FOTW web site
• Keep your copy updated
• Build your FOTW mirror site
• Make your mirror an official one
• The official FOTW mirror sites

REQUIREMENTS:

1. On your local hard drive create a directory called fotw. Create three subdirectories under that directory called flags, images, and misc.
2. Using an ftp program log into fotw.vexillum.com using the login anonymous and your email address as the password
3. Download all the files in the directories flags, images, and misc on the ftp site to the same directories on your hard drive.
4. Now you can browse the site on your hard drive by opening the file /fotw/flags/index.html with your browser.

1. If you know the date of the last time you updated your local copy of FOTW skip to the next step. If you do not know open up each of fotw directories (flags, images, misc) on your local site with your file manager program and find the latest file by sorting in descending order by date/time.
2. Using an ftp program log into fotw.vexillum.com using the login anonymous and your email address as the password.
3. In each of the directories on the ftp site - sort by date and download those files which have been changed since the last time you updated your site into their respective directories on your local hard disk.
4. To automatically update your local copy with the newest files please see the instructions below for creating a mirror site.

REQUIREMENTS:

WARNING:

INSTRUCTIONS PART ONE - MIRROR:

1. You need to obtain a copy of mirror for your operating system. You can download mirror 2.9 from our anonymous ftp site at ftp://fotw.vexillum.com/mirror. For full documentation and updated mirror programs as well as other mirror solutions please visit http://src.doc.ic.ac.uk/packages/mirror/.
2. Create under a directory such as fotw the directories flags, images, misc, control, and custom.
3. Create a directory to place the mirror program in. Uncompress the mirror package into that directory.
4. Locate the file "mirror.defaults" which should be in the mirror directory. Open it in your text editor.
5. Find the line "package=defaults" and change it to read "package=fotw".
6. Find the line "hostname=sunsite.org.uk" and change it to read "hostname=YOURDOMAIN" where YOURDOMAIN is your web site's domain name.
7. Find the line "local_dir=/public/" and change it so that it points to the full path of the directory that you created the directories flags, images, custom, control, and misc in. In unix you can type "pwd" at the prompt to tell what the path is where you are in the directory tree. Your entry should look something like "local_dir=/usr/home/YOURDOMAIN/html/fotw/" depending on your server filesystem tree.
8. Find the line "remote_password=wizards@sunsite.org.uk" and change it so that it reads "remote_password=YOUREMAILADDRESS" where YOUREMAILADDRESS is the email address that you normally use for your site.
9. Insert a new line after the "remote_password=YOUREMAILADDRESS" that reads "remote_user=anonymous".
10. Insert a new line after the last one that says "remote_dir=\".
11. Insert a new line after the last one that says "site=fotw.vexillum.com".
12. At the beginning of the following lines place the "#" symbol (similar to other lines in the text) so that they read as follows:
    
    # dir_mode=0755
    # file_mode=0444
    # user=0
    # group=0
    # update_log=
    
    
13. Please make sure that you made all of the changes as listed above and that the information entered is correct. You are now ready to test the program. Type "perl mirror.pl -n". If all is well you will get normal messages showing what would happen if you ran the program for real (and this will take some time because there are literally thousands of files to transfer). If you get an error again check the modifications you made to the mirror.defaults file. Make sure that everything works correctly under the test mode before running the program "live" on your data.
14. WARNING! Please do not run this command unless you are sure the test mode above worked correctly. Now you are ready to actually create your mirror site. Run the mirror program by typing "perl mirror.pl". The site will be transferred and put in the proper locations automatically.

INSTRUCTIONS PART 2 - CUSTOM BANNER AND PAGE

1. Prepare your banner as a gif file. The preferred size is 468 x 60 pixels.
2. Name it linea2.gif
3. Put the file in the /custom directory.
4. change the contents of host.html file so that it points to your homepage and place it in the custom directory. If you want it to redirect to your home page automatically add the following line in the host.html file:
   
   <meta http-equiv="REFRESH" content="1; URL=http://www.yourdomain.com">
   

INSTRUCTIONS PART 3 - CONTROL SCRIPT

1. Using your text editor create a file called "control.bash" in the control directory.
2. Type the following replacing the PATH in the following example to the absolute paths on your server:
   
   #!/bin/sh
   perl PATH/mirror/mirror.pl
   cp PATH/custom/linea2.gif PATH/images/linea2.gif
   cp PATH/custom/host.html PATH/flags/host.html
   
   NOTE: The syntax for this step can be very different on other OS such as WindowsNT. Please consult your operating system documentation to accomplish the same thing.
   
   

INSTRUCTIONS PART 4 - CRONTAB:

1. Create a new file called "cron.txt" with your text editor in the control directory.
2. On the first line put "0 0 * * * perl PATH TO CONTROL.BASH/control.bash" where the PATH TO CONTROL.BASH is the absolute path to the control.bash script. So the resulting entry should look something like this:
   0 0 * * * /usr/home/domainname/html/control/control.bash
   
3. The above line assumes that you want to update the site every day at midnight. The syntax for cron is as follows:
   
   The minute of the hour(0-59)
   The hour of the day(0-23)
   The day of the month (1-31)
   The month (1-12)
   The day of the week (Sun=0, Mon=1, ... Sat=6)
   
   Minute - Hour - Day - Month - Day of Week
   * stands for no entry
   
   So if you wanted to update your mirror every Sunday at 3:00a.m. you would use the syntax "0 3 * * 0" instead of "0 0 * * *".
   
4. Save the file.
5. At the command prompt type "crontab cron.txt".
6. Then type "crontab -l". This should list the crontab contents that you just typed.

CONGRATULATIONS!

• modify the contents of FOTW pages and images
• put third-party advertisement on FOTW pages (e.g. you cannot put third-party logos and advertisement in linea2.gif file)
• sell the access to FOTW pages and images