Overview

This document describes how to migrate an existing OpenCms 5 application to OpenCms 6.

Migration of an existing application contains different steps:

1. Modifications of the template structure.
2. Migration of the content.
3. Changes in the template and element JSPs.
4. Adaption to the modifications in the OpenCms API (CmsObject)

Steps 1-3 include the necessary changes for most applications. If your OpenCms 5 application consists of templates and elements using the OpenCms taglib, those modifications will make your application run in OpenCms 6. If you have direct access to the CmsObject in scriplet code, it might be possible to follow the advices in step 4 how to adjust your scriplet code to OpenCms 6.

Please Note: This document only describes how to migrate OpenCms 5 JSP-based templates to OpenCms 6, but NOT how to use old style templates using the XML-Template mechanism.

Each of the steps will describe the necessary actions to do the mirgration and some additional technical background information explaining what this migration step will do internally.

Step 1: Template structure modification in OpenCms 6

Step 1: This document describes how to change the structure of your templates in OpenCms 6

Step 2: Content migration from OpenCms 5 to OpenCms 6

Step 2: This document describes how to migrate your content from OpenCms 5 to OpenCms 6

Step 3: JSP migration from OpenCms 5 to OpenCms 6

Step 3: This document describes the changes in your JSPs when migrating them from OpenCms 5 to OpenCms 6

Step 4: API changes from OpenCms 5 to OpenCms 6

Step 4: This document describes the changes in the OpenCms API

Advanced migration topics

Advanced migration topics