Difference between revisions of "OX6:Open-Xchange 620 622 Update Guide for RHEL5"

(Created page with "= Update of Open-Xchange Server v6.20 to v6.22 on RedHat Enterprise Linux 5 = This article will guide you through the update of an existing Open-Xchange Server 6 installation...")
 
(Blanked the page)
Line 1: Line 1:
= Update of Open-Xchange Server v6.20 to v6.22 on RedHat Enterprise Linux 5 =
 
  
This article will guide you through the update of an existing Open-Xchange Server 6 installation to the newest major release, v6.22.
 
 
= Supported update path =
 
 
Please note that the update to v6.22 is only supported from an installed version 6.20.7 or later. If you have an earlier version of Open-Xchange Server 6 installed, please update to the latest release of v6.20 before attempting an update to v6.22.
 
 
The latest v6.20 release will remain accessible on our servers. If you need to access the repository after the release of v6.22, please use the following lines in your <tt>/etc/yum.repos.d/ox.repo</tt> repository configuration to access v6.20 packages:
 
 
[ox-updates]
 
name=Open-Xchange Updates
 
baseurl=http://http://software.open-xchange.com/OX6/6.20/RHEL5/
 
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
 
enabled=1
 
gpgcheck=1
 
metadata_expire=0m
 
 
= Requirements =
 
* An Open-Xchange Server installation v6.20.7 or later. This update guide is valid for a system installed through our [[Open-Xchange_Installation_Guide_for_RHEL5|Open-Xchange Server 6 on RedHat Enterprise Linux 5]]
 
* If you have custom packages done by Open-Xchange, please discuss with your Open-Xchange contact when these packages are available for 6.22. Do not attempt the update earlier
 
* If you have built custom packages yourself which install config files in the OX config tree, please check the page [[6.22_Packaging_Changes|v6.22 Packaging Changes]]
 
* If you have custom plugins written by yourself which depend on Open-Xchange Server OSGI bundles, check the pages  [[6.22_Packaging_Changes|v6.22 Packaging Changes]] and  [[6.22_Necessary_Code_Changes|v6.22 Necessary Code Changes]] for changes you might need to do.
 
* Custom packages built for 6.20.7 or earlier might not work with 6.22.
 
* As for every update we strongly recommend that you make a backup of your system(s) before you proceed.
 
 
= Update Open-Xchange Repositories =
 
 
Open-Xchange maintains public available software repositories for different platforms, such as RHEL. This repository should be added to the RHEL installation to enable simple installation and updates.
 
 
Start a console and create a software repository file for Open-Xchange:
 
{{#if:{{{release}}}|{{#ifeq:{{{release|}}}|6.20|
 
  <code>$ vim /etc/yum.repos.d/ox.repo</code>
 
[ox]
 
name=Open-Xchange
 
baseurl=http://software.open-xchange.com/OX6/stable/{{{rhelname}}}/
 
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
 
enabled=1
 
gpgcheck=1
 
metadata_expire=0m
 
 
# if you have a valid maintenance subscription, please uncomment the
 
# following and add the ldb account data to the url so that the most recent
 
# packages get installed
 
 
[ox-updates]
 
name=Open-Xchange Updates
 
baseurl=http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/OX6/updates/{{{rhelname}}}/
 
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
 
enabled=1
 
gpgcheck=1
 
metadata_expire=0m
 
|}}|}}
 
 
{{#if:{{{release}}}|{{#ifeq:{{{release|}}}|6.22|
 
  <code>$ vim /etc/yum.repos.d/ox.repo</code>
 
[ox-frontend]
 
name=Open-Xchange-frontend
 
baseurl=http://software.open-xchange.com/OX6/6.22/frontend/{{{rhelname}}}/
 
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
 
enabled=1
 
gpgcheck=1
 
metadata_expire=0m
 
 
[ox-backend]
 
name=Open-Xchange-backend
 
baseurl=http://software.open-xchange.com/OX6/6.22/backend/{{{rhelname}}}/
 
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
 
enabled=1
 
gpgcheck=1
 
metadata_expire=0m
 
 
# if you have a valid maintenance subscription, please uncomment the
 
# following and add the ldb account data to the url so that the most recent
 
# packages get installed
 
 
[ox-updates-frontend]
 
name=Open-Xchange Updates-frontend
 
baseurl=http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/OX6/6.22/updates/frontend/{{{rhelname}}}/
 
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
 
enabled=1
 
gpgcheck=1
 
metadata_expire=0m
 
 
 
[ox-updates-backend]
 
name=Open-Xchange Updates-backend
 
baseurl=http://LDBACCOUNT:LDBPASSWORD@software.open-xchange.com/OX6/6.22/updates/backend/{{{rhelname}}}/
 
gpgkey=http://software.open-xchange.com/oxbuildkey.pub
 
enabled=1
 
gpgcheck=1
 
metadata_expire=0mb
 
|}}|}}
 
