JCP won't start | java.lang.IllegalArgumentException: port out of range

Products

• CA Automic Workload Automation - Automation Engine

Issue/Introduction

When attempting to start the JCP on a new installation or after changing ports, the JCP won't start up.  

JCP log shows:

20201103/110908.653 - 54     U00045014 Exception 'java.lang.IllegalArgumentException: "port out of range:[REST port number]"' at 'java.net.InetSocketAddress.checkPort()'.
20201103/110908.653 - 54     U00003620 Routine 'com.automic.rest.server.RestServerComponent' forces trace because of error.

and the JCP trc file shows:

20201103/105601.700 - 55               ----------------------- Stack Trace -----------------------
20201103/105601.700 - 55               java.lang.IllegalArgumentException: port out of range:[REST port number]
20201103/105601.700 - 55                at java.net.InetSocketAddress.checkPort(Unknown Source)
20201103/105601.700 - 55                at java.net.InetSocketAddress.<init>(Unknown Source)
20201103/105601.700 - 55                at java.net.InetSocketAddress.<init>(Unknown Source)

Cause

The PORT number is not allowed on the OS

Resolution

Update the port= setting in the [REST] section of the ucsrv.ini file to a valid port number.