EnCore installation and configuration

This article or section is a stub. It does not yet contain enough information to be considered a real article. In other words, it is a short or insufficient piece of information and requires additions.

Draft

## Contents

* 1 Definition
* 2 Installation
* 2.1 Before you install
* 2.2 Prerequisites
* 2.3 Downloads
* 2.4 File Setup
* 2.5 Installing the MOO Server
* 2.6 Make an Alias in the Web server
* 2.7 Start the MOO server
* 3 Configuration
* 4 Suport, End user guides and encore MOO examples

## Definition[edit | edit source]

This page contains installation tips for enCore MOO.

enCore is an educational MOO server/database and needs some Unix installation skills. It also may run under Windows (not tested).

## Installation[edit | edit source]

These notes are based on an install I did in spring 2007 (Daniel K. Schneider 15:28, 14 March 2008 (MET)). The server is still running and occasionally used by a foreign language teacher. I only fixed a few (easy) minor moo-code bugs.

### Before you install[edit | edit source]

Read all the official documentation:

* V.5 installation instructions

* www.encore-consortium.org (dead link as of 2017), The enCore Consortium seeks to coordinate and promote the open source development and distribution of the enCore Program.

* v5 Documentation (not meant for end users like non-technical teachers).

### Prerequisites[edit | edit source]

1. You need an Apache/Php web server installed (PHP not too old)
2. If you want file upload, you need a MySQL server (4.x or 5)
3. You need a C compiler, e.g. gcc.

On a Linux system, this ought to be easy. They come as packages with any distribution I am aware off.

### Downloads[edit | edit source]

(tested in March 2007, maybe outdated at some point)

You need both a MOO server and the enCore database. The MOO server implements low level server architecture and the MOO programming language. The enCore database will contain all the necessary objects for running MOO world. Objects are programmed in the MOO language and include things like User classes, various kinds of Rooms (locations) and such. In other words, you can't run a MOO without a database.

Download a MOO server

* We recommend to take the patched Unicode-patched LambdaMOO 1.8.1 server (made by the enCore folks).
* The official LambdaMOOServer will also do (but only provides basic iso-latin support).

Download a MOO database

Take the latest *.gzip version from http://sourceforge.net/projects/ele/

* Take version 4.x stable:
* Version 5 seems to be a dead project. No changes since 2006. It does work well enough for a production environment:
* Note: the database at eNcore Open Source MOO Project is old. Do not use it and get the 4.x version from above !

### File Setup[edit | edit source]

* In order to find all related files I usually recommend to do the following for software like MOO servers:

* Create a directory like /usr/local/moo and cd there
* We shall put absolutly everything in there ....
* Move the 2 archives to this directory (or if you are expert with tar/gtar put them directly into the src directory)
* Go there and make 2 subdirectories

mkdir bin
mkdir src
mkdir encore (not necessary)

### Installing the MOO Server[edit | edit source]

Note: On a Linux system use: tar instead of gtar (I am working with Solaris)

(1) Make sure that you are in the right directory !!

(2) Unarchive the MOO server

i.e. the file LambdaMOO-1.8.1-unicode.tar.gz

* To make sure the archive is ok type:

gtar ztvf LambdaMOO-1.8.1-unicode.tar.gz

* Unarchive

gtar zxf LambdaMOO-1.8.1-unicode.tar.gz

* The files should be in and you may have to ajust file ownership

./MOO-1.8.1
chown -R user:group *

* Move the archive to src

mv LambdaMOO-1.8.1-unicode.tar.gz src/

You should wind up up with something like this:

drwxr-xr-x    7 root     other         512 Mar 21 16:16 ./
drwxr-xr-x   41 root     root         1024 Mar 20 22:11 ../
drwxr-xr-x    4 schneide tecfa        4608 Mar 21 16:27 MOO-1.8.1/
drwxr-xr-x    2 schneide tecfa         512 Mar 21 18:40 bin/
drwxr-xr-x    8 schneide tecfa         512 Mar 21 16:16 encore/
drwxr-xr-x    4 schneide tecfa         512 Mar 20 22:37 junk/
drwxr-xr-x    2 root     other         512 Mar 21 16:19 src/

