/[webpac]/branches/hidra/INSTALL
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Diff of /branches/hidra/INSTALL

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

trunk/INSTALL revision 52 by dpavlin, Sun Jun 1 18:48:55 2003 UTC branches/hidra/INSTALL revision 248 by dpavlin, Mon Mar 8 20:32:36 2004 UTC
# Line 1  Line 1 
1  beta-beta-beta INSTALL INSTRUCTIONS  INSTALL INSTRUCTIONS
2    
3  Feel free to contact me via e-mail to dpavlin@rot13.org if those instructions  Feel free to contact me via e-mail to dpavlin@rot13.org if those instructions
4  don't work for you.  don't work for you.
5    
6  1. You will need PostgreSQL (for now)  1. You will need RDBMS (relational database management system) for index
7       files. PostgreSQL and SQLite are tested and supported.
8    
9     Using any other database is quite easy, and involves editing of     Using any other database is quite easy, and involves editing of
10     dbi_* parameters in isis2xml.conf [global] section (which you want     dbi_* parameters in global.conf [global] section (which you want
11     to do anyway to specify user and password to connect to database).     to do anyway to specify user and password to connect to database).
12    
13     Then, create database:     If you use PostgreSQL, you have to first create database:
14    
15     $ createdb webpac     $ createdb webpac
16     CREATE DATABASE     CREATE DATABASE
17    
18       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     Tables for index(es) will be created automatically on first run. If you     Tables for index(es) will be created automatically on first run. If you
25     change data for index often, you might want to drop and re-create database     change data for index often, you might want to drop and re-create database
26     to erase tables for indexes which are removed.     to erase tables for indexes which are removed.
27    
28       SQLite can be quite faster than PostgreSQL (for reference see SQLite
29       site: http://www.hwaci.com/sw/sqlite/speed.html). Since WebPAC doesn't
30       use advanced database facilities of PostgreSQL you would probably be
31       better off with SQLite if you don't have PostgreSQL already installed.
32    
33       If you are using SQLite, there is no need to specify dbi_user or dbi_pass.
34       So, just leave them like this:
35    
36       dbi_user=""
37       dbi_passwd=""
38    
39       If you specify dbi_user and than try to index using different user,
40       you won't be able to write into database.
41    
42  2. Use CPAN shell to install modules used:  2. Use CPAN shell to install modules used:
43    
44     $ sudo cpan     $ sudo cpan
# Line 29  don't work for you. Line 50  don't work for you.
50                                  to get this one from                                  to get this one from
51                                  http://savannah.nongnu.org/projects/unac/                                  http://savannah.nongnu.org/projects/unac/
52          Config::IniFiles          Config::IniFiles
53          DBD::Pg                 or some other DBD driver, you can also          DBD::Pg                 or some other DBD driver
                                 use the one which came with distribution  
                                 (e.g. libdbd-pg-perl on Debian)  
54          CGI::Application          CGI::Application
55          HTML::Pager          HTML::Pager
56          HTML::Template          HTML::Template
57          HTML::FillInForm          HTML::FillInForm
58          SWISH          SWISH
59          SWISH::Fork             and of course, swish-e executable          SWISH::Fork             and of course, swish-e executable
60                                  (e.g. swish-e package on Debian)          XML::Simple
61    
62     CPAN shell will also download some more modules to satisfy dependencies.     CPAN shell will also download some more modules to satisfy dependencies.
63    
64    
65     If you plan to use M$ Excel files for import (type=excel), you will need:     If you plan to use M$ Excel files for import (type=excel), you will need:
66    
67          Spreadsheet::ParseExcel          Spreadsheet::ParseExcel
68    
69       If you plan to use import from MARC files you will also need
70    
71            MARC
72    
73    
74    2.1 Installation on Debian GNU/Linux
75    
76       You will need following packages to get started:
77    
78            perl
79            swish-e
80    
81       and all additional packages which are dependencies.
82    
83       You also don't have to install all CPAN modules manually. Just use
84       following Debian packages:
85    
86            libtext-unaccent-perl
87            libconfig-inifiles-perl
88            libdbd-pg-perl
89            libhtml-template-perl
90            libxml-simple-perl
91    
92       and install following packages by hand from CPAN
93       because they are not part of Debian distribution:
94    
95            CGI::Application
96            HTML::Pager
97            HTML::FillInForm
98            SWISH
99            SWISH::Fork
100    
101       and optionally some of those modules:
102    
103            Spreadsheet::ParseExcel
104            MARC
105    
106       For compilation of OpenIsis in next step, you will also need following
107       packages:
108    
109            make
110            gcc
111            libc-dev
112    
113    3. You will need OpenIsis if you are using ISIS as an import format.
114       Currently, WebPAC uses OpenIsis 0.9.0 which *HAVE TO BE PATCHED*
115       with special patch so that perl module OpenIsis.pm have close call
116       (because there is hard-limit of 32 ISIS files in OpenIsis.pm, and that
117       is too low for our use).
118    
119       You can do that yourself, or if you did checkout of our subversion repository
120       you will already have latest OpenIsis in webpac/openisis/ directory.
121    
122       If you want to do it yourself, first get OpenIsis from:
123            http://openisis.org/Doc/GetIt
124    
125       Then get patch for close from:
126            http://www.rot13.org/~dpavlin/projects/openisis-0.9.0-perl_close.diff
127    
128       Unpack OpenIsis archive and apply patch -p0 to source tree.
129    
130       Eater way, now you got OpenIsis 0.9.0 with close support for perl. So,
131       first compile C parts:
132    
133            make
134    
135       And then compile perl module and install it:
136    
137            make perl
138            cd perl
139            sudo make install
140    
141       Since you need development tools on target machine to compile OpenIsis,
142       you might want to compile it on another machine and just copy perl module.
143    
144    4. edit global.conf and all2xml.conf to suit your needs. Comments inside
145       those files should help get you started.
146    
Legend:
Removed from v.52  
changed lines
  Added in v.248
  ViewVC Help
Powered by ViewVC 1.1.26