Installation guide

The installation of the Orion Application Server is very easy. Here is a step by step guide to install, start and make sure it's working. Advanded users can use the expert guide instead.

1 Step-by-step installation guide

The installation of the Orion Application Server is very easy. Here is a step by step guide to install, start and make sure it's working.

Download the latest orion package from http://www.orionserver.com
Unzip the orion zip file. This guide will assume you unzip the file in c:\ on a windows NT system but installing on other systems will not be any different, except for small issues. Unzipping the file creates a directory-hierarchy under an orion/ directory. The cross-platform way to do this is to, in the command shell, issue the command "jar xvf <orion-zip-file>" where <orion-zip-file> should be replaced by the name of your downloaded archive.
If you want to enable JSP and other technologies needing access to a java compiler, you have to copy the tools.jar file from your Java (J2SE 1.2 or later) installation to the orion/ directory. The file is located in the lib/ directory under your JDK installation root. If you have installed Java to c:\jdk1.4.2 the tools.jar file will be located in c:\jdk1.4.2\lib\tools.jar. If this is where your tools.jar is located, if you installed Orion directly under the c:\ directory and if you are using Windows NT you can do this using the command "copy c:\jdk1.4.2\lib\tools.jar c:\orion". Please notice that this only applies to platforms where the compiler is not part of the installed java runtime environment (which is the case on for instance MacOS).
Now orion is installed and ready to use with the default configuration. This means Orion will install itself using port 80 for the web server part. If you already have a web server installed on port 80 you will have to change Orion to use another port. To do this, open the file config/default-web-site.xml and edit the line <web-site display-name="Default Orion WebSite"> to <web-site port="8080" display-name="Default Orion WebSite"> (or the port number of your choice).
To install an administrator password and to do other initialization, run java -jar orion.jar -install. To do this, simply change directory to the orion/ dir and issue the command "java -jar orion.jar -install"
Now we can try to start the OrionTM Application Server to make sure it's working this far. To do this, issue the same command as last time but without the -install switch.
Now, if everything works fine the server should output "Orion/x.x.x initialized" (x.x.x being the Orion version number)
To make sure it really started, start your web browser and try accessing http://localhost/ from it. If you changed port number in step 4 you have to explicitly specify that in the URL like "http://localhost:<portnumber>/" with <portnumber> being replaced with the number you chose, for example 8080.

2 Expert

Unzip the orion package.
Copy the jdk tools.jar file to the Orion directory if a compiler is not part of the installed java runtime environment.
Run the orion.jar file in the orion/ dir (orion.jar is an executable jar, so java -jar orion.jar will start it) (if you need to run on another port than port 80, edit the config/default-web-site.xml file). First time you run Orion, start it with the -install switch and when prompted, enter the admin password you want to use.