<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<link rel="home" title="HomePage" href="HomePage.html" />
<link rel="help" title="HowToUseWiki" href="HowToUseWiki.html" />
<link rel="copyright" title="GNU General Public License" href="http://www.gnu.org/copyleft/gpl.html#SEC1" />
<link rel="author" title="The PhpWiki Programming Team" href="http://phpwiki.org/ThePhpWikiProgrammingTeam" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="Content-Language" content="en" />
<meta name="robots" content="noindex,nofollow" />
<meta name="language" content="en" />
<meta name="document-type" content="Public" />
<meta name="document-rating" content="General" />
<meta name="generator" content="PhpWiki" />
<meta name="PHPWIKI_VERSION" content="1.3.14" />

<link rel="stylesheet" type="text/css" charset="iso-8859-1" href="phpwiki-printer.css" />
<title>PhpWiki - SME Server User Manual</title>
</head>
<body>

<div id="header">
  
<!-- Page title -->
<h1>SME Server User Manual</h1>
</div>
<div id="content">



<div class="wikitext"><span class="plugin" id="RawHtmlPlugin19">SME Server
  <a name="id2746898"></a>SME ServerUser Guide - 6Contribs.org<p class="copyright">Copyright © 2003-2004 Contribs.org</p><a href="ln-id2748071.html">Legal Notice</a><p class="pubdate">January 2004</p><hr><p><b>Table of Contents</b></p>1. <a href="#intro">Welcome to your SME Server</a>1.1. <a href="#about">
About This Guide
</a>1.1.1. <a href="#id2749624">Production</a>1.1.2. <a href="#id2749685">History</a>1.1.3. <a href="#id2749731">Endorsements</a>1.1.4. <a href="#id2749758">Acknowledgements</a>1.2. <a href="#softwarelicensing">Software Licensing Terms and Conditions</a>1.3. <a href="#testco">About Our Test Company: The Pagan Vegan</a>1.4.<a href="#whatsnew">What's New</a>1.4.1. <a href="#whatsnew-features">Server Features</a>2. <a href="#serverrole">The role of the SME Server</a>3. <a href="#isp">Your Internet Service Provider (ISP)</a>3.1. <a href="#dedvsdial">Dedicated versus dialup connectivity</a>3.2. <a href="#ipaddress">The IP address</a>3.2.1. <a href="#id2809286">Static versus dynamic IP addressing</a>3.2.2. <a href="#id2809549">Routable versus non-routable IP addresses</a>3.3. <a href="#ispconnectivity">Arranging connectivity with your ISP</a>3.3.1. <a href="#orderingdedicated">Ordering a corporate ADSL or other commercial
dedicated connection</a>3.3.2. <a href="#orderingcabledsl">Ordering cablemodem or residential ADSL service</a>3.3.3. <a href="#orderingdialup"> Ordering a dialup connection</a>3.4. <a href="#ispservices">Arranging Services From Your ISP</a>3.4.1. <a href="#servicelista">Service List A</a>3.4.2. <a href="#servicelistb">Service List B</a>3.4.3. <a href="#servicelistc">Service List C</a>3.4.4. <a href="#servicelistd">Service List D</a>4. <a href="#hardware">Hardware Requirements of the SME Server Host
Computer</a>4.1. <a href="#hardwarecat1">Hardware Requirements for a Category 1 Server</a>4.2. <a href="#hardwarecat2">Hardware Requirements for a Category 2 Server</a>4.3. <a href="#hardwarecat3">Hardware Requirements for a Category 3 Server</a>4.4. <a href="#hardwarecat4"> Hardware Requirements for a Category 4 Server</a>4.5. <a href="#supportedenet">Supported Ethernet Adapters</a>4.5.1. <a href="#id2812138">Supported Ethernet Adapters</a>4.6. <a href="#supportedscsi">Supported SCSI Adapters</a>4.7. <a href="#supportedtape">Supported Tape Drives</a>5. <a href="#installing">Installing And Configuring Your SME Server Software</a>5.1. <a href="#licensing">Licensing Terms and Conditions</a>5.2. <a href="#raidsupport">RAID1 Support (Disk Mirroring)</a>5.2.1. <a href="#raid1-software">Software Mirroring</a>5.2.2. <a href="#raid1-hardware">Hardware Mirroring</a>5.3. <a href="#upgrading">Upgrading From A Previous Version</a>5.4. <a href="#installingsoft">Installing the Software</a>5.5. <a href="#configserver">Configuring your SME Server</a>5.6. <a href="#configadminpasswd"> Setting Your Administrator Password</a>5.7. <a href="#configsysnames"> Configuring Your System Name and Domain Name</a>5.8. <a href="#configlocalnet"> Configuring Your Local Network</a>5.8.1. <a href="#configenetlocal">Selecting Your Local Ethernet Adapter</a>5.8.2. <a href="#configinternal">Configuring Local Network Parameters</a>5.9. <a href="#operationmode"> Operation Mode</a>5.9.1. <a href="#id2814564">Option 1: Server and gateway mode</a>5.9.2. <a href="#id2814637">Option 2: Private server and gateway</a>5.9.3. <a href="#id2814702">Option 3: Server-only mode</a>5.10. <a href="#configsvrgwy">Configuring Server and Gateway Mode</a>5.11. <a href="#configexternal">Server and Gateway Mode - Dedicated</a>5.11.1. <a href="#configextenet">Configuring Your External Ethernet Adapter</a>5.11.2. <a href="#id2815019">Assigning Your Ethernet Adapters to Network Connection</a>5.11.3. <a href="#configexternal.dedicated">Configuring Your External Interface</a>5.11.4. <a href="#configdyndns">Configuring Dynamic DNS</a>5.12. <a href="#configexternal.dialup">Configuring the Server for Server and Gateway Mode - Dialup Access</a>5.13. <a href="#configdhcpsvr">Configuring Your DHCP Server</a>5.13.1. <a href="#configdhcprange">Configuring the DHCP Address Range</a>5.13.2. <a href="#id2816095">Important issues about the DHCP address range</a>5.14. <a href="#configmisc"> Further Miscellaneous Parameters</a>6. <a href="#serverconsole">The Server Console</a>6.1. <a href="#console-textbrowsing">Using the Text-based Browser</a>6.2. <a href="#console-rootprompt">Accessing the Linux Root Prompt</a>7. <a href="#configclients">Configuring the Computers on Your Network</a>7.1. <a href="#configclientorder"> What Order to do Things</a>7.2. <a href="#configclientos">Configuring Your Desktop Operating System</a>7.2.1. <a href="#id2746386">Automatic DHCP Service</a>7.2.2. <a href="#id2750524">Manual entry for computers not using DHCP service</a>7.2.3. <a href="#id2817328">MS Windows workgroup configuration</a>7.3. <a href="#imappop3"> IMAP versus POP3 e-mail</a>7.4. <a href="#configemailapp">Configuring Your E-mail Application</a>7.5. <a href="#configbrowser">Configuring Your Web Browser</a>7.6. <a href="#configdirectory">Configuring Your Company Directory</a>8. <a href="#admin">On-going Administration Using the server manager</a>9. <a href="#security">Security</a>9.1. <a href="#password">Password</a>9.2. <a href="#admin-remoteaccess">Remote Access</a>9.2.1. <a href="#ssh">ssh</a>9.2.2. <a href="#pptp">PPTP</a>9.2.3. <a href="#id2818859">FTP</a>9.2.4. <a href="#telnet">telnet</a>9.3. <a href="#admin-localnetworks"> Local networks</a>10. <a href="#serverconfig">Configuration</a>10.1. <a href="#admin-dateandtime">Set date and time</a>10.2. <a href="#admin-setworkgroup">Workgroup</a>10.3. <a href="#admin-directory">Directory</a>10.4. <a href="#admin-printers">Printers</a>10.5. <a href="#admin-hostnames">Hostnames and addresses</a>10.5.1. <a href="#admin-hostnames-creating">Creating New Hostnames</a>10.5.2. <a href="#admin-hostnames-dhcp">Reserving IP Addresses Through DHCP</a>10.6. <a href="#admin-emailretrieval">E-mail Retrieval</a>10.7. <a href="#admin-otheremailsettings">Other E-mail Settings</a>10.8. <a href="#admin-reviewconfig">Review Configuration</a>11. <a href="#collaboration"> Collaboration</a>11.1. <a href="#admin-useraccounts">User Accounts</a>11.1.1. <a href="#user-disabling">Disabling User Accounts</a>11.1.2. <a href="#user-passwords">Changing User Passwords</a>11.2. <a href="#admin-quotas">Quota Management</a>11.3. <a href="#admin-groups"> Groups</a>11.4. <a href="#admin-pseudonyms">Pseudonyms</a>11.5. <a href="#admin-ibays"> Information Bays</a>11.6. <a href="#admin-virtdom">Virtual Domains</a>12. <a href="#administration">Administration</a>12.1. <a href="#admin-backup">Backup or Restore</a>12.2.1. <a href="#admin-backup-snapshot">Backup To Desktop</a>12.2.2. <a href="#admin-restore-snapshot">Restore From Desktop</a>12.2.3. <a href="#admin-verify-snapshot">Verify Desktop Backup File</a>12.2.4. <a href="#admin-backup-tape">Configure Tape Backup</a>12.2.5. <a href="#admin-restore-tape">Restore From Tape</a>12.3. <a href="#admin-reinstalldisk">Reinstallation Disk</a>12.4. <a href="#admin-maillogfile">Mail Log File Analysis</a>12.5. <a href="#admin-viewlogfiles">View Log Files</a>12.6. <a href="#admin-reboot">Reboot or Shutdown</a>13. <a href="#servermisc">Miscellaneous</a>13.1. <a href="#admin-onlinemanual">Online manual</a>13.2. <a href="#admin-starterweb">Create Starter Web Site</a>13.3. <a href="#admin-misc">Other Administration Notes</a>14. <a href="#i-bays"> Information Bays (i-bays)</a>14.1. <a href="#ibaydirs">i-bay Directories</a>14.2. <a href="#ibayaccess">Accessing the i-bays</a>14.3. <a href="#ibaycreation">Creating an i-bay</a>14.4. <a href="#ibaymodify">Modifying an i-bay</a>14.5. <a href="#ibaycustsite">An i-bay Used as a Customer Site: The Miles Gabriel Art
Exposition</a>14.6. <a href="#ibayshareddrive"> An i-bay Used as a Shared Network Drive</a>14.7. <a href="#ibayintranet"> An i-bay Used as an Intranet: The Pagan Vegan &quot;Vegemite&quot;</a>14.8. <a href="#ibayprocess"> An i-bay Used to Expedite Processes: Samson's Farms</a>14.9. <a href="#ibaycustdownload">An i-bay Used as Your Customer Download Site</a>15. <a href="#filestorage">User File Storage on the SME Server</a>15.1. <a href="#filestorage-win">Windows</a>15.2. <a href="#filestorage-mac">Macintosh OS</a>16. <a href="#webmail">Webmail</a>16.1. <a href="#webmail-enabling">Enabling Webmail On Your System</a>16.2. <a href="#webmail-start">Starting Webmail</a>16.3. <a href="#webmail-login">Logging In</a>16.4. <a href="#webmail-inbox">Viewing The Inbox</a>16.5. <a href="#webmail-logout">Logging Out of Webmail</a>16.6. <a href="#webmail-compose">Composing Messages</a>16.7. <a href="#webmail-reading">Reading Messages</a>16.8. <a href="#webmail-deleting">Deleting Messages</a>16.9. <a href="#webmail-contacts">Using Contacts</a>16.10. <a href="#webmail-prefs">Changing Webmail Preferences</a>17. <a href="#addsoftware">Additional Software</a>A. <a href="#app-ethernetlan">Introduction to the Ethernet Local Area Network (LAN)</a>B. <a href="#app-dyndns">Dynamic DNS Services</a>C. <a href="#app-proxysrv">Proxy Servers</a>D. <a href="#app-techsupp">Technical Support</a><a name="intro"></a>Chapter 1. Welcome to your SME Server<p><b>Table of Contents</b></p>1.1. <a href="#about">

About This Guide
</a>1.1.1. <a href="#id2749624">Production</a>1.1.2. <a href="#id2749685">History</a>1.1.3. <a href="#id2749731">Endorsements</a>1.1.4. <a href="#id2749758">Acknowledgements</a>1.2. <a href="#softwarelicensing">Software Licensing Terms and Conditions</a>1.3. <a href="#testco">About Our Test Company: The Pagan Vegan</a>1.4. <a href="#whatsnew">What's New</a>1.4.1. <a href="#whatsnew-features">Server Features</a><p>

Congratulations on
choosing the SME Server as your network and communications server!
</p><p>

Companies all over the
world are using the Internet to communicate more effectively and efficiently
to a broader audience. The SME Server is founded upon state
of the art technologies - such as the Linux operating system - which have
been mainstays in the infrastructure of larger organizations for several
years. Contribs.org has customized these technologies to make them straightforward
to use, while still giving you local control over your Internet services.
The result is a cost-effective Internet infrastructure that will reliably
serve your organization as it grows and as its use of the Internet evolves.
</p><a name="about"></a>1.1.
About This Guide
<p>
This user's guide walks
you step-by-step through the straightforward process of installing and
configuring your SME Server. The Appendices in the back
of the guide provide background information on subjects related to networking
and the Internet and are intended to supplement chapters in the main section
of the user's guide.
</p><a name="id2749624"></a>1.1.1. Production<p>
We created this user's
guide using <a href="http://docbook.org/" target="_top">Docbook</a>
on the Linux operating system. Images were created using <a href="http://gimp.org/" target="_top">The GIMP</a>.
</p><p>The HTML version of this manual was generated from DocBook XML
using <a href="http://www.xmlsoft.org/XSLT/" target="_top">libxslt</a>

with customized XSLT stylesheets. More information about our documentation
process is available at
<a href="http://www.e-smith.org/docs/" target="_top">http://www.e-smith.org/docs/</a>
Most of the editing was done by Dan York and Kirrily &quot;Skud&quot; Robert using
the <a href="http://www.vim.org/" target="_top">vim</a> editor.
</p><a name="id2749685"></a>1.1.2. History
<ul type="disc">

<li><p><b>January 2004</b> - First print
edition of the <i>SME Server User Guide</i>

published by Contribs.org.

Available on your instalation CD or on the contribs.org site
<a href="http://wiki.contribs.org/" target="_top">http://wiki.contribs.org/</a>
Primary author/editor Craig Jensen.
</p></li>

<li><p><b>January 2002</b> - First print
edition of the <i>SME Server User Guide</i>
published by Mitel Networks Corporation.  Also published in HTML and DocBook XML/SGML.

Available at:
<a href="http://www.e-smith.org/docs/manual/5.1/" target="_top">http://www.esmith.org/docs/manual/5.1/</a>
Primary author/editor Dan York.
</p></li><li><p><b>August 2001</b> - First print
edition of the <i>SME Server user's manual</i>

published by Contribs.org.
Also published online in HTML and DocBook XML/SGML. Available at
<a href="http://www.e-smith.org/docs/manual/5.0/" target="_top">http://www.e-smith.org/docs/manual/5.0/</a>
Primary author/editor Dan York.
</p></li><li><p>
<b>February 13, 2001</b> - <i>e-smith
server and gateway user's manual</i> for version 4.1 published
online in HTML and DocBook SGML by e-smith, inc. Available at
<a href="http://www.e-smith.org/docs/manual/4.1/" target="_top">
http://www.e-smith.org/docs/manual/4.1/</a> Primary author/editor Dan
York.
</p></li><li><p>
<b>December 4, 2000</b> - <i>e-smith
server and gateway user's manual</i> for version 4.0 published
online in HTML and DocBook SGML by e-smith, inc. Available at

<a href="http://www.e-smith.org/docs/manual/4.0/" target="_top">
http://www.e-smith.org/docs/manual/4.0/</a>
</p></li><li><p>
<b>July 2000</b> - <i>e-smith server
and gateway user's manual</i> for version 4.0 published in print form
by e-smith, inc.
  PDF and PostScript versions
also made available via FTP at <a href="ftp://ftp.e-smith.net/pub/e-smith/e-smith-4.0/" target="_top">
ftp://ftp.e-smith.net/pub/e-smith/e-smith-4.0/</a>. Primary
author/editor Ross Laver using StarOffice 5.1.
</p></li><li><p>
<b>November 1999</b> - <i>e-smith server
and gateway user's manual</i> for version 3.1 published in print
form by e-smith, inc.  Primary author Kim Morrison using StarOffice 5.1.

</p></li></ul><a name="id2749731"></a>1.1.3. Endorsements<p>This is the official documentation for
<b>
SME Server</b> and is endorsed by
Contribs.org
</p><a name="id2749758"></a>1.1.4. Acknowledgements<p>Contribs.org wishes to thank all of the developers in the open
source community who continue to help us make our product better.
</p><p>We also thank Craig Foster and Paul Miller
for their help in documenting Macintosh connectivity.
</p><a name="softwarelicensing"></a>1.2. Software Licensing Terms and Conditions<p>
The SME Server is licensed under the General Public License (GPL).  This means that you are free to use, and alter the software.  If you do
alter any of the packages, you must <i>make the source code (with patches please)freely available</i>.
Agreement found on the CD.   Acceptance of this agreement is required
during the software installation.
</p><p>
SME Server users may copy and redistribute this software.  The text of the GPL license may be found on the
web at <a href="http://www.fsf.org/copyleft/gpl.html" target="_top">http://www.fsf.org/copyleft/gpl.html</a>.  The
applicable license for each software module is specifically identified and
can be seen by running the rpm -qiv packagename command,
from the command
 line.<a name="testco"></a>1.3. About Our Test Company: The Pagan Vegan<p>

In this user's guide, we use examples of a catering and event-planning company, The Pagan Vegan
or TPV, that configures, administers and makes use of their server. As far as we know,
no company of this name exists.
</p><a name="whatsnew"></a>1.4. What's New<p>For the most complete list of information about changes that have
been made in SME Server, see the release notes that accompany your
software.</p>
<a name="whatsnew-features"></a>1.4.1. Server Features
<ul type="disc"><li><p><b>User quotas</b> - Through a new
<a href="#admin-quotas" title="12.2. Quota Management">web panel</a>, you have the ability to set a
limit on the amount of a disk space a user can use for files and e-mail.
</p></li><li><p><b>Windows 2000 and XP domain logon support</b> -
Previous versions have allowed the server to act as a domain controller for
client computers running Windows 95, 98, ME or NT. This version now extends
that domain logon support to Windows 2000 and Windows XP.
</p></li><li><p><b>USB printer support</b> -
It is now possible to connect the SME Server to a printer via the USB
port. The printer configuration panel has also changed slightly.</p></li><li><p><b>Improved Macintosh file sharing
support</b>- The server now includes better support for Macintosh
file sharing and eliminates some previous cases where Macintosh users
were unable to access i-bays.


</p></li><li><p><b>Experimental ISDN card support</b> - While
our software has always supported external ISDN adapters, this version now
includes experimental support for using an internal passive ISDN card.
</p></li></ul><a name="serverrole"></a>Chapter 2. The role of the SME Server<p>
Your SME Server manages your connection to the Internet by routing Internet
data packets to and from your network (which allows all the computers on
your network to share a single Internet connection) and by providing security
for your network, minimizing the risk of intrusions.
</p><p>
When one of your local
computers contacts the Internet, or is contacted by an outside machine
on the Internet, the SME Server not only routes that connection,
but seamlessly interposes itself into the communication. This prevents
a direct connection from being established between an external computer
on the Internet and a computer on your local network
thereby significantly reducing the risk of intrusion onto your
network.
</p><p>
Your server also provides services - including e-mail, web access and a
powerful file sharing and collaboration feature called &quot;i-bays&quot; - that
allow you to communicate better internally and with the rest of the world
using the Internet.
</p><p>
Throughout this user's
guide, the word <b>gateway</b> is used to mean the computer that acts as
the interface between your local, internal network and the external world.

</p><img src="images/server_and_gateway_mode.jpg" alt="Server and gateway mode"><p>

If you prefer, you can
also run your SME Server in &quot;server-only&quot; mode. In &quot;server-only&quot; mode,
your server provides your network with services, but not the routing
and security functions associated with the role of &quot;gateway&quot;. The server-only
mode is typically used for networks already behind a firewall. In that
configuration, the firewall fulfills the role of gateway, providing routing
and network security.
</p><p>
Once installed, your SME Server can be configured and managed remotely. Routine administration
is handled from your desktop using a web-based interface, so only on rare
occasions will you require direct access to the server
computer. Once installation is complete, most customers put the server
in an out-of-the-way place like a utility closet. If
you wish, you can disconnect the keyboard and monitor. (Note that
some computers may not operate correctly without an attached keyboard.)
</p><img src="images/server_only_mode.jpg" alt="Server-only mode"><a name="id2746607"></a><table border="1"><tr><td><p class="title"><b>More About Ethernets</b></p><p> <a href="#app-ethernetlan" title="Appendix A. Introduction to the Ethernet Local Area Network (LAN)"><i>Appendix A:
Introduction to the Ethernet Local Area Network (LAN)</i></a>,
briefly explains ethernets, ethernet components and typical ethernet
configuration.</p></td></tr></table><a name="isp"></a>Chapter 3. Your Internet Service Provider (ISP)<p><b>Table of Contents</b></p>3.1. <a href="#dedvsdial">Dedicated versus dialup connectivity</a>3.2. <a href="#ipaddress">The IP address</a>3.2.1. <a href="#id2809286">Static versus dynamic IP addressing</a>3.2.2. <a href="#id2809549">Routable versus non-routable IP addresses</a>3.3. <a href="#ispconnectivity">Arranging connectivity with your ISP</a>3.3.1. <a href="#orderingdedicated">Ordering a corporate ADSL or other commercial
dedicated connection</a>3.3.2. <a href="#orderingcabledsl">Ordering cablemodem or residential ADSL service</a>3.3.3. <a href="#orderingdialup"> Ordering a dialup connection</a>3.4. <a href="#ispservices">Arranging Services From Your ISP</a>3.4.1. <a href="#servicelista">Service List A</a>3.4.2. <a href="#servicelistb">Service List B</a>3.4.3. <a href="#servicelistc">Service List C</a>3.4.4. <a href="#servicelistd">Service List D</a><p>

Your ISP is your connection to the Internet - it routes Internet data packets to and from
your server. It also provides other essential services. This section
of the user's guide reviews what ISPs offer and what the implications are
in choosing among the various options available to you. While your ISP
can also assist you in selecting and arranging the right Internet services
for your organization, it's important to know the general range of services
available, since not all ISPs offer all services.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="serveronly"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>
If you are operating the product in &quot;server-only&quot; mode, you will need
to review your gateway/firewall documentation and perhaps consult with
your ISP regarding your configuration. For example, depending on your plans
for the server, your ISP may need to publish DNS records associating your
mail and/or web servers with your firewall IP address. You may also need
to configure your firewall for port forwarding of services.
</p><p>
In server-only mode,
the single Ethernet connection to the
local network is &quot;trusted&quot; as being secure
and packet filtering is disabled. For that reason, a server-only server
must <i>always</i> be behind a local firewall. You
should <b>not</b> directly connect such a system
to the Internet via an Internet Service Provider.</p></td></tr></table><a name="dedvsdial"></a>3.1. Dedicated versus dialup connectivity<p>

Connectivity, also referred
to as Internet access type, refers to the physical connection between your
site and your ISP. How you connect to your ISP affects the speed of your
Internet connection, which, in turn, impacts such things as how quickly
your web site is displayed to visitors.
</p><p>
<b>Dedicated</b> connectivity
refers to a full-time connection to your ISP. Although they are more expensive
than the alternative, dedicated connections are generally faster and allow
you to use the full range of services on your server.
There are several common types of dedicated connectivity.
<b>ADSL</b>
provides relatively fast data transmission over phone lines. A <b>cable
connection</b> links you to your cable company, which provides you with
many (though not all) of the same services as a traditional ISP. The speed
of transmission over a cable network can vary widely (from quite fast to
very slow) based in part on the usage within your neighborhood.

</p><p>
If you have <b>dialup</b> connectivity,
your server is not permanently connected to the Internet.
Rather, it connects to your ISP over a phone line using a <b>modem</b> or <i>ISDN adapter</i>.
Because your connection to the Internet is not permanent, some of the services
on your server cannot be provided to the outside world.
For example, having your server host your external company
web site would create a problem because whenever your server was not connected
to the Internet, the web site would not be available. (However, it could
certainly host an intranet web site because the local network would always be
connected.)

</p><a name="ipaddress"></a>3.2. The IP address<p>
An IP address is an
identifying number assigned to all devices connected to the Internet, and
is used in routing information from one device to another. Like your phone
number, your IP address enables other people to reach you. In our standard
configuration, your ISP only needs to allocate one IP address for your
network. It is assigned to your server, which will
accept all the Internet data packets intended for your network and distribute
them to the appropriate computer - much like an office receptionist is
able to accept incoming calls and direct them to the appropriate extension.
</p><a name="id2809286"></a>3.2.1. Static versus dynamic IP addressing<p>
A <b>static IP address</b>
never changes. It is permanently assigned to your server
by your ISP.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2809322"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Static IP addressing is preferable to dynamic IP addressing because it
makes it easier for users on the Internet to connect to your services.</p></td></tr></table><p>
<b>Dynamic IP address</b>
assignment means that your IP address is assigned to you only temporarily
and may be changed by your ISP. This makes it more difficult to ensure
continuity of service to your network. Consider again our telephone
number analogy. When your telephone number changes, you are able to place
outgoing calls. However, until your new phone number is registered with
Directory Services, other people are unable to look up your new number and place
calls to you. Similarly, whenever your IP address changes, a record associating
your server with its new IP address must be published
with the equivalent of Directory Services (known as Domain Name Service
or DNS) before incoming traffic can find you.
</p><p>

If your IP address is
dynamically assigned and you have a dedicated connection to your ISP (for
example, with a typical cablemodem), you may find it helpful to use a
<b>dynamic
DNS service</b>. We strongly recommend you review Appendix B: Dynamic
DNS services for more information about this worthwhile
option.
</p><a name="id2809549"></a>3.2.2. Routable versus non-routable IP addresses
<p>
If an IP address is
analogous to your phone number, then a <b>routable</b> IP address is the
equivalent of a full telephone number complete with country code and area code
such as +1-613-555-1234. Using the same analogy, a non-routable
address is the equivalent of an office extension. If your server
 is assigned a <b>non-routable</b> address,
 it cannot directly receive
incoming Internet connections, which limits the services that it can provide
to your site.
</p><a name="ispconnectivity"></a>3.3. Arranging connectivity with your ISP<p>
If you are going to be using your server in &quot;server and gateway&quot; mode, you will
need to arrange for a connection to the Internet. Your ISP will help you
connect your site and provide you with services that enable you to take
advantage of the Internet (e.g. e-mail delivery). To some extent, the type
of connection used determines the services needed. Therefore, we guide
you first through arranging connectivity and then direct you to the appropriate
list of services for each type of connection. The terms used in the following
sections are defined at the end of this chapter.

</p><p>
To connect your site
to the Internet, you not only need to arrange your physical connection
(modem, ISDN, DSL, cable modem, etc.), but you also need to ensure that your server
can locate the appropriate devices at your ISP's site. Your ISP will give
you this information (e.g. IP addresses for their devices) which must eventually
be entered into your server console (a straightforward process covered
in a later chapter). Many ISPs use a DHCP server which can directly configure
your server with some or all of these parameters.
</p><a name="orderingdedicated"></a>3.3.1. Ordering a corporate ADSL or other commercial
dedicated connection<p>
Typically, your ISP
will arrange for and configure your external hub and router. Alternatively,
you may be required to install that hardware yourself under their direction.
If a special phone line is required, the ISP will typically arrange that.
It is most typical with corporate service that you receive a routable,
static IP address. In fact, usually you will be allocated a block of routable,
static IP addresses for your corporation - you will need only one for your
server.
</p><img src="images/network1.jpg" alt="DSL connection diagram"><p>
Information provided to you by your ISP:
</p><ul type="disc"><li><p>static IP address (or block of addresses from which you
choose one)</p></li><li><p>IP address of router (&quot;gateway IP
address&quot;)</p></li><li><p>subnet mask</p></li></ul><p>
Order services from: Service List A
</p><a name="orderingcabledsl"></a>3.3.2. Ordering cablemodem or residential ADSL service<p>
Typically, your cable
company or ADSL provider will install a configured cablemodem or ADSL router
at your site. If you do not have cable access, your cable company will
install it for you. ADSL connects to the ISP via a conventional phone line.
If you require an additional phone line, it is typical for you to arrange
that yourself. There are three possible configurations when ordering cablemodem
or residential ADSL services.

