Skip to end of metadata
Go to start of metadata

One requirement after making a schema change is to write Amster upgrade rules.  Amster upgrade is manual via the use of the openam-config-upgrader and its rule files.  The upgrader's associated rules perform that transformation.  This page is here to help you get started with writing Amster upgrade rules for any schema change.


After a schema change add Amster upgrade rules.  Use the existing rules as examples.

Amster files and their purpose


AM has the option of storing its configuration in

  • LDAP, or
  • File base

Amster can be used to export the contents of this configuration to a set of files.  The exported Amster files require upgrading before import to a newer version of AM.

Rules to upgrade Amster files


The the released rules and associated test cases are a good set of examples to follow.

  • No labels

1 Comment

  1. Some clarification on the Amster rules however.

    If there is a configuration instance that was exported before the schema change was made e.g new attribute, then it will not have the new attribute. If that new attribute has a sensible default then Amster should be able to reimport that configuration back into AM and not have any issue.