Solutions
ForgeRock Identity Platform
Does not apply to Identity Cloud

Unidentified properties or Invalid properties message when adding custom advanced server properties in AM (All versions)

Last updated Apr 13, 2021

The purpose of this article is to provide assistance if you see a "Server Profile was updated. Unidentified properties" or "Invalid properties" message when adding custom advanced server properties in AM. You may also notice that previously added custom server properties disappear upon upgrade.


Symptoms

The following error is shown when you add a custom server property using the console: Server Profile was updated. Unidentified properties, my.custom.server.property

The following error is shown when you add a custom server property using ssoadm: Invalid properties

Recent Changes

Installed AM or upgraded to a later version.

Causes

AM warns you when an unknown custom server property is added; however, the property is successfully added.

Solution

To prevent this warning being displayed, you can add the property to the validserverconfig.properties file (located in the /path/to/tomcat/webapps/openam/WEB-INF/classes/ directory). You should add your custom server property to the end of this file. For example, if your property is called my.custom.server.property, you would add:

my.custom.server.property=

You can then add the custom server property using either the console or ssoadm:

  • Console: navigate to: Deployment > Servers > [Server Name] > Advanced and add the required property and value. To add the property as a server default, navigate to: Configure > Server Defaults > Advanced instead. Once you have entered the property and value, click + to add followed by Save Changes.
  • ssoadm: enter the following command: $ ./ssoadm update-server-cfg -s [serverName] -u [adminID] -f [passwordfile] -a [property=value]replacing [serverName], [adminID], [passwordfile] and [property=value] with appropriate values, where [serverName] is either the name of the server or default.
Note

You must restart the web application container in which AM runs to apply these configuration changes.

See Also

Reference › Advanced Properties

Related Training

N/A

Related Issue Tracker IDs

N/A


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