enCore Installation

Introduction | Install a new enCore MOO | Upgrade to the latest version


Important: enCore with the new Xpress graphical user interface requires that you have a regular web server such as Apache running on the same machine as the MOO server. The reason for this is that Xpress components such as the telnet applet, icons and other images and files cannot be served by the built-in enCore web server.

If you already have a web server running on your MOO machine, you are all set to go. If not, you must install a web server on the machine before proceeding.

The installation instructions below have been tested under Sun Solaris, and should work similarly on other Unix systems such as Linux and BSD. If you are running your MOO under a non-Unix operating system such as Windows NT, you must adapt the steps below to fit your operating system requirements.


How to Install a New enCore MOO

If you are starting a new enCore MOO follow these instructions:

1) Select or create a directory that is accessible for the web server running on your machine. This can either be in your home web directory or some other web accessible directory of your choosing. The URL pointing to this directory should look something like this:


2) Download the enCore distribution archive named enCore-latest.tar.Z to this directory and be sure to use the binary transfer mode. Next you must uncompress the archive using a program such as uncompress or gzip. The following command should work on all Unix systems:

uncompress enCore-latest.tar.Z

Finally you must unpack the archive. On Unix systems the following command will unpack the archive and create proper directory substructure:

tar -xvf enCore-latest.tar

Do not move the new directory named /encore or any or the subdirectories or files therein.

3) After you have unpacked the enCore package, you should have a new directory named encore. You must now set file and directory permissions to readable, so before you move to the new /encore directory make it readable by typing:

chmod 755 encore

The new /encore directory should contain the following files and subdirectories:

To make all files in this directory readable type:

chmod a+r *.*

And to make the three subdirectories, /mootcan, /images, and /sounds readable as well type:

chmod 755 mootcan

chmod 755 images

chmod 755 sounds

Finally you must also make all files within these three subdirectories readable, so go to each directory in turn and type:

chmod a+r *.*

4) Copy the file enCore.db to the directory in which you want to run your MOO, and download and compile a MOO server for your machine. See High Wired: On the Design, Use, and Theory of Educational MOOs pp. 107-147 for details on how to do this. Note: For security reasons we do not recommend that you run your MOO in the /encore directory. If you must, make sure the file permissions on all MOO database files are set to non-readable.

5) Start up your MOO and log in as wizard (no password is necessary). It is very important at this point that you perform the Core-setup procedure by typing @configure. You should customize all relevant settings in the configure-menu, and pay special attention to the setting called Base URL. This is where you must type a URL pointing to the new encore directory. To go with the example above, you should type something like:


6) For more information on how to get started with your new MOO, read the enCore Administrator's Guide which can be found in your MOO's newspaper, and see appropriate sections in High Wired.


How to upgrade an existing enCore MOO to the latest version.

If you already have an enCore-based MOO and want to upgrade to the latest version, follow these instructions:

1) If you are upgrading from enCore 1.1 to enCore 2.0, follow steps 1-3 above before continuing with step 2. Otherwise go directly to step 2 below.

2) Make a backup of your MOO database before upgrading. Store this backup under a new name such as enCore.bkup. If anything goes wrong during the upgrade, you can restart your MOO using the backup database and try again.

3) Type @version in the MOO, or click the About Icon in Xpress to review core version information. If the MOO is older than the last shipping version, see enCore release history, you must first download and install the appropriate patches to bring it up to that version.

4) Download all relevant patch files from the enCore patch archive. To apply the patch files, log on to your MOO as wizard (#2), then open the patch files in a text editor. Patches must be applied in ascending order starting with the oldest relevant patch. You apply the patches by copying code/properties/text from the file and pasting it into your MOO. Read any instructions in the patch files carefully and paste in only a few verbs/properties/texts at a time so you can confirm that they were installed and programmed properly. If you have made any changes to core objects and code in your MOO that might be affected by the new patch code, you must update the patch code with your original changes before applying the patch. If you fail to do this, the patch will over write your modified code and your modifications will be lost.

5) Some enCore upgrade patches come with additional files such as images, sounds or new MOOtcan versions. These patch files will be in the form of a compressed tar archive. When you have unpacked the patch archive and applied the patch code, read the installation instructions provided for information on which directories the additional files should be put in.

6) If you are upgrading from enCore 1.1 to enCore 2.0 you must now log on to your MOO and enter a Base URL as specified in step 5 under installing a new enCore MOO above. Otherwise you are finished. Enjoy your new functionality and enhancements.

Enjoy your enCore MOO!