How to customize text messages in OpenAM 11

[dima]

Hi,

I cannot find any relevant information how to customize text messages in OpenAM 11, messages like “Authentication failed”, “You are logged out”, “User has no profile” and others.
In documentation http://openam.forgerock.org/openam-documentation/openam-doc-source/doc/install-guide/index/chap-custom-ui.html#lookup-for-ui-files there is explanation about pages customization only.
Some people write about editing of some “.properties” files, but I did not manage to find in 11th version of OpenAM any file of that kind which contain text messages inside.

Thanks in advance,

Dima

[Matt Miller]

Check inside your openam/WEB-INF/lib/openam-core-*.jar

[dima]

Thank you for the tip Matt.
Do you know where I can read any instructions how to repack the openam-core-*.jar?
I have tried to import and export via eclipse, but after it openAM stops to work.

[Matt Miller]

I would just use the jar command to repackage it, nothing special.

[dima]

I will try.
Thank you again.

[Scott Heger]

Another option is to take the specific properties file you want to edit and put it in WEB-INF/classes and not repackage it back into the jar file. Makes it easier to edit in the future.

[dima]

And openAM will not use the same .properties file from the jar?

[Scott Heger]

Correct. If it finds it under WEB-INF/classes it will use that one instead of what it finds in the jar. Just make sure you restart your OpenAM container after putting the file there and any time you make updates to it.

[dima]

Thank you, now it should be much easier

[Mark Craig]

Indeed the instructions were missing in the 11.0.0 docs.

The need to unpack the properties files is mentioned in the in-progress docs and should be fixed in OpenAM 12.0.0 docs. See the procedure To Customize UI Elements.

[dima]

Thank you Mark

[Scott Heger]

Thanks Mark. That will help many who have asked about this very thing.

[Author]

Posts