Beginners guide

This article briefly describes basic actions for beginners

1 Introduction

    The goal of this article is to explain how to perform basic actions in a step-by-step manner. The article is targeted at Orion beginners.

2 Deploying HTML and other content files

    If you just want to deploy some content files (such as HTML pages or images) to the default site that Orion is distributed with, go through the following steps:

    1. Install Orion as described here.

    2. Copy your file to the directory [path]/orion/default-web-app/

      Substitute [path] with the path to your Orion installation directory.

    3. Make sure that your Orion server is running.

    4. Using a normal browser, go to the location http://[localhost]/[file.type]

      Substitute [localhost] with the name or ip of your site if needed.

      Substitute [file.type] with the name of your file (such as welcome.html).

    You should now be able to see the output of your JSP file.

3 Deploying JSP files

    If you just want to deploy some JSP files to the default site that Orion is distributed with, go through the following steps:

    1. Install Orion as described here.

    2. Copy your JSP file to the directory [path]/orion/default-web-app/

      Substitute [path] with the path to your Orion installation directory.

    3. Make sure that your Orion server is running.

    4. Using a normal browser, go to the location http://[localhost]/[file.jsp]

      Substitute [localhost] with the name or ip of your site if needed.

      Substitute [file.jsp] with the name of your JSP page.

    You should now be able to see the output of your JSP file.

4 Deploying compiled Servlets

    If you just want to deploy some compiled Servlet to the default site that Orion is distributed with, go through the following steps:

    1. Install Orion as described here.

    2. Copy your Servlet .class file to the directory [path]/orion/default-web-app/WEB-INF/classes/[package]

      Substitute [path] with the path to your Orion installation directory.

      Substitute [package] with the package directory structure of your Servlet (such as /com/acme/yada/)

    3. Make sure that your Orion server is running.

    4. Using a normal browser, go to the location http://[localhost]/servlet/[package]/[name]

      Substitute [localhost] with the name or ip of your site if needed.

      Substitute [package] with the package directory structure of your Servlet (such as com.acme.yada.)

      Substitute [name] with the name of your servlet class (such as Snoop).

    You should now be able to see the output of your Servlet.

5 Deploying uncompiled Servlets

    If you just want to deploy some uncompiled Servlet to the default site that Orion is distributed with, go through the following steps:

    1. Install Orion as described here.

    2. Copy your Servlet .java file to the directory [path]/orion/default-web-app/WEB-INF/classes/[package]

      Substitute [path] with the path to your Orion installation directory.

      Substitute [package] with the package directory structure of your Servlet (such as /com/acme/yada/)

    3. Edit the file [path]/orion/config/global-web-applicaton.xml so that the <orion-web-app> tag looks something like in listing 1 below.

    4. Make sure that your Orion server is running.

    5. Using a normal browser, go to the location http://[localhost]/servlet/[package]/[name]

      Substitute [localhost] with the name or ip of your site if needed.

      Substitute [package] with the package directory structure of your Servlet (such as com.acme.yada.)

      Substitute [name] with the name of your servlet class (such as Snoop). 


        <orion-web-app
            jsp-cache-directory="./persistence"
            servlet-webdir="/servlet"
            development="true"
        >
    Listing 1: The <orion-web-app> tag in its updated form.

    You should now be able to see the output of your Servlet.

    What you did above was to configure the default Web-module to be running in development mode, which amongst other things allows for automatic compiling of Servlets.

6 Whats next?

    Now you should really learn how to build your own J2EE web-modules and application. The best source of information for beginners is the J2EE tutorial by Sun. You might also be intrested in how to deploy Applications and bind webmodules to a site on the Orion Application Server.

    A good starting point is also the Orion Application Server documentation Overview, which gives a brief overview of the existing documentation.

Copyright © 2005 IronFlare AB