WebTrends 7 Installation and Configuration Guide

(1)

WebTrends 7

Installation and Configuration Guide

(2)

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.

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.

(3)

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

(4)

(5)

Introduction...11

How to Use This Guide ... 11

Minimum System Requirements ... 12

Documentation ... 16

Getting help in the program ...16

Providing feedback ...17

Additional resources ...17

Visual cues in WebTrends documentation ...19

Chapter 2

Installation ... 21

Overview ... 21

Licensing ... 21

How WebTrends is licensed ...22

Licensing modes ...22

Working with license keys ...22

Checking the license status ...24

WebTrends On Demand Licensing ... 24

How WebTrends On Demand is licensed ...24

Checking the license status ...25

Basic Installation ... 26

Prerequisites ...26

Network ...27

Security ...27

(6)

Installing WebTrends software ... 28

Activating licensing ... 31

Installing WebTrends Sample Data ...31

Installation/SmartSource Data Collector Component ...32

Installing on Windows 2000/2003/XP ... 32

Installing on Linux or Unix ... 39

Enabling SSL ...51

SSL for Apache-based SDC ... 52

IIS-based SDC ... 57

Uninstalling the SmartSource Data Collector ...57

Uninstalling on Windows 2000/2003/XP ... 58

Uninstalling on Linux or Unix ... 60

Upgrading Apache ... 62

Custom Installation—Distributed Architecture ...66

Introduction ... 66

General guidelines ... 68

Installation steps ... 69

Managing your distributed installation ... 74

Migrating Manually ...74

Supported migrations ... 75

Migration components ... 75

Preparing for migration ... 75

The migration process ... 76

Migration example ... 79

Chapter 3

WebTrends On Demand Accounts ... 81

Registering for WebTrends On Demand Enterprise ...82

Registering for WebTrends On Demand Professional ...83

(7)

Enterprise and Professional Account Console ... 91

Working with user settings ...93

Changing account information ...95

Viewing account history ...97

Creating an account ...98

Instructions for WebTrends On Demand Small Business ... 99

Small Business Account Console ... 103

Additional Concepts and Definitions ... 105

Chapter 4

WebTrends User Accounts...107

Overview ... 107

Adding Users ... 107

About Users’ View Only Permissions ... 110

Chapter 5

Working with the Report Designer ... 111

Report Templates ... 111 Template settings ... 111 Applying templates ... 114 Report Dashboards ... 115 Dashboard settings ... 115 General tab ... 115 Content tab ... 116 Report Options ... 117 Reports ... 117 Report templates ... 118

(8)

Chapter 6

Express Viewer ...119

Introduction ... 119

Express Viewer Restrictions ... 119

Installation instructions ...120

Configuration instructions ...121

Uninstalling the Express Viewer ... 121

Chapter 7

Profile Setup ... 123

How Profiles Work ... 123

Adding Profiles ... 124

Launching the New Profile Wizard–On Demand only ...124

Launching the New Profile Wizard–Software only ...131

Editing previous settings ...149

Configuration file reference ...149

Chapter 8

SDC Operations and Monitoring...151

Operations ... 151

Starting and stopping the SmartSource Data Collector ...151

Apache-based SDC ...152

IIS-based SDC ...156

SDC audit log ...157

Hit count tracking ...161

Monitoring ... 168

Installation monitoring ...169

Log file monitoring ...169

Hit validation ...169

(9)

Log file rotation ... 171

Logging behavior ... 171

Monitoring the log file ... 171

Chapter 9

Instrumenting Web Pages ...173

Overview ... 173

SDC JavaScript Tags ... 173

SDC JavaScript tag modifications ... 174

SDC JavaScript tag placement ... 177

Inserting the SDC JavaScript tag ... 177

SDC VBScript Tags ... 179

SDC VBScript tag modifications ... 180

SDC VBScript tag placement ... 183

Using HTML <META> Tags ... 183

Syntax ... 183

(10)

(11)

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 as a WebTrends On Demand, Small Business Edition user, features and content areas applicable to you include this

icon:

If the content does not apply to your WebTrends edition, you will 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 either 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