</p><img src="images/network2.jpg" alt="Cable modem connection diagram"><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2809799"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>In the tables below, please keep the following information in
mind:</p><ol type="1"><li><p>ISPs often supply the items marked * to your server
by DHCP.</p></li><li><p>Some ISPs block outgoing HTTP connections, forcing you
to use their proxy server. This interferes in a few minor ways with your
server (e.g., the test for Internet connectivity will fail
erroneously). However, using the ISP's proxy server will normally work
fine.</p></li></ol></td></tr></table><ol type="1"><li><p> You receive a routable, static IP address</p><p>Information provided to you by your ISP:</p><ul type="disc"><li><p>static IP address</p></li><li><p>IP address of cablemodem or ADSL router (&quot;gateway IP address&quot;)</p></li><li><p>subnet mask</p></li></ul><p>Order services from: Service List A</p></li><li><p>You receive a routable, dynamically assigned IP address
and you elect to use a dynamic DNS service (We encourage you to
review <i>Appendix B: Dynamic DNS Services</i> for a
discussion of dynamic DNS services.)</p><p> Information provided to you by your ISP:</p><ul type="disc"><li><p>gateway IP address*</p></li><li><p>subnet mask*</p></li></ul><p> Information provided by dynamic DNS service:</p><ul type="disc"><li><p>DNS service account name</p></li><li><p>DNS service password</p></li></ul><p> Order services from: Service List B</p></li><li><p>You receive a routable, dynamically assigned IP address
and you elect not to use a dynamic DNS service OR your IP
address is non-routable. </p><p> Information provided to you by your ISP:</p><ul type="disc"><li><p>IP address of cablemodem or ADSL router
        (&quot;gateway IP address&quot;)*</p></li><li><p>subnet mask*</p></li></ul><p> Order services from: Service List D</p></li></ol><a name="orderingdialup"></a>3.3.3.  Ordering a dialup connection<p>

It is typical for you to purchase and install your own modem or
ISDN adapter for your dialup connection. (Be
sure to use a Linux-compatible modem - WinModems will not work.) Your modem
connects to your ISP over a conventional phone line. If you require an
additional phone line, it is typical for you to arrange that yourself.
</p><img src="images/network3.jpg" alt="Dialup connection diagram"><p>
Your ISDN adapter will connect to the ISDN connection installed by your ISP or
local telecommunications provider. The software can work with external ISDN
adapters and includes support for passive ISDN cards.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2810059"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>While the software includes experimental support for ISDN
cards, we do not provide technical support for the use of these cards
as they have not yet been tested in a wide enough variety of environments.</p></td></tr></table><p>
There are two possible
configurations with dialup service:
</p><ol type="1"><li><p>Your ISP is able to meet all of the following three
conditions:</p><ul type="disc"><li><p>you receive a routable, static IP
        address</p></li><li><p>your ISP will provide a secondary mail
        server for your domain, which receives e-mail when your
        server is not
        connected.</p></li><li><p>your ISP is able to accept the &quot;ETRN
        command&quot;. (This command is used by the server to
        retrieve the mail held by the ISP's secondary mail
        server.)</p></li></ul><p>Information provided to you by your ISP:</p><ul type="disc"><li><p>static IP address</p></li><li><p>dialup access number</p></li><li><p>dialup account name</p></li><li><p>dialup account password</p></li></ul><p> Order services from: Service List C</p></li><li><p>Your ISP is unable to meet all three of the above
conditions</p><p> Information provided to you by your ISP:</p><ul type="disc"><li><p>dialup access number</p></li><li><p>dialup account name</p></li><li><p>dialup account password</p></li></ul><p>    Order services from: Service List D</p></li></ol><a name="ispservices"></a>3.4. Arranging Services From Your ISP<p>

In each section on connectivity, above, we direct you to the appropriate
list of services that should be ordered from your ISP.
</p><a name="servicelista"></a>3.4.1. Service List A<ul type="disc"><li><p>domain name set up and hosting</p></li><li><p>publication of DNS address records for your web server,
FTP server and e-mail server</p></li><li><p>publication of DNS mail (MX) records</p></li><li><p>secondary mail server (optional)</p></li><li><p>Internet news server (optional)</p></li></ul><a name="servicelistb"></a>3.4.2. Service List B<p>
Services to order from ISP:
</p><ul type="disc"><li><p>secondary mail server (optional)</p></li><li><p>Internet news server (optional)</p></li></ul><p>
Services From Dynamic DNS Service
</p><ul type="disc"><li><p>domain name (depending on the service purchased, your
dynamic DNS service may restrict what your domain name can
be)</p></li><li><p>publication of DNS address records for your web server,
FTP server and e-mail server</p></li><li><p>publication of DNS mail (MX) records</p></li></ul><a name="servicelistc"></a>3.4.3. Service List C<ul type="disc"><li><p>PPP dialup access (with static IP)</p></li><li><p>domain name</p></li><li><p>publication of DNS address records for your e-mail
server*</p></li><li><p>publication of DNS mail (MX) records</p></li><li><p>secondary mail server (ETRN must be
supported)</p></li><li><p>Internet news server (optional)</p></li></ul><p>

Your web and
FTP servers are available to the external world only when your server
is connected to the Internet. DNS address records for web and FTP
servers only need to be published if it is likely that someone external
to your site will need to connect to them for a particular reason.
</p><a name="servicelistd"></a>3.4.4. Service List D<p>
Please read the important
notes (below) on the limitations of this configuration.
</p><ul type="disc"><li><p>PPP dialup access (if you are using dialup
connectivity)</p></li><li><p>POP mailbox (with generous size
limitation)</p></li><li><p>domain name - route all mail for domain name to the
single POP mailbox</p></li><li><p>Internet news server (optional)</p></li></ul><a name="sidebar-multidrop"></a><table border="1"><tr><td><p class="title"><b>Some Important Notes on Service List D (Multidrop Mail)</b></p><p>
Service list D is applied
to configurations where the publication of DNS records is not practical
either because your IP address changes frequently or because it is non-routable.
Because there is no published address receiving incoming network connections,
this configuration does not allow you to host a web page or FTP site using
your SME Server.
</p><p>
In this case, e-mail
is handled using a method called <b>&quot;multidrop&quot;</b>, which involves temporarily
storing all e-mail messages addressed to your domain in a POP mailbox at
your ISP until your server connects and fetches them.
Your POP mailbox must be large enough to hold the e-mail for your organization
until it is fetched. If your primary ISP cannot supply this, you can use
another ISP for your e-mail hosting.
</p><p>
As e-mail messages are
delivered into the POP mailbox at your ISP, some of the addressee information
is removed. To determine to whom the e-mail message is addressed, your server
uses several heuristics. This works very well for normal
person-to-person e-mail. However, messages from <b>mailing lists</b> (and other
sources where the user's account name is not present in the headers) cannot
be delivered. Any e-mail that cannot be delivered will be returned to the
sender. If the e-mail cannot be returned to sender, it will be directed
to the system administrator.

</p><p>
Some ISPs add a header
to each e-mail message as it enters the POP mailbox to assist in determining
the addressee. One common header tag is: &quot;X-Delivered-To&quot;. If your ISP
does this, make note of the header tag used so that you can configure your
server to look for it (explained in a later section).
</p><p>Because of the potential problems involved with delivery of e-mail to
multidrop mailboxes, we strongly encourage you to consider other means of mail
delivery before resorting to using multidrop.
</p></td></tr></table><p><b>Terms used in ordering connectivity and services</b></p>ADSL (or DSL)<p>
ADSL is a type of high-speed Internet access that uses regular phone lines and
is available in many metropolitan areas.
</p>Domain Name<p>
This refers to the
unique name attached to your organization on the Internet. For example,
&quot;tofu-dog.com&quot; or &quot;e-smith.com&quot;. If you don't have a domain name, your
ISP can help you select one, ensure it is available, and register it.

</p>DNS (Domain Name Service)<p>
DNS, or Domain Name
Service, refers to the software and protocols involved in translating domain
names to IP addresses. Your server provides DNS lookup
services for your local network, and your ISP typically also provides you
with the IP addresses of DNS servers. These servers do <b>not</b> need to be configured into your server
 as the DNS server that is provided with your server will
correctly resolve all local and Internet names.
</p>DNS: Publication of DNS Address Records<p>
The publication of
DNS address information allows other DNS servers to look up your domain
information. Your ISP must publish DNS address records associating the
name of your web server (&quot;www.domain.xxx&quot;), FTP server (&quot;ftp.domain.xxx&quot;)
and e-mail server (&quot;mail.domain.xxx&quot;) with the IP address of your server.
</p>DNS: Publication of DNS Mail (MX) Records<p>

The publication of
DNS mail (MX) records is the method used to inform Domain Name Services
worldwide that all e-mail to your domain (&quot;yourdomain.xxx&quot;) should be delivered
to your e-mail server (&quot;mail.yourdomain.xxx&quot;).
</p>ETRN<p>
ETRN is a command
used for dialup solutions in order to retrieve e-mail temporarily stored
at your ISP
</p>Gateway IP Address<p>
A gateway is the device
on your network that forwards packets to and from the Internet. The gateway
IP address is the IP address for that device.
</p>Internet News Service<p>
If you want access
to Internet newsgroups, your ISP will need to provide the IP address of
an Internet news server. The ISP will provide direction in configuring
your web browser or other newsreading software.
</p>PPP<p>
PPP refers to the &quot;Point-to-Point Protocol&quot; used when a modem connects to the ISP.

</p>PPPoE<p>
&quot;PPP over Ethernet&quot; is a modified version of PPP that is used over some
high-speed ADSL connections to the ISP.
</p>Secondary Mail Server<p>
A secondary mail server
receives e-mail for your domain if your server is unavailable,
and reattempts delivery later.
</p>Subnet Mask (or netmask)<p>
A subnet mask (or
a netmask) has four numeric segments (each between 0 and 255) and looks
like an IP address. It enables your computers to deduce what network they
are on. Your ISP provides the netmask for the external network between
the ISP and your server.
</p><a name="hardware"></a>Chapter 4. Hardware Requirements of the SME Server Host
Computer<p><b>Table of Contents</b></p>4.1. <a href="#hardwarecat1">Hardware Requirements for a Category 1 Server</a>4.2. <a href="#hardwarecat2">Hardware Requirements for a Category 2 Server</a>4.3. <a href="#hardwarecat3">Hardware Requirements for a Category 3 Server</a>4.4. <a href="#hardwarecat4"> Hardware Requirements for a Category 4 Server</a>4.5. <a href="#supportedenet">Supported Ethernet Adapters</a>4.5.1. <a href="#id2812138">Supported Ethernet Adapters</a>4.6. <a href="#supportedscsi">Supported SCSI Adapters</a>4.7. <a href="#supportedtape">Supported Tape Drives</a><p>

The hardware requirements
of the SME Server are modest compared with other server
software available today. However, because of its critical role in your
office, selecting an appropriate host computer is important. The hardware
requirements of the host computer depend on such things as the number of
users on your network, whether you plan to use the proxy server on the
server, and the speed of your Internet connection.
</p><p>
Because the SME Server software relies upon your computer meeting the hardware
standards noted in this section, Contribs.org cannot support a server installed
on hardware that does not meet these standards.
</p><p>Before you consider the requirements defined below, please be aware
of the following notes:
</p><ul type="disc"><li><p>
The server ships with the remote access services disabled
by default.  Enabling webmail will increase the resource
requirements of your server, in particular the memory requirement. Other
remote access services, such as ssh and PPTP, are also processor-intensive.
You should consider a fast processor speed if you intend to make
significant use of these services.
</p></li><li><p>The server should work with any Pentium,
Celeron, AMD or Cyrix processor that can run Red Hat Linux 7.3.</p></li><li><p>
        For a dedicated connection in server and gateway mode, your server requires
        two ethernet adapters (also called network adapters or network
        interface cards). For a dialup connection or server-only
        mode, one ethernet adapter is needed.
</p></li><li><p>
SCSI (Small Computer Systems Interface) is a system for adding peripherals to
a computer which enhances performance, reliability and scalability. If
you are using a SCSI system, you will need a specific adapter/driver (installed
similarly to an ethernet adapter) and will need to purchase SCSI-enabled
peripherals. These tend to be more expensive than their non-SCSI counterparts
but the tradeoff is often worth it if the system will be under heavy loads.
</p></li></ul><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2809385"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Our hardware recommendations only apply to servers
with up to 500 users. This is not a technical limitation, and the SME Server
can provide services to more than 500 users.
In that case, we suggest that you
specify a custom system using our <a href="#hardwarecat4" title="5.4.  Hardware Requirements for a Category 4 Server">Category
4</a> requirements as the minimum starting point.

</p></td></tr></table><a name="hardwarecat1"></a>4.1. Hardware Requirements for a Category 1 Server<p>The following information outlines what we consider the minimum
system that can give satisfactory performance as a basic file/print server and
network gateway.  Note that we do not believe such a system will
provide satisfactory performance for features such as webmail, remote
access via PPTP.
</p><p><b>Table 4.1.  Definition of a Category 1 Server</b></p><table summary=" Definition of a Category 1 Server" border="1"><tr><td># of Users</td><td>Up to 10</td></tr><tr><td>Usage</td><td>Light (minimal use of remote access, file sharing and
                other disk-intensive activity. No use of webmail, virus
                scanning or VPNs.)</td></tr></table><p><b>Table 4.2. Hardware Requirements for a Category 1 Server</b></p><table summary="Hardware Requirements for a Category 1 Server" border="1"><tr><td>Architecture</td><td>PCI-based Pentium-class processor
        </td></tr><tr><td>Processor speed</td><td>90 MHz (or better)</td></tr><tr><td>Minimum RAM</td><td>32 MB (64 MB recommended)</td></tr><tr><td>Hard drive </td><td>IDE or SCSI - at least 1 GB</td></tr><tr><td>SCSI adapter </td><td>SCSI adapter must appear on the <a href="#supportedscsi" title="5.6. Supported SCSI Adapters">

        supported list (only necessary for SCSI systems)</a></td></tr><tr><td>Ethernet adapters
        </td><td>The ethernet adapters installed on your server
        must appear on the <a href="#supportedenet" title="5.5. Supported Ethernet Adapters">supported list</a>.
        </td></tr><tr><td>Modem (for dialup only)</td><td>Only modems that are Linux-compatible may be used.
        WinModems are not supported.</td></tr><tr><td>CD-ROM drive</td><td>ATAPI or SCSI</td></tr><tr><td>Floppy drive</td><td>any</td></tr><tr><td>Monitor</td><td>any</td></tr><tr><td>Graphics card</td><td>any</td></tr><tr><td>Mouse</td><td>none required</td></tr><tr><td>Sound card</td><td>none required</td></tr></table><p>

</p><a name="hardwarecat2"></a>4.2. Hardware Requirements for a Category 2 Server<p><b>Table 4.3.  Definition of a Category 2 Server</b></p><table summary=" Definition of a Category 2 Server" border="1"><tr><td># of Users</td><td>Up to 40</td></tr><tr><td>Usage</td><td>Light (moderate use of remote access, file sharing and
                other disk-intensive activity)</td></tr></table><p><b>Table 4.4. Hardware Requirements for a Category 2 Server</b></p><table summary="Hardware Requirements for a Category 2 Server" border="1"><tr><td>Architecture</td><td>PCI-based Pentium-class processor
        </td></tr><tr><td>Processor speed</td><td>400 MHz (or better)</td></tr><tr><td>Minimum RAM</td><td>128 MB</td></tr><tr><td>Hard drive </td><td>IDE or SCSI - at least 6 GB</td></tr><tr><td>SCSI adapter</td><td>SCSI adapter must appear on the <a href="#supportedscsi" title="5.6. Supported SCSI Adapters">

        supported list</a> (only necessary for SCSI systems)
        </td></tr><tr><td>Ethernet adapters
        </td><td>The ethernet adapters installed on your server
        must appear on the <a href="#supportedenet" title="5.5. Supported Ethernet Adapters">supported list</a>.
        </td></tr><tr><td>Modem (for dialup only)</td><td>Only modems that are Linux-compatible may be used.
        WinModems are not supported.</td></tr><tr><td>CD-ROM drive</td><td>ATAPI or SCSI</td></tr><tr><td>Floppy drive</td><td>any</td></tr><tr><td>Monitor</td><td>any</td></tr><tr><td>Graphics card</td><td>any</td></tr><tr><td>Mouse</td><td>none required</td></tr><tr><td>Sound card</td><td>none required</td></tr></table><p>

</p><a name="hardwarecat3"></a>4.3. Hardware Requirements for a Category 3 Server<p><b>Table 4.5.  Definition of a Category 3 Server</b></p><table summary=" Definition of a Category 3 Server" border="1"><tr><td># of Users</td><td>Up to 40</td></tr><tr><td>Usage</td><td>Heavy (heavy use of remote access, file sharing and
                other disk-intensive activity)</td></tr></table><p><b>Table 4.6.  Hardware Requirements of a Category 3 Server</b></p><table summary=" Hardware Requirements of a Category 3 Server" border="1"><tr><td>Architecture</td><td>PCI-based Pentium-class processor
        </td></tr><tr><td>Processor speed</td><td>600 MHz (or better)</td></tr><tr><td>Minimum RAM</td><td>256 MB</td></tr><tr><td>Hard drive </td><td>IDE or SCSI (SCSI <i>highly</i> recommended) - at least 10 GB</td></tr><tr><td>SCSI adapter</td><td>SCSI adapter must appear on the <a href="#supportedscsi" title="5.6. Supported SCSI Adapters">

        supported list</a> (only necessary for SCSI systems)
        </td></tr><tr><td>Ethernet adapters
        </td><td>The ethernet adapters installed on your server
        must appear on the <a href="#supportedenet" title="5.5. Supported Ethernet Adapters">supported list</a>.
        </td></tr><tr><td>Modem (for dialup only)</td><td>Only modems that are Linux-compatible may be used.
        WinModems are not supported.</td></tr><tr><td>CD-ROM drive</td><td>ATAPI or SCSI</td></tr><tr><td>Floppy drive</td><td>any</td></tr><tr><td>Graphics card </td><td>any</td></tr><tr><td>Mouse </td><td>none required</td></tr><tr><td>Sound card </td><td>none required</td></tr></table><p>

</p><a name="hardwarecat4"></a>4.4.  Hardware Requirements for a Category 4 Server<p><b>Table 4.7. Definition of a Category 4 Server</b></p><table summary="Definition of a Category 4 Server" border="1"><tr><td># of Users</td><td>Up to 500</td></tr><tr><td>Usage</td><td>Heavy</td></tr></table><p><b>Table 4.8. Hardware Requirements of a Category 4 Server</b></p><table summary="Hardware Requirements of a Category 4 Server" border="1"><tr><td>Architecture</td><td>PCI-based Pentium-class processor
        </td></tr><tr><td>Processor speed</td><td>700 MHz (or better)</td></tr><tr><td>Minimum RAM</td><td>256 MB</td></tr><tr><td>Hard drive</td><td>SCSI - at least 20 GB (2 large SCSI drives using RAID1
        <i>strongly</i> recommended)</td></tr><tr><td>SCSI adapter</td><td>SCSI adapter must appear on the <a href="#supportedscsi" title="4.6. Supported SCSI Adapters">

        supported list</a></td></tr><tr><td>Ethernet adapters </td><td>The ethernet adapters installed on your server
        must appear on the <a href="#supportedenet" title="4.5. Supported Ethernet Adapters">supported list</a>.
        </td></tr><tr><td>Modem (for dialup only)</td><td>Only modems that are Linux-compatible may be used.
        WinModems are not supported.</td></tr><tr><td>CD-ROM drive</td><td>ATAPI or SCSI</td></tr><tr><td>Floppy drive</td><td>any</td></tr><tr><td>Monitor</td><td>any</td></tr><tr><td>Graphics card</td><td>any</td></tr><tr><td>Mouse</td><td>none required</td></tr><tr><td>Sound card</td><td>none required</td></tr></table><p>

</p><a name="supportedenet"></a>4.5. Supported Ethernet Adapters<p>
Either one ethernet
adapter (in the case of dialup connectivity or server-only mode) or two
ethernet adapters (for dedicated connections in server and gateway mode)
must be installed on your SME Server. This section describes
which types of ethernet adapter can be used in the computer that will become
your server. (There are no restrictions on the ethernet
adapters in your other computers.)
</p><p>
Any adapters installed
on the server must appear on the following supported
list. Note that only PCI adapters are supported.  The PCMCIA adapters
used in many laptops and the older ISA adapters are not supported.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2812080"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Because SME Server is based on Red Hat
Linux version 7.3, PCI ethernet adapters that can work with Red Hat
7.3 should also
work with SME Server.  You can find an up-to-date searchable
database at Red Hat's web site at: <a href="http://hardware.redhat.com/redhatready/cgi-bin/us/db-hcl.cgi" target="_top">http://hardware.redhat.com/redhatready/cgi-bin/us/db-hcl.cgi</a>
<i> (Choose <b>Network Device/Controller</b> from the
&quot;Hardware Category&quot; menu.) </i>

</p></table><a name="id2812138"></a>4.5.1. Supported Ethernet Adapters<p>
The following PCI Ethernet adapters are supported by SME Server:
</p><ul type="disc"><li><p>3Com 3C501, 3C503, 3C556, 3C590, 3C592, 3C595, 3C597</p></li><li><p>3Com 3C900, 3C900B, 3C905, 3C905B, 3C905C, 3C980, 3C985</p></li><li><p>3Com Megahertz 3CXE589D, EC, ET</p></li><li><p>Accton EN1203, EN1207, EN1207(B,C,D,F), EN2212 EtherDuo PCI, SOHO BASIC EN220
</p></li><li><p>Adaptec ANA6901/C, ANA6911/TX, ANA6911A/TX</p></li><li><p>ALFA GFC2206</p></li><li><p>AMD</p></li><li><p>Allied Telesyn AT-2550, AT-2560</p></li><li><p>AMD 79c970 (PCnet LANCE), 79c978 (HomePNA)</p></li><li><p>AT&amp;T GIS (NCR) 100VG</p></li><li><p>C-NET CNE-935</p></li><li><p>Cogent EM100, EM110, EM400, EM960, EM964 (Quartet)</p></li><li><p>Compaq NetFlex 3/P, Integrated NetFlex 3/P</p></li><li><p>Compaq Netelligent 10 T PCI UTP, 10 T/2 PCI UTP/Coax, 10/100 TX Embedded,
10/100 TX PCI UTP,10/100 TX UTP, Dual 10/100 TX PCI UTP, Integrated 10/100 TX UTP, ProLiant
Integrated 10/100</p></li><li><p>Compex ReadyLink 100TX, 2000, ENET100-VG4</p></li><li><p>D-Link DE-530CT, DFE500-Tx, DFE540-Tx</p></li><li><p>Danpex EN-9400P3</p></li><li><p>DEC 21040, 21041</p></li><li><p>Davicom Ethernet 100/10</p></li><li><p>Farallon PN9000SX</p></li><li><p>Fujitsu FMV-181, FMV-182, FMV-183, FMV-184</p></li><li><p>General Instruments SB1000</p></li><li><p>Genius GF100TXR (RTL8139)</p></li><li><p>HP J2585A, J2585B, J2970, J2973</p></li><li><p>IBM EtherJet PCI 10/100 adapter (i82557)</p></li><li><p>Intel 82556, 82557, 82865</p></li><li><p>Intel PCI EtherExpress Pro 10+, Pro100+, Pro100B</p></li><li><p>Kingston EtherX KNE100TX, KNE110TX, KNE120TX, KNE20T, KNE30T, KNT40T,
KNECB4TX</p></li><li><p>Lite-ON LNE100TX</p></li><li><p>Lucent WaveLan</p></li><li><p>Macronix MX98713, MX987x5</p></li><li><p>Microdyne/Eagle NE10/100 (i82557 w/DP83840 transceiver)</p></li><li><p>NDC Communications NE100TX-E</p></li><li><p>Netgear FA310TX 10/100, FA310TXC 10/100, GA620 </p></li><li><p>Novell NE1000, NE2000, NE2100, NE2500, NE3210, NL-10000</p></li><li><p>Olicom OC-2183, OC-2325, OC-2326</p></li><li><p>Racal Interlan ES3210</p></li><li><p>Realtek 8029</p></li><li><p>Samsung Smartether100 SC1100</p></li><li><p>Sis 900</p></li><li><p>SMC 8432T, 8432BT, EtherPower, EtherPower10/100, EZ 1208T, EZ 1211TX, 83C170QF, LANEPIC</p></li><li><p>Surecom EP-320X</p></li><li><p>Symbios 83C885, Yellowfin G-NIC</p></li><li><p>Syskonnect Gigabit Ethernet</p></li><li><p>Thomas Conrad TC5048</p></li><li><p>Znyx ZX312 (EtherArray), ZX314, ZX315, ZX342, ZX344, ZX345, ZX346, ZX348, ZX351 </p></li></ul><p>If your adapter is not listed above, it may be supported if it is based on one of the
following chipsets (check with Red Hat's web site mentioned above for
confirmation):</p><ul type="disc"><li><p>Alteon AceNIC Gigabit Ethernet</p></li><li><p>Compex RL2000</p></li><li><p>DEC Tulip</p></li><li><p>KTI ET32P2</p></li><li><p>NetVin NV5000SC</p></li><li><p>RealTek RTL8029, RTL8029AS, RTL8129/8139</p></li><li><p>VIA Rhine, VT86C926 &quot;Amazon&quot;</p></li><li><p>Winbond 89C940</p></li></ul><a name="supportedscsi"></a>4.6. Supported SCSI Adapters<p>

If the computer you
plan to use for your server has a SCSI hard disk, your
SCSI adapter must be supported by Red Hat Linux 7.3.
PLEASE NOTE: Only PCI
SCSI adapters are supported by the SME Server. Furthermore,
they must contain a SCSI BIOS so that the PC can boot from the SCSI disk.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2812522"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>As SME Server is based on Red Hat
Linux version 7.3, PCI-based SCSI adapter that can work with
Red Hat Linux 7.3 should also
work with SME Server. You can find an up-to-date searchable
database at Red Hat's web site at: <a href="http://hardware.redhat.com/redhatready/cgi-bin/us/db-hcl.cgi" target="_top">http://hardware.redhat.com/redhatready/cgi-bin/us/db-hcl.cgi</a>
<i> (Choose <b>Storage Device/Controller</b> from the
&quot;Hardware Category&quot; menu.) </i>
</p></td></tr></table><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2812574"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>
<i>In the list below the use of an 'x' symbolizes a
wildcard. For example, 'AHA-29xx' indicates it applies for the 'AHA-2930' as
well as the 'AHA-2940' and any other models beginning with 'AHA-29'.

</i>
</p></td></tr></table><ul type="disc"><li><p>Adaptec AIC-78xx, AHA-29xx, AHA-394x, 29160/39160,
AHA-1520B</p></li><li><p>Advansys ABP510, ABP514x, ABP930/40, ASC1200</p></li><li><p>AMI MegaRAID</p></li><li><p>Artop Electronic Corp AEC671x</p></li><li><p>Dell PowerEdge RAID Controller
2[<a name="id2812622" href="#ftn.id2812622">1</a>], Expandable RAID Controller
2/3</p></li><li><p>Future Domain TMC-18C30</p></li><li><p>HP NetRAID-4M</p></li><li><p>IBM ServeRAID</p></li><li><p>ICP Raid Controller GDT 6xxx, GDT 7xxx</p></li><li><p>Initio Corp INI-940, INI-950, INI-9100/9100W, 360P</p></li><li><p>Intel 80960RP</p></li><li><p>LSI MegaRAID express500</p></li><li><p>Mylex (BusLogic) FlashPoint Series, MultMaster 01/10</p></li><li><p>Symbios 53c1510, 53c8xx</p></li><li><p>Q Logic QLA10160, 1080, 1240, 1280, 2100, 2200 12160</p></li></ul><a name="supportedtape"></a>4.7. Supported Tape Drives<p>If you intend to use the <a href="#admin-backup" title="12.2. Backup or Restore">tape backup</a>

