---+ Virtuoso ODS-Mail Installation Guide

%TOC%

---++ Requirements

To make an ODS-Mail Installation you need:

   1. ODS Framework vad package: <b>[[https://virtuoso.openlinksw.com/download/][ods_framework_dav.vad]]</b>
   1. ODS-Mail VAD package: <b>[[https://virtuoso.openlinksw.com/download/][ods_webmail_dav.vad]]</b>
   1. Running Virtuoso Server. (version 3.5 or higher)
   1. SMTP Server
   1. Mail Drop application
    
---++ Installation steps

<b>Step 1</b>: Building VAD package

   1. If you have ODS-Mail VAD package, you can jump to Step 2.
   1. To build an ODS-Mail VAD package, you need to have a fresh copy of the ODS-Mail sources from CVS repository and Virtuoso environment installed.
   1. In the opensource tree, the path to module is: \virtuoso-opensource\appsrc\ODS-<nowiki>WebMail</nowiki>
   1. After cvs update, go to ODS-Mail directory and run:
<verbatim>
./make_vad.sh
</verbatim>
   1. As result should be build <nowiki>ods_webmail_dav</nowiki>.vad and <nowiki>ods_webmail_filesystem</nowiki>.vad packages. You can locate them in the same folder \virtuoso-opensource\appsrc\ODS-<nowiki>WebMail</nowiki>.

<b>Step 2</b>: Installing the ODS-Mail VAD package

   1. 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:
<verbatim>
DB.DBA.VAD_INSTALL('/<package_path>/ods_webmail_dav.vad',0);
</verbatim>
   1. As result, if the installation is successful, should be shown the messages:
<verbatim>
00000    No errors detected, installation complete.
00000    Now making a final checkpoint.
00000    Final checkpoint is made.
00000    SUCCESS
</verbatim>


<b>Step 3</b>: Configuration of receiving mail messages

   1. To be able to receive mail using your ODS-Mail account, you need to have the following components:
      1. SMTP server (MS SMTP, Sendmail, Qmail, ...)
      1. domain name (for example: domain.com)
      1. OpenLink Mail Drop program
   1. The working schema is:
<verbatim>
Internet->SMTP Server(*@domain.com)->Mail Drop App (via odbc)->Virtuoso DB message
</verbatim>
   1. 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.

---+++ Installation instructions for UNIX 

See details [[OdsMailInstallGuideUnix][here]].


---+++ Installation Steps for Windows

See details [[OdsMailInstallGuideWindows][here]].



<b>Step 4</b>: Configuring ODS-Mail application
 
   1. Go to http://[host]:[port]/ods
   1. Login as dav user (default password is dav)
   1. Go to Site Settings->Server Settings and configure domain names list with available domain for user registrations.
   1. Check if in the list "Existing Hosted Mail Domains" there is your domain, for ex. domain.com. If not, add it.
   1. Logout as user dav.
    

<b>Step 5</b>: ODS-Mail UI
   1. Go to http://[host]:[port]/ods and register a new user.
   1. Go to ODS-Mail and create new instance. In the create instance page you need to provide domain from the list of available domains for your email address.
   1. As result you will be redirected to your ODS-Mail Inbox folder.

---++ Related

   * [[OdsMail][ODS-Mail]]
   * [[OdsMailFiltersGuide][Creating Filters in ODS-Mail]]
      * [[ODSMailWebIDFilterRule][Web ID Filter Rule Example]];
      * [[ODSMailIMAP4FilterRule][Set Filter Rule associated with IMAP4 account Example]];
      * [[OdsMailSpamFilterGuide][Set Spam Filter Example]];
      * [[ODSMailSpamFilterRule][Manage Spam Filter with Addressbook interaction]]
   * [[ODSMailWebIDSMIME][ODS-Mail's SMIME + WebID Support Guide]]      
   * [[OdsWebmailProgrammersGuide][ODS-Mail's Programmers Guide]]
   * [[ODSMailPop3External][Configure an external POP3 account in ODS-Mail]]
   * [[ODSMailIMAP4External][Configure an external IMAP4 account in ODS-Mail]]   
   * [[ODSMailIMAP4Thunderbird][Synchronizing Mozilla Thunderbird IMAP4 account store with ODS-Mail IMAP4 mapped instance]]

CategoryMail CategoryODS CategoryOpenSource CategoryHowTo CategoryOdsMail