INSTALLING ON WINDOWS

Most developers will use Macromedia's Shockwave MultiUser Server in Windows servers. However it is also possible to run OpenSMUS on Windows system, for deployment or testing purposes. We recommend using the latest Sun VM available at Sun's Java website. Windows 2000/XP a powerful platforms for running Java applications, and can handle a large number of users.

OpenSMUS is distributed in a .tar file available at the FILES section of the OpenSMUS project site. Winzip can decompress tar files. The files needed to run the server can be found in the DISTRIB subdirectory. They are: OpenSMUS.jar, hsqldb.jar, netty.jar, OpenSMUS.cfg, ScriptMap.cfg and Movie.cfg. This guide assumes you copy them to the C:\OpenSMUS directory, but you can keep them anywhere on your system.

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 OpenSMUS.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 Notepad or other text editor to edit the configuration file.

From the command prompt you can issue the following command to verify that the Java VM installation is functional:

java -version

The result will be something like:

java version "1.6.0"

Java(TM) SE Runtime Environment (build 1.6.0-b105)

Java HotSpot(TM) Client VM (build 1.6.0-b105, mixed mode, sharing)

You can start the OpenSMUS server with the following commands. Don't forget to add the OpenSMUS installation directory to the classpath if you want to load server side script classes, and put them in the same directory of OpenSMUS:

cd C:\OpenSMUS

java -cp OpenSMUS.jar;hsqldb.jar;netty.jar;C:\OpenSMUS net.sf.opensmus.OpenSMUS

Please remember to run the command from the directory where OpenSMUS is installed.

For your convenience OpenSMUS 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 OpenSMUS Administrator tool includes these commands and is available at the download section of the project site. It can be used for server administration using any browser with the current Shockwave plugin.

If you need to stop a server locally press CTR-C in the command prompt window where the server has started.