Name | Synopsis | Description | Options | Examples | Exit Status | See Also
configure-jruby-container [--help] [--monitoring={false|true}] [--jruby-home jruby-home] [--jruby-runtime jruby-runtime] [--jruby-runtime-min jruby-runtime-min] [--jruby-runtime-max jruby-runtime-max] [--show={true|false}]
The configure-jruby-container subcommand configures the JRuby container of Oracle GlassFish Server. This subcommand also shows the current settings of the GlassFish Server JRuby container.
The GlassFish Server JRuby container enables JRuby applications to be deployed in GlassFish Server.
JRuby is an implementation of the Ruby programming language in the JavaTM language. JRuby consists of the JRuby interpreter, the Ruby library, and Ruby gems. JRuby is available from Update Tool or from the JRuby community site.
The GlassFish Server JRuby container maintains a pool of JRuby runtime instances for use by JRuby applications. The configure-jruby-container subcommand enables you to set the initial size, minimum size, and maximum size of this pool. The minimum size must be greater than zero. The initial size must be greater than or equal to the minimum size and less than or equal to the maximum size.
This subcommand is supported in remote mode only.
Displays the help text for the subcommand.
If set to true, enables monitoring for the GlassFish Server JRuby container. The default is false.
The directory where JRuby itself (not the GlassFish Server JRuby container) is installed.
The directory must exist. Otherwise, an error occurs. However, the subcommand does not check whether JRuby is installed in the directory.
The default is as-install/jruby, which is the directory where Update Tool installs JRuby. Therefore, if you obtained JRuby from Update Tool, this option is not required.
The initial number of JRuby runtime instances in the pool.
This number must be greater than zero, greater than or equal to --jruby-runtime-min, and less than or equal to --jruby-runtime-max.
The default is 1.
The minimum number of JRuby runtime instances in the pool.
This number must be greater than zero, and less than or equal to --jruby-runtime and --jruby-runtime-max.
The default is 1.
The maximum number of JRuby runtime instances in the pool.
This number must be greater than zero, and greater than or equal to --jruby-runtime and --jruby-runtime-min.
The default is 1.
If set to true, displays the current settings of the GlassFish Server JRuby container. The default is true.
This example sets the directory where JRuby is installed to /tools/jruby.
asadmin> configure-jruby-container --jruby-home=/tools/jruby Successfully updated jruby-home to the new value: /tools/jruby Current JRuby Container configuration: jruby-home=/tools/jruby max-pool-size=1 initial-pool-size=1 min-pool-size=1 monitoring=false Command configure-jruby-container executed successfully. |
This example configures the JRuby runtime pool as follows:
The initial number of JRuby runtime instances in the pool is 3.
The minimum number of JRuby runtime instances in the pool is 2.
The maximum number of JRuby runtime instances in the pool is 5.
The current settings of the GlassFish Server JRuby Container are not displayed.
asadmin> configure-jruby-container --show=false --jruby-runtime=3 --jruby-runtime-min=2 --jruby-runtime-max=5 Successfully updated JRuby runtime pool configuration. Updated values are, jruby-runtime: 3, jruby-runtime-min: 2, jruby-runtime-max: 5 Command configure-jruby-container executed successfully. |
This command displays the current settings of a JRuby container for GlassFish Server that is configured as follows:
The directory where JRuby is installed is /tools/jruby.
The initial number of JRuby runtime instances in the pool is 3.
The minimum number of JRuby runtime instances in the pool is 2.
The maximum number of JRuby runtime instances in the pool is 5.
Monitoring for the GlassFish Server JRuby Container is not enabled.
asadmin> configure-jruby-container --show=true Current JRuby Container configuration: jruby-home=/tools/jruby min-pool-size=2 initial-pool-size=3 max-pool-size=5 monitoring=false Command configure-jruby-container executed successfully. |
Name | Synopsis | Description | Options | Examples | Exit Status | See Also