Distributon Overview

This article describes the files distributed with the Orion Application Server.

1 Introduction

    This article describes the files distributes with the Orion Application Server as well as their location in the file structure.

    Tips for how to keep your Orion Application Server up to date with the latest updates is also given.

2 File structure

    Below is a listing of the files of the Orion file structure. Each entry is linked to a description given below.

    Rootlevel 1 Level 2 Level 3
    application-deployments/default/defaultWebApp/orion-web.xml
    applications/
    config/database-schemas/hypersonic.xml
    ms-access.xml
    ms-sql.xml
    oracle.xml
    postgresql.xml
    sybase.xml
    application.xml
    data-sources.xml
    default-web-site.xml
    global-web-application.xml
    jms.xml
    mime.types
    principals.xml
    rmi.xml
    server.xml
    default-web-app/examples/ *
    WEB-INF/classes/ *
    web.xml
    demo/ejb/ *
    jms/ *
    news-app/ *
    rmi/ *
    ssl/ *
    messagelogger.ear
    lib/hsql.jar
    log/default-web-access.log
    global-application.log
    rmi.log
    server.log
    persistence/
    activation.jar
    admin.jar
    applicationlauncher.jar
    assemblerlauncher.jar
    autoupdate.jar
    autoupdate.properties
    changes.txt
    clientassembler.jar
    Copyright.txt
    earassembler.jar
    ejb.jar
    ejbassembler.jar
    ejbmaker.jar
    jaxp.jar
    jcert.jar
    jdbc.jar
    jndi.jar
    jnet.jar
    js.jar
    jsse.jar
    jta.jar
    loadbalancer.jar
    mail.jar
    orion.jar
    orionconsole.jar
    parser.jar
    Readme.txt
    taglibassembler.jar
    webappassembler.jar
    xalan.jar
    xerces.jar
    Table 1: The filestructure of the Orion distribution

    2.1 application-deployments/

      Directory where Orion by default stores the Orion specific deployment information, the application logs and generated sources.

    2.2 application-deployments/default/

      Directory for the deployment information for the default application.

    2.3 application-deployments/default/defaultWebApp/

      Directory for the deployment information for the default web application.

    2.4 application-deployments/default/defaultWebApp/orion-web.xml

      The deployment information of the default web application.

      The description of this file is available here.

    2.5 applications/

      Directory where .ear's are normally placed

    2.6 config/

      Directory for the server configuration files

    2.7 config/database-schemas/

    2.8 config/database-schemas/*

      Default database schemas for the most common database management systems. These schemas should be edited accoring to the specific version of the DBMS in use before taking a system into production.

      Read more about database schemas here.

    2.9 config/application.xml

      The config for the global application. It is the parent of all the other applications in this server. This file is an Orion deployment file.

      A description of this file can be found here.

    2.10 config/data-sources.xml

      The data-sources.xml file contains global data-source configuration.

      More information is available here.

    2.11 config/default-web-site.xml

    2.12 config/global-web-application.xml

      The global web-application config. The other web-application will inherit settings from this config. This file is an Orion deployment file ( orion-web.xml)

    2.13 config/jms.xml

      The jms.xmljms.xml file contains configuration for the Java Messaging Service subsystem.

      More information is available here.

    2.14 config/mime.types

      The mime type configuration for the web server

    2.15 config/principals.xml

      The principals.xml file is the location of user and group configuration when using the default XMLUserManager.

      More information is available here.

    2.16 config/rmi.xml

      The rmi.xml file contains configuration for Orion's Remote Method Invocation system.

      More information is available here.

    2.17 config/server.xml

      The Server.xml file contains the configuration for the application-server

      More information is available here.

    2.18 default-web-app/

      The default web application

    2.19 default-web-app/examples/

      This directory contains the web examples that are deployed with the Orion distribution

    2.20 default-web-app/WEB_INF/

      This directory holds the deployment descriptor file for the default web application

    2.21 default-web-app/WEB-INF/classes/

      This directory contains the pre-installed Servlets.

    2.22 default-web-app/WEB-INF/web.xml

      The J2EE deployment descriptor for the default web application

    2.23 demo/

      Contains demos shipped with Orion

    2.24 demo/ejb/

      EJB demos

    2.25 demo/jms/

      JMS demos

    2.26 demo/news-app/

      A J2EE application containing both a web module and an EJB module

    2.27 demo/rmi/

      RMI demos

    2.28 demo/ssl/

      Demo that shows how to register SSL users

    2.29 demo/messagelogger.ear

      Demo showing how to use MessageDriven Beans (EJB2.0)

    2.30 lib/

      The directory to put shared library jar's, like jdbc drivers, in

    2.31 lib/hsql.jar

      The HypersonicSQL database that is shipped with Orion

    2.32 log/

      The directory for the server wide logs (the application specific logs are located in the application-deployments/ directory). For information about the logs, see the debugging document.

    2.33 log/default-web-access.log

      For information about the logs, see the debugging document.

    2.34 log/global-application.log

      For information about the logs, see the debugging document.

    2.35 log/rmi.log

      For information about the logs, see the debugging document.

    2.36 log/server.log

      For information about the logs, see the debugging document.

    2.37 pesistence/

      The directory where Orion persists data over restarts.

    2.38 activation.jar

      Java Activation, library used by JavaMail

    2.39 admin.jar

      The command line administration application (java -jar admin.jar to get the usage)

    2.40 applicationlauncher.jar

      The application used to launch remote application clients

    2.41 autoupdate.jar

      Used to update Orion to the latest version.

    2.42 autoupdate.properties

      Settings for the Auto-update application

    2.43 changes.txt

      Contains information about changes made in different versions of Orion

    2.44 clientassembler.jar

      The graphical tool for assembling application clients

    2.45 earassembler.jar

      The graphical tool for assembling J2EE applications

    2.46 ejbassembler.jar

      The graphical tool for assembling EJB modules

    2.47 ejbmaker.jar

      Graphical CMP EJB creation tool

    2.48 jaxp.jar

      The Java XML parsing API

    2.49 jdbc.jar

      The JDBC API

    2.50 jndi.jar

      The JNDI API

    2.51 jsse.jar

      The Sun JSSE implementation

    2.52 jta.jar

      The JTA API

    2.53 loadbalancer.jar

      The loadbalancer application (see the clustering document)

    2.54 mail.jar

      JavaMail

    2.55 orion.jar

      The executable jar for the application server

    2.56 orionconsole.jar

      The graphical management console

    2.57 parser.jar

      The Sun JAXP implementation

    2.58 taglibassembler.jar

      The graphical tool for assembling Taglibraries

    2.59 webappassembler.jar

      The graphical tool for assembling Web modules

    2.60 webappassembler.jar

      The graphical tool for assembling application client

    2.61 xalan.jar

      The Xalan XSL engine

    2.62 xerces.jar

      The Xerces XML parser

3 Keeping the Orion distribution up-to-date

    To update your Orion to the latest version, you can use the auto-updater:


    java -jar autoupdate.jar
    Listing 1: Running the autoupdate tool

Copyright © 2005 IronFlare AB