Difference between revisions of "OX6:UpdatingOXPackages"

(How to get updates?)
Line 1: Line 1:
= Updating Open-Xchange Server packages =
+
== Updating Open-Xchange Server packages ==
  
 
This article describes how to update Open-Xchange Server packages from one service pack to another.
 
This article describes how to update Open-Xchange Server packages from one service pack to another.
Line 5: Line 5:
 
'''What is written here only applies to Open-Xchange Server Service Pack levels SP4 and newer!'''
 
'''What is written here only applies to Open-Xchange Server Service Pack levels SP4 and newer!'''
  
== How to get updates? ==
+
=== How to get updates? ===
  
 
Open-Xchange Server 6 updates can be accessed by customers with a valid license for
 
Open-Xchange Server 6 updates can be accessed by customers with a valid license for
Line 16: Line 16:
 
for more information about how to create an account in the [http://ldb.open-xchange.com LDB].
 
for more information about how to create an account in the [http://ldb.open-xchange.com LDB].
  
== What Service Pack do I have installed? ==
+
=== What Service Pack do I have installed? ===
  
 
The service pack can be determined in checking the version number of the <tt>open-xchange</tt> package. The second digit relates to the SP version. The following table shows a list of package versions and the corresponding SP number:
 
The service pack can be determined in checking the version number of the <tt>open-xchange</tt> package. The second digit relates to the SP version. The following table shows a list of package versions and the corresponding SP number:
Line 37: Line 37:
 
If the second digit is an odd number (e.g. 6.3, 6.5 or 6.7), you have a beta or snapshot version installed.
 
If the second digit is an odd number (e.g. 6.3, 6.5 or 6.7), you have a beta or snapshot version installed.
  
=== How to determine the version number? ===
+
==== How to determine the version number? ====
==== On Debian based distributions ====
+
===== On Debian based distributions =====
  
 
Run
 
Run
Line 53: Line 53:
 
  ii  open-xchange      6.6.0-1            Open-Xchange server scripts and configuration
 
  ii  open-xchange      6.6.0-1            Open-Xchange server scripts and configuration
  
==== On RPM based distributions ====
+
===== On RPM based distributions =====
  
 
Run
 
Run
Line 63: Line 63:
 
  open-xchange-6.6.0-1.1
 
  open-xchange-6.6.0-1.1
  
== Installing Updates ==
+
=== Installing Updates ===
  
 
A new service pack usually introduces new packages and requires configuration changes. To get all required new packages and configuration changes, the following '''must''' be done when installing updates.
 
A new service pack usually introduces new packages and requires configuration changes. To get all required new packages and configuration changes, the following '''must''' be done when installing updates.
  
=== On Debian based distributions ===
+
==== On Debian based distributions ====
  
 
To ensure, that all required configuration file changes will be applied to the Open-Xchange packages, you need to leave the original files as they are and the <tt>postinst</tt> mechanism will automatically apply all necessary changes.
 
To ensure, that all required configuration file changes will be applied to the Open-Xchange packages, you need to leave the original files as they are and the <tt>postinst</tt> mechanism will automatically apply all necessary changes.
Line 109: Line 109:
 
  $ apt-get dist-upgrade -s
 
  $ apt-get dist-upgrade -s
  
=== On RPM based distributions ===
+
==== On RPM based distributions ====
  
==== RHEL5 ====
+
===== RHEL5 =====
  
 
Add the following entry to <tt>/etc/yum.repos.d/ox.repo</tt>:
 
Add the following entry to <tt>/etc/yum.repos.d/ox.repo</tt>:
Line 129: Line 129:
  
  
==== SLES10 ====
+
===== SLES10 =====
  
 
Add the updates repository to the repository list:
 
Add the updates repository to the repository list:

Revision as of 15:00, 14 January 2009

Updating Open-Xchange Server packages

This article describes how to update Open-Xchange Server packages from one service pack to another.

What is written here only applies to Open-Xchange Server Service Pack levels SP4 and newer!

How to get updates?

Open-Xchange Server 6 updates can be accessed by customers with a valid license for

  • OX SE
  • OX HE

Have a look at the article: How to create an OXAccount and unlock Keys within the License Database for more information about how to create an account in the LDB.

What Service Pack do I have installed?

The service pack can be determined in checking the version number of the open-xchange package. The second digit relates to the SP version. The following table shows a list of package versions and the corresponding SP number:

Package version SP Version
6.4 SP3
6.6 SP4
6.8 SP5

If the second digit is an odd number (e.g. 6.3, 6.5 or 6.7), you have a beta or snapshot version installed.

How to determine the version number?

On Debian based distributions

Run

$ dpkg -l open-xchange

The following output should appear:

Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Installed/Config-files/Unpacked/Failed-config/Half-installed
|/ Err?=(none)/Hold/Reinst-required/X=both-problems (Status,Err: uppercase=bad)
||/ Name               Version            Description
+++-==================-==================-====================================================
ii  open-xchange       6.6.0-1            Open-Xchange server scripts and configuration
On RPM based distributions

Run

$ rpm -q open-xchange

The following output should appear:

open-xchange-6.6.0-1.1

Installing Updates

A new service pack usually introduces new packages and requires configuration changes. To get all required new packages and configuration changes, the following must be done when installing updates.

On Debian based distributions

To ensure, that all required configuration file changes will be applied to the Open-Xchange packages, you need to leave the original files as they are and the postinst mechanism will automatically apply all necessary changes.

You can do that in answering all the questions like e.g. this

Configuration file `/opt/open-xchange/etc/groupware/system.properties'
 ==> Modified (by you or by a script) since installation.
 ==> Package distributor has shipped an updated version.
   What would you like to do about it ?  Your options are:
    Y or I  : install the package maintainer's version
    N or O  : keep your currently-installed version
      D     : show the differences between the versions
      Z     : background this process to examine the situation
 The default action is to keep your current version.
*** system.properties (Y/I/N/O/D/Z) [default=N] ?

with the default answer "N".

If you don't want to do that every time, you could tell apt-get to answer this question for you, just cut and paste the following command in a shell as root user:

cat<<EOF > /etc/apt/apt.conf.d/01oxupdater
DPkg::options {"--force-confold";};
EOF

Note: This change will apply to ALL packages you are going to update in the future, not only Open-Xchange packages.

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

$ deb http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/OX6/updates/DebianEtch /

Then run

$ apt-get update
$ apt-get dist-upgrade

If you want to see, what apt-get is going to do without actually doing it, you can run:

$ apt-get dist-upgrade -s

On RPM based distributions

RHEL5

Add the following entry to /etc/yum.repos.d/ox.repo:

[ox-updates]
name=Open-Xchange Updates
baseurl=http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/OX6/updates/RHEL5/
enabled=1
gpgcheck=0


and run

$ yum update
$ yum upgrade


SLES10

Add the updates repository to the repository list:

$ zypper sa http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/OX6/updates/SLES10/ OXUPDATES

and run

$ zypper up -y -t package

Note: package is not the name of a package, but an option, so just copy and paste the complete line.