WebTrends Enterprise Reporting Server for Solaris and Linux

Transcription

2

3 Disclaimer WebTrends Corporation makes no representations or warranties with respect to the contents or use of this manual, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, WebTrends Corporation reserves the right to revise this publication and to make changes to its content at any time, without obligation to notify any person or entity of such revisions or changes. Further, WebTrends Corporation makes no representations or warranties with respect to any WebTrends Corporation product, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, WebTrends Corporation reserves the right to make changes to any and all parts of WebTrends Corporation products at any time, without obligation to notify any person or entity of such changes. Trademarks WebTrends is a registered trademark of WebTrends Corporation. WebTrends Enterprise Reporting Server is a trademark of WebTrends Corporation. Other brands and their products are trademarks or registered trademarks of their respective holders. Product Support If you should have any questions during the installation or use of WebTrends, please refer to the WebTrends Corporation Knowledge Base online at: webtrend/support.htm. If you are unable to resolve the problem, do not hesitate to contact our Product Support Department: Telephone: (503) , Fax: (503)

4 Software License Agreement GRANT SOFTWARE TITLE If you receive your first copy of the Software electronically, and a second copy on media, the second copy may be used for archival purposes only. This license does not grant you any right to any enhancement or update. You may not: permit other individuals to use the Software, modify, translate, reverse engineer, decompile, disassemble (except to the extent applicable laws specifically prohibit such restriction), or create derivative works based on the Software; copy the Software (except for back-up purposes); rent, lease, transfer or otherwise transfer rights to the Software; or remove any proprietary notices or labels on the Software or documentation. Title, ownership rights, and intellectual property rights in and to the Software shall remain with the Developer or its suppliers. The Software is protected by the copyright laws of the United States and international copyright treaties. Title, ownership rights, and intellectual property rights in and to the content accessed through the Software is the property of the applicable content owner and may be protected by applicable copyright or other law. This License gives you no rights to such content. DISCLAIMER OF WARRANTIES THERE ARE NO WARRANTIES, CLAIMS OR REPRESENTATIONS MADE BY DEVELOPER, EITHER EXPRESS, IMPLIED, OR STATUTORY, WITH RESPECT TO THE SOFTWARE, INCLUDING WARRANTIES OF QUALITY, PERFORMANCE, NON INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE, NOR ARE THERE ANY WARRANTIES CREATED BY COURSE OF DEALING, COURSE OF PERFORMANCE, OR TRADE USAGE. DEVELOPER DOES NOT WARRANT THAT THE SOFTWARE WILL MEET YOUR NEEDS OR BE FREE FROM ERRORS, OR THAT THE OPERATIONS OF THE SOFTWARE WILL BE UNINTERRUPTED. THE FOREGOING EXCLUSIONS AND DISCLAIMERS ARE AN ESSENTIAL PART OF THIS AGREEMENT AND FORMED THE BASIS FOR DETERMINING THE PRICE CHARGED FOR THE PRODUCTS. SOME STATES DO NOT ALLOW EXCLUSION OF AN IMPLIED WARRANTY, SO THIS DISCLAIMER MAY NOT APPLY TO YOU. EXCLUSIVE REMEDY Developer s cumulative liability to you or any other party for any loss or damages resulting from any claims, demands, or actions arising out of or relating to this Agreement shall not exceed the license fee paid to Developer for use of the Software. In no event shall Developer be liable for any indirect, incidental, consequential, special, or exemplary damages or lost profits, even if Developer has been advised of the possibility of such damages.

5 EXCLUSION OF CONSEQUENTIAL AND OTHER DAMAGES DEVELOPER WILL NOT BE LIABLE TO USER OR ANY THIRD-PARTY CLAIMANT FOR ANY INDIRECT, SPECIAL, PUNITIVE, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, WHETHER BASED ON A CLAIM OR ACTION OF CONTRACT, WARRANTY, NEGLIGENCE, STRICT LIABILITY, OR OTHER TORT, BREACH OF ANY STATUTORY DUTY, INDEMNITY OR CONTRIBUTION, OR OTHERWISE, EVEN IF DEVELOPER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE EXCLUSION CONTAINED IN THIS PARAGRAPH SHALL APPLY REGARDLESS OF THE FAILURE OF THE EXCLUSIVE REMEDY PROVIDED IN THE FOREGOING PARAGRAPH. SOME STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE LIMITATIONS OR EXCLUSIONS IN THIS AND THE FOREGOING PARAGRAPH MAY NOT APPLY TO YOU. TERMINATION This license will terminate automatically if you fail to comply with the limitations described above. On termination, you must destroy all copies of the Software. MISCELLANEOUS This Agreement represents the complete agreement concerning this license between the parties and supersedes all prior agreements and representations between them. It may be amended only in writing executed by both parties. If any provision of this Agreement is held to be unenforceable for any reason, such provision shall be reformed only to the extent necessary to make it enforceable. This Agreement shall be governed by and construed under Oregon law as such law applies to agreements between Oregon residents entered into and to be performed within Oregon, except as governed by Federal law. U.S. Government Restricted Rights. Use, duplication or disclosure by the Government is subject to restrictions set forth in subparagraphs (a) through (d) of the Commercial Computer-Restricted Rights clause at FAR when applicable, or in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS , and in similar clauses in the NASA FAR Supplement. Manufacturer is WebTrends Corporation, 851 SW 6th Avenue, Suite 1200, Portland, OR 97204, U.S.A.

6

7 Contents Chapter 1. Introducing WebTrends Enterprise Reporting Server 15 About this guide About WebTrends Enterprise Reporting Server Reporting server features How it works Reporting Server Concepts Understanding log files Understanding profiles Understanding reports Setting up the Reporting Server What typographic changes mean Making documentation available to non-administrators Getting help Resources Chapter 2. Installing and Setting Up the Reporting Server System requirements Installing the Reporting Server Installing on Solaris Installing on Linux Running the Reporting Server the first time Uninstalling the Reporting Server Installing Add-Ons Chapter 3. Reporting Server Remote Interface About the Remote Interface Accessing the Remote Interface Using the Main Console Using the WebTrends profiles tab

8 WebTrends Enterprise Reporting Server Using the menu Using the toolbar Chapter 4. Analyzing Web Site Activity About Reporting Server analysis Preparing to analyze web site activity Creating a profile Specifying the site configuration Specifying general profile information Activating archiving Disabling the profile Specifying the log file for single server profiles Setting up servers for ClusterTrends profiles Specifying home page location and file names Specifying filters Specifying the cookie to use Selecting the report template Customizing the report header Specifying reports to generate Specifying a schedule for reporting Specifying the location for reports Specifying a DNS lookup method Specifying the database directory Specifying user access Selecting URL Search and Replace definitions Selecting URL Parameter Analysis definitions Selecting Content Group definitions Selecting Path Analysis definitions Copying a Profile Editing a Profile Deleting a Profile Stopping Analysis

9 Restoring profiles to an earlier state Monitoring profile status Changing the profiles displayed in the main console Chapter 5. Filtering the Analysis About filters How filters are processed Adding a filter Filter types Return code filter User address or country filter Multi-Homed Domain filter Directory or URL filter File filter Referrer filter Entry page filter Advertising filter Browser filter Authenticated username filter Day filter Hour filter Chapter 6. Tracking Internet Advertising About Ad Views and Clicks Scenario: tracking internet advertising Defining an advertisement to track Adding a profile for an ad Chapter 7. Using Intranet Management About Intranet Management Scenario: Configuring Reporting Server for the Intranet

10 WebTrends Enterprise Reporting Server Chapter 8. Working with Reports About reports Report viewer workspace Report calendar Table of contents Status Report Viewing reports Using the job queue Viewing profile history Converting reports to Microsoft Word Customizing reports Adding report templates Editing a report template Deleting a report template Chapter 9. Configuring Reporting Server Options About Reporting Server options General options Archives Web Site Locale Profile directory Cookies File types Domain groups Reports Serving Database directory Report templates Reports Report header Report scheduler System performance

11 DNS lookup Proxy Configuring advanced features URL search and replace Defining paths to analyze Creating content groups Analyzing activity for a dynamic site Web server configuration Chapter 10. Working with Users and Permissions About user access Creating a user account Modifying a user account Chapter 11. Running from the command line About the command line capability Directory structure Command line options Scripts Executables Recommended steps for using command line settings Hierarchy of settings Configuring program settings audit archives cookie defaults reports performance language profile Proxy

12 WebTrends Enterprise Reporting Server FTP Interface MaxTableSizes Feedback Unix Configuring web server settings Audit settings Remote configuration Authentication settings Unix Setting up user accounts and permissions user info settings Permissions filter[n] profile restrictions Working with profiles server[n] profile settings filterx Working with Content Groups Default Content Group settings Content Group defintion settings Working with Path Analysis settings Default Path Analysis settings Path Analysis definition settings Working with URL Parameter Analysis settings Default URL Parameter Analysis settings URL Parameter Analysis definition settings Working with URL Search and Replace definitions Default URL Search and Replace settings

13 URL Replacement definition settings Working with report templates WebTrends report template Defining advertisements to track Ad views and ad clicks syntax Setting up your intranet domains Modifying search engines SearchEngines Engine settings Appendix A. Glossary Appendix B. Optimizing & Troubleshooting Investigating Errors Using the wtrs.err file Using the wt.remote.err file Using the wtrs.audit file Using the profile status log Fixing Error 500 Server Error Web server fails to initialize Profiles fail to initialize Conflicting file permissions Database location Factors impacting space and memory Connecting through the Remote Interface Problems creating a Microsoft Word report from Internet Explorer Dates for reports are unexpected Special considerations for configuring the Reporting Server Default configuration Configuration implementing an alternate web server Using multiple web servers and storing results on another machine

14 WebTrends Enterprise Reporting Server

15 Chapter 1. Introducing WebTrends Enterprise Reporting Server About this guide Welcome to WebTrends Enterprise Reporting Server. The purpose of this guide is to introduce the product features, help you install the software, and get you up and running for reporting. About WebTrends Enterprise Reporting Server WebTrends Enterprise Reporting Server provides web server traffic analysis for users with high traffic and multiple clients, such as ISPs, server farms, and large organizations. The built in web server publishes reports automatically, making them available to remote users through their browsers. Administrators can manage all aspects of the Reporting Server remotely. In addition to the browser-based user interface, the program can also be run and configured from the command line. See Running from the command line on page 137 for details. The Reporting Server should be installed on a system that can access the web server log files either locally, through a mounted drive, or transferred using FTP. The platform of the client machines viewing reports is irrelevant, as long as the correct web browser is installed. See System requirements on page 23 for browser requirements. Reporting server features This section provides information on the Reporting Server features. Web Server Log File Analysis--Allows you to report on all aspects of your web site s activity including how many people are visiting your web site, where they come from and what pages interest them most. Support for Multiple Servers--ClusterTrendsTM technology allows you to get accurate reports for sites hosted by multiple servers. ClusterTrends can be implemented if you have a Server Add-On license. Report Template Designer--Create your own look with Report Templates. You choose the colors, fonts, layouts, and content to use. 15

16 WebTrends Enterprise Reporting Server Comprehensive Reports--Reports are created and maintained automatically at regular intervals, eliminating the need to run several individual reports manually. Generate weekly, monthly, quarterly, and yearly reports that focus on the content you choose. User Access Management--User access management allows you to grant permissions and default settings on an individual basis. A range of permissions is possible, from program wide access as an administrator to reporting ability with viewing report access. Preconfigure profile settings for any or all users, making their work easier. Users only view the reports and program features they have access to. Customizable Interface--Many dialogs in the interface are optional and can be disabled for non-administrators. You decide if those dialogs are visible to your users. New features are added frequently. Refer to our web site at for the latest information. How it works The Reporting Server uses the log file from your web server to analyze activity on your site. Through a profile, you specify the location of the log file, how it should be analyzed, and the reports to generate. See Understanding log files on page 17 for details on log files. 16

17 Chapter 1. Introducing WebTrends Enterprise Reporting Server Start Report Process WebTrends Reporting Server Profile Web Server Log File Log File Data Analyzed Report for Profile is Generated and Published WebTrends Reporting Server Report End Report Process Reporting Server Concepts In order to set up and run the Reporting Server, there are a few key concepts you should understand. This section discusses log files, profiles and reports. Understanding log files When someone connects to your site, the event is stored by the web server in a log file. Log files record data such as the user, the protocol used to access the page (such as HTTP or FTP), what they did, the platform used (such as NT, Windows 98, or Unix), the search engine (such as Yahoo or Lycos), keywords, date and time, and much more. The Reporting Server uses the data from this log file to create reports. Log files typically have a.log extension and are located in various directories, depending on the web server that you use. 17

18 WebTrends Enterprise Reporting Server Sample Log File: Common and Combined (Extended) Format The NCSA recognizes two log file format standards--the common and combined (extended) formats. The following is a sample line from a "common" log file: - [16/Jan/1999:10:36: ] "GET / dept/argguides/dwsg/ jpg HTTP/1.0" The "combined" or "extended" log file format is similar to the common log file format with the addition of the referrer and agent fields at the end of the line in quotation marks. The following is a sample in combined format: [12/Jan/1996:19:35: ] "GET / HTTP/1.0" " search?p=trends%20internet" "SPRY_Mosaic/v8.32 (Windows 16-bit) SPRY_package/v4.00" In this example, the referrer is search?p=trends%20internet, the agent is SPRY_Mosaic/v8.32, and the platform is Windows 16-bit. Understanding profiles Profiles specify how the log file should be analyzed and the activity you want to report on. Through the profile you define the location and log file type, any activity you want filtered, and whether or not IP resolution should be performed. WebTrends analyzes the log file and uses the result to create reports. Profiles covered in Analyzing Web Site Activity on page 39. Understanding reports Reports are based on profiles. Reports are posted automatically, and are available for viewing through your browser. All archived report data is accessible using the calendar in the Report Viewer. Reports are covered in Working with Reports on page

19 Chapter 1. Introducing WebTrends Enterprise Reporting Server Setting up the Reporting Server New to the Reporting Server? Use this section to get a sense of the steps involved in taking the product from a CD-ROM sitting in your drive to running reports. For This Step Refer To 1. Install the Software. Installing and Setting Up the Reporting Server on page Review the sample profile. This is the essence of reporting. Profiles identify the web server log file type, the location of the log file, how the data should be analyzed, and the reports you want to create. Make note of the dialogs you may want to disable for non-administrators. You may want to give the responsibility of creating and maintaining profiles to Administrators only, making non-administrators lives much easier; all they ll need to do is log in and select their reports. 3. Run a Complete Summary report on the sample profile. Make note of any tables you want to exclude, or those you d like more or less information. Later you can reflect these changes in the profile. Consider the colors used. You can change the colors for the Report Template in the Template dialog. 4. Create profiles for the logs you want to analyze. If you are providing customized reports for different users, you will create a profile for each. Tell your users where they can view reports. 5. Review the Options settings. Many default settings for profiles are located here. Decide whether you want nonadministrators to have access to the optional dialogs. About Reporting Server analysis on page 39 Report viewer workspace on page 90. Creating a profile on page 40. Configuring Reporting Server Options on page

20 WebTrends Enterprise Reporting Server For This Step 6. Create user accounts for anyone who is going to use the Reporting Server for viewing reports or managing any aspect of the reporting server. For each user, determine the permissions you want to give. 7. Modify the Report Template Styles or create your own if needed. Refer To Working with Users and Permissions on page 133. Customizing reports on page 96. What typographic changes mean The following table describes the typographic changes used in this guide. Table 1-1 Typographical Changes This text Bold Title Case courier font Represents A button in the graphical user interface (New button). Refers to the names of dialogs and fields (Add Profile dialog, Home Page URL field) in the graphical user interface. Commands, source code examples, program output, and file or program names. in quotes Refers to a title of a chapter or section. See Glossary on page 205 for additional definitions of terms used in the program and in the documentation. Making documentation available to non-administrators A user guide for non-administrators is also available. We strongly recommend that you make the WebTrends Enterprise Reporting Server User Guide available on your Intranet or network. The user guide can be viewed online using Adobe Acrobat. If you purchased the CD-ROM version of the Reporting Server, you can get the pdf from the CD. Otherwise, you can download the manual from the Support section of the WebTrends Corporation web site: 1 Open your browser. 2 Enter the following URL: 20

21 Chapter 1. Introducing WebTrends Enterprise Reporting Server 3 Click Support to access the Product Support Page. 4 Click Documentation to view the manuals available. Click Support Getting help The Reporting Server provides online help to guide you through the program. Look for the Help button in program dialogs. If you re not sure about what to enter in field, click the Help button. At any time, you can access help by selecting the Help menu from the main console. Resources WebTrends portal for Internet and Intranet professionals is a great resource for Web related information, industry news, reviews, and other useful information. Visit to see for yourself. 21

22 WebTrends Enterprise Reporting Server 22

23 Chapter 2. Server Installing and Setting Up the Reporting System requirements (Solaris) You can run the Reporting Server on Sun Ultra TM or Sun SPARCstation TM running Solaris 2.5, 2.6, or 2.7. (Linux) You can run the Reporting Server on any Intel platforms running Red Hat 5.2 or above. You can install and run the program with the following minimum system requirements: 45 MB available disk space 128 MB memory Note: More space and memory is required to analyze large logs. Contact your Product Support representative for more information. You can view reports on any machine so long as Netscape Navigator 4.5 or above or Microsoft Internet Explorer 4.01 or above is installed on the machine. Installing the Reporting Server Note: The Bourne shell or Bourne-like shell must be available to install the Reporting Server. Installing on Solaris Install the Reporting Server using either the install script from a set of tarred files, or the Solaris package. Using the installation script The installation script installs the files and configures the program in one process. 23

24 WebTrends Enterprise Reporting Server 1 Type mkdir <tempdirectoryname> where tempdirectoryname refers to the directory used to uncompress and untar the files needed for installation. 2 Type cd <tempdirectoryname> 3 Type cp <source path>/wtrs-2.0-sparc.tar.gz. 4 Type gunzip wtrs-2.0-sparc.tar.gz 5 Type tar-xvf wtrs-2.0-sparc.tar 6 Type cd wtrs-2.0 Note: If you are not logged on as root, Reporting Server warns that you can not install the program as a service. Type Ctrl-C to cancel, or Enter to proceed with the installation. 7 Type./install.wtrs The WebTrends Enterprise Reporting Server Software License Agreement is displayed. 8 Press Enter to view the Software License Agreement. 9 Type accept if you consent to the Software License Agreement. The installation begins. If you do not accept the Software License Agreement, enter CTRL-C or type anything other than "accept." 10 Press Enter when you have reviewed the explanation of your authentication options. 24

25 Chapter 2. Installing and Setting Up the Reporting Server 11 Enter Y to accept the default directory for the Reporting Server. The default directory is /usr/local/webtrends. To install the program in another location, enter the directory. 12 Enter the port number to use for the user interface. This is the port through which users access the Reporting Server through their browsers. If you are installing as root, the default port is 99. If you are installing as non-root user, the default is Make sure the port that you specify is not used by another service. Enter Y to verify the port number. Note: If you are logged in as root, you can use ports below Enter the username of the person performing the installation. The user you specify is given Administrator rights for the Reporting Server. 14 Enter the port number that the user interface can use to communicate with the analysis engine. It must be a different port than you specified in Step 12. The default port is To accept it, press Enter. Enter Y to verify that this is the port that you want to use. 15 If you are installing as root, you can specify how you want to start the Reporting Server. Enter Y to start the Reporting Server automatically at system bootup. Otherwise, enter n. 16 Enter Y to start the Reporting Server now. Otherwise, enter n. 17 Press Enter when you have reviewed information about the services available. 18 Enter Y to review the readme file. Otherwise, enter n. Note: To run the Reporting Server, launch your browser and enter the name of the machine, followed by a colon and the port you specified during installation. For example, 25

26 WebTrends Enterprise Reporting Server Running the installation package To install the Reporting Server using the Solaris package: 1 Type mkdir <tempdirectoryname> where tempdirectoryname refers to the directory used to uncompress and untar the files needed for installation. 2 Type cd <tempdirectoryname> 3 Type cp <source path>/wtrs-2.0-sparc.pkg.tar.gz 4 Type gunzip wtrs-2.0-sparc.pkg.tar.gz 5 Type tar-xvf wtrs-2.0-sparc.pkg.tar 6 Type cd wtrs-2.0-sparc 7 Type pkgadd -d pwd /wtrs-2.0-sparc The package installs the program files. 8 When you are ready to configure program settings, run configure.sh from the /wtrs-2.0-sparc directory which takes you through the setup process. Refer to steps 8-19 of Using the installation script on page 23 for details. Installing an upgrade using the script To upgrade your existing version of the Reporting Server, install the program in the same directory. During the installation, a backup of wtremote.ini and wtm_wtx.ini are made. The new settings in these files are merged with the existing ones. Installing an upgrade using the Solaris package 1 Type mkdir <tempdirectoryname> where tempdirectoryname refers to the directory used to uncompress and untar the files needed for installation. 26

27 Chapter 2. Installing and Setting Up the Reporting Server 2 Type cd <tempdirectoryname> 3 Type cp <source path>/wtrs-2.0-sparc.pkg.tar.gz 4 Type gunzip wtrs-2.0-sparc.pkg.tar.gz 5 Type tar-xvf wtrs-2.0-sparc.pkg.tar 6 Type cd wtrs-2.0-sparc 7 Type pkgadd -a pwd /admin -d pwd /wtrs-2.0-sparc Installing on Linux Install the Reporting Server using the installation script or the RPM. Note: The Bourne shell or Bourne-like shell must be available to install the Reporting Server. Using the installation script The installation script installs the files and configures program settings in one process. 1 Type mkdir <tempdirectoryname> where tempdirectoryname refers to the directory used to uncompress and untar the files needed for installation. 2 Type cd <tempdirectoryname> 3 Type cp <source path>/wtrs-2.0-linux.i586.tar.gz 27

28 WebTrends Enterprise Reporting Server 4 Type gunzip wtrs-2.0-linux.i586.tar.gz The files needed for installation are uncompresed. 5 Type tar-xvf wtrs-2.0.tar 6 Type cd wtrs-2.0 If you are not logged on as root, Reporting Server warns that you can not install the program as a service. Type Ctrl-C to cancel, or Enter to proceed with the installation. 7 Type./install.wtrs The WebTrends Enterprise Reporting Server Software License Agreement is displayed. Press Enter to view the Software License Agreement. 8 Type accept if you consent to the Software License Agreement. If you do not accept the Software License Agreement, enter CTRL-C or anything other than accept. 9 Press Enter when you have reviewed the explanation of authentication options. 10 Press Enter to accept the default directory for the Reporting Server. The default directory is /usr/local/webtrends. To install the program in another location, enter the directory. Enter Y to verify that you want to use the specified directory. 11 Enter the port number for the user interface. This is the port through which users access the Reporting Server through their browsers. If you are installing as root, the default port is 99. The default port for non-root users is Make sure the port is unused by any other service. Enter Y to verify the port number. Note: If you are logged in as root, you can use ports below

29 Chapter 2. Installing and Setting Up the Reporting Server 12 Enter the username of the Administrator performing the installation. 13 Enter the port number that the user interface can use to communicate with the analysis engine. It must be a different port than you specified in Step 11. The default port is To accept it, press Enter. Enter Y to verify that this is the port that you want to use. 14 If installing as root, you can specify how you want to start the Reporting Server. Type Y to start the Reporting Server when you boot the system. Type N if you want to start it manually. 15 Type Y to start the service when the installation is complete. Type n to start it manually. 16 Type Y to view the readme file. Otherwise type n. Using the RPM You can run the RPM from the WebTrends Enterprise Reporting Server CD-ROM. 1 From the CD-ROM drive, type rpm -i wt-ers-linux.i586.rpm 2 When you are ready to configure program settings, run configure.sh which takes you through the program setup. Installing an upgrade using the RPM To upgrade your existing version of the Reporting Server, install the program in the same directory. During the installation, a backup of wtremote.ini and wtm_wtx.ini are made. The new settings in these files are merged with the existing ones. 1 From the CD-ROM drive, type rpm -U wt-ers-linux.i586.rpm 2 When you are ready to configure program settings, run configure.sh which takes you through the program setup. 29

30 WebTrends Enterprise Reporting Server Running the Reporting Server the first time Once the Reporting Server is installed, you can run it through your browser. To run the Reporting Server 1 Open your Internet Explorer or Netscape Navigator browser. 2 Enter the name of the machine where the Reporting Server is installed, followed by a colon and the port that you specified during installation. For example, 3 The Reporting Server Login screen opens. Click the Login button. 4 Enter the username you specified during the installation. For now, you can leave the password field blank. You should specify a password in your.usr file. See About user access on page 133 for details. 5 The Limited Demonstration screen opens. 6 Specify whether you want to download a trial code purchase a full version. 30

31 Chapter 2. Installing and Setting Up the Reporting Server 7 Once you complete the trial registration form or purchase a full version, you are ed a trial code or product serial number. 8 Enter the code you are given in the Trial Code or Product Serial Number field. Click Submit. Uninstalling the Reporting Server If at any time you want to remove the Reporting Server from your system, use the procedure described here. To uninstall the Reporting Server: 1 If the Reporting Server is running, stop it by typing <install dir>./wtrs.server stop 2 If the Reporting Server is configured to run as a service, type (Solaris) rm /etc/rc3.d/s99 wtrs.server (Linux) rm /etc/rc.d/init.d/s99 Note: You must be logged in as root to remove this file. 3 Type rm -r -f <install dir> where <install dir> refers to the directory where the Reporting Server is installed. 4 Type (Solaris) rm /etc/init.d/wtrs.server (Linux)rm /etc/rc.d/init.d/wtrs.server to remove the wtrs.server file. Note: You must be logged in as root to remove this file. Installing Add-Ons When you first install the Enterprise Reporting Server, you have the ability to analyze log files for one web server. The standard installation supports a total of five (5) users. If you wish to analyze log files for additional web servers, you must purchase the appropriate number of Server Add-Ons. 31

32 WebTrends Enterprise Reporting Server To support more than five users, you must purchase the appropriate number of User Add-ons. You can purchase both Server Add-Ons and User Add-Ons from the WebTrends Corporation web site. To purchase and install the Add-On: 1 Go the WebTrends Corporation web site at order/. 2 Order the Add-ons. Write down the license code that you are given. Note: You must know the license code to run the installation. 3 Select Help>License Add-ons. Enter the license code you were given. The new license is activated. 32

33 Chapter 3. Reporting Server Remote Interface About the Remote Interface This chapter explains how to log in to the Reporting Server and how to use the program through the Remote Interface. Note: You can also control all aspects of the Reporting Server from the command line. See Running from the command line on page 137 for details. Accessing the Remote Interface To run the Reporting Server through the remote interface, the program and the reporting server must be started. To start the Reporting Server 1 Enter the path to the install directory and type wtrs The program starts as shown here. 2 Type wtrs -start The reporting server starts. 3 Type wtinterface -start And the remote interface starts. 33

