Page History

...

In a number of situations it is recommended or required to set Java options to specify the behavior of the JVM.

• Recommendations: JS7 - FAQ - Which Java Options are recommended?
• Troubleshooting: JS7 - Troubleshooting - Connection reset or Timeout reached (30s) for process and other articles.

Java options are set individually for the respective JS7 componentsproducts, the Controller, Agent and JOC Cockpit.

...

• From the Unix command line or from the Controller instance start the controller_<instance>.sh script:

  Code Block
  language bash title Unix example to run the Controller start script with Java options
  # Set Java options before running the Controller start script export JAVA_OPTIONS="-Xms128m -Xmx500m" ./controller.sh start # Alternatively set Java options when running the Controller start script ./controller.sh start --java-options="-Xms128m -Xmx500m" # For use with a Controller daemon add this line to the Controller instance start script controller_<instance>.sh export JAVA_OPTIONS="-Xms128m -Xmx500m"

• From the Unix command line or from the Agent instance agent_4445.sh start script (assuming that port 4445 is used for the Agent):

  Code Block
  language bash title Unix example to run the Agent start script with Java options
  # Set Java options before running the Agent start script export JAVA_OPTIONS="-Xms128m -Xmx500m" ./agent.sh start # Alternatively set Java options when running the Agent start script ./agent.sh start --java-options="-Xms128m -Xmx500m" # For use with an Agent daemon add this line to the Agent instance start script agent_<port>.sh export JAVA_OPTIONS="-Xms128m -Xmx500m"

• Alternatively the JAVA_OPTIONS environment variable can be set with:
  • the profile (~/.bashrc, ~/.bash_profile etc.) of the run-time account used for Controller or Agent,
  • the JS7 - systemd Service Files for automated Startup / and Shutdown with Unix Systems.

Windows Operating Systems

...

• From the Windows command line or from the Controller instance controller_<instance>.cmd start script:

  Code Block
  language bash title Windows example to run the Controller start script with Java options
  @rem Set Java options before running the Controller start script set JAVA_OPTIONS="-Xms128m -Xmx500m" .\controller.cmd start @rem Alternatively set Java options when running the Controller start script .\controller.cmd start --java-options="-Xms128m -Xmx500m" @rem For use with a Controller Windows Service add this line to the Controller instance start script controller_<instance>.cmd set JAVA_OPTIONS="-Xms128m" "-Xmx500m"

• From the Windows command line or from the Agent instance agent_4445.cmd start script (assuming that port 4445 is used for the Agent):

  Code Block
  language bash title Windows example to run the Agent instance start script with Java options
  @rem Set Java options before running the Agent start script from the command line set JAVA_OPTIONS="-Xms128m -Xmx500m" .\agent.cmd start @rem Alternatively set Java options when running the Agent start script .\agent.cmd start --java-options="-Xms128m -Xmx500m" @rem For use with an Agent Windows Service add this line to the Agent instance start script agent_<port>.cmd set JAVA_OPTIONS="-Xms128m" "-Xmx500m"

• Alternatively, when operating the Controller or Agent as a Windows Service then from the .\service directory of the installation run
  
  • for a Controller: js7_controller_<controller-id>w.exe
    • where <controller-id> corresponds to the Controller ID the Controller has been installed with.
    • Example: C:\Program Files\sos-berlin.com\js7\controller\my-controller\service\js7_controller_mycontrollerw.exe
  • for an Agent: js7_agent_<port>w.exe
    • where <port> corresponds to the port that the Agent is operated with.
    • Example: C:\Program Files\sos-berlin.com\js7\agent_4445\service\js7_agent_4445w.exe
  • This brings up a utility that allows Java options to be specified:
    
    
    • 
      
      
  • Note: The Controller or Agent Windows Service has to be restarted to apply changes to Java options.

...

• The Jetty start script is available from the installation directory  /opt/sos-berlin.com/js7/joc/jetty/bin/jetty.sh or  or a location specified during installation:

  Code Block
  language bash title Unix example to run the Jetty start script with Java options
  # Set Java options before running the Jetty start script export JAVA_OPTIONS="-Xms128m -Xmx500m" ./jetty.sh start

• When running the JOC Cockpit as a daemon then the following line can be added to the $HOME/.jocrc file of the JOC Cockpit run-time account. This file is created by the installer and it is used if it exists and is executable. The $HOME directory is identified from the /etc/passwd file during installation.

  Code Block
  language bash title Unix example to use $HOME/.jocrc with Java options
  export JAVA_OPTIONS="-Xms128m -Xmx500m"

  When running the JOC Cockpit as a daemon then the  /etc/default/joc file can be created (requires root permission) by the user. This file is not created by the installer and it will be used if it exists and is executable. This file will not be used if the 

  $HOME/.jocrc

   file is present as described above.

  Code Block
  language bash title Unix example to use /etc/default/joc with Java options
  export JAVA_OPTIONS="-Xms128m -Xmx500m"

• Alternatively the JAVA_OPTIONS environment variable can be set with:
  • the profile (~/.bashrc, ~/.bash_profile etc.) of the run-time account used for JOC Cockpit,
  • the JS7 - systemd Service Files for automated Startup / and Shutdown with Unix Systems.

Windows Operating Systems

...

• The C:\Program Files\sos-berlin.com\js7\joc\jetty\bin\jetty.cmd start script is only available when the JOC Cockpit is not installed as a Windows Service.

  Code Block
  language bash title Windows example to run the JOC Cockpit start script with Java options
  @rem Set Java options before running the JOC Cockpit start script set JAVA_OPTIONS="-Xms128m" "-Xmx500m" .\jetty.cmd start

• When operating the JOC Cockpit as a Windows Service then from the installation .\service directory run:
  • for JOC Cockpit: js7_jocw.exe
    
    • Example: C:\Program Files\sos-berlin.com\js7\joc\service\js7_jocw.exe
  • This brings up a utility that allows Java options to be specified:
    
    
    
    
  • Note: The JOC Cockpit Windows Service has to be restarted to apply changes to Java options.

...