Command line option

From Resin 3.0

(Difference between revisions)
Jump to: navigation, search
m (Command Line Options moved to Command line option)
(migration)
Line 1: Line 1:
 
[[Category:Configuration]]
 
[[Category:Configuration]]
  
= Java command line options =
+
== Resin command line options ==
  
 
{|
 
{|
!option||description
+
!Option||Description
 
|-
 
|-
||-Jxxx||passes xxx to the JVM
+
 
 +
||-classpath ''xxx''
 +
||Adds to the system classpath, default is determined from environment variable CLASSPATH
 
|-
 
|-
||-Xxxx||passes the -Xxxx configuration to the JVM
+
 
 +
||[[-conf]] ''conf/resin.conf''
 +
||specifies the [[resin.conf]] file
 
|-
 
|-
||-Dfoo=bar||sets the JVM [[system property]] `foo' to the value `bar'
+
 
 +
||-D''foo''=''bar''
 +
||sets the JVM [[system property]] `foo' to the value `bar'
 
|-
 
|-
||-J-verbosegc||turns on JVM garbage collection information (recommended)
+
 
 +
||[[-install]]
 +
||(windows) install Resin as a [[service]]  with a default name (but doesn't automatically start)
 
|-
 
|-
||-Xdebug||enable [[HotSwap]] class reloading (recommended)  
+
 
 +
||[[-install-as]] ''name''
 +
||(windows) install Resin as a named [[service]] (but doesn't automatically start)
 
|-
 
|-
||-Xrunjdwp:transport=dt_socket,address=9080,server=y,suspend=n||allow remote debugger to attach to port 9080, useful for [[IDE]] integration
 
|}
 
  
== Memory Settings ==
+
||[[-J]]''xxx''
 +
||passes xxx to the [[JVM]]
 +
|-
  
{|
+
||-J-verbosegc
!option||description
+
||turns on [[JVM]] [[garbage collection]] information (recommended)
 
|-
 
|-
||-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.
 
|-
 
|-
||-Xmx256m||set the maximum [[heap size]] (recommended)
+
 
 +
||-nojit
 +
||disables the Just-In-Time compiler, useful for debugging with some JDK's
 
|-
 
|-
||-XX:MaxPermSize=256m||the maximum size of the [[permanent space]] (recommended)
 
|}
 
  
The default values for -Xmx and -XX:MaxPermSize are generally too low for a normal deployment.
+
||[[-pid]] ''file''
 +
||(unix) sets the pid file
 +
|-
  
== Resin command line options ==
+
||[[-remove]]
 +
||(windows) remove Resin as a [[service]] with a default name
 +
|-
  
{|
+
||[[-remove-as]]
!option||description
+
||(windows) remove Resin as a named [[service]]
 
|-
 
|-
||-conf conf/resin.conf||specifies the [[resin.conf]] file
+
 
 +
||[[-resin-home]] ''dir''
 +
||sets the [[resin.home]] value, default is determined from RESIN_HOME environment variable or a heuristic search.
 
|-
 
|-
||-server id||sets the resin.server_id value
+
 
 +
||[[restart]]
 +
||(unix) restarts Resin as a daemon using the pid in the file specfied with [[-pid]]
 
|-
 
|-
||-resin-home dir||sets the [[resin.home]] value
+
 
 +
||[[-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 documents, sets the resin.root value
+
 
 +
||[[-server-root]] ''dir''
 +
||establishes the root directory for server files and sets the [[resin.root]] value
 
|-
 
|-
||-pid file||sets the [[pid file]]||httpd.pid
+
 
 +
||[[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
 +
|-
 +
 
 +
||[[-X]]''xxx''
 +
||passes the -X''xxx'' 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)
 +
|}
 +
 +
The default values for -Xmx and -XX:MaxPermSize are generally too low for a
 +
normal deployment.
  
 
= See Also =
 
= See Also =
  
[[Garbage Collection]]
+
[[Garbage collection]]

Revision as of 10:59, 14 February 2006


Resin command line options

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.
-nojit disables the Just-In-Time compiler, useful for debugging with some JDK's
-pid file (unix) sets the pid file
-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)

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

See Also

Garbage collection

Personal tools