34 WebTrends Enterprise Reporting Server To login to the Reporting Server 1 Open your web browser (Netscape Navigator or Internet Explorer.) 2 Enter the IP Address or domain name for the machine where the Reporting Server is installed followed by the port specified during installation. For example, The Login window opens as shown here: 3 Click the Login button. 4 Enter your system username and password for the machine where the Reporting Server is installed. To change the username and password, see Working with Users and Permissions on page 133.Enter your system username and password for machine where WebTrends is installed or the username and password you were given to run the program. 5 If you have not completed the registration for the Reporting Server, the following dialog opens. Register Now--Click this button to register your copy of the Reporting Server. 34

35 Chapter 3. Reporting Server Remote Interface Register Later--Click this button to complete the registration at another time. Using the Main Console When you log in, the Main Console opens. From the Main Console, you can run reports, work with profiles, and access program configuration settings. Tip: You can turn the browser toolbar on or off using the Browser Toolbar command on the File menu. 35

36 WebTrends Enterprise Reporting Server Menu bar Tool bar Profile List Using the WebTrends profiles tab The WebTrends Profiles tab displays all profiles that have been created.sample profiles are included so that you can get familiar with the Reporting Server and run sample reports. As an Administrator, you have access to all profiles. Using the menu The menu bar provides access to all program functions. For example, you can create a new profile, view profile status, or access your server license agreement. Table 3-1 Menus Menu File Profile View Configuration Provides Commands for working with profiles and reports and exiting the program. Commands for the analysis and performing archives. Access to status windows, job queues, and browser toolbar. Access to program options, user access, advanced features, and web server configuration. 36

37 Chapter 3. Reporting Server Remote Interface Menu Help Feedback Provides Access to the Help Table of Contents, the WebTrends Corporation web site, and the About box. Enterprise Reporting Server feedback form. Let us know what you think. Using the toolbar The toolbar provides quick access to the most used commands. Table 3-2 Toolbar commands Button Purpose Displays the Report window where you view the report for the selected profile. Displays the Options window where you can modify program options including the default values for profiles. Displays the Configure User Access window where you can create and modify user accounts. Displays the Edit Profile dialog where you can change the selected profile settings. Displays the Profile Wizard for creating a new profile. All analysis and reporting is based on profiles. Lets you remove the selected profile from the list. Displays the Report Templates window where you can define the colors used for reports. Displays the Ad Views and Clicks dialog where you can set up ads to track for traffic. Displays the Intranet Configuration dialog where you can set up the domains in your organization by country, state, city, department or workstation. Displays the Online Help where you ll find detailed information on all Reporting Server dialogs. 37

39 Chapter 4. Analyzing Web Site Activity About Reporting Server analysis Reporting Server reports are based on profiles which define the location of your web server log file and how it should be analyzed. A profile provides the following data: whether your web site resides on a single server or on multiple servers (including server clusters) log file type and location home page location and default pages for your site filters to apply users who can access the profile location for report data reports to create schedule for updating reports cookie to use As an Administrator, you can add, edit, and modify all profiles, even those created by other users. Note: Specify the profile settings non-administrators have access to through the Options window. See Configuring Reporting Server Options on page 103 for details. Note: The Reporting Server allows you to specify which users have access to profiles and the options they are allowed to define. See Working with Users and Permissions on page 133 for details. Preparing to analyze web site activity To set up a new profile to analyze your site s activity, you ll need the following data: Where are log files stored? You ll need the exact file path to your log files. 39

40 WebTrends Enterprise Reporting Server What is the naming convention used for log files? For example, log files might be named according to date followed by a.log extension (such as log). If log files are compressed they may have a.zip,.gz, or.tar extension. What is the rotation of your log files? You ll need to know if they are rotated, and if so, on what schedule: daily, monthly, and so on. Does your site reside on a single server or multiple servers? This is the first question you ll encounter when you create a profile. If your site is on more than one server (such as in a server cluster configuration), you ll need to know the location of the servers and where your logs reside on the servers. Also, be sure you have the proper licensing if you are reporting on activity for multiple servers. Creating a profile Many of the steps involved in creating a profile are optional or may have been configured for you. This section describes every profile dialog that may be available, depending on your program setup. Refer to the sections that follow for a complete explanation of the steps in the following table. To create a profile 1 Click New on the toolbar. 2 Define the settings described in the following table. Some settings are optional and may not be accessible to you. Table 4-1 Profile settings Dialog Description Refer to Site Configuration General Specifies whether the web site is maintained by one server or multiple servers (such as a server cluster or farm). Specifies a name for the profile. Provides settings for disabling the profile and enabling archiving. See Specifying the site configuration on page 42. See Specifying general profile information on page

41 Chapter 4. Analyzing Web Site Activity Dialog Description Refer to List of Servers Log File Path Home Filters Cookies Report Template Report Header Reports Report Scheduler Report Paths DNS Lookup Database Directory If the web site exists on multiple servers, this dialog specifies the servers and the location of the log files. If your web site is on one server, this dialog specifies the location of the log files. Specifies the home page default file names and the URL for the root of your web site. This information is optional. Specifies the activity filters to apply to this profile. By default, all log file activity is analyzed. Allows you to enable cookies and specify the cookie to use. Specifies the template to use for reports. Specifies settings for the report header such as a graphic or title to use. Specifies the reports created, and allows you to delete old reports when the specified limit is reached. Specifies when the reports are run and how often they are updated. Specifies where reports are posted on the web server and the directory where they are saved. Specifies the IP resolution method to use. Specifies the location for this profile s database. See Setting up servers for ClusterTrends profiles on page 46. See Specifying the log file for single server profiles on page 44. See Specifying home page location and file names on page 47. See Specifying filters on page 49. See Specifying the cookie to use on page 49. See Selecting the report template on page 50. See Customizing the report header on page 51. See Specifying reports to generate on page 52. See Specifying a schedule for reporting on page 54. See Specifying the location for reports on page 54. See Specifying a DNS lookup method on page 55. See Specifying the database directory on page

42 WebTrends Enterprise Reporting Server Dialog Description Refer to User Access Advanced Features Specifies the users who can use this profile. Provides access to any Advanced Features that can be defined on a profile basis. See Specifying user access on page 58 See Selecting URL Search and Replace definitions on page 59, Selecting URL Parameter Analysis definitions on page 59, Selecting Content Group definitions on page 60, or Selecting Path Analysis definitions on page 60. Specifying the site configuration With the ClusterTrends Add-On, the Reporting Server can analyze web site activity for sites that reside on multiple servers. This is the first issue addressed when you create a new profile. To make your site configuration selection 1 Click New on the toolbar. The Site Configuration dialog opens. 2 Select one of the following: 42

43 Chapter 4. Analyzing Web Site Activity My Site Is On One Server If your web site resides on one server, select this option. My Site Resides on Multiple Servers If your site resides on more than one server, such as a server cluster, select this option. Note: You must have purchased and installed a Server Add-on with ClusterTrends to implement this technology. Specifying general profile information The General dialog specifies the name for the profile. The profile name identifies it in the profile list and serves as the default title for reports. 1 Select the profile to work with, and click Edit. 2 Select the General dialog. Enter a name for the profile. 3 Specify how much of the log to analyze by selecting one of the following: From the start of the log file--analyzes the entire log file. From the following date--analyzes the log beginning with the date specified. Enter the date in day/month/year format. Activating archiving You can archive the profiles that you chose at regular intervals. An archive contains a backup of the databases for the profile. Archiving allows you to restore a profile to a point in the past. Archives are useful if some log files were not available during analysis or if you made changes to the profile that you want to undo. Archive settings are maintained in the Options window. See Restoring profiles to an earlier state on page 62 for details on using archives. To enable archiving 1 Select the profile to work with, and click Edit. 43

44 WebTrends Enterprise Reporting Server 2 Select the General tab. 3 Click in the Enable Archiving box. The archive is made at regular intervals which have been defined in the Options window. See Archives on page 104 for details. Disabling the profile You can disable the analysis and reporting for an individual profile. 1 Select the profile to work with, and click Edit. 2 Select the General dialog, and click in the Disable Profile check box. 3 Click OK. The profile is disabled until you clear the Disable Profile box. Specifying the log file for single server profiles If your web site resides on a single server, use this information to specify the location and format of the log file. This is the most important step in creating a profile. Without the location of the log file, the program cannot access or analyze the activity on your web site. You can access your log either locally through a mapped or mounted drive, or using FTP. Tip: If you get a message stating that the profile has failed to initialize, verify that the log file path that you entered is correct. See Understanding log files on page 17 for an overview of log files. 1 Select the profile to work with, and click Edit. 44

45 Chapter 4. Analyzing Web Site Activity 2 Select the Log File Path dialog. Click here for Examples 3 From the drop-down list, select the access method to use: file://--select this option if the file is available on the machine where WebTrends Enterprise Reporting Server is installed, or if it is accessible through a mounted/mapped drive. ftp://--select this option if you access the log file using FTP. For example, if your site is hosted by an ISP, you may have to retrieve your log using this method. 4 Specify the path to the log in the corresponding field. If your logs are saved according to date, you can use date macros to simplify your entry. You can specify a set of similarly named logs using wildcards. Or separate several individual logs with a space. For example, httpd/logfiles/access_log specifies the access_log file in the httpd/logfiles directory. 5 If the log files specified are accessed using FTP and the server requires the user to authenticate, enter the login Information in the Username and Password fields. 45

46 WebTrends Enterprise Reporting Server Setting up servers for ClusterTrends profiles If your web site resides on more than one server, such as a server cluster or farm, set up the servers to analyze here. For each server, specify the location of the log files. 1 Select the ClusterTrends profile to work with, and click Edit. 2 Select the List of Servers tab. 3 Select the log file format from the list. The Server Names list specifies any servers that have been defined for this web site. 46

47 Chapter 4. Analyzing Web Site Activity 4 Click Add to define a new server. In the Server Name field, enter a name to identify the server. 5 In the Log File Path field, enter the path to the log file. Logs that are accessed using FTP, should be specified using the following syntax: ftp://ftp.domain.com/filepath where domain.com is the FTP server and file path is the complete path to the log files. Enter each log file path on a separate line. 6 If the log files are accessed using FTP and the server requires the user to authenticate, provide the authentication information in the Username and Password fields. 7 Click OK when you are finished. See Specifying the log file for single server profiles on page 44 for details on specifying the access method and log file path. Specifying home page location and file names The data in the Home Page dialog is used to provide a more accurate home page hit count and to locate your home page directory for looking up web page titles. 47

