OpenSMUS is available as a packaged Java file, named "OpenSMUS.jar". OpenSMUS download packages also include versions of the free and open HSQL Database engine (used for the internal database functions) and Netty (used for networking). OpenSMUS servers can operate with or without database functions, but we recommend enabling database support in order to access administrative functions and DBObject commands. A third file named "OpenSMUS.cfg" is used to configure the server. There is also a template file named "Movie.cfg" that can be used to configure movie-specific commands.

OpenSMUS has been installed and tested in Solaris, FreeBSD, MacOSX, Windows and in different distributions of Linux (RedHat, Slackware and Debian). The only real requirement is a Java virtual machine compatible with Java 2 (JDK 1.5 or newer.)


Installing on Linux/Solaris/Unix/MacOSX


Installing on Windows


After installation is complete you can customize the server by editing the "OpenSMUS.cfg" file. This file provides most of the configuration options also available for the Shockwave MultiUser Server 3, so the settings should be familiar to most multiuser developers:


OpenSMUS.cfg file configuration


It is also possible to configure movie-specific properties. A template file named "Movie.cfg" is supplied. In order to configure a specific movie you can should copy and rename this file to match the name of the target movie, for example to "Chat.cfg" to configure a movie named "Chat". All configuration files should be kept in the same directory where the server application is started.


Movie.cfg file configuration