Migrating a Data Directory between different versions

Minor and major version numbers

There should generally be no problems or issues migrating data directories between major and minor versions of GeoServer (i.e. from 2.0.0 to 2.0.1 and vice versa, or from 1.6.x to 1.7.x and vice versa).

Migrating between GeoServer 1.7.x and 2.0.x

When using GeoServer 2.0.x with a data directory from the 1.7.x branch, modifications will occur to the directory immediately that will make the data directory incompatible with 1.7.x! Below is a list of changes made to the data directory.

Files and directories added

wfs.xml
wcs.xml
wms.xml
logging.xml
global.xml
workspaces/*
layergroups/*
styles/*.xml

Files renamed

  • catalog.xml renamed to catalog.xml.old
  • services.xml renamed to services.xml.old

Note

Reverting from GeoServer 2.0.x to 1.7.x

In order to revert the directory to be compatible with 1.7.x again:

  1. Stop GeoServer.

  2. Delete the following files and directories:

    wfs.xml
    wcs.xml
    wms.xml
    logging.xml
    global.xml
    workspaces/*
    layergroups/*
    styles/*.xml
  3. Rename catalog.xml.old to catalog.xml.

  4. Rename services.xml.old to services.xml.

Migrating between GeoServer 2.1.x and 2.2.x

The security changes that ship with GeoServer 2.2 require modifications to the security directory of the GeoServer data directory.

Files and directories added

security/*.xml
security/masterpw.*
security/geoserver.jceks
security/auth/*
security/filter/*
security/masterpw/*
security/pwpolicy/*
security/role/*
security/usergroup/*

Files renamed

  • security/users.properties renamed to security/users.properties.old

Note

Reverting from GeoServer 2.2.x and 2.1.x

In order to restore the GeoServer 2.1 configuration:

  1. Stop GeoServer.

  2. Rename users.properties.old to users.properties.

  3. Additionally (although not mandatory) delete the following files and directories:

    security/
      config.xml
      geoserver.jceks
      masterpw.xml
      masterpw.digest
      masterpw.info
      auth/
      filter/
      masterpw/
      pwpolicy/
      role/
      usergroup/

Migrating between GeoServer 2.2.x and 2.3.x

The security improvements that ship with GeoServer 2.3 require modifications to the security directory of the GeoServer data directory.

Files and directories added

security/filter/roleFilter/config.xml

Files modified

security/filter/formLogout/config.xml
security/config.xml

Backup files

security/filter/formLogout/config.xml.2.2.x
security/config.xml.2.2.x

Note

Reverting from GeoServer 2.3.x

In order to restore the GeoServer 2.2 configuration:

  1. Stop GeoServer.

  2. Copy security/config.xml.2.2.x to security/config.xml.

  3. Copy security/filter/formLogout/config.xml.2.2.x to security/filter/formLogout/config.xml.

  4. Additionally (although not mandatory) delete the following files and directories:

    security/
      filter/
        roleFilter/
           config.xml
        formLogout/
           config.xml.2.2.x
      config.xml.2.2.x