ILux Windows SQL Anywhere Installation Guide

You will save yourself time by reading this document before installing ILux. This document describes several key pieces of information you will need to gather before Installing ILux.

ILux can be configured for a variety of operating systems and databases. In addition, you can place the various components on one or more servers. This flexibility allows you to adapt ILux to your existing Internet or Intranet server configuration. Because ILux is so flexible, be sure to closely review the information below. For performance reasons, you may at several points in the process find it a good idea to put one of the ILux components on a different server or in a different location.

Contents

• A Conceptual Overview of ILux
• Preparing to Install ILux
• Installing the ILux Server
• Starting the ILux Server
• Stopping the ILux Server

A Conceptual Overview of ILux

ILux is a client/server application for analyzing web site usage. ILux is comprised of several components that can be installed in a fully distributed environment.

The basic components are:

The ILux Server

The server is the central component, and is used to import, parse, store, and index information from your web server's log files. The ILux Server also serves all ILux client requests. This version of ILux can be installed on Windows NT (versions 3.51 and higher, Server or Workstation) and Windows 95. The ILux Server requires a LAN, WAN, or FTP connection to the web site(s) that will be analyzed, and a read/write local or network connection to all ILux components.

The ILux Database

The database is automatically generated during installation, and can be stored in any location (local or network) of which the ILux Server has sufficient storage and read/write privileges.

The ILux Client

The client is a Java-based application and is the user's interface to ILux. The ILux client can be run from any computer that has an Internet connection to the ILux server.

The ILux Reports

The ILux reports are the final output from all web site analyses. The reports are in HTML format. For the reports to be viewed over Internet, this directory must be located anywhere under a web server's web root directory. You also have the option to write the reports to your local workstation or to a network server.

Preparing to Install ILux

The installation procedure requires you to make decisions on directory locations for the ILux components and will ask you for specific information about your mail server and the web sites to be monitored.

The ILux Server

The ILux Server occupies approximately 10MB of disk space, and can be installed to any local directory. The default location is:

<windows_drive>:\Program Files\ILux

The Database

Database Installation

The database is created automatically during installation.

Database Location

The ILux Database can be stored in any storage location in which the ILux Server has read/write privileges. For optimum performance, we recommend you install the database on the local machine. The default location is:

<windows_drive>:\Program Files\ILux\Data

Make sure this location has sufficient storage, which should be at least twice the size of the total web site log files to be analyzed. Be sure to allow room for future growth.

Your Web Site(s)

The ILux server needs the following information for each web site to be analyzed. Depending on the capacity of the machine hosting the ILux server, you can monitor several web servers. (Your initial ILux license allows you to monitor up to three.) However, you should consider possible degradation in performance when monitoring a number of large web sites. In this circumstance, you should consider purchasing additional licenses.

When you add a web site, ILux validates the information you enter. Be sure to enter the information carefully. If for any reason ILux cannot validate the information, and you know that the information is correct, you will be able to proceed, but will be required to manually enter the IP address for each HTTP and FTP server you specify.

Host Name

The domain name of the web site, for example,

webserver.mydomain.com

or

www.mydomain.com.

Port Number

The default port number (80) is usually acceptable. If for any reason you need to use a different port number, select one and prepare to alert users to use it for all ILux clients as well.

Web HTTP Hostname

Enter the directory under which all web files are served.

If you have a network connection with read access you can specify the web root directory by UNC name or DOS path, such as:

\\webserver\html (UNC)

or

h:\html (DOS path)

You can also access the web directory structure via FTP. Enter the FTP address of the host and the userid and password, if required. If anonymous access is supported, then enter the anonymous userid.

For example:

ftp.hostdomain.net
bfrank (your userid)
[enter password] (normal)

or

ftp.hostdomain.net
anonymous (your userid)
[blank--enter nothing] (anonymous)

Web HTTP Directory

