OX6:Update to 6 22: Difference between revisions

From Open-Xchange

Revision as of 09:03, 19 July 2012

Update and Installation Portal Open-Xchange Server v6.22

The new Open-Xchange Server v6.22 is the first step on the way to the next generation Open-Xchange Server 7. The update provides a new and improved Open-Xchange Server backend with enhancements for both generations.

Especially on the backend, Open-Xchange implemented various changes and improvements like a new and clear structure for the configuration files and packages, an improved exception framework, unified OSGi, etc.

On this portal you can find an overview of the differences between the Open-Xchange 6.20.x and the Open-Xchange v.6.22 backend. There are new requirements, update guides, and multiple other changes.

Please read the different articles and manuals regarding the update. We encourage administrators of Open-Xchange 6 v6.20.x to install this update. The further feature development will be based on v6.22

Furthermore, Open-Xchange provides the complete v6.22 materials as a document which is available here: Software Repository.

Supported Update Path

Old version	New version	Update supported
v6.20.7	v6.22.x
v6.20.x	v6.22.x	(1)
v6.18.x	v6.22.x
Older Versions	v6.22.x

(1) If you don't update to 6.20.7 before you start the 6.22 update, it is possible that some important scripts have not run on your system(s) and configuration options might be missing. See HERE for a list of changes that were done during the updates between 6.20.x versions

Rollback

Please note that after updating to 6.22 there is no way to get back to an earlier version of Open-Xchange. Please make sure that you have a backup. (TODO)

Supported Server / Client Combinations

Client Support

Open-Xchange GUI / Clients	Open-Xchange Server	Supported
v6.22.x	v6.22.x
v6.20.x	v6.22.x
v6.18.x	v6.22.x
Older versions of Open-Xchange GUI	v6.22.x
OXtender 2 for Microsoft Outlook	v6.22.x
OXtender for Business Mobility	v6.22.x
Open-Xchange Web Interface v1.2	v6.22.x

Open-Xchange Database Support (Parallel Setup)

Database	New Version	Supported
Open-Xchange Database	v6.22.x	(after running v6.22 update tasks)
	v6.20.7	(after running v6.22 update tasks)
	v6.20.x	(after running v6.22 update tasks)
	v6.18.x
	Older Versions

Improvements Overview of 6.20.x to 6.22 Backend

Open-Xchange provides an overview page regarding the main improvements of the new v6.22. Please have a look at Backend Improvements 6.22

Configuration Changes

The overview page provides a list of

unchanged config files with old and new location
completely new config files
config files that do not longer exist
merged / split config files
config options which need to be changed and their containing files

All pre-update config files are copied to DIRECTORY during the update so they are still accessible after the update. They can be safely removed at any time.

We encourage administrators of Open-Xchange v6.20.x to read the list before updating to Open-Xchange v6.22.

If you have any configuration management or templating system for automatic deployment of OX instances in place, theses changes mean that you will have to adapt that system to the new configuration file tree.

Packages changes

The overview page provides a list of

new packages and metapackages with short description
removed metapackages
remaining metapackages and what they do

We encourage administrators of Open-Xchange v6.20.x to read the [list] before updating to Open-Xchange v6.22.

If you have any custom system for automatic installation and deployment of OX instances in place, it is very likely that you need to adapt your system to the new package structure.

Process Descriptions

The overview page provides a list of

processes exist now and need to be monitored
processes don't exist any more

We encourage administrators of Open-Xchange v6.20.x to read the [list] before updating to Open-Xchange v6.22.

Startup Scripts

The overview page provides a list of

startup scripts

We encourage administrators of Open-Xchange v6.20.x to read the [list] before updating to Open-Xchange v6.22.

Changes to programming APIs which might break custom plugins to the OX Server

The overview page provides a list of

changes to exception handling & other code changes that break customer's custom developments

We encourage administrators of Open-Xchange v6.20.x to read the [list] before updating to Open-Xchange v6.22.

Installation and Update Guide for Open-Xchange v6.22

Quick Installation Guide (supported packages)

To download and install the software, please use the following Installation Guides.

Update Guide (supported packages)

To update the software to Open-Xchange v6.22, please use the following Update Guides. Additional there is provided information regarding how to start groupware with / without admin part, known issues list and a list of necessary manual step.

Retrieved from "https://wiki.open-xchange.com/wiki/index.php?title=OX6:Update_to_6_22&oldid=10932"