Installing the Wrox Webshop application with Orion Application Server
=====================================================================

1.  Download Orion Application Server from www.orionserver.com.
    I used Orion 1.0 Release Candidate 1 (orion1.0rc1.zip)

2.  Unpack the zip file to a suitable location (I used C:\orion) and
    install as specified in its Readme.txt file
    (java -jar orion.jar -install) 

3.  Copy tools.jar from your JDK lib directory (e.g. C:\jdk1.3\lib)
    to the Orion lib directory (e.g. C:\orion\lib)

4.  Edit Orion's config\data-sources.xml file
    (e.g. C:\orion\config\data-sources.xml)to add a data source for
    persistence of Enterprise JavaBeans. I used an Access database and
    the JDBC-ODBC bridge, uncommenting the following in the file:

    <data-source 
        name="Default data-source"
        class="com.evermind.sql.ConnectionDataSource"
        location="jdbc/DefaultDS"
        pooled-location="jdbc/DefaultPooledDS"
        xa-location="jdbc/xa/DefaultXADS"
        ejb-location="jdbc/DefaultEJBDS"
        url="jdbc:odbc:EJB"
        connection-driver="sun.jdbc.odbc.JdbcOdbcDriver"
        username="xxx"
        password="yyy"
    />

    and changing the username and password to suit. I also had to create
    the database and set up an ODBC system DSN using the ODBC Data Sources
    control panel. There is no need to create any tables within the
    database - these are automatically created by the application
    server.

5.  Place webshop.ear in Orion's applications directory
    (e.g. c:\orion\applications)

6.  Edit Orion's config\server.xml file
    (e.g. C:\orion\config\server.xml) to add the line:

    <application name="webshop" path="../applications/webshop.ear" />

    within the <application-server> tags.

7.  Edit Orion's config\default-web-site.xml file
    (e.g. C:\orion\config\default-web-site.xml) to add the line:

    <web-app application="webshop" name="webshop-web" root="/webshop" />

    within the <web-site> tags.

8.  Start Orion (java -jar orion.jar). It should automatically deploy the
    webshop.ear file, and create database tables for the Product and
    Customer EJBs.

9.  Enter the database and add some Customer and Product entries.

10. Request http://localhost/webshop/
