<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Steve Looi &#187; Installation Guide</title>
	<atom:link href="http://www.stevelooi.com/category/installation-guide/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.stevelooi.com</link>
	<description>Tech, Gadgets, Reviews, How-to, Tips and more</description>
	<lastBuildDate>Wed, 25 Jan 2012 15:07:04 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.2.1</generator>
		<item>
		<title>hMailServer For Windows Installation Guide</title>
		<link>http://www.stevelooi.com/2008/08/18/hmailserver-for-windows-installation-guide/</link>
		<comments>http://www.stevelooi.com/2008/08/18/hmailserver-for-windows-installation-guide/#comments</comments>
		<pubDate>Mon, 18 Aug 2008 08:50:38 +0000</pubDate>
		<dc:creator>Steve Looi</dc:creator>
				<category><![CDATA[Installation Guide]]></category>
		<category><![CDATA[Tutorial]]></category>
		<category><![CDATA[hmailserver]]></category>
		<category><![CDATA[SMTP]]></category>

		<guid isPermaLink="false">http://www.stevelooi.com/?p=63</guid>
		<description><![CDATA[Apache Installation Download the latest Apache 1.3.x from http://httpd.apache.org/ Launch the installer and follow the installation instruction. MySQL Installation You have an option to install the MySQL automatically when the hMailServer is installed, unless you want to have a separate MySQL installation.]]></description>
			<content:encoded><![CDATA[<p>hMailServer is a free e-mail server for Microsoft Windows. It supports all the common e-mail protocols such as, SMTP, POP3 and IMAP.</p>
<p>If you are on a tight budget to purchase a commercial mail server, this is a good choice of having a reliable mail server that cost virtually nothing, except your effort you put to configure it.</p>
<p>I wrote this installation guide based on my experience in setting up a workable system.</p>
<p><span id="more-63"></span><strong>Prerequisites</strong></p>
<p>These prerequisites are necessary to have if you want a web mail that works with hMailServer.</p>
<p>1. Apache<br />
2. PHP<br />
3. MySQL<br />
4. Perl</p>
<p><strong>hMailServer Installation</strong></p>
<p>Stop the SMTP Service in IIS (Internet Information Services). It will clash with hMailServer because both are using the same port 25.</p>
<p>Download the latest hMailServer from <a href="http://www.hmailserver.com/" target="_blank">http://www.hmailserver.com</a></p>
<p>Launch the installer and follow the installation instruction.</p>
<p>Enter a password for hMailServer Administrator.</p>
<p>Launch the hMailServer Administrator.</p>
<p>Click Settings &gt; Protocols &gt; SMTP, and select the “Delivery of email” tab.</p>
<p>Enter the Host name and click Save.</p>
<p>Right-click Domains menu, then click Add.</p>
<p>Enter a new Domain name. Eg. mydomain.com</p>
<p>Enter a catch-all address. Eg. catch-all@mydomain.com</p>
<p>Click Save.</p>
<p>Expand the newly created Domain and click “Add account”.</p>
<p>Enter an Account Address and Password.</p>
<p>Click Save.</p>
<p>Repeat the steps to create additional accounts.</p>
<p><strong>Apache Installation </strong></p>
<p>Download the latest Apache 1.3.x from <a href="http://httpd.apache.org/" target="_blank">http://httpd.apache.org/</a></p>
<p>Launch the installer and follow the installation instruction.</p>
<p>Edit httpd.conf</p>
<p>Enter an e-mail address in ServerAdmin.</p>
<p>Enter a ServerName.</p>
<p>Modify DocumentRoot if necessary to point to the root directory. Eg. D:/www<br />
Note the forward slash “/”.</p>
<p>The default root directory is at C:/Program Files/Apache Group/Apache/htdocs, or in a different folder location where the Apache program is installed.</p>
<p>Add: index.php to DirectoryIndex. Place it before index.html.</p>
<p>Add: LoadModule php5_module &#8220;C:/php/php5apache.dll&#8221;</p>
<p>Uncomment: LoadModule vhost_alias_module modules/mod_vhost_alias.so</p>
<p>Uncomment: LoadModule rewrite_module modules/mod_rewrite.so</p>
<p>Add: AddModule mod_php5.c</p>
<p>Uncomment: AddModule mod_vhost_alias.c</p>
<p>Uncomment: AddModule mod_rewrite.c</p>
<p>Save the changes.</p>
<p>Start Apache Service and verify there is no error.</p>
<p><strong>PHP + PEAR Installation</strong></p>
<p>Download the latest PHP 5.2.x Zip Package (not installer package) from <a href="http://www.php.net/" target="_blank">http://www.php.net/</a></p>
<p>Unzip it to C:\PHP folder.</p>
<p>Rename php.ini-recommended to php.ini and copy it to C:\Windows folder.</p>
<p>Edit C:\Windows\php.ini with the following:</p>
<p>short_open_tag = On<br />
max_execution_time = 60<br />
post_max_size = 20M<br />
upload_max_filesize = 20M<br />
include_path=&#8221;.;C:\PHP\PEAR;C:\PHP&#8221;<br />
extension_dir = &#8220;C:\PHP\ext&#8221;</p>
<p>Uncomment:<br />
extension=php_bz2.dll<br />
extension=php_curl.dll<br />
extension=php_gd2.dll<br />
extension=php_gettext.dll<br />
extension=php_ldap.dll<br />
extension=php_mbstring.dll<br />
extension=php_mcrypt.dll<br />
extension=php_mhash.dll<br />
extension=php_mysql.dll<br />
extension=php_xsl.dll<br />
extension=php_zip.dll</p>
<p>Copy libeay32.dll and libmysql.dll from C:\PHP to C:\Windows\System32 folder.</p>
<p>Launch the Windows command prompt and enter C:\PHP\go-pear.bat to install PEAR.</p>
<p>Follow the installation instruction and keep the default settings.</p>
<p>Download the PEAR DB package from http://pear.php.net/package/DB/</p>
<p>Unzip it into C:\PHP\PEAR folder. Make sure the DB.php is in that folder.</p>
<p>Restart Apache and verify there is no error.</p>
<p>Create a phpinfo.php with the following code and place it in the root directory.</p>
<p>&lt;?php<br />
echo phpinfo();<br />
?&gt;</p>
<p>Browse the phpinfo.php in web browser. PHP installation is successful if information is displayed.</p>
<p><strong>MySQL Installation</strong></p>
<p>You have an option to install the MySQL automatically when the hMailServer is installed, unless you want to have a separate MySQL installation.</p>
<p>Download the latest MySQL Community Server 5.x from <a href="http://www.mysql.com/" target="_blank">http://www.mysql.com/</a></p>
<p>Launch the installer and follow the installation instruction.</p>
<p>Start MySQL Service.</p>
<p>Download the latest MySQL Administrator GUI Tools from <a href="http://dev.mysql.com/downloads/gui-tools/" target="_blank">http://dev.mysql.com/downloads/gui-tools/</a></p>
<p>Launch the installer and follow the installation instruction.</p>
<p>Launch the MySQL Administrator.</p>
<p>Click Catalogs and create a New Schema.</p>
<p>Enter a Schema name: eg. squirrelmail</p>
<p>Click User Administration and Add New User.</p>
<p>Enter a new MySQL User name. eg. squirreluser</p>
<p>Enter a Password. Eg. squirrelpassword</p>
<p>Click Apply Changes.</p>
<p>Right-click the squirreluser and Add Host.</p>
<p>Enter a Host as localhost.</p>
<p>Select localhost and select the Schema Privileges tab.</p>
<p>Select squirrelmail and move SELECT, INSERT, UPDATE and DELETE to Assigned Privileges.</p>
<p>Click Apply Changes.</p>
<p>Launch MySQL Command Prompt and login into MySQL.</p>
<p>********* Skip this section of the above is done ************<br />
CREATE DATABASE squirrelmail;</p>
<p>GRANT select,insert,update,delete ON squirrelmail.*<br />
TO squirreluser@localhost IDENTIFIED BY &#8216;squirrelpassword&#8217;;<br />
**********************************************</p>
<p>USE squirrelmail;</p>
<p>CREATE TABLE address (<br />
owner varchar(128) DEFAULT &#8221; NOT NULL,<br />
nickname varchar(16) DEFAULT &#8221; NOT NULL,<br />
firstname varchar(128) DEFAULT &#8221; NOT NULL,<br />
lastname varchar(128) DEFAULT &#8221; NOT NULL,<br />
email varchar(128) DEFAULT &#8221; NOT NULL,<br />
label varchar(255),<br />
PRIMARY KEY (owner,nickname),<br />
KEY firstname (firstname,lastname)<br />
);</p>
<p>CREATE TABLE userprefs (<br />
user varchar(128) DEFAULT &#8221; NOT NULL,<br />
prefkey varchar(64) DEFAULT &#8221; NOT NULL,<br />
prefval blob DEFAULT &#8221; NOT NULL,<br />
PRIMARY KEY (user,prefkey)<br />
);</p>
<p>quit</p>
<p><strong>PERL Installation</strong></p>
<p>Download the latest ActivePerl 5.10.x from <a href="http://www.activestate.com/" target="_blank">http://www.activestate.com/</a></p>
<p>Launch the installer and follow the installation instruction.</p>
<p><strong>SquirrelMail Installation</strong></p>
<p>Download the latest SquirrelMail 1.4.x from <a href="http://www.squirrelmail.org/" target="_blank">http://www.squirrelmail.org/</a></p>
<p>Unzip it into the web root C:\path to apache\htdocs or in a sub-folder. Eg C:\path to apache\htdocs\ squirrelmail\ and you will access it through http://yourdomain.com/squirrelmail/</p>
<p>Create a directory C:\Data and within that directory create two more directories C:\Data\Data and C:\Data\Attachments. Specify these as your Data and Attachment directories.</p>
<p>Edit functions/db_prefs.php and replace var $default with the following:</p>
<p>var $default = Array(&#8216;chosen_theme&#8217; =&gt; &#8216;../themes/default_theme.php&#8217;,<br />
&#8216;show_html_default&#8217; =&gt; &#8217;1&#8242;,<br />
&#8216;language&#8217; =&gt; &#8216;en_US&#8217;,<br />
&#8216;use_javascript_addr_book&#8217; =&gt; &#8217;1&#8242;,<br />
&#8216;left_size&#8217; =&gt; &#8217;140&#8242;,<br />
&#8216;left_refresh&#8217; =&gt; &#8217;3600&#8242;,<br />
&#8216;show_username&#8217; =&gt; &#8217;1&#8242;,<br />
&#8216;show_username_pos&#8217; =&gt; &#8216;top&#8217;,<br />
&#8216;order1&#8242; =&gt; &#8217;1&#8242;,<br />
&#8216;order2&#8242; =&gt; &#8217;2&#8242;,<br />
&#8216;order3&#8242; =&gt; &#8217;3&#8242;,<br />
&#8216;order4&#8242; =&gt; &#8217;5&#8242;,<br />
&#8216;order5&#8242; =&gt; &#8217;4&#8242;,<br />
&#8216;order6&#8242; =&gt; &#8217;6&#8242;);</p>
<p>Edit squirrelmail/src/login.php and change the wording of &#8220;Name:&#8221; to &#8220;Email Address:&#8221;.</p>
<p>In Windows command prompt, access into C:\path to\squirrelmail\config folder.</p>
<p>Type perl conf.pl</p>
<p>D. SET PRE-DEFINED SETTINGS FOR SPECIFIC IMAP SERVERS<br />
Choose hmailserver</p>
<p>1. ORGANIZATION PREFERENCES<br />
1. Organization name : YourCompany WebMail<br />
2. Organization Logo : /images/yourcompanylogo-100.gif<br />
3. Org. Logo Height/Width : 100/100<br />
4. Organization title : YourCompany WebMail (v$version)<br />
7. Provider link : http://www.yourdomain.com<br />
8. Provider name : YourCompany</p>
<p>2. SERVER SETTINGS<br />
1. Domain : yourdomain.com</p>
<p>3. FOLDER DEFAULTS<br />
15. Default Unseen Type : 2</p>
<p>4. GENERAL OPTIONS<br />
1. Data directory : C:/Data/Data<br />
2. Attachment directory : C:/Data/Attachments<br />
5. Usernames in lower case : true<br />
7. Hide SM attributions : true<br />
11. Allow server-side sorting : false<br />
( Note: Item 4.1 and 4.2 need to be forward slash &#8220;/&#8221;)</p>
<p>6. ADDRESS BOOKS<br />
2. Use Javascript Address Book Search : True</p>
<p>9. DATABASE<br />
1. DSN for address book :<br />
mysql://squirreluser:squirrelpassword@localhost/squirrelmail<br />
3. DSN for preferences :<br />
mysql://squirreluser:squirrelpassword@localhost/squirrelmail</p>
<p>Now, Save and quit the config program</p>
<p>Start Apache Service and verify there is no error.</p>
<p>Done.</p>
<p><strong>ClamWin</strong></p>
<p>ClamWin is an open source anti-virus scanning and detection engine that will integrated seamlessly with hMailServer.</p>
<p>Download the latest ClamWin 0.93.x installer from <a href="http://www.clamwin.com/" target="_blank">http://www.clamwin.com/</a></p>
<p>Launch the installer and follow the installation instruction.</p>
<p>Launch hMailServer Administrator.</p>
<p>Expand the Settings &gt; AntiVirus menu.</p>
<p>Set the desired options in General tab.</p>
<p>Click ClamWin tab and enable “Use ClamWin” checkbox.</p>
<p>Click the AutoDetect button to locate the ClamWin installation path.</p>
<p>Verify the ClamScan executable path and ClamScan database path are correct.</p>
<p>Click Save.</p>
<p><strong>ASSP (Anti-Spam SMTP Proxy Server)</strong></p>
<p>This is installation is option.</p>
<p>ASSP is an open source, multi-platform anti-spam proxy server which will detect and block spam e-mails before they rech your mail server.</p>
<p>The accuracy of ASSP in catching spams is very high, which I do recommend that you give it a try.</p>
<p>Download the latest ASSP installer from <a href="http://www.asspsmtp.org/" target="_blank">http://www.asspsmtp.org/</a></p>
<p>Read the <a href="http://www.asspsmtp.org/wiki/Installation" target="_blank">ASSP installation guide</a> available from the ASSP web site.</p>
<p><strong>Try Out Your Installation</strong></p>
<p>It&#8217;s time to try out your hMailServer SMTP, POP3 and IMAP installation using Outlook, <a href="http://www.mozilla.com/thunderbird/" target="_blank">Mozilla Thunderbird</a> or Squirrelmail.<br />
<h3 class="bsuite_related">Related items</h3>
<ul class="bsuite_related">
<li><a href='http://www.stevelooi.com/2011/10/10/upgrade-php-5-1-x-to-5-2-x-required-by-wordpress-3-2-in-centos/'>Upgrade PHP 5.1.x to 5.2.x required by WordPress 3.2 in CentOS</a></li>
<li><a href='http://www.stevelooi.com/2011/09/29/tcpdump-command-line-packet-analyzer/'>TCPDUMP command-line packet analyzer</a></li>
<li><a href='http://www.stevelooi.com/2008/03/25/streamyx-blocks-outgoing-smtp-port-25/'>Streamyx Blocks Outgoing SMTP Port 25</a></li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.stevelooi.com/2008/08/18/hmailserver-for-windows-installation-guide/feed/</wfw:commentRss>
		<slash:comments>5</slash:comments>
		</item>
	</channel>
</rss>

