← Back to branch summary

~cpick/mongrel2/release

« back to all changes in this revision

Viewing changes to docs/manual/installing.tex

  • Committer: Chris Pick
  • Date: 2013-06-30 16:39:57 UTC
  • mfrom: (1106.1.15)
  • Revision ID: git-v1:ec39967acb6bc9867ed9b9dc3774304ca6b9c294
Merge tag 'v1.8.1' into debian

Hotfix for github issue 148

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/manual/installing.tex
32
32
install required packages for your OS, but here's how I did it on my computer:
33
33
 
34
34
\begin{code}{Installing Dependencies on ArchLinux}
35
 
<< d['docs/manual/inputs/install_dependencies.sh|pyg|l'] >>
 
35
<< d['inputs/install_dependencies.sh|pyg|l'] >>
36
36
\end{code}
37
37
 
38
38
If you run into parts that your OS is missing, which is likely on
39
39
Debian and SuSE systems, then you'll have to go and figure out
40
40
how to install it.
41
41
 
 
42
Some distributions (like Ubuntu) split ``dev'' and ``runtime'' packages.
 
43
In order to build mongrel2 on these distros, you must install libsqlite3-dev:
 
44
this package contains sqlite3.h, which Mongrel2 needs during compilation.
 
45
 
 
46
For the lazy, the command is: \shell{sudo apt-get install libsqlite3-dev}
 
47
 
 
48
Other pieces known to be missing on ubuntu-like systems: 
 
49
 
 
50
\begin{itemize}
 
51
\item uuid-runtime: Needed by m2sh uuid command
 
52
\item You may need to run: \shell{sudo ldconfig -v} 
 
53
\end{itemize}
 
54
 
 
55
 
42
56
\section{Building Mongrel2}
43
57
 
44
58
If everything went well you should be able to grab the Mongrel2 source
68
82
Once you have git you can then get the Mongrel2 source and open it up:
69
83
 
70
84
\begin{code}{Cloning the Mongrel2 Source}
71
 
<< d['docs/manual/inputs/cloning_mongrel2_source.sh|pyg|l'] >>
 
85
<< d['inputs/cloning_mongrel2_source.sh|pyg|l'] >>
72
86
\end{code}
73
87
 
74
88
Make sure you do this in order (just like with every set of instructions you follow)
98
112
If any of these stages fail, then you can simply try to fix them and then
99
113
run:  \shell{make clean all \&\& sudo make install} which will do everything all over again.
100
114
 
 
115
\subsection{Other platforms than Linux}
 
116
 
 
117
If you aren't running Linux chances are good this standard procedure will not work for you.
 
118
 
 
119
The ``Makefile`` lists several targets for various platforms, as of writing this there are:
 
120
 
 
121
\begin{itemize}
 
122
\item freebsd
 
123
\item netbsd
 
124
\item openbsd
 
125
\item macports
 
126
\end{itemize}
 
127
 
 
128
So for example you would probably install zeromq and sqlite3 as ports and then compile it like so:
 
129
 
 
130
\begin{code}{Installing Mongrel2 on FreeBSD}
 
131
<< d['inputs/install_freebsd.sh|pyg|l'] >>
 
132
\end{code}
 
133
 
101
134
\section{Testing The Installation}
102
135
 
103
136
When you are done, you probably want to make sure that it installed correctly.
105
138
use to try it out:
106
139
 
107
140
\begin{code}{First Test Run}
108
 
<< d['docs/manual/inputs/first_mongrel2_run.sh|pyg|l'] >>
 
141
<< d['inputs/first_mongrel2_run.sh|pyg|l'] >>
109
142
\end{code}
110
143
 
111
144
That's it.  Just hit CTRL-c for now and we'll get into playing with this
113
146
 
114
147
\section{Upgrading from trunk}
115
148
\begin{code}{Update your checkout}
116
 
<< d['docs/manual/inputs/updating_your_checkout.sh|pyg|l'] >>
 
149
<< d['inputs/updating_your_checkout.sh|pyg|l'] >>
117
150
\end{code}
118
151
 
119
152