Nebulae MutiUser Server NEBULAE MUTIUSER SERVER HELP: INSTALLING THE SERVER  
 

INSTALLING ON FREEBSD

 

We tested Nebulae with the latest official VM port available for the platform, JDK 1.3.1 , from the FreeBSD Foundation. More information about this release can be found at http://www.freebsdfoundation.org/downloads/java.shtml.

Nebulae is distributed in a .tar file available at the DOWNLOAD section on xtras.tabuleiro.com. We suggest that the files are decompressed in the /usr/local/nebulae directory, but you can keep them anywhere on your system. You can create a new user to run the server or run it as a root or any unprivileged account: Java applications rely on the Java VM to provide security to the whole system. The only restriction is that the user running the server must have access rights to the directory where the server files are installed, since it will be necessary to create database files and a server log. To create the directory (this assumes you are logged as root) and decompress your files open a shell account and issue the following commands:

 

cd /usr/local

mkdir nebulae

 

You can copy the Nebulae_126.tar file downloaded from Tabuleiro's site to this directory, and use the following command to decompress it:

 

cd nebulae

tar -xvf Nebulae_126.tar

 

This will create files Nebulae.jar, Nebulae.cfg, ScriptMap.cfg and Movie.cfg. The original .tar file can be deleted at this time. You can also decompress the tar file with another utility like Winzip on your PC and upload the decompressed archives directly to your Linux server.

Before the server runs for the first time it is recommended that you create at least one administrative user in the server database, to allow access to server administration commands in the future. This can be accomplished by editing the "CreateUser" directive in the Nebulae.cfg file:

 

#CreateUser = admin,pass,100

 

Uncomment the line by removing the pound sign at the beginning, and customize the values for username and password. This command will create a user names "admin", with password "pass" and userlevel 100 the first time the server is started. Please note that while the server can operate without a server administrator account you will not be able to shutdown it remotely until an administrative user is added. You can use pico or other text editor to edit the configuration file.

We recommend running the Java Runtime Environment application to execute the server. Make sure you are really invoking version 1.3.1 of the JDK, as Nebulae will no run with earlier versions. If you have installed the FreeBSD Foundation package (Latte Diablo) for example at the /usr/local/jdk13 directory you can test for its presence running:

 

/usr/local/jdk13/bin/java -version

 

The output should read as:

 

java version "1.3.1"

Java(TM) 2 Rutime Environment, Standard Edition (build diablo-1.3.1-0)

Classic VM (build diablo-1.3.1-0, green threads, nojit)

 

You can start the Nebulae server and put it to run in the background with the following command:

 

/usr/local/jdk13/bin/java -cp Nebulae.jar net.tabuleiro.nebulae.Nebulae &

 

Please remember to run the command from the directory where Nebulae is installed. You can also use a shell script to start the server. This version adds the Nebulae directory to the classpath, so you can put server side script classes in the same directory of Nebulae (/usr/local/nebulae) in order to have them loaded by your movies. If you need to use a JDBC driver (for PostgreSQL connection for example) you should also remember to list its location on the classpath:

 

#!/bin/sh

cd /usr/local/nebulae

unlimit

/usr/local/jdk1.3/bin/java -cp

Nebulae.jar:/usr/local/nebulae:postgresql.jar net.tabuleiro.nebulae.Nebulae &

 

For your convenience Nebulae can be restarted or shutdown remotely by an user connected as an administrator (userlevel 100), using the commands "system.server.restart" and "system.server.shutdown". The Nebulae Administrator tool includes these commands and is available at the download section of Tabuleiro web site. It can be used for server administration using any browser with the current Shockwave plugin.

If you need to stop a server you can also find its process id from the shell:

 

ps -auxww

 

This will show the process IDs for all running applications. Locate the Nebulae server process (it contains the java application name) and kill it with:

 

kill pidnumber