About FocalMail 1.2

What is FocalMail?

FocalMail is a web base email interface, which allow you to manage your mail
virtually at anywhere with Java script enable web browser.

Why use FocalMail?

As you are on the road, you can manage your mails at any Internet Cafe, ISPs
showroom, or even at your friends house. Most important, you dont have to
setup anything. All you need is any Java script enabled web browser. You also gain
features such as Address Book, and more. As FocalMail upgrade, you will
automatically use all its new features without pay any license or fee.

As an ISP, why use FocalMail?

FocalMail is developed by Focaltek Computer. As an ISP, we know what you needs.
We develop FocalMail with important features to allow you to easily support your
current clients. Most important it is FREE. Also it is extremely easy to setup. If you
have already installed all the require package, you will only need 5 minutes to setup
FocalMail by editing two line in the config.inf file. (refer to the Quick Setup for
FocalMail.) Also it is multi-lingual support, and we will release language files for you
to easily support your clients.

Features

1.List mails in INBOX, mail/saved-messages, and mail/sent-mail folders 
2.Copy, and Move mails between above mentioned folders 
3.Mark any mail for Delete 
4.Purge marked delete mail 
5.Highlight new incoming mail 
6.Online compose mail with cc, and bcc supports 
7.Online reply or reply to all with cc, and bcc supports 
8.Online forwarding mail with cc, and bcc supports 
9.Save draft mail to send later 
10.Manageable address book 
11.Pop-up address list for recipients 
12.Online help for individual form 

Advance Features

1.Support SSL without any extra setup 
2.Multi-lingual support 
3.Help files customizable 
4.Maintenance free 
5.Send attachment 
6.Save Mail with attachment 
7.User Profile Setting 

Requirement

Software
Apache 1.3.1 or higher
PHP 3.0.5
IMAP 4rev1
MySQL 3.21.28 or higher
mod_ssl 2.0.10-1.3.1 or matching version for Apache (optional V for better security)
UNIX environment ONLY (NT environment is not tested)

Hardware
Pentium Class 166MHz or higher
32MB RAM or more

NOTE: This is a recommended setting for concurrent 50 users. If you wish to support
more concurrent users, you must have a better computer. Please refer to the FAQs
sizing section. 

Quick Setup for FocalMail

This quick setup is only for those of you have installed all required software correctly. 

1.grap the GZ file V focalmail-version.tar.gz 
2.copy the file to the directory you wish to be the root of FocalMail 
3.decompress that file by typing gunzip focalmail-version.tar.gz 
4.decompress the structure by type tar Vvxf focalmail-version.tar.gz 
5.edit the file config.inf 
6.change the $mailserver = focaltek.comto $mailserver = domainIP* 
7.change the $database = focaltek.com to $database = databaseIP* 
8.change the send file attachment setting (Please refer to document attachment.txt)
9.change the sendmail path (Note: Must be in correct path)
10.save the config.inf 
11.setup MySQL table by typing mysqladmin create focalmail 
12.mysql focalmail < focalmail.mysql 
13.mysql focalmail < usersettup.mysql
14.add security for FocalMail to use the database focalmail by doing the
followings : 
mysql mysql
insert into user values('','fm',password('focaltek'),'y','y','y','y','y','y','y','y','y','y'); 

Please note that you may use IP number instead of servers name. This can help
FocalMail to speed up a bit for not necessary DNS translation. 


Setup FocalMail

This section is only for those of you do not have any software requirement installed.

Apache 1.3.1 + mod_ssl + php3.0.5 + MySQL on Linux

1. Download/UnTar/Ungzip the following:

- mod_ssl http://www.engelschall.com/sw/mod_ssl/
- SSLeay0.9.0b ftp://ftp.psy.uq.oz.au/pub/Crypto/SSL/
- Apache 1.3.1 http://www.apache.org/dist/
- Mysql http://mysql.he.net
- IMAP ftp://ftp.cac.washington.edu/imap/imap-4.2.tar.Z
- PHP 3.0.5 http://www.php.net

2. Compile/Install Mysql

setenv CFLAGS "-O2"
./configure --prefix=/usr/local/mysql
make install

3 Compile/Install IMAP c-client libs (only need to do once)

make sl5 (for glibc Linux)
cp c-client/c-client.a /usr/local/lib
cp c-client/rfc822.h /usr/local/include
cp c-client/mail.h /usr/local/include
cp c-client/linkage.h /usr/local/include

4. Compile SSLeay0.9.0b

make -f Makefile.ssl links
perl ./Configure gcc
make 
make rehash
make test

(ignore any warnings/errors above)

5. Configure mod_ssl

./configure --with-apache=../apache_1.3.1

6. Compile/Install PHP module

cd ../apache_1.3.1
./configure --prefix=/usr/local/apache
cd ../php_3.0.3
./configure --with-apache=../apache_1.3.1 \ 
--with-mysql=/usr/local/mysql --enable-debug=no \
--enable-track-vars=no --with-imap
7. add line to Makefile for PHP

-I../SSLeay-0.9.0b/include to INCLUDE line
make install

8. Compile Apache

./configure --prefix=/usr/local/apache \
--activate-module=src/modules/php3/libphp3.a --enable-module=ssl
make

9. Add below lines to srm.conf in /usr/local/apache/etc

AddType application/x-httpd-php3 .php3
AddType application/x-httpd-php3-source .phps

