Upgrading Nebulae to Version 2.0

Before starting, make a backup of your Nebulae 1.2.x directory, including all database files. Make sure your system meets the system requirements for Nebulae 2.0. Replace the Nebulae.jar and add hsqldb.jar to the same directory file. You need to add hsqldb.jar to the classpath, as the HSQLDB database classes are now delivered in a separate package, and no longer inside the main Nebulae. jar file. This requires modification of your server start scripts: for example in Linux the line changes from

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

to

/usr/bin/java -cp Nebulae.jar:hsqldb.jar:/usr/local/pathtonebulaescriptsdir net.tabuleiro.nebulae.Nebulae &

Restart the server. Please make sure the server process is restarted at the OS level and not through system.server.restart, in order to guarantee that the new .jar files are loaded.

There may also be newer directives available at Nebulae.cfg, including StartupMovies and configurable message and login queues, depending on the version of Nebulae you are upgrading from. You may want to study the new Nebulae.cfg file to see if the new directives are useful for your multiuser applications. It is however possible to continue using your existing Nebulae.cfg file without any changes, and the server will automatically use default values for the new options if they are not specified.

The download installer includes version 1.6.1 of Hsqldb in the hsqldb.jar file, the same version included internally with no modifications in Nebulae 1.2. This allows transparent upgrade of database information. However, for new server installations, it is possible to start with a newer versions of HSQLDB, if desired. To do this, download the 1.8 version of the hsqldb.jar file from the project download page and use it instead of the version provided in the server download package. Notice however that older databases are NOT automatically supported if you choose to use the newer versions. Follow these instructions if you want to upgrade older databases manually. Please notice that our experience shows that 1.6.1 as used in Nebulae is stable and proven, and there is immediate need to upgrade.