48 WebTrends Enterprise Reporting Server Note: To include page titles in reports, you must also check the HTML Page Titles box in the General options tab. To include this information in reports 1 Select the profile to work with, and click Edit. 2 Select the Home dialog. 3 In the Home Page File Names field, specify the file names that the web server defaults to when a visitor enters a URL without entering a specific file name. Separate multiple file names with spaces. Doing so reports all references to the home page whether or not the visitor specifically included the file name, making the home page hit count more accurate. You can enter up to 255 characters. 4 In the web site URL field, specify the URL to the root your web site, including the access method ( ftp://, or file:///). For example, if you specified your Home Page File Names as default.htm and the Web Site URL as a hit to is identified as And a hit to 48

49 Chapter 4. Analyzing Web Site Activity is identified as a hit to Specifying filters You can use filters to narrow the focus of your analysis. By default, all log file data is included in the analysis, indicated by the Include Everything filter. All other filters are optional. 1 Select the profile to use, and click Edit. 2 Select the Filters tab. Because the Include Everything filter overrides all other filters, you must select it, and click Delete. Click Add to create a new filter, or select a filter in the list, and click Edit to modify it. See Filtering the Analysis on page 67 for details on working with filters. Specifying the cookie to use You can use cookies to identify unique user sessions during the analysis. A cookie is a file sent with the page requested from the server to the visitor. Cookies are stored on the visitor s system. The stored cookie is then included in subsequent requests to your site by this visitor and is recorded in the log file, enabling you to uniquely identify the visitor. Activating cookies makes user session data more accurate because each visitor is clearly distinguished. 1 Select the profile to work with, and click Edit. 49

50 WebTrends Enterprise Reporting Server 2 Select the Cookies tab. If you want to use cookies in the analysis for this profile, click in the Use Cookies To Identify User Sessions check box. 3 Specify whether or not to validate the cookie. If your Web site uses a single cookie, you don t need to validate. However, if your site uses several cookies, select Validate Cookie Format. 4 If you selected Validate Cookie Format in Step 3, specify the cookie to match: Use this cookie--if your site uses several cookies, enter the cookie you use for tracking user sessions here. For example, if you are using Microsoft SiteServer, you might have cookies that look like this: SITESERVER=ID=CookieValue1; SITESERVER=GUID=CookieValue2 If the GUID is the cookie that you want to use to identify user sessions, then you should enter SITESERVER=GUID here. Use WebTrends plug-in cookie--if a WebTrends extended logging plug-in is installed on your web server, you can use the WebTrends cookie to track user sessions. Selecting the report template Report templates define the content, language, and style for the report. As an Administrator, you have access to Report Template settings. See Customizing reports on page 96 for details. 50

51 Chapter 4. Analyzing Web Site Activity Note: If the program Admininistrator has already configured this setting, you will not see it. 1 Select the profile to use, and click Edit. 2 Select the Report Template dialog. Select the template from the drop-down list. Customizing the report header The Report Header dialog allows you to provide additional details in the report header. Note: If the program Admininistrator has already configured this setting, you will not see it. 1 Select the profile to use, and click Edit. 51

52 WebTrends Enterprise Reporting Server 2 Select the Report Header tab. Here you can specify the following: Report Title--By default, the profile description is used as the title for reports, but you can modify it here. Report Description--Specifies additional information about the report that is useful to the user. Report Image--Specifies the file path to a graphic that you want to include. Report Image Alt--Specifies the text to display in place of the graphic if it isn t available. Associated URL--Specifies the URL to load when the report user clicks on the image. You may have to scroll the window to see this option. Specifying reports to generate Use the Reports dialog to select the reports to maintain for this profile. Each time a profile is analyzed, the Reporting Server updates each of the reports selected. For example, if daily, weekly, and monthly are selected, the daily report is updated each time the log is analyzed during the day. Then, at the end of the day, the weekly and monthly reports are updated using the completed daily report, and because it is no longer used, the data used for the daily report is discarded. 52

53 Chapter 4. Analyzing Web Site Activity Similarly, when the weekly report is complete, the data used to create it is discarded, and at the end of the month when the monthly report is complete, the data used to create it is discarded. Because disk space and memory are needed to maintain the report data, only select the reports that you need. Note: Because this dialog is optional, you may not see it. 1 Select the profile to work with, and click Edit. A check indicates that the report will be created. 2 Select the Reports tab, and select the report intervals that you want to maintain by clicking in the Report Types boxes. 3 For each report type, specify the number of reports to save from the corresponding Reports to Store list. If you run a large number of reports, you might limit the number of reports that are saved. Using this option, you can select the number of reports saved for each interval. For example, you might want to keep one month s worth of daily reports at a time; once the report for February 1 is created, the report for January 1 is deleted, and so on. When determining how many reports to store, consider how much disk space you want to devote to reports and how long you want to save them. A report using the Complete Summary template as it was installed needs 1 MB. 53

54 WebTrends Enterprise Reporting Server 4 Click OK to save your changes. Specifying a schedule for reporting Use the Report Scheduler dialog to specify when the profile is analyzed and how often reports are updated. If the program Administrators have chosen, new profiles can be analyzed immediately once they are created. If this is the case, the Reports Scheduler dialog says that the "Start Immediately" option has been selected. In such a case, the time and interval that you specify here determines all subsequent analyses. 1 Select the profile to work with, and click Edit. 2 Select the Scheduler tab. In the Base Time field, specify when you want reports to begin. 3 Using the Interval drop-down list, select how often to update the report. "Start Immediately" message Specifying the location for reports The Reporting Server can be configured by the Administrator to use either the built-in web server or an alternate web server for posting reports. If the program has been configured to use an alternate web 54

55 Chapter 4. Analyzing Web Site Activity server and the location can be defined at the profile level, you can use the Report Paths dialog to specify the location and URL where the reports for this profile are posted. Note: If you change the directory where reports are stored, only new reports appear in this directory. Reports created before the change remain in the original directory. 1 Select the profile to work with, and click Edit. 2 Select the Report Paths dialog. By default, the location of the built-in web server is displayed. 3 In the Report Directory field, specify the location where reports for this profile are saved. 4 In the Report URL Path, specify the URL where users can view the report for this profile. Specifying a DNS lookup method The DNS Lookup dialog specifies the DNS lookup method to use for this profile. DNS Lookup is the process of associating a domain name with a numeric IP address. This can be done either by the web server 55

56 WebTrends Enterprise Reporting Server when logging activity or by the Reporting Server when it analyzes the log files. DNS Lookup is performed more efficiently by the web server as the log is created, rather than by the Reporting Server. However, if you know your web server administrator or ISP disabled DNS Lookups for their servers, you can have the Reporting Server do them for you. 1 Select the profile to work with, and click Edit. 2 Select one of the following methods: Quick mode, using format from log--this is the fastest method for creating reports. If your web server doesn t perform DNS Lookups and you select this method, reports display visitor s IP addresses rather than domain names. Resolve mode, lookup all numeric IPs--If your web server does not perform DNS Lookups and you need geographic or other domain-related information, select this option. Note: Resolve mode may slow reporting. Use it only if DNS lookups cannot be done on the server. Once a numeric address has been looked up, its text equivalent is stored in a permanent cache to expedite all subsequent reports. The default cache size is 50,000 entries; once this limit is reached, the oldest addresses are 56

57 Chapter 4. Analyzing Web Site Activity replaced with the new entries. You can change the cache size in the General Options tab. See General options on page 103 for details. Auto mode, if you re unsure--if you don t know whether your log file contains IP addresses or domain names, you can let the Reporting Server decide. With auto-mode selected, the program assumes that your web server wasn t performing DNS lookups, and uses Resolve Mode. Then, if a record contains a domain name, it assumes that the web server was performing DNS lookup and switches to Quick Mode. Specifying the database directory If accessible, use the Database Directory dialog to specify the location where the profile database should be saved. These databases store all the information needed to create reports, and because of this, they can grow quite large. For this reason, you should place these directories on a drive where you have a large amount of available space. Note: If you change the database location, the Reporting Server reanalyzes the log file from the beginning. This is because a new database is created, and the original databases remain in the old location. 57

58 WebTrends Enterprise Reporting Server 1 Select the profile to work with, and click Edit. 2 Select the Report Database tab, and enter the file path where you want to store the profile database. To maintain separate databases for each profile, use the %PROFILE% macro; the profile name is used in the directory name. Specifying user access You can control the users who can use each profile through the Profile Access dialog. Giving a user access to the profile enables them to use it according to the rights that they have been given. If you want the report for this profile to be viewed publicly, be sure you turn on that option. 1 Select the profile to work with, and click Edit. 2 Select the Profile Access dialog. The Users Who Have Access list displays anyone who has access to this profile. The User Without Access list displays anyone who is not able to use the profile. Use the arrows to change the list. 3 Click the Enable Reports Generated... box to make reports for this profile available to everyone. Use the arrows to move users. 58

59 Chapter 4. Analyzing Web Site Activity Selecting URL Search and Replace definitions URL Search and Replace settings are defined in the Advanced features window. URL Search and Replace definitions can either be applied to all profiles or applied on a profile basis. If the option to select definitions for each profile is enabled, the Advanced Features dialog is accessible when you work with profiles. URL replacement definitions delete specific identifiers from URLs or replace all unique identifiers with a common string. View the settings for the definition to see how it functions. See URL search and replace on page 123 for more information on using this feature. To specify the URL replacement definitions 1 Select a profile to work with, and click Edit. 2 Select the Advanced Features tab. Click Configure. 3 Select the URL Replacement tab to view a list of definitions. 4 Select a definition, and click View to view its settings. 5 Click in the check boxes to select the definitions to use. Selecting URL Parameter Analysis definitions URL Parameter Analysis settings are defined in the Advanced Features window. URL Parameter Analysis definitions can either be applied to all profiles or applied on a profile basis. If the option to choose URL Parameter definitions for each profile is enabled, the Advanced Features tab is accessible in the profile window. URL Parameter Analysis definitions associate a page with the parameter used to create it, allowing you to report on dynamically created web pages. See Analyzing activity for a dynamic site on page 130 for more information on using this feature. To specify URL parameter analysis definitions 1 Select a profile to work with, and click Edit. 59

60 WebTrends Enterprise Reporting Server 2 Select the Advanced Features tab. Click Configure. 3 Select the URL Parameter Analysis tab to view a list of definitions. 4 Select a definition, and click View to view its settings. 5 Click in the check boxes to select the definitions to use. Selecting Content Group definitions Content Group settings are defined in the Advanced Features window. Content Group definitions can either be applied to all profiles or applied on a profile basis. If the option to choose Content Group definitions for each profile is enabled, the Advanced Features tab is accessible in the profile window. Content Groups allow you to group related pages together in one report. The Content Group definition is a set of patterns that identifies the pages that you want to report on as a group. See Creating content groups on page 129 for more on this feature. To specify content group definitions 1 Select a profile to work with, and click Edit. 2 Select the Advanced Features tab, and click Configure. 3 Select the Content Group tab to view a list of definitions. 4 Select a definition, and click View to view its settings. 5 Click in the check boxes to select the definitions to use. Selecting Path Analysis definitions Path Analysis settings are defined in the Advanced Features window. Path Analysis definitions can either be applied to all profiles or applied on a profile basis. If the option to choose Path Analysis definitions for each profile is enabled, the Advanced Features dialog is accessible in the profile window. 60

61 Chapter 4. Analyzing Web Site Activity A Path Analysis definition specifies the page and the number of paths that you want to track. See Defining paths to analyze on page 127 for a detailed explanation. To specify path analysis definitions 1 Select a profile to work with, and click Edit. 2 Select the Advanced Features tab. Click Configure. 3 Select the Path Analysis tab to view a list of definitions. 4 Select a definition, and click View to view its settings. 5 Click in the check boxes to select the definitions to use. Copying a Profile You can use existing profiles as the basis for a profile using the Copy Profile command. 1 Select a profile in the list, and select File>Profile>Copy Profile from the Profile menu. A copy of the profile opens. 2 Rename the profile, and make any modifications. 3 Once you have made changes, click OK to close the window. Editing a Profile Use the Edit Profile dialog to modify settings for a profile. Note: If the profile is being used for analysis when you make changes, it is updated when the analysis is complete. 1 Select a profile in the list, and click the Edit button. 2 Select the tab with the settings that you want to modify. 3 Once you have made you changes, click OK to close the window. 61

62 WebTrends Enterprise Reporting Server Deleting a Profile You can remove profiles from the Profile List if they are no longer needed. 1 Select a profile in the list, and click the Delete button. 2 Click OK to confirm that you want to remove the profile. Stopping Analysis You can interrupt processing of a profile using the Stop Analysis/ Reporting command. Doing so post-pones analysis until the next scheduled interval. 1 Select the profile whose processing you want to stop. 2 Select Profile>Stop Analysis. Restoring profiles to an earlier state Profiles that have been archived can be restored to one of the archived versions. For example, if the wtrs.audit file says that there is a date without log file data, you could restore the profile to an earlier version using an archive, place the missing logs in the proper location, and restart the analysis so that reports show activity for the newly added logs files. Monitor the wtrs.audit file for messages like this one to determine when an archive should be used: 62

63 Chapter 4. Analyzing Web Site Activity Sep :33:48: No log data for profile daily on Sunday, February 14, 1999 To restore an archive 1 Select the profile to restore. 2 Select Profile>Archives, and the Profile Archives dialog opens. 3 Select the archive that you want to use from the Available Archives list, and click Restore. Important! When you restore a profile using an archive, all databases and reports created after the archive date are deleted. Monitoring profile status The Reporting Server maintains a status file for each profile which you can use to monitor the processing of the logs. From the Profile Status window you can view the current state of the profile, the file name and location of the status log file. Use the scroll bar to peruse the profile history. To access the profile status 1 Select the profile you want to monitor from the Main Console. 63

64 WebTrends Enterprise Reporting Server 2 Select View>Status>Profile Status. The following window opens: Changing the profiles displayed in the main console If your profile library has grown to the point that finding the profile to work with has become a chore, you can limit the profiles that are displayed through the main console. Or, if you know the name or part of the name of the profile you are looking for, you can search for it here. 64

65 Chapter 4. Analyzing Web Site Activity Tip: You can increase the number of profiles displayed by modifying the MaxGridProfiles option in the wtm_wtx.ini file. To filter the profiles displayed 1 Select File>Profile>Search. 2 Limit the profiles displayed using the following criteria: User--Allows you to display only profiles for the user specified. Description--Allows you to view profiles whose description matches your criterion. Note: To view the maximum number of profiles allowed, enter * in both fields. 65

67 Chapter 5. Filtering the Analysis About filters Filters let you limit the scope of your analysis and reports by specifying the data you are interested in. The result of the analysis determines what is displayed in your reports. You can filter in data through Include filters and filter out data through Exclude filters. Include filters analyze only activity in the log file that matches the filters you have defined and ignore everything else. By default, all log file data is included as indicated by the Include Everything filter. To filter in specific information, begin by editing the Include Everything filter and making changes in one of the filter element tabs. Exclude filters ignore specific activity in the log file and exclude it from the analysis and reports. By default, nothing is excluded. You can combine several filter elements in an Exclude filter and use several Exclude filters in a single profile. Note: You can create both Include and Exclude filter definitions in one profile. For example, if you would like to determine how much of your domestic Web server activity is from organizations other than the military, create an include filter for all U.S. User Addresses and an exclude filter for all military User Addresses (.MIL). How filters are processed This section describes how filters are processed during the analysis. Single include filters--if a profile contains a single Include filter, only activity that matches the filter is reported on. Multiple include filters--if a profile contains several Include filters, only the activity that matches every filter is reported on. Single exclude filters--if a profile contains a single exclude filter, only activity that does not match this filter is reported on. Multiple exclude filters--if a profile contains several exclude filters, only activity that does not match every filter is reported on. 67

68 WebTrends Enterprise Reporting Server Both include and exclude filters--if a profile contains both include and exclude filters, only activity that matches all include filters, but does not match any exclude filters is reported on. Adding a filter You can add filters to any profile. To add a filter to an existing profile: 1 Select the profile that you want to filter, and click Edit. 2 Select the Filters tab. 3 Select the Include Everything filter, and click Delete. 4 Click Add. The Filter Type dialog opens. Choose whether to create an Include or Exclude filter. 5 Click Next, and the Filter Title dialog opens. Enter a name for the filter in the Filter Title field. Select the Include/Exclude Only Activity Based Upon option. Indicate the type of activity that you 68

69 Chapter 5. Filtering the Analysis want to filter by checking the corresponding boxes. 6 Click Next, and a dialog for the filter that you selected opens, allowing you to define the filter criteria. Tip: Click the Examples button in the filter dialogs for help on formatting your entries. 7 Click Finish to complete your filter. Filter types This section describes each filter in detail. Return code filter Log files contain the results received from browsers, which are called return codes. Use the Return Code filter to specify the types of results you want to include or exclude. For example, if you are creating an Include filter and you want to include hits that were logged as successes, select Success Only from the list. Or to find out about all hits that were logged as a 404, you would create an Include Filter and enter

70 WebTrends Enterprise Reporting Server Select one of the predefined return codes from the list, or enter your own. The default, indicated by an asterisk (*), is All Return Codes. User address or country filter Use the User Address filter to include or exclude domains, IP addresses, or countries from the results of this profile. For example, if you create an Exclude filter and you specify a domain, the report does not display any activity from this domain. Type the user addresses that you want to filter, or click the down arrow to select from the list of predefined user addresses. The default, All User Addresses, is indicated by an asterisk (*) in the field. Note: Country information is not always accurately reported because the domain name may not include the country suffix. Table 5-1 User Address Filter Examples Example Result Specifies all numeric IP addresses from through Specifies all numeric IP addresses from through /26 CIDR notation. Specifies all addresses of this classless subnet: /26 Specifies all subnet addresses from through *.webtrends.com Specifies only those addresses that have a sub-domain that appears to the left of this domain (such as., www. WebTrends.com, ftp. WebTrends.com, etc.) This would not include addresses without a sub-domain. 70

71 Chapter 5. Filtering the Analysis Example *webtrends.com *.edu *.com *.net *.de Result Any address that includes the specified domain, with or without a sub-domain (such as., www. WebTrends.com, ftp. WebTrends.com, or WebTrends.com). Tip: You can specify IP addresses as well as domain names in filter fields if you are uncertain whether DNS lookups are being performed. All addresses that have the domain types: edu, com, or net. Specifies all addresses from Germany. Specifies only those addresses that have www as a sub-domain. Multi-Homed Domain filter Note: This filter only applies to multi-homed log files. Use the Multi-home domain filter if your log file contains activity from more than one domain. Specify the domains you want to include or exclude. For example, if your log file contains activity from domains and and you want to report only on you would create an Include file and enter Note: To filter multiple domains, separate your entries with a space. Directory or URL filter Use the Directory filter to include or exclude the activity of a specific directory. The default for an Include Directory filter is to include all directories starting at the root directory, indicated by a slash (/). There is no default for the Exclude Directory filter. If you want to include or exclude all subdirectories starting with the directory you specify and proceeding down, click the Include/Exclude 71

72 WebTrends Enterprise Reporting Server Subdirectories check box. Check the Case Sensitive box if you want to look for exact case matches. Note: Because most servers require case-sensitive (upper or lower case) matches, be careful to specify the exact case you want to look for, and check the Case Sensitive box. The default for both include and exclude files filters is to activate the subdirectories box (indicated by a check in the Include/Exclude Subdirectories box). Therefore, if you created an Exclude filter for the /Images directory, the subdirectories are automatically excluded. Or if you create an Include filter for a directory, the subdirectories are automatically included in the filter. Use wildcards to specify multiple directories, or separate directories with a space. Put quotation marks around directories containing spaces or commas. For example, "/logo graphic. Table 5-2 Directory Filter Examples Example Result /images "/image files" "/image files" / intranet /graphics /*graphics Specifies the directory /images is filtered and all subdirectories therein, if Include Subdirectories is checked. Specifies the long directory, /image files. Specifies the following directories: /image files, /intranet, and /graphics. Specifies any first-level directory whose name ends in graphics, such as /bitmap graphics, but not /intranet/bitmap graphics. /*/graphics Specifies all second-level directories named / graphics, such as /home/graphics and /intranet/ graphics, but not /home/sales/graphics. Directories such as /home/graphics/logos, are specified by this example only if Include Subdirectories is checked. 72

73 Chapter 5. Filtering the Analysis Example /graphics /*/ graphics /*/*/ graphics /*graphics*/ Result Specifies all first, second and third level directories named graphics, such as /graphics, /home/graphics, and /home/sales/graphics. Subdirectories of these, such as /home/ graphics/logos, and /home/sales/graphics/ logos/specials would be included only if Include Subdirectories is checked. Specifies all first level directories with names containing graphics, such as /graphics, / graphics files, and /bitmap graphics. Note: Remember to put quotation marks around directories containing spaces or commas. File filter Use the File filter to include or exclude specific files from the report. Enter the file name or extension in this field, or click the down arrow to select a file type from the list. The default for an Include File filter is to include all files, indicated by *.*. The is no default for an Exclude File filter. Use wildcards to specify file names or extensions, such as all HTML files (*.HTM) or all GIF files (*.GIF). Specify several file types at once by inserting a space between each file type. A check in the Case Sensitive box means that you want to look for exact case matches (upper or lower case). Note: Because most servers are case-sensitive, be sure to enter your filter exactly as what you want to look for in the log file, and check the Case Sensitive box. Table 5-3 File Filter Examples Example help.htm *.gif *.bmp Result Filters the file help.htm. Filters bitmap (.bmp) and gif (.gif) files. 73

74 WebTrends Enterprise Reporting Server Example help*.html help*.* marketing.htm marketing help.htm marketing leads.htm Result Filters all html files whose name begin with help. Filters all files whose name begin with help, regardless of type. Filters the files marketing.htm, marketing help.htm, and marketing leads.htm. Referrer filter Use the Referrer filter to include or exclude entire user sessions based on the referring URL. A referring URL is the link that the user came from. This filter helps you identify the quantity and quality of users coming to your site from other sites, or from a specific Internet advertisement. Whereas other filters deal with hits, the referrer filter deals with user sessions to determine where your users are coming from. (A typical user session is 30 minutes.) See General options on page 103 for details. Note: Be sure to include either the protocol of the referrer or a wild card at the beginning of the entry. For example * where the first asterisk (*) stands for the protocol, or where indicates the protocol. Use a space to separate multiple referrers. Use an asterisk (*) either to the right or left of a partial referring URL as a wildcard. If you do not use a wildcard, the Reporting Server looks for exact matches (case insensitive). Append a wildcard character (*) if you want to specify all activity from a referrer. For example,

75 Chapter 5. Filtering the Analysis Table 5-4 Filtering Search Engine Referrers Example *.referrer.com* *referrer* page.htm page.htm* *.referrer.com/ page.htm* Result Filters anything coming from Hits from ftp:// are not filtered. Filters and so on. Filter ftp.referrer.com or It would not filter or Filters anything with referrer in the name, for example, referrer.com, referrer, etc. Filters ONLY references from page.htm at the site. Filters page.htm, page.html, page.html2...from the root of the domain. Filters page.htm or page.html from any referrer.com domain (ftp.referrer.com, search.refererrer.com). Note: This filter does not apply to log file views, only for log file reports. Table 5-5 Filtering References from a Specific Page Example ad.html *ad.* *reports.html Result Filters only references from the page ad.html. Filters hits referred from ad.html, yippiedodad.htm, rad.gif, mad.jpg. Specifies only the referring URLs originating from the reports.html pages. Entry page filter Use the Entry Page filter to include or exclude entire user sessions based upon the first page that a user viewed. An entry page is the 75

76 WebTrends Enterprise Reporting Server first item requested in a session. The item could be an image, a document or a file. For example, if you placed an ad on Yahoo, and the URL for that banner is /ads/yahoo_ad.htm, you could create an Include Entry Page filter specifying this URL to determine the number of sessions that came to your site from your ad. Advertising filter With the advertising filter you can either include or exclude hits that result from Ad Views or Ad Clicks that have been defined. This filter gives you the ability to produce reports based on a specific web site advertisement s activity that you can distribute to a client. See Tracking Internet Advertising on page 79 for information on defining Ad Views and Clicks. Browser filter Use the Browser filter to either include or exclude a browser, spider or robot from the analysis and reporting. You can filter any browser if you know how it appears in the Agent field of the log file. Use a space to separate multiple browsers. Put quotation marks around browser names that have spaces. You cannot use wildcards for browser filters. Table 5-6 Browser Filter Examples Example Mozilla/4. Mozilla/3.1 MSIE Microsoft Internet Explorer/ Result Filters any activity that matches Netscape Navigator 4. or Netscape Navigator 3.1 is included or excluded from the report or view. Filters any activity that matches any version of Internet Explorer is included or excluded from the report or view. Note: You cannot use wildcards (*) in a browser filter. The Reporting Server assumes that there are wildcards at either end of each browser entry when comparing it to the agent field in the log file. 76

77 Chapter 5. Filtering the Analysis Note: Filtering for Netscape Navigator may not return accurate results because many browsers identify themselves as Netscape Navigator. Authenticated username filter If you have an intranet site or a web site that requires visitors to log on with a username and password, then you can use the Authenticated Username filter to include or exclude authenticated users from this web log profile. Enter the name that you want to filter for. Put quotation marks around names that contain spaces. Refer to the examples that follow for formatting tips. Check the Case Sensitive box if you want to look for exact case matches. Note: Because most servers are case sensitive, be sure to enter your filter exactly as the data appears in the log file, and check this box. Table 5-7 Authenticated Username Filter Examples Example Jane Smith Bob Smith Mike Macintosh John Hill Result Filters any activity that matches Jane Smith from the report or view. Note: If the username you are filtering contains a space, use quotation marks around the username as shown here. Filters any activity that matches these usernames is included or excluded from the report or view. Day filter Use the Day filter to filter days of the week from the report. For example, if you create an Include Days filter, a check indicates the log file activity must match the days specified in order to be displayed in the report. 77

78 WebTrends Enterprise Reporting Server Hour filter Use the Hour filter to filter hours of the day from your analysis or report. The default for the Hour Include filter is All. The default for the Hour Exclude filter is None. Any activity that is within the hour range that you specify through the Between...And range is filtered from the report. Note: Enter the hours in military format (twenty-four hour clock). Table 5-8 Hour Filter Examples Example Between 12 and 17 Between 20 and 6 Result Filters any activity from 12 p.m. to 5 p.m. from the report or view. Filters any activity from 8 p.m. to 6 a.m. from the report or view. 78

79 Chapter 6. Tracking Internet Advertising About Ad Views and Clicks Using the Ad Views and Clicks feature, you can determine the number of visitors to your web site who view or click on a particular ads. If you are selling advertising space on your web site, you can easily collect exact traffic statistics to help determine pricing schedules. Additionally, the Reporting Server includes an Advertising filter you can use to profile a specific advertisement s traffic patterns (such as busiest time of the day or day of the week), as well as demographic information (such as top viewing or clicking organizations or countries). With this feature you can produce advertising reports for each of your clients. See Running from the command line on page 137 for details on defining ad views and clicks from the command line. Tip: For the most effective reporting results, use the Advertising Summary memorized report settings which includes all of the tables and graphs relating to advertisement tracking. Tip: You can track exit URLs using Ad Views and clicks by creating an Ad View for each advertisement that you want to track. Note: To track the effectiveness of web site advertisements that you have on someone else s site, see Referrer filter on page 74. Scenario: tracking internet advertising Your site is booming and advertising is selling like mad. How do you keep your billing from becoming a nightmare? Create reports that provide each of your client s ads activity, including views, clicks, click through rate and more. The following instructions walk you through the process of: defining an advertisement to track adding a profile with a filter to track that ad 79

80 WebTrends Enterprise Reporting Server Defining an advertisement to track Your first step is to define the advertisements that you want to track. Following are two possible advertisement configurations. 1 Click Ad Clicks, and the Ad Views and Clicks Configuration dialog opens. 2 Click Add, and the Add New Ad View dialog opens. 80

81 Chapter 6. Tracking Internet Advertising 3 In the Description field, enter a descriptive name of the web site ad. This is the text that identifies the ad in reports. For our example, enter IBM Laptop Advertisement. 4 In the Ad View File Name field, enter the file name or text string identifying the advertisement view you want to track. You must enter the exact text (case sensitive) as it appears in the web server log file. Specify multiple components using spaces (each component acting as a logical Boolean "AND" to the other components). Refer to the following examples to determine which you should enter. Example 1: Tracking Statically Linked Ads For this example, we'll track the IBM advertisement which is statically linked, meaning that it's not retrieved through CGI scripts, but rather called straight through an <IMG SRC> HTML tag. When a browser hits your site and sees the link to the image, it asks the server for that image and generates a log entry on the server that looks something like this:... "GET /images/ibm_ad.gif" Since the filename "ibm_ad.gif" is unique to just IBM's advertisement, then the file name itself is sufficient to put in the "Ad View File Name" field to accurately track views of this ad. Example 2: Tracking Ads Sent Through Scripts In this example, you have an automated CGI script that delivers ads to a browser. The advertisement image, ibm_ad.gif, is sent to the client through a CGI script with an advertisement ID number rather then a filename. The only way to retrieve this particular ad is to make an image link off your view page to a CGI script, which has a URL looking something like this: When a web browser sees this URL, it asks the server for that image and generates a log entry that looks like:... "GET /cgi-bin/showad.cgi?ad=123456" Since the CGI script returns the image, the file name is irrelevant. For our ad view we want to use text specific to this advertisement only, in this case, the ad ID string for the CGI script. For this example, we'll put "showad.cgi ad=123456" in the Ad View File Name field, since the only time this combination of text shows up 81

82 WebTrends Enterprise Reporting Server in the log file is when retrieving the IBM advertisement image. 5 In the Ad Click ID String field, enter the text identifying the advertisement click you want to track. This must be the exact text (not case-sensitive) from the web server log file. You can specify multiple components separated by spaces which together define a click. The Reporting Server scans only the log file Action field (usually Get or Post statements) for the text that you specify, so the click must create an entry in your log file. For example, if a visitor clicks on an ad which takes him or her out of your site directly via a URL, this is not logged in your log file. In order to be able to track ad clicks, you must implement some type of server-side scripting (for example, CGI, Perl, or ASP) to perform a redirect to the destination URL. A very common Perl script is redir.pl. To summarize, if you have a.gif file on your site that links to IBM s site through redir.pl, the information in the Ad Views and Clicks dialog would break down like this: In the Description field, you would enter IBM Laptop Advertisement In the Ad View File Name field, you would enter ibm_ad.gif And in the Ad Click ID String field, you would enter url= because when a visitor to your site clicks on the ad, the following information is recorded in your log file: GET /cgi-bin/redir.pl?url= 6 When you have finished, click OK to save the new advertisement definition and return to the Ad Views and Clicks Configuration window. 7 Repeat steps 2-6 to add Ad definitions for each of your clients, and click Close to exit the Ad Views and Clicks Configuration dialog when you have finished. Note: To edit an existing advertisement definition, highlight it in the main Ad Views and Clicks Configuration window and click Edit. 82

83 Chapter 6. Tracking Internet Advertising Note: To delete an existing advertisement definition, highlight it in the Ad Views and Clicks Configuration window and click Delete. Adding a profile for an ad Once you have completed your advertisement definitions, add profiles for each of your client s advertisement activity. 1 To add a new profile, click New. 2 In the Description field, enter a description to identify this profile as one that tracks the advertisement activity for your client (for example, IBM Advertisements). This description will appear in the profile list, as well as in the title of reports and views that are based on this profile. 3 In the Log File URL Path field, enter the location of your web server log. In this case, a drive to your web server is mounted, so choose file from the drop-down list, and the enter the path to your log file. You can click Browse to search for the exact location of the file. 4 Click Next to skip the DNS Lookup dialog. This information is not needed for this profile. 5 The Report Template dialog opens. The template defines the report sections that are included in the report. 6 Click Next, and the Home Page dialog. This information is not necessary for this profile, so click Next to continue. 7 The Report Scheduler dialog opens. Enter when you want reporting to begin, and how often the report data should be updated. 8 Click Next, and the Filters dialog opens. Select the default Include Everything filter, and click Delete to remove it. 9 Click Add to create a new filter. The Type dialog appears. Select the Include, and click Next. 83

84 WebTrends Enterprise Reporting Server 10 The Filter Title dialog opens. Enter a title for the filter in the Title field. Select Include Only Activity Based Upon, and check the Advertising box. 11 Click Next and the Advertising dialog opens. Select the IBM ad from the list. Click Next to display the Summary dialog where you can review your filter criteria. 12 Click Finish. 13 Repeat steps 1-12 to add a separate profile for each or your clients. The URL for the report is displayed in the Main Console. 84

85 Chapter 7. Using Intranet Management About Intranet Management The Reporting Server includes a company database which translates domain names into organization names and geographic information and makes this information available in WebTrends reports. Within large organizations Intranets, certain sub-nets or ranges of IP addresses usually represent a department, area or location of an organization, but they are not represented in the company database. This is where the Intranet Management feature steps in. Note: See Running from the command line on page 137 for details on defining ad views and clicks from the command line. The Intranet Management feature lets you provide a more detailed break-down of your organization s domain name. You can define multiple Intranet Domains which specify an area of your organization by country, state, city, department, or even individual workstations. Once you have added this information with the Intranet Management tool, it is automatically included in your report data. As with any web site, having accurate and up-to-date statistics and access to information is essential. The Reporting Server helps you manage your site by reporting the what, where and when of user and department activities: What pages are users accessing and how much time are they spending on them? What departments are accessing your Intranet and when? Where are your users and departments located? What operating systems are used most widely within the organization? What browsers are used? What are the most active and inactive days and times? What forms are users submitting? What scripts are run and when? 85

86 WebTrends Enterprise Reporting Server Scenario: Configuring Reporting Server for the Intranet In this scenario, you are the Webmaster for an international corporation, XYZ Corp. The good news is that your newly implemented company Intranet has become very popular; the bad news is that you now need to provide statistics about which departments are using the Intranet and how they are using it. No problem! Once you have created Intranet domains for each of your departments (you can also define individual machines or entire offices) with the Intranet Management tool, this information is automatically included in your reports. Specifically, this information appears in the Most Active Organizations graph and table, and is used for the geographic information in the graphs and tables relating to States, Cities and Countries. Adding an Intranet Domain Follow these steps to setup the departments that you want to track: 1 Click Intranet, and the Intranet Configuration dialog opens. 86

87 Chapter 7. Using Intranet Management 2 Click Add, and the Add New Intranet Configuration dialog opens. 3 In the Intranet Domain field, enter the domain name of the department or division of your organization to be listed in your report (for example, marketing.xyz.com). 4 In the Description field, enter the descriptive name of the organization or department as you want it to appear in reports (for example, Marketing Dept.). 5 In the City field, enter the location of the department or division. Select a State from the drop-down list. Select a Country from the drop-down list. 6 This geographic information is used to produce the geographic tables and graphs in reports. 7 In the IP Address/Pattern field, enter the IP address, or domain name or range of IP addresses, as they appear in your Web server log file (for example, marketing.xyz.com). Note: The Reporting Server performs pattern matching for Intranet Management entries after it has performed DNS lookups, so you need to 87

88 WebTrends Enterprise Reporting Server use an IP address in this field only if neither your Web server nor the Reporting Server is converting IP addresses to domain names. 8 When you have finished, click OK to save the new Intranet domain information and return to the Intranet Configuration window. The new Intranet domain and corresponding description appear in the Intranet Configuration window. 9 Repeat the previous steps to define an Intranet domain for each department. Note: If you want to edit an existing Intranet domain, select it in the Intranet domain list in the Intranet Configuration window, and click Edit. Note: To delete an existing Intranet domain, highlight it in the Intranet Configuration window, and click Delete. 88

89 Chapter 8. Working with Reports About reports Once a profile for the web server log file has been created, the Reporting Server analyzes your log file data and creates reports based on the profile settings. If the profile is enabled, reports are generated and posted automatically. Users connect remotely through their browsers to view reports. Start Report Profile Log File Log File Analysis WebTrends Reporting Server Report End Report Note: Reports for new profiles are available immediately if the Start Initial Analysis Immediately... option in the Report Scheduler dialog was activated. Otherwise, reports are available at regular intervals beginning at the scheduled start time. See Report scheduler on page 117 for details. 89

90 WebTrends Enterprise Reporting Server As an Administrator, you have access to all reports. Nonadministrators have access to reports if they have been given rights in the Profile Access dialog in the Profile window. Users who log in as "anonymous" view only the reports that have been marked for public viewing. See Creating a user account on page 133 for details. Report viewer workspace Use the Report Viewer to work with reports for the selected profile. The Report Viewer makes all the reports generated available to you in one place. The most current report is displayed. Use the Calendar to load a saved report. Report Calendar Scroll to view the report. Report calendar All reports generated for the loaded profile are accessible using the calendar. Click the links on the calendar to select the report to view. The report calendar includes links for each day or interval that a report was generated. 90

91 Chapter 8. Working with Reports Use the to view the Profile Home page where you can view a reporting history. Loads the Profile Home page. Links indicate a report is available for this interval. Status frame Table of Contents Click to change the graph type. Table of contents Just below the calendar is the table of contents which lists the chapters of the report. Click on an item to view it, and use arrows to expand or collapse the list. 91

92 WebTrends Enterprise Reporting Server Status The Status frame displays information about the report, including the report type, and the date- and time-ranges report on. Use the Microsoft Word button to convert the HTML report to Word format. Use the navigational arrows in the Status frame to scroll through the report. Note: You can only convert reports to Microsoft Word on client machines that have Microsoft Office. Report The Report frame displays the report chapter selected in the Table of Contents for the date or period selected in the Calendar. Use the graph buttons to change the graph type. 92

93 Chapter 8. Working with Reports Viewing reports To view report data for a profile 1 Select the profile you want to report on from the Main Console. 2 Click the Report button, and the Report Viewer opens displaying the profile home page. 3 Use the Report Calendar to select the dates or date range to view. If a report is available for a day or interval, a link appears in the calendar. The selected interval is highlighted in yellow. 4 Use the Table of Contents to select the report chapter to view. Or use the up and down arrows in the Status frame to scroll through the report. Tip: You can change the graph style by clicking a graph button in the Report frame. Using the job queue You can view the profiles currently being processed and those waiting to be processed in the Job Queue. Use the Job Queue to remove a 93

94 WebTrends Enterprise Reporting Server profile from the queue or to stop processing. Removing an item from the queue only stops processing temporarily; it returns at the next scheduled interval. To access the Job Queue 1 Select Job Queue from the View menu. The Current Analysis Queue lists the profiles that are currently being processed. Because the Reporting Server makes use of multi-threaded processing, several profiles may be analyzed at once. To interrupt processing, select a profile and click Stop. When a profile is stopped, it re-enters the queue at the next scheduled time. The Waiting Queue lists the profiles next in line for processing. The profile that will be processed next appears first in the list. Select a profile and click Remove to remove it from the queue. It will return at the next scheduled interval. 2 Click Close. Viewing profile history Use the Profile Home Page to view a history of reports generated for the profile selected. Here you can view the last time the profile was analyzed and the total number of reports generated for each report type. 94

95 Chapter 8. Working with Reports 1 Select the profile you want to report on from the Main Console. 2 Click the Report button, and the Report Viewer opens displaying the Profile Home Page. 3 Click a link in the calendar to view the report. Converting reports to Microsoft Word To create reports in a format that can be manipulated for reviews or presentations, you can convert the HTML report to Microsoft Word through the Report Viewer. You can convert your reports to Microsoft Word if the workstation where you are running the Remote Interface meets the following criteria: The HTML and Microsoft Word format must be activated in the Report Template for the profile. See Customizing reports on page 96 for details on report templates. Microsoft Windows 95/98, or Microsoft NT must be running on the workstation using the Remote Interface. Microsoft Office must be installed on the workstation. Netscape Navigator or Internet Explorer must be installed on the workstation. 95

96 WebTrends Enterprise Reporting Server The first time you select the MS Word option, the WebTrends MS Word installation package is automatically downloaded. The installation package contains the files needed to convert HTML reports to Word. Once the converter files are on your system, the HTML report is downloaded to your system and converted to Word format. Note: You may be asked to provide your username and password during the installation of the MS Word installation package. 1 Select the profile that you want to report on. 2 Click the Report button. 3 Click the Microsoft Word icon that appears in the status bar of the Report Viewer. The HTML report is converted to Microsoft Word format. Customizing reports You can tailor your reports using Report Templates. A report template defines the colors, language, and content of the report. The Reporting Server provides a set of report templates which are customizable. You can also create your own templates. As an Administrator, you can apply the template on a profile basis, or define this option globally and hide it from the user. See Customizing reports on page 96 for details. The following table describes the report settings you can define using Templates. Table 8-1 Customizing reports To modify Color scheme Use this Template tab Modify the colors used in the Style/Language tab. 96

97 Chapter 8. Working with Reports To modify Language Document format Tables and graphs Number of items in tables and graphs Graph type Saving the report as a single HTML page Remove blank chapters from reports. Use this Template tab Modify the language used for reports in the Style/Language tab. Select HTML only, or HTML and Microsoft Word in the Format tab. Choose the tables and graphs included in reports using this style in the Content tab. Use the Elements option in the Content tab to define the amount of information provided in each table. Select the style for each graph in the Content tab. Select the Single Content HTML page option in the Format tab to save the report as one file. Select the Remove Chapters that contain no data option in the Style/Language tab. Note: See Working with report templates on page 196 for details on defining Templates using text files. Adding report templates This section describes the process for creating a new template for reports. If you are new to templates, refer to the previous section for an overview. 97

98 WebTrends Enterprise Reporting Server 1 Click the Template button, and the Report Template dialog opens. All pre-defined styles appear in the list box. 2 Click Add, and the Add Report Template dialog opens. 3 Enter a name to identify the template in the Report Template field. The name appears in the Report Template dialogs in the Options window, Profile window, and User Access window. 98

99 Chapter 8. Working with Reports 4 In the Style/Language tab, select a style to use from the dropdown list. To view the colors and fonts used in the style, click Preview Style. 5 Select the Language to use from the drop-down list. 6 If you don t want blank chapters included in the report, check Remove Chapters That Contain No Data box. Note: You may have to scroll to view this option. 7 Select the Format tab. Choose whether you want both HTML and Microsoft Word reports or only HTML reports generated. Check the Single Content HTML page box if you want to save the report as one HTML file. Otherwise, each section is saved as a separate file. Note: The HTML only format is the quickest and uses less storage space. 8 Select the Content tab. Check the chapters to include in the report. 99

100 WebTrends Enterprise Reporting Server To specify the size of the table or graph, select the chapter in the list and enter the number in the Elements field. The greater the number, the more data included in the table or graph. To change the type of graph, select the graph in the list and click on the type you want to use. 9 Click OK to save your settings. Changing the report color Report templates determine the color of your reports. The Reporting Server offers several color schemes to chose from. To change the color: 1 Click the Template button, and the Report Template window opens. 2 Click Add, and enter a name for the template in the Report Template field. 3 In the Style/Language tab, select the style to use. Click Preview Style to look at the style. Click OK to save the template. 4 Apply the template to profiles in the Report Template tab. 100

101 Chapter 8. Working with Reports Changing the report language The template determines the report language used. To run reports using a different language, you should create a new template using the language you chose. Because any changes to templates only apply to reports created after the change, you should either copy an existing profile or create a new profile that uses the new template. This method allows you to generate a consistent set of reports. To change the language: 1 Click the Template button, and the Report Template window opens. 2 Click Add, and enter a name for the template in the Report Template field. 3 In the Style/Language tab, select the language to use. 4 Click OK to close the window. Editing a report template You can change settings for an existing template. Modifying template settings only affects reports generated after the change. To modify an existing Template 1 Click the Template button, and the Report Template window opens. 2 Select the template that you want to modify from the list, and click Edit. 3 Make your changes, and click OK. Deleting a report template You can delete a template if it is no longer used. 101

102 WebTrends Enterprise Reporting Server To remove a Report Template 1 Click the Template button, and the Report Template window opens. 2 Select the template that you want to remove, and click Delete. 3 Click OK to close the dialog. 102

103 Chapter 9. Configuring Reporting Server Options About Reporting Server options As an Administrator, you have access to all program settings. Using the Options window, you can modify settings that impact performance and processing. You can also define many settings for new profiles through the Options window. If you allow non-administrators to change these settings, your settings appear as default settings in the profile wizard to guide them. Otherwise, the profile settings defined here are used for every new profile created by a non-administrator. Note: User Access settings override the settings defined here. See Creating a user account on page 133 for details. General options The General tab allows you to define the number of entries stored in the DNS cache, the length of a user session, and whether or not to include HTML titles in reports. To work with these settings 1 Click Options, and the Reporting Server Options window opens. 103

104 WebTrends Enterprise Reporting Server 2 Select the General tab. Here you can specify the following options: DNS Cache--Specifies the number of DNS Lookup entries to maintain in the DNS cache. Once this value is reached, the oldest lookups are overwritten by new entries. This value is expressed in thousands. The default value of 50 equals 50,000 entries. User Session Termination Timeframe--Specifies the length of a user session in seconds. HTML Titles--To retrieve web page titles in your reports, make sure this box is checked. Enter the number of titles to store in the cache, and specify how long the entries should be saved. Note: Retrieving page titles can slow down report creation. Choose this option only when it is important to identify HTML pages by their titles. Archives Archiving allows you to backup profile databases at regular intervals. Use this dialog to specify how often archives are performed and the 104

105 Chapter 9. Configuring Reporting Server Options number of archives that are maintained for each profile. You can also set a default for the Activate Archiving setting that appears in the profile window. See Restoring profiles to an earlier state on page 62 for steps on using archives. To define settings for archiving 1 Click Options, and the Reporting Server Options window opens. 2 Select the Archives tab. 3 Specify how often archives are made for each profile in the Frequency, In Days field. 4 Specify the maximum number of archives to maintain for each profile in the Max Number of Archives Per Profile field. 5 Click in the By Default, Enable Archiving in Profiles check box to enable archiving by default for new profiles. Web Site Locale The Locale tab allows you to identify the country where your web server resides. This information is used in reports to show the activity that is considered domestic. 105

106 WebTrends Enterprise Reporting Server 1 Click Options, and the Reporting Server Options window opens. 2 Select the Locale tab. 3 Select the country where your WebTrends reports are created from a list of the possible countries (what is considered domestic ). 4 Click OK to save your selections, or click Cancel to exit the Options window without saving your changes. Profile directory The Profiles tab allows you to define the directory for storing profiles. Note: If you change the profile directory, only new profiles are stored here. All previously created profiles remain in the original directory unless you copy them to the new location. 106

107 Chapter 9. Configuring Reporting Server Options 1 Click Options, and the Reporting Server Options window opens. 2 Select the Profiles tab. 3 In the Profile Directory field, specify the directory for storing profiles. To indicate that the directory is relative to the WebTrends program directory, enter before the name of the directory. 4 Click OK to save your selections, or click Cancel to exit the Options window without saving your changes. Cookies The Cookies tab allows you to include cookie data in the log file analysis. A cookie is a file sent with the page requested from the server to the visitor. Cookies are stored on the visitor s system. The stored cookie is then included in subsequent requests to your site by this visitor and is recorded in the log file, enabling you to uniquely 107

108 WebTrends Enterprise Reporting Server identify the visitor. Activating cookies makes user session data more accurate because each visitor is unambiguously distinguished. Setting default cookie settings for profiles To use cookies by default for profiles: 1 Click Options, and the WebTrends Enterprise Reporting Server Options window opens. 2 Select the Cookies tab. 3 Click in the Use Cookies, By Default check box to look for cookie user session IDs in log files. When cookies are found, Reporting Server uses these session IDs rather than the IP address to more accurately track a user s activity. If you don t use this option, and you have several users from the same IP, you won t be able to distinguish one user session from another. 4 Click in the Validate Cookie Format check box to verify that the cookie matches a WebTrends Plug-in cookie or one of your own. If the cookie matches, it is included as user session data. Note: If you are using a cookie other than the WebTrends Plug-in cookie make sure that the cookie ID is the same throughout a user s 108

109 Chapter 9. Configuring Reporting Server Options visit, and does not change from page to page. If it changes within the user session, the results are incorrect. 5 Specify the cookie to use: Use this cookie--allows you to specify the cookie to use. Enter the cookie text in the corresponding field. Use WebTrends plug-in cookie--if you installed a WebTrends logging plug-in on your web server, you can use this format. File types Use the File Types dialog to define the types of files to include in the graphs and tables that relate to downloaded files or document files. For example, the Page Views item represents the sum of all hits to all document file types. If you would like this number to reflect only hits to.html and.htm pages, remove all other document file type extensions from the list. 1 Click Options, and the Reporting Server Options window opens. 2 Select the File Types tab in the Options dialog box. 3 Select the file type that you would like to modify: 109

110 WebTrends Enterprise Reporting Server Download File Extensions and Types--Add or remove the file types that are included in the WebTrends Top Downloaded Files table and graph. Document File Extensions and Types--Add or remove the file types that are included in WebTrends report tables and graphs that pertain to documents (for example, Most and Least Requested Pages, Top Entry and Exit Pages). Document File Types define Page Views by appropriate hits. 4 Click Edit. The Edit Download/Document File Extensions and Types dialog appears. The extension list indicates the file type extension, and the condition displays when the request for the file type is included. 5 Choose one of the following options: Edit--Select a file type and click Edit to display the Edit File Type dialog where you can modify when the file type is included. See Adding or Editing File Types on page 110 for details. Add--To add an extension, click Add. See Adding or Editing File Types on page 110 immediately following this section for details. Remove--Select a file type and click Remove to delete a file type in the list. 6 Click OK to save your selections, or click Cancel to exit the Options window without saving your changes. Adding or Editing File Types Use the Edit File Type dialog to modify file type settings. You can add a file type to the default list or define when a file type is included. You 110

111 Chapter 9. Configuring Reporting Server Options can access this dialog from the Download/Document File Extensions and Types dialog. 1 Click Options, and select the File Types tab. 2 Select the set of file extensions and types to work with (Download or Document), and click Edit. 3 Select a file type to work with from the drop-down list. Specify when the file request is included by choosing one of the following: Always--Includes every file request for the selected file type. Only if they are not from a script or dynamic web page-- Includes only file requests that are not from scripts or dynamic web pages. If the URL includes this file type without a (?), the request is included. Only if they are from a script or dynamic web page-- Include only file requests from scripts or dynamic web pages. If the URL specifies this file type with a (?), the request is included. Domain groups Use the Domains tab to modify how domains are reported in graphs and tables (for example, the Organization Breakdown graph and 111

112 WebTrends Enterprise Reporting Server table). Some reports break down activity by U.S., International, or Unknown. If the domain is not found in the company database, but its extension matches something in the U.S. domains grouping, then it is added the U.S. total, rather than the International or Unknown total. Add or remove domain name suffixes from the list for each domain name grouping (United States Domains, Government Domains, Military Domains, etc.). 1 Click Options, and the Reporting Server Options window opens. 2 Select the Domains tab in the Options dialog box. 3 Select the domain grouping that you would like to modify, and click Edit. The Edit Domains dialog opens displaying the domain suffixes included in the selected grouping. To remove an existing suffix, highlight the suffix in the list and click Remove. To add a suffix, type the suffix in the text entry field and click Add. 4 Click OK to save your selections, or click Cancel to exit the Options window without saving your changes. Reports Serving The Reports Serving tab allows you to specify the web server to use for publishing reports. The Reporting Server provides a built-in web server for publishing reports and providing the Remote Interface. 112

113 Chapter 9. Configuring Reporting Server Options However, if you have another web server that you want to use for the reporting, you can specify it here. The Remote Interface is still provided by the Reporting Server s built in web server. 1 Click Options, and the Reporting Server Options window opens. 2 Select the Report Serving tab. Select one of the following: Default--Select this option to use the built-in web server for publishing reports. Specify a different web server for serving reports--select this option to specify your own web server for publishing reports. Specify the location where reports should be stored in the Reports Directory field. Specify the URL that accesses the reports in the Report URL Path field. Note: If you change the reports directory, only new reports are stored in the new location. Old reports remain in the original location. 3 Select the Allow Non-administrators to Configure and Override...option to allow non-administrators to modify the defaults. 113

114 WebTrends Enterprise Reporting Server 4 Click OK to save your selections, or click Cancel to exit the Options window without saving your changes. Database directory The Database Directory tab allows you to define the default directory for all profile data. Note: If you change this location, Reporting Server reanalyzes the log file from the beginning. The original databases remain in the old directory and are not copied to the new location. 1 Click Options, and the Reporting Server Options window opens. 2 Select the Database Directory tab. 3 Enter the default directory to use for profile data. To maintain a separate directory for each profile, use the %profile% macro in your entry. 4 Select the Allow Non-administrators... option to enable the Database Directory option in the profile window for all users. 114

115 Chapter 9. Configuring Reporting Server Options 5 Select the Allow Administrators... option to enable the Database Directory option in the profile window for administrators. 6 Click OK to save your selections. Report templates Use the Report Template dialog to define the default report template for new profiles. Report Templates define the colors, fonts, and content of the report. You can create your own templates in the Report Templates window. See Customizing reports on page 96 for details. 1 Click Options, and the Reporting Server Options window opens. 2 Select the Report Template tab. 3 Select the template to use as the default from the drop-down list. 4 Select the Allow Non-administrators... option to allow Nonadministrators to define Report Template options in the profile window. 5 Click OK to save your selections. 115

116 WebTrends Enterprise Reporting Server Reports Use the Reports tab to define the default reports for new profiles. Each time a profile is analyzed, the Reporting Server updates each of the reports selected. For example, if daily, weekly, and monthly are selected, the daily report is updated each time the log is analyzed during the day. Then, at the end of the day, the weekly and monthly reports are updated using the completed daily report, and because it is no longer used, the data used for the daily report is discarded. Similarly, when the weekly report is complete, the data used to create it is discarded, and at the end of the month when the monthly report is complete, the data used to create it is discarded. Because disk space and memory are needed to maintain the report data, only select the reports that you need. 1 Click Options, and the Reporting Server Options window opens. 2 Select the Reports tab, and select the report intervals that you want to maintain by clicking in the Report Types boxes. 3 For each report type, specify the number of reports to save from the corresponding Reports to Store list. If you run a large number of reports, you might limit the number of reports that are saved. Using this option, you can select the number of reports saved for each interval. For example, you might want to keep one month s worth of daily reports at a time; once the report for February 1 is 116

117 Chapter 9. Configuring Reporting Server Options created, the report for January 1 is deleted, and so on. When determining how many reports to store, consider how much disk space you want to devote to reports and how long you want to save them. A report using the Complete Summary template as it was installed needs up to 1 MB. 4 To allow Non-administrators to modify these settings for their profiles, click in the Allow Non-administrators to Configure... box. 5 Click OK to save your selections, or click Cancel to exit the Options window without saving your changes. Report header Use the Report Header tab to specify an image to include in your reports. You can also specify a URL to reference when a visitor clicks on the image. 1 Click Options, and the Reporting Server Options window opens. 2 Select the Report Header tab. Here you can specify the following options: Report Image--Specifies the complete path to the graphic to use. Report Image Alt--Specifies the text that is displayed if the image isn t available or as the graphic is loading. Associated URL--Specifies the URL to load when a visitor clicks on the Report Image. 3 Click OK to save and close the window. Report scheduler Use the Report Scheduler tab to define the default schedule for updating reports. 117

118 WebTrends Enterprise Reporting Server 1 Click Options, and the Reporting Server Options window opens. 2 Select the Scheduler tab. 3 In the Initial Start Time field, specify when you want the report to be generated using the 24 hour clock. 4 The default for the Frequency field is 15 minutes. Adjust this value to match the typical traffic on the web sites analyzed. 5 Select the Allow Non-administrators... option to allow nonadministrators to define the schedule on a profile basis. 6 Select the Start Initial Analysis... option to begin reports for new profiles immediately. To start reports at the scheduled time, do not select this option. 7 Click OK to save your selections, or click Cancel to exit the Options window without saving your changes. System performance Use the System Performance tab to modify settings that may improve performance in your environment. 118

119 Chapter 9. Configuring Reporting Server Options 1 Click Options, and the Reporting Server Options window opens. 2 Select the Performance tab. Maximum Number of Simultaneous Analyses--Enter the maximum number of profiles that can be processed concurrently. If your system has fast processing or multiple CPUs, increasing this number may improve performance. Threaded Analysis--Use this option to run more than one profile at a time. If your system has fast processing or multiple CPUs, enabling this option may improve performance. Do not use this option if your system lacks the resources, or if you want profiles processed one at a time. Note: Creation of reports is a single-threaded operation. 3 Click OK to save your selections. DNS lookup Use the DNS Lookup tab to define the DNS lookup method for profiles. If you allow non-administrators to modify this setting on a profile basis, the method you select is used as the default. 119

120 WebTrends Enterprise Reporting Server DNS lookup is the process of translating the numeric IP address into a domain name. This can be done either by the web server when logging activity or by WebTrends when it analyzes the log files. DNS lookups are performed more efficiently by the web server as the log is created, rather than by WebTrends. However, if you know your web server administrator or ISP disabled DNS Lookups for their servers, you can have WebTrends do them for you. 1 Click Options, and the Reporting Server Options window opens. 2 Select the DNS Lookup tab. Select the DNS Lookup from the drop-down list: Quick mode, using format from log--maintains the log format, domain name or numeric IP address, making this the fastest method for creating reports. If your web server doesn t perform DNS Lookups and you choose the Quick Mode in this dialog, WebTrends reports will display visitor s IP addresses rather than domain names. Resolve mode, lookup all numeric IPs--If your web server does not perform DNS Lookups and you need geographic or other domain-related information, select this option. Note: Resolve mode may slow reporting. Use it only if DNS lookups cannot be done on the server. Once a numeric 120

121 Chapter 9. Configuring Reporting Server Options address has been looked up, its text equivalent is stored in a permanent cache to expedite all subsequent reports. The default cache size is 50,000 entries; once this limit is reached, the oldest addresses are replaced with the new entries. You can change the cache size in the General tab. Auto mode, if you re unsure--if you don t know whether your log file contains IP addresses or domain names, you can let WebTrends decide. If WebTrends finds a domain name when it begins analyzing the log file, it uses the quick mode. If WebTrends finds an IP address when it begins analyzing the log file, it tries to translate, or resolve, all IP addresses. 3 Select the Allow Non-administrators... option to enable the DNS Lookup option in the profile window for all users. 4 Click OK to save your selections, or click Cancel to exit the Options window without saving your changes. Proxy If you access the Internet through a proxy server, you must configure these settings. For example, if you enabled page title retrieval in the General Options tab, WebTrends must be able to access the Internet in the same manner that you do. 1 Click Options and the Reporting Server Options window opens. 121

122 WebTrends Enterprise Reporting Server 2 Select the Proxy tab. 3 Click in the Connect Through Proxy Server check box. 4 Specify the URL for the proxy server to use in the Address field. 5 Enter the port number for the server in the Port field. 6 Enter the username and password required to acccess the server in the Proxy Server Login Information fields. This information is required only for servers who authenticate their users. Configuring advanced features The Advanced Features dialog allows you to create global definitions that can make your analysis more informative. Advanced Features deal with the following aspects: pages that you want to group together for reports shopping cart software or plug-ins that cause hits to be reported incorrectly frequently traveled paths through your site reporting on dynamic pages The following sections provide information on using and configuring each of these features. 122

123 Chapter 9. Configuring Reporting Server Options URL search and replace Each entry in the web server log contains a field that references the URL of the page or file that was accessed. Reporting Server uses this field to track activity on the web site, and counts each unique URL as a separate page or file. Some web server plug-ins or software add unique identifiers to URLs which can cause hits to these pages to be counted incorrectly. For example, shopping cart software may add a unique string to the page name in order to track visitors and their shopping carts. If this is the case, every hit to such a page appears in the log as a unique URL (containing the ID of the visitor), which would prevent you from getting an accurate hit count for that page. That s where URL Search and Replace comes in. This feature allows you to delete specific identifiers from URLs or replace all unique identifiers with a common string. Doing so restores accuracy to page counts, makes your reports more informative, and avoids some out of memory conditions when the number of unique IDs is extremely high. Once you ve set up the URLs to look for, you can apply them to all profiles or to the ones that you choose. Keep in mind that the URL replacement is performed before any other processing takes place. Using URL search and replace for shopping cart software Many web sites that sell products use shopping cart software. If you browse a site where you can purchase products, typically you see buttons that say, "add to basket" or "add to cart." The software used to track the shopping cart uses one of several mechanisms to associate the visitor of the site with her shopping cart. One of the following mechanisms can be used: IP address of the visitor This mechanism uses the IP address of the visitor to track the shopping cart. It is not widely used because many visitors can come from the same IP address. An IP address looks something like this: Cookie This mechanism uses a cookie that is stored on the visitor's computer to track the cart. It can also be used to track the user's shopping interests. Because some users don't allow cookies to be downloaded, software using cookies either rejects the user or switches to one of the other mechanisms. 123

124 WebTrends Enterprise Reporting Server Some examples of stores that use cookies are SalesCart, IBM and ShopSite. Parameters on dynamic pages Sites using dynamic pages often use a parameter that identifies the visitor and includes this parameter in the URL of every page visited. Each page is a script that uses the shopping cart parameter to access a database. One type of entry might look something like this: page.pl?cart_id=hjf k&product=boot, where HJF K is the cart id. Yahoo.Store and NetCart are examples of store providers using these parameters. Another type of entry might look like this: page.pl?hrud9tpc;00-342;26, where hrud9tpc is the id. Mercantec and MiniVend are examples of providers using this type of parameter. Data embedded in the URL Some sites using dynamic pages use server-side data includes to embed shopping cart information. Data embedded in the URL might look like this: /catalogue/ /offer/addproduct/123, where is the shopping cart id. How tracking mechanisms affect analysis If the shopping cart software uses the IP or cookie, the analysis is performed in the usual manner. If the software uses a consistent name/value pair parameter (such as?cart_id=ure445&product=jacket), you can use a URL Parameter Analysis definition (see Analyzing activity for a dynamic site on page 130). If the software doesn't use a name/value parameter pair (and uses something like page.pl?hrud9tpc;00-342;26), or if the data is embedded (such as /catalogue/ /offer/addproduct/ 123), you should use a URL Search and Replace definition. Using URL search and replace to group pages You can use URL Replacement definitions to analyze and report on URLs differently than they were recorded in the log. You might do this to report on all pages from a certain directory as hits to the same page, forcing the pages into a group. Because the URL replacement 124

125 Chapter 9. Configuring Reporting Server Options is performed before the analysis, the change affects the counting for all tables and graphs. Grouping pages using this method differs from Content Groups because Content Group definitions only apply to the Content Group section, whereas a URL replacement definition applies to all sections of the report. To make URL replacement selections 1 Select Configuration>Advanced Features>URL Search and Replace. The URL Search and Replace tab lists all URL replacment definitions. Checks indicate those that are enabled. 2 Select one of the following options: Add--Click this button to create a new definition. See Creating a URL replacement definition on page 126 for details. Edit--Select an item, and click Edit to modify the settings. Delete--Select an item, and click Delete to remove it. 3 You can apply the definitions to every profile or pick the ones to use for each profile: 125

126 WebTrends Enterprise Reporting Server Apply these settings to all profiles--select this option to apply these definitions to all profiles. Allow the user to modify on a profile basis--select this option to choose the URL replacement definitions on a profile basis. 4 Click OK to close the dialog. Creating a URL replacement definition Use these steps to create a new URL replacement definition. 1 Select Configuration>Advanced Features>URL Search and Replace. 2 Click Add, and the Preconfigured URL Search and Replace dialog opens. 3 Select Custom from the Shopping Cart list, and click Continue. The URL Search and Replace dialog opens. 4 Enter a name for the definition in the Description field. 5 Use the Replace From list to select the starting point for the replacement. Enter the string to match in the next field. 126

127 Chapter 9. Configuring Reporting Server Options 6 Use the Up To list to select the ending point for the replacement from the drop-down list, and enter the text that indicates the end of the replacement string. 7 In the With field, enter the text to use in place of the text you specified in the Replace From field. 8 In the Perform Replacement only if URL Contains field, you specify a value to match. The text is replaced only if the URL contains this value. 9 To use the URL text that was replaced to track user sessions, check the Use the Text That Was Replaced... box. The replaced text is used rather than an IP or cookie. 10 Use the Test Area to see how the definition works. Enter a sample URL, and click the Test button. The results are displayed in the Resulting URL field. The text that was removed is displayed in the Text that was Replaced field. 11 Click OK to close the URL Search and Replace dialog. Defining paths to analyze Use Path Analysis definitions to discover the pages visitors went to from a specified page. This allows you to get path analysis data on the parts of the site that interest you. For example, if you want to report on the top paths from the pricing page, order.htm, create a path analysis definition which specifies the location of order.htm and the number of paths to report on. 127

128 WebTrends Enterprise Reporting Server 1 Select Configuration>Advanced Features>Path Analysis. 2 Click Add, and the Path Analysis dialog opens. 3 In the Description field, enter a name for this path analysis. What you enter here identifies the Path Analysis throughout the program. 4 In the Starting Page field, enter the web page to use as the starting point for the path analysis. 5 Use the Number of Levels to Track box to specify the depth of the path analysis. For example, a value of 6 reports on the next six pages that the visitor went to from the page specified. 128

129 Chapter 9. Configuring Reporting Server Options 6 Use the Maximum Number of Paths to Track box to specify the maximum number of paths to track for this definition. When this value is reached, the entire table is discarded from the report. This is necessary because all matches must be considered for accurate reports. You may need to reduce this number to reduce the amount of memory used in processing. 7 Click OK to close the dialog. Note: To automatically use the Paths Analysis definitions in all profiles, select Apply These Settings to All Profiles. Creating content groups If you re finding that the physical organization of your site limits the information that you get in reports, you may want to categorize some pages into groups. Content Group definitions allow you to group related pages in one report. For example, if you have pages in various parts of the site that relate to a particular product, you could sort all of these URLs into one group. A Content Group definition is a set of patterns that identifies each group. Patterns are the key parts of the URL. If the URL matches a pattern in the definition, it is associated with the group. To create a content group definition: 1 Select Configuration>Advanced Features>Content Groups. 2 Click Add, and the Content Groups dialog opens. 3 In the Description field, enter a name for the new group. This is used to identify it in the Profile list and in reports. 4 In the Patterns field, enter the part of the URL that pages in this group should match. Enter each pattern on a separate line. 129

130 WebTrends Enterprise Reporting Server Note: Click OK to close the dialog. To automatically use the selected Content Group definitions in all profiles, select Apply These Settings to All Profiles. Analyzing activity for a dynamic site Looking for meaningful data on a dynamic web site? Tracking dynamic pages requires some customizing, but your efforts are rewarded with reports that provide both a summary of activity for each dynamic page (via the Top Forms section) and parameter data for each page defined (via the Dynamic Pages section). Most people reporting on dynamic sites avoid tracking their pages as "documents." Check the File Types configuration option to confirm that the file extension (such as.asp) is not listed as a document type. See File types on page 109 for information. Create a URL Parameter Analysis definition for each page that interests you. The section that follows explains what a URL Parameter Analysis definition is and provides instructions for creating one. Note: If you don t define a page through a URL Parameter Analysis definition, the total hits for the page are reported in the Top Forms section. URL parameter analysis definitions A URL Parameter Analysis definition associates a page with a parameter used to create it. Because there may be many parameters passed for a particular page, you can create definitions for each. The number of hits and user sessions for each value submitted with the parameter appear in the Dynamic Page reports. To create a URL Parameter Analysis definition The procedure that follows uses the example of reporting on activity for products on the downloads page. The URL for this page looks something like this: download.htm?product=

131 Chapter 9. Configuring Reporting Server Options 1 Select Configuration>Advanced Features>URL Parameter Analysis. 2 Click Add, and the URL Parameter Analysis dialog opens. 3 In the Description field, enter a name for this definition. For example, if this definition is for the downloads.asp page, you might enter Downloads here. The description is used to identify the definition in the Advanced Features dialog, in the profile window, and in reports. 4 In the URL field, enter the web page for this definition. This is how the page appears in the log file. For example, if the URL is in the Dynamic page field, you would enter /site_download/ download.htm To specify a home page, enter "/" in the URL field. Note: If you are reporting on a multi-homed log, you must include the domain in the URL field. 5 In the Parameter Name field, enter the parameter to track. Each time the page appears with the parameter, the value for that parameter is recorded in the log file. In our example, you want to look at the product parameter on the downloads.asp page, so you enter product. 6 If you created a translation file for the parameters, check the Translate Parameter Values box. Then specify the location of the translation file. See Creating translation files on page 131 for information. 7 Click OK to close the dialog. Creating translation files The translation file lists each value that the parameter may have and associates it with a more readable phrase. For example, if your web site is designed to refer to products by number, the map file can be used to translate those numbers to actual product names. Each line 131

132 WebTrends Enterprise Reporting Server in the file contains a value and a phrase, separated by a comma or tab, as shown here: 0014,Firewall 0016,Professional Suite To group multiple parameters values as one, give each the same text definition. For example, if you sell running shoes on your site, and you want to report on all styles of a brand, the translation file might look something like this: flight07,flight Shoes flight06,flight Shoes Web server configuration In the Web Server Configuration window, you can work with settings for the web server that publish reports. 1 Select Configuration>Web Server Configuration. 2 In the Web Server Configuration window, you can modify the following settings: Port--Specifies the port where the web server resides. Be sure the port is not used by another daemon. Authentication--Specifies the method used to authenticate the users when the log in. If you select Operating System, the user must have an account on the machine. If you select Custom, you must define a password for all users in the User Access window. User Session Timeout--Specifies the length of the timeout before the user is disconnected from the server. 132

133 Chapter 10. Working with Users and Permissions About user access The User Access feature enables you to set up user accounts for the Reporting Server. Here you can define the features individuals have access to, define profile default settings, and restrict the dialogs they see. If you are using the Reporting Server s authentication instead of OS Authentication, you specify usernames and passwords as well. Note: Your license determines the number of user accounts you can create. Creating a user account This section describes the steps for setting up a user account. 1 Click the Access button. The Configure User Access and Privileges dialog displays all accounts. Note: The area just below the Users list displays the number of Administrators and the number of Users defined. 133

134 WebTrends Enterprise Reporting Server 2 Click the Add button, and the Add New User dialog opens. 3 Enter the login name for the user in the Username field. If the password field is displayed, enter the password for the user in the Password field. Note: The password field appears only if OS Authentication was not enabled. See Remote configuration on page 165 for more information. 4 Select the privileges for this user: View Reports--Allows the user to look at published reports. All users are given view access. Add Profiles--Allows the user to create profiles. Edit Profiles--Allows the user to modify profiles. Delete Profiles--Allows the user to remove profiles. Administrator Rights--Gives the user access to all the Reporting Server functions. 5 Check Enable Advanced Configuration to define restrictions and default profile settings for the user. 134

135 Chapter 10. Working with Users and Permissions 6 If you did not check Enable Advanced Configuration, click Finish and skip the next steps. If you checked Enable Advanced Configuration, click Next, and the Restrictions dialog opens. To limit the number of profiles the user can create, check the box, and enter the maximum number of profiles. 7 Click Next, and a profile dialog opens. Use these dialogs to define default settings for this user s profiles. Note: Wherever you see "Hide this tab from the user," you can define the options and prevent the user from seeing the dialog when she is working with profiles. Note: Refer to Creating a profile on page 40 or the online help for details on each profile setting. 8 Click OK to save your settings. Modifying a user account This section describes changing the settings in a user account. 135

136 WebTrends Enterprise Reporting Server Note: You cannot modify your own permissions. Only another Administrator may do so. 1 Click the Access button. 2 Select the user whose account you want to modify from the list. 3 Click the Edit button. 4 Make your changes, and click OK. Note: Wherever you see "Hide this tab from the user," you can define the options and prevent the user from seeing the dialog when she is working with profiles. 136

137 Chapter 11. Running from the command line About the command line capability Although the Reporting Server provides a graphical user interface (GUI) for viewing reports and administering the program, you can perform all Reporting Server functions from the command line. Most likely you ll configure the Reporting Server from the command line to benefit from the immediacy and speed. Running a profile from the command line allows you analyze the profile without having to start the Reporting Server s web server. Using the commands available and configuration text files, you can: start and stop the program configure program settings setup user accounts create profiles create report template styles review program and profile audit files define Internet advertising to track enter information about your Intranet to include in reports customize the company database used for reports Table 11-1 Audit and Configuration Text Files File Purpose Refer to this section adviews.txt keywords.ini <profilestatus > style.ini.usr Define advertisements to track. Defines the search engine identified in reports. Contains a log of activity for the profile selected. Defines report template settings. Defines user accounts, privileges, and default profile settings. Defining advertisements to track on page 199. Modifying search engines on page 201. Using the profile status log on page 212. Working with report templates on page 196. Setting up user accounts and permissions on page

138 WebTrends Enterprise Reporting Server File Purpose Refer to this section.wlp Create profiles. Working with profiles on page 174. wtintra.txt wt_remote.ini wtm_wtx.ini wtrs.audit Customizes domain information for reports. Configures settings for the web server that provides the remote interface. Specifies program wide settings including many default settings. Contains a detailed log of program activity which you, the administrator, should check daily. Setting up your intranet domains on page 200. Configuring web server settings on page 165. Configuring web server settings on page 165. Using the wtrs.audit file on page 211. Directory structure The following graphic shows the directory structure for the Reporting Server. /WebTrends Reporting Server /scripts /users /wt_script /wtm_wtx /wwwroot WebTrends Reporting Server Executables and.ini files wtrs.exe /CordaJava /datfiles /images /MSWord /templates report.ini style.ini webtrend.ini wt_remote.ini /databases /profiles /reports /samples /statuslogs Profile Configuration Files Report Data by Profile Profile Status Logs and Server Audit File The following table briefly describes the top level directories for the Reporting Server. 138

139 Chapter 11. Running from the command line Table 11-2 Reporting Server Directory Structure Directory Sub-directory Contains scripts cgi-inc general /layout /res wtm_wtx /language /layout /res and.pl files wtscript.ph files wtm_wtx CordaJava /apfiles /com /PopChartA.zip datfiles /databases /profiles /reports / samples /users /statuslogs images.html files and.gifs for reports MSword Installation package for the Microsoft Word convertor program template.var and.rpl files for report templates wwwroot english help /general /wtm_wtx help directories images /btns /tabs and.gifs for program Command line options This section describes the scripts available to run the program and their parameters. Scripts wtrs.server The wtrs.server script invokes both the wtinterface.server script and the wtengine.server script. Using the parameters available you can control both the analysis engine and the remote interface. wtengine.server The wtengine.server script calls the wtrs executable which controls the analysis engine. wtinterface.server The wtinterface.server script calls the wtinterface executable which controls the remote interface. 139

140 WebTrends Enterprise Reporting Server Table 11-3 Script parameters Parameter start stop status Description Starts the service. Stops the service. Provides the status of the service. Syntax Reporting Server scripts require the following syntax: [script] [parameter] For example, wtrs.service start Executables wtrs The executable, wtrs, performs the analysis and other program processes such as generating reports and updating files for changes made through the remote interface. Run wtrs using the available parameters. It also can be called by wtrs.service or wtengine.service. wtinterface The executable, wtinterface, controls the graphical user interface using the parameters available. It communicates with the analysis engine through the port specified during installation. wtinterface can be called by wtrs.service or wtinterface.service. Otherwise, you must start wtrs in order to start wtinterface. Table 11-4 Executable parameters Parameter Description -start -stop -status -update Starts the executable. Stops the executable Provides the status of the executable. Updates program configuration without stopping the program. 140

141 Chapter 11. Running from the command line Syntax Reporting Server executables accept commands presented in the following syntax: [executable] [-option]--where [executable] refers to either wtrs or wtinterface and [-option] refers to one of the program parameters defined in the previous table. For example, the command to start wtrs looks like this: wtrs -start wtrs <profile>--where <profile> is the name of a single profile or a set of profiles. For example, you can run the sample profile included with the program by entering the following: wtrs sample Note: Use wildcards to specify a set of profile names. Enter * to specify all profiles. Spaces are not allowed in profile file names. wtrs -reanalyze <profile>--where <profile> is the name of a single profile or a set of profiles. Reanalyzing a profile allows you to make changes to a profile s settings and update the profile s entire set of reports at the next scheduled interval. Were you to make a change and not reanalyze, only new reports would reflect the change. Important! When you reanalyze a profile, all existing databases and reports are deleted. Note: If the Reporting Server is running as a daemon, you cannot run profiles from the command line. Recommended steps for using command line settings We recommend the following process for creating the text files described in the previous section. 1 Use the GUI to create a profile, template, intranet domain definition, user file, or ad click definition that contains the settings 141

142 WebTrends Enterprise Reporting Server that you are most likely to use. Name these items in a way that you can recognize them in the text files. 2 To make sure that all of your settings have been recorded in the text files, select File>Exit. To locate your profile or memorized report text files, sort them by date. The Reporting Server uses a default incremental naming convention to name them (for example, "1" and "2". However, for your own custom files, you can use any naming convention you like. Just make sure that they have the right extension. 3 Modify your files using a plain text editor such as vi. The file options are described in the sections that follow. Hierarchy of settings In Reporting Server processing, there are three levels of configuration settings. Global configuration settings are defined in the wtm_wtx.ini file. Settings in the wtm_wtx.ini file define defaults for profiles, and apply to Reporting Server processes on the whole (for example, the web server that is used for posting reports or the settings for threading processing). Only administrators have access to these settings. Profile settings are kept in.wlp files. The settings defined in the wtm_wtx.ini file appear as defaults in the.wlp file. Anyone with create profile access can override these settings. User settings are maintained in.usr files. As an administrator, you can tighten profile settings even more through.usr files. In addition to acess rights,.usr files contain profile settings defined just for the user. You can also hide the profile dialogs from the user, so that only those that you choose appear. Configuring program settings Most program configuration settings and profile default settings are located in the wtm_wtx.ini file. Use this section as a reference for the settings contained in this file. audit The Reporting Server maintains audit files for each profile and for the program. 142

143 Chapter 11. Running from the command line Table 11-5 Audit settings Audit settings Default logdir./wtm_wtx/datfiles/statuslog Specifies the directory where the profile status logs and the audit file for the Reporting Server are stored. logfile wtrs.audit Specifies the name of the Reporting Server audit file. This file provides an account of program activity. Audit settings [audit] logdir =./wtm_wtx/datfiles/statuslogs logfile = wtrs.audit archives Archiving allows you to backup profile databases and reports at regular intervals. The archives section defines how often archiving takes place and the maximum number of archives kept for each profile. Table 11-6 Archive settings Archive setting cookie Default frequency 30 Specifies how often an archive is created for the profile. maxarchives 11 Specifies the maximum number of archives kept for each profile using archiving. If your web server uses cookies to identify repeat visitors, this information can be used to more accurately identify unique user sessions. Using cookies is the most accurate way of tracking the user s path through the site. Note: See Cookies on page 107 for details on how cookies are defined in the GUI. 143

144 WebTrends Enterprise Reporting Server Table 11-7 Cookie settings Cookie setting Default enable 1 1--Uses cookie data in the analysis. 0--Cookies are not used to track visitors. validate 1 1--Includes only valid cookies in the analysis. 0--Does not validate the cookie. If enabled is set to 1, the data in the cookie field of the log file is used in the analysis. If enabled is set to 0, this value is not read. CookieText Allows you to specify a cookie to use to track user sessions. 1--Uses the cookie specified in the CookieString option. 0--Uses the cookie generated by the WebTrends Plugin (or none, if enable is set to 0.) Note: You must also specify the cookie to match in the cookiestring option. WebTrendsPlugin Allows you to use the cookie generated by either WebTrends Netscape Extended Log Plugin or WebTrends IIS Extended Log Plugin. 1--If CookieText is set to 0, set this option to If CookieText is set to 1, set this option to 0. Note: You must have installed one of these plugins to use this option. CookieString If the CookieText option is set to 1, specify the cookie format to validate here. Enter the string to match. For example, the cookie field of a log file might look like this: CookieID1=CookieValue1;CookieID2=CookieValue2; CookieID3=CookieValue3 If the cookie that you want to use to identify user sessions is CookieID2, you would enter CookieID2 in the CookieString field. If you are using Microsoft SiteServer, you might have cookies that look like this: SITESERVER=ID=CookieValue1;SITESERVER=GUID=CookieValue 2 If the GUID is the cookie that you want to use to identify user sessions, then you should enter SITESERVER=GUID in the CookieString field. 144

145 Chapter 11. Running from the command line Cookie settings [cookie] enable = 1 validate = 0 defaults The settings in this section define the defaults for new profiles created through the GUI (graphical user interface). Table 11-8 Defaults settings default setting Default profilesdir./wtm_wtx/datfiles/profiles Specifies the directory where all profiles are kept. Entering./ in the path indicates that the directory is relative to the installation directory. Note: If you change this location, only new profiles appear in the new directory. Profiles created before the change remain in the original location unless you copy them. Note: The Reporting Server provides information on domain groupings in the Organization Breakdown table and graph. The following settings define the domains associated with each domain grouping. They can also be defined through the GUI. See Domain groups on page 111 for details. edu_orgtype edu ac.at at.cn ac.cr ac.cy ac.fj ac.id ac.il ac.im ac.in ac.jp ac.kr ac.nz ac.pa ac.th ac.ug ac.uk ac.yu ac.za re.kr ed.cr edu.ac edu.bm edu.cn edu.co edu.do edu.ec edu.eg edu.ge edu.gu edu.jo edu.lc edu.lv edu.mm edu.mo edu.my edu.pa edu.py edu.sg edu.sh edu.tr edu.tw edu.uy edu.ve edu.yu edu.za edunet.tn k12.ec k12.il k12.tr sch.uk school.fj school.za Specifies the domains associated with education types of organizations in reports. Separate multiple entries with spaces. usdomains com edu net org gov mil int arpa Specifies the domains associated with the United States in reports. Separate multiple entries with spaces. int_orgtype int int.co int.ve intl.tn 145

146 WebTrends Enterprise Reporting Server default setting Default Specifies the domains that are reported as International types of organizations. gov_orgtype gov go.cr go.id go.kr go.th go.ug gob.pa gov.ac gov.au gov.bm gov.br gov.cn gov.co gov.cy gov.do gov.ec gov.eg gov.fj gov.ge gov.gu gov.il gov.im gov.in gov.jo gov.jp gov.lb gov.lc gov.lv gov.mm gov.mo gov.my gov.sg gov.sh gov.tn gov.tr gov.ua gov.ua gov.uk gov.ve gov.ve gov.za gove.tw govt.nz Specifies the domains that are reported as government types of organizations. mil_orgtype mil mil.ac mil.br mil.co mil.do mil.ec mil.ge mil.gu mil.id mil.lb mil.lv mil.ph mil.sh mil.tr mil.ve mil.za Specifies the domains that are reported as military types of organizations. net_orgtype net ad.jp ne.kr net.ac net.ae net.ar net.au net.bm bet.br net.bs net.cn net.cu net.cy net.do net.ec net.eg net.ge net.gu net.hk net.id net.il net.im net.in net.jo net.jp net.la net.lb net.lc net.lv net.ly net.mm net.mo net.mt net.mx net.my net.na net.nc net.np net.nz net.pa net.pe net.ph net.pl net.py net.ru net.sg net.sh net.sy net.th net.tn net.tr net.tw net.ua net.uk net.uy net.ve net.vi net.ve net.vi net.za Specifies the domains that are reported as network types of organizations. 146

147 Chapter 11. Running from the command line default setting Default org_orgtype org or.cr or.id or.kr or.th or.ug org.ac org.ae org.au org.bm org.br org.bs org.cn org.co org.cu org.cy org.do orge.ec org.eg org.fj org.ge org.gu org.hk org.hu org.il org.im org.jp org.la org.lb org.lc org.lv org.ly org.mm org.mo org.mt org.mx org.my org.na org.nc org.nz org.pa org.pe org.ph org.pl org.py org.ru org.sg org.sh org.sy org.tn org.tr org.tw org.uk org.uy org.ve org.vi org.yu org.za Specifies the domains that are reported as organizations. arpa_orgtype arpa Specifies the domains that are reported as arpa types of organizations. com_orgtype com co co.at co.co co.hu co.id co.id co.il co.im co.in co.jp co.kr co.nz co.sv co.th co.ug co.uk co.ve co.vi co.yu co.za com.ac com.ae com.ar com.au com.bm com.br com.bs com.cn com.co com.cu com.cy com.do com.ec com.eg com.jf com.ge com.gu com.gh com.jo com.la com.lb com.lc com.lv com.ly com.mm com.mo com.mt com.mx com.my com.na com.nc com.ni com.np com.pa com.pe com.ph com.pl com.py com.ru com.sg com.sh com.sy com.tn com.tr com.tw com.ua com.uy com.ve firm.co firm.ve ltd.uk Specifies the domains that are associated as commercial types of organizations. maxtopcount 500 This option is not currently used. maxthreads

148 WebTrends Enterprise Reporting Server default setting Specifies the number of threads which are allocated to reverse DNS (domain name server) lookups. The threads are divided among the number of concurrent analyses. maxcachedcount NA This option is not currently used. dnscachelifespan 30 Specifies the number of days that DNS entries stored in the database are valid. dnsthreads (Solaris 2.5) 8 (Solaris 2.6) 16 (Linux) 1 Specifies the number of threads available to perform DNS lookups on the entries in the lookup queue. The more threads working on DNS resolution, the quicker the process should go, provided that there are enough entries in the lookup queue to work on. However, if there are too many threads for the size of the lookup queue, many of the threads are not used, and remain idle. Making this number too high may overtax system resources. dnscacheentries 5000 Specifies the number of entries in the DNS cache. Once an entry in the DNS lookup queue has been cached, it is saved here until the maximum number of entries is reached. If you are running extremely large log files, or log files with a high incidence of unique IPs, you should increase the size of the cache for better performance on subsequent analyses. Each entry takes about 50 bytes; making the cache too large may cause excessive swapping. dnstimeout 5 Specifies the maximum number of seconds given to perform each DNS lookup. Once this number is reached, the IP is cached whether it is translated or not, and the record is ready for processing. Decreasing this value can improve performance significantly if there are a large number of IPs that cannot be translated. However, once an IP has been cached, it is not be looked up again which can affect the accuracy of reports. downloadtypes Default {exe,0} {com,0} {zip,0} {pdf,0} {arc,0} {bin,0} {sit,0} {tar,0} {gz,0} {z,0} {arj,0} 148

149 Chapter 11. Running from the command line default setting Default Specifies the file type extensions that are associated with downloaded files and when the file type is included in reports. 0--includes the file type if it is from a script or dynamic page. 1--includes the file type only if it is not from a script or dynamic page. 2--always includes the file type. This data is included in the Top Downloaded Files table and graph. documenttypes {htm,0} {txt,0} {mdl,0} {shtml,0} {htmls,0} {html,0} {htp,0} {htpl,0} {dbm,0} {asp,0} {sht,0} {cfm,0} Specifies the file type extensions that are counted as document files and when the file type is included in reports. 0--includes the file type if it is from a script or dynamic page. 1--includes the file type only if it is not from a script or dynamic page. 2--always includes the file type. These are reported in the Most/Least Requested Pages table and graph, and the Top Entry/Exit Pages table and graph. cachedtime 1800 Specifies the number of minutes of inactivity before the user session is timed-out. The default value, 1800, corresponds to 30 minutes of inactivity. titlecachesize 1000 If the NoHTMLTitles option is disabled (set to0), specify the size of the cache for page titles here. The default value is titlecachelifespan If the NoHTMLTitles option is disabled (set to1), specify the maximum number of seconds entries are saved in the cache. This option is typically used for sites that change often. The default value is (3 days). nohtmltitles 0 Setting this value to 1 leaves HTML page titles out of reports. Tip: Setting this option to 1 may significantly reduce the time it takes to analyze the log file. UseGlobalContentGroups Content Group definitions can be applied to all profiles or can be selected on a profile basis. 0--Apply the definitions to all profiles. 1--Allows you to specify the definitions on a profile basis. useglobalpathsanalysisprofil es 149

150 WebTrends Enterprise Reporting Server default setting Default Path Analysis definitions can be applied to all profiles or be selected on a profile basis. 0--Apply the definitions to all profiles. 1--Allows you to specify the definitions on a profile basis. useglobalquerystrings URL Parameter Analysis definitions can be applied to all profiles or only to those that you chose. 0--Apply the definitions to all profiles 1--Allows you to specify the definitions on a profile basis. UseGlobalURLReplacementFilte rs URL Search and Replace definitions can be applied to all profiles or can be selected on a profile basis. 0--Uses the definitions specified in the URL Search and Replace dialog for all log analysis profiles. 1--Allows you to specify the definitions on a profile basis. 150

151 Chapter 11. Running from the command line Defaults settings [defaults] profilesdir =./wtm_wtx/datfiles/profiles rtrange = 5 edu_orgtype = edu ac.at at.cn ac.cr ac.cy ac.fj ac.id ac.il ac.im ac.in ac.jp ac.kr ac.nz ac.pa ac.th ac.ug ac.uk ac.yu ac.za re.kr ed.cr edu.ac edu.bm edu.cn edu.co edu.do edu.ec edu.eg edu.ge edu.gu edu.jo edu.lc edu.lv edu.mm edu.mo edu.my edu.pa edu.py edu.sg... usdomains = com edu net org gov mil int arpa int_orgtype = int int.co int.ve intl.tn gov_orgtype = gov go.cr go.id go.kr go.th go.ug gob.pa gov.ac gov.au gov.bm gov.br gov.cn gov.co gov.cy gov.do gov.ec gov.eg gov.fj gov.ge gov.gu gov.il gov.im gov.in gov.jo gov.jp gov.lb gov.lc gov.lv gov.mm... mil_orgtype = mil mil.ac mil.br mil.co mil.do mil.ec mil.ge mil.gu mil.id mil.lb mil.lv mil.ph mil.sh mil.tr mil.ve mil.za net_orgtype = net ad.jp ne.kr net.ac net.ae net.ar net.au net.bm bet.br net.bs net.cn net.cu net.cy net.do net.ec net.eg net.ge net.gu net.hk net.id net.il net.im net.in net.jo net.jp net.la net.lb net.lc net.lv net.ly net.mm net.mo net.mt net.mx net.my net.na net.nc... org_orgtype = org or.cr or.id or.kr or.th or.ug org.ac org.ae org.au org.bm org.br org.bs org.cn org.co org.cu org.cy org.do orge.ec org.eg org.fj org.ge org.gu org.hk org.hu org.il org.im org.jp org.la org.lb org.lc org.lv org.ly org.mm org.mo org.mt org.mx org.my org.na... arpa_orgtype = arpa com_orgtype = com co co.at co.co co.hu co.id co.id co.il co.im co.in co.jp co.kr co.nz co.sv co.th co.ug co.uk co.ve co.vi co.yu co.za com.ac com.ae com.ar com.au com.bm com.br com.bs com.cn com.co com.cu com.cy com.do com.ec com.eg com.jf com.ge com.gu com.gh com.jo com.la... maxtopcount = 500 maxthreads = 150 maxcachedcount = 4000 dnscachelifespan = 30 downloadtypes = {exe,0} {com,0} {zip,0} {pdf,0} documenttypes = {asa,2} {asp,2} {cdx,2} {cer,2} cachedtime = 1800 dnscacheentries = 7000 titlecachesize = 1800 titlecachelifespan = 365 nohtmltitles = 0 151

152 WebTrends Enterprise Reporting Server reports The settings in the reports section define the number of reports that are saved for each interval by default. Once this limit is reached, the oldest report is deleted to make room for the new one. When determining how many reports to store, consider how much disk space you want to devote to reports and how long you want to save them. A report using the Complete Summary template as it was installed needs K. These settings correspond to the dailyreport, weeklyreport, monthlyreport, quarterlyreport, and yearlyreport settings in the [profile] section of the wtm_wtx.ini file. As an administrator, you can modify these setting on a profile basis. Non-administrators can modify these settings if the histoverride option in the profiles section is set to 1. Note: If an option is not present, if it has a value of 0, or if it is blank, reports are not deleted. Table 11-9 Reportssettings Reports settings Default dailystore 0 Specifies the default number of daily reports to save. weeklystore 0 Specifies the default number of weekly reports to save. monthlystore 0 Specifies the default number of monthly reports to save. quarterlystore 0 Specifies the default number of quarterly reports to save. yearlystore 0 Specifies the default number of yearly reports to save. performance If you are analyzing a large number of log files, these settings help you manage the performance of the Reporting Server. 152

153 Chapter 11. Running from the command line Note: You can also modify these settings through the GUI. See System performance on page 118 for details. Table Performance settings Performance settings Default threadedanalysis true This option specifies whether multiple processes are performed at the same time. Set this option to false if your system lacks the resources, or if you want the processing of profiles handled one at a time. false--performs profile analyses one at a time. true--analyzes more than one profile at once. If your system has fast processing or multiple CPUs, enabling threaded analysis may improve performance. maxanalysis 1 Enter the maximum number of profiles that can be processed concurrently. If your system has fast processing or multiple CPUs, increasing this number may improve performance. lookupqueuesize 5000 Specifies the maximum number of records in the lookup queue. Records enter the lookup queue and wait to be processed by one of the lookup threads. The lookup queue should be large enough to make use of the available lookup threads, but not so large that it uses too much memory. Each queue entry uses 2K of memory; if the lookup queue is too large, excessive swapping occurs. Performance settings [performance] maxanalysis = 1 threadedanalysis = true language The language section defines the language that reports should be generated in. 153

154 WebTrends Enterprise Reporting Server Table Language Settings Language settings Language settings Default country US Specifies the country that will be identified as the country of origin for reports. report english Specifies the language to use for the report. Enter one of the following: english french german [language] country = US report = english profile The settings in the profile section are used as default settings for profiles created through the GUI. Table Default profile settings. Profile settings Default threadedreports true A value of true generate reports concurrently with analysis. Set this value to false to suspend analysis while reports are generated. debuglevel 5 Specifies the degree of verbosity when debugging the profile. Enter a value from A value of 10 provides the greatest detail. enablearchives 1 Specifies the default archiving setting for profiles. 0--Disables archiving by default. 1--Enables archiving by default. processingtype 1 Specifies whether to analyze the entire log file or to analyze the log file beginning with the date specified for the startprocessingat option. 0--All dates in the log file are analyzed. 1--The log file is analyzed from the date specified in the startprocessingat option to the end. 154

155 Chapter 11. Running from the command line Profile settings Default startprocessingat If processingtype is 1, the log file is analyzed beginning with the date specified here. Enter a date in yyyy/mm/dd format. logfileformat 0 This option is not currently used. deferred reports false This option is not currently used. dnsoverride false This option is not currently used. dnslookup 0 Specifies the method of DNS lookup to use. A value of 0 disables DNS lookup and maintain the user data as it appears in the log file. 1--Attempts to translate all IPs to domain names. 2--If you don t know the format of the log and want to turn DNS lookup on. Until a domain is found in the log, WebTrends attempts to translate all IPs. schedoverride false Setting this value to true allows non-administrators to modify the schedule on a profile basis. Setting this value to false allows only administrators to define analysis schedules on a profile basis. startimmediately true Setting this value to true causes new profiles to be processed as soon as they are saved rather than waiting for the scheduled start time. starttime 00:00 Specifies the schedule for starting profile analysis. If the schedoverride option is set to true, this value is used as the default which users can change on a profile basis. period 15 Specifies how often the report is updated (in minutes.) reportfileoverride false Setting this value to true allows non-administrators to change the directory for the database on a profile basis. reportfile Complete summary.wct 155

156 WebTrends Enterprise Reporting Server Profile settings Default Specifies the report template to use as the default for profiles. Note: Report template files have a.wct extension. By default they are located in the wtm_wtx directory. webservermodeoverride false Setting this value to 1 allows non-administrators to define the web server to use for reports on a profile basis. Setting this value to 0 uses the setting in the webservermode option. webservermode webtrends Specifies the web server to use for publishing reports. webtrends--uses the built-in web server for publishing reports. other--uses another web server. reportdestoverride 0 1--Allows non-administrators to define the report directory and URL on a profile basis. 0--Uses the settings defined in this file. reportdir./wtm_wtx/datfiles/reports/ %PROFILE%.wlp If the webservermode option is set to other, this option defines the directory path where reports for the profile are saved. For example, / hosting/server2/reports/%profile%.wlp Note: If you change the report directory, only reports created after the change appear in this location. Reports created before the change remain in the original location. reporturl %PROFILE%.wlp/index.html If the webservermode option is set to other, this option defines the URL for the report. wtreportdir./wtm_wtx/datfiles/reports/ %PROFILE%.wlp If the webservermode option is set to webtrends, this option defines the directory where reports are saved. wtreporturl %PROFILE%.wlp/index.html If the webservermode options is set to webtrends, this option defines the URL for the report. datadiroverride false 156

157 Chapter 11. Running from the command line Profile settings Default true--allows non-administrators to define the location of the database directory on a profile basis. false--uses the value for the datadir option for profiles created by nonadministrators. datadir./wtm_wtx/datfiles/databases/ %PROFILE% Specifies the directory for profile databases. Note: If you change the database directory, the Reporting Server reanalyzes the log file from the beginning. Databases created before the change remain in the original location. showadmindatadir false true--allows administrators to change the location of the database directory on a profile basis. false--uses the value defined in the datadir option. histoverride false true--allows non-administrators to select the reports that are generated on a profile basis. false--uses the value in the weeklydata, monthlydata, quarterlydata, and yearlydata options. Tip: Granting only administrators this right can improve performance by closely controlling the data maintained. You should only maintain data for the reports that you need. Note: The following settings specify the databases that you want to maintain for creating reports. The Reporting Server uses the data from the daily database to fill databases for all other report intervals that are set to true. You must set the interval data field to true in order to generate a report for that interval. Each setting has a corresponding report setting which controls the generation of the report. Tip: To save space on your hard drive, maintain only the databases you need for reports. weeklydata true true--maintains a database for weekly reports. false--if you do not generate weekly reports, set the option to false. monthlydata true true--maintains a database for monthly reports. false--if you do not generate monthly reports, set the option to false. 157

158 WebTrends Enterprise Reporting Server Profile settings Default quarterlydata true true--maintains a database for quarterly reports. false--if you do not generate quarterly reports, set the option to false. yearlydata true true--maintains a database for yearly reports. false--if you do not generate yearly reports, set the option to false. Note: The following settings specify the report intervals that are enabled by default for profiles that you create through the GUI. The corresponding data option must be enabled to generate the report. For example, to generate a monthly report, the monthlydata option must be setting to true. weeklyreport na This option is not currently used. monthlyreport true true--activates the monthly report option for profiles created through the GUI. false--the monthly report option is not checked. quarterlyreport true true--activates the quarterly report option for profiles that are created through the GUI. false--the quarterly report option is not checked. yearlyreport true true--activates the yearly report option for profiles that.are created through the GUI. false--the yearly report option is not checked. tempdir./wtm_wtx/datfiles/databases/ %PROFILE%/.logtmp Specifies the directory location where zipped log files are unzipped. Proxy If you access the Internet through a proxy server, you must configure these settings. 158

159 Chapter 11. Running from the command line Table Proxy settings Proxy setting Example enable 0 Specifies whether these settings are used. 1--These settings are used for logs accessed through a proxy server. 0--Proxy settings are not used. httpserver webtrendsproxy.net Specifies the host name of the proxy server. httpport 8012 Specifies the port where the server resides. httplogin gloriaf If users are required to authenticate, specify the username here. httppassword D997BA1E82B A7F8 ED0CEAB If users are required to authenticate, this option specifies the encrypted password. This setting can only be configured through the UI. (httpplaintextpwd) titan If users are required to authenticate, this option specifies the plain text password. Use this option rather than httppassword if you are modifying this setting manually. FTP The [FTP] section defines settings used for log files that are accessed using FTP. Table FTP settings FTP settings Default ftptimeout 30 Specifies the timeout for FTP activity. If the program drops the connection after this limit is reached if it cannot successfully connect to the FTP server. Enter the number of seconds for the timeout. ftpdir./wtm_wtx/datfiles/ftp Specifies the directory where log files are downloaded. A separate directory is created for each profile. 159

160 WebTrends Enterprise Reporting Server FTP settings Default ftppersistantcachesiz 100 e Specifies the maximum number of megabytes FTP logs can use. This governs the space available to ALL profiles. For example, if there are currently FTP logs using 80 MB of disk space, and a new profile is created that requires 30 MB to download the FTP files. The logs are downloaded, increasing the FTP cache size to 110 MB. Once the profile is analyzed, the new profile s log files are deleted until the disk space used by FTP logs is less than 100 MB. Interface The [interface] section defines settings for the GUI. Table Interface settings Interface setting Default mode demo This option is maintained by the Reporting Server. Do not modify. It is used set the product in demo mode. In demo mode the ini files are not written to. It is either set to demo or blank. maxgridprofiles 50 Specifies the number of profiles that can be viewed on the main console. By default, this option is set to 50. To view more profiles in the list, increase the value. Once this value is reached, a dialog opens allowing you to specify criteria for displaying profiles. prostatrefresh Specifies how often the selected profile s status on the main console is updated. Enter the value in seconds. This option works in conjunction with the maxrefresh option. For, example to refresh the profile status every 5 seconds, set the postatrefresh to 5. To refresh the status a maximum of 100 times, set maxrefresh to 100. maxrefresh Number of times to refresh the selected profile's status on the main console before stopping. maxrefresh and postatrefresh together allow the page to refresh for a reasonable amount of time and then stop in order to relieve the server s time. Note: If the user clicks the Refresh/Reload button on the browser, this will effectively restart from

161 Chapter 11. Running from the command line Interface setting Default showbrowsermenu false Specifies whether or not the toolbar for the browser is displayed. true--displays the browser toolbar. false--hides the browser toolbar. ErsAddress 9999 Specifies the port number that the Reporting Server analysis engine uses to communicate server status back to wtinterface. The default port is MaxTableSizes Because all records in a log must be analyzed to report accurate statistics, the database for many report tables can grow quite large. To prevent these tables from using the memory required for other tables and graphs, you can define a maximum table size. Once the size is reached, the table is dropped, freeing the memory used to create it. If the maximum size is not reached, all records are analyzed, and an accurate report is displayed. These options can be entered in the [defaults] section. Enter a value between Table 11-1 MaxTableSizes section settings MaxTableSizes setting Top404Errors TopAuthUsers TopBandwidth TopCities TopCompanies TopCountries TopDirectory Description Limits the memory used to create the Client Errors table. Limits the memory used to create the Top Authenticated Users table. Limits the memory used to create the Bandwidth graph and Summary of Activity table. Limits the memory used to create the Most Active Cities table and graph. Limits the memory used to create the Most Active Organizations table and graph. Limits the memory used to create the Most Active Countries table and graph. Limits the memory used to create the Most Accessed Directory table and graph. 161

162 WebTrends Enterprise Reporting Server MaxTableSizes setting TopDownloads TopFormErrors Description Limits the memory used to create the Most Downloaded Files and Most Downloaded File Types tables and graphs. Limits the memory used to create the Dynamic Pages and Forms Errors table and graph. Feedback The [feedback] section specifies the URL for the product feedback page on the WebTrends Corporation web site. Table 11-1 Feedback settings Feedback settings Unix Description url feedback.htm Specifies the feedback page on the WebTrends Corporation web site. The settings in the Unix section specify the ids for running as a daemon or as root as well as the number of handles for processing. Table 11-2 Unix settings Unix settings uid 2 Default Specifies the user id of the user the Reporting Server daemon should run as. By default this value is set to 2, which is the id for bin user. gid blank Specifies the group id of the group the Reporting Server should run as. By default this value is blank. handles

163 Chapter 11. Running from the command line Unix settings Default Specifies the number of handles allocated for processing. By default this value is set to 64. The Reporting Server uses a handle for each log file it processes and several for creating reports. Depending on the number of log files being processed, all available handles may be exhausted. Consequently, the number of file handles must be increased to a number suitable to the number of log files the server accesses during analysis. The required number of handles is the number that would be analyzed at any one time, not the total of all log files to be analyzed. For example, a server may use 5 profiles, each with 10 log files to analyze. The unbounded number of required handles would be 5*10, or 50 handles. However, if the maximum number of concurrent analysis is limited to 2 profiles, only 20 handles are required during a single analysis. Add at least 5 for report generation, and a handle for each of the expected maximum number of simultaneous connections to the web server (currently set at 5). Note: If the server is started at system boot time, and "handles=" is left blank, the number of available handles is set to either unlimited for root, and the maximum resource limit for non-root users. Alternatively, the allocated number of file handles can be changed by using the ulimit command. For example, ulimit -n 128 will increase the number of available file handles to 128. ulimit -n displays the current file handle setting. usesymlinks false Allows you to use symbolic links for resource directories to save drive space. true--sets up a symbolic link for the images and CordaJava directories. false--symbolic links are not used and an images and CordaJava directory is maintained for each profile database. resolve options retrans:1 retry:1 Allows you to set an environmental variable to decrease the timeout for DNS lookups. The option applies only to Solaris 2.6 and 2.7. Enabling this option adjusts the timeout setting and number of retries for DNS lookups for the Reporting Server. The DNS lookups for other system processes are not affected. See the man page for resolve.conf for more information on the resolve setting. retrans--specifies the number of seconds for the DNS timeout. retry--specifies the number of attempts made to connect to the DNS server. 163

164 WebTrends Enterprise Reporting Server Profile settings [profile] threadedreports = true deferreports = false debuglevel = 7 logfileformat = 0 dnsoverride = false dnslookup = 0 schedoverride = false startimmediately = true starttime = 00:00 period = 15 reportfileoverride = false reportfile = Complete Summary.wct webservermodeoverride = false webservermode = webtrends reportdestoverride = false reportdir =./wtm_wtx/datfiles/reports/%profile%.wlp reporturl = index.html wtreportdir =./wtm_wtx/datfiles/reports/%profile%.wlp wtreporturl = index.html datadiroverride = false datadir =./wtm_wtx/datfiles/databases/%profile% showadmindatadir = false histoverride = false weeklydata = true monthlydata = true quarterlydata = true yearlydata = true dailyreport = true weeklyreport = true monthlyreport = true quarterlyreport = true yearlyreport = true 164

165 Chapter 11. Running from the command line Configuring web server settings The wt_remote.ini file contains settings that apply to wtinterface which runs the remote interface. Audit settings The [audit] section specifies settings for the wtinterface audit file. The audit file contains messages about remote interface processes. Table 11-3 Audit settings Audit setting Remote configuration Default logdir./wtm_wtx/datfiles/statuslogs Specifies the location of the audit file for wtinterface. logfile wtinterface.audit Specifies the name of the audit file. debuglevel 1 Specifies the degree of verbosity for the audit file. Enter a value from A value of 10 provides the greatest detail. The settings in the [RemoteConfiguration] section are used to configure the web server that runs the interface though a Web browser. Table 11-4 Remote configuration settings Remote configuration settings Default ERSRetries 30 Specifies the number of times wtinterface attempts to connect to wtrs. ERSTimout 2 Specifies the number of seconds that wtinterface waits for a repsonse from wtrs. Once this limit is reached, a retry is made until the maximum number of retries is reached. OSAuthentication 1 165

166 WebTrends Enterprise Reporting Server Remote configuration settings A value of 1 uses the operation system authentication. Reporting Server checks to see if the user logging in has a valid account on the machine and that it matches the username and password used to log in. A value of 0 uses the Reporting Server authentication database. When setting up users for the program, you define usernames and passwords to use. This is useful if you want to allow people to log in who do not have accounts on the operating system. Note: Reporting Server passwords are base 64 encoded. WebAddress 99 Specifies the port for the web server. This is the port defined when the program was installed. Port 99 is the default port. Make sure the port is not used by any other service.the default port for root installations is 99. The default port for non-root installations is The OS requires you to use port 1024 or above. Make sure the port is not used by any other daemon. WebLogFileName./wt_remote.log Specifies the file path for the web server log file. WebUserTimeout 300 Specifies the length of the user timeout before the user is disconnected from the server. Enter the length in seconds. WebLogErrors 1 Trace messages sent from the web server are stored in the wtm_remote.err file. This option specifies the degree of verbosity in the file. Enter a value of 1-5. A value of 1 generates minimal messages. Remote configuration settings [remote] OSAuthentication=1 WebAddress=99 WebLogFileName=wtx_remote.log WebUserTimeout=300 WebLogErrors=1 Default Authentication settings The authentication section defines your preferences for authenticating users. 166

167 Chapter 11. Running from the command line Table 11-5 Authentication settings Description Default methods password shadow If OSAuthentication is enabled, this option specifies the authentication method to use. Reporting Server supports PAM, passwd, and shadow. By default, password and shadow are used. Specify the authentication methods to use, separating your entries with a space. The order in which you enter them is not important; the Reporting Server attempts to implement them in the following order: PAM, passwd, shadow. PAM--(Plugable Authentication Module) If PAM is installed on the system and you want to use it as the authentication method for the Reporting Server, include PAM as one of the values. In the case that PAM fails, you should also specify a backup method. Passwd--Uses the user information and password from the passwd file. It may be argued that this method is not as secure as the others available because although encrypted, the passwd file is readable by anyone. Shadow--Uses the user information from the pass.wd file and the password from the shadow file. Shadow is considered more secure than the password method because the shadow file is only readable by super users. Unix The settings in the unix section specify the ids for running the service as well as the number of handles available for the interface. Table 11-6 Unix settings Unix settings uid 2 Default Specifies the user id of the user the wtinerface daemon should run as. By default this value is set to 2, which is the id for bin user. gid blank Specifies the group id of the group wtinterface should run as. By default this value is blank. 167

168 WebTrends Enterprise Reporting Server Unix settings Default handles 64 Specifies the number of handles allocated for connections to the web server. wtinterface uses one handle for each web server connection, one for each user logged into the interface, and one or more for every cgi script. By default this value is set to 64. Note: If the server is started at system boot time, and "handles=" is left blank, the number of available handles is set to either unlimited for root, and the maximum resource limit for non-root users. Alternatively, the allocated number of file handles can be changed by using the ulimit command. For example, ulimit -n 128 will increase the number of available file handles to 128. ulimit -n displays the current file handle setting. Setting up user accounts and permissions Use the.usr file to define users who have access to the Reporting Server and the permissions that they have. Each user has his/her own.usr file which specifies authentication information, permissions, restrictions, and default settings for profiles. Through the.usr file, you can also specify dialogs that you want to hide from the user. Because the settings in these files override those in the wtm_wtx.ini file, you can completely customize the profile interface for each user. Note: See Creating a user account on page 133 for details on setting up users through the GUI. When you install the Reporting Server, an anonymous.usr and %installuser%.usr (the person who installs the program) are created. To create a new user, copy a.usr file and modify it accordingly. The options in the.usr file are described in the sections that follow. user info settings The [userinfo] section defines the authentication for the user and level of permission. 168

169 Chapter 11. Running from the command line Table 11-7 User info settings User info settings Example permissions 7 Specifies the user s access rights. A value of 15 gives the user administrator rights. A value of 0 gives the user public access only. See User Permissions settings on page 171 for details. username migueld Specifies the user s operating system username. password oldcat7 If the OSAuthentication option is set to 0 in the wtm_remote.ini file, this value specifies the password for the user. If OSAuthentication is set to 1, leave this setting blank. User Info settings [User1] plaintextpassword=paolo17 Permissions=15 Username=maria Permissions The permissions option allows you to control the program features that a user can access. Minimally, you can set up a user who only is allowed to view reports. On the other end of the spectrum, you can give users Administrator rights which allows them to work with all profiles, view reports, create user accounts, modify program settings, and view status log and licensing information. The most that a nonadministrator may do is view reports and create, modify, and delete profiles. Because the Reporting Server translates the value you enter to hexadecimal, any combination of permissions is possible. The permissions in the following table correlate to the options in the User Information dialog. For example, a user with a permission level of 1 is given Administrator rights, allowing her complete access to the program. A user with a permission level of 15 is also given Administrator rights. The difference is in the way their permissions appear through the GUI, as shown in the following examples. 169

170 WebTrends Enterprise Reporting Server Permission Example: User Value of 1 This graphic shows a user with a permission level of 1. If you were to uncheck Administrator rights box, the user would be left with a permission level of 0. Permission Example: User Value of

171 Chapter 11. Running from the command line This graphic shows a user with a permission level of 15. If you were to uncheck Administrator rights box, the user would be left with a permission level of 14, still able to create, modify and delete profiles. Table 11-8 User Permissions settings Value Permission 0 view reports 2 create profiles 4 modify profiles 6 create and modify profiles 8 delete profiles 10 create and delete profiles 12 modify and delete profiles 14 create, modify and delete profiles 15 administrator, create, modify and delete profiles filter[n] The [filter] section specifies any filters that you want to include as defaults for the user. If you hide the Filters dialog from the user, the Reporting Server uses the filters you specify for every profile the user creates. See filterx on page 183 for details on defining filters. profile The [profile] section allows you to define default profile settings for this user. If you want to make creating profiles easier for the user, define the defaults you want them to use here. See profile settings on page 175 for details on defining profile settings. Tip: To make the profile interface even simpler and more secure, use the restrictions section to hide dialogs with settings you don t want this user to modify. restrictions The [restrictions] section specifies the profile dialogs to hide from the user and the maximum number of profiles the user can create. If a 171

172 WebTrends Enterprise Reporting Server dialog is hidden from the user, the Reporting Server uses the settings in the profile section in the analysis instead of the values in the.wlp file. Note: Restrictions only apply if the advanceduserenabled option is set to 1. Table 11-9 Restrictions settings Setting Example advanceduserenabled 1 1--Activates the options in the restrictions section. 0--The Reporting Server only reads the values in the userinfo section. hidedns true true--hides the DNS dialog from this user, and uses the value for the dnslookup option in the analysis. hidefilters false true--hides the Filters dialog from this user, and uses the values in the filter section for the analysis. false--allows the user to modify settings in the Filters dialog. hidehome false true--hides the Home dialog from this user, and uses the value for the homepagedefaults and the homepagebasedir settings in the analysis. hidelistservers true true--hides the List of Servers dialog from this user and uses the values in the server section for the analysis. false--allows the user to modify settings in the List of Servers dialog. hidelogfile true true--hides the Log File Paths dialog from this user and uses the logfilepath and logfileformat values. false--allows the user to modify settings in the Log File Path dialog. hidereportdata true true--hides the Database Directory dialog from this user and uses the datadir value. false--allows the user to modify settings in the Database Directory dialog. hidereportdest true 172

173 Chapter 11. Running from the command line Setting Example true--hides the Report Paths dialog from this user and uses the reportdir and reporturl values. false--allows the user to modify settings in the Database Directory dialog. Note: This value is only read of the webservermode is set to "other." hidereporthist false true--hides the Reports dialog from this user and uses the weeklyreport, monthlyreport, quarterlyreport, and yearlyreport settings. false--allows the user to modify settings in the Reports dialog. hidereporttype true--hides the Report Template dialog from this user and uses the reportfile option. false--allows the user to modify settings in the Report Template dialog. Note: Report template files have a.wct extension and are located in the wtm_wtx directory. hidescheduler false true--hides the Report Scheduler dialog from this user and uses the period and starttime values. false--allows the user to modify settings in the Report Scheduler dialog. hidetype true true--hides the Site Configuration dialog from this user and uses the value from the isservercluster option. false--allows the user to modify settings in the Site Configuration dialog. maxprofiles 10 Specifies the number of profiles that the user can create. maxprofilesenabled 1 1--Reads the value of the maxprofiles option, limiting the number of profiles that this user can create. 0--Any value specified in the maxprofiles option is ignored. No limit is imposed. 173

174 WebTrends Enterprise Reporting Server Restrictions settings [restrictions] advanceduserenabled = 1 maxprofilesenabled = 0 maxprofiles = 120 hidetype = false hidereportdest = true hidereporthist = true hidereportdata = true hidereporttype = true hidelogfile = false hidelistservers = false hidehome = false hidedns = true hidescheduler = true hidefilters = false Working with profiles Note: By default, the settings for each profile are stored in the./ wtm_wtx/datafiles/profiles directory. Profiles have a.wlp extension. Note: The Reporting Server provides a sample profile, sample.wlp. server[n] If you purchased a Server Add-On, you can report on activity for web sites that reside on multiple servers (including server clusters). The [server[n]] section defines the name and the location of the log files for each server. If you are reporting on multiple servers, create a server[n] section for each server that hosts your web site. Note: If you are reporting on a single server, leave this section blank. 174

175 Chapter 11. Running from the command line Note: See Installing Add-Ons on page 31 for more information on Server Add-Ons. Table Server settings Server setting Example servername brazil Specifies the name for this server. logfilepath[n] /wtm_wtx/datfiles/samples/ctsample1.log Specifies the path to the log file. profile settings The settings in this section define the location of the log file on which you are reporting, and how the data in the log file should be analyzed and reported on. Note: If a value is left blank, the default defined in the wtm_wtx.ini file is used. Table Profile Settings Profile settings Example version version 2.0 Specifies the version number of the program. Do not modify this setting. description sample_log_analysis Specifies the name for the profile which is used to identify the profile in the user interface and as a heading for the report. Enter a string. processingtype 1 Specifies whether to analyze the entire log file or to analyze the log file beginning with the date specified for the startprocessingat option. 0--All dates in the log file are analyzed. 1--The log file is analyzed from the date specified in the startprocessingat option to the end. startprocessingat

176 WebTrends Enterprise Reporting Server Profile settings Example If processingtype is 1, the log file is analyzed beginning with the date specified here. Enter a date in yyyy/mm/dd format. IsServerCluster 1 Specifies whether the web site resides on a single server or on multiple servers. 0--Use if the site is hosted on one server. 1--Use if the site resides on multiple servers. users anonymous Comma-delimited list of users who have access to the profile. To allow users to view the profile publicly, without a username or password, enter "anonymous" here. logfilepath./wtm_wtx/datfiles/samples/sample.log Specifies the path to the log file to be analyzed. Enter./ to specify a path relative to the program installation directory. Note: If the IsServerCluster option is set to 1, this value is not read. homepagedefaults default.htm default.html index.htm index.html default.asp Specifies the pages that the web server defaults to when a visitor requests a URL without a specific page. Separate multiple pages with a space. homepagebasedir file:///../samples/ Specifies the URL of the root of the web site. dailyreport false true--generates a daily report for this profile. false--the daily report is not generated for this profile. datadir./wtm_wtx/datfiles/databases Specifies the directory for profile databases. Note: If you modify the directory, the Reporting Server reanalyzes the log file from the beginning to rebuild the database. This is because the original database remains in the old location. debuglevel 5 Specifies the degree of verbosity when debugging the profile. Enter a value from A value of 10 provides the greatest detail. deleted false true--marks the file for deletion. false--the file will not be deleted. 176

177 Chapter 11. Running from the command line Profile settings Example disabled false Allows you to disable or enable the profile. true--suspends any new analysis. The profile can still be used (modified or viewed) and completed reports are still accessible through the Report Viewer. false--enables the profile for analysis and reporting. enablearchives 1 Allows you to enable or disable archiving for this profile. 0--Disables archiving by default. 1--Enables archiving by default. dnslookup 0 Specifies the method of DNS lookup to use. 0--Disables DNS lookup and maintain the user data as it appears in the log file. 1--Attempts to translate all IPs to domain names. 2--If you do not know the format of the log and want to turn DNS lookup on. Until a domain is found in the log, WebTrends attempts to translate all IPs. logfileformat 1 Specifies the format of the log file. Enter a value of See Log file Format Parameters on page 180 for details. Note: In most instances, you should select 0 and let the Reporting Server automatically detect the format of the log. monthlyreport true true--generates a monthly report for this profile. false--the monthly report is not generated. period 30 Defines the repeat interval for analyzing the log file and creating the report. Enter the number of minutes. quarterlyreport false true--generates a quarterly report for this profile. false--the quarterly report is not generated. reportdir /hosting/server2/reports/%profile%.wlp If webservermode is set to other, this option defines the directory path where reports for this profile are saved. Note: If you modify the report directory, only new reports appear in the new directory. Reports created before the change remain in the original location. 177

178 WebTrends Enterprise Reporting Server Profile settings Example reportfile report.wct Specifies the report template to use for this profile. Note: Report template files have a.wct extension and are located in the wtm_wtx directory. reporturl %PROFILE%/index.html If webservermode option in wtm_wtx.ini is set to other, this option defines the URL to the report index html file. starttime 12:00 Specifies the start time of an analysis and reporting cycle in hh:mm. Enter a value from 00:00-23:59. If the schedoverride option is set to true, this value is used as the default which users can change on a profile basis. threadedreports true true--generates reports concurrently with analysis. false--suspends analysis while reports are generated. weeklyreport true true--generates a weekly report for this profile. false--the weekly report is not generated. wtreportdir./wtm_wtx/reports/%profile%.wlp Do not change this value. If webservermode is set to webtrends, this option defines the directory where reports for this profile are saved. Note: The reports directory refers to a mapped directory for security purposes. wtreporturl %PROFILE%/index.html If webservermode is set to webtrends, this option defines the URL to the report index html file. Note: The reports directory is case-sensitive. This is because requests to the report directory are sent to a mapped directory above the web server. yearlyreport false true--generates a yearly report. false--the yearly report is not generated. IncludeContentGroups 178

179 Chapter 11. Running from the command line Profile settings Example Because Content Group definitions are global settings that can be referenced in multiple profiles, each definition is assigned a unique identifier. To specify a definition for this profile, enter the unique id here. Separate multiple identifiers with a space. Use an asterisk (*) to specify all Content Group definitions. The unique id is defined in the ProfileID option which is in the default.ini file in <InstallDir>/wtm_wtx/datfiles/contentgroups IncludeQueries Because URL Parameter Analysis definitions are global settings that can be referenced in multiple profiles, each definition is assigned a unique identifier. To specify a definition for this profile, enter the unique id here. Separate multiple identifiers with a space. Use an asterisk (*) to specify all URL Parameter Analysis definitions. The unique id is defined in the ProfileID option which is in the default.ini file in <InstallDir>/wtm_wtx/datfiles/dynamicpages IncludeURLReplacement s Because URL Search and Replace definitions are global settings that can be referenced in multiple profiles, each definition is assigned a unique identifier. To specify a definition for this profile, enter the unique id here. Separate multiple identifiers with a space. Use an asterisk (*) to specify all URL Search and Replace definitions. The unique id is defined in the ProfileID option which is in the default.ini file in <InstallDir>/wtm_wtx/datfiles/urlreplacement IncludePathsAnalysisP rofiles Because Path Analysis definitions are global settings that can be referenced in multiple profiles, each definition is assigned a unique identifier. To specify a definition for this profile, enter the unique id here. Separate multiple identifiers with a space. Use an asterisk (*) to specify all Path Analysis definitions. The unique id is defined in the ProfileID option which is in the default.ini file in <InstallDir>/wtm_wtx/datfiles/pathsanalysis tempdir./wtm_wtx/datfiles/databases/ %PROFILE%/.logtmp Specifies the directory location where zipped log files are unzipped. 179

180 WebTrends Enterprise Reporting Server Table Log file Format Parameters A value of Specifies this format 0 Auto-detect log file type 1 Apache Extended Format 2 CerfNet 3 CERN Common 4 Emwac log format 5 Lotus Domino 6 IBM Intenet Connection Secure Server 7 Microsoft IIS 1.x, 2.x, 3.x. 8 Microsoft IIS US date format 9 Microsoft IIS European Date Format 10 Microsoft IIS Japanese Date Format 11 Microsoft IIS Extended 12 Microsoft Extended + Cookies 13 Microsoft IIS Virtual 14 NCSA Combined/Extended 15 NCSA Combined Multihome 16 NCSA Common 17 NCSA Common Multihome 19 Netscape Combined 20 Netscape Common 21 Netscape NSAPI Extended 23 Novell Web Server 24 Open Market Extended 25 Oracle Log Format 26 Other Common 27 Other Extended 28 Purveyor Extended 29 Purveyor Multi-home 30 Spry Log format 31 Web site combined multi-homed format 32 Web site common multi-homed format 180

181 Chapter 11. Running from the command line A value of Specifies this format 33 Web site Windows log file format 34 Web site Windows US date format 35 Web site Windows European date format 36 Web site Windows Japanese date format 181

182 WebTrends Enterprise Reporting Server Profile settings [server1] servername = Server 1 logfilepath1=./wtm_wtx/datfiles/samples/ctsample1.log [server2] servername = Server 2 logfilepath1 =../wtm_wtx/datfiles/samples/ctsample2.log [Profile] Version=4 Description=Sample Cluster Log Analysis I IsServerCluster = 1users = maria,anonymous logfilepath =./wtm_wtx/datfiles/samples/sample.log homepagedefaults = default.htm default.html index.htm index.html default.asp homepagebasedir = / dailyreport = datadir = debuglevel = deferredreports = deleted = false disabled = dnslookup = 2 homepagepassword = homepageusername = logfileformat = monthlyreport = false period = profilename = quarterlyreport = reportdir = reportfile = Advertising Summary.wct reporturl = starttime = threadedreports = weeklyreport = false wtreportdir = wtreporturl = yearlyreport = false monthlydata = false weeklydata = false yearlydata = false 182

183 Chapter 11. Running from the command line filterx You can apply filters to profiles for more focused reports. Filters specify the data in the log file that you want to be analyzed. Table Filter settings Filter settings name Specifies a name for the filter. This is how the filter is identified in the user interface. Enter a string. filtertype Specifies the function of the filter. include--analyzes only data that matches the settings in this section. exclude--analyzes all log file data but the data that you specify. defaultoveride 1--Ignores the values defined in this section. 0--Uses them. returncodes Use the Return Code filter to specify the types of results you want to include or exclude. For example, if you want to only report on successful hits, enter the codes for successful requests ( ) The default, which includes all return codes in the analysis, is indicated by the asterisk (*). Note: Separate multiple entries with a space. returncodesenabled 1--Uses the value of the returncodes option in the analysis. 0--Ignores it. users Use the Users filter to include or exclude hits coming from specific domains, subnets, or IP addresses from the results of this profile. For example, you can create a filter that excludes all activity from your own domain. Use wildcards to specify a set of IPs. The default, which includes all IPs in the analysis, is indicated by an asterisk (*). usersenabled 183

184 WebTrends Enterprise Reporting Server Filter settings Setting this value to 1 uses the value of the users option in the analysis. Setting this value to 0 ignores the users value. multihomedomain If your log file contains entries for more than one web site, you can use this option to report on activity for a single site. For example, if your multihomed log file contains activity from domains and and you want to report only on and you would specify include as the filtertype and for the multihomedomain value. Note: This filter only applies to multi-homed log files. Note: Use this filter to filter domains visited, not domains where users are coming from. multihomedomainenabled 1--Uses the value of the users option in the analysis. 0--Ignores the users value. directory Use this option to filter the activity of a specific directory by entering the directory path here. The default for an include directory filter is to view all directories starting at the root, indicated by a slash (/). There is no default for an exclude directory filter. Note: Use quotation marks around directories containing spaces or commas. includesubdirs 1--Filters the subdirectories of the directory specified in the directory option. The default for both include and exclude filters is to filter all subdirectories. Therefore, if you created an exclude filter for a directory, WebTrends automatically excludes the subdirectories. If you created an include filter for a directory, WebTrends automatically includes the subdirectories. 0--Sub-directories are not filtered. directorycasesensitive 1--Makes the directory option case-sensitive. 0--Not case-sensitive. directoryenabled 184

185 Chapter 11. Running from the command line Filter settings 1--Uses the value of the directory option in the analysis. 0--Ignores it. files Use this option to filter specific files. Enter the file name or extension in this field. The default for an include files filter is to include all files, indicated by *.* in the field. There is no default for an exclude filter. filescasesensitive 1--Makes the files option case-sensitive. 0--Not case-sensitive. includedefaultpages 1--Includes requests for the file that are submitted without the file name. 0--Default pages are not included in the file filter. filesenabled 1--Uses the value of the files option in the analysis. 0--Ignores it. referrer The referrer filter helps you analyze the number and quality of users coming to your site from other sites or from a specific Internet advertisement link. Referrer entries should begin with a * prefix, and unless you mean only the exact string entered, you should also include an ending * also. The default for the referrer include filter, all referrers, filters all hits with referring data regardless of site. The default for the referrer exclude filter, no referrers, filters only hits without any referring information. A filter entry of filters any hits prefixed by referrerenabled 1--Uses the value of the referrer option in the analysis. 0--Ignores it. adclick Use the adclick option to filter an advertisement click defined in the adview.txt file. adview Use the adview option to filter an advertisement view. adsenabled 185

186 WebTrends Enterprise Reporting Server Filter settings 1--Uses the value of the adclick or adview options in the analysis. 0--Ignores it. searchkeywords This option is not used. searchkeywordsenabled This option is not used. username If you have an Intranet or a web site that requires visitors to log on with a username and password, you can use the username option to filter activity based on authenticated user data. Enter the username to filter. usernamecasesensitive 1--Makes the username option case-sensitive. 0--Not case-sensitive. usernameall 1--Filters all data containing an authenticated username. In an include filter, only data containing an authenticated username is included in the analysis. In an exclude filter, all data containing an authenticated username is excluded from the analysis. 0--Only the usernames specified in the username option are filtered. usernameenabled 1--Uses the value of the username option in the analysis. 0--Ignores it. browser Use the browser option to filter hits from a specific browser, spider or robot. Enter the browser as it appears in the agent field of the log file. Note: Because WebTrends looks for the filter text anywhere in the agent field of the log record, any wildcards (* or?) you enter are ignored. Note: Filtering for Netscape Navigator may not return accurate results because many browsers identify themselves as Netscape Navigator. browserenabled Setting this value to 1 uses the value of the browser option in the analysis. Setting this value to 0 ignores the browser value. days 186

187 Chapter 11. Running from the command line Filter settings Use the days option to filter days of the week. Separate your entries using spaces. Monday =1 Tuesday =2 Wednesday =3 Thursday =4 Friday =5 Saturday =6 Sunday =0 daysenabled Setting this value to 1 uses the value of the days option in the analysis. Setting this value to 0 ignores the days value. hourbegin To filter the log by time of day, enter the start range here. Enter the time using 24 hour format. hourend To filter by time of day, enter the end range here. Enter the time using 24 hour format. hourall/none If you are creating a filter type of include, setting this value to 1 includes all hours of the day in the analysis. If you are creating a filter type of exclude, setting this value to 1 excludes all hours of the day. If you are filtering for hours of the day, this option should be set to 0. hourenabled Setting this value to 1 uses the value of the hourbegin and hourend options in the analysis. Setting this value to 0 ignores the hourbegin and hourend values. entrypage To filter the analysis for user sessions based upon the first page a user viewed. An entry page is the first item that the user requests in a session. The item could be an image, a document, or a file. For example, entering /browser.htm filters any session starting at browser.htm in the root directory. entrypageenabled 187

188 WebTrends Enterprise Reporting Server Filter settings Setting this value to 1 uses the value of the entrypage option in the analysis. Setting this value to 0 ignores it. entrypagecasesensitive Setting this value to 1 makes the entrypage option case-sensitive. For your filter to be used, the log file data must match the case of the filter. 188

189 Chapter 11. Running from the command line Filter settings name = New Download filtertype = include defaultoveride = 1 returncodes = 200 returncodesenabled = 1 users = * usersenabled = 0 multihomedomain = * multihomedomainenabled = 0 directory = /downloads includesubdirs = 1 directorycasesensitive = 1 directoryenabled = 1 files = *.new* filescasesensitive = 0 includedefaultpages = 0 filesenabled = 1 referrer = * referrerenabled = 0 adclick = * adview = * adsenabled = 0 searchkeywords = * searchkeywordsenabled = 0 username = * usernamecasesensitive = 0 usernameall = 0 usernameenabled = 0 browser = * browserenabled = 0 days = 6 7 daysenabled = 1 hourbegin = 8 hourend = 17 hourall/none = 0 hourenabled = 1 entrypage= entrypageenabled=0 entrypagecasesensitive=0 189

190 WebTrends Enterprise Reporting Server Working with Content Groups The default.ini file in the contentgroups directory contains settings for the Content Groups feature. See Creating content groups on page 129 for an overview. Default Content Group settings The default section specifies the number of Content Group definitions. Table Default Content Group settings Default setting Default ContentGroupProfileCount NA Specifies the number of Content Group definitions in this file. For example, if the file contains six definitions, enter 6 here. Content Group defintion settings The settings for each Content Group are defined in the ContentGroupProfile[n] section. Name the first definition ContentGroupProfile0, and increment subsequent definitions by 1. Table ContentGroupProfile settings Conent Group Setting Example MatchString[n] MatchString1 Specifies the URL pattern to match. Log file records that match this string are reported on as this group. Increment each pattern by 1. PageType 4 This option must be set to 4. ProfileID 2mGbS4IrCR4 Specifies the unique id to identify this definition in the profile file or in the wtm_wtx.ini file. It can be created automatically through the UI or can created by you manually. ProfileName Intranet Specifies the name of the definition. ProfileVersion 1 This option is used by the analysis engine and should always be set to

191 Chapter 11. Running from the command line Content Groups default.ini [Default] ContentGroupProfileCount = 6 [ContentGroupProfile0] MatchString0 = /loganalyzer PageType = 4 ProfileID = 2mGbS4IrCR4 ProfileName = Intranet ProfileVersion = 1 [ContentGroupProfile1] MatchString0 = /prosuite PageType = 4 ProfileID = ODVwHKirCR4 ProfileName = Pro Suite pages (sample) ProfileVersion = 1 [ContentGroupProfile2] MatchString0 = /enterprise PageType = 4 ProfileID = Yn1I8MjrCR4 ProfileName = Enterprise pages (sample) ProfileVersion = 1... Working with Path Analysis settings The default.ini file in the pathsanalysis directory contains settings for the Path Analysis definitions. See Defining paths to analyze on page 127 for details. Default Path Analysis settings The default section specifies the number of Path Analysis definitions. Table Default Path Analysis settings Default setting Default PathsAnalysisProfileCount NA Specifies the number of Path Analysis definitions in this file. For example, if the file contains six definitions, enter 6 here. 191

192 WebTrends Enterprise Reporting Server Path Analysis definition settings The settings for each Path Analysis definition are configured in the pathanalysisprofile[n] sections. Name the first definition PathsAnalysisProfile0 and increment subsequent defintions by 1. Table pathanalysisprofile settings Path analysis settings Example root /products/promotion.asp Specifies the page that you want to track. depth 5 Specifies the depth of the path analysis. For example, a value of 5 tracks the 5 pages that visitors went to from the specified page. profileid a Specifies the unique id required to identify the definition in the profile file or the wtm_wtx.ini file. This value is generated automatically for definitions created through the UI, but you can assign it yourself for definitions that are created manually. pagetype 4 This option must be set to 4. profileversion 1 This option is used by the analysis engine and should always be set to 1. maxtableentries 1000 Specifies the maximum number of paths that you want to track. Enter a value between 1000 and profilename Path from the promotions page Specifies the name that identifies the definition in the UI. Enter a string. Working with URL Parameter Analysis settings The default.ini file in the dynamicpages directory contains settings for the URL Parameter Analysis definitions.see Analyzing activity for a dynamic site on page 130 for an overview. Default URL Parameter Analysis settings The default section specifies the number of URL Parameter Analysis definitions. 192

193 Chapter 11. Running from the command line Table Default URL Parameter Analysis settings Default setting Example QueryProfileCount 2 Specifies the number of URL Parameter Analysis definitions in this file. For example, if the file contains two definitions, enter 2 here. URL Parameter Analysis definition settings The settings for each URL Parameter Analysis definition are configured in the QueryProfile[n] sections. Name the first definition QueryProfile0,and increment subsequent defintions by 1. Table QueryProfile settings Query profile settings Example page /download.asp Specifies the page that you want to track for this definition. profileid J6QCcdSvCR4 Specifies the unique id required to identify the definition in the profile file or the wtm_wtx.ini file. This value is generated automatically for definitions created through the UI, but you can assign it yourself for definitions that are created manually. mapfile..\datfiles\dynamicpages\solutions.txt Specifies the file path to the translation file relative to the Reporting Server installation directory. See Creating translation files on page 131 for an overview. pagetype 4 This option must be set to 4. parameter products Specifies the parameter that you want to track in this definition. profilename Product Downloads (Sample) Specifies the definition name which identifies it in the UI. profileversion 1 This option is used by the analysis engine and should always be set to

194 WebTrends Enterprise Reporting Server Working with URL Search and Replace definitions The default.ini file in the urlreplacement directory contains settings for the URL Search and Replace definitions. See URL search and replace on page 123 for an overview. Default URL Search and Replace settings The default section specifies the number of URL Search and Replace definitions. Table Default URL Search and Replace settings Default setting Example urlreplacementrofilecount 2 Specifies the number of URL Replacement definitions in this file. For example, if the file contains two definitions, enter 2 here. URL Replacement definition settings The settings for each URL Replacement definition are configured in the urlreplacementprofile[n] sections. Name the first definition urlreplacementprofile0 and increment subsequent defintions by 1. Table URL replacement settings URL Replacement setting Example profilename Shopping Cart Example The definition name which identifies it in the UI. profileid a Specifies the unique id required to identify the definition in the profile file or the wtm_wtx.ini file. This value is generated automatically for definitions created through the UI, but you can assign it yourself for definitions that are created manually. pagetype 4 This option must be set to 4. trailermatchtype startofnext 194

195 Chapter 11. Running from the command line URL Replacement setting Example Specifies the method to signal the beginning of the replacement. startofstringpattern--replaces the text beginning with the start of the URL. startoffirstpattern--replaces from the beginning of the first occurrence of text specified. startoflastpattern--replaces from the beginning of the last occurrence of text specified. endoffirstpattern--replaces from the end of the first occurrence of the text specified. endoflastpattern--replaces from the end of the last occurrence of the text specified. leadinstring? The character or string that signals the beginning of the text to be replaced. Separate multiple strings with a pipe ( ). usegatestring N Allows you to specify text that must be present for the replacement to be made. N--The value of the gatestring option is not read. Y--The value of the gatestring option is read, and the replacement is performed only if the text specified appears in the URL. gatestring order The URL must contain the text specified in order to make the replacement. leadinmatchtype endoffirstpattern Specifies the method to use to signal the end of the replacement. startofnext--ends the replacement before and not including, the character specified in the trailerstring option. endofnext--ends the replacement with, and including, the character specified in the trailerstring option. endofstring--ends the replacement at the end of the URL. trailerstring ; The text that signals the end of the text you want to replace. replacementstring 1234 Specifies the text to use in place of the string you want to remove. usetotracksession Y Allows you to use the text that was replaced to track user sessions rather than an IP, username, or cookie. profileversion 1 This option is used by the analysis engine and should always be set to

196 WebTrends Enterprise Reporting Server Working with report templates Change the colors, fonts, logo used in reports through the style.ini. The style.ini contains a set of fifteen pre-defined report templates which you can modify. You can also create your own report templates to use. WebTrends report template This section contains a list of any available report templates. Style <x> = [style name] Style X defines the number assigned to the report template. [style name] specifies a description for the title. Each [style name] has a corresponding section that define the values for the report template. WebTrends styles settings Style 1=(Default) Style 2=(Default-Long Descriptions) Style 3=(Default-Watermark) Style 4=Arizona Style 5=Billy s Windows Style 6=Bricks & Sand Style 7=Eggplant Garden Style 8=Motif Style 9=Oregon Evergreen Style 10=Rainy Day Style 11=Stars & Stripes Style 12=Thunder Storm Style 13=Vegas Neon Style 14=Wild Rose Style 15=Yowee Banana Table Style Name settings Style Name Settings Description Page Background Color Specifies the color to use for the report background. Page Text Color Specifies the color to use for the main report headers. Section Background Color Each section of the report contains a header. This option defines the background color for the header. 196

197 Chapter 11. Running from the command line Style Name Settings Description Section Text Color Specifies the color to use for the section heading text. Title Background Color Each table contains a table title. This value defines the background color for the table title. Title Text Color Specifies the color to use for the text in the table title. Sub Title Background Color Tables may contain a sub-title. This value defines the background color for the sub-title. Sub Title Text Color Specifies the color to use for sub-titles. Odd Row Background Specifies the color to use for odd numbered rows (for example, the first, third and fifth rows). Odd Row Text Color Specifies the color to use for the text in odd numbered rows. Even Row Background Color Specifies the color to use for even numbered rows (for example, the second, fourth, and sixth rows). Even Row Text Color Specifies the color to use for the text in even numbered rows. Standard Font Specifies the font to use for the main report heading and the report descriptions. Section Font Specifies the font to use for section title text. Sub Title Font Specifies the font to use for table sub-titles. Table Data Font Specifies the font to use for the table body text. Background Filename 197

198 WebTrends Enterprise Reporting Server Style Name Settings Description Specifies the file to use for the background. Logo Filename By default the WebTrends logo appears in the footer of the report. To specify a different.gif file to use, enter the path to the file here. Table Columns The setting is not currently used. Sort By Specifies the sorting order for the table data. A value of 0 sorts the table by hits, 1 sorts by % of hits, and 2 sorts by user sessions. Number Alignment Specifies how the report data is aligned within the column. Enter left to line the numbers with the left side of the column, center to place them in the middle, and right to line them up with the right side of the column. Frame Page This setting is always set to 1. It includes the Table of Contents frame for HTML reports. Frame Width Specifies the width of the Table of Contents frame. Long Description Setting this value to 1 includes detailed descriptions in the report. A value of 0 includes only short descriptions. TOC Width The width of the Table of Contents frame is expressed as a percentage. For example, to make the table of contents 15% of the entire width of the report, enter 15 here. 198

199 Chapter 11. Running from the command line <style name> settings Page Background Color=FFFFFF Page Text Color= Section Background Color= Section Text Color=FFFFFF Title Background Color=FFDD00 Title Text Color= Sub Title Background Color=D0D0D0 Sub Title Text Color= Odd Row Background Color=F0F0F0 Odd Row Text Color= Even Row Background Color=FFFFFF Even Row Text Color= Standard Font=verdana,lucida,arial Section Font=verdana,lucida,arial Title Font=verdana,lucida,arial Sub Title Font=verdana,lucida,arial Table Data Font=verdana,lucida,arial Background Filename= Logo Filename=wtlogoss.gif Table Columns=012 Sort By=0 Number Alignment=CENTER Frame Page=1 Frame Width=1 Long Description=0 TOC Width=20 Defining advertisements to track You can set up advertisements that you want to track in the adviews.txt file. The adviews.txt file allows you to configure the Ad Views and Clicks feature. With Ad Views and Clicks feature, you can determine the number of visitors to your web site who view or click on a particular ad. Additionally, WebTrends includes an Advertising filter with which you can profile a specific advertisement s traffic patterns (i.e., busiest time of the day, day of the week) as well as demographic information (i.e. top viewing/clicking organizations, country of origin). 199

200 WebTrends Enterprise Reporting Server Ad views and ad clicks syntax Enter your advertisement in the following format: "<ad view file name>","<ad click id string>","<description>" ad views and clicks "IBM_AD.GIF","/cgi-bin/IBM_AD.PL","IBM Laptop Ad" Setting up your intranet domains The wtintra.txt allows you to define areas of your intranet or other domain s by department, city, state or even individual workstations. The data is automatically included in reports. Use the following syntax: <IntranetDomain>,<Description>,<City>,<State/ Province>,<Country>,<IPAddress/Pattern/Subnet> where: <IntranetDomain>--Specifies the domain name of the department or division of your organization (i.e., marketing.company.com) that you want to include in the report. <Description>--The descriptive name of the organization or department as you want it to appear in your reports. <City>--Specifies the city associated with this domain. <State/Province>--Select the state or province associated with this domain. <Country>--Select the country associated with this domain. <IPAddress/Pattern/Subnet>--Enter the IP address, IP range, domain name or Subnet, as it is recorded in your web server log file. Note:You can also specify a subnet mask using CIDR format. For example, /26 where /26 indicates the number of bits used to identify the network. 200

201 Chapter 11. Running from the command line Sample wtintra.txt acme.edu,acme training Center,Los Angeles,CA,US,acme.edu Bill.acme.org,Bill Johnson (Technical sales),orlando,fl,us,*.westworld.com canada.acme.ca,acme International (Canada),Toronto,Ontario,CA,*.acme.ca Modifying search engines Use the keywords.ini to modify the search engines included in reports. SearchEngines The [SearchEngines] section lists the search engines defined. Note: The search engine list is read from the top to bottom. Keep the order in mind when creating sections for similar domains. Table SearchEngines settings SearchEngine setting Engine[n] Description Specifies the search engine defined. Engine definitions are incremented by 1, begining with Engine1. Engine settings The Engine[n] sections define the string for the search engine and the indicator used to signal search keywords. 201

202 WebTrends Enterprise Reporting Server Table Engine settings Engine settings id[n] KeywordIndicator[n] Description Specifies the string used to identify the search engine in the log file. Any matches to the key field are report as a hit for this engine. For example, by default, any Yahoo search engine (yahoo.fr, yahoo.de) is reported simply as Yahoo. If you wanted to report on yahoo.fr and yahoo.de separately, you create an entry for each for example, engine[n]=yahoo france, and for the key enter id1=yahoo.fr. Specifies the strings that immediately precede the search phrases. Include as much of the string needed to make it unique. 202

203 Chapter 11. Running from the command line Keywords.ini [SearchEngines] Engine1=Yahoo Engine2=Excite [Yahoo] ID1=yahoo.com ID2=yahoo.com.sg ID3=yahoo.ca ID4=search.chinese.yahoo.com ID5=yahoo.dk ID6=yahoo.fr ID7=yahoo.de ID8=ink.yahoo.it ID9=yahoo.no ID10=yahoo.se ID11=yahoo.co.uk ID12=ink.yahoo.com ID13=yahoo.co.jp ID14=yahoo.co.kr KeywordIndicator1=?p= KeywordIndicator2=&p= [Excite] ID1=excite.com ID2=excite.de ID3=excite.co.jp ID4=excite.co.uk KeywordIndicator1=?search= KeywordIndicator2=&search= KeywordIndicator3=?s= KeywordIndicator4=&s= 203

205 Appendix A. Glossary This section provides definitions of terms used throughout WebTrends and for common Internet terminology. Term Ad Ad Click Ad View Authenticated User Browser Click Stream Click Through Client Client Errors Combined Log File (Format) Common Log File (Format) Company Database Content (Report) Definition A graphic or a banner on a web page that when clicked on, takes the visitor to another site. Refers to a visitor on a web site clicking on an ad. A web page that presents an ad. Once the visitor has viewed an ad, he/she can click on it (see Ad Click). There may be more than one ad on an ad view. A user whose identity is known through the verification of a username and/or password. A program used to locate and view HTML documents. Netscape, Mosaic, and Microsoft Internet Explorer are Web browser applications. The path that the user took within a particular web site indicating navigational patterns or popular pages. See Ad Click. The browser (see above) used by a visitor to a web site. An error occurring due to an invalid request by the visitor s browser. Client errors have codes in the 400 range. (See Return Codes. ) Two additional fields (Referrer and User Agent) are added to the Common Log File (see below) to create the Combined Log File. A log file format developed by NCSA which has become the standard logging format for most Web servers. The proprietary database installed and used by WebTrends to look up the company name, city, state and country corresponding to a specific domain name. Each time you generate a WebTrends report, you have the option to select the graphs and tables to include as well as the scope of each report item and the style of each graph. 205

206 WebTrends Enterprise Reporting Server Term Cookies DNS Cache DNS Lookup Domain Name Domain Name Lookup (DNS Lookup) Filters FTP Hit Home Page URL HTML HTTP Definition Persistent Client-State HTTP Cookies are files containing information about visitors to a web site (e.g., user name and preferences). This information is provided by the user during the first visit to a Web server. The server records this information in a text file and stores this file on the visitor s hard drive. When the visitor accesses the same web site again, the server looks for the cookie and configures itself based on the information provided. WebTrends maintains a DNS cache to speed IP address conversion and report generation. The range supported is from 1,000 to 250,000 entries; each entry requires 8 bytes of memory. See Domain Name Lookup. The text name corresponding to the numeric IP address of a computer on the Internet (e.g., The process of converting a numeric IP address into a text name (for example, is converted to A means of narrowing the scope of a report or view by specifying ranges or types of data to include in or exclude. File Transfer Protocol is a standard method of sending files between computers over the Internet. An action on the Web server, such as when a user views a page or downloads a file. Note: The Number of Hits in WebTrends reports indicates the number of times that item was requested, whereas User Sessions specifies the number of sessions (regardless of the number of times within a particular session) the item was requested. The local path or Internet URL to the default page of the web site for which the report is being generated. Hyper Text Markup Language is used to write documents for the World Wide Web that specify hypertext links between related objects and documents. Hyper Text Transfer Protocol is a standard method of transferring data between a Web server and a Web browser. 206

207 Appendix A. Glossary Term Impression Internet Domain IP Address IP Resolution Log File Log File URL MAPI Multi-homed Domain Multi-homed Log File Multi-homed Web Server Multithreading Platform Plug-In Profiles Protocol Definition See View. See Domain Name. The Internet Protocol Address identifies a specific machine attached to the Internet. See Domain Name Lookup. A file created by a web or proxy server which contains all of the access information regarding the activity on that server. The local path or Internet URL for the log file to be used for the report. Mail Application Programming Interface is an industrywide standard which is usually the default method for accessing large mail systems like Microsoft Mail and cc:mail. The domain name or IP address of one of the sites in a multi-homed log file (see below). A single log file that contains the access information for multiple web sites. A single computer that is hosting more than one web site. See Threads. The operating system (Windows 95, Windows NT, Unix) used by a web site visitor. A software module that adds a specific function or service to another software program. For example, WebTrends plug-ins for Netscape and Microsoft servers allow these servers to save additional information in their log files. All analysis and reports are based on profiles. Profiles tell WebTrends how to analyze a web site, log file, or monitor a device. An established method of exchanging data over the Internet. 207

208 WebTrends Enterprise Reporting Server Term Proxy Server Referrer Remote Interface Report Return Code (Web Servers) Definition A proxy server is a server that acts as a go-between between an organization and the Internet. They serve to improve performance by filling a request directly rather than forwarding the user to the Internet if the necessary information is available. Proxy servers also serve to block unauthorized activity outgoing or incoming (referred to as firewalls ). The URL of an HTML page from which a visitor clicks to access your web site. The Reporting Server can be administered and configured remotely through a web browser installed on a workstation. Doing so allows you to run the Reporting Server through a graphical user interface. A document created by WebTrends to present in graphs and tables the result of its analysis. The return status of the request which specifies whether the transfer was successful and why. Possible Success codes are: 200 = Success: OK 201 = Success: Created 202 = Success: Accepted 203 = Success: Partial Information 204 = Success: No Response 300 = Success: Redirected 301 = Success: Moved 302 = Success: Found 303 = Success: New Method 304 = Success: Not Modified Possible Failed codes include: Client Errors: 400 = Failed: Bad Request 401 = Failed: Unauthorized 402 = Failed: Payment Required 403 = Failed: Forbidden 404 = Failed: Not Found Server Errors: 500 = Failed: Internal Error 501 = Failed: Not Implemented 502 = Failed: Overloaded Temporarily 503 = Failed: Gateway Timeout 208

209 Appendix A. Glossary Term Server Server Errors (Web Server) SMTP Telnet Threads URL URL Path User Address User Agent User Session View (Ad) View (Page) Visit Definition A computer that hosts information available to anyone accessing the Internet. An error occurring at the server. Web server errors have codes in the 500 range. (See Return Codes. ) Simple Mail Transfer Protocol: used by most Internet mail programs (Eudora and Netscape, for example). A telnet host allows you to log on and use the services provided there. Threads are the parts of a program that can run independently and concurrently. A multithreaded application can execute multiple threads at the same time to greatly enhance performance. Universal Resource Locator is a means of identifying an exact location on the Internet. (For example, is the URL which defines the use of HTTP to access the Web page Default.htm in the /html/info/ directory on the WebTrends Corporation Web server). As the previous example shows, a URL is comprised of four parts: Protocol Type (HTTP), Machine Name (webtrends.com), Directory Path (/html/info/) and File Name (default.htm). See URL. The domain name or IP address for the remote user/ visitor. The fields in an extended Web server log file indicating the browser and the platform used by a visitor. A session of activity (all hits) for one user of a web site. A unique user is determined by the IP address or cookie. By default, a user session is terminated when a user is inactive for more than 30 minutes. See General Web Log Analyzer Settings on page 108 for instructions on how to change the default setting. See also Ad View. Each request for a particular web page which is a means for selling advertising on a web site. Also referred to as an Impression or an Page View. See User Session 209

210 WebTrends Enterprise Reporting Server Term Wildcard Definition A wild card is a symbol or combination of symbols that stand for one or more characters. WebTrends filters support wildcards to make defining your filter easier. For example, image* might stand for all files that begin with image (image1, image2, image3). Similarly, image*.gif stands for all image files with a.gif extension (image1.gif, image2.gif). 210

211 Appendix B.Optimizing & Troubleshooting Investigating Errors The Reporting Server maintains several logs that may record information on program activity as a whole, the web server, and profile processing. If you are having a problem, these files might assist you. Using the wtrs.err file The wtrs.err file contains debug information related to the analysis engine. It contains information about connections to the server, the reports that have been generated, and general error messages. For example, if the server fails to start, look through this log. Using the wt.remote.err file The wt.remote.err file contains debug information related to Report Server s web server. It contains a record of actions that the server portion of the program has performed. Look in this log if there are problems with the server. Using the wtrs.audit file As an administrator, you should check the wtrs.audit file daily. It records the profiles that are active, connections made to the web server, and reports that are created. In addition, if dates are missing for a log file that is analyzed, the missing date is recorded here. Note: The wtrs.audit file name can be changed. See audit on page 142 for details. 211

212 WebTrends Enterprise Reporting Server Using the profile status log The profile status log focuses on the details of profile processing. This graphic shows several lines from one log. Jul :15:02: =-=-=-= Initializing profile =-=- =-= Jul :15:02: Reverse DNS disabled. Jul :15:03: 1 member(s) found in log list. Jul :15:03: 1 member(s), which have already been analyzed, have been removed from the log list. Jul :15:03: Logfile data is up to date -- no analysis required. Jul :15:03: Scheduling analysis of cluster s logfiles every 0 hour, 15 minutes. Jul :15:03: cluster s next analysis is Fri Jul 16 08:30: Jul :15:03: 1 member(s) found in log list. Jul :15:03: 1 member(s), which have already been analyzed, have been removed from the log list. Jul :15:03: Logfile data is up to date -- no analysis required. Jul :15:03: Creating summary report: \index.html Using these details, you can determine where in the process a problem occurred. Profile status logs are given the same name as the profile they are logging. They are located in the <InstallDir>/wtm_wtx/datfiles/ statuslogsdirectory. Tip: The debuglevel option determines the level of detail provided. Set it to 10 to get the most data. Profile status Jan :21:38: =-=-=-= Creating profile =-=-=-= Jan :21:38: 1 member(s) found in logfile list. Jan :21:38: Reverse DNS disabled. Jan :21:38: 1 member(s) remain to be analyzed: Jan :21:38: Using log file.\wtm_wtx\datfiles\samples\sample.log: Jan :21:40: Scheduling analysis of sample s logfiles every 0 hour, 15 minutes. 212

213 Appendix B. Troubleshooting Fixing Error 500 Server Error Error 500 Server Error states "An error occurred processing your request." This can happen if the Reporting Server daemon is not started by the same user who installed the program. For example, if user johns installed the Reporting Server, and he logs in as "superuser" rather than "johns" to start the daemon, he will get the 500 Server Error. To solve this problem, either change the uid setting in the wtm_wtx.ini file to uid=0, or give other write permissions to the install directory only. For example, if the install directory is wtrs, do chmod o+w wtrs. Note: It s best to start the server as the user who installed the Reporting Server. Setting uid to 0 or having it run as root exposes a security risk. Web server fails to initialize If the web server fails to initialize, the wt_remote.err may provide insight. Failure to initialize may be caused by trying to use a privileged port or one that is already used. Profiles fail to initialize There are several reasons why a profile might not initialize. First, look at the status log for the profile. It might indicate a problem in processing. Then consider the following possibilities: Are the log files in a supported format? Make the logs are not corrupt and that the log data is valid. Are you running a trial version of the Reporting Server? If you are and the trial period expired, check the dates of the log files that you are trying to run. The dates must be within the period of the trial. Can the Reporting Server find and write to the directories specified for databases? Can it access the statuslogs directory? The Reporting Server must be able to access the 213

214 WebTrends Enterprise Reporting Server directories specified for the reports database and the profile database. Conflicting file permissions If you have trouble running or saving a profile, or it appears to be missing, check your owner or group permissions. Typically, this occurs when a you install the product as one user and try to run it as another, or when you copy another user s profile. You might avoid this and other problems by running the Reporting Server as the user who installed it. Database location Reports that use data stored locally are generated more quickly than those that use data stored on another machine. Factors impacting space and memory Several factors affect total memory requirements: Number of concurrent analysis--the greater the number of analyses occurring at the same time, the greater the demands on memory. To conserve memory, decrease the number of concurrent analyses. See System performance on page 118 for details. Report queue size--the data needed to create pending reports must be saved. Once the reports are created, the data is released. Report maintained--to save disk space, only maintain reports for intervals that you need (daily, weekly, monthly). Set a limit on the number of reports that are maintained for each interval. See Reports on page 116 for more information. Reports tables used--to minimize the amount of memory used to created reports, only generate the tables and graphs that you need. Define which report sections are included through the Report Template dialog. See Customizing reports on page 96 for more information. DNS lookups -- the size of the DNS queue and the number of threads impact the memory used for DNS lookups. Refer to the Readme for more information. 214

215 Appendix B. Troubleshooting Logs retrieved using FTP--You ll need disk space to download the logs so they can be analyzed. If the log has already been downloaded once, you ll only need space for new activity. Connecting through the Remote Interface To run the Reporting Server through the GUI, connect using one of the following methods: Enter in the hostname followed by the port that the Reporting Server is running on. For example, server:1024 Enter the host IP address followed by the port that the Reporting Server is running on. For example, :1024 Enter "localhost" followed by the port number if the Reporting Server is installed locally. For example, localhost:1024 The browser treats each method of connecting as a separate realm. To log in as two different users in the same browser, use a different method to access the Reporting Server. If you are behind a firewall, make sure that the firewall allows access to the port where the Reporting Server is running. Problems creating a Microsoft Word report from Internet Explorer The first time that you create a Microsoft Word report, the Reporting Server downloads and installs the WebTrends Microsoft Word document utility. If the document utility fails to download, the security settings in Internet Explorer could be blocking the Active X control from running. To change IE security settings 1 Select View>Internet Options. 2 Select the Security tab. Dates for reports are unexpected If the log files don't include the GMT offset time (for example, +0000), the Reporting Server adjusts for the local time zone. For example, if you are reporting on data for August 5, 1999, but the reports show a 215

216 WebTrends Enterprise Reporting Server different date, you might check the log file for the GMT offset. Although log files vary, the GMT field looks something like or (where zeros are replaced with the offset for your time zone.) Special considerations for configuring the Reporting Server The configuration you design determines the speed and resources available for processing and publishing reports. This section discusses three approaches. Default configuration By default, the Reporting Server is configured to provide all the administration and publishing of reports on one machine. When the default configuration is used, the databases for reports and analysis are stored locally. This configuration results in the best reporting speed. The default configuration is shown here. Reporting Server Running Remote Interface Users profiles Running Reports Users databases reports Configuration implementing an alternate web server The Reporting Server may also be configured to delegate report publishing to another web server. Using an alternate web server rather than the built-in web server may relieve the burden of providing both the remote interface as well as the task of analyzing, producing, and posting reports. Even if another web server is configured to publish reports, the Reporting Server still provides the GUI. The following graphic shows this configuration. 216

217 Appendix B. Troubleshooting Reporting Server Running Remote Interface Administrator profiles Databases Other Web Server Running Reports Users Reports Using multiple web servers and storing results on another machine The Reporting Server can also be configured to use multiple web servers for reporting and to maintain databases on other machines. To implement this configuration, you would change both the default web server settings as well as the database directory setting. This configuration is shown here. 217

218 WebTrends Enterprise Reporting Server profiles Reporting Server Running Remote Interface Administrator Web Server Web Server User 1 Reports User 1 Databases User 2 Reports User 2 Databases 218

219 Index Index Symbols.usr files 168.wlp files 174 A about ad views and clicks 79 profiles 18 program interface 33 reports 18, 89 this manual 15 user accounts 133 WebTrends Reporting Server 16 activating cookies 108 Ad Click ID String 82 Ad View File Name 81 ad views and clicks 80 about 79 adding 80 deleting 83 description 81 editing 82 initialization files 199 tracking exit URLs 79 using 80 adclick setting 185 adding ad views and clicks 80 advertisement profile 83 content groups 129 filters 68 Intranet domain 86 intranet domains 86 path analysis definitions 127 report template styles 97 URL parameter analysis definition 130 URL search and replace definition 126 adsenabled setting 185 advanceduserenabled setting 172 advertising filter 76 tracking 80 adview setting 185 analyzing from a specified date 43 paths 127 archives global settings 143 archiving profile settings 43 restoring profiles 62 arpa_orgtype setting 147 audit settings 142 authenticated user filter 77 authentication 132, 165 authentication methods 167 auto mode DNS lookup 57 B Background Filename setting 197 browser defined 205 filter 76 filter examples 76 browser filter 76 examples 76 browser setting 186 browser toolbar 35 browserenabled setting 186 C cachedtime setting 149 changing user accounts 136 client defined 205 client errors defined 205 ClusterTrends profile settings 46 ClusterTrends Add-On profile setup 42 com_orgtype setting 147 combined log file defined

220 WebTrends Enterprise Reporting Server command line steps for using 141 commands syntax 141 common log file defined 210 company database 85 company database, defined 205 configuring the Reporting Server 216 content 205 report 100 content group definitions 190 content groups 129 profile settings 60 content, defined 205 ContentGroupProfileCount setting 190 cookie enable 144 settings 143 validate 144 cookies defined 206 option 108 profile settings 49 copying profiles 61 country of origin, in reports 106 country setting 154 creating Microsoft Word reports 95 new user accounts 133 D dailyreport setting 176 database directory option 114 database location profile settings 57 datadir setting 157, 176 datadiroverride setting 156 day filter 77 days setting 186 daysenabled setting 187 debuglevel setting 154, 176 default report template 115 reports report default for profiles 53, 116 defaultoveride setting 183 deferred reports setting 155 defining access rights 133 defining domain types 112 definitions server 209 deleted setting 176 deleting ad views and clicks 83 Intranet domain 88 profiles 62 depth setting 192 description ad views and clicks 81 description setting 175 directory filter 71 examples 72 directory for profile database 114 directory setting 184 directory structure 138 directorycasesensitive setting 184 directoryenabled setting 184 disabled setting 177 disabling profiles 44 DNS Cache defined 206 DNS cache size 103 DNS lookup analyzing without 56 auto mode 57 explained 55, 120 turning on 56 Web log analysis profile 55, 120 dns lookup options 120 dnscachelifespan setting 148 dnslookup setting 155, 177 dnsoverride setting 155 document file types modifying 110 documentation overview

221 Index documenttypes setting 149 domain name defined 206 domain name lookup defined 206 domain names changing groupings 112 domain settings 145 domain tab 112 Download File Extensions and Types 110 downloadtypes setting 148 dynamic pages and URL search and replace 123 including in reports 130 dynamic sites and URL parameter analysis 59 dynamic web pages, in reports 111 E editing ad views and clicks 82 Intranet domain 88 profiles 61 report template styles 101 edu_orgtype setting 145 elements for reports 100 enablearchives setting 177 entry page filter 75 entrypage setting 187 entrypagecasesensitive setting 188 entrypageenabled setting 187 error profile failed to initialize 44 errors interface log verbosity 166 ERSRetries 165 ERSTimout 165 Even Row Background Color setting 197 Even Row Text Color setting 197 examples browser filter 76 directory filter 72 file filter 73 hour filter 78 referrer filters 75 exclude filters explained 67 exit URLs tracking 79 F features 15 file extensions, adding or editing 111 file extensions, edit 110 file filter 73 examples 73 file name Ad View 81 file types, adding or editing 111 file types, edit 110 files setting 185 filescasesensitive setting 185 filesenabled setting 185 filtering 67 filters advertising 76 authenticated user 77 browser 76 country 70 creating 68 day 77 defaults 183 defined 206 directory filter 71 entry page 75 exclude filters 67 file filter 73 hour 78 include filters 67 IP address 70 multi-homed domain 71 multi-homed domain filter 71 overview 67 profile settings 49 referrer 74 return codes 69 settings 183 URL 71 user address

222 WebTrends Enterprise Reporting Server username 77 filtertype setting 183 formatting referrer filters 74 Frame Page setting 198 Frame Width setting 198 frequency for archving 143 FTP configuring proxy settings 121 defined 206 G gatestring setting 195 general options 103 WebTrends 103 gid 162, 167 gov_orgtype 146 graphs changing the size 100 modifying 100 H handles 162, 168 hidedns setting 172 hidefilters setting 172 hidehome setting 172 hidelistservers 172 hidelogfile setting 172 hidereportdata setting user hide database directory dialog 172 hidereportdest setting 172 hidereporthist setting 173 hidereporttype setting 173 hidescheduler setting 173 hidetype setting 173 histoverride setting 157 hit defined 206 home page URL defined 206 homepagebasedir setting 176 homepagedefaults setting 176 hour filter 78 examples 78 hourall/none setting 187 hourbegin setting 187 hourenabled setting 187 hourend setting 187 HTML defined 206 HTML titles in reports 103 HTTP defined 206 I ID String Ad Click 82 include filters explained 67 IncludeContentGroups 178 includedefaultpages setting 185 IncludePathsAnalysisProfiles 179 IncludeQueries 179 includesubdirs setting 184 IncludeURLReplacements 179 int_orgtype 145 interface log file 166 port port web server 166 retries 165 timeout 165 user timeout 166 using 33 interface settings 165 international options 105 Internet advertising tracking 80 Intranet domain adding 86 deleting 88 editing 88 Intranet Management 85 Intranet management initialization files 200 IP Address 222

223 Index defined 207 IsServerCluster setting 176 K keywords.ini 201 L language changing 101 language settings 154 leadinmatchtype setting 195 leadinstring setting 195 license agreement 3 locale options 105 log interface 166 log file defined 207 log file path dialog 44 log file URL path defined 207 log files about 17 sample 18 logdir setting 143 logfile setting 143 logfileformat setting 155, 177 logfilepath setting 176 logging in 34 Logo Filename setting 198 Long Description setting 198 M main console using 35 WebTrends 36 main screen 36 manual overview 15 mapfile setting 193 MAPI defined 207 maxanalysis setting 153 maxarchives for archiving 143 maxcachedcount setting 148 maxgridprofiles 160 maxprofiles setting 173 maxprofilesenabled setting 173 maxrefresh 160 maxtableentries setting 192 MaxTableSizes 161 maxthreads setting 147 maxtopcount setting 147 memory usage, limiting for reports 161 methods setting 167 mil_orgtype setting 146 mode 160 modifying user accounts 136 monthlydata setting 157 monthlyreport setting 158, 177 multi-homed domain defined 207 log file defined 207 Web server, defined 207 multi-homed domain filter 71 multihomedomain setting 184 multihomedomainenabled setting 184 multiple servers 174 multithreading defined 207 N logfilepath 175 MatchString 190 name setting 183 net_orgtype setting 146 nohtmltitles setting 149 Number Alignment setting 198 O Odd Row Background setting 197 Odd Row Text Color setting 197 option cookies 108 options database directory

224 WebTrends Enterprise Reporting Server dns lookup 120 general 103 locale 105 profiles 107 report scheduler 117 report template 115 reports 53, 116 system performance 118 web server 113 org_orgtype setting 147 OSAuthentication setting 165 P Page Background Color setting 196 page setting 193 Page Text Color setting 196 pages,sorting into groups 129 PageType setting 190 pagetype setting 192, 193, 194 parameter setting 193 password setting 169 path analysis 127 definition name 192 depth 192 id 192 maximum paths 192 page type 192 profile version 192 starting page 192 path analysis definitions profile settings 60 path analysis settings 191 paths through site 127 PathsAnalysisProfileCount setting 191 peformance options 118 performance settings 152 period setting 155, 177 permissions about 169 permissions setting 169 platform defined 207 plug-in defined 207 port 132 processingtype setting 175 product features 15 profile analyzing from a specific date 43 defaults 175 defined 207 settings 154 profile list 36 Profile Search command 64 profiledir setting 145 ProfileID setting 190 profileid setting 192, 193, 194 ProfileName setting 190 profilename setting 192, 193, 194 profiles 67 about 18 archiving 43 cookie settings 49 copying 61 database directory 114 database location 57 deleting 62 disabling 44 displayed in main console 64 DNS settings 55 editing 61 filtering 49 grouping pages 60 log file path setting 44 monitoring status 63 name 43 path analysis settings 60 report header settings 51 report paths 54 report settings 52 report template settings 50 restoring with archives 62 scheduling reports 54 search for 64 server settings 46 settings 175 stopping analysis 62 text files 174 tracking advertising 83 URL parameter analysis settings 59 URL replacement settings

225 Index user access settings 58 viewing more in list 160 profiles directory 107 profiles options directory for profiles 107 ProfileVersion setting 190 profileversion setting 192, 193, 195 program directory structure 138 prostatrefresh 160 protocol defined 207 proxy server defined 208 proxy server settings 121 Q quarterlydata setting 158 quarterlyreport setting 158, 177 query strings 130 R referrer defined 208 filter 74 referrer filters examples 75 formatting 74 referrer setting 185 referrerenabled setting 185 remote configuration settings 165 removing templates 102 replacementstring setting 195 report 94 about 89 color 98 content 100 customizing 96 default schedule for profiles 117 defined 208 excluding blank chapters 99 font 98 language 99 Microsoft Word 95 running 93 selecting 90 viewing 90, 93 report distribution profile settings 54 report header profile settings 51 report language changing 101 report paths profile settings 54 report queue 94 report scheduler option 117 report setting 154 report style adding 97 report template default for profiles 115 editing 101 profile settings 50 removing 102 report template option 115 report template style adding 97 report template styles about 96 report templates settings 196 report types 53, 116 report viewer calendar 90 status bar 90 table of contents 90 using 90 reportdestoverride setting 156 reportdir setting 156, 177 reportfile setting 155, 178 reports 62, 113 about 18 background color 196 country of origin 106 deleting 53, 116 directory 113 header color 196 incorrect dates

226 WebTrends Enterprise Reporting Server problems with Word reports 215 profile settings 52 report types 53, 116 reports to save 53, 116 search engines included 201 start time 118 reports option 53, 116 reports to save 53, 116 reporturl setting 156 reporturl setting 178 resolve 163 restoring profiles and archiving 62 restrictions 172 retries interface 165 return code defined 208 return code filter 69 return codes filter 69 returncodes setting 183 returncodesenabled setting 183 root setting 192 running reports 93 S Scenarios Configuring WebTrends for your Intranet 86 Tracking Internet Advertising 79 scheduling reports profile settings 54 scripts, in reports 111 search engines reported on 201 searchkeywords setting 186 searchkeywordsenabled setting 186 Section Background Color setting 196 Section Font setting 197 Section Text Color setting 197 server defined 209 log file path 175 name 175 web server for publishing reports 113 server cluster settings 175 server errors defined 209 server settings 174, 175 servername setting 175 servers profile settings 46 setting 175, 190 sheduling reports 117 shopping cart software and URL replacement 59 shopping cart software,and URL search and replace 123 showadmindatadir setting 157 site configuration dialog 42 SMTP defined 209 software license agreement 3 Sort By setting 198 specifying filters for analysis 68 Standard Font setting 197 startimmediately setting 155 startprocessingat setting 175 starttime setting 155, 178 status 94 profiles 63 stopping analysis 62 stopping analysis and reporting 62 stopping profile analysis 62 style settings 196 style.ini 196 styles adding 97 Sub Title Background Color setting 197 Sub Title Font setting 197 Sub Title Text Color setting 197 syntax 141 system performance option 118 T Table Columns setting 198 Table Data Font setting 197 tables changing the size 100 template editing

227 Index removing 102 templates editing 101 profile settings 50 testing url replacement definitions 127 threadedanalysis setting 153 threadedreports setting 154, 178 timeout interface 165 user session 132 Title Text Color setting 197 titlecachelifespan setting 149 titlecachesize setting 149 TOC Width setting 198 toolbar 37 browser 35 tracking advertising 79 tracking Internet advertising 80 trailermatchtype setting 194 trailerstring setting 195 translation file 131 U uid 162, 167 unique URLs and URL search and replace 123 unix settings gid 162, 167 handles 162, 168 uid 162, 167 URL defined 209 URL filter 71 URL parameter analysis 59, 130 definition name 193 id 193 page to track 193 page type 193 parameter to track 193 profile version 193 translation file 193 URL parameter analysis settings 192 URL path 113 URL replacement 59 URL replacement definitions profile settings 59 url replacement definitions testing 127 URL search and replace about 123 creating a definition 126 definition count 194 definition name 194 id 194 page type 194 URL search and replace settings 194 urlreplacementrofilecount setting 194 usdomains setting 145 usegatestring setting 195 user advanced settings 172 enable limit profiles 173 filter settings 171 hide dns 172 hide filters 172 hide home dialog 172 hide log file dialog 172 hide report path dialog 172 hide report template dialog 173 hide reports dialog 173 hide scheduler dialog 173 hide site configuration dialog 173 limit profiles 173 password 169 permissions 169 profile settings 171 restrictions settings 172 username 169 user access profile settings 58 user accounts about 133 modifying 136 user address defined 209 user address filter 70 user agent defined 209 user session defined

228 WebTrends Enterprise Reporting Server user session length 103 user session timeout 132 user settings 168 username filter 77 username setting 169, 186 usernameall setting 186 usernamecasesensitive setting 186 usernameenabled setting 186 users setting 176, 183 usersenabled setting 183 usesymlinks 163 usetotracksession setting 195 using ad views and clicks 80 V version setting 175 viewing reports 93 views page view 110 visit defined 209 W web log analysis filters overview 67 Web log analysis profiles DNS lookup 55, 120 web log filters advertising 76 browser 76 day 77 directory filter 71 file filter 73 hour 78 multi-homed domain 71 referrer 74 return codes 69 user address 70 username 77 web server port 132 web server configuration 132 web server options 113 web server settings 165 WebAddress setting 166 WebLogErrors setting 166 WebLogFileName setting 166 webservermode setting 156 webservermodeoverride setting 156 WebTrends general options 103 main console 36 WebTrends Reporting Server features 15 how it works 16 WebUserTimeout setting 166 weeklydata setting 157 weeklyreport setting 158, 178 wild cards, defined 210 Word reports problems with 215 wtinterface settings 165 wtm_wtx.ini interface section 160 unix section 162, 167 wtreportdir setting 156, 178 wtreporturl setting 156 wtreporturl setting 178 Y yearlydata setting 158 yearlyreport setting 158,