Do I need to change the Repertoire Client JAR?
Yes. The old RepertoireClient.jar must be replaced with the new Repertoire Client JAR, as the old version causes compatibility issues.
You can refer to the \Repertoire-Client\sample\demo\JavaDemo.java code sample, which details how to send a report template rendering request to the Repertoire 202x Server using the old ERSClient method. Download the Repertoire 202x Client and find more details here: Repertoire Client for Ambience/Repertoire 202x
I did not see the pool file in this new version. How do I create and add it to my data sources?
A sample pool file named hikari-sample.properties is provided in the \etc folder under your Repertoire‑202x directory. Use this file as a reference template for creating connection pools.
I encountered warnings with the Oracle JDBC driver. What should I do?
Using older ojdbc drivers can trigger warnings. You need to upgrade to a compatible driver. Refer to Oracle’s documentation for guidance: Getting Started
I'm facing SSL connectivity issues between the Application Server and Repertoire Server.
Please follow the guide on configuring TLS protocol versions in Repertoire 202x and Ambience 202x: Configuring TLS Protocol Version in Repertoire 202x and Ambience 202x - Repertoire 2022+ - Elixir Support Forum
What are the system requirements for Repertoire 202x?
You can check the latest system requirements here: System Requirements for Ambience/Repertoire 202x - Ambience 2020+ - Elixir Support Forum
What is the MIME type for printing in Repertoire 202x?
Add the MIME type application/x-print under ui-render-types in your application configuration file. Example:
ambience.rml-engine {
default-timeout: 60 seconds
large-chunk-expiry: 2 hours
ui-render-types = [
"application/pdf",
"application/x-print",
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
#"application/vnd.openxmlformats-officedocument.wordprocessingml.document"
#"application/x-html-zip"
#"application/x-jpeg-zip"
#"application/x-png-zip"
#"text/csv"
#"text/html"
#"text/xml"
]
ui-left-parameters = [
#"application/pdf"
]
}
If you are using the Repertoire Client, specify the printing MIME type in the client.renderReport method:
JobInfo info = client.renderReport("/ElixirSamples/Report/TestDirect.rml", "application/x-print", paramMap, emptyMap, os);
Note: For both Repertoire 8 and 202x, the print job will be sent to the network printer configured as the main printer in your environment.
I'm getting “Access Denied” when connecting from the Application Server to the Repertoire Server.
Ensure the following line is added to your etc/application.conf if your application uses the elx-repertoire-client-xxx.jar when sending requests to the Repertoire Server:
elixir.sso.server.resource-owner-password-enabled = true
I don't see my custom fonts, or I’m getting FontManagerFactory errors.
Custom fonts need to be installed and mapped correctly in Repertoire 202x. If fonts are missing or you encounter FontManagerFactory errors, please follow these guides:
How to install and configure custom font in Repertoire 8.x and Ambience/Repertoire 202x
Font Mapping in Ambience/Repertoire v202x
Resolving FontManagerFactory Errors in Ambience/Repertoire Server 202x
These articles provide step‑by‑step instructions for installing fonts, mapping them correctly, and resolving common errors during migration.
Rendering fails if the output directory does not exist. How can I fix this?
Rendering may fail if the output directory is missing prior to execution. It is recommended to create the subdirectory for the output location before rendering.
Moreover, in your application code, check if the directory exists first, and if not, create it programmatically.
I'm seeing Gravatar errors in the logs.
Gravatar lookups can be disabled if not required. Please follow this guide: Disable Gravatar icon look up - Ambience 2020+ - Elixir Support Forum