capabilities of the SME Server, you must have a tape drive
that will work with a Linux system.
</p><p>We believe that most SCSI tape drives and many IDE tape drives will work
correctly.  Unfortunately, the popular <i>OnStream</i> tape
drives do not at the current time work with Red Hat Linux version 7.3,
and hence are not supported by your SME Server.
</p><p>We have tested the following tape drives and know that they work with
the SME Server:
</p><p><b>Table 4.9.  Supported SCSI Tape Drives</b></p><table summary=" Supported SCSI Tape Drives" border="1"><tr>VendorModelRevisionFormat</tr><tr><td>Dell</td><td>Powervault 100T</td><td> </td><td>DAT</td></tr><tr><td>HP</td><td>HP35470A</td><td>T603</td><td>DAT</td></tr><tr><td>Seagate</td><td>Python 06408</td><td>XXX</td><td>DAT</td></tr><tr><td>SONY</td><td>SDX-300C</td><td>0400</td><td>AIT</td></tr></table><p><b>Table 4.10.  Supported ATA (IDE) Tape Drives</b></p><table summary=" Supported ATA (IDE) Tape Drives" border="1"><tr>VendorModelRevisionFormat</tr><tr><td>Seagate</td><td>STT20000A</td><td>8A51</td><td> </td></tr><tr><td>Seagate</td><td>STT32000A</td><td> </td><td> </td></tr></table><p>We have tested and verified that the following tape drives do

<i>not</i> work with the SME Server:
</p><p><b>Table 4.11.  Unsupported ATA (IDE) Tape Drives</b></p><table summary=" Unsupported ATA (IDE) Tape Drives" border="1"><tr>VendorModelRevisionFormat</tr><tr><td>OnStream</td><td>DI-30</td><td> </td><td>ADR</td></tr></table><p>If you do not have one of the supported
drives listed above you may want to check with <a href="http://hardware.redhat.com/" target="_top">http://hardware.redhat.com/</a> for
information about how well that drive will work with Red Hat Linux
7.3.</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2813050"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>If your tape drive is not listed at Red Hat's site, you can visit

<a href="http://www.linuxtapecert.org/" target="_top">http://www.linuxtapecert.org/</a> to see
if your tape drive vendor is participating with that tape drive certification
effort.  Be aware that some of the solutions developed to get certain tape drives
to work with Linux may require kernel modifications and only be attempted by
experienced developers.
</p></td></tr></table><br><hr width="100" align="left"><p>[<a name="ftn.id2812622" href="#id2812622">1</a>] Note that the firmware on this controller may need to be updated before
it can work your server.  See <a href="http://no.longer.valid/modules/xoopsfaq/" target="_top">http://no.longer.valid/modules/xoopsfaq/</a> for more
information.</p><a name="installing"></a>Chapter 5. Installing And Configuring Your SME Server Software<p><b>Table of Contents</b></p>6.1. <a href="#licensing">Licensing Terms and Conditions</a>5.2. <a href="#raidsupport">RAID1 Support (Disk Mirroring)</a>5.2.1. <a href="#raid1-software">Software Mirroring</a>5.2.2. <a href="#raid1-hardware">Hardware Mirroring</a>5.3. <a href="#upgrading">Upgrading From A Previous Version</a>5.4. <a href="#installingsoft">Installing the Software</a>5.5. <a href="#configserver">Configuring your SME Server</a>5.6. <a href="#configadminpasswd"> Setting Your Administrator Password</a>5.7. <a href="#configsysnames"> Configuring Your System Name and Domain Name</a>5.8. <a href="#configlocalnet"> Configuring Your Local Network</a>5.8.1. <a href="#configenetlocal">Selecting Your Local Ethernet Adapter</a>5.8.2. <a href="#configinternal">Configuring Local Network Parameters</a>5.9. <a href="#operationmode"> Operation Mode</a>5.9.1. <a href="#id2814564">Option 1: Server and gateway mode</a>5.9.2. <a href="#id2814637">Option 2: Private server and gateway</a>5.9.3. <a href="#id2814702">Option 3: Server-only mode</a>5.10. <a href="#configsvrgwy">Configuring Server and Gateway Mode</a>5.11. <a href="#configexternal">Server and Gateway Mode - Dedicated</a>5.11.1. <a href="#configextenet">Configuring Your External Ethernet Adapter</a>5.11.2. <a href="#id2815019">Assigning Your Ethernet Adapters to Network Connection</a>5.11.3. <a href="#configexternal.dedicated">Configuring Your External Interface</a>5.11.4. <a href="#configdyndns">Configuring Dynamic DNS</a>5.12. <a href="#configexternal.dialup">Configuring the Server for Server and Gateway Mode - Dialup Access</a>5.13. <a href="#configdhcpsvr">Configuring Your DHCP Server</a>5.13.1. <a href="#configdhcprange">Configuring the DHCP Address Range</a>5.13.2. <a href="#id2816095">Important issues about the DHCP address range</a>5.14. <a href="#configmisc"> Further Miscellaneous Parameters</a><a name="licensing"></a>5.1. Licensing Terms and Conditions<p>

In installing the SME Server software, you are agreeing to the open source licensing
terms and conditions associated with it. You can read these terms and conditions
in the introduction to this guide under the title
<a href="#softwarelicensing" title="1.2. Software Licensing Terms and Conditions"><i>Software Licensing Terms and
Conditions</i></a>.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2810970"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>
The computer on which you install this software will be totally dedicated
to being your SME Server. The hard drive of this computer
will be erased and re-written with the Linux operating system - dramatically
enhancing the reliability of your server over other
operating systems. However, this means that while this computer is acting
as your server, you cannot use it for any other purpose.
</p></td></tr></table><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2810976"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>
If you have previously installed and configured a
server and are reinstalling the software, please
be aware that you must use the <a href="#upgrading" title="6.3. Upgrading From A Previous Version">Upgrade</a> option
in order to preserve your existing configuration and data.
Simply performing a new installation will erase all previously existing
user accounts, user directories, i-bay contents and web site and configuration
parameters. If you have not already done so, you may wish to back up the
contents of your server onto one of your desktop computers.
You can do so easily by selecting &quot;Backup or restore&quot; from the server manager,
as explained in the chapter on on-going administration of your
server.
</p></td></tr></table><a name="raidsupport"></a>5.2. RAID1 Support (Disk Mirroring)<p>With SME Server, you have the ability to set up disk
mirroring, also called RAID Level 1.  In disk mirroring, you basically
write all of your data to two separate hard disks installed in your
server.  One is the mirror of the
other.  Should the primary disk experience a hardware failure, the
mirror disk will continue operations as if nothing had happened. All
of your data will be protected. </p><p>Disk mirroring can be accomplished through either <i>software

</i> or <i> hardware </i>.
</p><a name="raid1-software"></a>5.2.1. Software Mirroring<p>To enable software RAID1 support, you must first have two disks that are
either the same size or capable of having partitions of the same size. They
can be either SCSI or IDE drives.
<b>They must both be installed in your system prior
to installing the SME Server software. Software RAID support can
<i>only</i> be configured at the time you install the
software.</b> If you choose not to configure RAID support on your
server, and later wish to do so, you will need to reinstall the SME Server software.</p><p>Once you have two disk drives, activating RAID support requires only a
very slight change in the <a href="#installingsoft" title="6.4. Installing the Software">software
installation process.</a></p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2813109"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>SME Server supports a software implementation of
RAID Level 1, known as disk mirroring.
It does <i>not </i>support RAID Level 0 (disk striping),
as that does not provide any protection of your data whatsoever. It does
not support RAID Level 5 (disk striping with parity) because of the poor
performance and reliability of software implementations of RAID5.  If you are seeking
RAID5 support, Contribs.org recommends you consider one of the many hardware
implementations which will provide both protection and performance.

</p></td></tr></table><a name="raid1-hardware"></a>5.2.2. Hardware Mirroring<p>
With hardware mirroring, you use a special RAID disk controller to perform the
actual mirroring across multiple disks.  As mirroring is performed in hardware, the performance can be significantly
faster than software mirroring.  Additionally it can simplify
configuration because to the operating system the entire RAID disk system
looks like one single disk. You should be able to use any supported SCSI
hardware RAID controller.
</p><p>
If you are going to use hardware mirroring, you should <b>NOT</b> choose <i>Install - Dual hard
disk with software RAID-1 mirroring</i> in the <a href="#installingsoft" title="5.4. Installing the Software">installation process</a>. (Doing so will enable
<i>software </i> mirroring.) Instead, you should do a
regular installation of the software.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2813347"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Using one of the supported hardware RAID controllers, you

<i>will</i> be able to upgrade from an earlier version of
the SME Server to version 5.1 using the standard <a href="#upgrading" title="5.3. Upgrading From A Previous Version">upgrade process </a>. You should back up all your data
and test carefully after installation.
</p></td></tr></table><a name="upgrading"></a>5.3. Upgrading From A Previous Version<p>If you have previously installed a server
and now
wish to upgrade to version 5.1, you <i>can </i> do so while
preserving your configuration data.  To do so, select <b>
Upgrade </b> from the appropriate screen in the <a href="#installingsoft" title="5.4. Installing the Software">installation process</a>.
</p><p>While the upgrade should proceed smoothly, we do
recommend that you back up your system prior to performing
this upgrade just to be safe.</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2813418"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>

It is not possible to use the <b>Upgrade</b> option
to <i>add</i> software mirroring (RAID1) to an existing server.
</p><p>
If you previously installed software mirroring with a previous version
of the software, you
should be able to upgrade without any problems.  However, if you want to
upgrade a previous version of the software that was <i>not</i>
installed with software mirroring to
use software mirroring (RAID1) support, you should:
</p><ol type="1"><li><p>perform a <a href="#admin-backup" title="14.2. Backup or Restore">backup</a> through the server manager
</p></li><li><p>perform a fresh install selecting the software mirroring option

</p></li><li><p>restore the backup through the server manager
</p></li></ol></td></tr></table><a name="installingsoft"></a>5.4. Installing the Software<table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2813512"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>If you are configuring your system with RAID1 support, notice that
your step 4 below will be slightly different.  If you skipped the <a href="#raidsupport" title="6.2. RAID1 Support (Disk Mirroring)">previous section on RAID</a>, it would be
advisable to read it before proceeding.
</p></td></tr></table><p>
<b>Step 1:</b> Insert
the CD-ROM. If your computer is an older model that is unable to boot from
CD-ROM, you will also need to insert the boot floppy. Most modern computers do
not need to use a boot floppy.
</p><p>
<b>Step 2:</b> Review
the warning screen and type <b>accept</b> to indicate
your acceptance of Contribs.org's legal terms
and conditions and your acknowledgment that installation of the software
will rewrite the host computer's hard drive.

</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2813570"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>The installation process formats and
erases <b>all attached hard drives.</b> If you
have multiple hard drives, be sure to back them up prior to starting the
installation process.
</p></td></tr></table><p>
<b>Step 3:</b> Read the software licensing terms
and indicate your acceptance of the license.
</p><p>
<b>Step 4:</b> Choose whether you wish to
<i>Install on a single hard disk (or use hardware mirroring)</i>,
<i>Install on dual hard disks using software mirroring</i>

(RAID1 support), or
<i>Upgrade</i>.
</p><p>
<b>Step 5:</b> Read the screen offering a final
warning. Type
<b>proceed</b> and hit enter on the &quot;OK&quot; button to continue.
The installation process will now automatically proceed to install the
necessary packages.
</p><p>
<b>Step 6:</b> Indicate
whether you wish to create an emergency boot diskette.
This can be used in the future to boot the system in the event that you are
unable to boot from the hard disk.  If you choose yes, you will be prompted
to insert a blank diskette. We recommend that you <i>do</i>

create an emergency boot floppy and put it in a safe place where you can
easily retrieve it when necessary.
</p><p>
<b>Step 7:</b> Finishing the installation
is automatic and takes only a few minutes. At the end of the process, you
will be prompted to remove the floppy diskette and CD and then to reboot
your computer.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2813683"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>The installation (or upgrade) process rewrites the boot sector on
your hard drive. This may cause machines with BIOS boot sector virus detection
to not boot unattended.  This detection should be disabled in your system's
BIOS.</p></td></tr></table><a name="configserver"></a>5.5. Configuring your SME Server<p>
Once your system has restarted (so that it is no longer booting from
the installation CD), you are ready to configure your system.
</p><p>
If your ISP provided
you with a summary of your configuration choices and network information,
we suggest that you keep it handy while completing the screens in the configuration
section of the server console.
</p><p>
There are
several types of configuration parameters that must be entered into your server:
</p><ul type="disc"><li><p>the system password
</p></li><li><p>
the type of ethernet adapters (network interface cards, or NICs) that will be used by your
server to communicate with the internal network and the Internet (or external network).
Typically, the server software will detect this information automatically. (Note
that if you are connecting to the Internet with a dialup connection, you only
need one ethernet adapter.)

</p></li><li><p>
configuration for the internal (local) network - you must provide information
about your internal network so that your server can communicate with other machines
on your local network.
</p></li><li><p>
operation mode - you must select whether your server will operate
in server and gateway mode or server-only mode.
</p></li><li><p>
configuration for the external network/Internet - you must configure your
server so that it can communicate with your ISP
either by a dedicated connection or using a dialup connection <i>(only for
server and gateway mode)</i>.
</p></li><li><p>
miscellaneous information - there are several final items to configure, such
as whether
to allow your users to use a proxy server, whether to provide status reporting
to Contribs.org, and whether you wish to secure the server console so that it can only be accessed using the administrator's password.
</p></li></ul><p>
As you select a given
configuration parameter, you will be presented only with the screens necessary
for your given configuration. Each screen will provide you with a simple,
detailed explanation of the required information.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2813819"></a>Note: The &quot;Keep&quot; option</tr><tr><td colspan="2" align="left" valign="top"><p>As you move through the configuration screens, you will notice that
there is a &quot;Keep&quot; option which will allow you to keep
the choices you may have made previously.  Obviously, when you are configuring your system for the first time, many of these choices will not have been made, but if
you later go back to re-configure the system, this option can save time.

</p></td></tr></table><a name="configadminpasswd"></a>5.6.  Setting Your Administrator Password<p>As shown in the image below, the first thing you will be asked to do is to set the system
password. This is the password you will enter to access the web-based server manager.  Depending on how you configure the system, you may also
need to enter this password to access the server console.  It is
<i>extremely </i>important that you choose a good password and
keep that password secret.
</p><p><b>Anyone who gains access to this password has the
power to make <i>any </i>change to your server!
</b></p><img src="images/set_admin_passwd.jpg" alt="Setting your administrator password"><p>After you enter the password once, you will be asked to type it again to
confirm that the password was recorded correctly. The password will also be
examined to determine how strong it is from a security point-of-view. If it
is found to be weak (for instance, a dictionary word), you will see an
additional screen asking if you <i>really</i> want to use this
password.  You will have the option to go back and change to a stronger
password or to continue using the weaker password.</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2813942"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>You can use any ASCII printable characters in the
administrator password. As this password gives someone total control
over your server, you should choose a password that
cannot be guessed easily.  A good password should contain mixed upper- and
lower-case letters, numbers and punctuation, yet also be easy to
remember.  An example might be &quot;IwmSMES!&quot; as in &quot;I want my SME Server!&quot;

