RMS 4.8.x Unable to start with IIS Integration enabled
Technical Support Guide
Table of Contents
Brand:
- AMX
Models:
- Resource Management Suite (RMS)
RMS 4.8.x Unable to start with IIS Integration enabled
Applicable to RMS 4.8.0 - 4.8.4
With Tomcat v9.0.43 or later, the AJP 1.3 connector has an option 'secretRequired="true"' which is enabled by default. When IIS is enabled for RMS, this option causes a conflict which prevents the RMS webpages from loading.
Problem:
To confirm, by checking the STDError log, you would see an error 'Caused by: java.lang.IllegalArgumentException: The AJP Connector is configured with secretRequired="true" but the secret attribute is either null or "". This combination is not valid.'
Solution:
To work around this issue, it's possible to make the following amendment to the AJP connector in the server.xml and worker.properties files for Tomcat and RMS.
server.xml file of Tomcat:
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443"
Executor="tomcatThreadPool" tomcatAuthentication="false" secret="<MATCHING CUSTOM PASSWORD>"/>
worker.properties file of 'isapi-redirect-rms-api' and 'isapi-redirect-rms-ui':
worker.worker1.secret=<MATCHING CUSTOM PASSWORD>
Heading 1: [eg. Key points, Features, Prerequisites]
- [Use bullet points and]
- [indented text to highlight]
- [items for better clarity]
Heading 2: [eg. Instructions, Procedure, Description]
- [Use numbered lists]
- [for instructions or]
- [processes]
Heading 3: [eg. Final Thoughts, Pro-Tips]
[Add any additional info here]