WebSTAR 4 Manual & Technical Reference

Manual Contents | Chapter Contents | Previous Page | Next Page

About the Installed Files

The WebSTAR folder contains the WebSTAR applications, WebSTAR Plug-Ins, default files, examples, and more. You'll add HTML and other files to this folder to serve web and FTP data.

See also: Important WebSTAR Files .
 

WebSTAR 4

This is the main server application . It serves web pages, runs the Plug-In modules, displays the status of your server, and provides an interface for the Administration Password and your WebSTAR Serial Number. The WebSTAR application does the actual serving, while the WebSTAR Admin application allows you to configure the server.

See WebSTAR Server & Troubleshooting .

WebSTAR Admin

This application provides an administration interface for you to change the settings for your Web, Mail, FTP and Proxy servers, and to monitor the status of your servers. It does not have to be running at all times: you can launch it when you need to make changes, then quit when you're done.

WebSTAR Admin communicates with the WebSTAR server application via TCP/IP, so you can run it on any Macintosh system that has access to the Internet. The password and encrypted communications mean that no one else can access your server.

See also: About the WebSTAR Admin Application and for web-specific instructions, Web Server Administration .

To install the WebSTAR Admin application on a remote machine, use the Custom Install option in the WebSTAR Installer.

About WebSTAR 4

This file contains release information and last-minute changes that you should know about.

HTML files

The Installer automatically places these useful HTML files in your WebSTAR web server's default root folder. You should change them to include information about your server in particular.

Default.html is a temporary starter web page, which appears when a browser contacts your site. You'll want to replace this shortly, following the instructions in Default Page . To change the default index name, see Index File Name .

Error.html is an HTML page with a brief message that appears when there's a request for data that can't be served. For more information, see Error File Path .

NoAccess.html is the page displayed when a browser can't connect to the server, because that host is denied access to the entire site using the "Global" option. For more information see No Access File Path .

Plug-Ins folder

WebSTAR Plug-Ins are modules which provide functionality to the WebSTAR server. Many WebSTAR features, including the Mail, FTP and Proxy servers, are implemented as Plug-Ins.

The WebSTAR server will find only those Plug-Ins in the Plug-Ins folder, or a subfolder within that folder. Do not move the files or rename the folder. Some Plug-Ins have Extensions and Data folders, storing additional data used by that Plug-In. Do not delete or remove these folders unless you are deleting the associated Plug-In.

If you ever need to re-install the WebSTAR Plug-Ins, use the WebSTAR Installer.

There are many third-party Plug-Ins available to extend your server: for more information, see the StarNine Store at store.starnine.com and the Extending WebSTAR Pages at

www.starnine.com/extendingwebstar.html

Mail, FTP, and Proxy Server Plug-Ins

The WebSTAR Plug-In architecture is so powerful that the Mail, FTP and Proxy servers are implemented as Plug-Ins. If you do not intend to use these features of WebSTAR, you can remove them from the Plug-Ins folder and they will not be loaded.

Core WebSTAR Plug-Ins

The Core Plug-Ins , listed below, are important for WebSTAR--you should not remove them.

Additional WebSTAR Plug-Ins

The other WebSTAR Plug-Ins provide additional functionality to the web server. These are not required by the web server and are not installed by default: you must install them separately (see Custom Installation ).

For information on Plug-Ins, see WebSTAR Plug-Ins .

Other Plug-In files provide support for third-party products:

CGI-BIN folder

CGIs (Common Gateway Interface scripts) are another way to extend the power and flexibility of your WebSTAR web server. The cgi-bin folder is a standard place to store CGIs, so do not rename this folder. CGIs may be stored in other folders as well. WebSTAR includes several example CGIs in the Tools & Examples folder.

JRun Folder

The WebSTAR JRun Servlet Runner allows WebSTAR to support JavaSoft's Java Servlet API. For more information, see WebSTAR JRun Servlet Runner and Developing Java Servlets for WebSTAR .

Documentation folder

The Documentation folder contains WebSTAR's documentation, including this manual, in Adobe Acrobat (PDF) format for printing, and HTML format for online viewing using your favorite web browser.

You can use WebSTAR Search to index the WebSTAR HTML manual and search it locally.

Restart Server Application

The Restart Server Application is automatically launched when WebSTAR receives certain TCP/IP errors or settings are changed. For information on this program, see Restarting After Open Transport Errors .

Tools & Examples Folder

This folder contains helpful tools, example files and instructions for using WebSTAR and writing extensions to it. If you have trouble accessing this folder in your browser, encode the space and ampersand for HTTP, like this:

 

http://www.domain.com/Tools%20%26%20Examples/tools_and_examples.html
(be sure to change "www.domain.com" to your server's host name)

Files

Folders

Other Files

WebSTAR Mailing Lists File

This file, automatically installed on your desktop, contains a link to the sign-up page for the StarNine email-based discussion lists, including WebSTAR-Talk. If you have any questions about using WebSTAR or related CGIs and Plug-Ins, the WebSTAR-Talk list, and its associated archive of messages, is a great resource for you.

IP Secondary Addresses

This file, installed in the System Folder, Preferences folder, is used for a particular form of virtual hosting: see IP Multihoming: Special Configuration for details. If a file with this name already exists, the WebSTAR Server Suite Installer will not replace it.

Extensions for Mac OS 8.0 and 8.1

WebSTAR will install the Apple update files for Appearance Manager and Navigation Services on Mac OS 8.0 and 8.1.


Manual Contents | Chapter Contents | Previous Page | Next Page