How to customize Actuate BIRT iServer error messages on a UNIX or Linux system

Use the location of your Information Console installation if it differs from the location used in this example.

1	Extract the contents of resources.jar into a temporary directory:

1	Back up your resources file:

cd /usr/local/Actuate11/iPortal/iportal/WEB-INF/lib

cp resources.jar resources.jar.original

2	Extract the resource file’s contents:

mkdir ap

cd ap

jar -xf /usr/local/Actuate11/iPortal/iportal/WEB-INF/lib/resources.jar

2	Navigate to com/actuate/activeportal/resources and make a backup copy of ErrorMessages.properties:

cd com/actuate/activeportal/resources

cp ErrorMessages.properties ErrorMessagesOrig.properties

3	In a text editor that supports UTF-8 encoding, edit ap/com/actuate/reportcast/resources/ErrorMessages.properties to add your custom error messages in the following format:

<Errorcode>=Example of a message with no variables.

<Errorcode>=Example of a message with a variable {0}.

<Errorcode>=Message with three variables {0}, {1} and {2}.

where <Errorcode> is the Actuate error number or constant of the message being customized.

4	Save and close the file.

5	Rebuild the resources.jar file with your customized ErrorMessages.properties file:

jar -cf resources.jar *

mv resources.jar /usr/local/Actuate11/iPortal/iportal/WEB-INF/lib/resources.jar

(c) Copyright Actuate Corporation 2011