Skip to main content
Jump to: navigation, search

Difference between revisions of "Orion/Metadata migration"

Line 1: Line 1:
 
=== Orion 3.0 (CompatibilityMetaStore) ===
 
=== Orion 3.0 (CompatibilityMetaStore) ===
  
The server metadata is organized as follows:
+
The legacy server metadata is organized as follows:
{| border="1" cellspacing="0" cellpadding="2" align="left"
+
{|{{BMTableStyle}}
 +
|-{{BMTHStyle}}
 +
! File / Folder
 +
! Description
 
|-
 
|-
 
| /serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core/.settings/Projects.prefs  
 
| /serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core/.settings/Projects.prefs  
Line 31: Line 34:
 
| Orion Tasks
 
| Orion Tasks
 
|}
 
|}
 +
 +
=== Orion 4.0 (SimpleMetaStore) ===
 +
 +
The simple server metadata is organized as follows:
 +
{|{{BMTableStyle}}
 +
|-{{BMTHStyle}}
 +
! File / Folder
 +
! Description
 +
|-
 +
| /serverworkspace/metastore.json
 +
| Root of the orion filesystem.
 +
|-
 +
| /serverworkspace/an/anthony/user.json
 +
| Server metadata user file, includes preferences, user rights and list of workspaces
 +
|-
 +
| /serverworkspace/an/anthony/OrionContent/workspace.json
 +
| Server metadata workspace file, includes project list
 +
|-
 +
| /serverworkspace/an/anthony/OrionContent/Project.json
 +
| Server metadata project file, includes content location
 +
|-
 +
| /serverworkspace/an/anthony/OrionContent/Project/
 +
| folder root of project "Project"
 +
|-
 +
| /serverworkspace/an/anthony/OrionContent/Project Two.json
 +
| Server metadata project file, includes content location
 +
|-
 +
| /serverworkspace/an/anthony/OrionContent/Project Two/
 +
| folder root of project "Project Two"
 +
|-
 +
| /serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core.search
 +
| Orion Search (no change)
 +
|-
 +
| /serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core/tasks
 +
| Orion Tasks (no change)
 +
|}
 +
==== Notes ====
 +
The default layout will now be <source lang="properties">orion.file.layout=userTree</source>, so user folders are organized in a hierarchy. In this case anthony is under /an/anthony on the server.
 +
 +
=== Orion 4.0 Migration ===
 +
 +
The server administrator should perform the following steps to migrate the server from 3.0 format to 4.0 format:
 +
 +
* Backup the server. The migration renames project folders, so if there is some issue with the migration, the server may need to be restored to it's original contents.
 +
* Delete the old index folder <code>/serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core.search</code>. Since the projects are moved, they will be reindexed.
 +
* Add the properties to the <code>orion.conf</code> configuration file for your server:
 +
<source lang="properties">
 +
orion.core.metastore=simple
 +
orion.file.layout=userTree
 +
</source>
 +
* Start the orion server.
 +
* Review the migration log in <code>/serverworkspace/.metadata/migration.log</code> to ensure there are no <code>ERROR</code> messages.
  
  
 
[[Category:Orion]]
 
[[Category:Orion]]

Revision as of 15:31, 4 November 2013

Orion 3.0 (CompatibilityMetaStore)

The legacy server metadata is organized as follows:

File / Folder Description
/serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core/.settings/Projects.prefs Project list
/serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core/.settings/SiteConfigurations.prefs Site List
/serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core/.settings/Users.prefs User List, includes preferences, user rights and list of workspaces
/serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core/.settings/Workspaces.prefs Workspace list
/serverworkspace/A folder root of "Project" with project id "A"
/serverworkspace/B folder root of "Project Two" with project id "B"
/serverworkspace/.metadata/.plugins/org.eclipse.orion.server.user.securestorage Equinox Secure Storage for Users and Passwords
/serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core.search Orion Search
/serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core/tasks Orion Tasks

Orion 4.0 (SimpleMetaStore)

The simple server metadata is organized as follows:

File / Folder Description
/serverworkspace/metastore.json Root of the orion filesystem.
/serverworkspace/an/anthony/user.json Server metadata user file, includes preferences, user rights and list of workspaces
/serverworkspace/an/anthony/OrionContent/workspace.json Server metadata workspace file, includes project list
/serverworkspace/an/anthony/OrionContent/Project.json Server metadata project file, includes content location
/serverworkspace/an/anthony/OrionContent/Project/ folder root of project "Project"
/serverworkspace/an/anthony/OrionContent/Project Two.json Server metadata project file, includes content location
/serverworkspace/an/anthony/OrionContent/Project Two/ folder root of project "Project Two"
/serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core.search Orion Search (no change)
/serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core/tasks Orion Tasks (no change)

Notes

The default layout will now be
orion.file.layout=userTree
, so user folders are organized in a hierarchy. In this case anthony is under /an/anthony on the server.

Orion 4.0 Migration

The server administrator should perform the following steps to migrate the server from 3.0 format to 4.0 format:

  • Backup the server. The migration renames project folders, so if there is some issue with the migration, the server may need to be restored to it's original contents.
  • Delete the old index folder /serverworkspace/.metadata/.plugins/org.eclipse.orion.server.core.search. Since the projects are moved, they will be reindexed.
  • Add the properties to the orion.conf configuration file for your server:
orion.core.metastore=simple
orion.file.layout=userTree
  • Start the orion server.
  • Review the migration log in /serverworkspace/.metadata/migration.log to ensure there are no ERROR messages.

Copyright © Eclipse Foundation, Inc. All Rights Reserved.