(Please don't use this example as your password!)
</p></td></tr></table><a name="configsysnames"></a>5.7.  Configuring Your System Name and Domain Name<p>
As shown below, your next step is to enter the <i>primary </i> domain name that
will be associated with your SME Server.  (You can later configure other
<i>virtual </i> domains that work with the server.)
</p><img src="images/set_primary_domain_name.jpg" alt="Setting the primary domain name"><p>
Next you need to provide a name for your server. You should think
carefully about this as changing it later may create additional work. (For
instance, Windows client computers may be mapping drives to your server
using its name.  Those clients would need to remap the drive using the new
name.) </p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/tip.gif"></td><a name="id2814042"></a>Tip</tr><tr><td colspan="2" align="left" valign="top"><p>You should make the system name as unique as possible in case you
someday decide to link your server to another server using an IPSEC VPN.
When you do, each server will need a unique name. Using some type of theme,
such as location names, may be an effective way to ensure unique names.</p></td></tr></table><img src="images/select_system_name.jpg" alt="Selecting the system name"><a name="configlocalnet"></a>5.8.  Configuring Your Local Network<a name="configenetlocal"></a>5.8.1. Selecting Your Local Ethernet Adapter<p>

An ethernet adapter
- also called an ethernet card or network interface card (NIC) - is a special
piece of hardware that serves as the interface between a computer and the
ethernet network. It connects your computer and
the ethernet, allowing the computer to communicate with other computers
and devices on the network.
</p><p>
A computer needs a special
software program, called an &quot;ethernet driver&quot;, to use an ethernet adapter.
Which ethernet driver is required depends on which ethernet adapter is
installed on your computer.
</p><p>
You will first need to select the appropriate driver for the ethernet adapter
connected to your local network, a shown in the screen below:
</p><img src="images/select_local_enet_driver.jpg" alt="Selecting the local Ethernet driver"><p>
If you are using a PCI
ethernet adapter that appears on our supported list, it is likely that your server will be able to detect your hardware
automatically and you will simply be able to choose option 1,
&quot;Use xxxx (for chipset yyyy)&quot;, where 'xxxx' and 'yyyy' are specific to your
hardware.  If the software fails to detect it correctly, you can manually select the
appropriate driver for your ethernet adapter from
a list of drivers or from a list of ethernet adapter models.
After the appropriate driver is selected, select &quot;OK&quot;
and proceed to the next screen.
</p><a name="configinternal"></a>5.8.2. Configuring Local Network Parameters<p>
Your SME Server needs information about your local network in order to communicate
with the other computers on your network.
This includes the IP address and the subnet mask on your server's internal
interface. Because your server acts as a gateway and firewall, these will
differ from the IP address and subnet mask on the external interface.

</p><p>
If you plan to operate in server and gateway mode (explained in greater detail below),
your server will act as a relay between your local network
and the Internet. Because no computer on your local network, other than
your server, directly interacts with the external world,
the IP addresses assigned to those computers need only be
unique with regards to your local network. (It doesn't matter if a computer
on someone else's local network uses the same IP address, because the two
machines will not be in direct contact.) As a result, we are able to use
special &quot;non-routable IP addresses&quot; for your local network, including the
internal interface of your server.
</p><img src="images/select_local_network.jpg" alt="Selecting local network information"><p>
<b>
If you have no reason to prefer one set of IP addresses
over another for your local network, your server will
prompt you with default parameters that are probably appropriate in your
situation.
</b>
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/tip.gif"></td><a name="id2813275"></a>Tip</tr><tr><td colspan="2" align="left" valign="top"><p>
If you are installing servers at multiple sites
within your organization, you may find it useful for later troubleshooting
to use different network addresses for each site. Additionally, if you ever
want to establish an IPSEC VPN between the servers, each server will need to
use a different range of IP addresses.  Even if you are not planning to use a
VPN right now, it would be safest to use unique network addresses for each
location.
</p></td></tr></table><p>
If, however, you are operating your server in &quot;server-only&quot; mode and there are already
servers on your network, you will need to obtain
an unused IP address for your local network.

</p><p>Next, you will be prompted to enter the subnet mask for your local
network. If you are adding your server to an existing network, you
will need to use the subnet mask used by the local network. Otherwise,
unless you have a specific need for some other setting, you
can accept the default setting.
</p><a name="operationmode"></a>5.9.  Operation Mode<p>
After configuring your
SME Server for your local network, you will
see the following screen. This is where you select your server's operation mode.
</p><img src="images/select_operation_mode.jpg" alt="Selecting operation mode"><a name="id2814564"></a>5.9.1. Option 1: Server and gateway mode<p>
In server and gateway
mode, your server provides services (such as e-mail,
web services, file and print sharing) to your network and also acts as
a gateway between your internal network and the outside world. The fact
that it serves as a &quot;gateway&quot; means it has separate interfaces with each
network, and provides security and routing.
</p><p>
If you configure your
server to operate in server and gateway mode, your
server will require either:
</p><ol type="1"><li><p>
two ethernet adapters (one to communicate
with the local network and the other to communicate with the external
network/Internet)
</p></li><li><p>
one ethernet adapter (for the local network) and a modem for a dialup
connection
</p></li></ol><p>With server and gateway mode, there are a number of extra parameters
that will need to be configured. These will be discussed in the <a href="#configsvrgwy" title="6.10. Configuring Server and Gateway Mode">next section</a>.</p><a name="id2814637"></a>5.9.2. Option 2: Private server and gateway<p>This mode is a variation of option 1 and provides the same functionality
with the following differences:

</p><ul type="disc"><li><p>Your web server is not visible to anyone outside of the local network.
</p></li><li><p>Your mail server is not accessible from outside of the local network.
</p></li><li><p>Additional firewall rules have been configured to drop packets for
various services (such as 'ping' requests).
</p></li></ul><p>All services <i>are</i> available on the internal network.
The differences are entirely in how your server is seen by the external world.
</p><p>You would select this mode only if you wish to use the server as
a gateway, but do not wish to publish any services to the external Internet.
</p><a name="id2814702"></a>5.9.3. Option 3: Server-only mode<p>
Server-only mode is
appropriate if you do not wish to use the gateway capabilities of your
server. In this configuration,
your server connects only to the local network and
does not connect directly to the outside world (although it may connect
indirectly through your firewall or another server).
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2814714"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>Because the server &quot;trusts&quot; the local network
to be secure in server-only mode, it <b>must

</b> be behind a firewall of some type.  Under no conditions should it
be directly connected to the Internet.</p></td></tr></table><p>Your network will resemble the image below:
</p><img src="images/network4.jpg" alt="Server-only mode"><p>
<b>If you have a connection to the Internet</b> by
way of another gateway or corporate firewall,
you can configure your server
to provide services (including e-mail, web services, file and print-sharing)
to your network. In this instance, you do not need your server
to provide the gateway role because that role is fulfilled
by your firewall. If you select Option 3, &quot;<b>Server-only mode - protected network
</b>&quot;,
your server will provide your local network with web,
e-mail, file and print-sharing.
</p><p>
On the next configuration screen, you should enter the IP
address for the Internet gateway on your local network.
If you do not have an Internet connection, simply leave this configuration
screen blank.
</p><a name="configsvrgwy"></a>5.10. Configuring Server and Gateway Mode<p>
If you are configuring
your server to operate in server and gateway mode,
you must select one of two Internet connection types - a <b>dedicated connection </b>
(such as ADSL or cable modem) or a <b>dialup connection</b> (in which case
you will be connecting to your ISP via a modem).


</p><img src="images/select_ext_access_mode.jpg" alt="Selecting external access mode"><p>
The next step after
selecting a connection type is to enter the specific parameters representing that connection.

</p><a name="configexternal"></a>5.11. Server and Gateway Mode - Dedicated<p>
How you configure your server's
external interface depends on whether you are using a dedicated connection
or a dialup connection. Therefore, if you configured your server
for &quot;server and gateway mode - dedicated connection&quot; you
will be presented with very different configuration screens than if you
configured the server for &quot;server and gateway - dialup connection&quot; (as
discussed <a href="#configexternal.dialup" title="6.12. Configuring the Server for Server and Gateway Mode - Dialup Access">in the next section</a>).

</p><a name="configextenet"></a>5.11.1. Configuring Your External Ethernet Adapter<p>
As you did previously with your <a href="#configenetlocal" title="6.8.1. Selecting Your Local Ethernet Adapter">local ethernet
adapter</a>, you need to configure the driver for your external ethernet
adapter. As before, the software will attempt to detect the card. If it
correctly identifies the card, you can proceed using Option 1, &quot;Keep current
driver&quot;. If it does not, you will need to manually select the driver.

</p><img src="images/select_ext_enet_driver.jpg" alt="Selecting external ethernet driver"><a name="id2815019"></a>5.11.2. Assigning Your Ethernet Adapters to Network Connection<p>
To communicate successfully, your server
needs to know which ethernet adapter connects it to the internal
network and which adapter connects it to the external network/Internet.
Your server will make this designation automatically
- the first ethernet adapter (in position &quot;eth0&quot;) will normally be assigned
to the local, internal network and the second ethernet adapter (in position
&quot;eth1&quot;) will normally be assigned to the external network/Internet. In
the event that this assumption is incorrect, this screen allows you to
easily swap that designation.
</p><p>
If you don't know which
ethernet adapter is designated to eth0 and which is designated to eth1,
we suggest you leave it in the default configuration while completing the
rest of the screens. You will later have the opportunity to &quot;Test
Internet Access&quot; from the server console.  If your test fails at that time,
return to this screen, swap the card assignment and retry the test.
</p><img src="images/select_ethernet_card_assignment.jpg" alt="Selecting Ethernet card assignment"><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/tip.gif"></td><a name="id2815098"></a>Tip</tr><tr><td colspan="2" align="left" valign="top"><p>
If you are using two different network interface
cards, you will see which driver is associated with eth0 and which is
associated with eth1. This information can help you determine which
card is eth0 and which is eth1.  If you have two cards that use the identical
driver you will see a screen such as the one above where the actual driver is
not listed.
</p></td></tr></table><a name="configexternal.dedicated"></a>5.11.3. Configuring Your External Interface<p>

With a dedicated connection in server and gateway mode, you will be presented
with the following screen:
</p><img src="images/select_ext_interface_config.jpg" alt="Selecting external interface configuration"><p>
Your server must know three additional things to communicate on the Internet:</p><ul type="disc"><li><p>its own unique IP address so that Internet data packets can reach it.</p></li><li><p>a subnet mask (also called a netmask) which looks like an IP address and
allows other computers to infer your network address from your IP
address.</p></li><li><p>the IP address of the external gateway for your server.
This is the IP address of the router on your server's external network.
It identifies the computer that your server should
contact in order to exchange information with the rest of the
Internet.</p></li></ul><p>
Normally, you would
need to know this information and enter it into the server console. However,
most ISPs are capable of automatically assigning these configuration
parameters to your server using a <i>DHCP
server</i> or <i>PPPoE</i>.
</p><p>
<b>If you have a static IP address and your ISP is configuring your server
using DHCP or PPPoE</b>, select Option 1, 2 or 3 depending upon how
you will be connecting to your ISP. When you first connect to your ISP,
your server will automatically be given its external
interface configuration parameters.
</p><p>

<b>If your ISP is providing
you with a dynamic IP address</b>, the ISP will configure this through
DHCP or PPPoE and your server will be re-configured
automatically
whenever your IP address changes. If you plan to use a Dynamic DNS service,
select Option 2. Otherwise, select Option 1.
</p><p>
There are some very good reasons to use a dynamic DNS
service if you have a dynamically assigned IP address. It is a simple,
affordable way to ensure continuity of service when your IP address changes.
Please read the <a href="#configdyndns" title="6.11.4. Configuring Dynamic DNS">next section on dynamic DNS
</a> for more information about dynamic DNS.
</p><p>
<b>If you are using ADSL and need PPP over Ethernet
</b>, choose Option 3. You will then be asked for the user name and
password you use to connect to your ISP.  Note that some ISPs require you to
enter their domain name as well as your user name.
</p><a name="id2815296"></a><table border="1"><tr><td><p class="title"><b>What is PPPoE?</b></p><p>PPPoE is the <i>Point-to-Point Protocol over Ethernet
</i>. Essentially, it is an implementation of the popular PPP protocol
used for dialup connections - only configured to run over an Ethernet
connection.  Many ISPs that provide ADSL connections use PPPoE as the method
of connecting their customers to the Internet over ADSL.
</p></td></tr></table><p>
<b>If you have a static
IP address and your ISP does not offer DHCP or PPPoE</b>, then your ISP will
give you the static IP address, subnet mask (or netmask), and the gateway
IP address of the device that your server should connect
to in order to communicate with the Internet. Assuming you have this information
on hand, you can go ahead and select Option 4. Successive screens will
prompt you to enter each parameter.

</p><a name="configdyndns"></a>5.11.4. Configuring Dynamic DNS<p>If you choose either of the DHCP options or PPPoE, you will be presented with an additional screen where you can choose which dynamic DNS service you wish to use.  </p><img src="images/select_dyn_dns.jpg" alt="Selecting dynamic DNS"><p>The server is pre-configured to operate with four dynamic DNS
organizations:
<a href="http://www.yi.org/" target="_top">yi.org</a>,
<a href="http://www.dyndns.com/" target="_top">dyndns.com</a>,
<a href="http://www.dyndns.org/" target="_top">dyndns.org</a>, and
<a href="http://www.tzo.com/" target="_top">tzo.com</a>. (You can elect to use a different service, but doing
so would require some customization of the server.) Once the service is
selected, the subsequent two screens will prompt you to enter your account
name and the password for your account. (These two parameters would be
given to you by the service. Note that the dynamic DNS service may place
restrictions on which domain name you can use for your company.)
Please read <a href="#app-dyndns" title="Appendix B. Dynamic DNS Services">Appendix B on dynamic DNS</a> for more information about whether a dynamic DNS is right for you. </p>
<a name="configexternal.dialup"></a>5.12. Configuring the Server for Server and Gateway Mode - Dialup Access<p>

If you select dialup
access, successive screens will ask you for the following information:
</p><ul type="disc"><li><p>
information regarding the modem or ISDN
connection with your ISP, such as the serial port your modem is connected
to
[<a name="id2815498" href="#ftn.id2815498">2</a>]
</p></li><li><p>modem or ISDN initialization screen - most users can simply leave this blank,
but with some particular modems or ISDN cards, additional information may need to be entered
here
</p></li><li><p>
the dialup access phone number
</p></li><li><p>username
</p></li><li><p>password
</p></li><li><p>connection policy
</p></li></ul><p>This last item may be of special interest. As shown in the screen below,
you can configure what type of policy you wish to have in place during typical
work hours.  If you are in a small office and wish to share your phone line
between your computer and phone or fax, you may wish to minimize the time you
are online. This is also true if your ISP charges a fee on a per-minute basis.
On the other hand, if you have a separate phone line or unlimited time with
your ISP, you might want to have long connection times or a continuous
connection.</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2815572"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p> If you are using a dial-on-demand link to your ISP, please be aware that you
can incur very steep phone charges due to dialup connection attempts to the
ISP.  We are aware of at least one case in which a failed modem link at the
ISP resulted in several thousand connection attempts over a couple of days -
and a hefty phone bill.  If your telephone carrier charges you per-call or
per-minute fees, we suggest that you contact your ISP and ask whether it is
willing to assume responsibility if a failure at their end results in a
large phone bill.  </p></td></tr></table><p>After configuring this policy for &quot;work&quot; hours, you can then configure
the policy for time outside of office hours and additionally for the weekend.
Notice that you do have the
choice of <i>never </i>, which would allow you to restrict your
system from connecting on weekends or during off-hours.

</p><img src="images/select_connect_policy.jpg" alt="Selecting connection policy"><p>The connection policy defines several choices
including Short,
Medium or Long. These specify how
long the server should wait before disconnecting the dialup
connection. If your office only shares a single phone line, the
<i>Short</i> option minimizes the amount of connection time and
frees up the phone line for later use.  The down side to this is that if
someone is reading a long page on the web site or steps away from their
computer for a brief moment, when they want to then go to another web page,
the server will probably have disconnected and will need to redial and
connect.  On the other hand, setting the <i>Long</i> connection
time will result in users experiencing fewer delays while waiting for the
server to reconnect. However, the phone line will used for a larger amount of
time.
</p><p>There are two separate timeout values configured by each choice. One
value is the length of time since the last HTTP (web) packet went through the
server. The other is a more general timeout for any other types of packets.
The difference is there because it is assumed that people reading a web page
may take longer to go on to another web page, whereas users connecting to
another service (such as ssh or POP3 to an external server) probably will be
more active than someone using a web browser.  The timeout values are shown in
the table below.
</p><table border="1"><tr>
Choice


HTTP Timeout

Other Timeout
</tr><tr><td>
Short
</td><td>
3 minutes
</td><td>
30 seconds
</td></tr><tr><td>
Medium
</td><td>
10 minutes
</td><td>
5 minutes
</td></tr><tr><td>

Long
</td><td>
20 minutes
</td><td>
10 minutes
</td></tr></table><p>Note that there is also the option for a
Continuous dial-up connection. Choosing this option is
basically equivalent to creating a permanent or dedicated connection, but
only doing so through the use of a dial-up connection and a modem or ISDN
adapter.
One example of this use might be to set a Continuous
connection policy during work hours and then some variable policy during
off-hours and the weekend.  Assuming that your ISP is okay with this
arrangement and you can afford to do so financially, these settings would give
your users the fastest response time as the connection would always be online.
</p><a name="configdhcpsvr"></a>5.13. Configuring Your DHCP Server<p>
You now will be prompted regarding DHCP service.
Your SME Server can be configured to <b>provide</b> DHCP service
to your internal
network. The DHCP server can automatically configure the other computers
on your internal network with such parameters as non-routable IP address,
subnet mask and gateway IP address. This reduces the risk of error and
simplifies the process of configuring your network.

</p><p>
We recommend configuring your server to use DHCP to
configure all of your network clients.  You should <i>not</i> do
this if there is an existing DHCP server on your network as there should
typically be only one DHCP server per network.
</p><img src="images/select_dhcp_server_config.jpg" alt="Selecting DHCP server configuration"><a name="configdhcprange"></a>5.13.1. Configuring the DHCP Address Range<p>
Before the DHCP server
is able to assign IP addresses to the computers on your network, you need
to tell it what range of IP addresses it can safely distribute. <b>As above,
this section is pre-configured with defaults that are appropriate in most
situations. If you have fewer than 180 machines on your local network and
no reason to prefer one range of IP addresses over another, you can simply
accept the defaults for these screens.</b>

</p><p> If the defaults are not appropriate
to your situation, you may need a bit of background to understand how to
configure this range. For example, if you entered the server address
of 192.168.1.1 and subnet mask of 255.255.255.0 (the
default settings), the configuration script will infer that your &quot;network&quot; is
192.168.1.0 and that valid addresses are from 192.168.1.1 to 192.168.1.254.
If you entered some number such as
192.168.100.1 for the server, the script will infer that your valid addresses
will be 192.168.100.1 through 192.168.100.254.
</p><p>

If you enter the number &quot;<b>192.168.202.65</b>&quot; as the &quot;beginning of DHCP address
range&quot;, as shown below, the first computer served by the DHCP server would receive the IP
address of 192.168.202.65. The second computer would receive the IP address
of 192.168.1.<b>66</b>, and so on.
</p><img src="images/select_dhcp_range_start.jpg" alt="Selecting start of DHCP range"><p>
If you specify that the end of
the range is &quot;<b>192.168.202.250</b>&quot;, as shown below, then the last
computer able to receive
DHCP service would be assigned the IP address 192.168.202.250. Once all the
available IP addresses within that range are assigned, your DHCP server
will no longer serve IP addresses to new computers.
</p><img src="images/select_dhcp_range_end.jpg" alt="Selecting end of DHCP range"><a name="id2816095"></a>5.13.2. Important issues about the DHCP address range<p>
<b>The usual range maximum
is 254:</b> Normally the &quot;end of DHCP address range&quot; cannot exceed &quot;254&quot;.
If you have more than 253 computers on your network and would like to exceed
this range maximum, you can use a Class B or Class A non-routable address
for your network. In this case the number entered in the &quot;end of range&quot;

field needs to be calculated and entered a little differently. Note that the default range maximum is 250. As explained
below, this is to allow a few static addresses at the end of the range.

</p><p>
<b>The local IP address
assigned to your server itself must fall outside of
this range:</b> In other words, you should not assign your server
a non-routable IP address that is also assignable by the DHCP
service to another computer on your network. If your server
 is assigned the IP address of &quot;192.168.1.1&quot; then the lowest possible
number in the DHCP range should be &quot;2&quot;.
</p><p>
<b>We recommend that
you leave a small pool of IP addresses that can be manually
assigned:</b> Some
of the computers (or devices such as network printers) on your network
may not be able to accept DHCP service. Therefore,
it is preferable to exclude some IP addresses from the DHCP range so they
are available to be assigned manually to those computers. For example,
using the 192.168.1.0 block of addresses, the default &quot;beginning of DHCP
address range&quot; is &quot;192.168.1.65&quot;. This ensures that
non-routable IP addresses &quot;192.168.1.<b>2</b>&quot;

through &quot;192.168.1.<b>64</b>&quot;
are available to you if any computers on your network cannot accept DHCP
service. Additionally, the default end of &quot;192.168.1.250&quot; leaves addresses
&quot;192.168.1.<b>251</b>&quot;
through &quot;192.168.1.<b>254</b>&quot; available.
</p><a name="configmisc"></a>5.14.  Further Miscellaneous Parameters<p>

There are a few, final
connectivity-related parameters that must be entered into your SME Server.
</p><p>
<b>Master DNS server: </b>The first option is
for a master (or primary) DNS server. You should only configure this value if
your server is behind a firewall and cannot perform direct queries to
Internet DNS servers. Most installations should leave this setting blank. You
<b>do not</b> need to configure your server to use your ISP's DNS servers.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2816245"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Your SME Server contains a fully functional caching DNS
server and in almost all cases you will <i>not </i> need to
enter the address here for a DNS server.  However, some corporate firewalls
restrict DNS queries from internal DNS servers. If that is the case, you
will need to supply the address for an external DNS server.
</p></td></tr></table><p>
<b>External proxy server: </b>
The next screen allows you to configure
your server so that the computers on your network will use
a proxy server <i>outside of your own network </i>. Some
Internet Service Providers may require this.  Additionally, if your server
is behind another firewall, it may need to use the external proxy
server. If
you have questions about whether to use a proxy server,
we recommend you read <a href="#app-proxysrv" title="Appendix C. Proxy Servers">Appendix C on using
a proxy server</a>. In most environments you can probably leave this blank.

</p><p>
<b>Status reporting:</b> You will be asked
to decide whether to enable status reporting to Contribs.org. Through status
reporting, Contribs.org, tracks the performance of its servers worldwide. Every
day, your server would send a small packet of data
containing up-time information to Contribs.org. The information sent to Contribs.org
is minimal and is not shared with any other organization.
</p><p>
<b>Console mode:</b> Next, as shown below, you select
the security setting for the server console itself - in other words, whether
users will require a password to access the server console. If you choose the
default, &quot;auto&quot;, the server console will be displayed on your server
monitor.  In many small office or home office situations, this is
perfectly acceptable.  However, doing so allows anyone with physical access to your
server monitor and keyboard to make system-wide changes.  If you are concerned
about security in your situation, you may wish to choose &quot;login.&quot; This
setting prevents users from accessing the server console unless they login as
&quot;admin&quot; with the system password you set earlier in the process. Note
that this setting controls access to the server console only; it does not
control whether you (or anyone
else) can administer your server using the web interface.
</p><img src="images/select_console_mode.jpg" alt="Selecting server console mode"><p>

<b>Contact e-mail address:</b>
Finally, you will have the option of providing a contact e-mail address
and name. If you would like to be notified of security updates or new versions
of software,
we strongly encourage you to provide at least your e-mail
address.  As the screen indicates, we will <i>only </i> send you
notices of updates and no other information. Your contact information will not
be shared.
</p><p>
The last screen asks you to confirm the
changes you have made. After the changes take effect, you will see other services starting up. When that is
finished, your server should be fully operational!
</p><p>
Congratulations -
you have configured your SME Server!!
</p><p>
Afterward you may want to test your Internet access using the test option in the server console.
If you chose &quot;auto&quot; earlier, the server console remains permanently &quot;up&quot; on your
server. Otherwise you would need to login as &quot;admin&quot;.
Most routine administration (for example, adding or deleting e-mail addresses) is
done from your desktop computer using the web-based server manager (reviewed in
a later chapter). Therefore, once it is up and running, most users
put their server in an out-of-the-way place and turn
off the monitor.

</p><br><hr width="100" align="left"><p>[<a name="ftn.id2815498" href="#id2815498">2</a>] 
Your modem documentation may indicate which serial port is used by the
modem. You may also be able to visually identify which port your modem
uses. </p><a name="serverconsole"></a>Chapter 6. The Server Console<p><b>Table of Contents</b></p>6.1. <a href="#console-textbrowsing">Using the Text-based Browser</a>6.2. <a href="#console-rootprompt">Accessing the Linux Root Prompt</a><p>
When installation is
complete and if you set server console mode to &quot;auto&quot;, the opening
screen of the SME Server server console will appear:
</p><img src="images/console.jpg" alt="The server console"><p>If you set the server console mode to &quot;login&quot;, you will be given a login
prompt. After you enter the user name &quot;admin&quot; and your system password, you
will see the server console screen above.

</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2814226"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>
<i>Any</i> time that you login to your system as the &quot;admin&quot;
user you will see the server console.  This is true even when connecting to the
server remotely using a tool such as <i>ssh</i>
(discussed later in the chapter on Remote Access).
</p></td></tr></table><p>
The server console
provides you with basic, direct access to your server.
From the server console you can get the following information and perform the
following tasks:
</p><p>
<b>Option 1:</b> Provides
you with uptime information about your server.

</p><p>
<b>Option 2:</b> Allows you to view and modify
the configuration information you entered during the original installation
(ethernet cards, IP address information, DHCP, DNS, domain names, etc.)
</p><p>
<b>Option 3:</b> Provides
you with a summary of the configuration parameters entered into your server.
</p><p>
<b>Option 4:</b> Allows
you to test your Internet access by sending a small test packet of information
to a server on the Internet (located at Contribs.org) which will confirm
that your server is communicating on the Internet.
</p><p>
<b>Option 5:</b> Allows
you to smoothly reboot or shut down your server.
</p><p>

<b>Option 6:</b> Provides you with a means to
access the web-based server manager using a text-based browser. This is the
same interface to which you can connect from another system using a normal
graphical browser. This option merely allows you to perform these functions
directly from the server console.
</p><p>
<b>Option 7:</b> Connects to <a href="http://wiki.contribs.org/" target="_top">http://wiki.contribs.org/</a>
to allow you to read the online version of this user guide.
</p><p>
<b>Option 8:</b> Displays
the GNU General Public License (the license governing the distribution and
use of SME Server software) and information on how to contact Contribs.org for
support.
</p><a name="console-textbrowsing"></a>6.1. Using the Text-based Browser<p>
For Option 6, <i>Access server manager with text-mode browser</i>,
the server uses a text-based browser called

<i>lynx</i> to allow you to access the web-based server manager from the
server console. Navigation is primarily with the arrow keys - up and down to move
through the page, right arrow to follow a link, left arrow to go back. Lynx
has a wide range of other commands which you can learn about through the
online help available at <a href="http://www.lynx.browser.org/" target="_top">
http://www.lynx.browser.org/</a> Note that for security reasons some
regular features of lynx are
<i>disabled</i> when you are browsing from the server console (such as
the ability to specify an external URL). Type 'q' (for 'quit') to exit the
text-based browser.</p><a name="console-rootprompt"></a>6.2. Accessing the Linux Root Prompt<p>
If you are an expert user and would like to do advanced
modifications to the configuration of your server,
you can access the Linux operating system underlying the SME Server software
by logging in as the user &quot;root&quot;. If your server
is displaying the server console and not a login prompt, you can
press Alt-F2 to switch to another screen with a login prompt. To
switch back, press Alt-F1. You should always ensure that you log out from
the root account when you are finished and before you switch back to the
server console.
</p><p>
The password for the &quot;root&quot; user is whatever password is currently set for
the administrator of the server. Note that this is the

<i>same</i> password as that used by the &quot;admin&quot; user account.
</p><p>Be aware that this ability to switch between the server console and a login
prompt is only available when you have physical access to the server.
If you connect in remotely as the &quot;admin&quot; user and see the
server console, you will <i>not</i> be able to switch to a
login prompt in that window.  (You can, however, open up another remote
connection to your server and login as the &quot;root&quot; user.) Note that remote
administrative access is <i>disabled</i> by default and must be
specifically enabled through the <a href="#admin-remoteaccess" title="10.2. Remote Access">Remote
Access</a> panel of the server manager.

</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2816625"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>If you are not familiar with working from the Linux prompt, you may be
interested in trying a file management tool called Midnight Commander. It
allows you to perform many file operations through a menu-driven interface. Simply
type mc at the command prompt. Press the function key &quot;F1&quot;
for help and &quot;F10&quot; to quit.</p></td></tr></table><a name="configclients"></a>Chapter 7. Configuring the Computers on Your Network<p><b>Table of Contents</b></p>7.1. <a href="#configclientorder"> What Order to do Things</a>7.2. <a href="#configclientos">Configuring Your Desktop Operating System</a>7.2.1. <a href="#id2746386">Automatic DHCP Service</a>7.2.2. <a href="#id2750524">Manual entry for computers not using DHCP service</a>7.2.3. <a href="#id2817328">MS Windows workgroup configuration</a>7.3. <a href="#imappop3"> IMAP versus POP3 e-mail</a>7.4. <a href="#configemailapp">Configuring Your E-mail Application</a>7.5. <a href="#configbrowser">Configuring Your Web Browser</a>7.6. <a href="#configdirectory">Configuring Your Company Directory</a><a name="configclientorder"></a>7.1.  What Order to do Things<p>

For efficiency, we recommend
you configure your desktop computers in the following order:
</p><p>
<b>Step 1:</b> First,
configure one of your desktop computers to work with TCP/IP (using the
information in this chapter).
</p><p>
<b>Step 2:</b> With
TCP/IP up and running on one of your computers, you can now access the
server manager over the web and create your employees' user accounts.
The next chapter, <a href="#admin" title="Chapter 8. On-going Administration Using the server manager">On-going Administration
Using the server manager</a>,
explains this simple process.
</p><p>
<b>Step 3:</b> Once
e-mail accounts are created, you can ensure that all the computers on your
network are configured for TCP/IP, e-mail, web browsing and LDAP (using
the information in this chapter).
</p><p>
This chapter helps
you configure software and hardware supplied by other companies and for
that reason is not as specific as the rest of this guide. Given the wide
range of computers, operating systems and software applications, we cannot
accurately explain the process of configuring each of them. If your computers
and applications came with manuals, they might be useful supplements to
this chapter. Technical problems encountered in networking your desktop
computers and applications are best resolved with the vendors who support
them for you.

</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/important.gif"></td><a name="id2816579"></a>Important</tr><tr><td colspan="2" align="left" valign="top"><p>This chapter demonstrates only <i>one</i> of the many
possible ways to configure your client computers and is provided here as
an example.
</p></td></tr></table><a name="configclientos"></a>7.2. Configuring Your Desktop Operating System<p>
The dialog box where
you configure your desktop differs from operating system to operating system
and version to version. As an example, in Microsoft Windows 95 or 98,
client configuration occurs
in the &quot;Properties&quot; dialog box associated with the TCP/IP protocol for
your ethernet adapter. To get there, go to the &quot;Control Panel&quot; and select
&quot;Network&quot;. If a TCP/IP protocol is not yet associated with your ethernet
adapter, you may need to add one before you can configure its properties
with the following information.
</p><table border="1"><tr>

Item

Description

What to enter
</tr><tr><td>
enable TCP/IP protocol
</td><td><p>
All your computers
must communicate on the network using the TCP/IP protocol.
</p></td><td><p>
In Windows you add
a TCP/IP protocol. In Apple, open TCP/IP Control Panel.
</p></td></tr><tr><td>
disable non-TCP/IP
protocols
</td><td>
Unless an application
relies on a non- TCP/IP protocol, disable all other protocols.
</td><td>
Turn &quot;off&quot; other networking
protocols (e.g. NetBeui, etc.)

</td></tr><tr><td>
enable DHCP service
</td><td>
See section below
</td><td>
In Windows, enable
&quot;Obtain an IP address service automatically&quot;. In Apple, select &quot;DHCP server&quot;.
</td></tr></table><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2746294"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>We <b>strongly</b> recommend that you
configure all clients machines using DHCP rather than manually using static
IP addresses. Should you ever need to change network settings or
troubleshoot your network later, you
will find it much easier to work in an environment where addresses are
automatically assigned.</p></td></tr></table><p>On a Windows 95/98 system, the window will look like the image below.
</p><img src="images/tcp_ip_properties_ip_auto.jpg" alt="Windows 95/98 TCP/IP properties window"><a name="id2746386"></a>7.2.1. Automatic DHCP Service<p>

Your server provides a DHCP server that assigns each of the computers on
your network an IP address, subnet mask, gateway IP address and DNS IP
address(es). For a more detailed explanation of DHCP, consult the section in the
Chapter 5 called &quot;<a href="#configdhcpsvr" title="5.13. Configuring Your DHCP Server">Configuring Your DHCP Server</a>&quot;.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2746359"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>In some rare cases, you may want to use a static IP address for
a particular client machine. The typical approach is to manually enter
this IP address into the network properties of the specific machine.
The negative side of this approach is that you cannot easily change or alter
network settings without having to go in and modify the information
on the client machine.
However, it <i>is</i> possible to provide this static IP address
directly through DHCP rather than manually configuring the client computer. To
do so, you will first need to determine the Ethernet address of the client
computer (usually through the network properties). Next you will go to the
<a href="#admin-hostnames" title="11.5. Hostnames and addresses">Hostnames and addresses</a> web panel of the
server manager and enter the information there.
</p></td></tr></table><a name="id2750511"></a><table border="1"><tr><td><p class="title"><b>Only One DHCP Server</b></p><p>
It is imperative
that no other DHCP server is on your network. If a former DHCP server configured
your computers, you should remove that DHCP server from your network.
Leave DHCP enabled, and reboot each computer. New IP addresses, netmasks,
gateway IP addresses and DNS addresses will be assigned automatically by
the server DHCP server.
</p></td></tr></table><a name="id2750524"></a>7.2.2. Manual entry for computers not using DHCP service<p>
As noted above, we strongly recommend that you perform all your client
configuration using DHCP.  It is even possible to assign a static IP
address through the <a href="#admin-hostnames" title="11.5. Hostnames and addresses">Hostnames and addresses</a>

web panel of the server manager that will be distributed through your
DHCP server.
</p><p>However, if your computers do
not support DHCP, you must manually enter the following information into your
TCP/IP properties:
</p><table border="1"><tr>
Item

Description

What to enter
</tr><tr><td>
IP address
</td><td>
Manually enter this information (see paragraph below).
</td><td>
You must assign a
different, unique IP address to computers not accepting DHCP (see note
below).
</td></tr><tr><td>
subnet mask (or netmask)
</td><td>

Manually enter this number.
</td><td>
The default subnet
mask (or netmask) is &quot;255.255.255.0&quot;.
</td></tr><tr><td>
gateway IP address
</td><td>
Enter the IP address for the server
or, in the case of server-only mode, enter the IP address for your
network's gateway (e.g. the firewall or network router).
</td><td>
If you are running
in server and gateway mode, your server is your local network's
gateway. Enter its IP address here: the default is &quot;192.168.1.1&quot;. If you
are running in server-only mode, enter the IP address for the device interfacing
with your external network.
</td></tr><tr><td>
IP addresses of your
domain name servers
</td><td>
Manually enter this information.

</td><td>
Normally you would just add the IP
address for your server - the default used in the server console
is &quot;192.168.1.1&quot;. If you have a firewall other than your server that
restricts internal queries to Internet DNS servers, you may need to enter
additional DNS servers here.
</td></tr></table><p>
It is critical that
every computer on your network has a unique IP address and that you don't
assign two computers the same address. In enabling DHCP service in the
server console, you designated a range of IP addresses for DHCP assignment.
You also allocated a block of IP addresses for manual assignment. If you
accepted the defaults pre-configured into the server console, IP addresses 192.168.1.2
through 192.168.1.64 will have been set aside for manual entry. To avoid duplication, use only those IP addresses when manually
assigning IP addresses to your computers.
</p><img src="images/tcp_ip_properties_ip_select.jpg" alt="Windows 95/98 TCP/IP Properties - selecting the IP protocol"><p>
After configuring the
TCP/IP parameters, you may need to reboot your desktop computer to implement the configuration changes. (For example, most Windows systems need to be rebooted after the
TCP/IP configuration has been changed.) Once the settings take effect, your computer will be connected to the server and to the Internet.
</p><a name="id2817328"></a>7.2.3. MS Windows workgroup configuration<p>
If you are using a Microsoft
operating system, you must ensure that your workgroup is the same as the
workgroup name of your server. (The default workgroup name is your domain name.
In a subsequent chapter, we'll explain how this can be changed using the
web-based server manager.) If you are using the default name, go to the
Control Panel, select &quot;Network&quot; and then
select &quot;Identification&quot;. In the field for &quot;Workgroup&quot;, type your domain name.

</p><a name="domainnames"></a><table border="1"><tr><td><p class="title"><b>A word about domain names</b></p><p>
Once you've set up your
server, there's typically a delay of one or more days
before your ISP publishes your domain address records (the domain name
or names and the associated numerical IP address) so that the information is accessible to other computers on
the Internet. Until it does, incoming mail won't be able to find you and
computers elsewhere on the Internet won't be able to contact your server
using your domain name (for example, www.yourdomain.xxx). However, on your
local network you should be able to connect to your server using the short
names of 'www' (for web access) and 'mail' (for e-mail clients).
</p></td></tr></table><a name="imappop3"></a>7.3.  IMAP versus POP3 e-mail<p>
There are two common
standards for e-mail management, IMAP and POP3. Your server supports both protocols.
You will need to select the protocol that
is right for your organization.
</p><p>
POP3 is the earlier,
better-known e-mail protocol. POP3 was designed to permit on-demand retrieval
to a single client machine. E-mail is stored on the mail server until you
retrieve it, at which time it is transferred over the network to your desktop
machine and stored in your e-mail box there.
</p><table border="1"><tr>
Benefits of POP3

Drawbacks of POP3
</tr><tr><td>
Even when you are
not connected to your network, you have access to the e-mail stored on your
desktop.
</td><td>
POP3 was not originally
intended to support users accessing and managing their e-mail from remote
systems. Because your e-mail is stored on your desktop, setting up remote
access of your e-mail when you are at a different computer can be complex.
</td></tr></table><p>

IMAP e-mail, in contrast,
is designed to permit interactive access to multiple mailboxes from multiple
client machines. You manage your e-mail on the mail server over the network.
You read your e-mail over the network from your desktop, but the e-mail is
not stored on your desktop machine - rather, it is permanently stored and
managed on the server.
</p><table border="1"><tr>
Benefits of IMAP

Drawbacks of IMAP
</tr><tr><td><p>You can access all
of your new and stored e-mail from any machine connected to a network.
</p><p>Because all employee
e-mail is stored on the server, backup of e-mail is easily accomplished.
</p></td><td><p>If you are not connected
to a network, new and stored e-mail
messages are not available
to you.
</p><p>
</p></td></tr></table><a name="configemailapp"></a>7.4. Configuring Your E-mail Application<p>
Each user's e-mail application
requires information about that user's account, where to send outgoing
e-mail and pick up incoming e-mail. This information is usually entered in
the &quot;preferences&quot; or &quot;options&quot; section. Most e-mail applications require
you to enter the following information:

</p><p>
<b>User's e-mail address:</b>
The user's e-mail address is the user account as created in the server manager
plus the @domain name. Typically it will be in the form of <i>username@yourdomain.xxx</i>
(e.g. afripp@tofu-dog.com).
</p><p>
<b>E-mail server or
outgoing e-mail SMTP server:</b> This is the name of the e-mail server from
the server. Normally you should just enter <b>mail</b>
here. If you prefer, you should also be able to use the full domain name of
<i>mail.yourdomain.xxx</i> (e.g. mail.tofu-dog.com).

</p><p>
<b>E-mail account name
or user name:</b> this is the name before the @ in the e-mail address. For
example, the username for &quot;afripp@tofu-dog.com&quot; is
&quot;<i>afripp</i>&quot;.
</p><p>
If you choose POP3 e-mail service:
</p><p>
<b>Enable POP3 protocol:</b>
Typically,
to enable the POP3 protocol for incoming e-mail, you click on the POP3 checkbox
or select POP3 from a pull-down menu in the section of your e-mail application
dedicated to the incoming e-mail server.
</p><p>
<b>Disable IMAP protocol:</b>

To
disable the IMAP protocol for outgoing mail (not all e-mail applications
have IMAP protocol) click the IMAP checkbox &quot;off&quot;.
</p><p>
<b>Delete read e-mail
from server:</b> We recommend you configure your e-mail application so e-mail
that has been read is not left on the server. To do this, click off the
checkbox marked &quot;leave mail on server&quot; or click on the checkbox marked
&quot;delete mail from server&quot;.
</p><p>
If
you select IMAP e-mail:
</p><p>
<b>Enable IMAP protocol:</b>

Typically, to enable the IMAP protocol for incoming e-mail (note that
not all e-mail applications offer IMAP support) you click on the IMAP checkbox
or select IMAP from a pull down menu in the section of your e-mail application
dedicated to the incoming e-mail server.
</p><p>
<b>Disable POP3 protocol:</b>
To disable the POP3 protocol for outgoing mail, click the POP3 checkbox
&quot;off&quot;.
</p><p>The images below show you the sequence in Netscape. First you choose
<i>Preferences</i> from the <i>Edit</i> menu and
click on <i>Mail Servers</i> as shown in:</p><img src="images/netscape_prefs_mail.jpg" alt="Netscape Preferences - mail"><p>If you have not configured a mail server yet, you will need to press the

<i>Add...</i> button and enter information about your server.
Otherwise, you will select the default mail server listed and click on the the
<i>Edit...</i> button. This will bring up a screen where you
enter the user name and choose whether you are using IMAP or POP3:
</p><img src="images/netscape_prefs_mail_general_imap.jpg" alt="Netscape Preferences - IMAP"><p>Netscape should now be ready to send and receive e-mail.
</p><a name="configbrowser"></a>7.5. Configuring Your Web Browser<p>
Most browsers are
configured using a dialog box called &quot;preferences&quot;, &quot;network preferences&quot;
or &quot;options&quot;. Some browsers need to be configured to access the Internet
either directly or via a proxy server. When required, most desktop applications,
your web browser included, should be configured as though they were directly
accessing the Internet. Although the server uses a security feature known as IP
masquerading, thereby creating an indirect connection to the Internet, this is a
transparent operation to most of your desktop applications.
Hence, you should ensure that the &quot;Direct connection
to the Internet&quot; check box is clicked &quot;on&quot; in your web browser.

</p><p>
Under certain circumstances,
using a proxy server can improve the perceived performance of your network.
The server includes HTTP, FTP and Gopher proxy servers.
Normally, we recommend these be disabled in your browser.


</p><p>
If you decided that you <i>do </i>want to use proxy servers
[<a name="id2817886" href="#ftn.id2817886">3</a>], you will need to enter the IP address or domain name
of the proxy server (i.e. your server) into the
configuration screens of your web browser. The port number you will need to
enter to connect to the proxy server is 3128.
This information is the same for HTTP, Gopher and FTP proxying.
</p><p>The image below shows how a proxy server would be configured
in Netscape Navigator.</p><img src="images/netscape_prefs_proxy.jpg" alt="Netscape Preferences - proxy server"><a name="configdirectory"></a>7.6. Configuring Your Company Directory<p>
Your SME Server will automatically create a company directory and update it
as you maintain your e-mail accounts. The next chapter explains how to configure
this service. Any client program that uses LDAP (Lightweight Directory
Access Protocol), such as the address book in Netscape Communicator, will
be able to access the directory. For example, with Netscape, look under
the &quot;Communicator&quot; menu and choose &quot;Address Book&quot;. Then look under the
File menu and select &quot;New Directory&quot;. You will see a dialog box similar
to the one shown here.

</p><img src="images/netscape_prefs_directory.jpg" alt="Netscape Preferences - directory"><p>
You will need to enter the following information:
</p><ul type="disc"><li><p>
Enter the name you wish to give your company directory - any name will
do.
</p></li><li><p>
The LDAP server is the name of your web server, in the form www.yourdomain.xxx.
</p></li><li><p>
The Server Root information can be found on the &quot;Directory&quot; screen in your
server manager (more information on this is available in the next chapter).
The usual form, assuming your domain is yourdomain.xxx, is <i>
dc=yourdomain,dc=xxx</i>.
(No spaces should be entered between the &quot;dc=&quot; statements.)

</p></li><li><p>
The Port Number is always 389.
</p></li></ul><p>
Once the address book
has been created, Netscape can display a list of all e-mail accounts if
you type an asterisk into the search field and press &quot;Enter&quot;.
</p><br><hr width="100" align="left"><p>[<a name="ftn.id2817886" href="#id2817886">3</a>] 
Note
that laptop users should disable proxy servers when working away from their
local area networks.
</p><a name="admin"></a>Chapter 8. On-going Administration Using the server manager<p>
The server manager
is a simple control panel that allows you to administer your network. Using
the server manager, you perform such tasks as adding or deleting e-mail addresses,
setting the system date and time, and creating a starter web page. The server manager
is accessed through a web browser by visiting the URL
<b>http://www.yourdomain.xxx/server-manager</b> or
more simply

<b>http://www/server-manager</b>.
The staff at The Pagan Vegan would access the server manager using the
URL <b>http://www.tofu-dog.com/server-manager</b>.
We recommend you bookmark
this address so that you can return to it whenever you wish to access the
server manager.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2746121"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>For security reasons, you are only able to access the server manager through a web
browser <i>on the local network</i>. Remote access is only
possible using remote access tools such as ssh and PPTP.</p></td></tr></table><img src="images/manager.jpg" alt="server manager"><p>
When you arrive at the
correct URL, you'll be asked to enter your user name (which is always &quot;admin&quot;)
and the password you created during the installation process.
Enter that
information and click &quot;OK&quot; to be taken to the server manager. It
will look like the screen shown above.
</p><p>
In the next four
chapters, we'll explain each of the administrative functions in the order
in which they appear in the frame running down the left side of the screen.
The links are grouped together under four headings: Security, Configuration,
Collaboration and Miscellaneous.

</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2818160"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>As even one further layer of security, you can also connect to the server manager
using the secure HTTPS protocol .  This establishes an encrypted channel of
communication between  your browser and the server, even on your local
network. To connect to the server manager in this manner, use a URL prefix of &quot;https&quot; as
in the example:
<b>https://www.yourdomain.xxx/server-manager</b>.
</p></td></tr></table><a name="security"></a>Chapter 9. Security<p><b>Table of Contents</b></p>9.1. <a href="#password">Password</a>9.2. <a href="#admin-remoteaccess">Remote Access</a>9.2.1. <a href="#ssh">ssh</a>9.2.2. <a href="#pptp">PPTP</a>9.2.3. <a href="#id2818859">FTP</a>9.2.4. <a href="#telnet">telnet</a>9.3. <a href="#admin-localnetworks"> Local networks</a><a name="password"></a>9.1. Password<p>

This screen lets you
change your system password at any time. To do so, type the new password
in the first field. Verify the new password by entering it in the
second field. (Your password can be any combination of printable
characters, including upper- and lower-case letters, numbers, and
punctuation marks.)
If you
make a mistake, click the &quot;Back&quot; button on your browser and try again.
Note that whenever you change your password, the system will prompt you
for the revised password as soon as you access another feature. When you
get the &quot;Authorization Failed&quot; message, click OK, enter the new password
and press &quot;Enter&quot;.
</p><img src="images/change_system_password.jpg" alt="System password web panel"><a name="admin-remoteaccess"></a>9.2. Remote Access<p>
If you're an advanced
user, the SME Server provides several different ways to access
the underlying operating system, either from a computer on your internal
network or from a computer outside your site on the Internet. Additionally,
you have the ability to access your computer network securely from a remote
computer.  All of these operations are configured from the screen shown
below in the server manager.
</p><img src="images/change_remote_access_settings1.jpg" alt="Remote Access web panel"><br><img src="images/change_remote_access_settings2.jpg" alt="Remote Access web panel"><p>Each of these remote access methods is described below.</p><a name="ssh"></a>9.2.1. ssh<p>
If you need to connect directly to your server and login from a remote system belonging to you,
we <i>strongly</i> encourage you to use ssh
instead of telnet.  In addition to UNIX and Linux systems, ssh client software
is now also available for Windows and Macintosh systems. (See the section
below.)

</p><p>
<b>If you do not have any reason to allow remote
access</b>, we suggest you set this to <b>No access</b>.
</p><a name="id2818334"></a><table border="1"><tr><td><p class="title"><b>ssh (secure shell)</b></p><p>
ssh (secure shell) provides a secure, encrypted way to login to a
remote machine across a network or to copy files from a local
machine to a server.  Many people do not realize that many programs
such as telnet and ftp transmit your password in plain, unencrypted
text across your network or the Internet.  <i>ssh</i>
and its companion program <i>scp</i> provide a secure
way to login or copy files. The ssh protocol was originally invented by SSH
Communications Security which sells commercial ssh servers, clients, and other
related products. The protocol itself has two versions - SSH1 and SSH2 - both
of which are supported by most clients and servers today. For more information
about SSH Communications Security and its commercial products, visit <a href="http://www.ssh.com/" target="_top">http://www.ssh.com/</a>.

</p><p>

OpenSSH, included with the SME Server, is a free version
of the ssh tools and protocol.  The server
provides the ssh client programs as well as an ssh server
daemon and supports both the SSH1 and SSH2 protocols. For more information
about OpenSSH, visit <a href="http://www.openssh.com/" target="_top">
http://www.openssh.com/</a>.
</p></td></tr></table><p>Once ssh is enabled, you should be able to connect to your server simply by launching
the ssh client on your remote system and ensuring that it is pointed to the external domain name or
IP address for your server. In the default configuration, you should
next be
prompted for your user name.  After you enter <i>admin </i>and your
administrative password, you will be in the <a href="#serverconsole" title="Chapter 7. The Server Console">server console</a>. From here you can change the
server configuration, access the server manager through a text browser or perform
other server console tasks.
</p><p>If you do enable ssh access, you have two additional configuration options:
</p><ul type="disc"><li><p><b>Allow administrative command line access over
ssh</b> - This allows someone to connect to your server and login as
&quot;root&quot; with the administrative password. The user would then have full access
to the underlying operating system. This can be useful if someone is providing remote support for your system, but in most cases we recommend setting this to
<i>No</i>.

</p></li><li><p><b>Allow ssh using standard passwords</b> -
If you choose <i>Yes </i> (the default), users will be able to connect to the server
using a standard user name and password. This may be a concern from a security point of view, in that someone wishing to
break into your system could connect to your ssh server and repeatedly enter
user names and passwords in an attempt to find a valid combination. A more
secure way to allow ssh access is called <i>RSA Authentication
</i> and involves the copying of an ssh key from the client to the
server. This method is supported by your server, but is
beyond the scope of this user guide and will eventually
be covered by additional documentation on the contribs.org web site.
</p></li></ul><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2818623"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>
By default, only two user names can be used to login remotely to the server:
<i>admin </i>(to access the server console) and <i>
root </i>(to use the Linux shell). Regular users are

<b>not</b>
permitted to login to the server itself.  If you give another user the
ability to login remotely to the server, you will need to access the
underlying Linux operating system and manually change the user's shell
in /etc/passwd.

</p></td></tr></table><a name="id2818654"></a>9.2.1.1. ssh clients for Windows and Macintosh systems<p>
A number of different free software programs provide ssh clients for use
in a Windows or Macintosh environment. Several are extensions of existing
telnet programs that include ssh functionality.  Two different lists of known clients
can be found online at
<a href="http://www.openssh.com/windows.html" target="_top">
http://www.openssh.com/windows.html</a> and <a href="http://www.freessh.org/" target="_top">http://www.freessh.org/</a>.

</p><p>A commercial ssh client is available from SSH Communications Security
at:
<a href="http://www.ssh.com/products/ssh/download.html" target="_top">
http://www.ssh.com/products/ssh/download.html</a>. Note that the client is
free for evaluation, academic and certain non-commercial uses.
</p><a name="pptp"></a>9.2.2. PPTP<p>The <i>Point-to-Point Tunnelling Protocol (PPTP)

</i> is used to create client-to-server Virtual Private Networks (VPNs) and was
developed by the PPTP Forum, an industry group which included Microsoft and
several other companies. A VPN is a private network of computers
that uses the public Internet to connect some nodes.  PPTP allows users to
connect to their corporate networks across the Internet.
</p><p>Microsoft's PPTP implementation is widely used in the Windows world to provide remote access
across the Internet.  If you have a remote Windows system (for instance, a
laptop or a home computer) that has access to the Internet,
you can also access the information stored on your server.</p><p>If you wish to enable VPN access, you must decide how many individual PPTP clients you will
allow to connect to your server simultaneously, and enter that number here. The simplest method is to enter the total number of
remote PPTP clients in your organization. Alternatively, if you have a slow connection
to the Internet and do not want all of those PPTP clients to connect at the
same time, you can enter a lower number here. For instance, if you have five users who from time to time use
PPTP to connect remotely, entering 5 here would allow all of them to connect at any time. Entering 2 would only allow two users to
connect at any given time. If a third user tried to connect, he or she would receive an
error message and would not be able to connect until one of the other users
disconnected. If, on the other hand, you entered <b>0 </b>, no PPTP connections would
be allowed. </p><p>
After you enter a number and press Save, the server should
be ready to accept PPTP connections.</p><p>To connect using PPTP, the protocol must be installed on each remote Windows client. Typically, this is done through the Network Control Panel (you may need to have
your original Windows installation CD available).  After it is installed (a
reboot of your Windows system may be needed), you can create new
connections through the Dial-Up Networking panel by entering the external IP address of the server you wish to connect to. Once you're finished, you should be able
to initiate a PPTP connection by double-clicking the appropriate icon in the Dial-Up Networking window. When you then open up your
Network Neighborhood window, you should see your server workgroup
listed there.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2818777"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Your connection to the Internet needs to be established <i>first
</i> before you initiate the PPTP connection. This may involve double-clicking one Dial-Up Networking icon to start your Internet connection,
then double-clicking a second icon to start the PPTP connection. To shut down, disconnect your PPTP connection first, then disconnect from your ISP.
</p></td></tr></table><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2818810"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>
To protect your network, the SME Server enforces the use of 128-bit encryption for PPTP connections,
rather than the 40-bit encryption provided in earlier versions of Microsoft's
PPTP software. If you are unable to establish a PPTP connection to your
server, you should visit <a href="http://windowsupdate.microsoft.com/" target="_top">

http://windowsupdate.microsoft.com/</a> and download the appropriate
update. Due to the dynamic nature of Microsoft's web site, the page may appear
differently depending upon the version of Windows you are using. In most
cases, you will want to look or search for <i>Virtual Private Networking</i>
or a <i>Dial Up Networking 128-bit encryption update.</i> You may
need to install the 40-bit encryption update <i>first</i>, and then
install the 128-bit encryption update. Note that
with Microsoft's <i>ActiveUpdate</i> process, if you are not
presented with the choice for this update, it is most likely already installed
in your system.
</p></td></tr></table><a name="id2818859"></a>9.2.3. FTP<p>
Another way to upload or download files to and from your
server is to enable a protocol called FTP, or &quot;file transfer
protocol&quot;. This screen enables you to set your policy for FTP. Note that
allowing liberal FTP access to your server does reduce your security.
You have two options that you can set here.

</p><p>
<b>FTP user account access: </b>
Private
FTP access allows only people on your internal network to write files to
your server. Public FTP access allows users both inside and outside
your local network to read or write files on your server,
provided they have an account and password. If, for example, you want to
be able to update your web site from home using FTP, you would choose the &quot;Public&quot;
setting. We strongly recommend you leave this as <b>Private</b> unless you have a specific reason to do so.
</p><p>
<b>FTP access limits: </b> This allows you to set
an overall site-wide policy for FTP access. <i>The setting you choose here will override all
other FTP settings on your server.</i> For example, if you choose &quot;Disable public
FTP access&quot; here and then later configure an i-bay to allow public FTP access from
the Internet, such access will be forbidden.  Note that one of the
choices here allows you to completely disable any use of FTP.

</p><a name="telnet"></a>9.2.4. telnet<p>
<i>telnet</i> has traditionally been one of the tools used to
login remotely to other systems across a network or the Internet. This
screen gives you the options to control the
use of telnet as a means of connecting to your server.
Telnet can be useful in that
it allows you to login remotely and diagnose problems or configure settings.
However, when you use telnet, all user names and passwords are transmitted <b>without
any kind of encryption</b>, dramatically reducing the security of
your server. For that reason, we <b>strongly</b>
recommend the use of <a href="#ssh" title="10.2.1. ssh">ssh</a> as described above.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2818979"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Because telnet has been and continues to be widely used to date, we are
providing the ability to use telnet for remote access. However, as
<a href="#ssh" title="10.2.1. ssh">ssh</a> usage
increases, it is our intention to remove telnet access from future releases of the
server.</p></td></tr></table><p>

<b>Telnet access: </b> This can be set to
&quot;No Access&quot;, &quot;Private&quot; or &quot;Public&quot;.
Because of the inherent security weakness mentioned above,
we <i>strongly</i> recommend that you leave this set to <b>No Access</b> (the default) and instead use <i>ssh </i> as described above. If you
do need to enable telnet access, we suggest that you enable &quot;public&quot; or

&quot;private&quot; telnet access only when absolutely necessary, and disable such access when it is no longer required. If &quot;public&quot; access is enabled, a red warning will appear at the
top of every server manager screen.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2819028"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Because of these security concerns, we do not allow administrative
command line access (connecting as 'root') using telnet. Please use ssh instead.</p></td></tr></table><a name="admin-localnetworks"></a>9.3.  Local networks<p>
Your SME Server provides services to machines on the local network and
it gives machines on that network special privileges and access. For example,
only machines connected to the local network can access the mail server on your server
 to send mail. When you configured your server, you
provided it with sufficient information to deduce its own local network.
Machines on the network are automatically identified by the server
as being eligible for these privileges and access.
</p><p>
If your company only
has one network that is being serviced by the server,
you do not need to add any information here.
</p><p>
Some advanced users
may wish to extend privileges to more than one network of computers. If
you would like your server to identify one or more
additional networks for those privileges, you will be asked to enter those
network IDs and the subnet mask for each network here.
</p><p>
Note that depending
on the architecture of your network infrastructure, the instructions for
configuring the client machines on that additional network may be different
than the instructions outlined in the chapter in this user guide. If you have
questions regarding adding another network, you may wish to contact Contribs.org
 and visit the forums.

</p><a name="serverconfig"></a>Chapter 10. Configuration<p><b>Table of Contents</b></p>10.1. <a href="#admin-dateandtime">Set date and time</a>10.2. <a href="#admin-setworkgroup">Workgroup</a>10.3. <a href="#admin-directory">Directory</a>10.4. <a href="#admin-printers">Printers</a>10.5. <a href="#admin-hostnames">Hostnames and addresses</a>10.5.1. <a href="#admin-hostnames-creating">Creating New Hostnames</a>10.5.2. <a href="#admin-hostnames-dhcp">Reserving IP Addresses Through DHCP</a>10.6. <a href="#admin-emailretrieval">E-mail Retrieval</a>10.7. <a href="#admin-otheremailsettings">Other E-mail Settings</a>10.8. <a href="#admin-reviewconfig">Review Configuration</a><a name="admin-dateandtime"></a>10.1. Set date and time<p>

Accessing this section
allows you to set the system date and time either manually or using a network
time server. Pull-down menus for month and
time zone ensure accurate entry. The server manager will reset the time
automatically during daylight savings time. There are worldwide time zones
with multiple selections for countries with multiple time zones.
(including standard time zones, states/provinces and even cities).
This ensures that regional variations
in time zones and daylight savings time are accurately reflected.
</p><img src="images/set_date_and_time.jpg" alt="Date and time web panel"><p>
Instead of setting the time manually, you can use a <i>network
time server. </i>A time server is a device
on the Internet that keeps accurate time and is able to communicate
the time to other computers over the Internet using the <i>Network
Time Protocol (NTP)</i>. Many organizations around
the world provide Internet time servers for free.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2818357"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>After you start using a network time server, you should
<b>NOT</b> set the time or date manually.
If you do so, the network time synchronization will no longer function.
</p></td></tr></table><p>
This screen in the server manager allows you to configure your server
to connect regularly to a time server and synchronize the clock
on the server with the time provided by the time server.
To do this, simply check the box for &quot;Enable NTP Service&quot;, add the domain
name or IP address of the time server
in the space provided and click &quot;Save NTP Settings&quot;. Using a time server
is optional but doing so can greatly increase the accuracy of your system.

</p><p>For more information about using a network time server, visit
<a href="http://www.ntp.org/" target="_top">http://www.ntp.org/</a>. You can also
find a list of publicly available time servers at
<a href="http://www.eecis.udel.edu/~mills/ntp/servers.htm" target="_top">
http://www.eecis.udel.edu/~mills/ntp/servers.htm</a>. You should always
use a <i>secondary </i> time server (also called a
<i>stratum 2 </i> server) to lighten the load on the primary time
servers.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/tip.gif"></td><a name="id2819113"></a>Tip</tr><tr><td colspan="2" align="left" valign="top"><p>In order to make sure the network time server is set to your timezone,
you should go through this screen once and <i>manually</i>
set the time to be correct and with the correct timezone. After doing that, go
back to this panel and set the server to use a network time server.</p></td></tr></table><a name="admin-setworkgroup"></a>10.2. Workgroup<p>

If you are using a computer
on a local network and you wish to access the server
via Windows file sharing, it is important that you are logged onto the
same workgroup as your SME Server. This screen allows you
to enter the name of the Windows workgroup the server should appear
in. You should also enter the Windows server name. In order that you may
later connect multiple locations using IPSEC VPNs, we suggest that you use a
different name for each server. If you wish you
can change the workgroup name to correspond with an existing workgroup.
Macintosh users need only enter a server name or accept the defaults.
</p><img src="images/change_workgroup_settings.jpg" alt="Workgroup web panel"><p>
Also in this section,
you can specify whether the server should be the domain master
for your Windows workgroup.  Most sites should choose &quot;Yes&quot; unless you are
adding an server to an existing network which already has a domain
master.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2819368"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>
If you have a Windows NT server or Windows 2000 server
on your network that is functioning as a network server, you should
most likely answer &quot;no&quot; because that other server will act as the domain master.
</p></td></tr></table><p>
If you <i>do</i> configure your system to be the domain master,
a special Windows share called NETLOGON is
created with a DOS batch file called netlogon.bat

. This batch file is executed by Windows clients that have been
configured to &quot;Logon to domain&quot;.  The netlogon.bat file we provide by default
does very little, but advanced users can, if they wish, modify this script to set environment
variables for their clients or provide automatic drive mappings.
</p><p>
As the
NETLOGON share is only writable by the &quot;admin&quot; user, you modify the
netlogon.bat script by logging on to a Windows system as &quot;admin&quot;,
connecting to the share and then modifying the script using a Windows
text editor. Be aware that the NETLOGON share will not be visible in Network
Neighborhood or other similar tools. As the &quot;admin&quot; user, you will need to
connect to the share or map a drive to it, by using the specific path:
</p><table border="0" bgcolor="#E0E0E0" width="90%"><tr><td><pre class="programlisting">

  \\<i>servername</i>\NETLOGON\


</pre></td></tr></table><p>The sample file contains a few examples of setting the system time for
each machine and also for mapping a common drive for all Windows client.
</p><a name="admin-directory"></a>10.3. Directory<p>
Your SME Server provides an easy mechanism for creating a company directory.
Each time you create or delete an e-mail account, your directory will be
automatically updated with the new information.
</p><img src="images/change_ldap_directory_settings.jpg" alt="Directory web panel"><p>
In this section of the
server manager, you specify the default directory information for new accounts
- the user's department, company, street address, city and phone number.
Each time you create an e-mail account, the fields will contain the information
entered here as the default. If you wish, you can change the information
for each user.
</p><p>
At any time in the future,
you can change the default information and have the new information apply
to all new users or to all existing users as well. The field to do this
is located near the bottom of the screen. Choosing &quot;update with new defaults&quot;
is a convenient one-click method of revising your directory when, for example,
your company has moved to a new address.
</p><a name="admin-printers"></a>10.4. Printers<p>
Your SME Server enables all users on your network to easily share a printer.
The printer can be either locally attached to a parallel or USB port on your
server or can be a network printer. All the server
needs is some basic information: the printer name (which can be anything
you want, as long as it starts with a lower-case letter and consists only
of lower-case letters and numbers, with no spaces), a brief description
(for example, &quot;the printer down the hall&quot;) and the location of the printer
- whether it's on the network or directly connected to your server through
a parallel or USB port.
</p><img src="images/create_new_printer.jpg" alt="Printers web panel"><p>

If you choose &quot;Network printer&quot;, you will see an additional screen that will
ask for the hostname or IP address and the network printer name.
Enter
that information where requested.
For the network printer name, you can use the default setting,
raw, unless you have some reason to do otherwise.
(raw is the name used by most network printers for their
main print queues.)
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2819635"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>For maximum flexibility in making changes later, we suggest that you
enter the hostname for a network printer here and enter the IP address of the
printer through the <a href="#admin-hostnames" title="11.5. Hostnames and addresses">Hostnames and addresses
</a> panel of the server manager. This allows you to have one central
location listing IP addresses and allowing you to make changes.  Note that
many modern network printers can be configured automatically. To do so, enter
their hostname, IP address and Ethernet address in the <a href="#admin-hostnames" title="11.5. Hostnames and addresses">Hostnames and addresses
</a> panel.
</p></td></tr></table><p>Note also that the server printing system does not perform any
filtering and passes the print requests <i>directly</i> from
the client computers to the printer in the &quot;raw&quot; or &quot;pass-through&quot; machines.
For this reason, the SME Server does not have a list of &quot;supported printers&quot;. Most
printers are supported as long as the appropriate driver is installed in the
operating system on your <i>client</i> computers.

</p><p>However, there are some newer printers that only have a Windows driver
available and rely heavily on that operating system to perform their print
functions. These printers cannot be used on the server. If you are
concerned about whether your printer will work with your server, you can visit
<a href="http://hardware.redhat.com/redhatready/html/us/static-hcl/intel-input-output.html" target="_top">Red
Hat's Hardware Compatibility List</a> or explore the information found
at <a href="http://www.linuxprinting.org/" target="_top">LinuxPrinting.org</a>.
</p><p>As a final item, you should be aware that in order to use the printers
available through your server a user must be logged in to their client
system with a user name and password that is valid on the server. For
instance, if a user is logged in as tturtle on their
Windows desktop and that user account does <i>not</i> exist on
the server, the user will <i>not</i> be able to print to
the printers managed by the server. Either the user will have to
logout and log back in as a valid user or the tturtle

account will need to be created on the server.
</p><a name="admin-hostnames"></a>10.5. Hostnames and addresses<p>
When you installed your SME Server, you were asked to provide a name
for your system. That name and several other
&quot;standard&quot; names are automatically configured in your system's <i>host
table </i> during the installation process. This host table is
consulted as part of the name resolution process.  The &quot;Hostnames and address&quot;
web panel allows you to modify this table and specify different host &quot;names&quot;
for each domain on your system, as well as to control how those names resolve
both for systems on your local network and also for systems on the larger
Internet.
</p><p>

For instance, when someone
tries to connect to &quot;www.mycompany.xxx&quot;, they will be taken to wherever &quot;www&quot;
has been set to point to. As seen in the image below,
this screen in the server manager allows you to view these default settings, and
also to modify the configuration.
</p><a name="id2819786"></a><table border="1"><tr><td><p class="title"><b>Using the Hostnames Panel</b></p>
<p>
Throughout the screens linked to from the Hostnames panel, you will find
the text &quot;Publish globally?&quot; with a checkbox next to it.
<img src="images/create_host_entries.jpg" alt="Creating a host entry"><p>Suppose, for example, your company's web site was hosted at some other location, such as on your
ISP's web servers.  If you wanted &quot;www.mycompany.xxx&quot; to point to your ISP's server, you
would modify the entry here by clicking the &quot;Modify...&quot; link next to &quot;www&quot;.
The image below shows the screen in which you would perform the task:

</p><img src="images/modify_hostname.jpg" alt="Modifying a hostname"><p>You would first change the location to &quot;Remote&quot; and then enter the IP
address of your ISP's server in the field marked &quot;Global IP&quot;.

</p><a name="admin-hostnames-creating"></a>10.5.1. Creating New Hostnames<p>
Creating new hostnames simply involves selecting one of the links at the top
of the Hostnames and addresses panel and filling out the appropriate fields.
</p><p>Note that if your system is configured with any <a href="#admin-virtdom" title="11.6. Virtual Domains">virtual domains</a>, you will have the choice of
the domain in which you want to create the hostname.  This allows you, for
instance, to have &quot;www.tofu-dog.com&quot; pointing to one IP address and
&quot;www.mycompany.xxx&quot; pointing to a completely separate IP address.

</p><p>The hostnames you can create on this panel fall into three categories:
</p><p><b>Additional names for your server:</b> For
instance, you might want to set up &quot;intranet.mycompany.xxx&quot; to point to your
server.  All you do here is enter the hostname and, if appropriate, choose the
domain for the hostname.
</p><p><b>Remote hosts:</b> As mentioned in the
example earlier, you might want to point a hostname such as &quot;www&quot; to a remote
system.  While &quot;www&quot; is created by default, you can create other names such as
&quot;home&quot;, &quot;research&quot;, or any other appropriate name.  In the form, you simply
enter the hostname, choose the domain, and enter the remote IP address.

</p><p><b>Local hosts:</b> This screen is a bit
more complicated because you have more options. At a basic level, you can
create a hostname in a domain that points to another computer on your local
network.  To do this, just type in the hostname and enter the IP address in
the &quot;Local IP&quot; field.  For instance, you might want &quot;research&quot;
to point to a computer system inside your network.
</p><p>Where this gets complicated is when you want &quot;research.mycompany.xxx&quot;
to be accessible both <i>inside</i> and <i>outside</i> your
local network.  The challenge is that your local IP addresses are only
accessible <i>inside</i> your network.  For that reason, the
target computer system will need to have two network interface cards - one
connected to the internal network and one connected to the external network.
You would then enter both IP addresses in this screen in the &quot;Local IP&quot; and

&quot;Global IP&quot; fields.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2820057"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>The &quot;Ethernet address&quot; field when creating a hostname pointing
to a local host is only used for reserving IP
addresses through DHCP as mentioned in the next section.
</p></td></tr></table><a name="admin-hostnames-dhcp"></a>10.5.2. Reserving IP Addresses Through DHCP<p>Another task you can perform through this panel is to reserve an IP
address for a given system based on its Ethernet address. For instance, you
might have another intranet web server within your company that you want to
always have the same IP address.  One method of assigning that address is to
manually configure the client machine to have a static IP address. The
negative aspect of doing this is that if you later want to change the network
settings for that machine, you must manually go and configure that machine.
An example would be if one of your DNS servers changed its IP address.
Additionally, you have to keep track somewhere of the fact that you have
assigned a specific IP address to that machine.
</p><p>Rather than configuring the machine manually, you can
<i>reserve</i> an IP
address from the DHCP server for that specific machine. This has the same
result as manually configuring a static IP address, but offers two benefits.
First, you have one location to keep track of all assigned static address.
Second, through the DHCP server you will provide network settings. If you wish
to change those settings, the change can be simply done on your server.
All DHCP clients will then receive those updated changes when they
renew their DHCP-provided addresses.
</p><p>To reserve an IP address, you must first determine the Ethernet address
of your client system. Windows NT/2000 users can type the command
<b>ipconfig /all</b>. Windows 95/98 users can run the command

<b>winipcfg</b>. Linux/UNIX users can type
<b>ifconfig</b>.
</p><p>Once you have determined the client's Ethernet address, click on the
link to create a new hostname for a <i>local</i> host. Add the
hostname of the target system, the Ethernet address along with the desired
IP address into the web panel. From this
point on specified IP address will only be provided to a client system with
the matching Ethernet address.
</p><a name="admin-emailretrieval"></a>10.6. E-mail Retrieval<p>
As shown below, this section of the server manager allows you to specify the
protocol used to retrieve e-mail from your ISP and configure other settings
regarding the retrieval of e-mail.  </p><img src="images/change_email_retrieval1.jpg" alt="E-mail Retrieval web panel">
<br><img src="images/change_email_retrieval2.jpg" alt="E-mail Retrieval web panel"><p>
Your choice of e-mail
retrieval mode will depend on the arrangements you made with your Internet
service provider:
</p><ul type="disc"><li><p>
<b>If you have a dedicated
connection</b>, set E-mail retrieval mode to &quot;Standard&quot;.

</p></li><li><p>
<b>If you arranged
&quot;ETRN&quot; support with your ISP</b>, choose that setting and then scroll down
to the field that asks for the IP address or hostname of your ISP's secondary
mail server. This secondary mail server will provide temporary e-mail storage
when your server is not connected to the Internet.
</p></li><li><p>
<b>If you arranged
&quot;multidrop&quot; mail service from your ISP</b>, choose &quot;multidrop&quot; and then
scroll down to the field that asks for the IP address or hostname of your
ISP's secondary mail server. This secondary mail server will receive all
e-mail for your domain and store it in a single POP mailbox. Further down
the screen, you will need to specify the user account and password assigned
by your ISP for this POP mailbox. Your server will
periodically fetch this mail and distribute it to individual POP mailboxes
on the server. (Note that due to problems receiving mail
for mailing lists, we <i>strongly</i> encourage people to

<i>NOT</i> use multi-drop e-mail.)
</p></li></ul><p><b>If you want to forward e-mail to another mail
server for processing</b>, enter the mail server IP address in the box marked
<b>Delegate mail server</b>. A common use for this is if your
server is receiving inbound e-mail from the Internet, but
you would like to pass that mail to a different mail server on your internal
network.
</p><p>
If you have a dialup
connection, the server allows you to control how frequently
it fetches e-mail from your ISP. This is particularly useful in situations
where you incur phone or Internet charges each time your system contacts
your ISP. The default settings are every 15 minutes during standard office
hours and every hour outside normal office hours on weekdays or on weekends.
The fields allow you to customize those settings.
</p><p>
Finally, if you have
&quot;multidrop&quot; mail service you need to select the sort method used by the
server to decide which user each message should be
delivered to. Your server has a default method for
this (it examines various headers such as &quot;To&quot; and &quot;Resent-To&quot;) which works
in most circumstances but is not suitable for certain purposes such as
mailing list messages. Some ISPs add a header to each e-mail message which
can help your server determine the correct recipient.
If your ISP does not add a header to multidrop e-mail, select the &quot;Default&quot;

sort method and ignore the &quot;select sort header&quot; field. If your ISP does
add a header to multidrop e-mail, then select &quot;Specify below&quot; and enter
the header tag provided by your ISP. Because you
<i>will</i> experience problems with mailing-lists when using
multi-drop e-mail, we strongly recommend that you work with your ISP to have a
special header added to each message. The &quot;Default&quot; sort method should be only
used as a last resort.
</p><a name="admin-otheremailsettings"></a>10.7. Other E-mail Settings<p>
This screen presents
you with additional options for controlling how your system handles
e-mail.
</p><img src="images/change_other_email_settings.jpg" alt="Other e-mail settings web panel"><ul type="disc"><li><p>

<b>Forwarding address
for administrative notices:</b> The default address for administrative notices
(i.e. undeliverable mail, backup notifications and other status/error messages)
is &quot;admin&quot;. If you'd like those messages to be sent elsewhere, enter the address here.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2820480"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Be aware that all messages sent to postmaster,
root or mailer-daemon at your domain
are sent to either admin or the address that you enter
in this field.</p></td></tr></table></li><li><p>

<b>E-mail to unknown users:</b>
This field allows you to choose whether incoming messages to
unknown users are bounced back to the sender or forwarded to the system
administrator. Some users prefer the latter setting because it allows them
to catch and reroute e-mail that was incorrectly addressed.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2820537"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>If you choose to have messages forwarded to the system administrator,
they will be sent to either &quot;admin&quot; or the e-mail address specified in the
forwarding address field mentioned above.</p></td></tr></table></li><li><p>
<b>Internet provider's
SMTP server:</b> Normally the server will send outgoing
messages directly to their intended destination. If, however, you have
an unreliable connection or are using a residential Internet service, it
may be advisable to route e-mail via your provider's SMTP server. In that
case, you should enter the SMTP server's hostname or IP address here.
</p><p>In fact, if you have a temporary dial-up connection to the Internet, you
may find that you <i>need</i> to use your ISP's mail server in
order to deliver mail to some locations.  As a reaction to the huge volume of
unsolicited
commercial e-mail (&quot;spam&quot;), many Internet sites are refusing direct SMTP
connections from IP addresses that are known to be temporary dial-up accounts.
For this reason, you may need to use your ISP's mail server since it will have
a permanent connection to the Internet.

</p></li><li><p>
<b>POP and IMAP server
access:</b> The options are &quot;Private&quot; and &quot;Public&quot;. The former allows access
only from your local network. The latter allows access from anywhere on
the Internet. Think about this carefully.  On the positive side, choosing
&quot;Public&quot; access allows any of your users to retrieve their e-mail via POP/IMAP from
anywhere on the Internet. The negative side is that when you do this, you are reducing your level of security, as you will now have two more services (POP and
IMAP) that are listening for connections across the Internet.  Both protocols
also involve transmitting your password across the Internet in plain,
unencrypted text, opening up the possibility that someone could intercept the
packets and learn your username and password.  Allowing such access can be a
great convenience to your users, but if security is a concern you should consider using encrypted webmail instead.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2820618"></a>IMPORTANT</tr><tr><td colspan="2" align="left" valign="top"><p>Even with POP and IMAP configured for public access, users outside your
local network are not able to <i>send</i> e-mail using your
server as their SMTP host. Allowing this would open your server to abuse by
spammers as a mail relay.  Users who are travelling should either: a) use the
STMP server of their local ISP; b) use PPTP to connect to your internal
network; or c) use webmail to read their mail. Webmail provides your users
with secure access to both read and send mail via your server.