(12)

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 along with SDC, and GeoTrends.

WebTrends Small Business

• 2.0GHz or higher processor • 1GB of RAM

• 50GB of free hard disk space (7200 RPM IDE) • 10/100 Mbps network interface

These requirements are based on 5 profiles, and 2 concurrent users.

Note: If you choose to run GeoTrends on the same machine as WebTrends v7.0 you will need

an extra 1024MB of RAM. If you are processing more than 100,000 page views a day you will need an extra 1024MB of RAM. If you run GeoTrends and have more than 100,000 pv/day, then you will need an extra 2048MB of RAM.

Note: If you want to convert WebTrends reports to alternate formats, or use WebTrends

SmartReports for Microsoft Excel, WebTrends also requires Office 2000 or above, and the Sun Java Runtime Environment v1.3.1_11.

WebTrends On Demand Professional Edition WebTrends On Demand Enterprise Edition

(13)

WebTrends Professional

WebTrends Enterprise

At least two machines with:

• Dual 2.8GHz or higher processors • 2GB of RAM

• 200GB of free hard disk space (15,000 RPM SCSI) • 10/100/1000 Mbps network interface

(14)

WebTrends Supported

Operating Systems and Browsers:

• Windows 2000 SP3 or higher, XP SP1 or higher, or 2003 • Microsoft Internet Explorer v5.5 or higher

WebTrends Enterprise can scale in many different ways. Contact Professional Services for a solution that best meets your needs.

WebTrends Desktop (for viewing reports)

• 512 MB of RAM

• Microsoft Internet Explorer v5.5 or higher

• Microsoft Office 2000 or higher (required for Report Exporter) • Sun Java Runtime Environment v1.3.1_11

Large environments will require multiple machines. Additional RAM improves performance. SCSI RAID 10 (also known as RAID 0+1) is recommend for the best disk performance.

SmartSource Data Collector (SDC) Hardware

• Windows/Linux: 1.0GHz or higher processor

• Solaris: Dual 400 MHz UltraSparc-II processors or better • 1GB of RAM

• Enough disk space to store the expected contents of your log files (7200 RPM IDE) • 10/100 Mbps network interface

(15)

SDC Hardware

processing more than 100,000 Daily Page Views

• Windows/Linux: Dual 2.0GHz or higher processors

• 2GB of RAM

• Enough disk space to store the expected contents of your log files (15,000 RPM SCSI)

• 10/100 Mbps network interface

SDC Supported Operating Systems

• Windows 2000 SP3 or higher, XP SP1 or higher, 2003 • Solaris 2.8 or 2.9

• Red Hat Enterprise Linux AS (Advanced Server)/ES (Enterprise Server) v3.0

SDC Supported Web Servers

• Apache Web Server v2.0

• Microsoft Internet Information Server v5.0 or v6.0

For larger sites, it may be necessary 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 the various load-balancing techniques. Contact Professional Services for a solution that best meets your needs.

GeoTrends Hardware

(16)

GeoTrends Hardware

processing more than 100,000 Daily Page Views

• Dual 2.0GHz or higher processors

• 2GB of RAM

• 30GB of free hard disk space (15,000 RPM SCSI) • 10/100 Mbps network interface

GeoTrends Supported Operating Systems

• Windows 2000 SP3 or higher, XP SP1 or higher, 2003

If you choose to run GeoTrends on the same machine as WebTrends v7.0 you will need an extra 1024MB of RAM. If you are processing more than 100,000 page views a day.

Documentation

There are a variety of online help resources and manuals—such as this one—to help you install, configure, and use WebTrends to its full potential.

• The online resources are detailed in the following section.

• See “Additional resources” on page 17 for a list of other manuals that are available as *.pdfs to WebTrends users.

Getting help in the program

WebTrends includes detailed online 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.

(17)

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 panels.

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-hand 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:

(18)

• 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 User Guide to these WebTrends users as a introduction to navigating WebTrends reports and report data.

• WebTrends Technical Reference Guide

This guide serves as 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.

These manuals can be found in the Documentation directory on your WebTrends installation CD, or downloaded from our website.

To download the *.pdf files from the WebTrends web site, do either of the following:

