Virtuoso ODS-Mail Installation Guide

Requirements

To make an ODS-Mail Installation you need:

Step 1: Building VAD package

If you have ODS-Mail VAD package, you can jump to Step 2.
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.
In the opensource tree, the path to module is: \virtuoso-opensource\appsrc\ODS-WebMail
After cvs update, go to ODS-Mail directory and run:
```
./make_vad.sh
```
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.

Step 2: Installing the ODS-Mail VAD package

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:
```
DB.DBA.VAD_INSTALL('/<package_path>/ods_webmail_dav.vad',0);
```

As result, if the installation is successful, should be shown the messages:


00000    No errors detected, installation complete.
00000    Now making a final checkpoint.
00000    Final checkpoint is made.
00000    SUCCESS

Step 3: Configuration of receiving mail messages

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, ...)
2. domain name (for example: domain.com)
3. OpenLink? Mail Drop program

The working schema is:


Internet->SMTP Server(*@domain.com)->Mail Drop App (via odbc)->Virtuoso DB message

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.

See details here.

See details here.

Step 4: Configuring ODS-Mail application

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

Step 5: ODS-Mail UI

Go to http://[host]:[port]/ods and register a new user.
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.
As result you will be redirected to your ODS-Mail Inbox folder.