diff --git a/.hgignore b/.hgignore index 3997a38e..64982230 100644 --- a/.hgignore +++ b/.hgignore @@ -1,3 +1,2 @@ syntax: glob .DS_Store -html/* diff --git a/5-integrations/_title.md b/5-integrations/_title.md new file mode 100644 index 00000000..6bff7712 --- /dev/null +++ b/5-integrations/_title.md @@ -0,0 +1 @@ +Third-party integrations. diff --git a/5-integrations/sogo-centos-6-iredmail-mysql.md b/5-integrations/sogo-centos-6-iredmail-mysql.md new file mode 100644 index 00000000..0b273b99 --- /dev/null +++ b/5-integrations/sogo-centos-6-iredmail-mysql.md @@ -0,0 +1,119 @@ +# How to install SOGo on CentOS 6 with iRedMail (MySQL backend) + +## Requirements + +* A working iRedMail server on CentOS 6. + +## Install SOGo + +* Make sure you have EPEL repo enabled, if not, please follow [this wiki +tutorial](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F) +to enable it. + +
+# yum repolist | grep -i 'epel'
+epel              Extra Packages for Enterprise Linux 6 - x86_64          11,109
+
+ +* Add yum repo file `/etc/yum.repos.d/sogo.repo`: + +
+[SOGo]
+name=Inverse SOGo Repository
+baseurl=http://inverse.ca/downloads/SOGo/RHEL6/$basearch
+gpgcheck=0
+
+ +* Install SOGo and dependences: + +
+# yum install sogo sope49-gdl1-mysql
+
+ +## Create SQL database to store SOGo data + +
+$ mysql -u root -p
+
+mysql> CREATE DATABASE sogo CHARSET='UTF8';
+mysql> GRANT ALL ON sogo.* TO sogo@localhost IDENTIFIED BY 'password';
+
+-- TODO
+mysql> GRANT SELECT ON vmail.mailbox TO sogo@localhost;
+
+mysql> CREATE VIEW sogo.sogo_auth (c_uid, c_name, c_password, c_cn, mail, home) AS SELECT username, username, password, name, username, maildir FROM vmail.mailbox;
+
+ +## Configure SOGo + +Default SOGo config file is `/etc/sogo/sogo.conf`: + +
+    SOGoProfileURL = "mysql://sogo:password@localhost:3306/sogo/sogo_user_profile";
+    OCSFolderInfoURL = "mysql://sogo:password@localhost:3306/sogo/sogo_folder_info";
+    OCSSessionsFolderURL = "mysql://sogo:password@localhost:3306/sogo/sogo_sessions_folder";
+
+    SOGoIMAPServer = "127.0.0.1";
+
+    SOGoMailingMechanism = smtp;
+    SOGoSMTPServer = 127.0.0.1;
+
+
+    // Enable managesieve service
+    SOGoSieveServer = sieve://127.0.0.1:4190;
+    SOGoSieveScriptsEnabled = YES;
+
+    SOGoForceExternalLoginWithEmail = YES;
+    SOGoAppointmentSendEMailNotifications = YES;
+
+  SOGoUserSources =
+    (
+      {
+        type = sql;
+        id = directory;
+        viewURL = "mysql://sogo:password@127.0.0.1:3306/sogo/sogo_view";
+        canAuthenticate = YES;
+        isAddressBook = YES;
+        userPasswordAlgorithm = md5;
+        prependPasswordScheme = YES;
+        //LoginFieldNames = username;
+        //MailFieldNames = username;
+        //IMAPLoginFieldName = username;
+        //DomainFieldName = domain;
+      }
+    );
+
+ + +## How to configure client applications + +### Configure Apple iCal.app for calendar + +http://[host]/SOGo/dav/[user]/ + +## TODO + +## References: + +* Addition settings: + +
+defaults write sogod OCSEMailAlarmsFolderURL mysql://vmail:PASSWORD@localhost:3306/vmail/sogo_alarms_folder
+defaults write sogod SOGoTimeZone "Europe/Berlin"
+defaults write sogod SOGoAppointmentSendEMailNotifications YES
+defaults write sogod SOGoFoldersSendEMailNotifications YES
+defaults write sogod SOGoACLsSendEMailNotifications YES
+
+defaults write sogod SOGoMailingMechanism smtp
+defaults write sogod SOGoSMTPServer 127.0.0.1
+defaults write sogod SOGoMemcachedHost 127.0.0.1
+
+defaults write sogod SOGoDraftsFolderName Drafts
+defaults write sogod SOGoSentFolderName Sent
+defaults write sogod SOGoTrashFolderName Trash
+defaults write sogod SOGoIMAPServer localhost
+defaults write sogod SOGoPasswordChangeEnabled YES
+defaults write sogod SOGoSieveScriptsEnabled YES
+defaults write sogod SOGoSieveServer sieve://127.0.0.1:4190
+defaults write sogod WOPort 127.0.0.1:20000
+
diff --git a/5-backup-restore/_title.md b/7-backup-restore/_title.md similarity index 100% rename from 5-backup-restore/_title.md rename to 7-backup-restore/_title.md diff --git a/5-backup-restore/migrate.to.new.iredmail.server.md b/7-backup-restore/migrate.to.new.iredmail.server.md similarity index 100% rename from 5-backup-restore/migrate.to.new.iredmail.server.md rename to 7-backup-restore/migrate.to.new.iredmail.server.md diff --git a/README.md b/README.md index f7c7457b..be88b3f6 100644 --- a/README.md +++ b/README.md @@ -15,9 +15,13 @@ * [ How to perform silent/unattended iRedMail installation](./4-howto/./4-howto/unattended.iredmail.installation.md) * [ How to use or migrate password hashes](./4-howto/./4-howto/use.or.migrate.password.hashes.md) +# Third-party integrations. + +* [ How to install SOGo on CentOS 6 with iRedMail (MySQL backend)](./5-integrations/./5-integrations/sogo-centos-6-iredmail-mysql.md) + # Backup and Restore -* [How to migrate old iRedMail server to the latest stable release](./5-backup-restore/./5-backup-restore/migrate.to.new.iredmail.server.md) +* [How to migrate old iRedMail server to the latest stable release](./7-backup-restore/./7-backup-restore/migrate.to.new.iredmail.server.md) # Troubleshooting and Debug diff --git a/html/howto/quarantining.clean.mail.html b/html/howto/quarantining.clean.mail.html new file mode 100644 index 00000000..0e5cebe9 --- /dev/null +++ b/html/howto/quarantining.clean.mail.html @@ -0,0 +1,60 @@ + + + + How to quarantine clean mail into SQL database + + + + +

How to quarantine clean mail into SQL database

+

To quarantine clean mails into SQL database, please follow below steps:

+

Configure Amavisd to enable quarantining

+ +
+$clean_quarantine_method = 'sql:';
+$clean_quarantine_to = 'clean-quarantine';
+
+ + +
+$policy_bank{'MYUSERS'} = {
+    ...
+    clean_quarantine_method => 'sql:',
+    final_destiny_by_ccat => {CC_CLEAN, D_DISCARD},
+}
+
+ + +
+@storage_sql_dsn = (
+    ['DBI:mysql:database=amavisd;host=127.0.0.1;port=3306', 'amavisd', 'qAv9CYva0vHA1GCX0J9f23WJvqRzt7'],
+);
+
+ + +

That's all. Now all clean emails sent by your mail users will be quarantined +into SQL database. if you have iRedAdmin-Pro, you can manage (release or delete) +quarantined emails with it.

+ \ No newline at end of file diff --git a/html/index.html b/html/index.html index b51ee63e..2e3570ac 100644 --- a/html/index.html +++ b/html/index.html @@ -23,6 +23,10 @@
  • How to perform silent/unattended iRedMail installation
  • How to use or migrate password hashes
    • +

    Third-party integrations.

    +

    Backup and Restore