eXo Platform 3.0

- Prev

## Chapter 3. BOS Migration Tools

## Preamble

PLF 3.0 provides a set of tools to migrate system data from your BOS-5.5 standalone instance to your new PLF 3.0 + Bonita instance.

So the entire old package will not be used, but it will serve as a backup of his old system.

## Requirements

. BOS-5.5 standalone server . Platform + Bonita server

In this document we will use <BOS-Server> for BOS-5.5 standalone server and <PLF-Server> for Platform + Bonita server.

## Install the migration libraries

This section provides step-by-step instructions for the backup procedure from a running BOS 5.5 standalone to Platform + Bonita.

1. Stop the running BOS-Server.

2. Copy the the BOS Migration Tool library, located in /bos/lib/exo.platform.migration.bos.tool-<VERSION>.jar into the xcmis lib directory of BOS-Server.

3. Start again the BOS-Server, in the log file (i.e: <BOS-Server>/logs/catalina.out) you should see a message indicating that the backup service is started:

    BOSBackupService: BOS Backup Service started

1. Access the server via JMX: in this example we will use jconsole as a JMX client.

2. Choose exo > platform > bonita-ext > BOSBackupService MBeans.

. We will proceed for the backup in a chosen location, say /exo-work/BOS-5.5/backup/

1. In the JMX client, fill the backupLocation field with appropriate value: /exo-work/BOS-5.5/backup/cmis1

1. Hit doBackup, you should see a Method successfully invoked message

.In the log file (i.e: <BOS-Server>/logs/catalina.out) you should see a message indicating the backup success:

    BOSBackupService: Starting the backup operation.. Repository: db1
    BOSBackupService: Full backup succeeded: /exo-work/BOS-5.5/backup/system/db1_system-20110608_061330.0
    BOSBackupService: Full backup succeeded: /exo-work/BOS-5.5/backup/cmis1/db1_cmis1-20110608_061330.0

. The backup procedure is now finished, we will go for a restore operation from the PLF-Server.

1. Copy the whole backup folder /exo-work/BOS-5.5/backup/ to <PLF-Server>/temp

2. Use the configuration archive located in /bos/config/exo.platform.migration.bos.config-<VERSION>.zip and extract it in "<PLF-Server>/gatein/conf".

1. Start your server.

. You should see that the workspaces are well initialized from the restore files

    Jun 8, 2011 12:48:39 PM org.exoplatform.services.jcr.impl.core.BackupWorkspaceInitializer initWorkspace
    INFO: Workspace system restored from file <PLF-Server>/bin/../temp/backup/system/db1_system-20110608_061330.0 in 0.269sec
    Jun 8, 2011 12:48:39 PM org.exoplatform.services.jcr.impl.core.BackupWorkspaceInitializer initWorkspace
    INFO: Workspace cmis1 restored from file <PLF-Server>/bin/../temp/backup/cmis1/db1_cmis1-20110608_061330.0 in 0.181sec

## Preamble

PLF 3.0 provides a set of tools to migrate system data from your BOS-5.5 standalone instance to your new PLF 3.0 + Bonita instance.

So the entire old package will not be used, but it will serve as a backup of his old system.

## Requirements

. BOS-5.5 standalone server . Platform + Bonita server

In this document we will use <BOS-Server> for BOS-5.5 standalone server and <PLF-Server> for Platform + Bonita server.

## Install the migration libraries

This section provides step-by-step instructions for the backup procedure from a running BOS 5.5 standalone to Platform + Bonita.

1. Stop the running BOS-Server.

2. Copy the the BOS Migration Tool library, located in /bos/lib/exo.platform.migration.bos.tool-<VERSION>.jar into the xcmis lib directory of BOS-Server.

3. Start again the BOS-Server, in the log file (i.e: <BOS-Server>/logs/catalina.out) you should see a message indicating that the backup service is started:

    BOSBackupService: BOS Backup Service started

1. Access the server via JMX: in this example we will use jconsole as a JMX client.

2. Choose exo > platform > bonita-ext > BOSBackupService MBeans.

. We will proceed for the backup in a chosen location, say /exo-work/BOS-5.5/backup/

1. In the JMX client, fill the backupLocation field with appropriate value: /exo-work/BOS-5.5/backup/cmis1

1. Hit doBackup, you should see a Method successfully invoked message

.In the log file (i.e: <BOS-Server>/logs/catalina.out) you should see a message indicating the backup success:

    BOSBackupService: Starting the backup operation.. Repository: db1
    BOSBackupService: Full backup succeeded: /exo-work/BOS-5.5/backup/system/db1_system-20110608_061330.0
    BOSBackupService: Full backup succeeded: /exo-work/BOS-5.5/backup/cmis1/db1_cmis1-20110608_061330.0

. The backup procedure is now finished, we will go for a restore operation from the PLF-Server.

1. Copy the whole backup folder /exo-work/BOS-5.5/backup/ to <PLF-Server>/temp

2. Use the configuration archive located in /bos/config/exo.platform.migration.bos.config-<VERSION>.zip and extract it in "<PLF-Server>/gatein/conf".

1. Start your server.

. You should see that the workspaces are well initialized from the restore files

    Jun 8, 2011 12:48:39 PM org.exoplatform.services.jcr.impl.core.BackupWorkspaceInitializer initWorkspace
    INFO: Workspace system restored from file <PLF-Server>/bin/../temp/backup/system/db1_system-20110608_061330.0 in 0.269sec
    Jun 8, 2011 12:48:39 PM org.exoplatform.services.jcr.impl.core.BackupWorkspaceInitializer initWorkspace
    INFO: Workspace cmis1 restored from file <PLF-Server>/bin/../temp/backup/cmis1/db1_cmis1-20110608_061330.0 in 0.181sec

- Prev
- Up
- Home