INSTALL
author Vincent Tondellier <tonton+hg@team1664.org>
Sun, 14 Feb 2016 19:58:33 +0100
changeset 92 702e246e5c9f
parent 51 2894d97715c9
permissions -rw-r--r--
Fix config key when inserting
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
13
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
     1
Web interface dependencies:
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
     2
- perl >= 5.10
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
     3
- Mojolicious >= 2.98
51
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
     4
- Mojolicious::Plugin::BootstrapPagination
13
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
     5
- perl-UUID
14
e9c1591a4f54 Add jquery too
Vincent Tondellier <tonton+hg@team1664.org>
parents: 13
diff changeset
     6
- jquery
13
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
     7
51
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
     8
On debian, install libuuid-perl, libmojolicious-perl (from wheezy-backports) and libjs-jquery.
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
     9
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    10
Mojolicious::Plugin::BootstrapPagination can be installed with cpan, or you
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    11
can create a debian package with cpan2deb Mojolicious::Plugin::BootstrapPagination
13
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    12
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    13
Edit CrashTest.conf and change the paths to match your environment.
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    14
51
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    15
If you want to use the SQL backend for a faster index page, see dist.ini for
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    16
the additional requirements. Then, you can create the tables with :
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    17
$ ./CrashTest.pl db create
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    18
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    19
Next, you need to get and build the json minidump-stackwalk from soccoro:
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    20
https://github.com/mozilla/socorro/tree/master/minidump-stackwalk/
13
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    21
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    22
Full compilation instructions:
51
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    23
$ svn co http://google-breakpad.googlecode.com/svn/trunk google-breakpad
13
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    24
$ mkdir obj-breakpad
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    25
$ cd obj-breakpad
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    26
$ ../google-breakpad/configure && make
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    27
$ cd ../
51
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    28
$ mkdir minidump-stackwalk
13
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    29
$ cd minidump-stackwalk
51
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    30
$ wget https://github.com/mozilla/socorro/raw/master/minidump-stackwalk/{Makefile,stackwalker.cc}
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    31
$ make BREAKPAD_SRCDIR=../google-breakpad/src BREAKPAD_LIBS="../obj-breakpad/src/libbreakpad.a ../obj-breakpad/src/third_party/libdisasm/libdisasm.a" OBJS=/usr/lib/libjsoncpp.a JSON_INCLUDEDIR=/usr/include/jsoncpp
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    32
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    33
Note: the paths above are for the system-installed libjsoncpp on debian. Get
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    34
the jsoncpp from socorro repository, or adjust the paths for you system if you
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    35
use another distribution.
13
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    36
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    37
Copy stackwalker to the path configured in CrashTest.conf.
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    38
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    39
No, you can test:
51
2894d97715c9 Update install instructions
Vincent Tondellier <tonton+hg@team1664.org>
parents: 15
diff changeset
    40
$ hypnotoad -f ./CrashTest.pl
13
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    41
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    42
The submit URL is /submit and is compatible with socorro.
b5d8f0f977aa Add install instruction
Vincent Tondellier <tonton+hg@team1664.org>
parents:
diff changeset
    43