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 Jan 18, 2023

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


This article does not apply to AM 7.1 and later because AM 7.1 and later includes a configuration file upgrade tool for converting configuration files exported with the Amster command. See What’s New for further information.

Background information

The Amster Configuration Upgrader tool has been removed from AM 6.5 as noted in the release notes: Important Changes to Existing Functionality. This change affects AM 6.5.x and AM 7. 

Additionally, 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

You can upgrade Amster configuration files as follows:

  1. Perform a standard upgrade by following the steps in Upgrading AM Instances.
  2. Export the configuration from the upgraded server using Amster. 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 6.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)

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