Project

General

Profile

Building Core On Ubuntu » History » Version 1

miohtama, 05/17/2009 01:23 PM

1 1 miohtama
h1. Building Quassel core with PostgreSQL support on Ubuntu Hardy
2 1 miohtama
3 1 miohtama
These instructions tell how to build the latest quassel core for your Ubuntu 8.04 Hardy Heron server. PostgreSQL database backend will be used instead of the default SQLite backend, since it scales better with many users and much of history. 
4 1 miohtama
5 1 miohtama
Make sure repositores are up-to-date
6 1 miohtama
<pre>
7 1 miohtama
sudo apt-get update
8 1 miohtama
</pre>
9 1 miohtama
10 1 miohtama
Install required dependencies and build tools
11 1 miohtama
<pre>
12 1 miohtama
sudo apt-get install git-core postgresql-8.3 qt4-dev-tools libqt4-dev libqt4-sql-psql screen
13 1 miohtama
</pre>
14 1 miohtama
15 1 miohtama
Pull out source codes
16 1 miohtama
<pre>
17 1 miohtama
git clone git://git.quassel-irc.org/quassel.git
18 1 miohtama
</pre>
19 1 miohtama
20 1 miohtama
Build it
21 1 miohtama
<pre>
22 1 miohtama
cd quassel
23 1 miohtama
cmake .
24 1 miohtama
</pre>
25 1 miohtama
26 1 miohtama
Setup PostgreSQL database master user
27 1 miohtama
28 1 miohtama
"Follow these instructions":https://help.ubuntu.com/community/PostgreSQL
29 1 miohtama
30 1 miohtama
Setup quassel PostgreSQL database:
31 1 miohtama
32 1 miohtama
<pre>
33 1 miohtama
sudo -i
34 1 miohtama
sudo -u postgres psql
35 1 miohtama
postgres=# CREATE USER quassel ENCRYPTED PASSWORD 'somepassword';
36 1 miohtama
CREATE ROLE
37 1 miohtama
postgres=# CREATE DATABASE quassel WITH OWNER quassel ENCODING 'UTF8';
38 1 miohtama
CREATE DATABASE
39 1 miohtama
</pre>
40 1 miohtama
41 1 miohtama
Create SSL certificate:
42 1 miohtama
43 1 miohtama
<pre>
44 1 miohtama
openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout ~/.config/quassel-irc.org/quasselCert.pem -out ~/.config/quassel-irc.org/quasselCert.pem
45 1 miohtama
</pre>
46 1 miohtama
47 1 miohtama
h2. Running Core
48 1 miohtama
49 1 miohtama
"Screen":http://www.debuntu.org/2006/07/04/72-how-to-screen-the-ultimate-admin-tool is a terminal tool which allwos you to leave terminal sessions running background even when you are logged out.
50 1 miohtama
51 1 miohtama
We run quassel in screen so that core keeps running as long as it is killed or the server is restarted
52 1 miohtama
53 1 miohtama
<pre>
54 1 miohtama
screen
55 1 miohtama
cd quassel
56 1 miohtama
./quasselcore
57 1 miohtama
</pre>
58 1 miohtama
59 1 miohtama
Now you can shut down your terminal and the quassel core still keeps running. 
60 1 miohtama
61 1 miohtama
Later we can reattach to this screen session to check out the quassel core terminal output to see if there has been any problems. Login in and type:
62 1 miohtama
63 1 miohtama
<pre>
64 1 miohtama
screen -x
65 1 miohtama
</pre>
66 1 miohtama
67 1 miohtama
Now you should how you left your terminal last time you shut it down.
68 1 miohtama
69 1 miohtama
70 1 miohtama
h2. Starting using it
71 1 miohtama
72 1 miohtama
Configuration wizard will guide you through the rest of the setup when you connect to your Quassel core using Quassel client for the first time. Remember to choose PostgreSQL backend instead of SQLite when asked.