Craftd:Installation: Difference between revisions

From wiki.vg
Jump to navigation Jump to search
imported>AyAn4m1
(Added a mostly complete compile guide for Linux)
imported>Jon
(→‎Obtain prerequisites: note for debian users)
 
(12 intermediate revisions by 3 users not shown)
Line 8: Line 8:


== Source ==
== Source ==
'''NOTE: There is a build script available which performs the majority of the following procedure for you. To use it, skip the first step of this guide, follow the second step to get the source code and then execute the build.sh script from the extras subfolder of your working copy directory.'''


=== Obtain prerequisites ===
=== Obtain prerequisites ===
To build craftd from source in Linux, you will need:
To build craftd from source in Linux, you will need the following packages and development headers installed:
* autotools/make/gcc
* autotools/make/gcc
* git
* libevent (http://monkey.org/~provos/libevent/)
* libevent (http://monkey.org/~provos/libevent/)
* libconfig (http://www.hyperrealm.com/libconfig/)
* pcre
Debian users may need to additionally install '''libltdl-dev'''. Symptoms:
* AC_LTDL_DLLIB not defined
* ltdl.m4 not found
Optional features:
* jansson - JSON RPC and web administration (http://www.digip.org/jansson/)
* SpiderMonkey - Javascript scripting (http://www.mozilla.org/js/spidermonkey/)
* ECL - Common LISP scripting (http://ecls.sourceforge.net/)


Most popular distributions do not have a package for the latest version of libevent. Therefore, it is best to fetch it from their website (shown above) and compile it. The latest release as of Feb. 5, 2011 is 2.0.10. Once you have obtained this package, extract it and run the following inside the resulting folder:
Most popular distributions do not have a package for the latest version of libevent. Therefore, it is best to fetch it from their website (shown above) and compile it. The latest release as of Feb. 5, 2011 is 2.0.10. Once you have obtained this package, extract it and run the following inside the resulting folder:
Line 23: Line 31:


First, checkout the code by running:
First, checkout the code by running:
<blockquote>git clone git://github.com/kev009/craftd.git</blockquote>
<blockquote>git clone git://github.com/craftd/craftd.git</blockquote>


The first time you check out the source, you will need to generate a configure script. You can do this by running the following in the working copy directory:
The first time you check out the source, you will need to generate a configure script. You can do this by running the following in the working copy directory:
<blockquote>autoreconf -i</blockquote>
<blockquote>./autogen</blockquote>


Now that you have a configure script, run it by executing:
Now that you have a configure script, run it by executing:

Latest revision as of 01:05, 15 June 2011

Menu

Binary Package

TODO

Source

Obtain prerequisites

To build craftd from source in Linux, you will need the following packages and development headers installed:

Debian users may need to additionally install libltdl-dev. Symptoms:

  • AC_LTDL_DLLIB not defined
  • ltdl.m4 not found

Optional features:

Most popular distributions do not have a package for the latest version of libevent. Therefore, it is best to fetch it from their website (shown above) and compile it. The latest release as of Feb. 5, 2011 is 2.0.10. Once you have obtained this package, extract it and run the following inside the resulting folder:

./configure
make
make install
ldconfig

Get the Source

First, checkout the code by running:

git clone git://github.com/craftd/craftd.git

The first time you check out the source, you will need to generate a configure script. You can do this by running the following in the working copy directory:

./autogen

Now that you have a configure script, run it by executing:

./configure

See the README file for more information on options to pass to configure.

Compile

NOTE: If you have a multi-core processor available, you can decrease compile-time by running `make -jX` instead of `make`, where X is the number of processor cores you have.

You can compile and install the server by running the following from your working copy directory:

make
make install

Configuration

By default, an example config file is installed to /usr/local/etc/craftd/craftd.conf.dist. You should make a copy of this file called craftd.conf and edit that to suit your purposes. See Craftd:Configuration for more information on editing this file.