http-analyze Homepage


Homepage | Product Description | Licensing & Pricing | Registration | Download Area | Documentation | FAQs | Sample Report | Customer Support

FAQ Home
Logfile rotation
Error messages
Statistics report
  1. How do I install http-analyze?
    Installation of the analyzer depends on the type of the distribution (source, binary) and on the platform:
  2. If you did download the Open Source distribution, unpack the files in some directory, select the required platform in the Makefile and compile the sources. Note that beside an ANSI-C compiler you will need the GD Graphics Library, the libpng PNG image format library and the zlib compression library to generate the executable. After successful compilation, issue a "make install" as root to install the analyzer. This will copy the executable into the directory /usr/local/bin and the required support files into the directory /usr/local/lib/http-analyze. Older installations of http-analyze are backed up before new files are installed by make. For more information on compiling the sources, see the instructions in the file INSTALL, which is included in the distribution.
  3. If you did download an install-able binary package, use the platform-specific installer to install http-analyze. For example, on SGI IRIX the installer is inst or swmgr, on Linux it's most often rpm (Red Hat Package Manager) and on native SVR4 Unix it is pkgadd. See the man-page of your installer software for more information.
  4. If you did download the TAR archive version of a binary distribution for some Unix platform, unpack the files somewhere. To install the software, run the shell script "makeinstall" as root. This will copy the executable into the directory /usr/local/bin and the required support files into the directory /usr/local/lib/http-analyze.
  5. To install the analyzer on Windows systems, unpack the ZIP archive and run the setup utility. You will be asked for the directory to install the software in. Make note of the directory path, since you will need it later in a MS-DOS command prompt when you need to change into this directory to be able to exetute http-analyze.
  6. To test-run the analyzer create a directory for the statistics report. This is usually a subdirectory under the DocumentRoot of your web server, but it could be any other directory as long as you can browse it using a web browser. Now run the command http-analyze -v3f -o stats logfile. Replace stats with the name of the output directory and logfile with the name of the actual logfile. The option -v instructs http-analyze to print comments about processing of the logfile. After statistics have been created, use a web browser to view the HTML pages in the stats directory.
  7. For more information about compilation, installation and setup of an analyzer configuration see the examples in the file INSTALL, which is included in the distribution, and also the examples in the Reference Manual of http-analyze.
  8. I can't become root on the system I am working on. Can I install the analyzer in some other directory?
    In general, http-analyze does not require special permissions other than write permission for the directory where you are going to install it, so you could install the analyzer in your HOME directory. To tell http-analyze where it should search for the required support files (buttons and images), you can either set the environment variable HA_LIBDIR to the pathname of the installation directory or specify its name using the option -l on the command line when executing http-analyze. However, you must have access to the web server's logfile and you must make sure that http-analyze always processes the whole logfile for the current month until this month has passed. Furthermore, the rotation of the logfile and the regular execution of http-analyze on the first of a new month has to be synchronized somehow.
  9. I can't get http-analyze compiled without errors. The compiler prints dozens of error messages and terminates.
    Your C compiler probably isn't ANSI compliant or you didn't specify ANSI mode when compiling. Sorry, but we do not provide compatibility with older versions of the C language. ANSI-C is the industry standard for more then 10 years now, so you should consider an upgrade of your compiler anyway.
  10. It seems that the software compiles fine, but the linker complains about undefined symbols strerror/gethostname/gettimeofday. Where can I find them?
    Although the function strerror is required by ANSI-C, there is at least one C environment which lacks this function. In this case, define the macro NEED_STRERROR in file config.h or in the Makefile and re-compile the sources. The functions gethostname and gettimeofday are extensions of the C libraries on most modern Unix systems. If your system doesn't provide gethostname, define the macro NO_GETHOSTNAME in file config.h or in the Makefile. If it doesn't know gettimeofday, remove the macro TIME_STATS in the Makefile. Those macros are described in the file config.h.
  11. If I run make, it responds with the error message "/usr/sbin/cc is part of an optional package not installed on this platform" and terminates immediately. What's the deal with this?
    You obviously have no developement tools installed on your system. Either use our pre-compiled binaries if available for your platform or find some technically skilled colleague who can help you to generate a binary on a developement system.

[ Homepage | Product Description | Licensing & Pricing | Registration | Download Area | Documentation | FAQs | Sample Report | Customer Support ]
Impressum Copyright © by RENT-A-GURU®