WebSTAR 4 Manual & Technical Reference
Table of Contents
COPYRIGHT
STARNINE® WEBSTAR® LICENSE AND LIMITED WARRANTY AGREEMENT
YEAR 2000 READINESS DISCLOSURE
SUPPORT
TRADEMARKS
Welcome to WebSTAR
WebSTAR Features
WebSTAR Web Serving
Mail Server
FTP Server
Proxy Server
Secure Administration
About This Manual
Additional WebSTAR Information
WebSTAR Information Online
StarNine Technical Support
Developing CGIs and Plug-Ins for WebSTAR
General Information
System Requirements
Hardware
System Software
Memory Requirements
Network Requirements
Standard New Installation
Active Installer
Installing Your WebSTAR Server
Custom Installation
Custom Install
Custom Install Location
Custom Install Items
Active Installer
Installing SSL
Upgrading your WebSTAR Server
Upgrading SSL Versions of WebSTAR
Using the WebSTAR Upgrade Installer
About the Installed Files
WebSTAR 4
WebSTAR Admin
About WebSTAR 4
HTML files
Plug-Ins folder
CGI-BIN folder
JRun Folder
Documentation folder
Restart Server Application
Tools & Examples Folder
Other Files
Starting The WebSTAR Server Suite
Start Your Server
WebSTAR Serial Number
Admin Password
More About WebSTAR
Try Out Your Server
Connect To Your Web Server
Browse the Documentation
Administering WebSTAR
About the WebSTAR Admin Application
Accessing the Browser Admin Pages
Connect To Your FTP Server
Creating an FTP User Entry
Testing Your FTP Server
Start Your Mail Server
Setting the Mail Host Name
Creating a Mail User Account
Log Into Your Email Account
Allow Email Clients to Send Messages
Protect Your User Directory
Connect to Your Proxy Server
Setting Up Your Web Site
URLs, HTTP and Your Web Server
Default Page
Folder Hierarchy
Extending Your Web Server
Upgrading
What's New In WebSTAR 4
Changes to The Web Server
SSL (Secure Sockets Layer) Changes
Changes to the WebSTAR Admin
New Mail Server Added to the Suite
Changes to the WebSTAR FTP Server
Changes to the WebSTAR Proxy Server
New Features:
Changes to the WebSTAR Plug-Ins
Core Plug-Ins Changes
Additional Plug-Ins
New Plug-Ins
WebSTAR Status and Monitor Windows
Status Window Top Panel
Minimized Window
Status Window Monitor Pane
FTP Monitor Window
Mail Monitor Window
Proxy Monitor Window
WebSTAR Server Menus
File Menu
Edit Menu
Options Menu
Plug-Ins Menu
Help Menu
Server Application Issues
Server Administration Responsibilities
Application Memory and Connections
Optimizing WebSTAR for Best Performance
Restarting After Open Transport Errors
WebSTAR Background Server
Running Multiple Servers On The Same Machine
Log Archiving
WebSTAR Security
Physical Security
WebSTAR Server and Admin Security
SSL Security
CGI and Plug-In Security
Web File Security
FTP Security
Safe Passwords
Identifying Your Site: IP, Host Name and DNS
IP Addresses
Your Server's IP Address
Host Names
Your Server's Host Name
DNS
Port Numbers
Important WebSTAR Files
WebSTAR.Messages File
Web Server Files
FTP Server Files
Mail Server Files
Proxy Server Files
Server Troubleshooting
How to Get Help
WebSTAR Debug Plug-In
General Server Troubleshooting Guidelines
About the WebSTAR Admin Application
Connecting To A Server
Disconnecting From a Server
WebSTAR Admin Security
Admin Monitor Windows
WebSTAR Admin Menus
File Menu
Edit Menu
Windows Menu
WebSTAR Admin Server Settings
Working With Admin Lists
File Paths in WebSTAR Admin
Log Archiving
How Log Archiving Works
Log Status Reporting
Log Archiving Settings
Status Reports
Browser-Based Admin
WebSTAR Admin Application
File Names and Paths
Default Names
Processors
Connections Settings
Max Connections
HTTP Port
Timeout
Buffer Size
Use DNS for Server and Client Lookups
Restrict CGIs to CGI-BIN
Persistent Connections
Performance
Caching
File Info Cache
Data Cache
Updating Caches
Virtual Hosts
Editing Virtual Hosts Entries
Virtual Host Root Folders
Virtual Host Options
Virtual Hosts Settings File
SSI
Suffix Mapping
Suffixes, Type and Creator Codes
How Suffix Mapping Works
Editing Suffix Mapping Table Entries
Fields in the Suffix Mapping Table
Suffix Mapping Example: Using SSI for All HTML Files
Actions
Editing Actions Entries
Using Actions
Security Realms
About Realms
Editing Realms Entries
Realms, Allow/Deny and User Names Work Together
Web Users and Passwords
Editing User Entries
Importing and Exporting Large Users Lists
Allow/Deny
Realms Access Control
Editing Allow/Deny Entries
Allow/Deny Examples
Web Serving and HTTP
HTTP Connections
WebSTAR URL Processing
Responding To Errors
WebSTAR URL Security Processing
Folder Hierarchy, File Paths, and Names
Example Hierarchy and File Paths
File Hierarchy and Virtual Hosting
Links to Subfolders and Parent Folders
Web File and Folder Name Rules
Redirection: Aliases and Redirect Files
Virtual Hosts: Hosting Multiple Web Sites
Routing to Virtual Hosts
Configuring Virtual Hosts
Logging
Log Archiving
Log Formats
About Log Formats: WLF, CLF and ExLF
Log Format Tokens
Configuring the Log Format
About SSL Security
Secure Sockets Layer (SSL) Protocol
Encryption Levels: US and International
How Browsers Access A Secure Server
SSL and Multiple Domains
Installing & Configuring SSL
Steps to Secure Serving
Performing the Installation
Obtaining and Installing Certificates
Certificate Formats
Certificate Authorities
Creating Certificate Signing Requests
Using the VeriSign Certificate Authority
Using the Thawte Certificate Authority
Obtaining a Test Certificate
Installing Your Server Certificate
Using SSL in WebSTAR
Testing Your Secure Server
Access Control
Additional Privacy Considerations
SSL Server Performance Issues
SSL (Secure Socket Layer) Troubleshooting
About WebSTAR Plug-Ins
Plug-In Memory Issues
Installing and Removing Plug-Ins
WebSTAR Plug-In Settings
WebSTAR Auto BinHex
Using Auto BinHex
Auto BinHex Settings
WebSTAR Byte Server
Example: Byte-Serving PDF files
WebSTAR Directory Indexer
Using Directory Indexer
Default Index Pages vs. Directory Index Listings
WebSTAR Directory Indexer Administration
WebSTAR File Upload
Using the WebSTAR File Upload Plug-In
WebSTAR File Upload Administration
WebSTAR Form Mail
Using WebSTAR Form Mail
WebSTAR Form Mail Examples
WebSTAR Form Mail Administration
Additional Form Mail Options
WebSTAR Image Map
Using the WebSTAR Image Map Plug-In
WebSTAR JRun Servlet Runner
System Requirements & Configuration
.Using WebSTAR JRun Servlet Runner
Java Servlet Development Information
WebSTAR PowerKey Pro Tickler
WebSTAR QuickDNS Load Balancer
Fault Tolerance
Load Balancing
Load Balancing vs. Load Sharing
QuickDNS Configuration Page
HTTP Configuration
WebSTAR Rebound! Assist
WebSTAR Search
How the Searching Works
Search Results
Installation
Indexing and Index Files
Search Dictionaries
Web Tools For Searching
Search Plug-In Administration: Index Auto-Update
WebSTAR WebObjects Adaptor
How the WebObjects Adaptor Works
WebObjects Configuration
Using WebSTAR SSI Commands
SSI Command Structure
SSI Command Example
SSI Command List
Echo Command
Include Command
FSize Command
FLastMod Command
Counter Command
Hide and Show Commands
Exec Command
Store Command
PostArg Command
Config Command
SSI Troubleshooting
SSI Administration & Security
SSI Security
Editing Counters and Numeric Variables
SSI and File Suffixes
Additional SSI Features and Options
WebSTAR SSI-WebInclude
WebInclude Security
Legal Issues
Installation
Using WebSTAR SSI-WebInclude
SSI WebInclude Commands
Nesting TAGEXTRACT Commands
Extending WebSTAR SSI
Tag Registry
WebSTAR SSI Extensions
Installation
Files Installed
How WebSTAR Lasso Publisher Works
WebSTAR Lasso Publisher vs. Lasso Web Data Engine
What You Need to Know
HTML Editor Requirements
Preparing a Database for Web Publishing
Security
Create a Layout
Open in Browse Mode
Using FileMaker Pro Server
Instant Web Database Publishing
Custom Web Database Publishing
LDML (Lasso Dynamic Markup Language)
FM Link
Creating a Search Form
Required Tags for a Search
Other Important Tags
Search Operators
Displaying Search Results
Listing the Matched Record Data
Navigating the Found Set
Showing Details
Creating a Form to Add Records
Add Record Example
Other Important Tags
WebSTAR Lasso Publisher Troubleshooting
Going Further
Advanced Topics
The LDML 3.5 Reference Database
Online Help
Purchasing the Lasso Web Data Engine
About the WebSTAR FTP Server
FTP and Cache Flushing
FTP Security
FTP Data Types Supported
FTP and Multiple Hosts
FTP Load Balancing
FTP URLs in HTML
FTP Standards and Conventions
FTP Specification
FTP Ports
WebSTAR FTP Settings
Max Connections
Timeout
Reported Server Name
Use MacBinary for .bin files
Displaying Files with Resource Forks
Default Type & Creator Codes For Upload
Connection Messages
FTP Users: Access Control
Making an FTP User Entry
User Name and Password
FTP Root Folder File Path
Max Folder Size
Privileges
FTP Users Import & Export
Anonymous FTP
FTP Monitor Windows
FTP Logging Information
FTP Log Elements
FTP Activities
FTP Commands
FTP Log Files
Logging Options
Log Archiving
FTP Server Troubleshooting
The WebSTAR FTP Server Startup Errors
Errors and Error Codes
Client Errors
About the WebSTAR Mail Server
WebSTAR Mail Files
About Internet Email
SMTP
POP
IMAP
Web Mail
LDAP
DNS Servers and Mail Hosts
Mail Exchange Records
Email Access from Web Browsers
Log In
Writing Messages
Viewing Messages
Acting on Messages
Mail Administrator Responsibilities
Mail Server Account Management
Reading the Postmaster Messages
Tracking Mail Server Usage
Backing Up and Restoring Email Files
Dealing With Spam (Unsolicited Email)
Mail Defaults
Mail Storage
Alternate DNS Server
Web-Based Email
Backup Scheduling
Mail Hosts
Host Name
Unknown Address
Copy To
Redirect To
Mail Connections
About Connections
SMTP Connections
Relay Restrictions and Spam Prevention
IMAP Connections
POP Connections
LDAP Connections
Mail Caching
RAM Cache
Disk Cache
DNS Caching
Mail Routing
Editing the Routing Entries
Routing Options
Mail Allow/Deny
Allow/Deny Services
Editing Allow/Deny Entries
Users & Accounts Settings
Account ID
Password
E-Mail
Host
Message Limit
Forward To
Forwarding To Groups
Storage Limit
Require APOP
IMAP Privileges
Import and Export
WebSTAR Mail Export Formats
Import User Mailboxes
Exporting Mail Users and Messages
Account Tips and Examples
Postmaster Account
Characters Allowed in Names Addresses
Creating Address Conventions
Mail Monitor & Queue Window
Connections
Activity Log
Queue
Logging Options Settings
Logging Options
Log Archiving
Reporting
Mail Server Report Format
Setting the Report Schedule
Clear Report
Run Now
Repairing Damaged Mail Files
Server Not Getting Messages
Log Error Messages
Mail Trace File
Client Problems and Error Messages
Postmaster Problem Messages
About the WebSTAR Proxy Server
Privacy Issues
Cache Issues
Browsers and the Proxy Server
WebSTAR Proxy Server Design
Proxy Connections
Upstream Proxy
Caching
Proxy Allow/Deny
Proxy Status Window & Log File
Proxy Log Options
Logging Options
Log Archiving
Proxy Server Troubleshooting
Suffix Mapping Defaults
Default File Suffix Mappings
RAW Files
WebSTAR Plug-In Suffix Mappings
WebSTAR SSI Reference
SSI Command Reference Table
SSI Environmental Variables
SSI Field Descriptors for TimeFmt
Descriptors Not Supported
Lasso Tag Reference
Lasso Tag Table
Extending WebSTAR:
CGIs, Plug-Ins and Java
WebSTAR Development Information
Scripting Tools
MacPerl
Third-Party WebSTAR Add-Ons
Developing CGIs
ACGIs and Asynchronous Processing
AppleScript CGI Issues
WebSTAR Apple Events
Apple Event Properties
Calling CGIs
CGIs and Virtual Hosts
More Information on CGIs
Developing WebSTAR API Plug-Ins
Theory of Operation
Filter Plug-Ins
WebSTAR API Parameter Definitions
Error Checking
Additional information on WebSTAR API Plug-ins
Using WebSTAR Plug-In Services
Calling WebSTAR Auto BinHex
Calling WebSTAR Data Cache
Calling WebSTAR Proxy
Calling WebSTAR Form Mail
Calling WebSTAR SSI
Developing Java Servlets for WebSTAR
Overview of JRun
Using JRun
Additional information on Java Servlets