</p></td></tr></table></li><li><p>
<b>Enable/Disable Webmail:
</b> With this option you can enable or disable the webmail
component of your server. More information can be found in
the <a href="#webmail" title="Chapter 16. Webmail">Webmail chapter</a>.
</p></li></ul><a name="admin-reviewconfig"></a>10.8. Review Configuration<p>
This section of the server manager summarizes how your server is configured.
This is the data that you entered during
the installation process and possibly changed later through the server console
or the server manager.  As you can see from the screen below, this is essentially
a report that you can print out for your records. You do not have the ability
to make changes from this screen.
</p><img src="images/review_configuration.jpg" alt="Review configuration web panel"><a name="collaboration"></a>Chapter 11.  Collaboration<p><b>Table of Contents</b></p>11.1. <a href="#admin-useraccounts">User Accounts</a>11.1.1. <a href="#user-disabling">Disabling User Accounts</a>11.1.2. <a href="#user-passwords">Changing User Passwords</a>11.2. <a href="#admin-quotas">Quota Management</a>11.3. <a href="#admin-groups"> Groups</a>11.4. <a href="#admin-pseudonyms">Pseudonyms</a>11.5. <a href="#admin-ibays"> Information Bays</a>11.6. <a href="#admin-virtdom">Virtual Domains</a><a name="admin-useraccounts"></a>11.1. User Accounts<p>

