WebTrends 7
Installation and Configuration Guide
July 2004 Edition © 2004 NetIQCorporation
Disclaimer
This document and the software described in this document are furnished under and are subject to the terms of a license agreement or a non-disclosure agreement. Except as expressly set forth in such license agreement or non-disclosure agreement, NetIQ Corpo-ration provides this document and the software described in this document “as is” without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of merchantability or fitness for a particular purpose. Some states do not allow disclaimers of express or implied warranties in certain transactions; therefore, this statement may not apply to you.
This document and the software described in this document may not be lent, sold, or given away without the prior written permission of NetIQ Corporation, except as otherwise permitted by law. Except as expressly set forth in such license agreement or non-disclosure agreement, no part of this document or the software described in this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, or otherwise, without the prior written consent of NetIQ Corpo-ration. Some companies, names, and data in this document are used for illustration purposes and may not represent real companies, individuals, or data.
This document could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein. These changes may be incorporated in new editions of this document. NetIQ Corporation may make improvements in or changes to the software described in this document at any time.
© 1996-2004 NetIQ Corporation. All rights reserved.
U.S. Government Restricted Rights: If the software and documentation are being acquired by or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcon-tractor (at any tier), in accordance with 48 C.F.R. 227.7202-4 (for Department of Defense (DOD) acquisitions) and 48 C.F.R. 2.101 and 12.212 (for non-DOD acquisitions), the government’s rights in the software and documentation, including its rights to use, modify, reproduce, release, perform, display or disclose the software or documentation, will be subject in all respects to the commercial license rights and restrictions provided in the license agreement.
Trademarks
WebTrends is a registered trademark of NetIQ Corporation. Additional trademarks of NetIQ Corporation include: FastTrends, WebTrends SmartView, WebTrends Report Exporter, GeoTrends, WebTrends Express Viewer, WebTrends SmartSource Data Collector,
WebTrends SmartReports, WebTrends On Demand, WebTrends Tech Tools, Log Analyzer, WebTrends Live, and WebTrends Reporting Center. Other brands and their products are trademarks or registered trademarks of their respective holders.
Support
Sales and General Contact Information
Service and Support Online Resources
NetIQ Corporation 3553 N. First St. San Jose, CA 95134 Phone: 1-408-856-3000 Fax: 1-408-273-0578 Sales: 1-888-323-6768 Email: [email protected]
Direct Technical Support: Americas:
+1 503-223-3023 Asia Pacific, Australia, New Zealand: +1 503-223-3023 Europe, Middle East, Africa:
+353 (0) 91 -782 677 http://www.netiq.com/ support
Customer Resource Center. A portal to resources that can help you make the most of your on-line web initiatives. http://www.netiq.com/webt-rends/resourcecenters.asp WebTrends Portland, Oregon 851 SW 6th Ave. Suite 700 Portland OR 97204 Phone: 1-503-294-7025 Fax: 1-503-294-7130 US Toll Free: 1-888-932-8736 Email: [email protected] Web:http://www.webt-rends.com
WebTrends Consulting and Training:
http://www.netiq.com/ services/analytics.asp
Knowledge Base. Answers to questions most commonly asked:
http://www.netiq.com/sup-port/kb/default.asp
Table of Contents
Chapter 1Introduction...11
How to Use This Guide ... 11
Documentation ... 12
Using Help ...12
Providing Feedback ...13
Additional Resources ...13
Visual Cues in WebTrends Documentation ...14
Chapter 2
Licensing ... 17
Overview ... 17
How WebTrends Software Is Licensed ... 17
Licensing Modes ...18
Working With License Keys ...18
Checking the License Status ...20
How WebTrends On Demand Is Licensed ... 20
Checking the License Status ...21
Checking Your Page View Balance ...22
Chapter 3
Installing WebTrends: Basic Installation... 23
Overview ... 23
Minimum System Requirements ... 23
Preparing for a Basic Installation ... 29
Activating Your License ... 32
Installing WebTrends Sample Data ...33
Installing SmartSource Data Collector ...34
Preparing to Install SDC ... 34
Installing Apache-Based SDC on Windows ... 35
Installing IIS-Based SDC for Windows ... 40
Installing Apache-Based SDC on Linux or Unix ... 42
Enabling SSL for SmartSource Data Collector ...55
SSL for Apache-Based SDC ... 55
SSL for IIS-Based SDC ... 60
Uninstalling SmartSource Data Collector ...61
Uninstalling SDC on Windows ... 61
Uninstalling SDC on Linux or Unix ... 63
Chapter 4
Installing WebTrends: Distributed Installation ...67
Overview ...67
Introduction ...67
Distributed Architecture ... 68
Planning a Distributed Installation ...69
Understanding WebTrends Components ... 70
Selecting a System Database ... 72
Assessing Your Storage Needs ... 72
Using the System Requirements Tool ... 72
Preparing for a Distributed Installation ...73
Preparing a MySQL Database Installation ... 73
Preparing a Microsoft SQL Server Installation ... 73
Setting Up Shares for Data ... 74
Performing the Distributed Installation ...74
Chapter 5
Modifying Your Installation ... 79
Overview ... 79
Migrating Manually ... 79
Supported Migrations ...80
Migration Components ...80
Preparing for Migration ...80
Performing the Migration ...81
Adding Components Post-Installation ... 85
Upgrading Apache Web Server ... 87
Upgrading on Windows 2000/2003/XP ...87
Upgrading on Red Hat Enterprise Linux 3 ...88
Upgrading on Solaris 8/9 ...88
Binary Compatibility ...91
Chapter 6
WebTrends On Demand Accounts ... 93
Signing Up for WebTrends On Demand Enterprise ... 94
Signing Up WebTrends On Demand Professional ... 95
Setting Up WebTrends On Demand Enterprise or Professional ... 96
Logging in to WebTrends On Demand ...97
Creating a Data Source ...98
Creating a Profile ... 100
Viewing Your Reports ... 101
Using the Account Console: Enterprise and Professional Editions ... 101
Changing Account Information ...106
Viewing Account History ...108
Creating an Account ...108
Setting Up WebTrends On Demand Small Business ... 109
Signing Up for WebTrends On Demand Small Business Edition ...110
Logging in to Your Account ...111
Creating a Profile ...113
Viewing Your Reports ...114
Using the Account Console Small Business Edition ... 114
Additional Concepts and Definitions ... 116
Chapter 7
WebTrends User Accounts ...119
Overview ... 119
Adding Users ... 119
About Users’ View Only Permissions ... 122
Chapter 8
Working with the Report Designer... 123
Report Templates ... 123 Template Settings ...123 Applying Templates ...126 Report Dashboards ... 126 Dashboard Settings ...127 General Tab ...127 Content Tab ...128 Report Options ... 129
Reports ... 129
Report Templates ... 130
Chapter 9
Express Viewer ...131
Introduction ... 131
Express Viewer Restrictions ... 131
Installation Instructions ... 132
Configuration Instructions ... 133
Uninstalling the Express Viewer ... 133
Chapter 10
Profile Setup...135
How Profiles Work ... 135
Adding Profiles ... 136
Launching the New Profile Wizard–On Demand Only ... 136
Launching the New Profile Wizard–Software Only ... 143
Editing Previous Settings ... 160
Configuration File Reference ... 160
Chapter 11
SDC Operations and Monitoring ...161
Operations ... 161
Starting and Stopping SmartSource Data Collector ... 161
Apache-Based SDC ... 162
IIS-Based SDC ... 166
SDC Audit Log ... 167
Hit Count Tracking ... 171
Monitoring ... 178
Log File Monitoring ...179
Hit Validation ...179
Log File Name ...180
Log File Rotation ...181
Logging Behavior ...181
Monitoring the Log File ...181
Chapter 12
Instrumenting Web Pages ... 183
Overview ... 183
SDC JavaScript Tags ... 183
SDC JavaScript Tag Modifications ...184
SDC JavaScript Tag Placement ...187
Inserting the SDC JavaScript Tag ...187
SDC VBScript Tags ... 189
SDC VBScript Tag Modifications ...190
SDC VBScript Tag Placement ...193
Using HTML <META> Tags ... 193
Syntax ...194
Chapter 1
Introduction
How to Use This Guide
You will find icons for each WebTrends edition throughout the documentation. If a feature or content section applies to your edition of WebTrends, you will find the appropriate icon at the beginning of the section. For example, if you are licensed to use the WebTrends On Demand Professional Edition, features and content areas applicable to you include this
icon:
If the content does not apply to your WebTrends edition, you see a “not applicable” version of your product icon:
Important: Note that while your edition of WebTrends may include a feature, your ability to use it may be restricted by licensing or your WebTrends Administrator. If you do not have access to a feature that is included in your edition, please see your WebTrends Administrator.
Table 1-1. Edition Icons
This icon Represents this product: WebTrends Small Business Edition WebTrends Professional Edition WebTrends Enterprise Edition
WebTrends On Demand Small Business Edition WebTrends On Demand Professional Edition
Documentation
WebTrends includes a full library of Help and user manuals to help you install, configure, and use WebTrends to its full potential. For more information about Help, see “Using Help” on page 12. For more information about WebTrends manuals, see “Additional Resources” on page 13.
Using Help
WebTrends includes detailed Help to guide you through configuring and using WebTrends and WebTrends On Demand. Various information resources include:
• Admin Console Help
If you are logged into WebTrends, open this by selecting Help from the left pane of the Admin Console, then Contents & Index from the right pane.
Context-sensitive help is also available from most dialogs within the progam. Select Help from the upper right-hand corner of the dialog to open the pertinent help page. You can then select Show Navigational Controls to open the Table of Contents if you want to browse elsewhere in the help system.
• Desktop Help
WebTrends users view reports, and descriptions of the elements of the reports, through the WebTrends Desktop. For help on navigating and working with the Desktop Viewer, select Help > Contents from the upper right corner of the Desktop.
• SmartView and Express Viewer
These new WebTrends features each include a standalone help system. To open these Help systems from within each program, select the Help icon from the upper right corner of these panes.
WebTrends On Demand Enterprise Edition This icon Represents this product:
Note: For SmartView and Express Viewer installation instructions, see the appropriate chapters of the WebTrends User Guide.
• Glossary
From the WebTrends Desktop, select Help > Glossary. A detailed WebTrends glossary opens in a new browser window.
Providing Feedback
Your comments are very important to us. Please take the time to let us know about your WebTrends experience by doing one of the following:
• From the Admin Console, select Help in the left pane, then Feedback from the right pane.
• From the WebTrends Desktop, select Help > Feedback from the upper right corner of the report.
The Feedback page of the WebTrends Web site opens in a new browser window. There you can rate different aspects of our product and provide your comment.
Additional Resources
In addition to this Installation and Configuration Guide, there is additional documentation available to help you maximize the effectiveness of your company’s WebTrends implemen-tation. The other major documents for this release of WebTrends include:
• WebTrends User Guide
This guide is intended to help non-administrators understand and use the WebTrends Desktop to view reports. This guide provides a brief overview of how WebTrends works, how to navigate the Desktop, Calendar, and Dashboards to access reports and interact with them to find the information you need.
Note: Users who have no other permissions than View Reports automatically use the WebTrends Desktop (Report Viewer) instead of the Admin Console. While they can view the reports, they may not have access to any of the other controls. WebTrends recommends distributing the WebTrends User Guide to these WebTrends users as a intro-duction to navigating WebTrends reports and report data.
• WebTrends Technical Reference Guide
A technical reference for administrators who are responsible for maintaining the WebTrends software or service.
• WebTrends Implementation Guide
A comprehensive guide for both administrators and non-administrators providing general information and best practices for a successful WebTrends implementation. Topics covered in this guide include how to collect web traffic data, how to get optimal performance with your web analysis, considerations to make when setting up your organization to run web analysis and how to configure WebTrends to give you the information you need.
You can find these manuals in the Documentation directory on your WebTrends installation CD or download them http://product.webtrends.com/ptw.aspx?action=14& prodtype=rcent&version=7.0&os=win32.
Visual Cues in WebTrends Documentation
The following table describes the typographic changes used in this and other guides to using WebTrends:
This text Represents
Bold The name of an icon or button (New), a text box (Base Time
text box), or check box (Save User ID check box in the user interface).
Title Case The name of a dialog box (Edit Connection dialog box),
Lucinda Console
Source code examples, program output, or anything typed by the user.
Note: For more information about using the WebTrends edition logos to determine which features apply to the WebTrends edition you are using, see Table 1-1, “Edition Icons,” on page 11.
Chapter 2
Licensing
Overview
In this chapter:
• “How WebTrends Software Is Licensed”
• “How WebTrends On Demand Is Licensed” on page 20
This section discusses how WebTrends and WebTrends On Demand are licensed, how product keys are activated in software editions, and where you can find status information for your license.
How WebTrends Software Is Licensed
WebTrends is licensed according to page views collected and by the number of Web servers on which you are reporting.
• Page views/period
The number of page views WebTrends collects is determined by the edition you have licensed. For example, during a 12 month period, your edition of WebTrends may be licensed for up to 20 million page views.
A page view in a licensing context is defined as a Web page rendered by a browser that WebTrends collects for analysis. Regardless whether WebTrends analyzes log files or SmartSource Data Collector (SDC) data generated by inserted Java Script tags on your Web pages, page views are counted from one data source or the other but not both.
If log files are being analyzed and the same log file is processed at a later date by a different profile or by the same profile, the page view is not counted again. Page views are counted prior to applying any customer filters. Although multiple frames on one Web page are counted as separate (multiple) page views, you can avoid this if you are using SDC by excluding the WebTrends JavaScript from the secondary frames.
• Web servers
The scale of your web analysis is influenced by the number of web servers on which you are reporting. You are limited to reporting on the number of servers for which you are licensed.
Licensing Modes
WebTrends runs in two modes: a trial and a full mode. • Trial
Each edition of WebTrends is available as a 14-day fully functioning trial for evaluation purposes. Once this trial period expires, you can convert the product to full mode when WebTrends is purchased. A product license key enables WebTrends to run.
• Full
WebTrends runs in full mode when the product license key is entered during the instal-lation. If you by-passed this step during the installation, you may enter a license key when you launch WebTrends.
Working With License Keys
WebTrends requires a product license key to run. You may also have additional keys for reporting on multiple servers (server Add On keys), for product maintenance, and for server Add On maintenance.
This section describes how to activate each of these keys and how to deactivate the product license.
Activating Your Licensing Key
During the installation process, you are prompted to enter a license key. If you skip this step during installation, you are prompted to activate the key when the product is launched. Enter the WebTrends license key in the dialog box.
Note: You must have internet connectivity to activate a license key.
Activating Add On Keys
As your needs grow, you may enhance WebTrends by activating keys that provide the capability to report on more web servers. Additionally, as you renew product or Add On maintenance, you update WebTrends with those keys.
To activate a license key:
1. From the Admin Console, select Licensing from the left pane. 2. Select the License Keys tab.
3. Click the Add New License Key button, and the Activate License Key dialog opens. 4. Type the new key in the Enter the License Key text box, and click the Activate button.
The key appears in the License Keys list, and the status is updated in the General tab.
Deactivating Your License Key
Should you need to move the WebTrends license key from one system to another, you may do so through the Licensing dialog boxes.
To deactivate a key:
1. From the Admin Console, select Licensing from the left pane. 2. Select the License Keys tab.
3. Select the WebTrends license key (the first key listed).
4. Click the Delete icon . WebTrends no longer runs until a key is activated on this or another WebTrends system.
Checking the License Status
The Licensing dialog boxes accessible from the Admin Console allow you to view the status of your WebTrends license.
To access the Licensing dialogs:
1. From the Admin Console, select Licensing in the left pane. 2. Select the General tab. The Current Statistics section allows you to:
• Check maintenance status
View whether the product maintenance is up to date in the Maintenance field. When you renew maintenance, add the new key in the License Keys tab. • Check page view status and limits
View the number of page views collected in the Current column. View the maximum number of page views that can be collected in the Limit column.
• Check web server status and limits
View the number of web servers reported on in the Current column. View the total number that you may report on in the Limit column. If an additional server Add On key is acquired, enter the key in the License Keys tab.
How WebTrends On Demand Is Licensed
WebTrends On Demand is licensed by page views collected, number and type of profiles, number of custom reports, and volume of reports exported.
• Page views/period
The number of page views WebTrends collects is determined by the edition of WebTrends On Demand you have licensed. For example, during a 1 year period, your edition of WebTrends may be licensed for up to 10 million page views.
A page view in a licensing context is defined as a Web page rendered by a browser that has been collected for analysis by WebTrends.
If WebTrends analyzes data that is processed again at a later date by a different profile or by the same profile, the page view is not counted again. Page views are counted prior to applying any customer filters. You can avoid multiple frames on one Web page being counted as separate page views by excluding the WebTrends JavaScript from the secondary frames.
• Profiles
The number of profiles is determined by the edition of WebTrends On Demand. Your total number of profiles available can be distributed to your child accounts (the sub accounts within your main license).
• Custom reports
WebTrends On Demand includes a set of pre-loaded custom reports that can be used with each profile. The edition of WebTrends On Demand that you are licensed for deter-mines the total number of custom reports that can be distributed to your child accounts (those sub accounts with your main WebTrends account).
• Report exports
Your edition of WebTrends On Demand determines the number of report exports that you can use each month. Once that limit is reached, you can purchase additional report exports.
Checking the License Status
The Edit Account dialog box in the Account Console allows you to view the status of your WebTrends On Demand license.
To access the Edit Account dialog box:
1. From the Account Console, select Edit Account in the left pane.
Within this dialog box you can: • Check profile status & limits
Number of Allowed Profiles shows the number of profiles currently used, the
balance available, and the total number that can be used for your account (including child accounts).
• Check child account status & limits (Not applicable to WebTrends Small Business or WebTrends On Demand Small Business.)
Number of Allowed Child Accounts shows the number of child (subordinate)
accounts currently used, the balance available, and the total number that can be used. The total number of profiles and custom reports available for the main account can be distributed to your child accounts.
• Check custom report status & limits
Number of Allowed Custom Reports shows the number of custom reports
currently used, the balance left to be used, and the total number allowed for your account. The custom reports that come pre-loaded are not included in the status details either in the total number available or the number currently used.
Checking Your Page View Balance
The Account Usage dialog box in the Account Console provides a status of your page views.
To access the Account Usage Summary dialog box:
From the Account Console, select Account Usage> Summary in the left pane. Use this dialog to view:
• Page views collected so far during the current month • Page views collected for the calendar year to date • Pages views collected during the life of your account.
Chapter 3
Installing WebTrends:
Basic Installation
Overview
In this chapter:
• “Installing WebTrends Software” on page 30 (including the optional GeoTrends data file)
• “Installing WebTrends Sample Data” on page 33
• “Installing SmartSource Data Collector” on page 34
This chapter provides procedures for a basic installation of WebTrends Software. For infor-mation about custom or distributed installation, see “Installing WebTrends: Distributed Installation” on page 67.
Minimum System Requirements
WebTrends is a Windows-based product with the exception of SmartSource Data Collector (SDC) which also supports Linux and Solaris. Below are the system requirements for each edition including SDC and GeoTrends.
Hardware Software Sizing Considerations WebTrends Small Business --2.0GHz or higher processor --1 GB of RAM
--50 GB of free hard disk space (7200 RPM IDE) --10/100 Mbps network interface card Supported Operating Systems --Windows 2000 with Service Pack 3 or higher --Windows XP with Service Pack 1 or higher --Windows 2003 Supported Browsers Microsoft Internet Explorer v5.5 or higher Note:
If you want to convert WebTrends reports to Microsoft Word or Excel format or use WebTrends SmartReports for Microsoft Excel, WebTrends also requires Office 2000 or higher and the Sun Java Runtime Environment v1.3.1_11.
Requirements are based on 5 profiles and 2 concurrent users. --To process more than 100,000 page views a day, add 1024 MB of RAM.
--To run GeoTrends on the same computer as WebTrends v7.0, add 1024 MB of RAM. --To run GeoTrends and process more than 100,000 page views a day, add 2048 MB of RAM.
WebTrends Professional
--2.0 GHz or higher processor
--1 GB of RAM
--70 GB of free hard disk space (7200 RPM IDE) --10/100 Mbps network interface card Supported Operating Systems --Windows 2000 with Service Pack 3 or higher --Windows XP with Ser-vice Pack 1 or higher --Windows 2003 Supported Browsers Microsoft Internet Explorer v5.5 or higher Note:
If you want to convert WebTrends reports to Microsoft Word or Excel format or use WebTrends SmartReports for Microsoft Excel, WebT-rends also requires Office 2000 or higher and the Sun Java Runtime Envi-ronment v1.3.1_11.
Requirements are based on 10 profiles and 5 concurrent users. --To process more than 100,000 page views a day, add 1024 MB of RAM.
--To run GeoTrends on the same computer as WebTrends v7.0 add 1024 MB of RAM. --To run GeoTrends and process more than 100,000 page views a day, add 2048 MB of RAM.
WebTrends Enterprise
At least two computers with the following requirements:
--Dual 2.8 GHz or higher processors
--200 GB of free hard disk space (15,000 RPM SCSI) --10/100/1000 Mbps net-work interface card
Supported Operating Systems
--Windows 2000 with Service Pack 3 or higher --Windows XP with Service Pack 1 or higher --Windows 2003 Supported Browsers Microsoft Internet Explorer v5.5 or higher Note:
If you want to convert WebTrends reports to Microsoft Word or Excel format or use WebTrends SmartReports for Microsoft Excel, WebTrends also requires Office 2000 or higher and the Sun Java Runtime Environment v1.3.1_11.
Requirements are based on 50 profiles and 10 concurrent users. You can scale WebTrends Enterprise in many dif-ferent ways. Contact Professional Services for a solution that best meets your needs. --To process more than 100,000 page views a day, add 1024 MB of RAM.
--To run GeoTrends on the same computer as WebTrends v7.0, add 1024 MB of RAM. --To run GeoTrends and process more than 100,000 page views a day, add 2048 MB of RAM.
WebTrends Desktop (for viewing reports)
256 MB of RAM Supported Browsers
Microsoft Internet Explorer v5.5 or higher with Sun Java Runtime Environment v1.3.1_11. The correct version of the Java Runtime Environment is installed with WebTrends. Note:
If you want to convert WebTrends reports to Microsoft Word or Excel format or use WebTrends SmartReports for Microsoft Excel, WebTrends also requires Office 2000 or higher.
Large environments require multiple comput-ers. To improve perfor-mance, increase the RAM. Use SCSI RAID 10 (also known as RAID 0+1) for the best disk performance.
SmartSource Data Collector (SDC) --Windows/Linux: 1.0GHz or higher processor --Solaris: Dual 400 MHz or higher UltraSparc-II processors --1GB of RAM --Enough disk space to store the expected contents of your log files (7200 RPM IDE) --10/100 Mbps network interface card Supported Operating Systems --Windows 2000 with Service Pack 3 or higher --Windows XP with Service Pack 1 or higher --Windows 2003, or: Solaris 2.8 and 2.9 --Red Hat Enterprise Linux AS (Advanced Server) or ES (Enterprise Server) v3.0 Supported Browsers Microsoft Internet Explorer v5.5 or higher Supported Web Servers --Apache Web Server v2.0.49
--Microsoft Internet Information Server v5.0 or v6.0
For SDC processing more than 100,000 daily page views, we recommend the following hardware upgrades: --Dual 2.0GHz or higher processors --2 GB of RAM --Enough disk space to store the expected contents of your log files (15,000 RPM SCSI) --10/100 Mbps network interface card
For larger sites, you may need to increase the number of processors, the speed of the processors, the amount of memory, and the network bandwidth of the SDC host. You can also scale the SDC by employing one of various load-balancing techniques. Contact Professional Services for a solution that best meets your needs.
Preparing for a Basic Installation
Before installing WebTrends, complete the following checklist:
• Review the system, browser, and screen resolution requirements in “Minimum System Requirements” on page 23 to ensure optimum performance of WebTrends.
• Collect any valid license keys for the product, Add-On licenses, or subscriptions. You can then choose from the following installation paths to install WebTrends, including the SmartSource Data Collector (SDC) and GeoTrends:
• “Installing WebTrends Software” on page 30 (this includes GeoTrends) • “Installing WebTrends Sample Data” on page 33
• “Installing SmartSource Data Collector” on page 34
GeoTrends --1.0 GHz or higher pro-cessor
--1GB of RAM
--30 GB of free hard disk space (7200 RPM IDE) --10/100 Mbps network interface card Supported Operating Systems --Windows 2000 with Service Pack 3 or higher --Windows XP with Ser-vice Pack 1 or higher --Windows 2003
For GeoTrends process-ing more than 100,000 daily page views, we recommend the following hardware upgrades: --Dual 2.0GHz or higher processors --2GB of RAM
--30GB of free hard disk space (15,000 RPM SCSI)
--10/100 Mbps network interface
To run GeoTrends on the same computer as WebTrends v7.0, add 1024 MB of RAM.
• “Installing Apache-Based SDC on Linux or Unix” on page 42
• “Enabling SSL for SmartSource Data Collector” on page 55
Installing WebTrends Software
This section covers a typical installation of WebTrends (and the optional GeoTrends component) for WebTrends Small Business and WebTrends Professional.
• For more information about installing SmartSource Data Collector (SDC), see page 34. • For more information about installing the optional WebTrends samples, see page 33. • For more information about performing a custom installation, see “Installing
WebTrends: Distributed Installation” on page 67.
To install WebTrends software:
1. Insert the WebTrends software CD-ROM into your CD-ROM drive. If your system is
set up to use auto-run, the setup program is automatically launched. If not, choose Run from the File or Start menus and type:
X:\setup
where X is the drive letter of your CD-ROM drive. 2. The installation wizard launches. Click Next to continue.
3. Before the WebTrends program files are copied to your system, you must accept the
Software License Agreement. If you agree to the stated terms, select the I Accept the
terms in the license agreement option, and click Next. Otherwise, click Cancel to exit
the setup program without installing the software.
4. The Add Licenses dialog box opens. Enter your valid license key here to continue. (See
your WebTrends administrator if you do not have a valid license key.) Note: You must have internet connectivity to activate a license key.
5. The Select Install Type dialog box opens with the Typical option selected. This dialog
box does not apply to WebTrends Small Business.
Note: For information about custom installation, see “Installing WebTrends: Distributed Installation” on page 67.
6. The Destination Folder dialog box opens. The default installation folder is
X:\Program Files\WebTrends where X is the hard drive you are installing to. Do one of the following:
• Click OK to accept the default installation folder.
• If you want to install to a different directory, click Change and browse to your preferred location. Click OK twice to save the new location and continue.
7. Select which WebTrends application you want to install:
• WebTrends core application • GeoTrends
• SmartSource Data Collector
8. If you select GeoTrends, you are prompted to do one of the following:
• Click Download to download the latest available version of the GeoTrends data file from the WebTrends Web site. Save the file to a location accessible by the
WebTrends computer.
• Locate the geotrends.dat file on the WebTrends CD-ROM. Click Next.
9. The System Database Initialization dialog box opens showing the host, port number,
and administrator information. Enter and confirm your password, and click Next. Note: In this dialog box, you are specifying the password for the database, not your log in password for the WebTrends User Interface. If this is a subsequent WebTrends instal-lation, only the information used during the first installation is valid. See your WebTrends administrator if you have questions.
10.The Specify Storage locations dialog box opens where you can:
• Specify the location for storing analysis data in the Analysis Data Repository text box.
• Specify the location for storing report data in the Report Data Repository text box. • Specify the location for WebTrends configuration data in the Configuration
Repository text box.
Each path must be accessible by the WebTrends computer. If you are installing
WebTrends Enterprise and you add additional computers to your installation later, those computers will need access to these shared locations. For more information about subse-quent installations, see “Managing Your Distributed Installation” on page 77.
Make any changes needed to the locations; otherwise, click Next to accept the default locations and continue.
11.You are prompted to return to previous dialog boxes if you need to edit your installation
choices. If you do not need to make any changes, click Install.
12.The WebTrends program files are installed to your machine.
13.Depending on your component selection in step 7, one of the following then occurs: • If you have only chosen to install WebTrends and the optional GeoTrends data file,
you are notified that the installation is complete. You are prompted to view and read the release notes. Click Finish to close the Installation program.
• If you selected SmartSource Data Collector in step 7, you need to complete additional installation steps. See “Installing SmartSource Data Collector” on page 34
for that information.
14.If a previously installed version of WebTrends v6.x is detected, you are asked if you
would like to migrate the configuration data from your previous installation to your new installation.
• Click Yes if you want to migrate data from your previous installation to WebTrends v7.0.
• Click No if you want to complete the installation without migrating data. You can manually migrate data later. Refer to “Migrating Manually” on page 79 for details.
Activating Your License
When you first launch WebTrends, if you did not provide a valid license key during instal-lation, you have to provide a valid license key, legacy serial numbers, or Add-On keys in order to register the product. After WebTrends accepts the license key, the Login window opens. You can then provide your WebTrends user name and password to log into WebTrends. (If you do not have this information, please see your WebTrends administrator.)
Installing WebTrends Sample Data
You can install WebTrends sample data from either the WebTrends CD-ROM or the WebTrends Web site.
To install a sample from the WebTrends CD:
1. Locate the sample you want to install on the WebTrends CD-TOM. Choose from:
• ZedescoODDBSample.exe • ZedescoWithLogsSample.exe • StreamingMediaSample.exe
2. Double-click Sample.exe, or select Run from the Windows Start menu to launch the
installation wizard. Click Next.
3. The License Agreement dialog box opens. If you accept the terms of the license
agreement, select I acccept the terms of the license agreement, and click Next. You cannot install the samples without doing so.
4. The Custom Setup dialog box opens. Select the samples you want to install, and click Next.
• If you are unfamiliar with this type of installation program, click Help for details on the different selection options you can choose from.
• If you are unclear how much storage space you have available, click Space. The installation program lists the available data space and requirement for each volume you have access to. (You can click through the columns to sort this data.) When you are finished reviewing this information, click OK.
5. Click Back if you want to review or change any of your installation choices before the
installation begins. Otherwise, click Install.
6. You are notified when the installation is complete. Click Finish to close the wizard. To install sample data from the WebTrends Web site:
1. Enter the following URL in your Web browser to access the Accessories page of the
WebTrends Web site:
http://product.webtrends.com/
ptw.aspx?action=10&prodtype=wrc&version=7.0 2. From the Accessories page, select Sample Downloads.
3. Select the Sample that you want to download and save the file to your computer. 4. Go to the location where you saved the sample, and run the sample executable. The
sample data is installed in the program.
Installing SmartSource Data Collector
You can install SmartSource Data Collector (SDC) on Linux/Unix platforms (see page 42) or on Windows platforms (see “Installing Apache-Based SDC on Windows” on page 35 and
“Installing IIS-Based SDC for Windows” on page 40).
Preparing to Install SDC
Before installing SDC, review this section for special considerations.
• If you are installing WebTrends SmartSource Data Collector (SDC) on Apache, and you have a version of Apache earlier than v2.0.48 installed on the WebTrends system, you must remove it before installing SDC. When you install SDC, a later version of Apache is installed. For information about removing an existing version of Apache, see
“Uninstalling SDC on Windows” on page 61.
• You must remove any pre-existing SDC installation before installing this version. For information about removing SDC, see “Uninstalling Windows Apache-Based SDC” on page 62.
Network Considerations
SDC is a specialized web server. It receives HTTP requests from web clients, processes the requests, and appropriately responds to the web clients. The connections established between the clients and the server use TCP/IP. To make the required connection, the web server must be listening on a predetermined port associated with a known IP address. The client must have knowledge of the IP address and connectivity to the web server.
Before installing SDC, consider the various issues related to the configuration of your network that enable the TCP/IP communication between the web server and web clients. Most importantly, keep in mind that the SDC server is a web server that must be available for web clients to make HTTP requests.
Security Considerations
Since external clients make requests to the SDC server, carefully consider the security of your server before installing SDC. The SDC server is a specialized web server, but the security issues related to the SDC server are common to the security issues of standard web servers. Many types of threats are related to web server operations:
• Unauthorized access to confidential data • Data corruption
• Web site disruption
• Denial of Service (DOS) and other types of attacks
One approach to a secure configuration of the SDC server is to start with a “deny all” model. This approach begins with all services disabled, and enables only those services necessary for the operation of the SDC server. Specifically, do not enable services (daemons) such at telnet, mail, and finger. For the SDC server, the only TCP/IP link to the Internet required is port 80. (Port 443 is required if you use secure connections via SSL.)
Firewalls are often used to protect web servers and/or internal corporate networks. You can select from many types of firewalls and numerous ways to configure them and their corre-sponding networks. To use a firewall (which can be composed of routers, network segments, and host computers), you need to determine the location of your SDC server relative to the firewall in your network. You can put the SDC server outside or inside of the firewall. If you place the web server outside of the firewall, it will be more susceptible to malicious attacks. However, in the event of a break-in, the attacker will have breached only the boundaries of the SDC server and not the entire corporate network.
The details about the types of security breaches and the methods for preventing these attacks are beyond the scope of this document. However, it is highly recommended that you address the security concerns before exposing the SDC server to external users.
Installing Apache-Based SDC on Windows
This section describes how to install an Apache-based SmartSource Data Collector (SDC) on Windows 2000/2003/XP platforms.
Uninstalling Previous Versions
If a version of Apache earlier than v2.0.48 is installed, remove it before installing SDC. If you are installing an SDC upgrade, you must remove any pre-existing SDC. See “Uninstalling SDC on Windows” on page 61 and “Uninstalling Windows Apache-Based SDC” on page 62.
Installing Apache Web Server and SDC
If you select SmartSource Data Collector during step 7 of your WebTrends installation (page 31), an Installation wizard for SmartSource Data Collector opens after the WebTrends core component installation is complete.
To install theApache web server and SDC:
1. After the main WebTrends installation has completed, the SmartSource Data Collector
Installation wizard launches. Click Next to continue.
2. Review the NetIQ SmartSource Data Collector License Agreement.
• If you agree to the terms of the Agreement, select I accept the terms in the license
agreement and then click Next.
• Otherwise, click Cancel to exit the installation.
3. Select the destination folder.
• To accept the default destination folder, click Next. Or
• To specify a location other than the default destination folder, click Change. - The Change Current Destination Folder dialog box opens.
- Browse to the location you want or type the location in the Folder name text box. Click OK.
Then
- In the Destination Folder dialog box, click Next. The Ready to Install the Program dialog box opens.
4. Click Install to begin the installation.
An Installing WebTrends SmartSource Data Collector dialog box opens and begins the installation process.
A Server Type dialog box opens
5. Select Apache as your web server and click Next.
6. A pop-up message opens: This product requires the use of Apache Web Server 2.0.48. Would you like to install it now?
Note: To insure ease of use and full SDC functionality, it is recommended that you uninstall and then re-install the Apache web server.
• If you want to install the Apache web server, click Yes. Go to step 7.
• If you already have the same version of Apache that is on this CD installed on your computer, click No and skip the Apache portion of the install. Go to step 16.
7. The Apache httpd server installation wizard Welcome page opens. Click Next. 8. Review the Apache Software License Agreement.
• If you agree to the terms of the Agreement, select I accept the terms in the license
agreement, then click Next.
Or
• If you do not accept the terms of the Agreement, click Cancel to exit the instal-lation.
9. Review the Read This First message and click Next.
10.The Server Information dialog box opens. Enter the Server Information and select the
Startup Option:
• Network domain
The network domain is the domain that the SDC server operates.
• Server name
The server name is your host name or IP address.
The following is a description of the ServerName directive found in the httpd.conf file. Review these comments from the httpd.conf file before you enter your server name.
# ServerName allows you to set a host name which is # sent back to clients for your server if it's
# different than the one the program would get i.e. use # "www" instead of the host's real name).
#
# Note: You cannot just invent host names and hope they # work. The name you define here must be a valid DNS # name for your host. If you don't understand this, ask # your network administrator.
#
# If your host doesn't have a registered DNS name, # enter its IP address here. You will have to access it # by its address (e.g., http:// 123.45.67.89/) anyway, # and this will make redirections work in a sensible # way.
#
# 127.0.0.1 is the TCP/IP local loop-back address, # often named localhost. Your machine always knows # itself by this address. If you use Apache strictly # for local testing and development, you may use # 127.0.0.1 as the server name.
• Administrator’s email address
The Administrator’s Email Address is the address where problems with the server are to be sent.
• Select one of the following to install Apache HTTP Server 2.0 programs and shortcuts
For All Users, on Port 80, as a Service – Recommended.
(This default setting automatically issues commands to start Apache each time that you want to use it.)
Or
Only for the Current User, on Port 8080, when started manually.
(This means that you must issue commands to start Apache each time that you want to use it.)
Then • Click Next.
11.Select the type of installation:
• To install all of the Apache software on your hard drive, select Typical and click
Next. The Destination Folder dialog opens. Go to step 12. Or
• To install only one or more features, select Custom and click Next. The Custom Setup dialog opens. Go to step 13.
12.The Destination Folder lets you accept a default location for the Apache folder or
specify another location.
• To accept the current destination folder, click Next. The Ready to Install dialog box opens. Go to step 14. Or
• Click Change to specify a different destination folder. The Change Current Desti-nation Folder dialog box opens.
Browse to the new folder or type the folder name in the Folder name text box. Click OK. Then in the Destination Folder dialog box, click Next.
The Ready to Install dialog box opens. Go to step 14.
13.To set up your custom installation, select the Apache components to install by clicking
on the icons in the component tree and choosing a component installation option. • Click Space to see a list of your drives, drive sizes, available space for each drive,
and the required space for the selected features. • Select the destination folder.
- Accept the current destination folder and click Next. Or
- Click Change to specify a different destination folder. The Change Current Destination Folder dialog box opens. Browse to the new folder or type the folder name in the Folder name text box. Click OK and then in the Custom Setup dialog box, click Next.
14.Click Install. The Apache program begins to install.
Note: If a web server or another application is already running on port 80 or another port that you specified for SDC, then you will receive an error message that states:
Only one usage of each socket address <protocol/network address/port> is normally permitted. : make_sock: could not bind to address 0.0.0.0:80 no listening sockets available, shutting down. Unable to open logs.
Open your management console (On your desktop right-click My Computer icon >
Manage > Services and Applications > Internet Information Services) and stop the
server or application that is running on port 80.
15.The Installation Wizard Completed dialog box opens, indicating that Apache is installed.
Click Finish.
16.To complete the SDC configuration, your web server must be stopped and restarted.
Click Yes to do so at this time. Click No to postpone this step and the configuration.
17.Click Finish. The SDC installation is complete.
Installing IIS-Based SDC for Windows
Uninstalling Previous Version
Before installing an IIS-based SDC upgrade, you must remove any previous version. See
“Uninstall Windows IIS-Based SDC” on page 62.
Installing IIS-Based SDC
You must install a supported version of IIS before installing the IIS-based SDC software.
“Minimum System Requirements” on page 23 for more information on compatible versions of IIS software.
To install IIS-based SDC:
1. Insert the WebTrends CD-ROM into your CD-ROM drive.
• If not, click Start > Run to open the Run dialog box, and type d:\setup where d: is the letter of your CD-ROM drive.
2. Review the contents of the InstallShield Wizard Welcome dialog box and click Next to
open the License Agreement dialog box.
3. Review the NetIQ SmartSource Data Collector License Agreement.
• If you agree to the terms of the Agreement, select I accept the terms in the license
agreement and then click Next.
• Otherwise, click Cancel to exit the installation. Note: Click Cancel at any time to exit the installation.
4. Select the destination folder.
• To accept the default destination folder, click Next. Or
• To specify a location other than the default destination folder, click Change. - The Change Current Destination Folder opens.
- Browse to the location you want or type the location in the Folder name text box. Click OK.
Then
- In the Destination Folder dialog box, click Next. The Read to Install the Program dialog box opens.
5. Click Install to begin the installation.
An Installing WebTrends SmartSource Data Collector dialog box opens and begins the installation process.
The Server Type dialog box opens.
6. Select Internet Information Server (IIS) and click Next.
The InstallShield Wizard Completed dialog box opens.
Starting SDC
The installation program creates a fully configured web site named SmartSource Data Collector. For more information on server configuration and the dcs.cfg file, see “SDC Configuration Reference” in the WebTrends Technical Reference Guide.
You can restart IIS to activate SDC by entering the following commands at a command prompt:
net stop iisadmin /y net start w3svc
The SDC server is now configured and listening for instrumented hits on Port 80.
For information about enabling secure communication from web clients to SDC using the Secure Sockets Layer protocol, see “Secure Socket Layer (SSL)” in the WebTrends Technical Reference Guide.
Installing Apache-Based SDC on Linux or Unix
This section describes installing the SmartSource Data Collector on the Linux platform (Red Hat Enterprise Linux only) or Unix platform (Solaris).
Uninstalling Previous Versions
Before installing the Apache web server shipped with SDC, remove any previous installation of the Apache web server. See “Uninstall Apache on Linux” on page 63 and “Uninstall Apache on Unix” on page 64.
Before installing an Apache-based SDC upgrade you must remove any previous version. See “Uninstall Unix Apache-Based SDC (Solaris only)” on page 64.
Installing Apache and SDC
To install Apache-based SDC: 1. Switch user to root.
2. Make a temporary directory.
mkdir <tempdirectoryname> 3. Change to the temporary directory.
cd <tempdirectoryname>
4. Copy the SDC distribution source to the temporary directory. Linux cp <source path>/sdc–linux.i586.tar.gz . Unix cp <source path>/sdc-solaris.sparc.tar.gz . 5. Uncompress the source.
Linux tar -zxvf sdc–linux.i586.tar.gz
Unix gzip cd sdcsolaris.sparc.tar.gz | tar xvf -6. Change to the directory containing the SDC software.
cd sdc-version number
7. Run installation script. ./install.sdc
8. The Welcome Panel introduces the installation.
Note: The installation script prompts for all necessary information. Press Ctrl-C at any time to interrupt the installation script.
At each script prompt, default values are enclosed in square brackets. Press Enter to accept default values or type an alternate value and press Enter.
For prompts requiring a Yes or No response, the default value is capitalized in square brackets. For example, [Yn] is a yes default and [yN] is a no default. Press Enter to accept the default, or type an n or a y, and press Enter.
For questions requiring a numeric response, type the number followed by Enter. The default value is enclosed in square brackets. For example, [2] means menu item 2 is the default. Press Enter to accept default values or type an alternate value and press Enter. Press Enter to view the WebTrends license agreement.
9. Read the license agreement carefully.
• Press the SpaceBar to scroll the agreement. • Type q to finish viewing the agreement.
10.To accept the agreement, type accept and press Enter.
Any other response implies non-acceptance of the agreement and cancels the installation.
11.Specify the installation directory.
• Press Enter to accept the default directory (/usr/local/webtrends/sdc).
Or
• Type the directory where SDC should be installed and press Enter.
12.Confirm the directory.
• Press Enter to confirm the directory. Or
• Type n followed by Enter to change it. 13.Next, you are prompted for your license key.
• Immediately following the colon prompt, type the license key. • Press Enter.
14.Confirm the license key.
• Press Enter to confirm the license key. Or
• Type n followed by Enter to change it.
If you have more than one license key, repeat the previous two steps for each license key. You can add more license keys later by running wtlicman from the command line.
15.End license key input by pressing Enter at the colon prompt.
Important: At this point, if you do not have a valid internet connection, you will receive a Manual Activation Text, which you must send to NetIQ’s licensing servers. You can continue to install the SDC software, but before you can use it you will be instructed to follow the steps listed in <SDC_installation_directory>/bin/manual_activation.txt. These steps describe how to manually license the product.
16.Press Enter again to advance to the next prompt.
17.(Solaris only) Specify the web server that you are using by typing the number
corre-sponding to Apache, followed by Enter.
Configuring the Apache-Based Cookie Server
Complete the following steps:
1. Enable the SDC-based cookie server?
• Press Enter (recommended) to accept the Yes default. Or
• Type n followed by Enter and go to “Configuring the Apache-Based Log File” on page 48.
The enabled setting in the SDC configuration file is set to true or false based on your response to this prompt.
2. If you have a previous version of a WebTrends cookie plug-in AND are installing SDC
on the same domain, you may continue to use the same cookie name and format. (This is not a likely scenario.)
• To use an existing WebTrends cookie, type y and press Enter. • To accept the default and create a new cookie, press Enter.
If you chose to use an existing WebTrends cookie, the cookieversion setting in the SDC configuration file is set to 1; otherwise it is set to 2 (which enables cookie validation).
3. Enter the cookie name.
• Press Enter to accept the default name (WEBTRENDS_ID). Or
The value entered is assigned to the cookiename setting in the SDC configuration file.
4. Validate incoming cookies?
• Press Enter to accept the default (Yes). Or
• Type n followed by Enter. Go to 7.
Validation checks to make sure that the cookie has not been tampered with by a web client.
The validatecookie setting in the SDC configuration file is set to true or false based on your answer to this prompt.
5. Specify the cookie validation private key (Magic Code).
• Press Enter to accept the default Magic Code. Or
• Type an alternate Magic Code and press Enter.
This setting is used as a private key when creating a message authentication check for the cookie values. It is recommended to create a Magic Code that consists of numbers and letters and is 6-10 bytes long.
The value entered is assigned to the magiccode setting in the SDC configuration file.
6. Issue a new cookie when an invalid cookie is detected?
• Press Enter to accept the default (Yes). Or
• Type n followed by Enter.
Reissuing cookies involves logging the existence of the invalid cookie in the SDC log file and adding a Set-Cookie header to the HTTP response.
The reissuebadcookie setting in the SDC configuration file is set to true or false based on your response to this prompt.
7. Specify the type of cookie expiration by typing the corresponding number followed by Enter. The default is to generate cookies that expire after ten years.
• Expire after a given amount of time generates a cookie that expires at a specified period of time after the cookie is created.
Specify the number of seconds after which the cookie is to expire and press Enter. Or press Enter to accept the default cookie expiration (315360000 seconds = 10 years).
The number entered is assigned to the expirationseconds setting in the SDC configuration file.
• Expire on a given date generates a cookie that expires on a certain date.
Specify the date on which the cookie will expire and press Enter. Or press Enter to accept the default date (January 1, 2010). Enter the date using the “MM-DD-YY” format.
The date entered is assigned to the expirationdate setting in the SDC configu-ration file.
• None generates session-only cookies that do not get saved to the client’s disk. The expirationtype setting in the SDC configuration file is assigned to either seconds, date, or none based on your answer to this prompt.
8. Specify the path of the subset of URLs in a web site for which a cookie is valid.
• Press Enter to accept the default path (/). Or
• Type the path and press Enter.
The path entered is assigned to the path setting in the SDC configuration file.
9. Transmit cookie over secure connections only?
• Press Enter to accept the default (No). Or
• Type y followed by Enter.
The secure setting in the SDC configuration file is set to true or false based on your answer to this prompt.
10.Specify if web clients should send HTTP requests to a targeted domain.
Blank domain uses the domain from which the client issued the request. This is almost always the desired result.
Or
• Type the domain and press Enter.
The domain entered is assigned to the domain setting in the SDC configuration file.
11.Enable first-time cookie detection?
• Press Enter to accept the default (Yes). Or
• Type n followed by Enter.
The track first-time cookies setting in the SDC configuration file is set to true or false based on your answer to this prompt.
Configuring the Apache-Based Log File
Complete the following steps:
1. Specify a directory where SDC-enabled server should store log files.
• Press Enter to accept the default directory: /usr/local/webtrends/sdc/weblog. Or
• Type the directory and press Enter.
The directory entered is used as part of the TransferLog directive in the Apache configuration file.
2. Specify the log rotation period.
You can rotate log files daily, weekly, in a number of hours, or hourly. In addition, in the next step, you can rotate log files when they reach a certain size. See “Log File
Monitoring” on page 179 for a discussion of log file rotation.
• Rotate by minutes specifies the number of minutes to elapse between a log file rotation.
Press Enter to accept the default (30 minutes), or type a valid number and press
Enter. (Accepted values are 1, 2, 3, 4, 5, 5, 10, 12, 15, 20, and 30). This setting is
assigned to the minutesinterval setting in the SDC configuration file.
- Press Enter to accept the default (1 hour). Or type a number (1, 2, 4, 6, 8, or 12) followed by Enter.
- The specified number is assigned to the hoursinterval setting in the SDC configuration file.
• Rotate Daily is the default period. Press Enter to accept. • Rotate weekly specifies the day of the week to start rotation.
Press Enter to accept the default (Sunday). Or type the number corresponding to the day that you prefer and press Enter.
The weekstart setting in the SDC configuration file is assigned to either Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, or Sunday based on your response to this prompt.
The rotationperiod setting in the SDC configuration file is assigned to daily, weekly, hourly, or minutes based on your response to this prompt.
3. Rotate log files when they reach a given size? Select one:
• Press Enter to accept the default (Yes).
Specify the maximum log file size by typing a number (of Kbytes) and press Enter, or press Enter to accept the default (2,000,000 Kbytes).
The number entered is assigned to the maxlogfilesize setting in the SDC config-uration file.
Or
• To not limit the size of log files, type n followed by Enter.
The limitbysize setting in the SDC configuration file will be set to true or false based on your response to this prompt.
4. Rotate log files based on GMT?
• Press Enter to accept the default (local time). Or
• Type y followed by Enter.
The gmtrotation setting in the SDC configuration file will be set to true or false based on your response to this prompt.
Or
• Type a log file prefix followed by Enter.
The log file prefix entered is assigned to the logfileprefix setting in the SDC config-uration file.
6. Log hits containing invalid cookies?
• Press Enter to accept the default (no invalid hit logging). Or
• Type y followed by Enter.
The loginvalidhits setting in the SDC configuration file will be set to true or false based on your response to this prompt.
7. Issue a P3P (Policy for Privacy Preferences) header?
• Press Enter to accept the default (no P3P header). Or
• Type y followed by Enter.
- Specify the P3P header in the event that none was received via the SDC tag. - Press Enter to Accept the Default, or type the P3P header and press Enter. - The P3P header entered is assigned to the p3p setting in the SDC configuration
file.
The issuep3p setting in the SDC configuration file will be set to true or false based on your response to this prompt.
See “P3P and SDC” in the WebTrends Technical Reference Guide for more information related to P3P and how it impacts SDC.
8. Specify the default log elements to write to a log file.
• Press Enter to accept the default log elements as displayed. Or
• Enable or disable log elements:
- Type the number corresponding to a log element followed by y (to enable) or n (to disable).
The settings in the logfields section will be set to true or false based on your response to this prompt.
9. Determine where to write errors and warning messages.
• Press Enter to accept the default (write to both the SDC Audit Log and Syslog). • Type 1 and press Enter to write to the SDC Audit Log only.
• Type 2 and press Enter to write to syslog only. Go to 11.
Your selection is assigned to the type setting in the SDC configuration file.
10.If you are writing errors and/or warnings to SDC Audit Log:
• Press Enter to accept the default (write both errors and warnings). Or
• Type 1 and press Enter to write errors only. Go to 12.
Your selection is assigned to the debuglevel setting in the SDC configuration file. 11.If you are writing errors and/or warnings to syslog:
• Press Enter to accept the default (write errors only). Go to 15. Or
• Type 2 and press Enter to write both errors and warnings.
Your selection is assigned to the system debuglevel setting in the SDC configuration file.
12.Limit the size of the SDC Audit Log?
• Press Enter to accept the default (No). That is, the Audit Log can grow unbounded. Go to 15.
Or
• Type y and press Enter to limit the size.
Your selection is assigned to the auditlimitbysize setting in the SDC configuration file.
13.Specify the maximum SDC Audit Log file size in Kbytes and press Enter or accept the
default size.
14.Specify the amount (in Kbytes) of the SDC Audit Log file to retain after truncation and
press Enter or accept the default size.
This entry is assigned to the audittrimsize setting in the SDC configuration file. 15.Accept or change the SDC configuration parameters as listed?
• Press Enter to accept the SDC configuration parameters. Or
• Type n followed by Enter to change the SDC configuration parameters.
Configuring the Apache-Based Web Server (Solaris only)
To configure the Web server:
1. Install the supported version of Apache?
• Press Enter (recommended) to accept the default (Yes). Or
• Type n followed by Enter.
If you chose to not install Apache, go to 14.
2. Specify the installation directory for Apache.
• Press Enter to accept the default directory (/usr/local/apache). Or
• Type the directory and press Enter.
3. Confirm the Apache installation directory.
• Press Enter to confirm the directory. Or
• Type n followed by Enter to change it. 4. Press Enter to view the Apache license agreement. 5. Read the license agreement carefully.
• Press the SpaceBar to scroll the agreement. • Type q to finish viewing the agreement.