Chapter 11. Configuring an EJB Engine in domain.xml
Prev   Next

Chapter 11. Configuring an EJB Engine in domain.xml

Table of Contents

11.1. Introduction
11.2. XML Schema/XML Tree
11.3. Element Reference
11.4. Example File

This chapter explains the JEUS EJB engine settings.

11.1. Introduction

XML references are configured in the following format.

  1. XML Schema/XML Tree: Summarizes all the tags of XML configuration file. Each node is defined in the following format.

    1. Tag reference enables quick search for tags. Each tag is attached with index numbers ( ex: (11) ). Tags are explained with this number in tag reference.

    2. The XML tag name defined in the XML schema is expressed in the format of <tag name>.

    3. Tags are set with cardinality defined in XML schema.

      “?” is for 0 or 1 element, “+” is for 1 or more elements, “*” is for 0 or more elements, (no symbol) is for exactly one element

    4. Several tags have "P" character, meaning that they are the tags related to performance. These tags are used to tune the setting.

  2. Element Reference: Explains XML tags in the tree.

    1. Dynamic: Allowed to change the configuration dynamically.

    2. Non-Dynamic: Not allowed to change the configuration dynamically. This is expressed only for the special case to comment out.

    3. Description: A short description for tags.

    4. Value Description: The value and type.

    5. Value Type: Data type of the value. (ex: String)

    6. Value Type Description: Description for the data type of the value.

    7. Default Value: The value to be used by default when the XML is not used.

    8. Defined Value: The default value.

    9. Example: The XML tag example.

    10. Performance Recommendation: The value recommended to improve performance.

    11. Child Elements:The tags contained in its own tag element.

11.2. XML Schema/XML Tree

11.3. Element Reference

(505) < domain >< servers >< server > <ejb-engine>
Description An EJB engine provides the environment for running J2EE EJB applications. It corresponds to the EJB container in the J2EE specification. It is started when the JEUS server starts. Each JEUS server can only have one EJB engine.
Value Type ejb-engineType
Child Elements

(507) resolution

(508) use-dynamic-proxy-for-ejb2

(509) enable-user-notify

(510) invoke-http

(513) active-management

(527) timer-service

(538) async-service

11.4. Example File

[Example 11.1] Example File

<?xml version="1.0" encoding="UTF-8"?>
<domain xmlns="http://www.tmaxsoft.com/xml/ns/jeus" version="7.0">
    <servers>
        <server>

            <ejb-engine>
                <!-- period of checking ejb engine for active management and beans for passivation -->
                <resolution>300000</resolution>

                <!-- unenable to write ejb exceptions into the user log specified in domain.xml -->
                <enable-user-notify>false</enable-user-notify>

                <!-- check the number of blocked threads and send an e-mail -->
                <active-management>
                    <max-blocked-thread>3</max-blocked-thread>
                    <max-idle-time>300000</max-idle-time>
                    <email-notify>
                        <smtp-host-address>mail.foo.com</smtp-host-address>
                        <from-address>admin@mail.foo.com</from-address>
                        <to-address>admin@mail.foo.com</to-address>
                        <cc-address>admin@mail.foo.com</cc-address>
                        <bcc-address>admin@mail.foo.com</bcc-address>
                    </email-notify>
                </active-management>

                <!-- use http-rmi invocation -->
                <invoke-http>
                    <url>/mycontext/RMIHandlerServlet</url>
                    <http-port>80</http-port>
                </invoke-http>

                <!-- configuration related to timer service -->
                <timer-service>
                    <support-persistence>true</support-persistence>
                    <max-retrial-count>1</max-retrial-count>
                    <retrial-interval>5000</retrial-interval>
                    <thread-pool>
                        <min>2</min>
                        <max>30</max>
                        <period>3600000</period>
                    </thread-pool>
                    <database-setting>
                        <db-vendor>oracle</db-vendor>
                        <data-source-id>datasource</data-source-id>
                    </database-setting>
                </timer-service>

                <!-- configuration related to async service -->
                <async-service>
                    <thread-min>0</thread-min>
                    <thread-max>30</thread-max>
                    <access-timeout>300000</access-timeout>
                </async-service>
            </ejb-engine>
            
        </server>
    </servers>
</domain>

Prev   Next
Chapter 10. Configuring a Virtual Host in domain.xml Home Chapter 12. Configuring a JMS Engine in domain.xml