Onyx v3 > Installation Notes

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 http://java.com/download


Step 1: Download of the binaries

Go to http://www.dndnetworks.com/modulonyx
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

Proxy
If you access internet through a proxy, please define it in the onyx.properties, otherwise leave it blank.
Passwords
Onyx is configured with default passwords. It is strongly advised that you spend time changing them.
You need to change jndi access in the jndi.properties:
service.username=admin
service.password=admin <- to change
service.controller.username=controller
service.controller.password=controller <- to change
service.module.username=module
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