Onyx Installation Notes [Linux & Windows]

Onyx with its NyxServer is a plugin container written in java. Nyx plugins are simple javascript text files and can be added and removed on the fly. Some plugins: TMX, Dedimania, NextMapInfo, CopperDonation and many more.

Moderators: PaGaisu, Vegeta, TM-Patrol

Post Reply
Pit Crew
Pit Crew
Posts: 126
Joined: 16 Jan 2006 10:48

Onyx Installation Notes [Linux & Windows]

Post by PaGaisu » 25 Jun 2008 22:33

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

If you access internet through a proxy, please define it in the onyx.properties, 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 jndi.properties:
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

Post Reply