User accounts should be
set up for each person in your organization. A user account includes separate,
password-protected e-mail and file storage areas.
</p><p>
If this is the first
time you are setting up user accounts for your organization, you will need
to establish what your naming convention will be. Let's assume you've decided
that the account name should consist of first initial and last name. So,
if you have an employee named Fred Frog, Fred's user account would be
&quot;ffrog&quot;. Assuming your domain name is tofu-dog.com, Fred's e-mail address
would be &quot;ffrog@tofu-dog.com&quot;. Fred's file directory on the
server would also be named &quot;ffrog&quot;. There are
some basic rules built into the server as to what constitutes a valid account
name. The account name must contain only lower-case letters and numbers
and should start with a lower-case letter (not a number).
</p><p>User account names are limited to twelve characters to maintain
consistency with various versions of Windows. Longer names can be created for
e-mail through the <a href="#admin-pseudonyms" title="12.4. Pseudonyms">Pseudonyms</a> panel.
For your information, pseudonyms of &quot;firstname.lastname&quot; and
&quot;firstname_lastname&quot; are automatically created for each account.

</p><img src="images/user_account.jpg" alt="User accounts web panel"><p>
In the &quot;User Accounts&quot;
section of the server manager, you will see a list of your current accounts.
If you haven't already created any accounts, select &quot;Click here&quot;
and fill in the requested information - the account name (the part of the
e-mail address that comes before &quot;@&quot;), the person's name, address, department, company
and phone number. As a convenience, the defaults that you entered
in the &quot;Directory&quot; section of the server manager appear each time you create a new
account. You can, if necessary, modify the information for each user as you create the
account.
</p><p>
From the list of user
accounts, you can easily modify or remove a user account (by clicking on &quot;modify&quot; or &quot;remove&quot; next to the user name) or set the user's password.

<b>User accounts are locked out and cannot be used until you set the
initial password for each account.</b> As a reminder of this, user accounts appear
in red until the password is changed. (In the example shown here, the administrator
has not yet changed the password for user &quot;Sally Salmon&quot;).
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2819192"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>If you want someone to have an e-mail address at your company, but want
the messages forwarded to another external e-mail address, you can create the
user account but set the e-mail delivery option in the user account to
<i>Forward to address below</i> and enter the external address.
If you leave the user account locked out, the user will not be able to access
services on your server, but the e-mail <i>will</i> be delivered
to the external e-mail address.
</p></td></tr></table><a name="user-disabling"></a>11.1.1. Disabling User Accounts<p>There may be times when you do not wish to delete a user account
but instead merely want to disable it.  For instance, when an employee leaves
the company, you may want to immediately remove their access to the server, but still
keep their files or e-mail address active until the information can be
examined.  To disable any user account on your server, just click on
the
<i>Lock Account</i> link on the User Accounts web panel.

<i>As soon as you click the link</i>, the account will be locked
out.  The user will no longer be able to retrieve e-mail or connect to any
files or other resources on the server.
</p><p>When an account is disabled, e-mail <i>will</i> still be
received for that user name, but the user will be unable to retrieve the
e-mail.  As noted above, if a user account is set to forward e-mail to an external
e-mail address, the e-mail <i>will</i> be forwarded to that
external address.  To prevent this, you will need to modify the properties for
that user account.
</p><p>To re-enable the user account, you need to reset the password using the
link on the User Accounts web panel.
</p><a name="user-passwords"></a>11.1.2. Changing User Passwords<p>
Once they have an active account,
your users can set their own passwords by accessing
the user-password URL. They do this through their web browsers by visiting
the URL <b>www.yourdomain.xxx/user-password</b> (where &quot;www.yourdomain.xxx&quot;

is the web server name you entered into the server console).
The staff at The Pagan Vegan would visit the URL <b>www.tofu-dog.com/user-password</b>.
</p><p>
To make the change,
a user would enter his or her account name (the characters before &quot;@&quot;),
the old password and the new password (to ensure accuracy, the screen asks
for the new password twice). Note that changing the password for a user in the
server manager overrides any previous password entered by your user. Therefore,
when a user forgets his password, simply reset it in the server manager.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2821020"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>There is no way for the administrator to recover a forgotten password
for a user.  All they can do is set a <i>new</i> password for
the user.</p></td></tr></table><a name="admin-quotas"></a>11.2. Quota Management<p>By default, there is no size limit on the files a user may store on the
server or the amount of e-mail he or she may receive. However,
if you wish to limit the disk space a particular user account can use, you may
do so on the &quot;<i>Quota management</i>&quot; panel in the server manager. As shown
in the image below, you will see a list of user accounts, the actual disk
space they are using and the quotas, if any, set for that user account.

</p><img src="images/manage_user_account_quotas.jpg"><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2821115"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>Note that the quotas apply to <b>all</b> files
that a user stores on the server.  This includes not just their home
directory, but also all files that they may put into any of the i-bays.</p></td></tr></table><p>There are two quotas that can be applied to each user account:
</p><ul type="disc"><li><p><b>Limit with grace period</b> - when a
user's disk usage exceeds this limit, an e-mail warning message will be sent to
the user account each night until the disk usage is brought back under the
limit.
</p></li><li><p><b>Absolute limit</b> - when a user's disk
usage hits this limit, the user will no longer be able to save files to the
server or receive e-mail.
</p></li></ul><p>Note that if the user account exceeds the &quot;Limit with grace period&quot; for
seven consecutive days, the account will be treated as if it exceeded the
absolute limit and will no longer be able to save files or receive e-mail.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/important.gif"></td><a name="id2821185"></a>Important</tr><tr><td colspan="2" align="left" valign="top"><p>E-mail for the user account is <b>not</b> lost!  It is
held in the delivery queue and will be delivered to the user when their disk
usage drops back below their absolute limit (or the &quot;limit with grace period&quot;

if they were locked out due to seven days above that limit).
</p></td></tr></table><p>By selecting &quot;<i>Modify...</i>&quot; you are able to set a
quota (in Megabytes) for a particular user account.  Note that you do not have
to set <i>both</i> limits for a user account and can choose to
set only one of the limits.
</p><p>If you set a limit and later wish to <i>disable</i> the
quota for a given user account, all you need to do is set the limit to &quot;0&quot;.
</p><a name="admin-groups"></a>11.3.  Groups<p>
This screen allows you
to create, remove or change user groups, which are simply lists of people
with a shared interest - for example, they work in the same department
or are collaborating on a project. The user group function serves two purposes
in the SME Server: it permits e-mail to be sent conveniently
to a group of users, and it allows the system administrator to associate
groups of users with a single information bay (i-bay).

</p><p>
Creating a new group is a simple three-step process. You enter the group name (as with
account names, these should begin with a lower-case letter and consist
only of lower-case letters and numbers), followed by a brief description.
Finally, check the boxes next to the names of the users
who should be associated with that group.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2821268"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>When you create a group, you are required to assign <i>at least one</i>
user to that group. If you fail to do so, the group will not be created and you will
receive an error message.
</p></td></tr></table><p>After you add (or remove) a user account from a group, the user must log
out and log back in for those changes to take effect. Until the user does so,
he or she will still have their old group membership information. For
instance, say that you create a new group &quot;sales&quot; and assign user &quot;ffrog&quot;
(Fred Frog) to that group.  You then create a new i-bay called &quot;salesinfo&quot; that only the

&quot;sales&quot; group can access.  Fred Frog is still logged into a Windows PC and now tries
to connect to the new i-bay through Windows Explorer. He will receive a
permission-denied error.  He must log out of windows (he does not need to
shut down or reboot, just log out) and login again. Now he should be able to
go through Windows Explorer and access the &quot;salesinfo&quot; i-bay without any
problem.</p><a name="admin-pseudonyms"></a>11.4. Pseudonyms<p>
Any user who has an account on your SME Server will be able to
receive e-mail sent to that user ID.  For instance, if you have a user named Fred Frog
with the user account &quot;ffrog&quot;, his primary e-mail address will be
&quot;ffrog@mycompany.xxx&quot;.
</p><p>
Likewise, when you create a group account, that group account name functions as an
e-mail <i>alias</i>, so that messages addressed to the group ID will be
sent to all members of the group.  If, for example, you create a group called

&quot;sales&quot;, messages to &quot;sales@mycompany.xxx&quot; will be distributed automatically
to all members of that group.  As you add and remove members to the group,
your server automatically updates the e-mail alias.
</p><p>
In addition to user and group accounts, however, your server also
automatically creates several <i>pseudonyms </i>.
For instance, for <i>each </i>user account, the server
creates two separate pseudonyms using the first and last names of the user. These two pseudonyms are in the form of &quot;firstname.lastname&quot; and &quot;firstname_lastname&quot;.  Hence, when
you create the user account &quot;ffrog&quot; for a user with the name Fred Frog, he will also be
able to receive e-mail sent to &quot;fred.frog@mycompany.xxx&quot; and

&quot;fred_frog@mycompany.xxx&quot;.
</p><p>
Additionally, your server creates a special pseudonym called &quot;everyone&quot;
that includes all user accounts on the system.  Two other pseudonyms, &quot;postmaster&quot; and &quot;mailer-daemon&quot;
are created pointing to the &quot;admin&quot; user.
</p><p>

If you wish to modify or remove any of these pseudonyms, or create new ones,
you can use the web panel found under the &quot;Collaboration&quot; section, as shown
below.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2821377"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>The special pseudonyms of &quot;everyone&quot;, &quot;postmaster&quot; and &quot;mailer-daemon&quot;
will only be visible after you have either added a user account to the system
or have added a custom pseudonym.  Until that time, these three pseudonyms are
there, but will not be visible on the Pseudonyms web panel.</p></td></tr></table><img src="images/create_pseudonyms.jpg" alt="Pseudonyms web panel"><p>
As noted on the screen below, there are some restrictions on the
text content of the names. Pseudonyms can be linked to existing user or group
accounts. In the example shown, a pseudonym for <i>webmaster</i>

is being set to point to <i>ffrog</i>.
</p><img src="images/create_a_pseudonym.jpg" alt="Creating a pseudonym"><a name="admin-ibays"></a>11.5.  Information Bays<p>
The i-bay (information
bay) feature of the SME Server is a simple, very flexible
and powerful way for you to share information with others. It is a rich
enough feature that we've devoted an entire upcoming <a href="#i-bays" title="Chapter 16.  Information Bays (i-bays)">
chapter</a> to discussing i-bays.
</p><a name="admin-virtdom"></a>11.6. Virtual Domains<p>
When you are supporting
multiple domains on a single server, each domain being served is referred
to as a <i>virtual domain</i>. (The strict definition of virtual domain is when
a single IP address is shared between multiple domains.) When you create
a virtual domain using this section of the server manager, your SME Server
will be able to receive e-mail for that domain and will be able
to host a web site for that domain.
</p><p>
To create a virtual
domain, fill in the domain name and a description of the site. You then
tell the server where to find the content for that domain - it can be the
same as your primary web site, or you can create a new set of web pages
and store them in one of your i-bays. Clicking the arrow in the &quot;Content&quot;

field will show you a list of your current i-bays and allow you to make
a selection. This feature allows you to host multiple web sites from a
single server.
</p><p>Be aware that you can point the virtual domain to either the
<i>primary</i> web site or to one of the
<i>i-bays</i>. You cannot point a virtual domain to a
subdirectory that you simply create inside of the primary web site file
area. You need to use an i-bay instead.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2821584"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>When you are entering the name for the virtual domain, you should
supply the <i>fully-qualified domain name</i>. This is the full
name of the domain, including any extensions like &quot;.com&quot;, but
<i>without</i> any prefixes like &quot;www&quot; or &quot;ftp&quot;. For instance, you
can create a virtual domain by entering &quot;tofu-bird.com&quot;, but

<i>not</i> by entering &quot;tofu-bird&quot; or &quot;www.tofu-bird.com&quot;.
</p></td></tr></table><p>
Once you have
created a virtual domain, your server will be
automatically configured to answer to web requests for
<i>www.domainname.xxx</i> and will accept e-mail for your
virtual domain as well.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/important.gif"></td><a name="id2821622"></a>Important</tr><tr><td colspan="2" align="left" valign="top"><p>
While the server is prepared to offer web and e-mail services for this
virtual domain, there is one more step that must occur. In order for
users on the Internet to successfully connect to your machine using
the virtual domain, you will need to work with your ISP or whoever controls
the DNS entries for your virtual domain to have the appropriate DNS
entries pointed to the IP address of your server. For instance, your ISP
will need to configure an MX record for the domain in order for you to
receive inbound e-mail to that domain.
</p></td></tr></table>

<a name="administration"></a>Chapter 12. Administration<p><b>Table of Contents</b></p>12.1. <a href="#admin-backup">Backup or Restore</a>12.1.1. <a href="#admin-backup-snapshot">Backup To Desktop</a>12.1.2. <a href="#admin-restore-snapshot">Restore From Desktop</a>12.1.3. <a href="#admin-verify-snapshot">Verify Desktop Backup File</a>12.1.4. <a href="#admin-backup-tape">Configure Tape Backup</a>12.1.5. <a href="#admin-restore-tape">Restore From Tape</a>12.2. <a href="#admin-reinstalldisk">Reinstallation Disk</a>12.3. <a href="#admin-maillogfile">Mail Log File Analysis</a>12.4. <a href="#admin-viewlogfiles">View Log Files</a>12.5. <a href="#admin-reboot">Reboot or Shutdown</a>

<a name="admin-backup"></a>12.1. Backup or Restore<p>
You can easily back
up the contents of your SME Server using one of two methods.
Both are controlled through the web panel shown below.

</p><img src="images/backup.jpg" alt="Backup web panel"><p>You have four actions you can perform, each of which is described in the
following sections.
</p><a name="admin-backup-snapshot"></a>12.1.1. Backup To Desktop<p>
The first type of backup allows you to save a snapshot of your server configuration onto your desktop
computer. This will save all user accounts, user
directories, i-bay contents and web content, as well as the configuration parameters
entered using the server console and the server manager. The web panel shows
you the size of the backup file so that you can verify whether sufficient
space exists on your desktop machine.
</p><p>
When you choose <b>Backup to desktop</b>,
 a browser window will appear that will allow you to name the file
and select the location on your desktop where the file will be saved.
</p><a name="admin-restore-snapshot"></a>12.1.2. Restore From Desktop<p>
If
you ever need to restore the original configuration and files to your server,
simply select <b>Restore from desktop
</b> and a browser window will prompt
you to select the backup file from your desktop. Restoration of the information
is automatic.

</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2822573"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>Ideally you should use <b>Restore from desktop</b>
on a freshly installed server. Therefore, if you are planning to do a restore, you
should first re-install the SME Server software and <i>then</i> perform
the &quot;Restore from desktop&quot; command.
</p></td></tr></table><a name="admin-verify-snapshot"></a>12.1.3. Verify Desktop Backup File<p>This option allows you to verify that the backup to disk was completed
successfully.  In rare cases we have found that users ran out of disk space on
their client PC while doing the backup to desktop.  This options allows you to
verify whether or not the backup did in fact complete successfully.
</p><a name="admin-backup-tape"></a>12.1.4. Configure Tape Backup<p>
The second type of backup involves configuring your system to perform a
daily full system backup to a tape
drive using a software package called <i>flexbackup</i>. If you wish to activate this option, check the box next to <b>Enable Tape Backup</b> and then specify the
time at which you wish the backup to occur and the time at which reminder notices
should be sent.

</p><img src="images/backup_tape.jpg" alt="Configuring a tape backup"><p>Be aware that you must use a supported tape drive
and that a tape must be inserted in the drive for the backup to
work.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2822703"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Reminder e-mail messages for tape backups are automatically sent to the e-mail address that is
configured to receive administrative notices. This is normally the user
<i>admin</i>, but you can change this by going to the <a href="#admin-otheremailsettings" title="11.7. Other E-mail Settings">
Other e-mail settings</a> screen in the server manager.</p></td></tr></table><a name="admin-restore-tape"></a>12.1.5. Restore From Tape<p>If you are performing regular backups, you can also restore user data and configuration settings by using the
<b>Restore From Tape</b> option. After you press
the <i>Perform</i> button, the system will read the files from
tape and overwrite any currently existing files. <b>You must reboot your system</b> after the restore for the
changes to take effect. Note that in order to restore data from tape, you must
have first checked off <b>Enable Tape Backup</b>

and scheduled nightly backups.  If you have not done this, you will not be
able to restore from tape using the server manager.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2822780"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>Note that this restore procedure <i>only</i> restores
user data and configuration information. It does <i>not</i>
restore system files.  If you experienced a serious system crash, you should
<i>first</i> re-install the SME Server software and
then perform a restore from tape.
</p></td></tr></table><a name="admin-reinstalldisk"></a>12.2. Reinstallation Disk<p>
Using this section of the server manager, you can create a reinstallation
diskette which
will aid in the recovery process in the unlikely
event that you encounter a system failure and are required to reinstall the
software. The reinstallation diskette will record
system and network configuration data for your current system so that you will not
need to re-enter that information when you reinstall.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2822841"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>Each time you alter your system configuration, you <b>MUST </b> make a new reinstallation disk (or overwrite
your old one). Otherwise, your existing reinstallation disk will not
contain your updated configuration data - which means that after reinstalling the
software, you will not automatically see your most recent data.