In case there are issues with an username and password containing URL unsafe characters, e.g. an @, they have to be entered URL encoded. Details can be found at http://www.w3schools.com/tags/ref_urlencode.asp
 
 
= Updating repositories and update packages =
 
 
Reload the package index. This will download the package descriptions available at the software repositories:
 
 
$ yum update
 
 
The following command starts the download and installation process of all required package for Open-Xchange deployment:
 
 
{{OXPackageInstallation|installer=yum|mysql=mysql-server|javavendor=sun}}
 
 
 
{{OXConfiguration|mysqlstart=/etc/init.d/mysqld start}}
 
 
{{oxinstaller}}
 
 
After initializing the configuration, start the Open-Xchange Administration service by executing:
 
 
$ /etc/init.d/open-xchange-admin start
 
 
{{OXRegister}}
 
 
= Install additional language packages if necessary =
 
 
Starting with v6.22 the localization files for German, French and British English are no longer part of the core packages. This change was necessary to allow customers to uninstall these languages when they are not needed. If you want to offer German, French and/or British English to your customers as language option, you need to install the corresponding packages after the update.
 
 
For German:
 
 
$ apt-get install open-xchange-l10n-de-de open-xchange-gui-l10n-de-de
 
 
For French:
 
 
  $ apt-get install open-xchange-l10n-fr-fr open-xchange-gui-l10n-fr-fr
 
 
For British English:
 
 
  $ apt-get install open-xchange-l10n-en-gb open-xchange-gui-l10n-en-gb
 
 
 
= Restart Open-Xchange =
 
 
To restart Open-Xchange Server after the update, run
 
 
$ /etc/init.d/open-xchange restart
 
 
This script will check on startup if the old processes for <code>open-xchange-groupware</code> and <code>open-xchange-admin</code> are running, and stops them if they are. You might still want to check with
 
 
$ ps aux | grep open-xchange
 
 
that there is now only one process running Open-Xchange Server.
 
 
= Leftover configuration files and runtime data =
 
 
After the update you may see leftover configuration files and runtime data below <code>/opt/open-xchange/etc</code>.
 
 
Some of these files belong to packages which have been uninstalled during the update, they are marked with the status <code>rc</code> in the output of <code>dpkg -l</code>. You can remove these packages with the command
 
 
$ dpkg --purge <packagename>
 
 
Other orphaned files may be runtime data or temporary files which do not belong to any package and therefore couldn't be removed during the package update.
 
 
Finally, there may be backup files created by the package manager during earlier updates.
 
 
It is safe to remove:
 
 
* All files and subdirectories below:
 
 
/opt/open-xchange/admindaemon
 
/opt/open-xchange/etc/common
 
/opt/open-xchange/etc/groupware
 
 
unless you have built your own packages which install files into these directories.
 
 
* All files ending in <code>.dpkg-bak</code> or <code>.dpkg-remove</code>
 

Revision as of 14:20, 4 October 2012