About WebSTAR Server Suite 4.2 © 1995-1999 StarNine Technologies, Inc. and its Licensors. This document provides a brief overview of the WebSTAR Server Suite 4.2 release. Also included are basic getting started and configuration instructions. If upgrading from a previous version of WebSTAR it is recommended that you read this entire document as it contains important upgrade and change history information. For more specific information, be sure to read the additional documentation included with WebSTAR Server Suite 4.2. Contents € Overview of WebSTAR Server Suite 4.2 € System Requirements € Installing WebSTAR Server Suite 4.2 € Upgrading From a Previous Version of WebSTAR € Known Compatibility Issues € Software Change History € Contacting StarNine Technologies, Inc. Overview of WebSTAR Server Suite 4.2 WebSTAR Server Suite 4.2 is a set of easy to use Internet servers for the Mac OS, providing support for Web, FTP, Mail and Proxy services. In addition to supporting a TCP/IP-based application for remote administration of these services, WebSTAR Server Suite includes a number of other technical features, including: Web Server (HTTP, HTTPS/SSL) € High performance Web server, capable of serving tens of millions of connections a day. € Full support for the HTTP 1.1 protocol, including persistent connections and byte-range requests. € Support for single-link IP multihoming, virtual domain and language-based routing. € High performance file info and data caching architecture. € SSLv2 and SSLv3 support on a per-IP address basis, including support for multiple X509, X509v3, PKCSv7 chained, Netscape chained and Server Gated Cryptography (SGC) style certificates, and RC4-128, 3DES, DES-56, DES-40, RC4-40 and MAC-only encryption options. € Enhanced Server-Side-Includes featuring an extensible architecture allowing Plug-Ins to register custom HTML tags for processing on SSI pages. € Support for processing of Mac OS-based CGIs, WebSTAR API-based Plug-Ins, Java Servlets and communicating with WebObjects-based applications. € Lasso-based publishing of FileMaker Pro and ODBC databases € Robust Realms and/or Allow/Deny-based security architecture. € Search engine for indexing sites, including support for extraction of text from PDF files. FTP Server € User level access control privileges for uploading, downloading, creation and deletion of content. € Support for MacBinary II and III encoding standards. € Limiting of folder content size on a per user-basis. € Supports resuming of FTP file transfers. € Features support for "log-on", "log-out" and folder messages. Mail Server (SMTP, SMTP/ESMTP, IMAP4, POP3, APOP, MIME, LDAP) € Full support for SMTP (Simple Mail Transfer Protocol), ESMTP (Extended Simple Mail Transfer Protocol), IMAP4 (Internet Message Access Protocol), POP3 (Post Office Protocol), APOP (Authenticated Post Office Protocol), MIME (Multipurpose Interent Mail Extensions), including limited LDAP (Lightweight Directory Access Protocol) for email alias and address lookups. € Support for multiple domains and user accounts on individual or multiple domains. € Web-based Email access of user account mailboxes. € Robust routing of configuration of outgoing SMTP messages. € Advanced relay blocking and Allow/Deny security for the prevention of unsolicited "spam" email. € Remote viewing and control of the outgoing mail queue. € Full support for 8-bit messages. € SMTP/ETRN support for intermittent Internet connections. Proxy Server (HTTP) € Advanced HTTP caching architecture for reducing network bandwidth demands. € Support for upstream Proxy servers. € Security architecture for preventing Proxy access from and Proxy access to individual hosts and web sites. System Requirements WebSTAR Server Suite 4.2 requires a Macintosh with a PowerPC processor (G3 or later recommended for WebSTAR Mail), Mac OS 8.0 or above (Mac OS 9 recommended), Open Transport 1.3 or above, 12 MB of available RAM (64 MB or more recommended for WebSTAR Mail), and a minimum of 50 MB of available hard drive space. Java Servlet support requires MRJ 2.1.3 or later. WebSTAR Server Suite 4.2 requires 12 MB of application memory, which is sufficient enough to run all Internet services in their default configurations. To increase the number of connections supported by any one service, follow these guidelines: Web Server: - For each additional connection, increase the WebSTAR applications memory allocation by 100K. - For each additional 32K assigned for data caching, increase the WebSTAR applications memory allocation by 32K. FTP Server: - For each additional connection, increase the WebSTAR applications memory allocation by 32K. Mail Server: - For each additional SMTP, POP, IMAP or LDAP connection, increase the WebSTAR applications memory allocation by 10K. Proxy Server: - For each additional connection, increase the WebSTAR applications memory allocation by 50K. Plug-Ins: - Some Plug-Ins may require that additional memory be allocated to the WebSTAR application. Consult relevant documentation. Installing WebSTAR Server Suite 4.2 To install WebSTAR Server Suite 4.2, follow these steps: 1. Double-click the WebSTAR Server Suite 4.2 Installer application and follow the installation instructions for performing an Easy Install. 2. Open the WebSTAR Server Suite 4.2 folder and double-click the WebSTAR 4.2 application. 3. You will next be prompted to enter your serial number. Enter your serial number and then click the OK button. NOTE: If this is an evaluation copy of WebSTAR Server Suite, you need to obtain a temporary serial number by contacting StarNine either via the Web , via electronic mail , or by calling 1-800-525-2580. 4. Once the WebSTAR server application is launched, you will then be prompted to enter an Admin Password. Enter a password then click the OK button. 5. With the WebSTAR server application running, double-click the WebSTAR Admin application. 6. Choose New Connection from the File menu and enter the primary host name or IP address of your WebSTAR server, the port number it is running on and the Admin Password. 7. Once connected to your WebSTAR server, choose Server Settings from the Edit menu. Next select the Users listing under Web Settings and define a username and password for the Administrator "pi_admin" Realm. 8. Next click the Users listing under FTP Settings. Define a user name and password for the Administrator user. 9. Click the Users & Accounts listing under Mail Settings. Select the "postmaster" account name and define a password for the Postmaster user. 10. Click Save. Upgrading From A Previous Version of WebSTAR When upgrading from a previous version of WebSTAR it is recommended that you read this entire section as it includes important upgrade and change information. It is also highly recommended that you use one of the Installers Upgrade options rather then trying to upgrade to WebSTAR Server Suite 4 "by hand". To upgrade from a previous version of WebSTAR, follow these steps: 1. Quit the WebSTAR server application in the folder you wish to upgrade. 2. If you have increased the servers memory allocation to support additional Plug-Ins or a larger number of connections you will need to assign more memory to the new WebSTAR 4.2 server application. Select the older WebSTAR application and choose Get Info from the File menu. Write down the difference between the Preferred Size and the Suggested Size. 3. Double-click the WebSTAR Server Suite 4.2 Installer application and select the appropriate upgrade option from the installers pop-up menu. If the folder you wish to upgrade contains a normal version of WebSTAR, select the Upgrade option. If the folder you wish to upgrade contains a copy of WebSTAR/SSL for U.S. and Candada (supporting RC4-40, DES-56 and RC4-128) select Upgrade with SSL- U.S. & Canada, users of WebSTAR/SSL for other countries (with support for RC4-40 only) will want to select Upgrade with SSL - International. Click Install. 4. The Installer will then present you with a dialog explaining that in order to upgrade WebSTAR Server Suite to support HTTPS (SSL) it is necessary to install or run this update off the WebSTAR CD or have an older copy of WebSTAR/SSL installed in the folder you wish to upgrade. If you have already installed a copy of WebSTAR Server Suite with HTTPS (SSL) support, click Continue to upgrade to the latest version with HTTPS (SSL) support. 5. Next the Installer will search your hard drives for a potential WebSTAR folders to upgrade. If necessary, the Installer will display a dialog prompting you to select the folder you wish to upgrade. Select the appropriate folder then click OK. 6. The Installer upgrades the selected folder by first copying and moving older files into a new "WebSTAR (old)" folder located at the root of the startup drive, then by installing copies of the latest WebSTAR Server Suite components into the selected folder. Third-party Plug-Ins, CGIs and Servlets, and most importantly, your sites contents are not disturbed during the upgrade process. Once completed, a dialog box will be displayed telling you that the upgrade was successful ‹ click OK and select Quit to leave the Installer. 7. If necessary, select the new WebSTAR 4.2 server application and increase the memory allocation by choosing Get Info from the File menu. Increase the Preferred Size by the difference between Preferred Size"and the Suggested Size in Step 2. 8. To automatically launch the WebSTAR server when you restart the machine, make an alias of the new WebSTAR 4.2 server application and move it to the Startup Items folder. Remove any aliases to older versions of WebSTAR. 9. Open your newly upgraded WebSTAR folder and double-click the WebSTAR 4.2 application. When launched the WebSTAR 4.1 server application is designed to update your server settings for use with WebSTAR Server Suite 4.2. While previous WebSTAR server application settings are maintained most WebSTAR/SSL settings (with the exception of the SSL certificate password stored in the WebSTAR/SSL Settings file) are not. Thus WebSTAR/SSL users will need to reeneter Realms, Allow/Deny and other server settings manually. NOTE: Once the WebSTAR 4.2 server application has been launched and the server settings have been updated, it is no longer necessary to keep a copy of the WebSTAR/SSL Settings file in the upgraded folder. 10. You will next be prompted to enter your serial number. Enter your serial number and then click the OK button. NOTE: If this is an evaluation copy of WebSTAR Server Suite, you need to obtain a temporary serial number by contacting StarNine either via the Web , via electronic mail , or by calling 1-800-525-2580. 11. If not already entered, you will be prompted to enter an Admin Password. Enter a password then click OK. 12. With the WebSTAR server application running, double-click the WebSTAR Admin application. 13. Choose New Connection from the File menu and enter the primary host name or IP address of your WebSTAR server, the port number it is running on and the Admin Password. 14. Once connected verify your WebSTAR server settings, making any modifications that may be necessary. 15. Click Save. Known Compatibility Issues ClearWay Thread Tweaker € Substantial changes have been made to the servers thread management to better take into account the CPU demands of threaded Plug-Ins. Utilities such as ClearWay Thread Tweaker are no longer supported. € ClearWay Thread Tweaker is not compatible with Mac OS 8.6 and above. BIAP W*API Patch € The changes provided by this patch are no longer needed or recommended for use with WebSTAR 4. ClearWay FireSite € There are known stability problems with ClearWay's FireSite 2.5 and earlier. Contact ClearWay Technologies to upgrade to FireSite 2.6 or later. Pervasive Tango € There are known stability problems with Tango 2.5 and earlier. Contact Pervasive to upgrade to Tango 3.6 or later. Blue World Lasso Application Server € There are known stability problems with Lasso versions earlier than 3.5 when used in conjunction with WebSTAR 4. Contact Blue World to upgrade to Lasso 3.5 or later. Purity WebSentinel € There are known stability problems with WebSentinel 2.0.5 and ealier when used in conjunction with WebSTAR 4. Contact Purity to upgrade to WebSentinel 2.1 or later. X-Cal and X-Cal-Multi € There are known stability problems with X-Cal and X-Cal-Multi versions earlier than 1.3.06 when used in conjunction with WebSTAR 4. Update to 1.3.06 or later from . Router Plug-Ins € WebSTAR Virtual Hosts and multiple Index file name support may be disabled if you install another Plug-In, such as Welcome or FireSite VDM, which runs in the Router role. Disabling the Router functions of these Plug-Ins will enable them to continue to be used with WebSTAR Virtual Hosts. Filter Plug-Ins € Filter Plug-Ins, like those that implement support for multiple index files, may modify the URL request before passing the URL request to WebSTAR Directory Indexer thus preventing directory index listings from being returned. Disable the Filter Plug-In or use the multiple Index file name support feature found in WebSTAR Virtual Hosts to resolve this problem. Contacting StarNine Technologies, Inc. StarNine Technologies, Inc. 2550 Ninth Street, Suite 112 Berkeley, California 94710 Email: info@starnine.com sales@starnine.com support@starnine.com Web: http://www.starnine.com/ Phone: Main: (510) 649-4949 Sales: (800) 525-2580 or (510) 649-4949 Support: (510) 704-1272 Fax: Sales: (510) 548-5959 Main: (510) 548-0393 Edited 12/28/99