</p></td></tr></table><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2822862"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Be aware that when you are performing this task, the diskette must
be in the <b>server</b> diskette drive,
<i>NOT</i> the diskette drive of your local desktop computer.</p></td></tr></table><p>Note that this reinstallation disk serves a <i>different
</i> purpose than the &quot;emergency boot disk&quot; you created as part of the
original software installation process.  The emergency boot disk allows you
to  boot your server if you are unable to boot from the hard disk
for some reason. For instance, this could occur due to a hardware error or
through a mis-configuration of the LILO boot loader during an advanced
customization procedure. The emergency boot diskette does not change your
software or make any other adjustments to your system.
</p><p>The reinstallation disk, on the other hand, will boot your system
directly into the <i>software installation process</i> and
will completely reinstall the SME Server software. It will,
however, save you the steps of entering all the network configuration data and
allow you to simply move through the configuration screens using the &quot;Keep&quot;

option.
</p><a name="admin-maillogfile"></a>12.3. Mail Log File Analysis<p>If you are using your SME Server to send and receive
e-mail, there are now a number of reports available that can help you
analyze your system's performance.  While the
default setting provides basic statistics, if you pop up the menu, you
will see a range of other options.  If you suspect that there is a problem
with the delivery of your e-mail, you can use these reports to see how your
system is operating.  The information can also help you decide how
best to optimize your system.
</p><a name="admin-viewlogfiles"></a>12.4. View Log Files<p>This panel allows you to view the system log files on you server.  As
shown in the image below, you select the log file that you want to view and
press the &quot;View Log File&quot; button.  Without any filter options, you will see
the entire log file.
</p><img src="images/view_log_files.jpg" alt="View Log Files"><p>You will probably find the log file of most interest to be
messages
where most of the system services write log messages.  If you enter any text
in the &quot;<i>Filter Pattern</i>&quot; box, only lines of the log file
containing that
text will be displayed.  If you enter any text in the
&quot;<i>Highlight Pattern</i>&quot; box, that text will be shown in bold.
Both options can be used together. Be aware that the filter is case-sensitive.

</p><p>
As an example, if you were interested in messages relating to DHCP, you could
examine the log file messages with a filter pattern of
DHCP. This will show you all DHCP-related messages. If
you further add a highlight pattern of
DHCPACK, the messages relating to DHCP acknowledgements
will appear in bold.
</p><a name="admin-reboot"></a>12.5. Reboot or Shutdown<p>
If you need to shut
down or reboot your server, using this screen will
ensure that the shutdown sequence occurs gracefully, preserving all configuration
and information on your server. There is a similar
function in the server console as well. Note that this screen initiates the shutdown
or reboot <b>immediately </b> after you click the
&quot;Perform&quot; button.

</p><a name="servermisc"></a>Chapter 13. Miscellaneous<p><b>Table of Contents</b></p>13.1. <a href="#admin-onlinemanual">Online manual</a>13.2. <a href="#admin-starterweb">Create Starter Web Site</a>13.3. <a href="#admin-misc">Other Administration Notes</a><a name="admin-onlinemanual"></a>13.1. Online manual<p>This link will take you directly from the server manager to the online
user guide available at <a href="http://wiki.contribs.org/" target="_top">
http://wiki.contribs.org/</a>. Note that you must be connected to the Internet to read the online user guide.
</p><a name="admin-starterweb"></a>13.2. Create Starter Web Site<p>
If you already have
a customized web site, you should not use this section, since it will overwrite
your index.htm file.

</p><p>
If you do not have a
customized web site and wish to create your starter home page, simply fill
out the appropriate fields. This will create a basic home page that you can
visit by entering your domain name for your site,
http://www.yourdomain.xxx, in your web browser. Note that, as previously explained, there is typically a
delay of one or more days before your ISP publishes your domain address
records. On your local network, you can use &quot;http://www/&quot; to view your starter
web site.
</p><p>
At any point in the
future, you can replace or revise your starter web page by replacing or
revising the files in the html directory on your server.
The html directory for your web site can be accessed using Windows file
sharing. Ensure you are logged onto your network using the
admin name and
password and then use file sharing to go to the server. Select the
&quot;primary&quot; share and then select the

&quot;html&quot; directory.
</p><a name="admin-misc"></a>13.3. Other Administration Notes<p>
<b>Accessing administrative areas of your server
via Windows file sharing:</b> To access
administrative
areas of your server using
Windows file sharing, you must be logged into your network as &quot;admin&quot; with
the server system password. This applies particularly to the NETLOGON share
(where you can edit the netlogon.bat file), the
<i>Primary</i> share (where the main web site is stored) and any
i-bays that are writable only by the user <i>admin</i>.

</p><a name="i-bays"></a>Chapter 14.  Information Bays (i-bays)<p><b>Table of Contents</b></p>14.1. <a href="#ibaydirs">i-bay Directories</a>14.2. <a href="#ibayaccess">Accessing the i-bays</a>14.3. <a href="#ibaycreation">Creating an i-bay</a>14.4. <a href="#ibaymodify">Modifying an i-bay</a>14.5. <a href="#ibaycustsite">An i-bay Used as a Customer Site: The Miles Gabriel Art
Exposition</a>14.6. <a href="#ibayshareddrive"> An i-bay Used as a Shared Network Drive</a>14.7. <a href="#ibayintranet"> An i-bay Used as an Intranet: The Pagan Vegan &quot;Vegemite&quot;</a>14.8. <a href="#ibayprocess"> An i-bay Used to Expedite Processes: Samson's Farms</a>14.9. <a href="#ibaycustdownload">An i-bay Used as Your Customer Download Site</a><p>

Information bays, or
i-bays, are a unique feature built into your SME Server.
i-bays are a powerful, simple, flexible mechanism for creating distinct
information-sharing sites. The network administrator can define several
characteristics for each new i-bay they create:
</p><ul type="disc"><li><p>
<b>write access:</b>
the administrator can control access to the i-bay by associating the i-bay
with a group. All groups
previously created in the groups section of the server manager will appear
in the drop-down menu under &quot;group&quot; in this section. In addition, two default
groups will always appear - &quot;administrator&quot; and &quot;everyone&quot; (meaning all users, whether on the local network or on the Internet).
</p></li><li><p>
<b>user access via
file-sharing or FTP:</b> The administrator can also control who has the
ability to save a file into or modify the contents of the files in the
i-bay (write access) and who has the ability to view the contents of the
i-bay (read access). The administrator can specify whether the entire
group can write to the i-bay or whether the administrator alone has the power to save files to the i-bay. Similarly, the administrator can control whether group members only can read the contents of the i-bay or
whether the contents can be read by anyone.

</p></li><li><p>
<b>password protection:</b>
the administrator can specify whether a password is required to access
an i-bay from the Internet and what that password will be.
</p></li></ul><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2823216"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>If you select
<i>Password Required</i>, users who connect to the i-bay via FTP or HTTP will be prompted
to supply that particular i-bay's username and password. The <i>user</i> name is always the name
of the i-bay and the <i>password</i> is whatever the administrator assigns to that i-bay - not the individual user's password.
Note that, as with user accounts, i-bay accounts are locked out
by default. <i>If</i> a password is required, users will not be
able to access the i-bay until the administrator sets the password.</p></td></tr></table><p>

