How To
ForgeRock Identity Platform
Does not apply to Identity Cloud

How do I upgrade Amster configuration files when upgrading to AM 6.5.x or 7?

Last updated May 17, 2021

The purpose of this article is to provide information on upgrading to AM 6.5.x or 7 if you have Amster configuration files.

Background information

The Amster Configuration Upgrader tool has been removed from AM 6.5 as noted in the release notes: Release Notes › Important Changes to Existing Functionality. This affects AM 6.5.x and AM 7. AM 7.1 and later includes a configuration file upgrade tool for converting configuration files exported with the Amster command. See Amster 7.1 Release Notes › What’s New for further information.

AM 6.5

There is a known issue in AM 6.5 (fixed in AM, where an export using the --failOnError true option fails with the following error:

ERROR java.lang.IllegalArgumentException: Illegal character in path    at index 11: json/users/{user}/devices/2fa/webauthn?_queryFilter=true    at (    at (    at (    at (    at (    at (    at (    at org.forgerock.openam.amster.loadster.exporter.EntityWriter.writeCollection (EntityWriter.groovy:85)    at org.forgerock.openam.amster.loadster.exporter.GenericExporter.exportEntity (GenericExporter.groovy:29)

You can either exclude the --failOnError option or set it to false as a workaround; the export will then proceed and just log an error about the endpoint it does not need to query.

See OPENAM-14049 (Amster export failure ) for further information.

Upgrading Amster configuration files (AM 6.5.x and 7)

You can upgrade Amster configuration files as follows:

  1. Perform a standard upgrade by following the steps in Upgrade Guide › Upgrading AM Instances.
  2. Export the configuration from the upgraded server using Amster (either using the --failOnError false option or excluding the --failOnError option). For example: am> export-config --path /path/to/export --failOnError false The exported configuration is now up-to-date and can be used as required.

See Also

Only url, secondaryURLs and _id are valid in write error when importing configuration data via Amster in AM 5, 5.5, 5.5.1, 6.0.0.x, 6.5.0.x, 6.5.1 and 6.5.2.x

Upgrading AM

Using Amster in AM

Related Training


Related Issue Tracker IDs

OPENAM-14049 (Amster export failure )

OPENAM-12233 (Amster doesn't export custom authentication node configuration)

OPENAM-11906 (Amster import using --clean true and site url hangs)

Copyright and Trademarks Copyright © 2021 ForgeRock, all rights reserved.