(3) Compile the MOO server

The idea is that we keep the source code in one directory and the binary in an other one. Read the README file in the MOO-1.8.2 directory. You will have to do at the least the following:

* Go to the MOO source directory (MOO-1.8x) and run the configure command:

sh configure

* Edit the configuration file options.h

If you want your MOO to send mail or to suppor file upload you must uncomment define OUTBOUND_NETWORK, i.e. you should have a line like this

#define OUTBOUND_NETWORK

You also may uncomment

#define LOG_COMMANDS

* Then, compile the MOO server:

make

* if you look at the directory, you should see a moo executable file (moo*)

ls -latr

* Copy to moo file (or alternatively make a link in the bin directory)

cd ../bin
cp ../MOO-1.8.1/moo .

* Copy the start-up script to the bin directory

cp ../MOO-1.8.1/restart .

* You may have to fix the first line of this. E.g on Solaris it should read

#!/usr/bin/csh -f

and not as under Linux:

#!/bin/csh -f

(4) Install the enCore distribution

* Go to the home directory of your installation (e.g. /usr/local/moo)

* Unzip the enCore archive and adjust file owners if needed

gtar zxf enCore-5.x.tar.gz
chown -R user:group *

* Move the archive to src

mv enCore-5.x.tar.gz src

* Move the enCore MOO database from encore to bin

mv encore/enCore.db bin

### Make an Alias in the Web server[edit | edit source]

Sinc we put the encore Web Interface in the encore subdirectory, we have to tell Apache where to find it.

* Edit the Apache configuration file

If you did your own compiling / installation it may be something like:

/usr/local/apache/conf/http.conf

Under a typical Linux installation (I hate those) you have to dig around, probably you have to edit a file like:

/etc/httpd/conf/vhosts/Vhosts.conf

* Make an alias to the encore directory:

Alias /encore "/usr/local/moo/encore"

(If you forget this, the XPress Web Interface won't work. Of course, you also may do as they say in the "official" guidelines and copy all the files to your web directory, but I don't like this solution, since it makes desinstallation complicated ...)

### Start the MOO server[edit | edit source]

* Check contents of the bin directory:

moo
restart
enCore.db

* Then, launch the MOO server:

restart enCore

* Look at the log file:

more enCore.log

You should see something like:

Mar 21 16:40:51: LISTEN: #0 now listening on port 7777
Mar 21 16:40:51: LISTEN: #32 now listening on port 7000

## Configuration[edit | edit source]

To configure your MOO you should the first time use a ordinary MOO client. If you don't have one you may use telnet (but it will not be easy).

* Connect to the server

telnet your.server.xxx 7777

The standard port for a MOO is 7777 and you must type the port number

* Login

At the login screen, type

connect wizard

* Configure

In the MOO, type @configure and edit the most important parameters. Since there are default values it's probably enough to just define the "Base URL".

@configure

* Exit the MOO by typing @quit

quit

* The you can try out the web interface

http://yourserver.xxx.org:7000/

The administrator (wizard) can configure things with menus. In case the web interface doesn't appear, go back to "traditional" Moo interaction and fix the URL for the web interface. Also, try another browser, e.g. Firefox instead of Safari.

## Suport, End user guides and encore MOO examples[edit | edit source]

User Guides

* For the moment there seems to be none for v5 (Early 2007)
* For others, see MOO

Support

* [www.encore-consortium.org/Barn/default.htm The Barn] (dead domain)
* The Barn (As of 2017 it is here now)
* Mailing List]

* enCore v.4 User's Guide (as of March 2007 a similar v5 guide does not seem to exist).

Encore MOO sites

* See: http://people.clemson.edu/~texcyn/encore/moos.html