Copy the generated.apptypes.cfg file from the ARIS server setup folder and overwrite the existing file in the ARIS installation folder, for example, C:\SoftwareAG\ARIS10.0\server. Then start ARIS Cloud Controller (ACC) with the command-line option -c <path to generated.apptypes.cfg> to provide ACC with the necessary information about the runnable of the new ARIS version. Make sure that ACC is started from now on with the new generated.apptypes.cfg file, for example, by creating or modifying a shortcut to ARIS Cloud Controller.
Examples
acc.bat -c "C:\SoftwareAG\ARIS10.0\server\generated.apptypes.cfg"
acc.bat -c "C:\SoftwareAG\ARIS10.0\server\generated.apptypes.cfg" -n nodes.nf
nodes.nf (example):
add node n1 ARISServerNode1 Clous g3h31m
add node n2 ARISServerNode2 Clous g3h31m
add node n3 ARISServerNode3 Clous g3h31m
Add all nodes of your distributed ARIS installation:
Either use the add node command manually whenever you start ACC
Or use a node file containing all add node commands which you pass as command-line option -n to ACC
The default settings for runnables provided in the generated.apptypes.cfg file can change from version to version.
However, in versions prior to ARIS 9.8, changes to the settings in the new generated.apptypes.cfg file (everything in the lines after defaults) will not be applied during an update.
As of version 9.8, only a selected subset of the default parameter changes is applied. You can identify the parameters in the generated.apptypes.cfg file that are changed during the update. They are marked with the prefix ! or ~. For example:
register app type umcadmin_s com.aris.umcadmin.y-umcadmin-run-prod 10.0.22.0 defaults connector.ajp.executor.maxThreads=50 connector.http.executor.maxThreads=50 JAVA-Xmx="256m" ~connector.ajp.packetSize=32768 connector.ajp.port=14481 ~connector.http.maxHttpHeaderSize=32768 connector.http.port=14480 JAVA-Dcom.sun.management.jmxremote.authenticate="false" JAVA-Dcom.sun.management.jmxremote.port="14486" JAVA-Dcom.sun.management.jmxremote.ssl="false" JAVA-Dcom.sun.management.jmxremote="/enabled" JAVA-Dcom.sun.management.jmxremote.local.only="true" ~"JAVA-XX\\:
+CrashOnOutOfMemoryError"="/enabled" ~"JAVA-XX\\:
+HeapDumpOnOutOfMemoryError"="/enabled" ~"JAVA-XX
:MaxHeapFreeRatio"="30" -"JAVA-XX
:MaxPermSize" ~"JAVA-XX
:MinHeapFreeRatio"="10" JAVA_OPTS="-server" zookeeper.connect.retry.time.ms="30000" !zookeeper.session.timeout.ms="60000"
Parameters marked with the prefix ~ are applied, if the parameter is NOT already set for the runnable. Parameters that were set or changed manually are retained.
Parameters marked with the prefix ! are applied regardless of whether the parameter is already set or not.
Warning
Parameters that were set or changed manually are overwritten.