1 |
dpavlin |
49 |
beta-beta-beta INSTALL INSTRUCTIONS |
2 |
|
|
|
3 |
|
|
Feel free to contact me via e-mail to dpavlin@rot13.org if those instructions |
4 |
|
|
don't work for you. |
5 |
|
|
|
6 |
dpavlin |
132 |
1. You will need RDBMS (relational database management system) for index |
7 |
|
|
files. PostgreSQL and SQLite are tested and supported. |
8 |
dpavlin |
49 |
|
9 |
|
|
Using any other database is quite easy, and involves editing of |
10 |
dpavlin |
132 |
dbi_* parameters in global.conf [global] section (which you want |
11 |
dpavlin |
49 |
to do anyway to specify user and password to connect to database). |
12 |
|
|
|
13 |
dpavlin |
132 |
If you use PostgreSQL, you have to first create database: |
14 |
dpavlin |
49 |
|
15 |
dpavlin |
52 |
$ createdb webpac |
16 |
dpavlin |
49 |
CREATE DATABASE |
17 |
|
|
|
18 |
dpavlin |
132 |
If using SQLite, just specify file which SQLite will use (in global.conf) |
19 |
|
|
like this: |
20 |
|
|
|
21 |
|
|
dbi_dbd=SQLite |
22 |
|
|
dbi_dsn=dbname=/data/webpac/index.sqlite |
23 |
|
|
|
24 |
dpavlin |
52 |
Tables for index(es) will be created automatically on first run. If you |
25 |
dpavlin |
49 |
change data for index often, you might want to drop and re-create database |
26 |
|
|
to erase tables for indexes which are removed. |
27 |
|
|
|
28 |
dpavlin |
52 |
2. Use CPAN shell to install modules used: |
29 |
dpavlin |
49 |
|
30 |
dpavlin |
52 |
$ sudo cpan |
31 |
|
|
cpan> install module_name |
32 |
|
|
|
33 |
|
|
Modules which are needed: |
34 |
|
|
|
35 |
|
|
Text::Unaccent version 1.02 or higher, you might need |
36 |
|
|
to get this one from |
37 |
|
|
http://savannah.nongnu.org/projects/unac/ |
38 |
|
|
Config::IniFiles |
39 |
|
|
DBD::Pg or some other DBD driver, you can also |
40 |
|
|
use the one which came with distribution |
41 |
|
|
(e.g. libdbd-pg-perl on Debian) |
42 |
|
|
CGI::Application |
43 |
|
|
HTML::Pager |
44 |
|
|
HTML::Template |
45 |
|
|
HTML::FillInForm |
46 |
|
|
SWISH |
47 |
|
|
SWISH::Fork and of course, swish-e executable |
48 |
|
|
(e.g. swish-e package on Debian) |
49 |
dpavlin |
132 |
XML::Simple |
50 |
dpavlin |
52 |
|
51 |
|
|
CPAN shell will also download some more modules to satisfy dependencies. |
52 |
|
|
|
53 |
|
|
If you plan to use M$ Excel files for import (type=excel), you will need: |
54 |
|
|
|
55 |
|
|
Spreadsheet::ParseExcel |
56 |
|
|
|
57 |
dpavlin |
132 |
If you plan to use import from MARC files you will also need |
58 |
|
|
|
59 |
|
|
MARC |
60 |
|
|
|
61 |
|
|
3. You will need OpenIsis if you are using ISIS as an import format. |
62 |
|
|
Currently, WebPac uses OpenIsis 0.9.0 which *HAVE TO BE PATCHED* |
63 |
|
|
with special patch so that perl module OpenIsis.pm have close call |
64 |
|
|
(because there is hard-limit of 32 ISIS files in OpenIsis.pm, and that |
65 |
|
|
is too low for our use). |
66 |
|
|
|
67 |
|
|
Get OpenIsis from: |
68 |
|
|
http://openisis.org/Doc/GetIt |
69 |
|
|
|
70 |
|
|
Get patch for close from: |
71 |
|
|
http://www.rot13.org/~dpavlin/projects/openisis-0.9.0-perl_close.diff |
72 |
|
|
|
73 |
|
|
Unpack OpenIsis archive and apply patch -p0 to source tree. Type make, and |
74 |
|
|
than: |
75 |
|
|
|
76 |
|
|
cd perl |
77 |
|
|
perl Makefile.PL |
78 |
|
|
make |
79 |
|
|
sudo make install |
80 |
|
|
|
81 |
|
|
4. edit global.conf and all2xml.conf to suit your needs. Comments inside |
82 |
|
|
those files should help get you started. |
83 |
|
|
|