enCore v5 Installation

New enCore installation

Introduction

enCore requires that you have a web server such as Apache HTTP Server running on the same machine as the MOO server.

The installation instructions below have been tested under SuSE Linux 10.0, Sun Solaris, and Mac OS X, but they should work similarly on other Unix systems such as 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

  1. Create a new directory in your UNIX home directory and name it moo.

  2. Download the file enCore-5.0 from our project page at SourceForge.net to the new moo directory. Make sure to use the binary transfer mode.

  3. Unzip and install the archive using gzip and tar. The following commands should work on all Unix systems for enCore-5.0.tar.gz:

    gunzip enCore-5.0.tar.gz
    tar xvfp enCore-5.0.tar
  4. Move the enCore database file, enCore.db from the new encore directory that was created by tar to your moo directory.

    mv $HOME/moo/encore/enCore.db $HOME/moo
  5. Move the encore directory to the root level of your web server's document directory, or to your public_html directory. Please note that if you choose to use your public_html directory, it must be located on the same machine that is running the MOO.

    mv encore $HOME/public_html
  6. Download the LambdaMOO server.
    For Unicode support, which is recommended, download our Unicode-patched LambdaMOO 1.8.1 server (ZIP).

    If you for some reason do not want unicode support, download the appropriate MOO server binaries for your system from the enCore FTP archive, or download and compile the LambdaMOO server.
    In such a case, you will have to manually set $httpd.charset to iso-8859-1 as utf-8 is now the default charset of enCore.
    Failing to do so may result in a corrupt database.

  7. Unpack / move the LambdaMOO files to your moo directory, and compile the LambdaMOO server.
    See LambdaMOO's README file and/or Chapter 5 in High Wired: On the Design, Use, and Theory of Educational MOOs for details on how to compile a MOO server.

  8. Start up your MOO and log in as wizard. No password is necessary the first time you log in, but once you are connected you should immediately type @newpassword somepassword in order to set one. 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:

    http://someserver.somesite.edu/~user/encore/

  9. Point your web browser to port 7000 on your machine and log in through Xpress.

    http://someserver.somesite.edu:7000
  10. If you wish to enable file uploads, install the File Upload extension.

  11. If you wish to enable the visual editor, install the TinyMCE WYSIWYG editor.

Copyright © 1997-2004, Jan Rune Holmevik and Cynthia Haynes. Updated Wed, November 15 2006 by Trond K. Pettersen.