i-bays are simple to
create and manage. The &quot;Information bays&quot; section of the server manager
shows all current i-bays, the name of each i-bay and a description of its
contents. In this section, you can delete an i-bay (which will delete all
contents of the i-bay directory) and, if the i-bay requires a password,
you can set it here. As with your user account directory, any i-bay that requires
a password will appear in red until that password has been changed from
&quot;default&quot; (the i-bay for Samson's Farms in the following image is an example of this).
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2823252"></a>A note about i-bay names</tr><tr><td colspan="2" align="left" valign="top"><p>When you create an i-bay, the name may be up to 12
characters long[<a name="id2823272" href="#ftn.id2823272">4</a>]
and may contain only lower-case letters, numbers, periods and underscores.
The i-bay name should also start with a lower-case letter. For example,
<b>johnson</b>, <b>sales</b> and

<b>client3.prj8</b> are all valid names, while
<b>3associates</b>, <b>John Smith</b> and
<b>Bus-Partner</b> are not. Finally, an i-bay cannot use the
same name as an existing user or group account. It must be unique. Note that
there are two special names, <i>primary</i> and
<i>public</i>, which are in use by the system and cannot be used
for an i-bay name.
</p></td></tr></table><img src="images/ibays.jpg" alt="I-bays web panel"><p><a name="ibaydirs"></a>14.1. i-bay Directories<p>

Each i-bay has three directories - html,
files and
cgi-bin. Each directory is briefly outlined below:
</p><ul type="disc"><li><p><b>cgi-bin:</b> This directory is set aside
to hold &quot;CGI scripts&quot; used for that i-bay's web pages.  CGI scripts are
tools used in advanced web site creation and are not discussed here.</p></li><li><p>
<b>files:</b>

This directory holds files that can be accessed either locally only
or publicly. It can be used for such things as a company download site,
a company-wide file sharing server, or a document sharing site for a specific
customer.  When someone connects to the i-bay using FTP, they will see the
files in this directory.
</p></li><li><p>
<b>html:</b>
When an i-bay is accessed using a web browser (via http), the user
will enter the html directory and the web browser will automatically open
the index file (usually index.html or
index.htm) in that i-bay. In other words, it will display the
web page associated with that i-bay. This means you can have different
web sites running on your server, each associated with
a specific i-bay. This can be very powerful and useful, as you will see
in the upcoming examples.
</p></li></ul><p>Generally, you can think of the html directory as
the place to put all files, images and documents that you would like to be
accessible through the <i>web</i>.  The files

directory is for all files that you want people to access through FTP or
regular file sharing.  Note that you can have as many subdirectories as you
wish underneath either html or
files but you cannot create additional directories at the
top level of the i-bay.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2823700"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>If an i-bay is set for <i>no public access via web or
anonymous ftp</i>, users connecting to the i-bay through Windows or
Macintosh file sharing will see only the contents of the
files directory. However, if the i-bay settings are
later changed to <i>allow</i> public access through web or
anonymous ftp, users will then see the top-level directory of the i-bay with
the three subdirectories of html, files

 and cgi-bin. The items they were used to
seeing before will now be found in the files directory.
</p></td></tr></table><a name="ibayaccess"></a>14.2. Accessing the i-bays<p>
You can access the contents
of an i-bay using a web browser, Windows file sharing / AppleTalk, or FTP.
</p><ul type="disc"><li><p>
<b>accessing an i-bay
using a web browser (via http):</b> To view an i-bay using a browser, enter
&quot;www.yourdomain.xxx/i-bayname&quot;. For example, the URL for Samson's Farms
i-bay is &quot;www.tofu-dog.com/samfarms&quot;. Assuming you are entitled to access
this i-bay, you will see the index.html page in the html directory in
the Samson's Farms i-bay. If a password is required to see the contents
of the i-bay, a password dialog box will appear before the contents of
the i-bay are served to the web browser.

</p></li><li><p>
<b>accessing an i-bay
via Windows file sharing and AppleTalk:</b> To access the i-bay using Windows
file sharing or AppleTalk, simply navigate to the server over your
network browser (in Windows, this would be via &quot;Network Neighborhood&quot;) and select the i-bay you want to enter from those appearing.
You can only access an i-bay in this way if you are on the local network.
</p></li><li><p>
<b>accessing an i-bay via the FTP server:</b> To access
the i-bay using FTP, you use your FTP client to connect to your server and
use the <i>i-bay name</i> as the login id.  If the i-bay
requires a password, you will need to enter the <i>i-bay password</i>
as well.  If you are using a
command-line or graphical FTP client, you will usually be prompted for the
login username and password.  If you are using a web browser, you will need to
enter a FTP URL.  This will be in one of the following forms, depending on
whether or not a password is required:
</p><table border="0" bgcolor="#E0E0E0" width="90%"><tr><td><pre class="programlisting">

   ftp://<i>ibayname</i>@ftp.<i>domainname</i>
   ftp://<i>ibayname</i>:<i>password</i>@ftp.<i>domainname</i>
</pre></td></tr></table><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2823887"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p>Be aware that FTP transmits all passwords in the clear

<b>without encryption</b> and can therefore
be a security risk. If you are concerned about security, we suggest you
consider the scp &quot;secure copy&quot; command associated with
<a href="#ssh" title="10.2.1. ssh">ssh</a> as an alternative to FTP.</p></td></tr></table><p>Note that users accessing the i-bay via FTP in this manner are
not able to <i>upload</i> files to the i-bay. They can only
<i>download</i> files from the i-bay to their client.

</p><p>It <i>is</i> possible to upload files using FTP, but to do
so you must login to the server with a valid user name, <i>not</i>
the i-bay name. That user account must be a member of the group that has
been given write permission for the i-bay (configured on the i-bay screen).
You would then change to the i-bay directory (using the
ftp command &quot;cd ../../ibays/ibayname&quot;).
You will now be able to upload files from your FTP client to the appropriate
directories.
</p></li></ul><p>
In the next few sections, we will take a look at some examples
of i-bays that have been created by our hypothetical catering and event-planning
company, The Pagan Vegan, to demonstrate their capabilities.
</p><a name="ibaycreation"></a>14.3. Creating an i-bay<p>No matter how you are going to use an i-bay, the process of creating an
i-bay starts by clicking on the &quot;Click here&quot; link at the top of the
Information Bays panel in the server manager.  You will be presented with the
form shown in the image below.
</p><img src="images/create_new_ibay.jpg" alt="Creating a new i-bay"><p>You now need to fill out the form providing the information and making
the choices described below. Note that the ftp access described below can be
overridden by the <b>FTP access limits</b> setting
on the <a href="#admin-remoteaccess" title="10.2. Remote Access">Remote access</a> panel of the
server manager. If you choose to &quot;Disable public FTP access&quot; there, ftp
access for individual i-bays will <i>not</i> be allowed, even
though you <i>will</i> appear to be able to enable it from the
i-bay configuration screen.

</p><ul type="disc"><li><p><b>Information bay name: </b>This is the short name of
the i-bay (subject to the 12-character length restriction mentioned earlier).
The i-bay name will be what users will
enter in the URL after the hostname to access the i-bay from the web. For
instance, if public access is enabled, an i-bay named 'intranet' can be
accessed by the Pagan Vegan staff at 'http://www.tofu-dog.com/intranet/'.
</p></li><li><p><b>Brief description: </b>This text will
appear in various administrative screens and can be a useful reminder of the
i-bay content.
</p></li><li><p><b>Group: </b>Ownership of the i-bay content
is assigned to an existing group. The group ownership plays a role in the next
setting for user access.
</p></li><li><p><b>User access: </b>You need to decide who
will be able to add and modify content in the i-bay and who will be able to
read the content.
</p></li><li><p><b>Public access: </b>Here you set what type
of public access you wish to have for the i-bay. If the i-bay is just to be
used by a small group of users, you can leave public access set to the default
of <i>None</i>.  If you want others to be able to access the
i-bay via web or anonymous ftp, you can choose to allow access to just the
local network or the wider Internet. You also can choose whether or not you
wish to require a password.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2823294"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>If you choose one of the modes of <i>Public access via
web or anonymous ftp</i> that requires a password, public access will
not be available until you set the i-bay password from the main information bay
panel in the server manager. Once you do so, users can access the i-bay
through their web browser or ftp by using the <i>i-bay name

</i> and <i>i-bay password</i>, rather
than their own user name and password.
</p></td></tr></table></li><li><p><b>Execution of CGI scripts: </b>If you want
to use CGI scripts to add functionality to your web site, you can execute
those scripts from the cgi-bin directory of your i-bay.
However, for security reasons you must first choose <i>enabled
</i> here to allow such scripts to be executed.
</p></li></ul><p>Once done filling out the form, click the <i>Create</i>
button and the server manager will create your i-bay. If you wish to change
these settings at any later point, you can click on <i>Modify...

</i> next to the i-bay name in the information bays panel of the
server manager.
</p><a name="ibaymodify"></a>14.4. Modifying an i-bay<p>At any point in time you can modify the attributes of an i-bay (except
for its name) by clicking on the &quot;<i>Modify...</i>&quot; link next to
the i-bay name on the &quot;Information bays&quot; panel of the server manager. For instance, you
can easily change the description, group ownership, and access methods.
</p><p>There are, however, a few items to be aware of when modifying i-bays:
</p><ul type="disc"><li><p>If an i-bay is set for <i>no public access via web or
anonymous ftp</i>, users connecting to the i-bay through Windows or
Macintosh file sharing will see only the contents of the
files directory. However, if the i-bay settings are
later changed to <i>allow</i> public access through web or
anonymous ftp, users connecting through file sharing will then see the
top-level directory of the i-bay with
the three subdirectories of html, files

 and cgi-bin. The items they were used to
seeing before will now be found in the files directory.
This may disrupt Windows shortcuts and configuration settings. (The good
news is that simply changing the public access setting back to &quot;None&quot; will
return i-bay file sharing access to its previous configuration.)
</p></li><li><p>After an i-bay is modified, all Macintosh users will
be disconnected from the i-bay and will need to reconnect. All Macintosh
users will receive an alert stating that they will be disconnected in
5 minutes.</p></li></ul><p>Outside of those concerns, you can modify the i-bay as often as you
wish. If you wish to change the actual <i>name</i> of the i-bay,
you will need to remove the i-bay and create it again. (Note that this will
delete the <i>contents</i> of the i-bay, so make sure you have
backed up the i-bay data before you remove it.)

</p><a name="ibaycustsite"></a>14.5. An i-bay Used as a Customer Site: The Miles Gabriel Art
Exposition<p>
&quot;The Pagan Vegan&quot; (TPV)
has found that customers like having access to a customized web page which
summarizes all of the information pertaining to their particular event.
The company finds it reduces the risk of miscommunication and improves
its image and reputation. The &quot;.html&quot; files in the i-bay's html directory
are based on a template that TPV uses for each customer. Creating each
web site is a straightforward, fill-in-the-blanks process.
</p><img src="images/tpv_mgabriel_ibay.jpg" alt="Creating the Mgabriel i-bay"><p>
TPV has chosen a naming
convention for i-bays that customers can easily remember - first initial,
last name. Because it contains important customer information, only the
site administrator can save files into this i-bay. To prevent others from
accessing the customer's i-bay, a password is required to enter the site.
(TPV created individual passwords and securely provided them to their customers.)
</p><img src="images/tpv_mgabriel.jpg" alt="The results of the Mgabriel i-bay"><p>
Miles Gabriel has contacted
The Pagan Vegan to cater an art exposition. The Pagan Vegan has created
an i-bay specifically for Mr. Gabriel's account called &quot;mgabriel&quot;. Mr.
Gabriel accesses the site with the URL <b>www.tofu-dog.com/mgabriel</b>.
As you can see, Mr. Gabriel has access to a summary of his event information.
He can check at any time to ensure the arrangements are correct. For example,
at midnight tonight he can access his i-bay to show his spouse the design
used for his invitations!
</p><a name="ibayshareddrive"></a>14.6.  An i-bay Used as a Shared Network Drive<p>

Having a shared network
drive can be very helpful as a way of storing and sharing documents company-wide.
TPV uses an i-bay for a company-wide network drive to hold documents to
which all employees should have access. All employees can read and write
files to this directory.
</p><p>
The i-bay is accessed
via Windows file sharing, AppleTalk or FTP. To access using file sharing,
simply access the server over the network (via Network
Neighborhood) and open the appropriate i-bay .
You will see the files located in the files
directory and can then open them or copy them to your system.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2824711"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>This is only true if the i-bay has been set to allow public access
via web or anonymous ftp. If an i-bay is set for <i>no public access via web or
anonymous ftp</i>, users connecting to the i-bay through Windows or
Macintosh file sharing will simply see the <i>contents</i> of the
files directory. However, if the i-bay settings are
later changed to <i>allow</i> public access through web or
anonymous ftp, users will then see the top-level directory of the i-bay with
the three subdirectories of html, files

 and cgi-bin. The items they were used to
seeing before will now be found in the files directory.
</p></td></tr></table><p>As an example, when the staff of The Pagan Vegan goes into their Network
Neighborhood, they double-click on &quot;E-smith-server&quot; as shown in:
</p><img src="images/windows_network_neighborhood.jpg" alt="A view of Windows Network Neighborhood"><p>They will then see a list of i-bays accessible through Windows file
sharing.  When they click on one of them called &quot;sharedfiles&quot;, they see the
three folders inside of the i-bay:
</p><img src="images/windows_sharedfiles_ibay.jpg"><p>When they go inside of files, they will then see
the list of documents provided there:

</p><img src="images/windows_ibay_files.jpg" alt="A view of an i-bay through Network Neighborhood"><p>
As you can see in this
example, The Pagan Vegan has several files in this directory for company
use. Providing a centralized location for company documents (such as expense report templates) ensures that everyone always has access
to these documents and uses the most up-to-date version.
</p><a name="ibayintranet"></a>14.7.  An i-bay Used as an Intranet: The Pagan Vegan &quot;Vegemite&quot;<p>
The Pagan Vegan has
created an i-bay for its company newsletter / intranet. The company has
found this to be a good way for employees to express themselves and share
information.
</p><img src="images/tpv_create_intranet.jpg" alt="Creating an intranet i-bay"><p>
In keeping with TPV's
culture, the newsletter is very casual. The company has a high degree of
trust in its employees, and, as a result, employees are given full access
to the contents of the intranet so anyone on staff can revise it. A more
typical company might want the intranet to be created by a particular staff
member and &quot;checked in&quot; by the administrator (write access &quot;administrator
only&quot;).
</p><p>
The intranet is, of
course, viewable only from the internal network. No password is required.
To access the intranet, TPV employees use their web browsers to access
the URL <b>www.tofu-dog.com/intranet</b>.

</p><img src="images/tpv_vegemite.jpg" alt="The Vegemite intranet newsletter"><p>
This particular newsletter
was created using a desktop office application called StarOffice (similar
to Microsoft Office). The files were created as typical word processing
documents, saved into &quot;.html&quot; format and then transferred into the html
directory of the &quot;intranet&quot; i-bay using Windows file sharing. Starting with
just a blank document, it took only
about an hour to create the main page and the other pages that make up this
newsletter.
</p><a name="ibayprocess"></a>14.8.  An i-bay Used to Expedite Processes: Samson's Farms<p>
Samson's Organic Farms
delivers fresh produce to The Pagan Vegan every week. Samson's and TPV
use an i-bay to improve the ordering and delivery process. TPV has created
an i-bay for Samson's called &quot;samfarms&quot;. It is accessible to the external
Internet but password-protected so that only staff at TPV and Samson's
Farms can read it. Anyone on TPV's local network can write to it.
</p><img src="images/tpv_create_samfarms.jpg" alt="Creating the Samson's Farms i-bay"><p>
<b>Here's how the process
works:</b>
</p><ul type="disc"><li><p>

 Each week, Mr. Samson
updates his online order sheet to include only produce that will be ripe
and ready for the next delivery date. He saves it in &quot;.html&quot; format and
e-mails it to The Pagan Vegan's administrator.
</p></li><li><p>
 Upon receiving the
e-mail, TPV's administrator saves the file directly into the html directory
of the &quot;samfarms&quot; i-bay.
</p></li><li><p>
 The chef accesses
the samfarms i-bay, reviews what produce will be available, and plans menus.
</p></li><li><p>
 The chef's assistant
then reviews the menus, checks against existing inventory and determines
what should be ordered. The assistant enters TPV's order directly onto
the order sheet in the samfarms i-bay using an HTML editor.

</p></li><li><p>
 The day before delivery,
the chef reviews his assistant's order (as shown in the image below) using a web browser and makes any
last minute adjustments.
</p><img src="images/tpv_samfarms.jpg" alt="The resulting samfarms i-bay"></li><li><p>
 On the day of delivery,
Samson's shipping staff accesses the i-bay over the Internet, prints out
TPV's order from the samfarms i-bay, and fills it.
</p></li></ul><a name="ibaycustdownload"></a>14.9. An i-bay Used as Your Customer Download Site<p>
When customers hire
The Pagan Vegan to plan events, they need to review a great deal of information
- menu options, catalogues from various vendors for event stationary, table-setting
rentals, etc. Often customers want several days to review it all. TPV has
only a limited number of catalogues for loan, so it decided to provide
customers with access to this information online. To accomplish this, TPV
created a download i-bay, called &quot;menus&quot;, where customers can download
the catalogue files themselves and view the contents on their desktop machines.
</p><img src="images/tpv_create_menus.jpg" alt="Creating the i-bay for menus"><p>
TPV set the i-bay for
Administrator-only write access, viewable over the entire Internet, with
no password required. A customer accesses the site using the FTP client
in their web browser to login as the i-bay user name by entering the URL
<b>ftp://menus@ftp.tofu-dog.com</b>.
This is what the customer sees:
</p><img src="images/tpv_menus_ftp.jpg" alt="Viewing the menus i-bay via ftp"><p>
When the cursor is placed
over a file name, the full name of the file appears. To download a particular
file, the customer simply clicks on the file name. A browser window allows
the customer to select a destination directory for the file on his or her
local hard drive.

</p><br><hr width="100" align="left"><p>[<a name="ftn.id2823272" href="#id2823272">4</a>] This 12-character restriction ensures that the i-bay
can be shared correctly to all Windows machines.</p><a name="filestorage"></a>Chapter 15. User File Storage on the SME Server<p><b>Table of Contents</b></p>15.1. <a href="#filestorage-win">Windows</a>15.2. <a href="#filestorage-mac">Macintosh OS</a><p>
When you
create a user account on your server, this not only creates an e-mail account but also
a file directory for that user. This directory is set aside for files that
the user would like to store on the server hard drive.
It can only be accessed by the user. To access the directory, the user would
naviagate to the server via Windows file sharing or
AppleTalk.
</p><a name="filestorage-win"></a>15.1. Windows<p>
For example, in Windows the user would open &quot;Network
Neighborhood&quot;. In the Network directory, you will see all machines accessible
to you on your network. The server should be one of
them. If it isn't viewable, you may not be logged onto your network under
the correct name/password (see the section below on this) or your machine may
not be in the same workgroup as the server.

</p><img src="images/windows_network_neighborhood.jpg" alt="Windows Network Neighborhood"><p>
When you click on the
server, you will see all i-bays and directories available to you.
You will also see the Primary directory (which houses the company web page
information). In the example below, Kate Hedges is logged onto her local
network as khedges (her account name) with her correct password. When she
enters the server, she can see all the i-bays (mgabriel, samfarms,
sharedfiles, menus and intranet), as well as her own user directory.
</p><img src="images/tpv_windows_ibays.jpg" alt="A group of i-bays seen through Network Neighborhood"><p>
By clicking on her own
user directory, &quot;khedges&quot;, she can see all of the work and personal files
she has chosen to store on the server, as shown in the image below.
</p><img src="images/khedges_ibay.jpg" alt="A view inside of an i-bay"><a name="id2824380"></a><table border="1"><tr><td><p class="title"><b></b></p><p>
Note that for users
who are on a Windows network, the user must be logged onto the network
with the name and password associated with the server
user account.
</p><p>
To do so, open the &quot;Start&quot;
menu.
</p><ul type="disc"><li><p>
 Select &quot;Shut down&quot;.

</p></li><li><p>
 Select &quot;Close all
programs and log in as a new user&quot;.
</p></li><li><p>
 Enter the username
(in our example, above, it would be &quot;khedges&quot;)
</p></li><li><p>
 Enter the current
password for that user on the server.
</p></li></ul><p>
If you change the password
on your server, you must also change the password for
&quot;admin&quot; on your PC. To do this:

</p><ul type="disc"><li><p>
 Use the File Manager
to search for the file &quot;admin.pwl&quot;.
</p></li><li><p>
 Delete this file and
simply log into Windows networking as above.
</p></li></ul></td></tr></table><a name="filestorage-mac"></a>15.2. Macintosh OS<p>
To use file sharing from a Macintosh computer, you will need to be set
up to use AppleTalk over Ethernet, and to communicate using TCP/IP over
Ethernet.
</p><p>
The first step is to choose your Ethernet adapter (usually &quot;Built-in
Ethernet&quot; or just &quot;Ethernet&quot;) from the AppleTalk Control Panel.  If
everything is plugged in correctly, the panel should quickly say that no
zones were found.  If this takes a while, the network cable or network
card may not be working properly, and you should see an Apple
technician.

</p><p>
To use AppleTalk over TCP/IP it is best that your Mac's network settings
are configured via DHCP.  The server provides this
service, but it must be enabled via the server manager.
To enable it on your Mac, choose &quot;DHCP Server&quot; in the TCP/IP
control panel.  If the control panel asks for a Client ID, simply type
in any unique title, such as &quot;Design G4&quot; or &quot;Reception&quot;.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2825620"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>
AppleTalk will work without TCP/IP, but will be slower than
AppleTalk over TCP/IP.
</p></td></tr></table><p>
The next step is to choose a server to connect to via AppleTalk.  Click
on the Chooser icon in your Apple Menu to bring up a list of file
servers to connect to.
</p><img src="images/mac_chooser.jpg" alt="The Macintosh Chooser"><p>
Double clicking on the server will bring up a list of all the volumes
available for you to connect to, whether or not you have sufficient
privileges to use them.  Your screen should now look like the following
picture.

</p><img src="images/mac_volumes_chosen.jpg" alt="Choosing a volume through the Chooser"><p>
The &quot;Primary&quot; volume is your default area set up by your server for sharing
files and the company web site, while &quot;Home directory&quot; points to the
specific user's own space on the server, viewable only by that user.
While other i-bays may appear, you may not be able to use them, as you
must be a member of the group owning that i-bay to use it.
</p><p>
The highlighted volumes are those you wish to connect to.  Any ticked
volumes will attempt to mount every time you boot your Mac.  If you wish
to save passwords in a keychain (Mac OS 9.0 or above), you should read
the tutorial available from the help menu on your Mac.
</p><p>
Once you have chosen your volumes to mount, whether or not they are
ticked, a dialog box will appear to allow you to log in.
</p><img src="images/mac_login.jpg" alt="Logging in via a Macintosh"><p>
Use your server user name and password to connect.  This screen will
pop up only once, as the information typed in will be used for every
subsequent login.  This includes clicking on the Chooser, your server,
and then other volumes to mount them as well.
</p><p>
Your desktop should now have icons for each successful volume, such as
the icons below:
</p><img src="images/mac_home_icon.jpg" alt="A Macintosh network drive icon from MacOS 8.5 on"><p>MacOS 8.5 or above</p><img src="images/mac_primary_icon.jpg" alt="A Macintosh network drive icon from MacOS 7.5 to 8.1"><p>MacOS 7.5 to 8.1</p><p>

Notice the wire at the bottom of the icon, denoting a network volume.
</p><p>
Clicking on one of these icons should show you a window similar to the
one below.  While you should not be able to add files or folders to this
window, you may do so in the files,
html or cgi-bin folders (permissions
allowing).
</p><img src="images/mac_folders_copy.jpg" alt="A view of i-bay folders on the Macintosh"><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2825994"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>
Some programs may not work well if run from the
server.  Programs such as MYOB (multi-user accounting software)
rely on certain specific nuances to share the same file with multiple
other Macs.  Test your applications with multiple users before relying
on them in this situation.
</p></td></tr></table><a name="webmail"></a>Chapter 16. Webmail<p><b>Table of Contents</b></p>16.1. <a href="#webmail-enabling">Enabling Webmail On Your System</a>16.2. <a href="#webmail-start">Starting Webmail</a>16.3. <a href="#webmail-login">Logging In</a>16.4. <a href="#webmail-inbox">Viewing The Inbox</a>16.5. <a href="#webmail-logout">Logging Out of Webmail</a>16.6. <a href="#webmail-compose">Composing Messages</a>16.7. <a href="#webmail-reading">Reading Messages</a>16.8. <a href="#webmail-deleting">Deleting Messages</a>16.9. <a href="#webmail-contacts">Using Contacts</a>16.10. <a href="#webmail-prefs">Changing Webmail Preferences</a><p>If you wish, you can configure your SME Server so that users can access their e-mail via a web interface. Once webmail is enabled, users will be able to access their e-mail from the local network or anywhere in the world via the Internet using any standard web browser (provided it supports Javascript and
tables, which almost all browsers do).

</p><p>For added security, the server supports the use of
<i>Secure Socket Layer (SSL)</i> connections.  When your users
connect using SSL, all communication between their browser and your web server
is securely encrypted to prevent eavesdropping.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2825541"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>The specific program we use for webmail is the
<i>Internet Messaging Program (IMP)</i>. If you would like more
information about IMP, you can visit the project web site at:
<a href="http://www.horde.org/imp/" target="_top">http://www.horde.org/imp/</a>
</p></td></tr></table><p>If you intend to enable webmail, you should consider whether your
users will use webmail exclusively or will use webmail part of the time (for example, when travelling) and
a regular e-mail client the rest of the time.  If they plan to use webmail and another client, they should make sure that the other client uses
the IMAP protocol.  If they use POP3, their e-mail messages will be pulled down
from the server into their local e-mail client and will therefore not be
visible when the user logs into webmail.  If IMAP is enabled on the local client,
the messages will remain on the server and will be visible both from the local
client and via webmail.  (For more information on IMAP and POP3, read the
<a href="#imappop3" title="8.3.  IMAP versus POP3 e-mail">earlier section in Chapter 7</a>.)
</p><p>A second issue is that using webmail <i>will </i> affect
the performance of your server.  We recommend that you evaluate your server hardware if you plan to use webmail.
(Note that webmail can always be <i>disabled </i> later if you
find that your system is not performing well.)

</p><a name="webmail-enabling"></a>16.1. Enabling Webmail On Your System<p>Because the use of webmail can be resource-intensive, the server
ships with webmail <i>disabled </i> by
default. To enable the use of webmail, perform the
following steps:</p><ol type="1"><li><p>Connect to the server manager and login as the admin user.</p></li><li><p>Click on <a href="#admin-otheremailsettings" title="11.7. Other E-mail Settings">Other e-mail settings</a> and scroll down to the section where you have the option to
<i>Enable/Disable Webmail</i>. You now have two options:
</p><ul type="disc"><li><p>
<b>Enabled (secure HTTPS access only)</b> - Allows
 users to connect <i>only </i> through a secure SSL
connection. This is <b>strongly </b>recommended
because a regular HTTP connection transmits your mail account password across
the network (or Internet) in plain, unencrypted text.

</p></li><li><p>
<b>Enabled (HTTP or HTTPS)</b> - Allows your users
to connect through a secure or an insecure web connection.
</p></li></ul></li></ol><p>After you perform these steps, your users should be able to
connect and use webmail.</p><a name="webmail-start"></a>16.2. Starting Webmail<p>To use webmail, a user first needs a valid user account
and password on your server. Next, the user opens up a web browser and
points it to your server using an address resembling the
following URL:</p><table border="0" bgcolor="#E0E0E0" width="90%"><tr><td><pre class="programlisting">
     https://www.tofu-dog.com/webmail/
</pre></td></tr></table><p>The <b>https
</b> in the URL indicates this connection uses SSL encryption and
provides a secure communication session.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2826278"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>The exact address used in the URL will depend on how you have configured
your server. In the example above, <i>www.tofu-dog.com

</i> points to the server located at The Pagan
Vegan and <i>https</i> indicates that they are using secure
communication using SSL encryption. If you choose to provide insecure access,
which we do <i>not</i> recommend, the URL would begin with
<i>http</i> instead of <i>https</i>. You will
need to provide your users with whatever URL will get them to
your server.
</p></td></tr></table><p>Note that if your server is behind another firewall, that firewall will
need to allow traffic through on TCP port 443 in order for SSL connections to
take place.
</p><a name="webmail-login"></a>16.3. Logging In<p>Once connected, a user will immediately be confronted with a login
screen similar to that shown in the screen below.
From this screen you can read the help menu (by clicking on the link for <i>New
User Introduction </i>at the top of the page) or login with your
normal network user ID and password. Note that IMP supports a wide variety of
languages for users for whom English is not their native language. (Or
who have some desire to have menus in a different language!)</p><img src="images/webmail_login.jpg" alt="Webmail login"><a name="webmail-inbox"></a>16.4. Viewing The Inbox<p>Once logged in, you will see your inbox, as shown in screen below.</p><img src="images/webmail_inbox1.jpg" alt="Webmail inbox"><p>Let's take a quick tour of the Inbox window.</p><blockquote class="blockquote"><p><b>In the top left corner</b> is a pop-up
menu that shows the list of your available mail folders. In your first
webmail session, the only folder choice will be <i>INBOX</i>. As soon as you
send an e-mail message, a folder called <i>sent-mail </i>will be
created and available in the menu.  You can also
create additional mail folders at any time.

</p><p><b>In the top center</b> portion of the window is a status message
indicating the folder you are in and the number of new or recent messages
in that folder.</p><p><b>On the left side</b> is a navigation menu
allowing you to compose new messages, modify contacts, create folders, modify preferences
or logout of the webmail system.</p><p><b>In the main part of the window</b> are
the actual messages. Each message has an icon denoting its status at the far
left, the date/time of the message, who it is from, the subject and the size.
Messages may be sorted by clicking on the column heading. You can read a
message simply by clicking on the subject or sender of a specific message. The
envelope/arrow icon that you can see in the status area of the second message
in the image above indicates that this message is new.
</p></blockquote><p>We will describe the various functions in greater detail later in this chapter,
but this should be enough to get you started.</p><a name="webmail-logout"></a>16.5. Logging Out of Webmail<p>Before we discuss the features of webmail, it is important to emphasize
that you must <b>always </b>click on the
<i>Logout</i> menu item when you are finished using webmail. If
you do <i>not</i> do so, anyone else who uses your web browser
on your computer (until you exit your web browser or logout of/shutdown your computer)
will be able to read your messages and send messages from your account.
After a successful logout,
you will see the webmail login screen with a message at the top of
the screen indicating that your logout was successful.</p><a name="webmail-compose"></a>16.6. Composing Messages<p>To compose a new message, click on <i>Compose

</i> in the menu on the left. You should see a screen similar to that
below.</p><img src="images/webmail_compose1.jpg" alt="Composing a message in webmail"><p>At the top of the compose screen, your available options include the ability to spell-check
the message in your language of choice, or to cancel, save a draft or send the message.
</p><p><b>If you choose to save a draft, </b> your
message will be saved in a folder called <i>drafts </i>. You may
later retrieve this message by using the popup menu in the upper left corner
to switch to the &quot;drafts&quot; folder.
</p><p>Below that are the familiar e-mail fields for you to fill out.
At the bottom of the page, the menu of commands is repeated
for your convenience.
</p><a name="webmail-reading"></a>16.7. Reading Messages<p>To read a message, click on the <i>From </i>
or <i>Subject </i> fields of the message. You should see a
screen similar to the one below.</p><img src="images/webmail_read1.jpg" alt="Reading a message in webmail"><p>

You now have several options. You can:
</p><ul type="disc"><li><p><b>Delete </b>the message.
</p></li><li><p><b>Reply </b>only to the sender.
</p></li><li><p><b>Reply to all </b>of the original
recipients.
</p></li><li><p><b>Forward </b> the message to someone else.
</p></li><li><p><b>Bounce </b>the message to another person (similar to
&quot;Forward&quot; but without providing you the opportunity to comment).
[<a name="id2826821" href="#ftn.id2826821">5</a>]

</p></li><li><p><b>Save As </b> - save the message to a text
file.
</p></li></ul><p>By clicking on the <i>Reply </i> button, you will be able
to enter a reply window such as that shown below. Notice that the
original message text is &quot;quoted&quot; with a &quot;&gt;&quot; character in front of it. At
this point, you can type more text or edit existing text, add or delete
recipients, spell-check the message and do anything else that you could do in
a normal compose window.  Again, you can choose to cancel the message,
save a draft or send the message.
</p><img src="images/webmail_reply1.jpg" alt="Replying to a message in webmail"><a name="webmail-deleting"></a>16.8. Deleting Messages<p>You can delete a message while reading it, as mentioned previously, or
you can delete a message - or a group of messages - from the Inbox view.</p><img src="images/webmail_inbox2.jpg" alt="Another view of the webmail inbox"><p>To do so, check the box next to each message you wish to delete.
After that, press the <i>Delete </i> text button directly above or
below the list of messages on the left side.  You will now see a trash icon next to the
checkbox and a line through the messages.

</p><p>
As an example, in the image above,
our user (ffrog) wants to delete the second and third messages. He can click
on the checkbox next to each message and then click <i>Delete
</i>. This will produce
a screen such as that below.
</p><img src="images/webmail_delete1.jpg" alt="Deleting messages in webmail"><p>
If you do not want to see the deleted messages, you have two choices. If you
click on the <b>Hide Deleted </b>text button on
the right side, the messages will be hidden from view, but will still be there
and could be recovered with the <i>Undelete </i> button. If you
choose <b>Expunge</b>, the messages will be
permanently deleted.
</p><a name="webmail-contacts"></a>16.9. Using Contacts<p>The server webmail system provides two means of keeping track of e-mail
addresses. First, you can have your own <i>Contacts </i> list.
Second, you can easily access the company directory that lists all users and groups that have been created.</p><p>You can view and edit your contacts through two menu choices. From the
left menu you can choose <i>Contacts </i>. This allows you to view or edit contacts, but does <i>not </i>allow you to add a contact to
an e-mail list. To add a contact, you must open the Contacts window
from the &quot;Contacts&quot; link in a Compose window, as highlighted in the image below.

</p><img src="images/webmail_contacts_compose.jpg" alt="Using the Contacts in the webmail compose window"><p>In either case, you will find yourself viewing a window that looks like
the one below.
</p><img src="images/webmail_contacts1.jpg" alt="Webmail contacts"><p>If this is the first time you have entered the Contacts window, you will
not see anything next to the &quot;Select&quot; button. Normally, though, you will see
a pop-up menu with all of your contacts in it (as seen in the window above
where &quot;bob &lt;bbass@e-smith.com&gt;&quot; appears).  To enter a new contact,
simply type the e-mail address, a &quot;nickname&quot; that will appear in the
Contacts list, and the full name of the person.  You must fill out all three
fields. Then click <i>Add Contact</i>.
</p><p>To update a contact's information, select the user's
name/address from the contacts pop-up menu. The information should
automatically appear in the fields. (If it does not, after selecting the entry from the pop-up menu, press the <i>Select
</i> button next to the menu.) Enter the new information and click <i>Update Contact </i>. In a similar fashion you can delete a
contact by selecting the contact from the pop-up menu and pressing the

<i>Delete Contact </i> button.
</p><p>As mentioned earlier, if you entered the Contacts window from the link
in the Compose window, the three buttons -
<i>Insert into To:</i>,
<i>Insert into Cc:</i>, and
<i>Insert into Bcc:</i> - will allow you to transfer the contact
information directly into the Compose window.
</p><p>To search the company directory, use the lower section of the
Contacts window labeled <i>LDAP Search</i>[<a name="id2827447" href="#ftn.id2827447">6</a>].
You have the ability to search either the entire name field
or just the surname. Enter the text you are searching for in the
entry box and choose how you want to compare the text against the directory.
The default is to search for entries where the name <b>

is </b> the text you enter, which requires an exact match. You may find
it more useful to search for entries where the name <b>
contains </b> the search text.  A search with &quot;contains&quot; will find
names where the search text appears <i>somewhere </i> in the
name.
</p><p>After entering your text and choosing your search options, press
the <i>Start Search </i> button to query the directory. As shown
in the screen below, your results will be returned in a new <i>LDAP
Results </i> section of the same Contacts window.  As with the section
at the top of the screen, you choose your entry from the pop-up menu (or press
the <i>Select </i> button if your entry is displayed already)
and the information should appear in the entry box below.  Assuming you
entered Contacts from the link in the Compose window, you can now insert this
information into the To, Cc or Bcc lines of the Compose window.

</p><p>
Note
that you also have the option of inserting this entry directly into your Contacts list. If you have a large company directory, you may find this a useful
way of ensuring that frequently used contacts are readily available.
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2827531"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Unlike your local Contacts list, you cannot directly update entries
that are in the company directory. Instead, those entries must be updated by
the system administrator using the <i>Directory </i>panel in the
server manager.  See the <a href="#admin-directory" title="11.3. Directory">Directory section
</a> of Chapter 11 for more information.
</p></td></tr></table><img src="images/webmail_contacts-ldap.jpg" alt="Using Contacts with the LDAP directory"><a name="webmail-prefs"></a>16.10. Changing Webmail Preferences<p>By clicking on the <i>Preferences </i>link on the
navigation menu, you can modify preferences for your webmail
session, as shown in the screen below.
</p><img src="images/webmail_prefs.jpg" alt="Webmail preferences"><p>You have four preferences you can configure:
</p><ul type="disc"><li><p><b>Signature</b> - You may include any text
that you wish to appear by default at the bottom of your e-mail messages. Once
configured, it will <i>always </i>appear at the bottom of a
Compose or Reply window when you enter that window. You can, however,
delete it for a specific message simply by editing the text in the Compose or
Reply text window.

</p></li><li><p><b>Full Name</b> - If you leave this blank, all of your messages will appear to recipients as having come from your e-mail address.  If you enter text here, recipients will
usually see that text first instead of your e-mail address.
</p></li><li><p><b>From Address</b> - By default your From
address is your regular system e-mail. <b>You do
not need to set it here.</b> Enter an address here only if you want
people to see a different reply address than your normal system-generated
e-mail address.
</p></li><li><p><b>Preferred Language</b> - This allows you to specify the
language used in the menus.
</p></li></ul><p>When you are done modifying your preferences, press the <i>Save
Preferences </i>button at the bottom of the page.</p><br><hr width="100" align="left"><p>[<a name="ftn.id2826821" href="#id2826821">5</a>] In fact, the bounce command will send the message on to a third-party
without indicating that you were the one forwarding it.  So if &quot;ffrog&quot; sent a
message to the &quot;sales&quot; group (of which you are a member) and you then bounced it to
another user, that user would see the message coming from &quot;ffrog&quot; and going to

&quot;sales&quot;, but <i>your </i> name would not appear anywhere in the
visible headers. Compare that to a &quot;forward&quot; command where the recipient knows you
are the person forwarding the message.
</p><p>[<a name="ftn.id2827447" href="#id2827447">6</a>] The search is called an <i>LDAP search </i>because
the directory is queried using the <i>Lightweight Directory Access
Protocol (LDAP)</i>, one of the most common protocols used on the
Internet for searching directories.
</p><a name="addsoftware"></a>Chapter 17. Additional Software<p>In the process of developing the SME Server, we found it
necessary to include some additional open source software.
While Contribs.org does not provide direct technical support for this additional
software, its availability on the server may be of benefit to advanced
users.</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/warning.gif"></td><a name="id2825505"></a>Warning</tr><tr><td colspan="2" align="left" valign="top"><p><b>Use of this software is at your own
risk and should not be attempted unless you know what you are doing!
Contribs.org does NOT provide support for this software.</b>

</p></td></tr></table><b>MySQL</b><p>
MySQL is a free, open source database management system.  It provides a
fully functional relational database similar to that provided by many
commercial database vendors.  We use it here as the back-end for our
webmail application. More information about MySQL can be obtained at
<a href="http://www.mysql.com/" target="_top">http://www.mysql.com/</a>.
</p><b>PHP</b><p>
PHP is a web scripting language that has become popular because
it easily allows developers to create dynamically generated web pages.
Additionally, it includes commands that allow for easy interaction with
databases, particularly MySQL.  The PHP language resembles C or perl
and is actually embedded in the actual HTML pages on the web server.
If you are familiar with Microsoft's Active Server Pages, PHP works in
a similar manner.  We have installed it on the server because
it is needed as part of our webmail application.  To
learn how to use PHP in your own web pages, please read the PHP FAQ
at <a href="http://www.php.net/FAQ.php" target="_top">http://www.php.net/FAQ.php
</a> and the manual at <a href="http://www.php.net/manual/" target="_top">
http://www.php.net/manual/</a>.
</p><b>Procmail</b><p>
procmail is an open source mail processing tool that can run on the server to
preprocess incoming mail messages perform actions such as filtering them into
folders.  More information about procmail can be found at:

<a href="http://www.procmail.org/" target="_top">http://www.procmail.org/</a>.
Additionally, members of our developer community have contributed HOWTO documents
that show how to use procmail and many other packages on our server. See
<a href="http://no.longer.valid/modules/mylinks/" target="_top">http://no.longer.valid/modules/mylinks/</a>
for links to those documents.
</p><b>Taper</b><p>
taper is a open source tape backup program provided for those who wish
an alternative to the <i>flexbackup </i>program used by default
in the server manager.  More information about taper can be found at:
<a href="http://www.e-survey.net.au/taper/" target="_top">http://www.e-survey.net.au/taper/</a>.
</p><a name="app-ethernetlan"></a>Appendix A. Introduction to the Ethernet Local Area Network (LAN)<p>
A local area network (LAN) is the system of wires and other hardware that connects
the computers within your office and allows them to communicate with one
another. An ethernet LAN is the most common type. Ethernet refers both
to a kind of connection and to a protocol for how Internet data packets
travel around your network.
</p><p>
The <b>hub</b>, a common
component of an ethernet, serves as a point of interface between computers
on the network. Each computer on your network is connected to the hub using
an ethernet network cable. Different hubs operate at different speeds:
slower hubs, operating at 10 MB/sec, are suitable for small networks; faster
hubs, operating at 100 MB/sec, are suitable for larger networks. Switching
10/100 MB hubs can operate at either speed, and provide a good way to upgrade
your network gradually.

</p><p>
An <b>ethernet adapter</b>,
also called an ethernet card or network interface card (NIC), connects
each computer to the ethernet LAN. An server with a dedicated Internet connection requires two ethernet adapters;
one connects it to your LAN and the other connects it to the
external network that leads to your ISP. If your server
connects to your ISP using a modem or ISDN adapter, it only requires one ethernet adapter.
</p><p>
A <b>router</b> ensures
that Internet data packets (e.g. e-mail, web page information, etc.) reach
the appropriate computers on your network. Routing is one of the functions
performed by the server in server and gateway mode.
</p><img src="images/network5.jpg" alt="One way to connect an server to the Internet"><p>
Allowing a third party,
such as a systems integrator or networking company, to install your ethernet
can be a good idea. It can help you select, procure and install the appropriate
ethernet adapters, hub and cables. There are also various how-to guides
available in bookstores if you are committed to installing it on your own.
</p><a name="app-dyndns"></a>Appendix B. Dynamic DNS Services<p>
If your IP address is
assigned dynamically, you may find it helpful to use a dynamic DNS service.
A dynamic DNS service provides you with an automated way to notify them
whenever your IP address changes so that they can immediately publish new
DNS records for your domain. Without dynamic DNS, you would have to contact
your ISP to have them change your DNS records, and your web site and other
services would be unavailable for several days until the change was processed.
You can easily enable the usage of a dynamic DNS service by selecting it
on your server console.
</p><p>
A dynamic DNS service
can be a great solution when used with a dedicated connection. With a typical
dialup connection, your IP address changes much more frequently (possibly
every time your server connects) and, because the server
only connects intermittently, there is a delay in informing the dynamic
DNS service of the change. This means that the risk of misdirected information
is much greater with a dialup connection. For this reason, we recommend
and support the use of dynamic DNS services only for dedicated connections.
</p><p>

Contribs.org has tested
four dynamic DNS services, of which two are free services and two are
commercial services: yi.org (free), dyndns.com (commercial), tzo.com
(commercial) and dyndns.org (free). For simplicity, we have preprogrammed the
server to work with these services (including pre-installing their
client software). If you have arranged dynamic IP address assignment from
your ISP and you wish to use one of these services, all you need to do
is visit the appropriate web site to sign up for service,
and enable that particular function in the server console. In pre-configuring
the server for this particular service, we in no way
interfere with nor prevent you from using another dynamic DNS service if
you wish. To do so, however, would require some customized configuration
on your part.
</p><p>
Contribs.org has tested the
functionality of these services with our software. However, we accept no
liability for any breach of service on their part. A failure on the part
of your dynamic DNS service can result in your network becoming temporarily
unreachable from the Internet. During these times, your e-mail may be undeliverable.
</p><p>
If your IP address is
assigned dynamically and you intend to receive all your e-mail directly
(rather than having it stored at an ISP and retrieving it via POP or IMAP),
but you decide not to use a dynamic DNS service, you
should implement multidrop e-mail as your e-mail solution as this will ensure
that no e-mail is misdirected to another IP address <a href="#sidebar-multidrop">(See <i>Some important
notes on Service list D (multidrop mail)</i> in Chapter 3.)</a>
</p><table border="0"><tr><td rowspan="2" align="center" valign="top" width="25"><img src="images/note.gif"></td><a name="id2828057"></a>Note</tr><tr><td colspan="2" align="left" valign="top"><p>Dynamic DNS services are not perfect. They merely point hostnames to IP
addresses. If your system receives an IP address via DHCP or PPPoE, it will
automatically update the dynamic DNS service each time it comes online.
However, when your server disconnects from the Internet, with most dynamic
DNS services your server does not indicate that it is offline in any way to the
dynamic DNS service.
If your system is offline for a period of time, it <i>is</i>
possible that someone else will be assigned your IP address by your ISP. If
this occurs, with most dynamic DNS services this other system will now start
receiving your e-mail and web page requests until your server comes back online
and updates the service with your new IP address.
There is not much you can do about this, but you should be aware
of this fact if there is any chance your system will be offline for a long
period of time.</p></td></tr></table><a name="app-proxysrv"></a>Appendix C. Proxy Servers<p>

The server comes with a proxy server called Squid which can proxy the web
(HTTP), FTP and Gopher protocols. Proxy servers temporarily store information
from the Internet on the hard drive of the server,
allowing other users to access it directly from that hard drive. For example,
when an employee visits a web page, the web proxy server will store that
web page. Subsequent visitors to that web page will read it from your proxy
server's hard drive, rather than over the Internet. This slightly reduces
the network performance for the first visitor to that web page, but can
enhance the performance for subsequent visitors.
</p><p>
Many gateway systems
require the use of proxy servers, but with the server
it is optional. Networked applications such as web browsers will work perfectly
without proxying, due to the IP masquerading capability of the server.
</p><p>
In general, we recommend
that proxying be disabled in your network applications. Using the proxy
server can benefit the organization if you have a slow Internet connection
and you've installed your server software on a fast
computer. In this case, reading from the hard drive will be faster than
reading from the Internet. Remember, though, that a proxy server benefits
the second and subsequent visitors to a site but not the first visitor,
so this benefit only applies if your users tend to visit the same sites
repeatedly.
</p><p>
A proxy server is generally
not appropriate if you have a fast Internet connection and you've installed
your server software on a lower- or mid-level computer.
In this case, reading from the hard drive of the computer may not be faster
than over the Internet. It also offers no benefit to your organization
if employees at your site do not tend to visit the same web pages.
</p><a name="app-techsupp"></a>Appendix D. Technical Support<p>
<p>
If you are having difficulty
configuring another vendor's hardware or software, we recommend you refer
to the manual or contact the vendor for that product.
</p><p>
The SME Server is open source software,
Contribs.org encourages users to freely share copies of our software.
</p><a name="id2827901"></a><table border="1"><tr><td><p class="title"><b>contribs.org</b></p><p>Developers may wish to note that additional documentation, including HOWTO documents
and a FAQ, can be found on our
development web site - <a href="http://forums.contribs.org/" target="_top">http://forums.contribs.org/</a>. There
are also links there to other web sites relating to the server.

</p></td></tr></table></p></p></p></p></table></tr></tr></td></td><!-- safe_html.php/0.4 --></span></div>

<div id="footer">  <hr class="printer" noshade="noshade" />
<p class="editdate">Owner: <a href="hfwang.html" class="wiki">hfwang</a>  Last edited on January 19, 2004  1:51 am by <a href="hfwang.html" class="wiki">hfwang</a></p>
</div>

</div>
<!-- Add your Disclaimer here -->
</body>
</html>
