1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head />
<body>
<a name="PageTop" />
<h1>Virtuoso ODS WebMail Installation Guide</h1>
<h2>Requirements</h2>
<p>To make an ODS WebMail Installation you need:</p>
<ol>
<li>WebMail VAD package: <b>ods_webmail_dav.vad</b>
</li>
<li>ODS Framework vad package: <b>ods_framework_dav.vad</b>
</li>
<li>Running Virtuoso Server. (version 3.5 or higher)</li>
<li>SMTP Server</li>
<li>Mail Drop application</li>
</ol>
<h2>Installation steps</h2>
<h3>Step 1: Building VAD package</h3>
<ol>
<li>If you have WebMail VAD package, you can jump to Step 2.</li>
<li>To build an WebMail VAD package, you need to have a fresh copy of the WebMail sources
from CVS repository and Virtuoso environment installed.</li>
<li>In the opensource tree, the path to module is: \virtuoso-opensource\appsrc\ODS-WebMail</li>
<li>After cvs update, go to ODS-WebMail directory and run:</li>
<pre>./make_vad.sh</pre>
<li>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.</li>
</ol>
<h3>Step 2: Installing the WebMail VAD package</h3>
<ol>
<li>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:</li>
<pre>DB.DBA.VAD_INSTALL('/<package_path>/ods_webmail_dav.vad',0);</pre>
<li>As result, if the installation is successful, should be shown the messages:</li>
<pre>
00000 No errors detected, installation complete.
00000 Now making a final checkpoint.
00000 Final checkpoint is made.
00000 SUCCESS
</pre>
</ol>
<h3>Step 3: Configuration of receiving mail messages</h3>
<ol>
<li>To be able to receive mail using your ODS WebMail account, you need to have the following components:</li>
<ol>
<li>SMTP server (MS SMTP, Sendmail, Qmail, ...)</li>
<li>domain name (for example: domain.com)</li>
<li>OpenLink Mail Drop program</li>
</ol>
<li>The working schema is:</li>
<pre>Internet-->SMTP Server(*@domain.com)-->Mail Drop App (via odbc)-->Virtuoso DB message</pre>
<p>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.</p>
</ol>
<h4>For Windows installation</h4>
<ol>
<li>You can use Windows version of Mail drop program and standard MS SMTP Server. The Mail Drop application included the following files:</li>
<ol>
<li>maildrop.dll</li>
<li>odbc_mail.exe</li>
<li><a href="http://ods.openlinksw.com/wiki/ODS/OdsMailInstallGuide/odbc_mail.ini" target="_top">odbc_mail.ini</a></li>
<li><a href="http://ods.openlinksw.com/wiki/ODS/OdsMailInstallGuide/register.bat" target="_top">register.bat</a></li>
<li><a href="http://ods.openlinksw.com/wiki/ODS/OdsMailInstallGuide/smtpreg.vbs" target="_top">smtpreg.vbs</a></li>
</ol>
<p>The files maildrop.dll and odbc_mail.exe you can found in your Virtuoso installation folder.</p>
<li>Place the files from above in the Virtuoso Server folder and execute:</li>
<pre>register.bat /register domain.com</pre>
<li>As result will be registered a rule in your MS SMTP server which means:</li>
<p>"If incoming message is for domain domain.com, then execute odbc_mail.exe"</p>
<li>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:
<pre>Start->Settings->Control Panel->Administrative Tools->Internet Information Services.</pre></li>
</ol>
<h3>Step 4: Configuring WebMail application</h3>
<ol>
<li>Go to http://[host]:[port]/ods</li>
<li>Login as dav user (default password is dav)</li>
<li>Go to Site Settings->Server Settings and configure domain names list with available domain for user registrations.</li>
<li>Check if in the list "Existing Hosted Mail Domains" there is your domain, for ex. domain.com. If not, add it.</li>
<li>Logout as user dav.</li>
</ol>
<h3>Step 5:WebMail UI</h3>
<ol>
<li>Go to http://[host]:[port]/ods and register a new user.</li>
<li>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.</li>
<li>As result you will be redirected to your WebMail Inbox</li>
</ol>
</body>
</html>
|
