home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Linux / Magazine / wwwoffle-2.1.tar.gz / wwwoffle-2.1 / INSTALL < prev    next >
Text File  |  1998-03-02  |  5KB  |  129 lines
  1.           WWWOFFLE - World Wide Web Offline Explorer - Version 2.0
  2.           ========================================================
  3.  
  4. Simple Installation
  5. -------------------
  6.  
  7. The following ten steps should be sufficient to demonstrate wwwoffle running.
  8.  
  9. 1) Edit the Makefile and set the following:
  10.         The path for installation (INSTDIR)       - default /usr/local
  11.         The spool directory (SPOOLDIR)            - default /var/spool/wwwoffle
  12.         The configuration file location (CONFDIR) - default /var/spool/wwwoffle
  13.         The compiler options (CC and CFLAGS).
  14.    (The Makefile includes some machine specific options for non-Linux machines
  15.     that may need to be uncommented.)
  16.  
  17. 2) Compile the programs
  18.      make all
  19.  
  20. 3) Install the programs and create the spool directory
  21.      make install
  22.  
  23.         **** Important * If you currently use version 1.x ****
  24.     You *MUST* run the program upgrade-cache to convert your cache from version
  25.     1.x format to version 2.x format.  Read the file UPGRADE for details.
  26.         **** Important * If you currently use version 1.x ****
  27.  
  28. 4) Edit the configuration file
  29.    $(CONFDIR)/wwwoffle.conf
  30.  
  31.         **** Important * If you must use an external HTTP proxy ****
  32.     You will need to add the name of the proxy and the port number to the
  33.     configuration file $(CONFDIR)/wwwoffle.conf, read it for instructions.
  34.         **** Important * If you must use an external HTTP proxy ****
  35.  
  36.         **** Important * If you currently use version 1.x ****
  37.     The configuration file $(CONFDIR)/wwwoffle.conf has changed, the file
  38.     CHANGES.CONF explains the differences since version 1.3.
  39.         **** Important * If you currently use version 1.x ****
  40.  
  41. 5) Start the wwwoffle demon running.
  42.    $(INSTDIR)/sbin/wwwoffled -c $(SPOOLDIR)/wwwoffle.conf
  43.  
  44.         **** Important * If you currently use version 1.2b or earlier ****
  45.     The wwwoffle demon now disconnects itself from the terminal when run unless
  46.     -d is used, this means that you do not need an '&' to run it in background.
  47.         **** Important * If you currently use version 1.2b or earlier ****
  48.  
  49. 6) Start your WWW Browser and set up localhost:8080 as the proxy.
  50.    Disable caching between sessions within the browser.
  51.  
  52. 7) a) Connect to the internet
  53.    b) Tell the wwwoffle demon that you are online
  54.         wwwoffle -online
  55.    c) Start browsing
  56.    d) Tell the wwwoffle demon that you are offline
  57.         wwwoffle -offline
  58.    e) Disconnect from the internet
  59.  
  60. 8) Go back and browse the pages again while not connected, follow some different
  61.    links this time (you will see a wwwoffle server message in the browser).
  62.  
  63. 9) a) Connect to the internet
  64.    b) Tell the wwwoffle demon that you are online
  65.         wwwoffle -online
  66.    c) Tell the wwwoffle demon to fetch the new pages
  67.         wwwoffle -fetch
  68.    d) Tell the wwwoffle demon that you are offline
  69.         wwwoffle -offline
  70.    e) Disconnect from the internet
  71.  
  72. 10)a) Go to http://localhost:8080/index/ and find the newly downloaded pages.
  73.    b) Browse the new pages that have just been fetched.
  74.  
  75.  
  76. Compile Time Options
  77. --------------------
  78.  
  79. In the file wwwoffle.h there are a number of extra compile time options that you
  80. may want to change.
  81.  
  82.  
  83. The first three are the compiled in defaults for the options in the StartUp
  84. section of the wwwoffle.conf file.
  85.  
  86. /*+ The default port number to use for the http proxy demon. +*/
  87. #define DEF_HTTP_PORT 8080
  88.  
  89. /*+ The default port number to use for the wwwoffle control. +*/
  90. #define DEF_WWWOFFLE_PORT 8081
  91.  
  92. /*+ The default spool directory. +*/
  93. #define DEF_SPOOL "/var/spool/wwwoffle"
  94.  
  95. /*+ The default configuration file directory. +*/
  96. #define DEF_CONF "/var/spool/wwwoffle"
  97.  
  98.  
  99. The next one is the compiled in default for the Purge section age of files to
  100. purge.
  101.  
  102. /*+ The default age of pages in days before purging. +*/
  103. #define DEF_PURGE_AGE 14
  104.  
  105.  
  106. The next four limit the number of connections that wwwoffle will accept at a
  107. time and the number of servers that it will fork in response to this.  A total
  108. of MAX_SERVERS, including up to MAX_FETCH_SERVERS when 'wwwoffle -fetch' is run.
  109. These are options in wwwoffle.conf, but the absolute maximum values can be
  110. changed here as well as the default values.
  111.  
  112. /*+ The absolute maximum number of servers to fork in total. +*/
  113. #define MAX_SERVERS 64
  114. /*+ The default total number of servers to fork. +*/
  115. #define DEF_MAX_SERVERS 8
  116.  
  117. /*+ The absolute maximum number of servers to fork for fetching previously
  118.     requested pages. +*/
  119. #define MAX_FETCH_SERVERS 48
  120. /*+ The default number of servers to fork for fetching pages. +*/
  121. #define DEF_MAX_FETCH_SERVERS 4
  122.  
  123.  
  124. The last one is the amount of time that wwwoffle will wait trying to read from a
  125. server before giving up and putting an error mesage in the cache instead.
  126.  
  127. /*+ The time in seconds to wait while reading from a socket. +*/
  128. #define SOCKET_TIMEOUT 120
  129.