Menu
AWS OpsWorks
User Guide (API Version 2013-02-18)

opsworks_java Attributes

Note

These attributes are available only on Linux stacks.

The opsworks_java attributes specify the Tomcat server configuration. For more information, see Apache Tomcat Configuration Reference. For more information on how to override built-in attributes to specify custom values, see Overriding Attributes.

datasources

A set of attributes that define JNDI resource names (string). For more information on how to use this attribute, see Deploying a JSP App with a Back-End Database. The default value is an empty hash, which can be filled with custom mappings between app short names and JNDI names. For more information, see Deploying a JSP App with a Back-End Database.

Copy
node['opsworks_java']['datasources']
java_app_server_version

The Java app server version (number). The default value is 7. You can override this attribute to specify version 6. If you install a nondefault JDK, this attribute is ignored.

Copy
node['opsworks_java']['java_app_server_version']
java_shared_lib_dir

The directory for the Java shared libraries (string). The default value is /usr/share/java.

Copy
node['opsworks_java']['java_shared_lib_dir']
jvm_pkg Attributes

A set of attributes that you can override to install a nondefault JDK.

use_custom_pkg_location

Whether to install a custom JDK instead of OpenJDK (Boolean). The default value is false.

Copy
node['opsworks_java']['jvm_pkg']['use_custom_pkg_location']
custom_pkg_location_url_debian

The location of the JDK package to be installed on Ubuntu instances (string). The default value is 'http://aws.amazon.com/', which is simply an initialization value with no proper meaning. If you want to install a nondefault JDK, you must override this attribute and set it to the appropriate URL.

Copy
node['opsworks_java']['jvm_pkg']['custom_pkg_location_url_debian']
custom_pkg_location_url_rhel

The location of the JDK package to be installed on Amazon Linux and RHEL instances (string). The default value is 'http://aws.amazon.com/', which is simply an initialization value with no proper meaning. If you want to install a nondefault JDK, you must override this attribute and set it to the appropriate URL.

Copy
node['opsworks_java']['jvm_pkg']['custom_pkg_location_url_rhel']
java_home_basedir

The directory that the JDK package will be extracted to (string). The default value is /usr/local. You do not need to specify this setting for RPM packages; they include a complete directory structure.

Copy
node['opsworks_java']['jvm_pkg']['java_home_basedir']
jvm_options

The JVM command line options, which allow you to specify settings such as the heap size (string). A common set of options is -Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC. The default value is no options.

Copy
node['opsworks_java']['jvm_options']
jvm_version

The OpenJDK version (number). The default value is 7. You can override this attribute to specify OpenJDK version 6. If you install a nondefault JDK, this attribute is ignored.

Copy
node['opsworks_java']['jvm_version']
tomcat Attributes

A set of attributes that you can override to install the default Tomcat configuration.

ajp_port

The AJP port (number). The default value is 8009.

Copy
node['opsworks_java']['tomcat]['ajp_port']
apache_tomcat_bind_mod

The proxy module (string). The default value is proxy_http. You can override this attribute to specify the AJP proxy module, proxy_ajp.

Copy
node['opsworks_java']['tomcat]['apache_tomcat_bind_mod']
apache_tomcat_bind_path

The Apache-Tomcat bind path (string). The default value is /. You should not override this attribute; changing the bind path can cause the application to stop working.

Copy
node['opsworks_java']['tomcat]['apache_tomcat_bind_path']
auto_deploy

Whether to autodeploy (Boolean). The default value is true.

Copy
node['opsworks_java']['tomcat]['auto_deploy']
connection_timeout

The connection timeout, in milliseconds (number). The default value is 20000 (20 seconds).

Copy
node['opsworks_java']['tomcat]['connection_timeout']
mysql_connector_jar

The MySQL connector library's JAR file (string). The default value is mysql-connector-java.jar.

Copy
node['opsworks_java']['tomcat]['mysql_connector_jar']
port

The standard port (number). The default value is 8080.

Copy
node['opsworks_java']['tomcat]['port']
secure_port

The secure port (number). The default value is 8443.

Copy
node['opsworks_java']['tomcat]['secure_port']
shutdown_port

The shutdown port (number). The default value is 8005.

Copy
node['opsworks_java']['tomcat]['shutdown_port']
threadpool_max_threads

The maximum number of threads in the thread pool (number). The default value is 150.

Copy
node['opsworks_java']['tomcat]['threadpool_max_threads']
threadpool_min_spare_threads

The minimum number of spare threads in the thread pool (number). The default value is 4.

Copy
node['opsworks_java']['tomcat]['threadpool_min_spare_threads']
unpack_wars

Whether to unpack WAR files (Boolean). The default value is true.

Copy
node['opsworks_java']['tomcat]['unpack_wars']
uri_encoding

The URI encoding (string). The default value is UTF-8.

Copy
node['opsworks_java']['tomcat]['uri_encoding']
use_ssl_connector

Whether to use an SSL connector (Boolean). The default value is false.

Copy
node['opsworks_java']['tomcat]['use_ssl_connector']
use_threadpool

Whether to use a thread pool (Boolean). The default value is false.

Copy
node['opsworks_java']['tomcat]['use_threadpool']
userdatabase_pathname

The user database path name (string). The default value is conf/tomcat-users.xml.

Copy
node['opsworks_java']['tomcat]['userdatabase_pathname']