== Migrate the repository ==

Here are the steps on how to migrate your data from MGOS 1.2 to MGOS 2.0 (note that these steps could take a long time if you have large repositories):

1. Shut down the existing MG Server (MGOS 1.2) if it is running.

2. Change to the !RepositoryAdmin directory (e.g. "C:\Program Files\!MapGuideOpenSource\Server\!RepositoryAdmin" or "/usr/local/mapguide/server/!RepositoryAdmin").

3. Run !BackUpOnlineRepositories.bat (or !BackUpOnlineRepositories.sh for Linux).

4. Run !RestoreRepositories.bat (or !RestoreRepositories.sh for Linux).

5. Uninstall MGOS 1.2. Note that the existing repositories will not get removed.

6. Install the new MGOS 2.0 Server. Note that the Server will fail to start if it tries to open old repositories.

7. Change to the !RepositoryAdmin directory (e.g. "C:\Program Files\!MapGuideOpenSource\Server\!RepositoryAdmin" or "/usr/local/mapguide/server/!RepositoryAdmin", etc.).

10. Run !UpgradeRepositories.bat (or !UpgradeRepositories.sh for Linux).

11. Run !SetupRepositoryIndices.bat (or !SetupRepositoryIndices.sh for Linux).

The above steps are required because of the [wiki:MapGuideRfc23 Oracle Berkeley DB XML upgrade].