• If you are logged into WebTrends:

1) From the Admin Console, select Help from the left pane of the Admin Console, then select Documentation and Release Notes from the right pane. 2) The Documentation page of the WebTrends web site opens in a new browser

window. Browse to the *.pdf you want to download. • Paste the following URL into your browser’s address bar:

http://product.webtrends.com/

(19)

Visual cues in WebTrends documentation

The following table describes the typographic changes used in this and other guides to using WebTrends:

Note: Please see Table 1-1, “Edition Icons,” on page 11 for details on using the WebTrends edition logos to determine which features apply to the WebTrends edition you are using.

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 inter-face).

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.

(20)

(21)

Chapter 2

Installation

Overview

In this chapter:

• Licensing summary (see below)

• “Basic Installation” on page 26 which includes:

− “Installation/WebTrends components” on page 28 (including the optional GeoTrends data file)

− “Installing WebTrends Sample Data” on page 31

− “Installation/ SmartSource Data Collector Component” on page 32

• “Custom Installation—Distributed Architecture” on page 66

• “Migrating Manually” on page 74

Licensing

This section discusses how WebTrends and WebTrends On Demand are licensed, how product keys are activated in software versions, and where you can find status information for your license.

(22)

How WebTrends 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.

• 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.

(23)

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.

(24)

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.

WebTrends On Demand Licensing

This section describes how these products are licensed and how to check the status of the license:

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.

(25)

• 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.

(26)

• 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.

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.

Basic Installation

This section covers basic installation procedures for WebTrends Small Business and WebTrends Professional. WebTrends Enterprise customers, please refer to “Custom Instal-lation—Distributed Architecture” on page 66.

Prerequisites

Please be sure to complete the following:

• Review the system, browser, and screen resolution requirements in “Minimum System Requirements” on page 12 to ensure optimum performance of WebTrends on your system.

• Collect any valid license keys for the product, Add-On licenses, or subscriptions. • If you are also installing the WebTrends SDC component on Apache, and you have a

version of Apache earlier than v2.0.48, you must remove it before installing SDC. A later version of Apache will be installed along with SDC. See “Uninstall Apache on Windows” on page 58 for instructions.

(27)

• You must remove any pre-existing SDC installation before installing this version. See

“Uninstall Windows Apache-based SDC” on page 58.

You can then choose from the following installation paths to install WebTrends, including the SmartSource Data Collector (SDC) and GeoTrends:

• “Installation/WebTrends components” on page 28 (this includes GeoTrends) • “Installing WebTrends Sample Data” on page 31

• “Installation/ SmartSource Data Collector Component” on page 32

• “Installing on Linux or Unix” on page 39

• “Enabling SSL” on page 51

Network

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 utilize 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

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

(28)

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 employed 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 corresponding 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.

Installation/WebTrends components

Installing WebTrends software

This section covers a typical installation of WebTrends (and the optional GeoTrends data file) for WebTrends Small Business and WebTrends Professional.

• For details on SDC installation, please see page 32.

• For details on installing the optional WebTrends samples, please see page 31.

• WebTrends Enterprise customers, please see “Custom Installation—Distributed Archi-tecture” on page 66.

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:

(29)

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. If you accepted the License Agreement, the Select Install Type window opens with the Typical option selected. (Not applicable to WebTrends Small Business)

Note: See “Custom Installation—Distributed Architecture” on page 66 if you are wanting custom installation instructions.

6. The Destination Folder window opens. The default installation folder is: X:\Program Files\WebTrends

where X is the hard drive you are installing to.

Complete 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 selected 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.

(30)

9. Click Next.

10.The System Database Initialization window opens showing the host, port number, and

administrator information. Enter and confirm your password, and click Next.

Note: This is the password for the database, not the WebTrends User Interface. Also, if

this is a subsequent WebTrends installation, only the information used during the first installation is valid here. See your WebTrends administrator if you have questions.

11.The Specify Storage locations window opens, showing the default folders for:

• Analysis Data Repository • Report Data Repository • Configuration Repository • Backup Repository

Note: It is important to consider your need to use shared locations before proceeding. If