You may also have to edit the httpd.conf, access.conf, and other files in the
/usr/local/apache/etc to get Apache to work correctly.

After you setup all the software, you may follow the following steps to setup
FocalMail.

1.grap the GZ file V focalmail-version.tar.gz 
2.copy the file to the directory you wish to be the root of FocalMail 
3.decompress that file by typing gunzip focalmail-version.tar.gz 
4.decompress the structure by type tar Vvxf focalmail-version.tar.gz 
5.edit the file config.inf 
6.change the $mailserver = focaltek.comto $mailserver = domainIP* 
7.change the $database = focaltek.com to $database = databaseIP* 
8.change the send file attachment setting (Please refer to document attachment.txt)
9.change the sendmail path (Note: Must be in correct path)
10.save the config.inf 
11.setup MySQL table by typing mysqladmin create focalmail 
12.mysql focalmail < focalmail.mysql 
13.mysql focalmail < usersettup.mysql
14.add security for FocalMail to use the database focalmail by doing the
followings : 
mysql mysql
insert into user values('','fm',password('focaltek'),'y','y','y','y','y','y','y','y','y','y'); 

Please note that you may use IP number instead of servers name. This can help
FocalMail to speed up a bit for not necessary DNS translation. 


Advance Setup for FocalMail

FocalMail is very easy to configure. As you know there are only two lines need to edit
in the config.inf file. If you wish to change the language set, or help screen
information, you can simply edit file in language, help directories. Each script file will
have a .lng and .htm for language and help setting.

For example, 
Script Name		Help Screen		Language Page
mailbox.php3		mailbox.htm		mailbox.lng

All help screens is a simple HTML 3.0 coded page. Please do not use any Java or
Javascript for those page. 

Language page consists of a list of valuables. Just change the content within the 
and your script will change the output automatically. Note: do not add any extra
valuable, or code in those pages.


FAQ

1.Performance 

FocalMail is using a very power Server side script call PHP. This script allows
special function within regular HTML page. However, this script requires web
server to parse (process) the PHP coded pages. This will reduce the over
server performance, and luckily PHP is currently one of the fastest server side
script. We also fine-tune FocalMail code to allow it run faster in PHP enabled
web server environment. 

A Pentium 166MHz with 32MB RAM can support up to 50 concurrent user
logons. Please see Sizing Issue for details.

2.Security Issue 

First of all there is no security system that cannot be hacked. FocalMail is a
web server base email interface that access IMAP mail stream and report the
information back to the user using HTTP protocol. Since FocalMail only allows
user to check local servers or ISP preset IMAP server, it should consider to
be in a trusted environment where only system administrators have the access
to monitor this traffic.

FocalMail will use standard cookie to store user login and password
information in clients browser. FocalMail itself cannot and will not store any
users login information. FocalMail will ask the browser to store the
information in a special cookie name that will reduce security risk. Cookie that
store in clients browser may still be able to be reviewed but chance are very
slight. FocalMail also will use a time out setting to force cookie to expire, and
reduce the security risk.

To ensure HTTP transaction secure, you may have to use the SSL to help
secure the HTTP protocol to that no one can easy tag your connection.

Due to the Encryption exporting laws, FocalMail cannot not support PGP at this
moment.

3.Sizing Issue 

FocalMail has been fine-tune for heavy usage. This is very import for ISP. As
you can use a regular Pentium 166MHz with 32MB RAM computer to running
MySQL, IMAP, and Apache web server, it can still support over 50 concurrent
users. In reality, it can roughly serve 200 FocalMail pages / minutes. FocalMail
can gain better performance with a faster CPU, and more RAM. With A
Pentium PRO 200 and 64MB RAM, the throughput can be up to 400 FocalMail
pages / minutes. 

4.Error when running FocalMail 

a.Fatal error: Call to unsupport function 
This means that your PHP is not successfully install with MySQL or
IMAP.

b.Displaying raw code 

This means either you have not setup PHP correctly or you have not edit
srm.conf file.

Most of the error may case by improper PHP and Apache installation.
Please double check such setting before actually install the FocalMail

5.Send attachment 

FocalMail 1.2 include send mail with attachment.  However, not matter how well
we design FocalMail, there is always a security risk of allowing others to upload
files to your server.  For such reason, we have a detail document about attachment
setting.  Please read attachment.txt

Getting Help from Focaltek Computer

If you have any question about FocalMail, you may send a email to
support@focalmail.com

FocalMail also has a forum in FocalPress (www.focalpress.com.hk) V an online
press which also developed by Focaltek Computer. 

Goto the Forum section, and you should find the forum.

Terms, Conditions, and Legal Document

Disclaimers

Neither the author(s) nor Focaltek Computer assume responsibility for any expense,
damage or loss caused by your use of this software, however it comes down. 

FocalMail logos are registered trademarks.

All the registered trademarks used herein are registered to whoever it is that owns
them. This notification is given in lieu of any specific list of trademarks and their
owners, which would not be as inclusive and would probably take a lot longer to type. 

FocalMail 1.2 are copyrighted and cannot be distributed, whether modified 
or unmodified. FocalMail may be used freely, including by commercial entities.

You must not modify or remark out code line in any FocalMail distribute file related 
to or link to copyright.php3, copyright2.php, and top.php3 files.  If you wish to 
modify top.php3, you must become our register user (FREE).  
Go to our register page now at http://www.focalmail.com/home/register.html

FocalMail 1.2 - Copyrighted by 1998 Focaltek