From 51d23729763cfa3d4d67f41fb154a7130ea1025d Mon Sep 17 00:00:00 2001 From: Pablo Carranza Date: Sat, 19 Oct 2013 12:17:39 -0500 Subject: [PATCH 1/8] Started Ubuntu w/PostgreSQL tutorial --- tutorials/ubuntu_postgresql.md | 174 +++++++++++++++++++++++++++++++++ 1 file changed, 174 insertions(+) create mode 100644 tutorials/ubuntu_postgresql.md diff --git a/tutorials/ubuntu_postgresql.md b/tutorials/ubuntu_postgresql.md new file mode 100644 index 000000000..3ad7abacd --- /dev/null +++ b/tutorials/ubuntu_postgresql.md @@ -0,0 +1,174 @@ +# ~~~~~~~~~~ DRAFT ~~~~~~~~~~ +*[Pull Requests](https://github.com/DigitalOcean-User-Projects/Articles-and-Tutorials/pulls) gladly accepted* +How To Install & Configure SOGo - an Open-Source Alternative to Microsoft Exchange +===== + +### Introduction + +SOGo is a free and modern scalable groupware server. It offers shared calendars, address books, and emails through your favourite Web browser and by using a native client such as Mozilla Thunderbird and Lightning. + +SOGo is standard-compliant. It supports CalDAV, CardDAV, GroupDAV, iMIP and iTIP and reuses existing IMAP, SMTP and database servers - making the solution easy to deploy and interoperable with many applications. + +## SOGo Features + +* Scalable architecture suitable for deployments from dozens to many thousands of users +* Rich Web-based interface that shares the look and feel, the features and the data of Mozilla +Thunderbird and Lightning +* Improved integration with Mozilla Thunderbird and Lightning by using the SOGo Connector and the SOGo Integrator +* Two-way synchronization support with any SyncML-capable devices (BlackBerry, Palm, Windows CE, etc.) by using the Funambol SOGo Connector + +Standard protocols such as CalDAV, CardDAV, GroupDAV, HTTP, IMAP and SMTP are used to communicate with the SOGo platform or its sub-components. Mobile devices supporting the SyncML standard use the Funambol middleware to synchronize information. + +To install and configure the native Microsoft Outlook compatibility layer, please refer to the [SOGo Native Microsoft Outlook Configuration Guide](). + +## Prerequisites + +SOGo reuses many components in an infrastructure. Thus, it requires the following: + +* Database server (e.g. [MySQL](https://www.digitalocean.com/community/community_tags/mysql) or [PostgreSQL](https://www.digitalocean.com/community/community_tags/postgresql)); +* LDAP server (e.g. OpenLDAP); +* SMTP server (e.g. [Postfix](https://www.digitalocean.com/community/articles/how-to-install-and-setup-postfix-on-ubuntu-12-04)); +* IMAP server (e.g. Dovecot). + +This guide assumes that (i.) all of those components are running on the same server (i.e. "localhost" or "127.0.0.1") (ii.) on which you will install SOGo. + +## Installation + +SOGo supports the following 32-bit and 64-bit operating systems: + +* Ubuntu 8.10 (Intrepid) to 12.04 (Precise) +* Community ENTerprise Operating System (CentOS) 5 and 6 +* [Debian GNU/Linux 5.0 (Lenny) to 7.0 (Wheezy)](http://www.sogo.nu/english/nc/support/faq/article/how-to-install-sogo-on-debian-2.html) +* Red Hat Enterprise Linux (RHEL) Server 5 and 6 + +### Ubuntu Precise Pangolin (12.04) + +If you are running Ubuntu, you must first add the SOGo repository to your `apt source list`, by executing the following commands: + + sudo vi /etc/apt/sources.list + +Then, on your keyboard, tap on the `i` key and append the line, below, to the end of your current list: + + deb http://inverse.ca/ubuntu precise precise + +Then, tap the following keystrokes: `Esc` followed by `:` and `w` and `q` and, finally, `enter`. + +Next, you must add SOGo's GPG public key to Ubuntu's `apt keyring`. To do so, execute the following commands: + + sudo apt-key adv --keyserver keys.gnupg.net --recv-key 0x810273C4 + +Then, update your lists of available software packages, by executing: + + sudo apt-get update + +Finally, execute: + + sudo apt-get -y install sogo + +Next, install the following additional packages: + + sudo apt-get -y install binutils-doc gcc-4.6-locales gcc-4.6-multilib libmudflap0-4.6-dev gcc-4.6-doc libgcc1-dbg libgomp1-dbg libquadmath0-dbg libmudflap0-dbg binutils-gold gnustep-base-doc gnustep-make-doc gobjc-4.6-multilib libobjc3-dbg glibc-doc libcache-memcached-perl nginx mysql-server + +Then, create a custom nginx config file for SOGo. To do so, execute: + + sudo vi /etc/nginx/sites-enabled/sogo.yourdomain.tld + +Next, copy the following and paste it into the newly-created file (replace `sogo.yourdomain.tld` with your FQDN): + + server { + + listen 80 default; + server_name sogo.yourdomain.tld; + + # redirect http to https + rewrite ^ https://$server_name$request_uri? permanent; + } + server { + + listen 443; + server_name sogo.yourdomain.tld; + root /usr/lib/GNUstep/SOGo/WebServerResources/; + ssl on; + ssl_certificate /etc/nginx/sslcerts/mycertificate.crt; + ssl_certificate_key /etc/nginx/sslcerts/mykey.key; + location = / { + rewrite ^ https://$server_name/SOGo; + allow all; + } + location ^~/SOGo { + proxy_pass http://127.0.0.1:20000; + proxy_redirect http://127.0.0.1:20000 default; + + # forward user's IP address + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header Host $host; + proxy_set_header x-webobjects-server-protocol HTTP/1.0; + proxy_set_header x-webobjects-remote-host 127.0.0.1; + proxy_set_header x-webobjects-server-name $server_name; + proxy_set_header x-webobjects-server-url $scheme://$host; + proxy_connect_timeout 90; + proxy_send_timeout 90; + proxy_read_timeout 90; + proxy_buffer_size 4k; + proxy_buffers 4 32k; + proxy_busy_buffers_size 64k; + proxy_temp_file_write_size 64k; + client_max_body_size 50m; + client_body_buffer_size 128k; + break; + } + location /SOGo.woa/WebServerResources/ { + alias /usr/lib/GNUstep/SOGo/WebServerResources/; + allow all; + } + location /SOGo/WebServerResources/ { + alias /usr/lib/GNUstep/SOGo/WebServerResources/; + allow all; + } + location ^/SOGo/so/ControlPanel/Products/([^/]*)/Resources/(.*)$ { + alias /usr/lib/GNUstep/SOGo/$1.SOGo/Resources/$2; + } + location ^/SOGo/so/ControlPanel/Products/[^/]*UI/Resources/.*\.(jpg|png|gif|css|js)$ { + alias /usr/lib/GNUstep/SOGo/$1.SOGo/Resources/$2; + } + } + +Nginx will rewrite all unsecured requests on port 80 to https on port 443. Consequently, ensure that these two ports are open if you have deployed a firewall. *See* [How to Setup a Firewall with UFW on an Ubuntu and Debian Cloud Server](https://www.digitalocean.com/community/articles/how-to-setup-a-firewall-with-ufw-on-an-ubuntu-and-debian-cloud-server); or [How To Setup a Basic IP Tables Configuration on Centos 6](https://www.digitalocean.com/community/articles/how-to-setup-a-basic-ip-tables-configuration-on-centos-6). + +### RPM-based Distributions: Red Hat or CentOS + +SOGo can be installed using the yum utility. To do so, first create the +`/etc/yum.repos.d/inverse.repo` configuration file with the following content: + + [SOGo] + name=Inverse SOGo Repository + baseurl=http://inverse.ca/downloads/SOGo/RHEL6/$basearch + gpgcheck=0 + +Some of the softwares on which SOGo depends are available from the repository of RepoForge (previously known as RPMforge). To add RepoForge to your packages sources, download and install the appropriate RPM package from [http://packages.sw.be/rpmforge-release/](http://packages.sw.be/rpmforge-release/). Also make sure you enabled the “rpmforge-extras” repository. For more information on using RepoForge, visit [http://repoforge.org/use/](http://repoforge.org/use/) + +Once the yum configuration file has been created, you are now ready to install SOGo and its dependencies. To do so, proceed with the following command: + + yum install sogo + +This will install SOGo and its dependencies such as GNUstep, the SOPE packages and memcached. Once the base packages are installed, you need to install the proper database connector suitable for your environment. + +You need to install `sope49-gdl1-postgresql` for the PostgreSQL database system or `sope49-gdl1-mysql` for MySQL. The installation command will thus look like this: + + yum install sope49-gdl1-postgresql + +Once completed, SOGo will be fully installed on your server. You are now ready to configure it. + +## Configuration + +In SOGo, users' applications settings are stored in `/etc/sogo/sogo.conf`. You can use your favorite text editor to modify the file. + +## Additional Resources + +* [Link1](); +* [Link2](); +* [Link3](). + +# ~~~~~~~~~~ DRAFT ~~~~~~~~~~ +*[Pull Requests](https://github.com/DigitalOcean-User-Projects/Articles-and-Tutorials/pulls) gladly accepted* \ No newline at end of file From 92d68de332290863570e0661abdf03d348a07755 Mon Sep 17 00:00:00 2001 From: Pablo Carranza Date: Sat, 19 Oct 2013 12:25:19 -0500 Subject: [PATCH 2/8] Update ubuntu_postgresql.md --- tutorials/ubuntu_postgresql.md | 34 ++++++---------------------------- 1 file changed, 6 insertions(+), 28 deletions(-) diff --git a/tutorials/ubuntu_postgresql.md b/tutorials/ubuntu_postgresql.md index 3ad7abacd..2d4c0fa6b 100644 --- a/tutorials/ubuntu_postgresql.md +++ b/tutorials/ubuntu_postgresql.md @@ -1,5 +1,5 @@ # ~~~~~~~~~~ DRAFT ~~~~~~~~~~ -*[Pull Requests](https://github.com/DigitalOcean-User-Projects/Articles-and-Tutorials/pulls) gladly accepted* +*[Pull Requests](https://github.com/vDevices/sogo/pulls) gladly accepted* How To Install & Configure SOGo - an Open-Source Alternative to Microsoft Exchange ===== @@ -25,9 +25,9 @@ To install and configure the native Microsoft Outlook compatibility layer, pleas SOGo reuses many components in an infrastructure. Thus, it requires the following: -* Database server (e.g. [MySQL](https://www.digitalocean.com/community/community_tags/mysql) or [PostgreSQL](https://www.digitalocean.com/community/community_tags/postgresql)); +* Database server (e.g. MySQL or PostgreSQL; * LDAP server (e.g. OpenLDAP); -* SMTP server (e.g. [Postfix](https://www.digitalocean.com/community/articles/how-to-install-and-setup-postfix-on-ubuntu-12-04)); +* SMTP server (e.g. Postfix; * IMAP server (e.g. Dovecot). This guide assumes that (i.) all of those components are running on the same server (i.e. "localhost" or "127.0.0.1") (ii.) on which you will install SOGo. @@ -67,7 +67,7 @@ Finally, execute: Next, install the following additional packages: - sudo apt-get -y install binutils-doc gcc-4.6-locales gcc-4.6-multilib libmudflap0-4.6-dev gcc-4.6-doc libgcc1-dbg libgomp1-dbg libquadmath0-dbg libmudflap0-dbg binutils-gold gnustep-base-doc gnustep-make-doc gobjc-4.6-multilib libobjc3-dbg glibc-doc libcache-memcached-perl nginx mysql-server + sudo apt-get -y install binutils-doc gcc-4.6-locales gcc-4.6-multilib libmudflap0-4.6-dev gcc-4.6-doc libgcc1-dbg libgomp1-dbg libquadmath0-dbg libmudflap0-dbg binutils-gold gnustep-base-doc gnustep-make-doc gobjc-4.6-multilib libobjc3-dbg glibc-doc libcache-memcached-perl nginx Then, create a custom nginx config file for SOGo. To do so, execute: @@ -134,29 +134,7 @@ Next, copy the following and paste it into the newly-created file (replace `sogo } } -Nginx will rewrite all unsecured requests on port 80 to https on port 443. Consequently, ensure that these two ports are open if you have deployed a firewall. *See* [How to Setup a Firewall with UFW on an Ubuntu and Debian Cloud Server](https://www.digitalocean.com/community/articles/how-to-setup-a-firewall-with-ufw-on-an-ubuntu-and-debian-cloud-server); or [How To Setup a Basic IP Tables Configuration on Centos 6](https://www.digitalocean.com/community/articles/how-to-setup-a-basic-ip-tables-configuration-on-centos-6). - -### RPM-based Distributions: Red Hat or CentOS - -SOGo can be installed using the yum utility. To do so, first create the -`/etc/yum.repos.d/inverse.repo` configuration file with the following content: - - [SOGo] - name=Inverse SOGo Repository - baseurl=http://inverse.ca/downloads/SOGo/RHEL6/$basearch - gpgcheck=0 - -Some of the softwares on which SOGo depends are available from the repository of RepoForge (previously known as RPMforge). To add RepoForge to your packages sources, download and install the appropriate RPM package from [http://packages.sw.be/rpmforge-release/](http://packages.sw.be/rpmforge-release/). Also make sure you enabled the “rpmforge-extras” repository. For more information on using RepoForge, visit [http://repoforge.org/use/](http://repoforge.org/use/) - -Once the yum configuration file has been created, you are now ready to install SOGo and its dependencies. To do so, proceed with the following command: - - yum install sogo - -This will install SOGo and its dependencies such as GNUstep, the SOPE packages and memcached. Once the base packages are installed, you need to install the proper database connector suitable for your environment. - -You need to install `sope49-gdl1-postgresql` for the PostgreSQL database system or `sope49-gdl1-mysql` for MySQL. The installation command will thus look like this: - - yum install sope49-gdl1-postgresql +Nginx will rewrite all unsecured requests on port 80 to https on port 443. Consequently, ensure that these two ports are open if you have deployed a firewall. Once completed, SOGo will be fully installed on your server. You are now ready to configure it. @@ -171,4 +149,4 @@ In SOGo, users' applications settings are stored in `/etc/sogo/sogo.conf`. You c * [Link3](). # ~~~~~~~~~~ DRAFT ~~~~~~~~~~ -*[Pull Requests](https://github.com/DigitalOcean-User-Projects/Articles-and-Tutorials/pulls) gladly accepted* \ No newline at end of file +*[Pull Requests](https://github.com/vDevices/sogo/pulls) gladly accepted* From aa791b257116d1adf03257c4e9f5848a9e6b130c Mon Sep 17 00:00:00 2001 From: Pablo Carranza Date: Sat, 19 Oct 2013 12:42:31 -0500 Subject: [PATCH 3/8] Create README.md --- README.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 000000000..f85be6e0e --- /dev/null +++ b/README.md @@ -0,0 +1,24 @@ +SOGo +==== + +Share your calendars, address books and mails in your community with a completely free and open source solution. + +Let your Mozilla Thunderbird/Lightning, Microsoft Outlook, Apple iCal/iPhone and BlackBerry users collaborate using a modern platform. + +## What is SOGo? + +SOGo is [fully supported](http://www.sogo.nu/support/commercial_support.html) and [trusted](http://www.sogo.nu/tour/testimonials.html) groupware server with a focus on scalability and open standards. SOGo is released under the GNU GPL/LGPL v2 and above. + +SOGo provides a rich AJAX-based Web interface and supports multiple native clients through the use of standard protocols such as CalDAV, CardDAV and GroupDAV. + +SOGo is the missing component of your infrastructure; it sits in the middle of your servers to offer your users an uniform and complete interface to access their information. It has been deployed in production environments where thousands of users are involved. + +[Learn more...](http://www.sogo.nu/about/overview.html) + +## Microsoft Outlook Compatible + +SOGo offers native Microsoft Outlook compatibility using the [OpenChange](http://www.openchange.org/) backend developed by [Inverse](http://www.inverse.ca/). This means Microsoft Outlook 2003, 2007 and 2010 can talk directly to SOGo – just like if it was a Microsoft Exchange server. **No plugins are required in Outlook to make this work**. + +The following screencast shows Outlook 2010 connected to SOGo as if it was an Exchange server, along the Web interface of SOGo. + +![Screencast](http://youtu.be/1hcBSB4Kxww) From 1d8e6b6295b75493c839b8330acb19448a9ed7cd Mon Sep 17 00:00:00 2001 From: Pablo Carranza Date: Sat, 19 Oct 2013 13:03:40 -0500 Subject: [PATCH 4/8] Update README.md --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index f85be6e0e..f0b12a3c6 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,4 @@ -SOGo -==== +![SOGo Logo](http://www.sogo.nu/fileadmin/sogo/logos/sogo.logo.v2.final.png) Share your calendars, address books and mails in your community with a completely free and open source solution. @@ -13,6 +12,8 @@ SOGo provides a rich AJAX-based Web interface and supports multiple native clien SOGo is the missing component of your infrastructure; it sits in the middle of your servers to offer your users an uniform and complete interface to access their information. It has been deployed in production environments where thousands of users are involved. +![Sogo diagram](http://www.sogo.nu/uploads/pics/sogo.png) + [Learn more...](http://www.sogo.nu/about/overview.html) ## Microsoft Outlook Compatible @@ -21,4 +22,4 @@ SOGo offers native Microsoft Outlook compatibility using the [OpenChange](http:/ The following screencast shows Outlook 2010 connected to SOGo as if it was an Exchange server, along the Web interface of SOGo. -![Screencast](http://youtu.be/1hcBSB4Kxww) +[![SOGo Screencast](http://img.youtube.com/vi/1hcBSB4Kxww/0.jpg)](http://www.youtube.com/watch?v=1hcBSB4Kxww) From 5f4ab6eaaff9f7248d9561b019b12cd61d407428 Mon Sep 17 00:00:00 2001 From: Pablo Carranza Date: Sat, 19 Oct 2013 13:11:36 -0500 Subject: [PATCH 5/8] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index f0b12a3c6..c976bce5e 100644 --- a/README.md +++ b/README.md @@ -23,3 +23,5 @@ SOGo offers native Microsoft Outlook compatibility using the [OpenChange](http:/ The following screencast shows Outlook 2010 connected to SOGo as if it was an Exchange server, along the Web interface of SOGo. [![SOGo Screencast](http://img.youtube.com/vi/1hcBSB4Kxww/0.jpg)](http://www.youtube.com/watch?v=1hcBSB4Kxww) + +[![SOGo on GitHub](http://www.sogo.nu/fileadmin/images/icon.github.png)](https://github.com/inverse-inc/sogo/) [![SOGo Ohloh](http://www.sogo.nu/fileadmin/images/icon.ohloh.png)](https://www.ohloh.net/p/sogo) [![SOGo on Twitter](http://www.sogo.nu/fileadmin/images/icon.twitter.png)](http://twitter.com/scalableogo) [![SOGo on SourceForge](http://www.sogo.nu/fileadmin/images/icon.sourceforge.png)](http://sourceforge.net/projects/sogo-zeg) [![SOGo on free code](http://www.sogo.nu/fileadmin/images/icon.freecode.png)](https://freecode.com/projects/sogo-inverse) [![SOGo on LinkedIn](http://www.sogo.nu/fileadmin/images/icon.linkedin.png)](http://www.linkedin.com/groups/SOGo-Groupware-4164805) From 54cd55ebefec9b4a404312e3b6d4910f2024c747 Mon Sep 17 00:00:00 2001 From: Pablo Carranza Date: Sat, 19 Oct 2013 13:15:13 -0500 Subject: [PATCH 6/8] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index c976bce5e..9444e1f3f 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -![SOGo Logo](http://www.sogo.nu/fileadmin/sogo/logos/sogo.logo.v2.final.png) +[![SOGo Logo](http://www.sogo.nu/fileadmin/sogo/logos/sogo.logo.v2.final.png)](http://www.sogo.nu/) Share your calendars, address books and mails in your community with a completely free and open source solution. @@ -12,7 +12,7 @@ SOGo provides a rich AJAX-based Web interface and supports multiple native clien SOGo is the missing component of your infrastructure; it sits in the middle of your servers to offer your users an uniform and complete interface to access their information. It has been deployed in production environments where thousands of users are involved. -![Sogo diagram](http://www.sogo.nu/uploads/pics/sogo.png) +[![Sogo diagram](http://www.sogo.nu/uploads/pics/sogo.png)](http://www.sogo.nu/) [Learn more...](http://www.sogo.nu/about/overview.html) From eb5ca2cba6d0eb41b3e917b9b455d4431add3498 Mon Sep 17 00:00:00 2001 From: Pablo Carranza Date: Tue, 5 Nov 2013 22:31:54 -0600 Subject: [PATCH 7/8] Revert "Update ubuntu_postgresql.md" This reverts commit 92d68de332290863570e0661abdf03d348a07755. --- tutorials/ubuntu_postgresql.md | 34 ++++++++++++++++++++++++++++------ 1 file changed, 28 insertions(+), 6 deletions(-) diff --git a/tutorials/ubuntu_postgresql.md b/tutorials/ubuntu_postgresql.md index 2d4c0fa6b..3ad7abacd 100644 --- a/tutorials/ubuntu_postgresql.md +++ b/tutorials/ubuntu_postgresql.md @@ -1,5 +1,5 @@ # ~~~~~~~~~~ DRAFT ~~~~~~~~~~ -*[Pull Requests](https://github.com/vDevices/sogo/pulls) gladly accepted* +*[Pull Requests](https://github.com/DigitalOcean-User-Projects/Articles-and-Tutorials/pulls) gladly accepted* How To Install & Configure SOGo - an Open-Source Alternative to Microsoft Exchange ===== @@ -25,9 +25,9 @@ To install and configure the native Microsoft Outlook compatibility layer, pleas SOGo reuses many components in an infrastructure. Thus, it requires the following: -* Database server (e.g. MySQL or PostgreSQL; +* Database server (e.g. [MySQL](https://www.digitalocean.com/community/community_tags/mysql) or [PostgreSQL](https://www.digitalocean.com/community/community_tags/postgresql)); * LDAP server (e.g. OpenLDAP); -* SMTP server (e.g. Postfix; +* SMTP server (e.g. [Postfix](https://www.digitalocean.com/community/articles/how-to-install-and-setup-postfix-on-ubuntu-12-04)); * IMAP server (e.g. Dovecot). This guide assumes that (i.) all of those components are running on the same server (i.e. "localhost" or "127.0.0.1") (ii.) on which you will install SOGo. @@ -67,7 +67,7 @@ Finally, execute: Next, install the following additional packages: - sudo apt-get -y install binutils-doc gcc-4.6-locales gcc-4.6-multilib libmudflap0-4.6-dev gcc-4.6-doc libgcc1-dbg libgomp1-dbg libquadmath0-dbg libmudflap0-dbg binutils-gold gnustep-base-doc gnustep-make-doc gobjc-4.6-multilib libobjc3-dbg glibc-doc libcache-memcached-perl nginx + sudo apt-get -y install binutils-doc gcc-4.6-locales gcc-4.6-multilib libmudflap0-4.6-dev gcc-4.6-doc libgcc1-dbg libgomp1-dbg libquadmath0-dbg libmudflap0-dbg binutils-gold gnustep-base-doc gnustep-make-doc gobjc-4.6-multilib libobjc3-dbg glibc-doc libcache-memcached-perl nginx mysql-server Then, create a custom nginx config file for SOGo. To do so, execute: @@ -134,7 +134,29 @@ Next, copy the following and paste it into the newly-created file (replace `sogo } } -Nginx will rewrite all unsecured requests on port 80 to https on port 443. Consequently, ensure that these two ports are open if you have deployed a firewall. +Nginx will rewrite all unsecured requests on port 80 to https on port 443. Consequently, ensure that these two ports are open if you have deployed a firewall. *See* [How to Setup a Firewall with UFW on an Ubuntu and Debian Cloud Server](https://www.digitalocean.com/community/articles/how-to-setup-a-firewall-with-ufw-on-an-ubuntu-and-debian-cloud-server); or [How To Setup a Basic IP Tables Configuration on Centos 6](https://www.digitalocean.com/community/articles/how-to-setup-a-basic-ip-tables-configuration-on-centos-6). + +### RPM-based Distributions: Red Hat or CentOS + +SOGo can be installed using the yum utility. To do so, first create the +`/etc/yum.repos.d/inverse.repo` configuration file with the following content: + + [SOGo] + name=Inverse SOGo Repository + baseurl=http://inverse.ca/downloads/SOGo/RHEL6/$basearch + gpgcheck=0 + +Some of the softwares on which SOGo depends are available from the repository of RepoForge (previously known as RPMforge). To add RepoForge to your packages sources, download and install the appropriate RPM package from [http://packages.sw.be/rpmforge-release/](http://packages.sw.be/rpmforge-release/). Also make sure you enabled the “rpmforge-extras” repository. For more information on using RepoForge, visit [http://repoforge.org/use/](http://repoforge.org/use/) + +Once the yum configuration file has been created, you are now ready to install SOGo and its dependencies. To do so, proceed with the following command: + + yum install sogo + +This will install SOGo and its dependencies such as GNUstep, the SOPE packages and memcached. Once the base packages are installed, you need to install the proper database connector suitable for your environment. + +You need to install `sope49-gdl1-postgresql` for the PostgreSQL database system or `sope49-gdl1-mysql` for MySQL. The installation command will thus look like this: + + yum install sope49-gdl1-postgresql Once completed, SOGo will be fully installed on your server. You are now ready to configure it. @@ -149,4 +171,4 @@ In SOGo, users' applications settings are stored in `/etc/sogo/sogo.conf`. You c * [Link3](). # ~~~~~~~~~~ DRAFT ~~~~~~~~~~ -*[Pull Requests](https://github.com/vDevices/sogo/pulls) gladly accepted* +*[Pull Requests](https://github.com/DigitalOcean-User-Projects/Articles-and-Tutorials/pulls) gladly accepted* \ No newline at end of file From 2d5f2d88fa1ca7c49e55fabb42fb5e382bfdfe99 Mon Sep 17 00:00:00 2001 From: Pablo Carranza Date: Tue, 5 Nov 2013 22:32:35 -0600 Subject: [PATCH 8/8] Revert "Started Ubuntu w/PostgreSQL tutorial" This reverts commit 51d23729763cfa3d4d67f41fb154a7130ea1025d. --- tutorials/ubuntu_postgresql.md | 174 --------------------------------- 1 file changed, 174 deletions(-) delete mode 100644 tutorials/ubuntu_postgresql.md diff --git a/tutorials/ubuntu_postgresql.md b/tutorials/ubuntu_postgresql.md deleted file mode 100644 index 3ad7abacd..000000000 --- a/tutorials/ubuntu_postgresql.md +++ /dev/null @@ -1,174 +0,0 @@ -# ~~~~~~~~~~ DRAFT ~~~~~~~~~~ -*[Pull Requests](https://github.com/DigitalOcean-User-Projects/Articles-and-Tutorials/pulls) gladly accepted* -How To Install & Configure SOGo - an Open-Source Alternative to Microsoft Exchange -===== - -### Introduction - -SOGo is a free and modern scalable groupware server. It offers shared calendars, address books, and emails through your favourite Web browser and by using a native client such as Mozilla Thunderbird and Lightning. - -SOGo is standard-compliant. It supports CalDAV, CardDAV, GroupDAV, iMIP and iTIP and reuses existing IMAP, SMTP and database servers - making the solution easy to deploy and interoperable with many applications. - -## SOGo Features - -* Scalable architecture suitable for deployments from dozens to many thousands of users -* Rich Web-based interface that shares the look and feel, the features and the data of Mozilla -Thunderbird and Lightning -* Improved integration with Mozilla Thunderbird and Lightning by using the SOGo Connector and the SOGo Integrator -* Two-way synchronization support with any SyncML-capable devices (BlackBerry, Palm, Windows CE, etc.) by using the Funambol SOGo Connector - -Standard protocols such as CalDAV, CardDAV, GroupDAV, HTTP, IMAP and SMTP are used to communicate with the SOGo platform or its sub-components. Mobile devices supporting the SyncML standard use the Funambol middleware to synchronize information. - -To install and configure the native Microsoft Outlook compatibility layer, please refer to the [SOGo Native Microsoft Outlook Configuration Guide](). - -## Prerequisites - -SOGo reuses many components in an infrastructure. Thus, it requires the following: - -* Database server (e.g. [MySQL](https://www.digitalocean.com/community/community_tags/mysql) or [PostgreSQL](https://www.digitalocean.com/community/community_tags/postgresql)); -* LDAP server (e.g. OpenLDAP); -* SMTP server (e.g. [Postfix](https://www.digitalocean.com/community/articles/how-to-install-and-setup-postfix-on-ubuntu-12-04)); -* IMAP server (e.g. Dovecot). - -This guide assumes that (i.) all of those components are running on the same server (i.e. "localhost" or "127.0.0.1") (ii.) on which you will install SOGo. - -## Installation - -SOGo supports the following 32-bit and 64-bit operating systems: - -* Ubuntu 8.10 (Intrepid) to 12.04 (Precise) -* Community ENTerprise Operating System (CentOS) 5 and 6 -* [Debian GNU/Linux 5.0 (Lenny) to 7.0 (Wheezy)](http://www.sogo.nu/english/nc/support/faq/article/how-to-install-sogo-on-debian-2.html) -* Red Hat Enterprise Linux (RHEL) Server 5 and 6 - -### Ubuntu Precise Pangolin (12.04) - -If you are running Ubuntu, you must first add the SOGo repository to your `apt source list`, by executing the following commands: - - sudo vi /etc/apt/sources.list - -Then, on your keyboard, tap on the `i` key and append the line, below, to the end of your current list: - - deb http://inverse.ca/ubuntu precise precise - -Then, tap the following keystrokes: `Esc` followed by `:` and `w` and `q` and, finally, `enter`. - -Next, you must add SOGo's GPG public key to Ubuntu's `apt keyring`. To do so, execute the following commands: - - sudo apt-key adv --keyserver keys.gnupg.net --recv-key 0x810273C4 - -Then, update your lists of available software packages, by executing: - - sudo apt-get update - -Finally, execute: - - sudo apt-get -y install sogo - -Next, install the following additional packages: - - sudo apt-get -y install binutils-doc gcc-4.6-locales gcc-4.6-multilib libmudflap0-4.6-dev gcc-4.6-doc libgcc1-dbg libgomp1-dbg libquadmath0-dbg libmudflap0-dbg binutils-gold gnustep-base-doc gnustep-make-doc gobjc-4.6-multilib libobjc3-dbg glibc-doc libcache-memcached-perl nginx mysql-server - -Then, create a custom nginx config file for SOGo. To do so, execute: - - sudo vi /etc/nginx/sites-enabled/sogo.yourdomain.tld - -Next, copy the following and paste it into the newly-created file (replace `sogo.yourdomain.tld` with your FQDN): - - server { - - listen 80 default; - server_name sogo.yourdomain.tld; - - # redirect http to https - rewrite ^ https://$server_name$request_uri? permanent; - } - server { - - listen 443; - server_name sogo.yourdomain.tld; - root /usr/lib/GNUstep/SOGo/WebServerResources/; - ssl on; - ssl_certificate /etc/nginx/sslcerts/mycertificate.crt; - ssl_certificate_key /etc/nginx/sslcerts/mykey.key; - location = / { - rewrite ^ https://$server_name/SOGo; - allow all; - } - location ^~/SOGo { - proxy_pass http://127.0.0.1:20000; - proxy_redirect http://127.0.0.1:20000 default; - - # forward user's IP address - proxy_set_header X-Real-IP $remote_addr; - proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; - proxy_set_header Host $host; - proxy_set_header x-webobjects-server-protocol HTTP/1.0; - proxy_set_header x-webobjects-remote-host 127.0.0.1; - proxy_set_header x-webobjects-server-name $server_name; - proxy_set_header x-webobjects-server-url $scheme://$host; - proxy_connect_timeout 90; - proxy_send_timeout 90; - proxy_read_timeout 90; - proxy_buffer_size 4k; - proxy_buffers 4 32k; - proxy_busy_buffers_size 64k; - proxy_temp_file_write_size 64k; - client_max_body_size 50m; - client_body_buffer_size 128k; - break; - } - location /SOGo.woa/WebServerResources/ { - alias /usr/lib/GNUstep/SOGo/WebServerResources/; - allow all; - } - location /SOGo/WebServerResources/ { - alias /usr/lib/GNUstep/SOGo/WebServerResources/; - allow all; - } - location ^/SOGo/so/ControlPanel/Products/([^/]*)/Resources/(.*)$ { - alias /usr/lib/GNUstep/SOGo/$1.SOGo/Resources/$2; - } - location ^/SOGo/so/ControlPanel/Products/[^/]*UI/Resources/.*\.(jpg|png|gif|css|js)$ { - alias /usr/lib/GNUstep/SOGo/$1.SOGo/Resources/$2; - } - } - -Nginx will rewrite all unsecured requests on port 80 to https on port 443. Consequently, ensure that these two ports are open if you have deployed a firewall. *See* [How to Setup a Firewall with UFW on an Ubuntu and Debian Cloud Server](https://www.digitalocean.com/community/articles/how-to-setup-a-firewall-with-ufw-on-an-ubuntu-and-debian-cloud-server); or [How To Setup a Basic IP Tables Configuration on Centos 6](https://www.digitalocean.com/community/articles/how-to-setup-a-basic-ip-tables-configuration-on-centos-6). - -### RPM-based Distributions: Red Hat or CentOS - -SOGo can be installed using the yum utility. To do so, first create the -`/etc/yum.repos.d/inverse.repo` configuration file with the following content: - - [SOGo] - name=Inverse SOGo Repository - baseurl=http://inverse.ca/downloads/SOGo/RHEL6/$basearch - gpgcheck=0 - -Some of the softwares on which SOGo depends are available from the repository of RepoForge (previously known as RPMforge). To add RepoForge to your packages sources, download and install the appropriate RPM package from [http://packages.sw.be/rpmforge-release/](http://packages.sw.be/rpmforge-release/). Also make sure you enabled the “rpmforge-extras” repository. For more information on using RepoForge, visit [http://repoforge.org/use/](http://repoforge.org/use/) - -Once the yum configuration file has been created, you are now ready to install SOGo and its dependencies. To do so, proceed with the following command: - - yum install sogo - -This will install SOGo and its dependencies such as GNUstep, the SOPE packages and memcached. Once the base packages are installed, you need to install the proper database connector suitable for your environment. - -You need to install `sope49-gdl1-postgresql` for the PostgreSQL database system or `sope49-gdl1-mysql` for MySQL. The installation command will thus look like this: - - yum install sope49-gdl1-postgresql - -Once completed, SOGo will be fully installed on your server. You are now ready to configure it. - -## Configuration - -In SOGo, users' applications settings are stored in `/etc/sogo/sogo.conf`. You can use your favorite text editor to modify the file. - -## Additional Resources - -* [Link1](); -* [Link2](); -* [Link3](). - -# ~~~~~~~~~~ DRAFT ~~~~~~~~~~ -*[Pull Requests](https://github.com/DigitalOcean-User-Projects/Articles-and-Tutorials/pulls) gladly accepted* \ No newline at end of file