you add additional machines later, they will need access to these locations. For further information on subsequent installations, see “Managing your distributed installation” on page 74.

Make any changes needed; otherwise, click Next to select the default locations and continue.

12.You are prompted to return to previous screens if you need to edit your installation

choices. If you do not wish to do so, click Install.

13.TheWebTrends program files are installed to your machine.

14.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 wizard.

• If you also selected SmartSource Data Collector in step 7, you will need to complete additional installation steps. See “Installation/ SmartSource Data Collector

Component” on page 32 for that list.

15.If a previously installed version of WebTrends v6.x is detected, you are asked if you

would like to migrate data to your new installation.

• Click Yes if you want to migrate data from your previous installation to WebTrends v7.0.

(31)

• Click No if you want to complete the installation without migrating data. You can manually migrate data later. Refer to “Migrating Manually” on page 74 for details.

Activating licensing

When you first launch WebTrends, if you did not provide a valid license key during instal-lation, you will have to provide a valid license key—or legacy serial numbers or add-on keys— in order to register the product. After WebTrends accepts the license key, the Login screen will open.

You can then provide your WebTrends username and password to log into WebTrends. (If you don’t have this information, please see your WebTrends administrator.)

Installing WebTrends Sample Data

WebTrends sample data is available via a separate download.

To install a WebTrends sample, complete these steps: 1. Complete either of the following:

• Locate the sample you want to install on your product CD. Choose from: - ZedescoODDBSample.exe

- ZedescoWithLogsSample.exe - StreamingMediaSample.exe

• Browse to the Accessories page of the WebTrends website at:

<http://product.webtrends.com/

ptw.aspx?action=10&prodtype=wrc&version=7.0> a.From the Accessories page, select Sample Downloads.

b.Follow the instructions to download the sample of your choice to your network. 2. Double-click Sample.exe, or use your Windows Start>Run to launch the installation

wizard. Click Next.

3. Click Next to accept the license agreement. You will not be able to install the samples

(32)

4. The Custom Setup window opens. Select the samples you want to install, and click Next.

If you are unfamiliar with using this type of installer, 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 wizard will list 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.

Installation/

SmartSource Data Collector Component

You can install SDC to run on Linux/Unix platforms (see page 39) or on Windows platforms (see the next subsection).

Installing on Windows 2000/2003/XP

The following subsections describe how to install the SmartSource Data Collector on Windows 2000/2003/XP platforms:

• Apache-based installation is described on page 32. • IIS-based installation is described on page 37.

Apache-based installation

Uninstall previous versions

(33)

If a version of Apache earlier than v2.0.48 is installed, you must remove it before installing SDC. If you are installing an SDC upgrade, you must remove any pre-existing SDC. See “Uninstall Apache on Windows” on page 58 and “Uninstall Windows Apache-based SDC” on page 58.

Installing the Apache web server and SDC

If you select SmartSource Data Collector during step 7 of your WebTrends installation (page 29), an Installation wizard for SmartSource Data Collector opens after the WebTrends core component installation is complete.

The additional installation steps for the Apache web server and SDC are: 1. After 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

(34)

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.

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 server name you enter is used to modify the httpd.conf file.

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

(35)

# 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 emailed.

• 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.

The Setup Type dialog opens.

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.

(36)

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.

The Ready to Install dialog box opens.

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

(37)

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.

IIS-based installation

Uninstall previous version of IIS-based SDC

Before installing an IIS-based SDC upgrade, you must remove any previous version. See

“Uninstall Windows IIS-based SDC” on page 60.

Install IIS-based SDC

Note: Prerequisite – You must install a supported version of IIS before installing the

IIS-based SDC software. “SDC Supported Web Servers” on page 15 for more information on compatible versions of IIS software.

Complete the following steps:

1. Insert the WebTrends 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, 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.

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.

(38)

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.

7. Click Finish. The SDC installation is complete.

Start SDC

The installation program creates a fully configured web site named SmartSource Data Collector. For more information on server configuration, refer to “IIS Configuration” on page 94, and for a complete reference on the dcs.cfg file, “Configuration Reference” on page 77.

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. If you want to enable secure communication from web clients to SDC using the Secure Sockets Layer protocol, refer to “Enabling SSL” on page 51.

