opsworks_java Attributes - AWS OpsWorks

opsworks_java Attributes

Important

AWS OpsWorks Stacks is no longer accepting new customers. Existing customers will be able to use the OpsWorks console, API, CLI, and CloudFormation resources as normal until May 26, 2024, at which time they will be discontinued. To prepare for this transition, we recommend you transition your stacks to AWS Systems Manager as soon as possible. For more information, see AWS OpsWorks Stacks End of Life FAQs and Migrating your AWS OpsWorks Stacks applications to AWS Systems Manager Application Manager.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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

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

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

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.

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

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

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

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

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

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

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

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

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.

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

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

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

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

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

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

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

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

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

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

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