home *** CD-ROM | disk | FTP | other *** search
/ c't freeware shareware 1999 February / CT_SW9902.ISO / pc / software / admin / editoren / web_mac.tz / web_mac / INSTALL < prev    next >
Text File  |  1999-06-01  |  8KB  |  207 lines
  1. Installation instructions for The Webalizer
  2.  
  3. The Webalizer is distributed in either source or binary distributions,
  4. and installation is different for each type.  Regardless of the type
  5. of installation, you need to obtain and un-tar/un-zip the distribution
  6. file somewhere.  For binary distributions, you should create a directory
  7. somewhere and chdir to it before unpacking the file.  Source distributions
  8. will automagically create a directory for you (webalizer-x.xx-xx).
  9.  
  10.  
  11. For Binary distributions
  12. ------------------------
  13.  
  14. You should have all the files you need in the directory you created
  15. when you un-tarred/un-zipped the distribution file.  The file
  16. 'webalizer' in this directory is the binary executable.  Copy this
  17. someplace useful, like /usr/local/bin or /usr/bin.  A man page for
  18. The Webalizer is also supplied... If desired, copy the file
  19. 'webalizer.1' to your local man directory (ie: /usr/local/man/man1).
  20. (You may also need to run 'makeinfo' or similar)
  21.  
  22.  
  23. For Source distributions
  24. ------------------------
  25.  
  26. The Webalizer requires the GD graphics library by Tom Boutell.  If
  27. you don't already have it, go to http://www.boutell.com/gd/ and
  28. grab a copy.
  29.  
  30.  
  31. Old style build:
  32.  
  33.   The file "Makefile.std" is a stock makefile for GCC on an x86
  34. linux system (slackware 3.6).  Rename the file to 'Makefile' and edit
  35. to match your system.  The stock file should work for most people.
  36. Then, type 'make', and if everything seemed to go well, type
  37. 'make install'...  If you get errors, check the frequently asked
  38. questions at the end of this document to see if your problem has
  39. already been addressed.
  40.  
  41. This will install the Webalizer on your system, and put a sample
  42. configuration file in /etc (named 'webalizer.conf.sample').  If
  43. you don't want to use the 'make install' method... just copy the
  44. file 'webalizer' to someplace usefull and you are ready to go :)
  45.  
  46.  
  47. New style build:
  48.  
  49. The Webalizer source distribution now comes packaged with a GNU
  50. autoconf 'configure' script, which should allow you to simply type:
  51.  
  52. ./configure
  53. make
  54. make install
  55.  
  56. Normal configure options apply, type ./configure --help to get a
  57. complete list.  A few options in particular may be useful:
  58.  
  59. --with-language=<language>
  60.  
  61. Allows you to specify the language to use.  Check the /lang directory
  62. to see the available language choices.  As an example, you could use
  63.  
  64. ./configure --with-language=french
  65.  
  66. to compile the program using french (webalizer_lang.french) for output.
  67. You can also use the --without-language switch, which will use the
  68. default language (english).
  69.  
  70. --with-gd=<path-to-gd-headers>
  71.  
  72. The configure script will attempt to locate the gd library header
  73. files in some of the more usual places, and should find them in most
  74. caces.  If you have the header files someplace unusual, you can
  75. specify additional locations to look for them with this option.
  76.  
  77. Some systems may require unusual settings that the configure script
  78. cannot determine.  You can pass values to the script by setting
  79. environment variables.  For example:
  80.  
  81. CC=c89 CFLAGS=-O LIBS=-lposix ./configure --with-language=german
  82.  
  83. Would allow you to set the compiler (c89) and various flags and
  84. libraries to use, which would then be passed to the configure script
  85. and eventually to the Makefile generated.  It also will cause the
  86. program to be compiled using German instead of the English default.
  87.  
  88. If the configure script doesn't work for you.. please let me know
  89. (along with relevant info like system type, compiler, etc..)  If you
  90. are able and can tweek something to make it work, let me know as well.
  91.  
  92.  
  93. Usage
  94. -----
  95.  
  96. When run, The Webalizer will read the specified log file and
  97. produce HTML output in the directory specified (or current
  98. directory if none).  You may specify various configuration
  99. options either on the command line or in a configuration file.
  100. The format of the command line is:
  101.  
  102. webalizer [options] [log_file]
  103.  
  104. Where 'options' may be any of the valid command line options
  105. described in the README file.  If a log filename is not given,
  106. input is taken from stdin.  A typical command line might look
  107. something similar to:
  108.  
  109. webalizer /var/lib/httpd/logs/access_log
  110.  
  111. This will produce output in the current directory based on the
  112. logfile /var/lib/httpd/logs/access_log.  Another example:
  113.  
  114. webalizer -c somehost.conf
  115.  
  116. This will read the configuration file somehost.conf, which
  117. should specify, among other things, the log filename and
  118. output directory to use.  You can use 'webalizer -h' to get
  119. a list of available command line options, or view the file
  120. README for complete instructions on all available configuration
  121. options.  You should note that The Webalizer will _always_
  122. look for a configuration file named 'webalizer.conf' in either
  123. the current directory or in /etc/, and will process that file
  124. _before_ any other configuration or command line options.  If
  125. you run a single server, you may want to create a default
  126. configuration file and place it in the /etc/ directory.  This
  127. will allow you to simply type 'webalizer' without the need to
  128. specify additional command line options.
  129.  
  130.  
  131. Configuration
  132. -------------
  133.  
  134. The Webalizer can be customized in many ways using either the
  135. command line or configuration files.  To test The Webalizer,
  136. type: 'webalizer /var/lib/httpd/logs/access_log', changing the
  137. directory to wherever your log files are.  After processing,
  138. you should have the output and a file named index.html which
  139. can be viewed with any browser.  The Webalizer can accept many
  140. command line options as well, type 'webalizer -h' to view them.
  141. In addition to the command line options, The Webalizer can
  142. be customized using configuration files. There is a sample.conf
  143. file that is part of both the source and binary distributions
  144. that can be used as a 'template' for creating your own site
  145. configuration file.  Just make a copy of the file and name it
  146. something like 'mysite.conf'.  Edit the new file to match your
  147. particular setup and taste.
  148.  
  149. To test the new configuration file, type 'webalizer -c mysite.conf'
  150. (or whatever your configuration file is named).  Fire up the
  151. browser and look at the results.  If you rename your new
  152. configuration file to 'webalizer.conf', you will only need
  153. to type 'webalizer', and The Webalizer will use it as the
  154. default.  See the README file for more on configuation and
  155. use of configuation files.
  156.  
  157.  
  158. Language Support
  159. ----------------
  160.  
  161. Version 1.00 of The Webalizer added language support in the
  162. form of a language specific header file included at compile
  163. time.  Grab a copy of the latest source distribution and
  164. Untar/uncompress it somewhere safe (such as /usr/src/webalizer).
  165. In the directory, you will find a symbolic link for the
  166. file webalizer_lang.h, and it will be pointing to the file
  167. webalizer_lang.english which is the default.  Delete the
  168. link (ie: rm webalizer_lang.h) and create a new one to the
  169. language file you want The Webalizer to use
  170. (ie: ln -s lang/webalizer_lang.spanish webalizer_lang.h)
  171. and re-compile the program.
  172.  
  173. Note: The source distribution of The Webalizer contains all
  174.       language support files that were available at the time.
  175.       Additional/updated language files can be found at:
  176.       ftp://ftp.mrunix.net/pub/webalizer/lang where I will put
  177.       them as I receive them.
  178.  
  179.  
  180. Common Questions
  181. ----------------
  182.  
  183. Q: Will it run on [some platform]
  184. A: If it is a *nix platform, it should without a problem.  If it's
  185.    something different, probably not and your on your own if you
  186.    want to try to make it work.
  187.  
  188. Q: When I compile, I get "file not found" errors?
  189. A: Most likely, the compiler cant find the header files for the
  190.    GD Graphics library.  If they are someplace other than the
  191.    default /usr/local/include/gd, then you need to change the
  192.    GDLIB variable in the Makefile to point to the proper place.
  193.  
  194. Q: I get "libgd not found' errors?
  195. A: You don't have the GD graphics located in a standard library
  196.    path, or you don't have the GD graphics library at all.  If
  197.    the later, go to http://www.boutell.com/gd/ and grab a copy.
  198.    If you do have it, add a -L switch in the Makefile to point
  199.    to the proper location.
  200.  
  201. Q: I can't get the GD graphics library to compile?
  202. A: The GD Library was written (and hopefully maintained) by
  203.    Tom Boutell, not me.  Visit his web site, ask him a
  204.    question or hit one of the newsgroups...  I can't help you
  205.    out too much with this one.
  206.  
  207.