Enter the relative path from the host machine's FTP root directory to the HTTP root directory for the web server. If the root of the FTP server is the same as the HTTP server root, you can leave this field blank.

For example,

/home/userid/public_html

Log File Hostname

If you have a network connection and appropriate privileges you can specify the log file directory by UNC name or DOS path, such as:

\\webserver\logs (UNC)

or

h:\logs (DOS path)

If you do not have a network connection, you can also access the log files via FTP, using a normal or anonymous login, such as:

ftp.hostdomain.net
bfrank (your userid)
[enter password] (normal)

or

ftp.hostdomain.net
anonymous (your userid)
[blank--enter nothing] (anonymous)

Log File FTP Directory

E nter the relative path from the host machine's FTP root directory to the log file directory on the web server.

For example:

/home/userid/logs

Name of Log File(s)

Case Sensitive Log Files

Port Number

The TCP/IP port that is used by the web server for HTTP communication. This is typically port 80.

The ILux Client

During ILux server install, you have the option of installing the ILux Java client on the HTTP server. This client can be launced from a web browser. It is useful for individuals who do not have an ILux client installed on their local machine. It is a little slower than the Java client on your local machine.

The files for the web browser-based ILux Java Applet must be placed under a web server root on the SAME machine as the ILux Server and its storage requirement is approximately 1.2MB. Its default location is:

[HTTP_root]/home/html/ userid/public_html/ilux/client

T he ILux Java application client installation files reside in a separate directory under the main ILux server directory. The default location is:

<windows_drive>: \Program Files\ ILux\Client Install

For convenience, this directory and its contents should be placed in a shareable directory for ease of client installation.

ILux Report Directory

ILux produces all its reports in HTML format. For the reports to be viewed by a browser, the report directory must be located anywhere under a web server's web root directory. Because ILux reports are typically for internal use, we suggest that you specify a location to store the reports that is located on a password protected Internet location or an Intranet web server.

SMTP Server

ILux allows e-mail notifications to be sent to users for certain events, such as when reports have completed. Therefore, ILux requires the SMTP mail server's DNS name or IP address used by the domain, such as postmaster.mydomain.com.

Installing the ILux Server

Before beginning installation, be sure you have collected all the information described in the previous portions of this Guide.

T To install ILux, simply double click on the self-extracting file ilux152sqlany.exe in the same location as this file. Follow the install instructions step by step. After you complete installation, review the remainder of this Guide.

Starting the ILux Server

You can use these parameters for either the Windows NT ILux log reporting service or Windows 95 (ILux Server Application).

To review this list of parameters on line, go to the directory where ilux.exe resides and run "ilux.exe -?"

Stopping the ILux Server

ILux is comprised of three services, the ILux log reporting service, the DNS Lookup Service, and the ILux SQL Anywhere database server (or the database engine. The ILux SQL Anywhere database server should not be stopped while the ILux log reporting service is active. Alternately, regardless of when you start the ILux log reporting service, your should start the ILux SQL Anywhere database server first.

Stopping ILux As a
Service on Windows NT

Stop the ILux log reporting service from the Services applet in the Control Panel.

Stopping ILux As an
Application on Windows 95

When you stop the application, you stop both ILux Reporting as well as the SQL Anywhere database.

Legal Notice

Limited Warranty Information in this document is periodically updated. Changes, technical inaccuracies, and typographic errors will be corrected in future editions. Portfolio Technologies Inc. makes no representations or warranties of any kind, either expressed or implied, with respect to the contents of this manual.

Trademarks ILux and the ILux lighthouse logo are registered trademarks of Portfolio Technologies Inc. Windows is a registered trademarks of Microsoft Corporation. All other trademarks and marks are the property of the respective owners.

Copyright notice Entire contents Copyright © 1998 Portfolio Technologies Inc. All rights reserved. No part of this online help may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose without the express written permission of Portfolio Technologies Inc., with the following exception: end users are granted permission to print a single copy for their sole personal use.