|There had been new functions in Web Dashboard which needs updates in the startup script. If user tried to use a startup script from an older version, they may encounter unexpected issues (which include HTTP ERROR: 503). Users should make sure that their startup script as well as the config directory (e.g. config/security.xml) are up to date. Please also check the OS startup locations like /etc/init.d for old versions of the script.
For Default Users
If user did not have customization to the startup script prior the upgrade, they are suggested to use the copy that comes as default in the Web Server download. Users should follow the Running Start Scripts section in the Web Dashboard documentation.
For those using the PS Templates
If user is using the previous "webserverctl" script from an ITRS Professional Services implementation, please note that the older package has been deprecated. Clients are encouraged moving to "cordial" which is available at this location:
Users can perform the change as an inhouse project, and they may consider engaging our ITRS Professional Service team for the deployment and other services.
For those using a Custom Script
Users are advised to check the "run" and "geneows" scripts in the Web Server installation package, and apply the changes to their custom script accordingly. Here we have prepared a list of changes as of this writing.
1. Add variable definitions in the script header as appropriate
2. Reference the variables in the start JVM command. Below command is taken from version GA5.11.3 as an example. (Please check the actual version of Web Server for the "geneosws" script.)
GWS_RUN_CMD="$JRE_BIN_PATH/java -XX:+UseConcMarkSweepGC -Xmx1024M -server $EXTRACTED_WAR_DIR $HEADLESS $SECURITY_CONFIG $CONFIG $DASHBOARDS_DIR $RESOURCES $JAVA_LIBRARY_PATH $LOG_PROPERTIES $PATH_FOR_LOG4J $JAVA_PROPS $SSO_PROPERTIES $BDO_FLAGS $JMX_FLAGS $DUMP_HEAP_ARGS $JAR_PATH $GWS_PORT $WEBAPPS $GWS_PORT $ENABLE_SSL $MAX_THREADS &"
3. Verify security.xml is correct
4. Restart the Web Server process
Users can check out the Web Dashboard documentation.