Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Administration Reference

- Previous: store-properties
- Next: T

## system-property

Specifies a system property. A system property defines a common value for a setting at one of these levels, from highest to lowest: domain, server, or config. A value set at a higher level can be overridden at a lower level. Some system properties are predefined; see system-property. You can also create system properties using this element.

The following example shows the use of a predefined system property:

    <log-service file="${com.sun.aas.instanceRoot}/logs/server.log">
        <module-log-levels admin=INFO .../>
    </log-service>

The following example shows the creation and use of a system property:

    <config name="config1">
        ...
        <http-service>
            ...
            <http-listener id="ls1" host="0.0.0.0" port="${ls1-port}"/>
            ...
        </http-service>
        ...
        <system-property name="ls1-port" value="8080"/>
    </config>

### Superelements

config, domain, server

### Subelements

The following table describes subelements for the `system-property` element.

Table 1–121 `system-property` Subelements

Element | Required | Description
--- | --- | ---
description | zero or one | Contains a text description of this element.

### Attributes

The following table describes attributes for the `system-property` element.

Table 1–122 `system-property` Attributes

Attribute | Default | Description
--- | --- | ---
`name` | none | Specifies the name of the system property.
`value` | none | Specifies the value of the system property.

### Properties

The following table lists predefined system properties.

Table 1–123 Predefined System Properties

Property | Default | Description
--- | --- | ---
`com.sun.aas.installRoot` | depends on operating system | Specifies the directory where the Application Server is installed.
`com.sun.aas.instanceRoot` | depends on operating system | Specifies the top level directory for a server instance.
`com.sun.aas.hostName` | none | Specifies the name of the host (machine).
`com.sun.aas.javaRoot` | depends on operating system | Specifies the J2SE installation directory.
`com.sun.aas.imqLib` | depends on operating system | Specifies the library directory for Sun Java System Message Queue.
`com.sun.aas.configName` | `server-config` | Specifies the name of the config used by a server instance.
`com.sun.aas.instanceName` | `server1` | Specifies the name of the server instance. This property is not used in the default configuration, but can be used to customize configuration.
`com.sun.aas.domainName` | `domain1` | Specifies the name of the domain. This property is not used in the default configuration, but can be used to customize configuration.

- Previous: store-properties
- Next: T

- © 2010, Oracle Corporation and/or its affiliates