Wusage 8.0 ManualConfiguring WusageAbout Configuration FilesEvery server analyzed by wusage will need a unique configuration file. Some sites may wish to use more than one in order to study different sections of a web site in great detail.A configuration file contains crucial information such as the name of the directory in which reports should be generated and the name of the file which contains the access log to be analyzed. A configuration file also indicates which documents, sites and domains are of interest to you, and which should be ignored. In earlier versions of Wusage, the configuration file also determined the look and feel of your reports. In Wusage 7.0 and above, this is accomplished through the Report Macro Language . Creating a Configuration FileSECURITY NOTE Starting Wusage under Windows 95, 98, and NTIf you chose to install Wusage in your startup group, then it is probably already running. Just click on the minimized W7 icon in your task bar to access the Wusage user interface. If you did not install Wusage in your startup group, pick the Wusage group from your start menu and launch the Wusage application from there.
Important note to batch file authors and command line fans:
yes, it is still possible to use the command line options. Beginning with
version 7.0 P10, you will do this using the Starting Wusage under UnixTo run Wusage, justcd to the directory where
you untarred or unzipped Wusage, and type ./wusage
to start the program.
Starting Wusage under MacOSMacintosh users can simply double-click on the Wusage icon, in the Wusage folder. When the Wusage console window appears, follow the instructions to connect to Wusage using your preferred web browser.
Starting Wusage as a CGI ProgramIf you prefer, you can install wusage as a CGI program, according to the directions for your particular web server. In that case, after installing the program, simply open the URL at which you have installed it and follow the directions in the web page that appears. Windows 95/98/NT users: installwusage.exe as a CGI program, rather
than wusageg.exe.
YOU DON'T HAVE TO RUN WUSAGE ON THE SAME COMPUTER AS YOUR WEB BROWSER! For instance, if you have a shell account or the privilege of installing CGI programs on your ISP's web site, then you can run the program on your ISP's computer and save the time and grief of downloading log files to your computer. Just be sure to install the correct version of Wusage for your ISP's operating system. How to Connect Your BrowserWindows users will not need to connect with a web browser, unless they prefer to, in which case they should use the A welcoming message will appear, with instructions to connect your browser to the program. WRITE DOWN the user name and password information that appears the first time you run the program, open the URL that appears with your web browser, and enter the correct name and password. If you are not able to connect, the host name in the URL Wusage has asked you to open may not be exactly correct. This happens when a computer is not configured to supply this information correctly. Just use the correct name or IP address for the computer on which you are running wusage. Step One: Locating Log FilesA web page will appear, titled Welcome to Wusage. Click on the New Configuration File button to get started!The next page you see will contain the following prompt: Click on the Browse Log Files button to begin locating your log files. Working with Log Files on the Same ComputerWindows users will see a dialog box, inquiring whether they wish to access local or remote files. Windows users who choose to access local files will then be asked whether they wish to work with a single log file, or an entire directory of log files. After this prompt is answered, the standard file or folder selection dialog box will appear. Windows users who choose to access remote files will see the same interface described below.For non-Windows users, and Windows users who choose to work with remote files, the next page will look like this: Log File or Directory Beneath this message, a list of files and directories in the current directory appears. Directories appear in brackets. The first item in the list is [Up One Level], which is used to move up to the parent directory.
If You Have Just One Log FileIf your log file is in the currently displayed directory, click on it and click the OK button. If not, browse from directory to directory until you find the file. You can change directories by selecting them in the list and clicking on the OK button.When you have selected an individual file, you will see a message similar like this one: If this is the correct file, click on the Done button and move on to the next step. If not, click on the Change Selection button and continue to browse. If You Have Many Log FilesIf you have many log files, you might prefer to select an entire directory. First, travel to the correct directory, by selecting directories and clicking on the OK button until the correct directory is displayed. Then, click on the Select This Directory button to indicate that you want to analyze ALL of the log files in this directory.Getting Around FasterTo save time, you can enter a complete filename or directory name in the text field above the Open Local button, and then click on that button to move swiftly to that location.Working with Log Files via FTP or HTTPWith Wusage 7.0, you are not limited to analyzing only log files that already reside on the same computer. You can also analyze log files remotely via FTP and HTTP, although it is faster in the long run to install Wusage on the same computer.Scroll down to the bottom of the page, where you will see the following: Use these fields to browse by FTP or HTTP.Enter the name of the FTP or HTTP site where your log files are kept, as well as the correct user name and password, if required. Also enter the correct directory or file path, if you know this information already. You will then be able to browse the FTP or HTTP site, following the same steps given above for browsing local files. However, please note that directories do not always appear in brackets when browsing via FTP. When browsing by HTTP, any HTML page you open is treated as a "directory" of links. This makes it possible to navigate through web pages, provided that a link to the log file or directory does exist somewhere! Step Two: Creating a Report DirectoryThe second step is easier: just choose a directory in which to keep your reports. The following prompt should appear when you are ready for the second step:Most likely, you will want to pick Create NEW Report Directory. However, if you have already made a new, empty directory to keep your reports in, then pick Select EXISTING Report Directory instead. The rest of step two is very similar to step one. Locate the parent directory beneath which you would like to create your report directory. You can do this by selecting directories from the list and clicking Change Directory until you reach the appropriate location. Then, add the name for the new directory to the end of the path that already appears in the text field next to the OK button, and click OK. If you are selecting an existing directory, you will use the OK button to change directories and the Select This Directory button to choose the currently displayed directory as the report directory. Please note that your report directory should not be used for other purposes. Wusage will assume that it owns the files in the chosen directory. Step Three: Create a Configuration FileThe third step is also easy: just pick a location and a name for the configuration file itself. Pick a meaningful name you can recognize later. It is OK to keep your configuration files anywhere you like, such as the directory in which you have installed wusage. (For safety's sake, the program will not let you overwrite an existing file.)When you reach step three, you will see this display: Click on the Create Configuration File button to begin choosing a location. The rest of step three is very similar to step two. Locate the parent directory in which you would like to create your configuration file. You can do this by selecting directories from the list and clicking Change Directory until you reach the appropriate location. Then, add the name for the new configuration file to the end of the path that already appears in the text field next to the OK button, and click OK. Completing the ProcessWhen you have correctly completed all three steps, you will see the following message:Click on the Continue button to move on to the control page for this configuration file. You are now ready to generate your first reports. Additional Configuration OptionsWusage has many other useful configuration options. Unless you look at these, you will probably never see many of the program's best features. You can access these options from the configuration file and clicking on the Edit Configuration button. Be sure to check out the topical configuration editor reference guide to learn about the many options available.Moving OnOnce you have finished creating a configuration file, you are ready to move on to Running Wusage: Generating Statistics .Upgrading from Version 3.2If you are currently using Wusage 3.2, you will want to read this section. If you are upgrading from Wusage 4.0, 4.1, 5.0, or 6.0, you don't need to take any special steps. Just check out the What's New section to find out about new options you may wish to turn on in your configuration file and the new Report Macro Language . Note that you CAN edit your old configuration files with the new user interface.Wusage 4.0 and up have a new, much improved and much friendlier format for configuration files. To use old version 3.2 configuration files, you will need to run the program upgrade (included in the wusage package).
If you are not interested in converting old configuration
files, skip ahead to the running wusage
section.
Example:
(Important Unix note: Unix users may need to type
Taking Advantage of New FeaturesKeep in mind that version 7.0 includes many new configuration file options. Don't miss out; check out the configuration file reference and the What's New in Wusage 7.0? section. You will also want to consider copying updated Domain Groups (Continents) (domaingroups), Search Server Templates (searchservertemplates), Top User Agents Report: Patterns (useragentgroups) and Top Operating Systems Report: Patterns (osgroups) information from a new configuration file created with the configuration file editor.Converting wusage 3.2 Report DataAfter converting the configuration file,upgrade
will ask whether you want to convert your old report
data as well.
Do you have all of your old access log data, perhaps in compressed form? If so, you may wish to skip this step and run wusage 7.0 once on all of your old logs at once to produce new reports. See the Analyzing Many Log Files section for more information. If you decide to convert your data, keep four things in mind:
Previous: Obtaining The Latest Version of Wusage
Next: Running Wusage: Generating Statistics Table of Contents Topical Configuration Editor Reference Alphabetical Configuration Editor Reference Alphabetical Configuration File Reference Glossary of Frequently Used Terms
Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, Boutell.Com, Inc.
wusage@boutell.com Boutell.Com, Inc - PO Box 16716, Seattle WA, 98116, USA Phone/Fax +1 206 658-8176 |
|
Copyright Statement All material, including images, on this web site is Copyright 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, Boutell.Com, Inc. unless otherwise noted. |
|
Need more information? Wondering who to
contact? Visit our whom page.
Boutell.Com, Inc.
PO Box 16716 |