This manual is deprecated. Please visit https://groupoffice.readthedocs.io for the latest documentation.

Difference between revisions of "Installing on Debian or Ubuntu"

From Group-Office Groupware and CRM Documentation
Jump to: navigation, search
(Ubuntu 12.04 specific)
(The main package)
 
(55 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
This is the easiest way of installing Group-Office. With the Debian packages everything is configured automatically and Group-Office updates will be installed automatically when you update your Debian or Ubuntu system.
 
This is the easiest way of installing Group-Office. With the Debian packages everything is configured automatically and Group-Office updates will be installed automatically when you update your Debian or Ubuntu system.
  
Install Debian >= 5 or Ubuntu >=8.10
+
Install Debian >= 8 or Ubuntu >= 16.10
  
 
<b>Note:</b> All the commands here use "sudo". This is necessary on Ubuntu. If you are on Debian you can use the "su" command first and execute all the commands without "sudo".
 
<b>Note:</b> All the commands here use "sudo". This is necessary on Ubuntu. If you are on Debian you can use the "su" command first and execute all the commands without "sudo".
Line 9: Line 9:
  
 
<pre>
 
<pre>
deb http://repos.groupoffice.eu/ fourzero main
+
deb http://repos.groupoffice.eu/ sixtwo main
 
</pre>
 
</pre>
 +
 +
<b>Note:</b> If you run php 7.1 you need a different build because Ioncube is not backwards compatible. Replace "sixtwo" with "sixtwo-php-7.1"
  
 
You can do that easily by executing the following command in the terminal:
 
You can do that easily by executing the following command in the terminal:
  
 
<pre>
 
<pre>
echo -e "\n## Group-Office repository\ndeb http://repos.groupoffice.eu/ fourzero main" | sudo tee -a /etc/apt/sources.list
+
echo -e "\n## Group-Office repository\ndeb http://repos.groupoffice.eu/ sixtwo main" | sudo tee -a /etc/apt/sources.list
 
</pre>
 
</pre>
  
 +
==Public key==
 
To authenticate the packages you need to import the public key by running the following commands:
 
To authenticate the packages you need to import the public key by running the following commands:
 
In Ubuntu don't do this as root because you will have trouble with the gpg keyring permissions. On Debian you can do this as root and omit the sudo command before the apt-key add command.
 
In Ubuntu don't do this as root because you will have trouble with the gpg keyring permissions. On Debian you can do this as root and omit the sudo command before the apt-key add command.
  
 
<pre>
 
<pre>
gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys 01F1AE44
+
gpg --keyserver pool.sks-keyservers.net --recv-keys 0758838B
gpg --export --armor 01F1AE44 | sudo apt-key add -
+
gpg --export --armor 0758838B | sudo apt-key add -
 +
</pre>
 +
 
 +
If that does not work, then try it over port 80
 +
 
 +
<pre>
 +
gpg --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 0758838B
 +
gpg --export --armor 0758838B | sudo apt-key add -
 
</pre>
 
</pre>
  
 
<b>Note:</b> The keyservers are often very slow. If the keyserver doesn't respond you may try this one instead: hkp://pgp.mit.edu
 
<b>Note:</b> The keyservers are often very slow. If the keyserver doesn't respond you may try this one instead: hkp://pgp.mit.edu
  
 +
==Install the package==
 
Open a terminal and become root. On Debian you must execute the command "su" and on Ubuntu you must execute the command "sudo -s" to become root.
 
Open a terminal and become root. On Debian you must execute the command "su" and on Ubuntu you must execute the command "sudo -s" to become root.
  
Line 36: Line 47:
  
 
This will install groupoffice on http://yourhostname/groupoffice/. If you want to change the location read [[Moving Group-Office from it's default location]]
 
This will install groupoffice on http://yourhostname/groupoffice/. If you want to change the location read [[Moving Group-Office from it's default location]]
 +
 +
<b>Note:</b> It could be possible that you get a blank screen when you go to the Group-Office url. Most of the time this is caused with wrong rights on the "/home/groupoffice" folder. Please make sure that the webserver is able to read and write in these folder and it's subfolders.
  
 
=Complete mailserver solution=
 
=Complete mailserver solution=
<b>Warning:</b> If you install groupoffice-mailserver it will reconfigure the entire mail system. Use on a Debian or Ubuntu installation without a mailserver configuration.
+
<b>Warning:</b> If you install groupoffice-mailserver it will reconfigure the entire mail system. Use only on a fresh Debian or Ubuntu installation without a mailserver configuration. Basic knowledge of Postfix, Dovecot and SMTP is required. If you're uncertain you can purchase installation support from us.
 +
 
 
Install it with the following command:
 
Install it with the following command:
  
 
<pre>
 
<pre>
sudo apt-get install groupoffice-mailserver postfix postfix-mysql
+
sudo apt-get install groupoffice-mailserver postfix postfix-mysql dovecot-mysql dovecot-sieve dovecot-managesieved
 
</pre>
 
</pre>
  
 
+
Note: on the latest debian jessie I had to set this in /etc/clamd.conf:
==Ubuntu 12.04 specific ==
+
On Ubuntu 12.04 not everything will be installed with the Group-Office packages.
+
You need to install and configure some more packages:
+
 
+
* The package dovecot-mysql is not installed automatically. To install the package with the following command:
+
  
 
<pre>
 
<pre>
sudo apt-get install dovecot-mysql
+
AllowSupplementaryGroups true
 
</pre>
 
</pre>
  
* The ManageSieve plugin for Dovecot is not installed. To install this run the following command:
+
==Smart host for SMTP==
+
If you've put Group-Office into your existing network it's probably a good idea to send mail through your existing SMTP server. Edit /etc/postfix/main.cf and set:
<pre>
+
 
sudo apt-get install dovecot-managesieve
+
relayhost=smtp.example.com
</pre>
+
  
 
==Connecting an external mail client==
 
==Connecting an external mail client==
Line 71: Line 79:
 
Username: mailbox@hostname.com (Full e-mail address and not the Group-Office username)
 
Username: mailbox@hostname.com (Full e-mail address and not the Group-Office username)
 
Password: *****
 
Password: *****
 +
 +
 +
SMTP authentication is not enabled by default. If you'd like to enable it please read [[Mailserver#Enabling_TLS_and_SMTP_authentication]]
 +
 +
==Connected mail domains==
 +
When the mailserver package is installed it asks for a mail domain. This domain is entered in \$config['serverclient_domain']='domain.com'; If you'd like to add more you can simply enter them there in a comma separated list. eg. \$config['serverclient_domain']='domain.com,domain2.com';
 +
 +
The domains listed here are presented in the new user dialog so you can automatically create mailboxes for new Group-Office users. Also the passwords will stay in sync. [[Mailserver#Optionally_install_the_serverclient|Read more about the serverclient]].
  
 
=Video=
 
=Video=
 
Watch this on video to see how it's done:
 
Watch this on video to see how it's done:
  
<videoflash>XTaeEYb5lLE|560|340</videoflash>
+
<html>
 +
<iframe width="560" height="315" src="//www.youtube.com/embed/XTaeEYb5lLE" frameborder="0" allowfullscreen></iframe>
 +
</html>
  
 
=Professional version=
 
=Professional version=
 +
 +
==Debian 8 / Ubuntu 16.04==
 +
 +
1. Download the ioncube loaders for your system at http://www.ioncube.com/loaders.php
 +
 +
2. Unpack the loaders in "/usr/local/ioncube"
 +
 +
3. Create a file "ioncube.ini" in "/etc/php5/mods-available/" or "/etc/php/7.0/mods-available/" on systems with PHP 7.0+.
 +
 +
<pre>
 +
; priority=00
 +
zend_extension=/usr/local/ioncube/ioncube_loader_lin_<PHP-Version>.so
 +
</pre>
 +
''**Please note that <PHP-Version> only needs to be the Major.Minor version. So for example it needs to be: '''5.6''' for PHP version 5.6.17 (The full line will then be: zend_extension=/usr/local/ioncube/ioncube_loader_lin_5.6.so)''
 +
 +
4. Then execute the following command:
 +
 +
<pre>phpenmod ioncube</pre>
 +
 +
''**Please note that on older systems you'll need to use "php5enmod" instead.''
 +
 +
This creates a symlink "00-ioncube.ini" in both folders
 +
 +
<pre>
 +
/etc/php/7.0/apache2/conf.d/
 +
/etc/php/7.0/cli/conf.d/
 +
</pre>
 +
 +
5. Check if ioncube works with:
 +
 +
<pre>php -v</pre>
 +
 +
==Older systems==
 +
 +
 
To install the professional version you'll need a license from Intermesh. Ioncube needs to be installed too.
 
To install the professional version you'll need a license from Intermesh. Ioncube needs to be installed too.
  
Then install Ioncube:
+
If you've installed the groupoffice-com debian package you can run:
 +
 
 +
<pre>
 +
/usr/share/groupoffice-install-scripts/installIoncube.sh
 +
</pre>
 +
 
 +
Restart apache with:
 +
 
 +
<pre>
 +
service apache2 restart
 +
</pre>
 +
 
 +
Or you can do it manually:
  
 
# Look up the download link at http://www.ioncube.com/loaders.php. Right click on the download link and select copy link location.
 
# Look up the download link at http://www.ioncube.com/loaders.php. Right click on the download link and select copy link location.
Line 109: Line 174:
 
<pre>Zend Engine v2.2.0, Copyright (c) 1998-2007 Zend Technologies
 
<pre>Zend Engine v2.2.0, Copyright (c) 1998-2007 Zend Technologies
 
     with the ionCube PHP Loader v3.3.1, Copyright (c) 2002-2009, by ionCube Ltd., and</pre>
 
     with the ionCube PHP Loader v3.3.1, Copyright (c) 2002-2009, by ionCube Ltd., and</pre>
 +
 +
<b>Note:</b> It can happen that Ioncube is not installed for the PHP CLI Interpreter after this. A fix for it will be to run the following command on Debian/Ubuntu systems:
 +
<pre>
 +
cp /etc/php5/apache2/conf.d/00-ioncube.ini /etc/php5/cli/conf.d/
 +
</pre>
 +
This will add the Ioncube configuration also to the CLI interpreter.
 +
  
 
Now restart apache and your system is ready to run Group-Office professional. The existing installation can easily be upgraded. Use the instuctions from Intermesh when you purchase the professional version to install it.
 
Now restart apache and your system is ready to run Group-Office professional. The existing installation can easily be upgraded. Use the instuctions from Intermesh when you purchase the professional version to install it.
  
<b>Note:</b> If you use groupoffice-mailserver and you have a license for groupoffice.example.com for example. You must change the $config['serverclient_server_url'] in /etc/groupoffice/globalconfig.inc.php. Replace localhost with groupoffice.example.com because the license doesn't allow localhost to be used. If you change the admin password you should change the password in this file too:
+
<b>Note:</b> If you use groupoffice-mailserver and you have a license for groupoffice.example.com for example. You must change the $config['serverclient_server_url'] in /etc/groupoffice/globalconfig.inc.php. Replace localhost with groupoffice.example.com because the license doesn't allow localhost to be used:
  
 
<pre>
 
<pre>
 
GO will connect to this installation to add a mailbox. It is the full url to the Group-Office installation with the postfixadmin module installed.
 
GO will connect to this installation to add a mailbox. It is the full url to the Group-Office installation with the postfixadmin module installed.
 
$config['serverclient_server_url']='http://localhost/groupoffice/';
 
$config['serverclient_server_url']='http://localhost/groupoffice/';
#The admin account of GO. Remember to change the password here too if you change it.
 
$config['serverclient_username']='administrator';
 
$config['serverclient_password']='somepass';
 
 
</pre>
 
</pre>
  
 
+
==Licenses==
Put the licenses from the Intermesh Software Shop in /usr/share/groupoffice and then run:
+
Put the licenses from the Intermesh Software Shop in '''/usr/share/groupoffice''' and then login to Group-Office again. The professional modules should be available for installation now at Start menu -> Modules.
 
+
<pre>apt-get install groupoffice-pro</pre>
+
 
+
If you have the billing package too:
+
<pre>apt-get install groupoffice-billing</pre>
+
 
+
If you have the documents package too:
+
<pre>apt-get install groupoffice-documents</pre>
+

Latest revision as of 11:55, 7 November 2017

The main package

This is the easiest way of installing Group-Office. With the Debian packages everything is configured automatically and Group-Office updates will be installed automatically when you update your Debian or Ubuntu system.

Install Debian >= 8 or Ubuntu >= 16.10

Note: All the commands here use "sudo". This is necessary on Ubuntu. If you are on Debian you can use the "su" command first and execute all the commands without "sudo".

Add the following line to /etc/apt/sources.list

deb http://repos.groupoffice.eu/ sixtwo main

Note: If you run php 7.1 you need a different build because Ioncube is not backwards compatible. Replace "sixtwo" with "sixtwo-php-7.1"

You can do that easily by executing the following command in the terminal:

echo -e "\n## Group-Office repository\ndeb http://repos.groupoffice.eu/ sixtwo main" | sudo tee -a /etc/apt/sources.list

Public key

To authenticate the packages you need to import the public key by running the following commands: In Ubuntu don't do this as root because you will have trouble with the gpg keyring permissions. On Debian you can do this as root and omit the sudo command before the apt-key add command.

gpg --keyserver pool.sks-keyservers.net --recv-keys 0758838B
gpg --export --armor 0758838B | sudo apt-key add -

If that does not work, then try it over port 80

gpg --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 0758838B
gpg --export --armor 0758838B | sudo apt-key add -

Note: The keyservers are often very slow. If the keyserver doesn't respond you may try this one instead: hkp://pgp.mit.edu

Install the package

Open a terminal and become root. On Debian you must execute the command "su" and on Ubuntu you must execute the command "sudo -s" to become root.

sudo apt-get update
sudo apt-get install groupoffice-com

This will install groupoffice on http://yourhostname/groupoffice/. If you want to change the location read Moving Group-Office from it's default location

Note: It could be possible that you get a blank screen when you go to the Group-Office url. Most of the time this is caused with wrong rights on the "/home/groupoffice" folder. Please make sure that the webserver is able to read and write in these folder and it's subfolders.

Complete mailserver solution

Warning: If you install groupoffice-mailserver it will reconfigure the entire mail system. Use only on a fresh Debian or Ubuntu installation without a mailserver configuration. Basic knowledge of Postfix, Dovecot and SMTP is required. If you're uncertain you can purchase installation support from us.

Install it with the following command:

sudo apt-get install groupoffice-mailserver postfix postfix-mysql dovecot-mysql dovecot-sieve dovecot-managesieved

Note: on the latest debian jessie I had to set this in /etc/clamd.conf:

AllowSupplementaryGroups true

Smart host for SMTP

If you've put Group-Office into your existing network it's probably a good idea to send mail through your existing SMTP server. Edit /etc/postfix/main.cf and set:

relayhost=smtp.example.com

Connecting an external mail client

If Group-Office is configured with it's default mailserver configuration you can connect any IMAP client with these settings:

Host: your.hostname.com
Encryption: SSL
Protocol IMAP
Port: 993
Username: mailbox@hostname.com (Full e-mail address and not the Group-Office username) Password: *****


SMTP authentication is not enabled by default. If you'd like to enable it please read Mailserver#Enabling_TLS_and_SMTP_authentication

Connected mail domains

When the mailserver package is installed it asks for a mail domain. This domain is entered in \$config['serverclient_domain']='domain.com'; If you'd like to add more you can simply enter them there in a comma separated list. eg. \$config['serverclient_domain']='domain.com,domain2.com';

The domains listed here are presented in the new user dialog so you can automatically create mailboxes for new Group-Office users. Also the passwords will stay in sync. Read more about the serverclient.

Video

Watch this on video to see how it's done:

Professional version

Debian 8 / Ubuntu 16.04

1. Download the ioncube loaders for your system at http://www.ioncube.com/loaders.php

2. Unpack the loaders in "/usr/local/ioncube"

3. Create a file "ioncube.ini" in "/etc/php5/mods-available/" or "/etc/php/7.0/mods-available/" on systems with PHP 7.0+.

; priority=00
zend_extension=/usr/local/ioncube/ioncube_loader_lin_<PHP-Version>.so

**Please note that <PHP-Version> only needs to be the Major.Minor version. So for example it needs to be: 5.6 for PHP version 5.6.17 (The full line will then be: zend_extension=/usr/local/ioncube/ioncube_loader_lin_5.6.so)

4. Then execute the following command:

phpenmod ioncube

**Please note that on older systems you'll need to use "php5enmod" instead.

This creates a symlink "00-ioncube.ini" in both folders

/etc/php/7.0/apache2/conf.d/
/etc/php/7.0/cli/conf.d/

5. Check if ioncube works with:

php -v

Older systems

To install the professional version you'll need a license from Intermesh. Ioncube needs to be installed too.

If you've installed the groupoffice-com debian package you can run:

/usr/share/groupoffice-install-scripts/installIoncube.sh

Restart apache with:

service apache2 restart

Or you can do it manually:

  1. Look up the download link at http://www.ioncube.com/loaders.php. Right click on the download link and select copy link location.
  2. Go to your server terminal and do (The examples here are for the Linux x86 architecture. your filenames might be different):
sudo -s
cd /usr/local
wget <url from ioncube>/ioncube_loaders_xxx.tar.gz
tar zxf ioncube_loaders_xxx.tar.gz
rm ioncube_loaders_lin_xxx.tar.gz

Now create /etc/php5/conf.d/ioncube.ini and add this line:

Note: Don't forget to replace the file with the correct version.

zend_extension=/usr/local/ioncube/ioncube_loader_lin_5.3.so

or execute:

echo -e "\nzend_extension=/usr/local/ioncube/ioncube_loader_lin_5.3.so" | sudo tee -a /etc/php5/conf.d/ioncube.ini

php -v should show something like this now:

Zend Engine v2.2.0, Copyright (c) 1998-2007 Zend Technologies
    with the ionCube PHP Loader v3.3.1, Copyright (c) 2002-2009, by ionCube Ltd., and

Note: It can happen that Ioncube is not installed for the PHP CLI Interpreter after this. A fix for it will be to run the following command on Debian/Ubuntu systems:

cp /etc/php5/apache2/conf.d/00-ioncube.ini /etc/php5/cli/conf.d/

This will add the Ioncube configuration also to the CLI interpreter.


Now restart apache and your system is ready to run Group-Office professional. The existing installation can easily be upgraded. Use the instuctions from Intermesh when you purchase the professional version to install it.

Note: If you use groupoffice-mailserver and you have a license for groupoffice.example.com for example. You must change the $config['serverclient_server_url'] in /etc/groupoffice/globalconfig.inc.php. Replace localhost with groupoffice.example.com because the license doesn't allow localhost to be used:

GO will connect to this installation to add a mailbox. It is the full url to the Group-Office installation with the postfixadmin module installed.
$config['serverclient_server_url']='http://localhost/groupoffice/';

Licenses

Put the licenses from the Intermesh Software Shop in /usr/share/groupoffice and then login to Group-Office again. The professional modules should be available for installation now at Start menu -> Modules.