<docbook><section><title>OdsMailInstallGuide</title><para> </para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2">Virtuoso ODS WebMail Installation Guide</bridgehead>
<bridgehead class="http://www.w3.org/1999/xhtml:h3">Requirements</bridgehead>
<para>To make an ODS WebMail Installation you need:</para>
<orderedlist spacing="compact"><listitem>WebMail VAD package: <emphasis>ods_webmail_dav.vad</emphasis> </listitem>
<listitem>ODS Framework vad package: <emphasis>ods_framework_dav.vad</emphasis> </listitem>
<listitem>Running Virtuoso Server.
 (version 3.5 or higher) </listitem>
<listitem>SMTP Server </listitem>
<listitem>Mail Drop application</listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h3">Installation steps</bridgehead>
<emphasis>Step 1</emphasis>: Building VAD package<orderedlist spacing="compact"><listitem>If you have WebMail VAD package, you can jump to Step 2.
</listitem>
<listitem>To build an WebMail VAD package, you need to have a fresh copy of the WebMail sources from CVS repository and Virtuoso environment installed.
</listitem>
<listitem>In the opensource tree, the path to module is: \virtuoso-opensource\appsrc\ODS-WebMail </listitem>
<listitem>After cvs update, go to ODS-WebMail directory and run: <programlisting>./make_vad.sh
</programlisting></listitem>
<listitem>As result should be build ods_webmail_dav.vad and ods_webmail_filesystem.vad packages.
 You can locate them in the same folder \virtuoso-opensource\appsrc\ODS-WebMail.</listitem>
</orderedlist><emphasis>Step 2</emphasis>: Installing the WebMail VAD package<orderedlist spacing="compact"><listitem>If you already have installed the ODS Framework package, you need only to execute either from Conductor Interactive SQL or from ISQL the following line: <programlisting>DB.DBA.VAD_INSTALL(&#39;/&lt;package_path&gt;/ods_webmail_dav.vad&#39;,0);
</programlisting></listitem>
<listitem>As result, if the installation is successful, should be shown the messages: <programlisting>00000    No errors detected, installation complete.
00000    Now making a final checkpoint.
00000    Final checkpoint is made.
00000    SUCCESS
</programlisting></listitem>
</orderedlist><emphasis>Step 3</emphasis>: Configuration of receiving mail messages<orderedlist spacing="compact"><listitem>To be able to receive mail using your ODS WebMail account, you need to have the following components: <orderedlist spacing="compact"><listitem>SMTP server (MS SMTP, Sendmail, Qmail, ...) </listitem>
<listitem>domain name (for example: domain.com) </listitem>
<listitem><ulink url="OpenLink">OpenLink</ulink> Mail Drop program </listitem>
</orderedlist></listitem>
<listitem>The working schema is: <programlisting>Internet-&gt;SMTP Server(*@domain.com)-&gt;Mail Drop App (via odbc)-&gt;Virtuoso DB message
</programlisting></listitem>
<listitem>You need to configure a SMTP server to receive messages for your domain name and execute mail_drop application for every incoming mail message to this domain.
 For reference see the steps below.</listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h3">For Windows installation</bridgehead>
<orderedlist spacing="compact"><listitem>You can use Windows version of Mail drop program and standard MS SMTP Server.
 The Mail Drop application included the following files: <itemizedlist mark="bullet" spacing="compact"><listitem>maildrop.dll </listitem>
<listitem>virt_mail.exe </listitem>
<listitem><ulink url="OdsMailInstallGuide/virt_mail.ini">virt_mail.ini</ulink> </listitem>
<listitem><ulink url="OdsMailInstallGuide/register.bat">register.bat</ulink> </listitem>
<listitem><ulink url="OdsMailInstallGuide/smtpreg.vbs">smtpreg.vbs</ulink> </listitem>
</itemizedlist></listitem>
<listitem>The files maildrop.dll and virt_mail.exe you can found in your Virtuoso installation folder.
</listitem>
<listitem>Place the files from above in the Virtuoso Server folder and execute: <programlisting>register.bat /register domain.com
</programlisting></listitem>
<listitem>As result will be registered a rule in your MS SMTP server which means: <programlisting>&quot;If incoming message is for domain domain.com, then execute virt_mail.exe&quot;
</programlisting></listitem>
<listitem>Configure the SMTP server so to add domain.com as alias or as default domain name.
 This can be done via Internet Information Services Administration: <programlisting>Start-&gt;Settings-&gt;Control Panel-&gt;Administrative Tools-&gt;Internet Information Services.
</programlisting></listitem>
</orderedlist><emphasis>Step 4</emphasis>: Configuring WebMail application<orderedlist spacing="compact"><listitem>Go to http://[host]:[port]/ods </listitem>
<listitem>Login as dav user (default password is dav) </listitem>
<listitem>Go to Site Settings-&gt;Server Settings and configure domain names list with available domain for user registrations.
</listitem>
<listitem>Check if in the list &quot;Existing Hosted Mail Domains&quot; there is your domain, for ex.
 domain.com.
 If not, add it.
</listitem>
<listitem>Logout as user dav.</listitem>
</orderedlist><para> <emphasis>Step 5</emphasis>: WebMail UI </para>
<orderedlist spacing="compact"><listitem>Go to http://[host]:[port]/ods and register a new user.
</listitem>
<listitem>Go to WebMail and create new instance.
 In the create instance page you need to provide domain from the list of available domains for your email address.
</listitem>
<listitem>As result you will be redirected to your WebMail Inbox folder.</listitem>
</orderedlist><para><ulink url="CategoryMail">CategoryMail</ulink> <ulink url="CategoryODS">CategoryODS</ulink> <ulink url="CategoryOpenSource">CategoryOpenSource</ulink> <ulink url="CategoryHowTo">CategoryHowTo</ulink></para>
<para> </para>
</section></docbook>