Installation

System Requirements

• To run Unity 2 Multiuser Server (U2MS) you need Java 1.3 or higher installed on your system. If you do not have Java installed, see Install Java.
• To support Flash clients, U2MS must run on port 1024 or higher.

Install Unity 2 Multiuser Server

Step 1

Download U2MS if you haven't already. If you purchased U2MS you will have received your download instructions in an email. If you did not receive your email contact unity@moock.org. You can download the trial version from moock.org.

Step 2

Unpack the files. The files will automatically be unpacked to a directory called unity. You can rename this directory if you wish. Make sure you specify to keep folders intact when unpacking the files. The full name of the directory you unpacked the files to is referred to as UNITY_HOME. For example, if you unpacked to d:\servers without changing the directory then UNITY_HOME would be d:\servers\unity.

Running Unity 2 Multiuser Server

Start Unity 2 Multiuser Server from the command line in directory UNITY_HOME using the start up scripts provided.

The bundled scripts will start the server on port 9100. Success or failure will be immediately reported at the command line. All further logging can be found in log.txt created in UNITY_HOME.

The scripts are meant to work with the default install of Unity 2 Multiuser Server. You will want to edit them to suit your needs once you have verified the server install. Change:

APORT to the admin port specified in uconfig.xml which listens for incoming admin connections
PASSWORD to the password set in uconfig.xml to validate admin connections

For more information on configuring Unity, see configuration instructions.

Install Java

If your machine doesn't have a Java installed you will have to download either a Runtime Environment (JRE) or Development Kit (JDK). You will need a JDK if you plan on making customized Rooms. You can download Java free from Sun here. If you use Linux you can also get binaries at Blackdown.

Follow the install instructions for your OS. For convenience you will want to make sure that the Java binaries are in your system's PATH so that you can run Java from the command line from any directory.

You can verify your install and version by typing "java -version" from the command line.

to Configuration --->