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

ProcedureTo create a lifecycle module

A lifecycle module performs tasks when it is triggered by one or more events in the server lifecycle. These server events are:

Lifecycle modules are not part of the J2EE specification, but are an enhancement to the Application Server.

  1. In the tree component, expand the Applications node.

  2. Select the Lifecycle Modules node.

  3. On the Lifecycle Modules page, click New.

  4. On the Create Lifecycle Module page, specify these settings:

    1. In the Name field, type a name that denotes the function of the module.

    2. In the Class Name field, type the fully qualified name of the lifecycle module’s class file.

    3. If the JAR file containing the lifecycle is in the server’s classpath, leave the Classpath field blank. Otherwise, type the fully qualified path.

      If you don’t specify the classpath, you must unpack the classes in domain-dir/applications/lifecycle-module/module-name. If you specify a classpath, nothing else is required.

    4. In the Load Order field, type an integer greater than 100 and less than the operating system’s MAXINT value.

      The integer determines the order in which lifecycle modules are loaded when the server starts up. Modules with smaller integers are loaded sooner.

    5. When you start the server, it loads lifecycle modules that are already deployed.

      By default, if a load fails, the server continues the startup operation. To prevent the server from starting up when a load fails, select the On Load Failure checkbox.

    6. To disable the module so that is unavailable after deployment, select the Disabled radio button.

      Because a lifecycle module is invoked at server startup, a disabled lifecycle module won’t cease to have an effect until the server is restarted.

  5. Click OK.

Equivalent asadmin command