resin
<cluster> configures a set of servers used for load-balancing and for
sharing distributed sessions.
- See the <> tag for more details
about the cluster contents.
- See the <> tag for more details
about the server contents.
<resin xmlns="http://caucho.com/ns/resin">
<cluster id="app-tier">
<server id="a" address="192.168.0.1"/>
<server id="b" address="192.168.0.2"/>
<host id="">
<web-app-deploy path="webapps"/>
</host>
</cluster>
</resin>
| Attribute |
Description |
Default |
| id |
Name of the cluster |
required |
resin
<cluster-default> configures common configuration for all
clusters.
true
By default, Resin's System.getProperties() is
environment-dependent, so the settings in on web-app do not affect the
properties in any other web-app. Some sites may need to disable
this virtualization capability, when using certain JVM agents.
element environment-system-properties {
r_boolean-Type
}
<resin> is the top-level configuration tag for
the resin.xml file. The <resin>
tag needs to specify the Resin namespace, to allow for validation
of the configuration file.
The environment of the top-level <resin> is the global classpath.
This environment can be important for <log> configuration
for threads which run with using only the global class loader.
Because the <resin> environment does not have a dynamic class loader,
dynamically loaded classes, like custom jars
in resin/lib are not available.
element resin {
env resources
& cluster*
& cluster-default*
& environment-system-properties?
& management?
& min-free-memory?
& resin-data-directory?
& resin-system-auth-key?
& root-directory?
& security-manager?
& security-provider?
& watchdog-manager?
}
<resin xmlns="http://caucho.com/ns/resin"
xmlns:resin="http://caucho.com/ns/resin/core">
<root-directory>/var/www</root-directory>
<cluster id="web-tier">
<server id="">
<http address="*" port="8080"/>
</server>
<resin:import path="app-default.xml"/>
<host id="">
<web-app id="" root-directory="/var/www/htdocs"/>
</host>
</cluster>
</resin>
resin, cluster, host, web-app
All Resource tags are
available to the <host>, for example, resources
like <database> or <authenticator>. Resources defined at
the host level are available for all web-apps in the host.
<resin xmlns="http://caucho.com/ns/resin">
<database jndi-name="jdbc/test">
<driver type="org.postgresql.Driver">
<url>jdbc:postgresql://localhost/test</url>
<user>caucho</user>
</driver>
</database>
<cluster id="app-tier">
...
</cluster>
</resin>
resin
<resin-data-directory> specifies the location of Resin's administration
and data files, including persistent caching, sessions, and administration
logs.
element resin-data-directory {
r_path-Type
}
resin
<resin-system-auth-key> specifies authorization token for Resin's Security service.
element resin-system-auth-key {
String
}
resin, cluster, host, web-app
<root-directory> specifies the base directory
for the contexts. All EL-style directory paths are relative to
the root-directory.
element root-directory {
r_path-Type
}
<security-manager> enables the use of the security manager for the JVM.
Because the JVM security manager is very slow, we generally do not
recommend enabling it for server applications. Instead, see the
watchdog configuration for alternative
methods for securiting the JVM in ISP configurations.
element security-manager {
r_boolean-Type
}
<resin xmlns="http://caucho.com/ns/resin">
...
<security-manager/>
...
<security-provider> adds one or more security providers. Each entry
specifies the name of a security provider class. The name is used
to instantiate an instance of the
object, which is then passed to
Security.addProvider.
element security-provider {
string
}
<resin xmlns="http://caucho.com/ns/resin"
xmlns:resin="http://caucho.com/ns/resin/core">
...
<security-provider>
com.sun.net.ssl.internal.ssl.Provider
</security-provider>
<security-provider>
example.MyProvider
</security-provider>
...
| Property |
Description |
| version |
Returns the JDK version from the java.version property |
| Property |
Description |
| address |
The machine's address as returned by InetAddress |
| conf |
The path to the resin.xml |
| home |
The --resin-home value, i.e. the location of the Resin installation |
| homeName |
The local hostname as returned by InetAddress |
| id |
The --serverId command line value (see serverId) |
| isProfessional() |
True if Resin professional is installed and licensed |
| root |
The --resin-root value, i.e. the site's deployment directory |
| serverId |
The --serverId command line value |
| version |
The Resin version |
| versionDate |
The compilation date of Resin |
The ${system} variable return the System.getProperties()
value.
<resin xmlns="http://caucho.com/ns/resin"
xmlns:resin="http://caucho.com/ns/resin/core">
<resin:message>${system['foo']}</resin:message>
...
</resin>
The <watchdog> tag is used in ISP-style
configurations where the <watchdog-manager> is configured separately
from the resin.xml instances, and where the configuration file is generally
not readable by the instance users.
The <watchdog> tag corresponds to the <server> tag in standard
resin.xml configurations, and specifies the resin.xml, the root directory
and resin-user.
| Attribute |
Description |
Default |
| chroot |
calls chroot before starting the Resin process |
|
| group-name |
setgid value for unix systems |
|
| java-exe |
java executable to use for the Resin instance |
java |
| java-home |
JAVA_HOME value for the Resin instance |
|
| open-port |
list of ports the watchdog should open for the Resin instance, e.g.
for ports that require root access |
|
| resin.xml |
Path to the resin.xml file for the Resin instance |
same as for watchdog |
| resin-root |
Root directory for the Resin instance |
same as for watchdog |
element watchdog {
attribute id { string }
& chroot?
& group-name?
& java-exe?
& java-home?
& jvm-arg*
& resin.xml?
& resin-root?
& open-port { address & port }*
& user-name?
}
For ISP configurations, <watchdog-manager> is used for a separate
resin.xml just to configure the watchdog-manager itself. The
<watchdog-manager> selects the <user-name>, <resin.xml>,
ports, and Resin home directories before giving access to the user's
Resin instance.
| Attribute |
Description |
Default |
| watchdog |
Watchdog configuration for a Resin instance, corresponding to a <server> in the resin.xml |
|
| watchdog-address |
The TCP address the watchdog-manager listens for start, stop, status |
127.0.0.1 |
| watchdog-default |
Defaults applied to all watchdog instances |
|
| watchdog-jvm-arg |
JVM arguments for the watchdog-manager when launched |
|
| watchdog-port |
The TCP port the watchdog-manager listens for start, stop, status |
6700 |
element watchdog-manager {
watchdog*
& watchdog-address?
& watchdog-default*
& watchdog-jvm-arg*
& watchdog-port?
}