-
Notifications
You must be signed in to change notification settings - Fork 49
/
INSTALL.html
123 lines (123 loc) · 7.91 KB
/
INSTALL.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
<head>
<meta charset="utf-8" />
<meta name="generator" content="pandoc" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<title>Installation Guide to PennMUSH 1.8.x</title>
<style type="text/css">
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
span.underline{text-decoration: underline;}
div.column{display: inline-block; vertical-align: top; width: 50%;}
</style>
<link rel="stylesheet" href="mushdoc.css">
<!--[if lt IE 9]>
<script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
<![endif]-->
</head>
<body>
<header>
<h1 class="title">Installation Guide to PennMUSH 1.8.x</h1>
</header>
<nav id="TOC">
<ul>
<li><a href="#introduction">Introduction</a></li>
<li><a href="#important-background">Important background</a></li>
<li><a href="#installation-from-source">Installation from source</a></li>
</ul>
</nav>
<h1 id="introduction">Introduction</h1>
<p>This file explains how to install PennMUSH. It comes in three parts:</p>
<ol type="1">
<li>Important background</li>
<li>Installation from source (recommended)</li>
<li>Installation of precompiled binaries (only for Windows platforms)</li>
</ol>
<p>If you are upgrading from a previous PennMUSH release, this is probably not the file you want to start with. Read the <a href="UPGRADING.html">UPGRADING.md</a> file first.</p>
<p><strong>DISCLAIMER</strong>: Before attempting to run a MUD of any sort, you should have some reasonable knowledge of UNIX and C. If you do not, it is <em>strongly</em> suggested that you learn UNIX and C to some reasonable level of competency before attempting to set up a MUSH. (Note that even people using the Windows ports are encouraged to know UNIX, because that's the paradigm that PennMUSH was built with, and most resources will be written with UNIX is mind.)</p>
<p>You may also want to take a look at the Managing PennMUSH book at <a href="http://community.pennmush.org" class="uri">http://community.pennmush.org</a> and at Javelin's Guide for PennMUSH Gods, at <a href="http://download.pennmush.org/Guide/guide-single.html" class="uri">http://download.pennmush.org/Guide/guide-single.html</a></p>
<h1 id="important-background">Important background</h1>
<p>Here's a quick picture of the organization of the MUSH directory tree. The "src" directory contains C source code. The "hdrs" directory contains header files for the source code. The files used by a running MUSH are in the "game" directory, which includes subdirectories "data" (current databases), "txt" (text files and directories for building them), "log" (log files), and "save" (backup databases). Finally, the "hints" directory is used during the installation process, the "test" directory contains an automated regression testing suite, and the "po" directory holds translation message files.</p>
<pre><code>pennmush--+-> src
+-> hdrs
+-> game ------+-> data
| |
| +-> txt -------+-> nws
| | +-> evt
| | \-> hlp
| |
| +-> log
| \-> save
+-> hints
+-> po
+-> utils
+-> test
\-> win32
</code></pre>
<p>PennMUSH has been tested on a fairly wide variety of machines and operating systems including at least:</p>
<ul>
<li>GNU/Linux</li>
<li>NetBSD</li>
<li>OpenBSD</li>
<li>Mac OS X</li>
<li>Microsoft Windows</li>
</ul>
<p>There's no real reason why PennMUSH shouldn't compile on any 32-bit or better BSD, System V, or POSIX operating system. Development is primarily done on GNU/Linux and NetBSD systems.</p>
<p>Mac OS 9 and earlier ("Classic"), and OS/2 are not supported.</p>
<h1 id="installation-from-source">Installation from source</h1>
<p>The quickstart version of the installation is:</p>
<ol type="1">
<li>On win32 only, install proper tools or read win32/README*.</li>
<li>On Unix systems, you need: A C compiler, perl, the minimum development packages required to compile programs (Linux distributions that don't come with gcc in the base install often need a package named glibc-dev).</li>
<li>A version of the PCRE regular expression library and any related development packages. (Debian and Ubuntu call them libpcre3 and libpcre3-dev).</li>
<li>A version of the OpenSSL library; most OSes these days come with it out of the box, but some might require a development package as well (libssl-dev, openssl-dev or some such name).</li>
<li>Development versions of a number of optional libraries are nice to have:
<ul>
<li>A sql client library for MySQL/MariaDB or Postgresql.</li>
<li>ICU (For enhanced Unicode support)</li>
<li>libevent (For ssl_slave)</li>
<li>libcurl (For <code>@http</code>)</li>
</ul></li>
<li>Run ./configure with any desired options (See ./configure --help or read below)</li>
<li>make update</li>
<li>make install</li>
<li>possibly make customize</li>
<li>Read game/README and follow those instructions</li>
</ol>
<p>Here's the process in detail:</p>
<ol type="1">
<li><p>If you're running on win32, read one of the win32/README* files for information on how to compile with various compilers.</p></li>
<li><p>On Unix systems, unpack the code and:</p>
<pre><code> % cd pennmush
% ./configure </code></pre>
<p>Useful arguments to configure:</p>
<dl>
<dt><code>--disable-sql</code></dt>
<dd><p>Don't compile in SQL support. See <a href="README.SQL.html">README.SQL</a> for more sql-related config options.</p>
</dd>
<dt><code>--disable-nls</code></dt>
<dd><p>Turn off translation support if you don't need it.</p>
</dd>
<dt><code>--disable-info_slave</code></dt>
<dd><p>Don't use an external process to do hostname lookups. This option is required on Windows.</p>
</dd>
<dt><code>--help</code></dt>
<dd><p>See all options.</p>
</dd>
</dl>
<p>Environment variables to customize search paths:</p>
<ul>
<li>CPPFLAGS=-I/path/to/extra/headers</li>
<li>LDFLAGS=-L/path/to/extra/libraries</li>
<li>CFLAGS=-Optimization and -Warning options.</li>
</ul>
<p>See hints/your-os.txt and hints/your-processor if present for more details and system-specific help, and <a href="README.SQL.html">README.SQL</a> for help with detecting a SQL server.</p></li>
<li><p>Run <code>make update</code>, and answer all the questions about which MUSH options you want. This will also create several config files in game/ which you may wish to edit, particularly game/mush.cnf, and will create the game/restart script that's used to start your MUSH.</p></li>
<li><p>Do a <code>make install</code>. This will build all the necessary files, and set up some symbolic links for the restart script. You will probably receive a few compilation warnings, which can generally be ignored.</p></li>
<li><p>If you plan to run multiple MUSHes, you may want to do a "make customize" which will run a script to help set up a separate customized game subdirectory for each MUSH (run it once per MUSH you plan to run). Files in these subdirectories will already be customized in many ways, so what follows may be slightly different. :) This is probably broken.</p></li>
<li><p>Read game/README and follow those instructions.</p></li>
</ol>
<p>A final thing you may want to think about is compiling portmsg.c (<code>make portmsg</code>). This is a port announcer; if your MUSH ever goes down, you can set one up, and a message will be given to a person attempting to connect to that port. Read the comments in src/portmsg.c for details. It is not an official MUSH piece of code; rather, it is a freely distributable program available via anonymous FTP that is included in this code because it happens to be fairly useful.</p>
</body>
</html>