Command line option

From Resin 3.0

(Difference between revisions)
Jump to: navigation, search
(migration)
 
(3 intermediate revisions by one user not shown)
Line 1: Line 1:
[[Category:Configuration]]
+
{{Cleanup}} [[Category:Configuration]]
 
+
== Resin command line options ==
+
  
 
{|
 
{|
Line 15: Line 13:
 
|-
 
|-
  
||-D''foo''=''bar''
+
||[[-D]]''foo''=''bar''
 
||sets the JVM [[system property]] `foo' to the value `bar'
 
||sets the JVM [[system property]] `foo' to the value `bar'
 
|-
 
|-
Line 31: Line 29:
 
|-
 
|-
  
||-J-verbosegc
+
||[[-J]]-verbosegc
 
||turns on [[JVM]] [[garbage collection]] information (recommended)
 
||turns on [[JVM]] [[garbage collection]] information (recommended)
 
|-
 
|-
Line 39: Line 37:
 
|-
 
|-
  
||-nojit
+
||[[-jvm-log]] ''file''
 +
||(unix) sets the file to put output that cannot be captured by [[stdout-log]] and [[stderr-log]], relative to [[-server-root]], default is <tt>log/[[jvm.log]]</tt>
 +
|-
 +
 
 +
||[[-no-auto-restart]]
 +
||disables the automatic restart of the JVM if it exits abnormally
 +
|-
 +
 
 +
||[[-nojit]]
 
||disables the Just-In-Time compiler, useful for debugging with some JDK's
 
||disables the Just-In-Time compiler, useful for debugging with some JDK's
 
|-
 
|-
  
 
||[[-pid]] ''file''
 
||[[-pid]] ''file''
||(unix) sets the pid file
+
||(unix) sets the pid file, default is based on the [[-server-id]]
 +
|-
 +
 
 +
||[[-pid-dir]] ''dir''
 +
||(unix) sets the directory to store pid files in
 
|-
 
|-
  
Line 87: Line 97:
 
|-
 
|-
  
||-Xdebug
+
||[[-X]]debug
 
||enable [[HotSwap]] class reloading (recommended)  
 
||enable [[HotSwap]] class reloading (recommended)  
 
|-
 
|-
Line 98: Line 108:
 
!Option||Description
 
!Option||Description
 
|-
 
|-
||-J-verbosegc||turns on [[JVM]] garbage collection information (recommended)
+
 
 +
||-J-verbosegc
 +
||turns on [[JVM]] garbage collection information (recommended)
 
|-
 
|-
||-Xmx256m||set the maximum [[heap size]] (recommended)
+
 
 +
||-Xmx256m
 +
||set the maximum [[heap size]] (recommended)
 
|-
 
|-
||-XX:MaxPermSize=256m||the maximum size of the [[permanent space]] (recommended)
+
 
 +
||-XX:MaxPermSize=256m
 +
||the maximum size of the [[permanent space]] (recommended)
 +
|-
 +
 
 +
||-Xss
 +
||the stack size, default is 1m
 +
 
 
|}
 
|}
  
Line 108: Line 129:
 
normal deployment.
 
normal deployment.
  
= See Also =
+
== See Also ==
  
[[Garbage collection]]
+
; [[Garbage collection]]
 +
; [[httpd]] : the command to start Resin
 +
; [[Daemon]] : running Resin as a background process in Unix
 +
; [[Windows service]] : running Resin as a background process in Windows

Latest revision as of 21:14, 1 December 2011

40px-Edit-clear.png This article requires cleanup and may refer to a legacy version of Resin.

Please visit http://www.caucho.com/documentation/ for the most up-to-date documentation.

Option Description
-classpath xxx Adds to the system classpath, default is determined from environment variable CLASSPATH
-conf conf/resin.conf specifies the resin.conf file
-Dfoo=bar sets the JVM system property `foo' to the value `bar'
-install (windows) install Resin as a service with a default name (but doesn't automatically start)
-install-as name (windows) install Resin as a named service (but doesn't automatically start)
-Jxxx passes xxx to the JVM
-J-verbosegc turns on JVM garbage collection information (recommended)
-java_home xxx sets the JDK, default is determined from environment variable JAVA_HOME or a heuristic search.
-jvm-log file (unix) sets the file to put output that cannot be captured by stdout-log and stderr-log, relative to -server-root, default is log/jvm.log
-no-auto-restart disables the automatic restart of the JVM if it exits abnormally
-nojit disables the Just-In-Time compiler, useful for debugging with some JDK's
-pid file (unix) sets the pid file, default is based on the -server-id
-pid-dir dir (unix) sets the directory to store pid files in
-remove (windows) remove Resin as a service with a default name
-remove-as (windows) remove Resin as a named service
-resin-home dir sets the resin.home value, default is determined from RESIN_HOME environment variable or a heuristic search.
restart (unix) restarts Resin as a daemon using the pid in the file specfied with -pid
-server id sets the resin.server_id value and limits http and srun activation to those with a matching server-id
-server-root dir establishes the root directory for server files and sets the resin.root value
start (unix) starts Resin as a daemon saving the pid in the file specfied with -pid
stop (unix) stops Resin as a daemon using the pid in the file specfied with -pid
-verbose show the Java environment before starting Resin
-Xxxx passes the -Xxxx configuration to the JVM
-Xdebug enable HotSwap class reloading (recommended)

Memory Options

Option Description
-J-verbosegc turns on JVM garbage collection information (recommended)
-Xmx256m set the maximum heap size (recommended)
-XX:MaxPermSize=256m the maximum size of the permanent space (recommended)
-Xss the stack size, default is 1m

The default values for -Xmx and -XX:MaxPermSize are generally too low for a normal deployment.

See Also

Garbage collection
httpd 
the command to start Resin
Daemon 
running Resin as a background process in Unix
Windows service 
running Resin as a background process in Windows
Personal tools