WebTen "Quick Start" Guide


This is a guide to getting started quickly with WebTen. This guide assumes you have a knowledge of internet Web service. If you are not familiar with the Internet and the World Wide Web, please see section "3.3 Web Server References" in the WebTen User's Guide for more information on building a Web site.

WebTen Installation

Installing WebTen is easy. First make sure that you have 20MB of free disk. If the proper amount of disk is not available, the installer will prompt you and allow you to return to the Finder. To install WebTen double-click on the WebTen Installer icon. You will need to select destination disk and directory names. After about 30 seconds the installation will be complete. Next check your network configuration.

WebTen Network Configuration

After installing WebTen make sure that your OpenTransport network configuration is correct. If you are unsure about your configuration, open the TCP/IP Control Panel and review your settings. As a minimum configuration, make sure that you have proper IP address and domain name settings. Just a note of caution below concerning the WebTen Application Heap.

WebTen Application Heap

The WebTen application heap is the memory that is allocated specifically to WebTen when it is launched. The size of the heap is specified in the "Get Info" window for the WebTen application. Since WebTen allocates most of its memory from outside of this heap, it is not necessary to increase the size of this heap before launching WebTen. In fact, significantly increasing this setting is a common mistake made by new WebTen users, which can actually reduce the memory available to WebTen and affect its behavior and performance.

NOTE: Do not allocate additional memory to the WebTen application.

Setting the WebTen Administrator's Password

You must set the WebTen administrator's password immediately after launching WebTen the first time. Select Set Password under the Admin menu. (See section "5.4.1 Set Admin Password" in the WebTen User's Guide.) Type the administrator's user name in the Admin Name field, and the administrator's password in the Password field. Click OK.

Once the administrator's name and password have been entered, additional names and passwords may be added, changed or deleted using the forms and tables presented in the WebTen Administration Server pages under sections "7.9 Users" and "7.10 Groups" (in the WebTen User's Guide). Set Admin Password can always be used to add new administrators or change the passwords of existing administrators.

NOTE: You will not be able to connect to the Administration Server if you do not set the Administrator's password.

Customizing WebTen

Connect to the WebTen Home Page

Use your Web browser to connect to the WebTen Home Page. If your browser is running on the same machine on which WebTen is running (and you are reading this documentation online), click on the following local host link:

http://localhost

If your browser is running on another machine, enter the URL:

http://hostname
where "hostname" is replaced with the host name of your WebTen machine.

If neither of the above links connects you to the WebTen Home Page, substitute the name of your WebTen machine and your domain name into the following URL, and enter it directly into your browser:

http://hostname.domainname

WebTen Home Page

The first time WebTen is accessed via a browser, WebTen uses the file default.html (located in the WebTen folder) as its home page. The WebTen Home Page contains several useful items, including links to online documentation and Web content examples. To access the WebTen Home Page from a browser on the same machine as WebTen, simply point your browser at http://localhost.

If your browser is running on another system, you will need to specify the complete URL using the host name of the WebTen machine and its domain.

A Web server's "home page" is the top-level page of a site - the welcome page. The WebTen Home Page can be used as a template for your own personalized home page. In addition, it serves as a roadmap to help you get started with WebTen. Since WebTen supports virtual hosting, you can have multiple Web sites on a single machine. In that case, each Web site would have its own top-level home page.

Connect to the Administration Server

To connect to the WebTen Administration Server, follow the WebTen Admin Server link in the WebTen Home Page. If your browser is running on the WebTen system, you can also click on the following link:

http://localhost/webten_admin

If your browser is running on another system, enter a URL of the form:

http://Host_Name/webten_admin

where "Host_Name" is replaced with the host name of your WebTen system.

Try the Examples

The WebTen Home Page contains a number of example CGIs including Perl, shell, and binary CGIs. There are also some example Apple CGIs and plug-ins. For more information, see section "4.12.1 CGI-Based Scripts" in the WebTen User's Guide.

Add Your Web Pages

All that remains to be done is to place the pages, folders and sub-folders you wish to publish in the WebTen folder. See section "4.2 Publishing Content" in the WebTen User's Guide. You may also customize your home page by replacing the file default.html with one of your own design.


Page last updated 12/27/1999

http://www.tenon.com/support/webten/papers/webten-quick-start.html