Commit 2a346db3 authored by Aleksy Barcz's avatar Aleksy Barcz

Updated INSTALL

+ cmake etc
parent 936b3617
SZARP installation guide
========================
Author: Paweł Pałucha <pawel@praterm.com.pl>
Authors:
Paweł Pałucha <pawel@praterm.com.pl>
Tomasz Pieczerak <tph@newterm.pl>
Aleksy Barcz <abarcz@newterm.pl>
This file briefly describes how to install SZARP software. The simplest way of
installation for end-users it to use Debian packages.
SZARP is compile and run on Debian GNU/Linux (i386, amd64, armel/armhf)
and Ubuntu. Some client applications are also cross-compiled for Windows.
All the development and testing is done only on Debian GNU/Linux, so you can
run into some problems with other distributions.
See INSTALL.Windows for information about Windows platform.
SZARP is compiled and run on Debian GNU/Linux (i386, amd64, armel/armhf)
and Ubuntu. On Windows you can use WSL (Windows Subsystem for Linux).
All the development and testing is done only on Debian GNU/Linux,
so you can run into some problems with other distributions.
1. Installation from source.
......@@ -23,79 +24,35 @@ recommend to install Debian packages so all the stuff will be in correct place.
Then you can replace binaries with your own compiled versions or run them
directly from your working directory.
SZARP uses autotools, but is deployed without configure scripts, so you need
automake, autoconf, libtool and pkg-config. The commands to build SZARP are:
# ./autogen.sh
This invokes automake and autoconf, it should run without any error messages.
In case of errors, check whether you have newest versions of automake,
autoconf, libtool and pkg-config installed.
# ./configure
This is the invocation of configure scripts. There are many options available,
see:
# ./configure --help
Configuration for Windows is described in INSTALL.Windows. There are
'--with-XXX' and '--without-XXX' options available to turn on/off optional
libraries. For example, to get server-only software (and get short compile time),
you can use '--without-x'.
By default all optional libraries are turned on. If some library is not found,
SZARP is configured without this library. At the end of configure run, there's
a report generated with information what libraries where found. To get full
functionality, you must have all libraries. You can skip some libraries, but
some parts of code will fail to compile (yes, we don't test every possible
combination of missing libraries). The safest bet is to have all libraries.
SZARP uses cmake for build and deployment (some files may still be deployed with
with configure scripts), so you need cmake to start with.
The commands to build SZARP are:
If you plan to debug programs, you should change compiler options. By default
'-g' is used, but -O2 (optimization) fools debugger. To get debugger-friendly
code run configure with options:
# cmake .
# ./configure CFLAGS=-g CXXFLAGS=-g
Now:
This invokes cmake and runs checks for missing libraries. All libraries
should be present for SZARP to build and run properly.
# make
This should compile everything. If there are errors, you have found a bug. But
if you're not using some old releases of Debian (ie. lenny, squeeze), there's
a little chance that we will help you with this. Patches are welcome if they do
not brake Debian compilation ;-). If you configure SZARP with LUA parameters
optimiser enabled, you need a lot of memory during compilation - about 1 GB
without '-g' options, 2 GB is better if you use '-g'.
# make doc
This creates html documentation. You need lots of Docbook stuff installed for
this to work, ./configure should warn you about missing programs.
This should compile everything, including documentation. If there are errors,
you have found a bug. Patches are welcome if they don't break Debian builds.
For building SZARP you will need at least 4GB RAM, as parts of the code use
templates extensively, more is recommended.
Now you can become root and type:
# make install
Default install directory is /opt/szarp. You can install SZARP under other
directory by using:
# make DESTDIR=/tmp install
or by passing '--prefix' argument to ./configure.
To install programs without debugger information (smaller, faster binaries
but debugging not possible), you can use:
# make install-strip
Default install directory is /opt/szarp.
To clean everything use:
# make clean
To get rid also of files generated by autotools, use:
To get rid of files and dirs generated by cmake, use:
# make maintainer-clean
# ./maintainer-clean.sh
2. Installation of Debian packages.
......@@ -103,7 +60,7 @@ To get rid also of files generated by autotools, use:
This is the simplest and best supported method of installation.
Add following line to /etc/apt/sources.list:
deb http://www.szarp.org/debian wheezy main
deb http://packages.szarp.org/debian stretch main
Then run:
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment