wlw-runtime-config.xml Configuration File

The wlw-runtime-config.xml file allows you to configure runtime parameters of web resources on a production server.

The wlw-runtime-config.xml file must be placed in the root of the WebLogic Server domain directory in order to impact the configuration of WebLogic Workshop applications deployed within the domain.

You can use the example at the bottom of this topic as a template wlw-runtime-config.xml file.

General Structure

<wlw-runtime-config>
    <wlw-config>
        <hostname>
        <protocol>
        <http-port>
        <https-port>
        <component-group>
            <component>
        <service>
            <class-name>
            <protocol>

<wlw-runtime-config>

The <wlw-runtime-config> element is the root element of the wlw-runtime-config.xml file. All other elements are children of <wlw-runtime-config>.

<wlw-runtime-config>
<wlw-config>

Syntax

<wlw-runtime-config
    xmlns="stringNamespace"
>

Attributes

none.

Hierarchy

Parents: none.

Children: <wlw-config>.

<wlw-config>

The <wlw-config> element defines name and the context-path for a given deployed application. Include a <wlw-config> element for each deployed application. Child elements configure the application's hostname, transport protocol, etc.

<wlw-runtime-config>
    <wlw-config>
        <hostname>
        <protocol>
        <http-port>
        <https-port>
        <service>

Syntax

<wlw-config
    application-name="stringAppName"
    context-path="stringContextPath"
    >
<!--
Child elements configure the application's hostname, transport protocol, etc.
-->
</wlw-config>

Attributes

Attribute	Description
application-name	Required string. Specifies the name of the application.
context-path	Required string. The context-path attribute specifies the first part of the URL path, after the hostname. The following URL shows the location of the context path. http://localhost:7001/WebApp/binaryFlow/BinaryFlowController.jpf

Hierarchy

Parents: <wlw-runtime-config>.

Children: <hostname>, <protocol>, <http-port>, <https-port>, <service>.

<hostname>

Specifies the name of the machine where your web application will be deployed.

<wlw-runtime-config>
<wlw-config>
<hostname>

Syntax

<hostname> stringHostname </hostname>

Attributes

none.

Hierarchy

Parents: <wlw-config>.

Children: none.

<protocol>

Defines the default exposure protocol for your web application. Unless otherwise specified in the class-specific <protocol> element, web resources within the web application will be exposed on the protocol specified here. Possible values are http or https.

<wlw-runtime-config>
<wlw-config>
<protocol>

Syntax

<protocol> [ HTTP | HTTPS ] </protocol>

Attributes

none.

Hierarchy

Parents: <wlw-config>.

Children: none.

<http-port>

Specifies which port should be used for http traffic. The range of values is 1 to 65535. If omitted the value is set to 7001.

<wlw-runtime-config>
<wlw-config>
<http-port>

Syntax

<http-port> portInteger </http-port>

Attributes

none.

Hierarchy

Parents: <wlw-config>.

Children: none.

<https-port>

Specifies which port should be used for https traffic. The range of values is 1 to 65535. If omitted the value is set to 7002.

<wlw-runtime-config>
<wlw-config>
<https-port>

Syntax

<https-port> portInteger </https-port>

Attributes

none.

Hierarchy

Parents: <wlw-config>.

Children: none.

<component-group>

Specifies the list of components.

<wlw-runtime-config>
    <wlw-config>
        <component-group>
            <component>

Syntax

<component-group>
	<!-- <component> elements -->
</component-group>

Attributes

none.

Hierarchy

Parents: <wlw-config>.

Children: <component>.

<component>

Specifies the list of components.

<wlw-runtime-config>
    <wlw-config>
        <component-group>
            <component>

Syntax

<component> component </component>

Attributes

none.

Hierarchy

Parents: <component-group> .

Children: none.

<service>

Use the <service>, and its children <class-name> and <protocol> elements, to specify the transport protocol for individual web resources in a web application.

<wlw-runtime-config>
    <wlw-config>
        <service>
            <class-name>
            <protocol>

Syntax

<service>
<!--
Child elements specifying a resource and exposure protocol.
-->
</service>

Attributes

none.

Hierarchy

Parents: <wlw-config> .

Children: <class-name>, <protocol>.

<class-name>

Specifies the transport protocols of individual web resources. Possible values are the class names of web resources. For example, to specify a web service Foo.jws, use <class-name>Foo</class-name>. Values of the <class-name> element are case sensitive.

<wlw-runtime-config>
    <wlw-config>
        <service>
            <class-name>

Syntax

<class-name> stringClassName </class-name>

Attributes

none.

Hierarchy

Parents: <service>.

Children: none.

<protocol>

Specifies the exposure protocol for individual web resources. Overrides the application-scoped <protocol> element.

<wlw-runtime-config>
    <wlw-config>
        <service>
            <protocol>

Syntax

<protocol> [ HTTP | HTTPS ] </protocol>

Attributes

none.

Hierarchy

Parents: <service>.

Children: none.

Example

<?xml version="1.0" encoding="UTF-8"?>
<wlw-runtime-config xmlns="http://www.bea.com/2003/03/wlw/config/">
  <wlw-config application-name="cluster_client" context-path="/cluster_clusterAsClientWeb">
    <hostname>myMachine</hostname>
    <protocol>http</protocol>
    <http-port>7120</http-port>
  </wlw-config>
</wlw-runtime-config>