(39)

Installing on Linux or Unix

The following subsections describe installing the SmartSource Data Collector on the Linux platform (Red Hat Enterprise Linux only) or Unix platform (Solaris):

Apache-based installation

Uninstall 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 60 and “Uninstall Apache on Unix” on page 61.

Before installing an Apache-based SDC upgrade you must remove any previous version. See “Uninstall Unix Apache-based SDC (Solaris only)” on page 61.

SDC and Apache installation

1. Switch user to root. su 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

(40)

-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.

(41)

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.

Apache-based cookie server configuration

1. Enable the SDC-based cookie server?

• Press Enter (recommended) to accept the Yes default. Or

• Type n followed by Enter and go to “Apache-based log file configuration” on

(42)

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

• Type a new or an existing name for the WebTrends cookie and press Enter. 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

(43)

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?

• 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.

(44)

• 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.

• Press Enter to accept the default (blank 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?

The track first-time cookies setting in the SDC configuration file is set to true or false based on your answer to this prompt.

Apache-based log file configuration

1. Specify a directory where SDC-enabled server should store log files.

• Press Enter to accept the default directory: /usr/local/webtrends/sdc/weblog.

(45)

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 194 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.

• Rotate by hours specifies the number of hours to elapse between log file rotation. - 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).

(46)

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

The gmtrotation setting in the SDC configuration file will be set to true or false

based on your response to this prompt.

5. Specify a log file prefix.

• Press Enter to accept the default prefix (sdc). 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

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

(47)

- 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” on page 207 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).

- Press Enter when you are done.

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:

(48)

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.

This entry is assigned to the auditmaxsize setting in the SDC configuration file. 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.

Apache web server configuration (Solaris only)

1. Install the supported version of Apache?

• Press Enter (recommended) to accept the default (Yes). Or

(49)

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.

6. To accept the agreement, type accept and press Enter.

Any other response implies non-acceptance of the agreement and cancels the installation of Apache.

7. Specify the user name.

• Press Enter to accept the default user (nobody). Or

• Type a user name followed by Enter.

The user entered is assigned to the User directive in the Apache configuration file. 8. Specify the group.

• Press Enter to accept the default group (nobody). Or

• Type the group followed by Enter.

The group entered is assigned to the Group directive in the Apache configuration file.

9. Specify the e-mail address that the server uses to send error messages.

(50)

Or

Press Enter to accept the default ([email protected]).

The e-mail address entered is assigned to the ServerAdmin directive in the Apache configuration file.

10.Specify the port number.

• Press Enter to accept the default port number. Or

• Type the port number followed by Enter.

11.Specify the server name.

• Press Enter to accept the default host name. Or

• Type the name of the server followed by Enter.

The name entered is assigned to the ServerName directive in the Apache configuration file. The following is a description of the ServerName directive found in the httpd.conf

file.

# 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.

(51)

• Press Enter to accept the default and configure SDC so that it starts up automati-cally at boot time. This copies a start up script into the /etc/rc.d/init.d directory (Linux) or the /etc/init.d directory (Unix).

Or

• Type n followed by Enter to start SDC manually.

13.Accept the Apache parameters?

• Press Enter to accept the Apache configuration parameters as listed. Or

• Type n followed by Enter to change one or more of the parameters.

The installation script unpacks files, configures SDC, configures the web server, and starts the web server.

The SDC server is configured and listening for instrumented hits on Port 80. Press Enter to advance to the next screen.

14.Read the release notes?

• Press Enter if you want to read the SDC release notes. Or

• Type n followed by Enter to ignore them.

If you want to enable secure communication from web clients to the SDC using the Secure Sockets Layer protocol, refer to the next section “Enabling SSL”.

Enabling SSL

Sensitive information is often transmitted between web clients and web servers. This infor-mation is typically protected by sending the data in an encrypted form and subsequently decrypting that data on the receiving side. The Secure Sockets Layer (SSL) protocol provides several features that enable secure transmission of web traffic. These features include data encryption, server authentication, and message integrity.