Page 1 of 1

Onyx Installation Notes [Linux & Windows]

Posted: 25 Jun 2008 22:33
by PaGaisu
Here are the installation notes for Onyx

Step 0: Prerequisites

Please ensure you have a Java Runtime Environment 1.6 or greater.
Check: type java -version in a shell window
It should look like this:
java version "1.6.0_05"
Java(TM) SE Runtime Environment (build 1.6.0_05-b13)
Java HotSpot(TM) Client VM (build 10.0-b19, mixed mode, sharing)

If you have the incorrect version, go to

Step 1: Download of the binaries

Go to
Click on the picture and save the file on your hard disk.

Step 2: Extraction of the archive

Extract the file in a directory of your choice using your favorite file extractor (Example: /home/user/Onyx )

Step 3: Configuration

If you access internet through a proxy, please define it in the, otherwise leave it blank.
Onyx is configured with default passwords. It is strongly advised that you spend time changing them.
You need to change jndi access in the
service.password=admin <- to change
service.controller.password=controller <- to change
service.module.password=module <- to change

Step 4: Test of the Installation

1) Test of Onyx
- Run Onyx[.sh|.bat] located in bin directory => You should see "zReadme.txt" Ctrl-C to shut down Onyx
2) Test of Web Service Access
- Click on the WebServices internet link in the bin directory or type http://localhost:9900 in your favorite browser.
- Use your service.username/password to access.
=> You should be able to see the web service home page
3) Test the Monitor Tool
- Run Monitor[.sh|.bat]
- Use your service.username/password to access.
=> You should be able to see the Memory, CPU graphs .... (Tab MBeans to see the Onyx JMX Service)

Step 5: Test of the Shutdown

In the shell window, type Ctrl-C to stop Onyx.
This can take several minutes, be patient.
=> You should see a message: ****** ONYX STOPPED *******
Press Y to complete the shutdown