about contact development documentation download news

::documentation/orion installation

 

Installation at Orion Server

First check that all required 3rd partie libraries are present. Orion comes with xalan, jaas and crimson packages. You should however check that You have the latest xalan package in Your classpath and copied to the Orion directory.

To install the Spooky service framework You must first copy the jaas.conf file to the Orion directory. The configuration file can be found in the config directory in the binaries directory. The jaas.conf file contains configurations for all JAAS authentication modules. To learn more about JAAS authentication modules check Sun's documentation at java.sun.com page.

Next You must modify Orion Server's own configurations. Open the server.xml in Orion's configuration directory and add the following line into the file:

<application name="Spooky" path="path to the spooky.ear"/>

To the default-web-site.xml document You must add the following line to add the Spooky web application

<web-app application="Spooky" name="spooky" root="/spooky"/>

After this You can start the Orion server. When You start the Orion server for the first time after configurating the Spooky application the Orion server will automatically depoloy the framework. After this You can configurate finder methods. The Orion server can be statrted with the following command:

java -jar -Djava.security.auth.login.config=Jaas.conf orion.jar

After You have started the orion first time with the right configuration You must configurate finder methods. This is done by editing the orion-ejb-jar.xml that can be found in the orion dir/application-deployments/Spooky/spookyejb.jar.

Search the finder method description for method called findByGroupName in the UserGroupEJB entity bean. To this method add to the query attribute at the finder element as attribute the following string

$1=$spGroupName

Next search the finder method description for the method called findByUserId in the UserGroupMapEJB entity bean. Add to the query attribute following string

$1=$spUserId

In the same entity bean You can also find a method called findByGrouId. Add the following string to it's query attribute

$1=$spGroupId

To next search the UserPrincipalEJB entity bean. It has two finder methods. To the first findByUserName the query attribute's value is

$1=$spUserName

The attribute value for the findAll method dosen't requires any modification.

After You have configurated all finder methods we can create the default database information. This is the default administrator user and the administrator user group for the default node. This is done by runig one of the client applications.

Now You should start the Orion server if it is not allready started. Note that in certain cases the Orion server is required to start again so thath the finder methods are updated. Start the Orion server in a same way that was described above.

You can find the spooky_client.jar in the libs directory of Your spooky installation. To run the initializer application for the orion you must start the application with the following command:

java -cp spooky_client.jar;%CLASSPATH% -Djava.naming.factory.initial=com.evermind.server.ApplicationClientInitialContextFactory -Djava.naming.provider.url=ormi://localhost/Spooky spooky.client.DefaultInitializer

Note that this is also done by running the runclient.bat or runclient.sh script provided in the libs directory. Note that the script supposes that the Orion server is running at the localhost.

When You run the client program a login screen pop ups. Put here your Orion server's admin name and password.

After all this configuration the Orion Server is ready to run the Spooky framework. Good Luck and Hope You enjoy using the framework!

Installation Guide

Istallation at JBoss

 

 
SourceForge Logo

©Erik Karlsson 2001 
©Orginal Pictures Antti Isomäki