/[webpac]/trunk2/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

Annotation of /trunk2/INSTALL

Parent Directory Parent Directory | Revision Log Revision Log


Revision 255 - (hide annotations)
Tue Mar 9 12:17:05 2004 UTC (20 years ago) by dpavlin
Original Path: trunk/INSTALL
File size: 4336 byte(s)
ported r248:252 from hidra branch:

r248: much improved installation instructions, especially for Debian
      GNU/Linux distributions
r249: changed use of Spreadsheet::ParseExcel and MARC to require/import so
      that dependency on those modules can be resolved in runtime.
r250: finished installation documentation
r251: removing dependency on HTML::Parser would ease installation
r252: smaller eval{} fiexes. eval{} logic should really move to
      parse_format.pm

1 dpavlin 255 INSTALL INSTRUCTIONS
2 dpavlin 49
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 133 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 dpavlin 220 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 dpavlin 52 2. Use CPAN shell to install modules used:
43 dpavlin 49
44 dpavlin 52 $ sudo cpan
45     cpan> install module_name
46    
47     Modules which are needed:
48    
49     Text::Unaccent version 1.02 or higher, you might need
50     to get this one from
51     http://savannah.nongnu.org/projects/unac/
52     Config::IniFiles
53 dpavlin 255 DBD::Pg or some other DBD driver like DBD::SQLite
54 dpavlin 52 CGI::Application
55     HTML::Pager
56     HTML::Template
57     HTML::FillInForm
58     SWISH
59     SWISH::Fork and of course, swish-e executable
60 dpavlin 132 XML::Simple
61 dpavlin 255 Text::Iconv
62     TDB_File
63     HTML::Entities (part of HTML::Parser)
64 dpavlin 52
65     CPAN shell will also download some more modules to satisfy dependencies.
66    
67 dpavlin 255
68 dpavlin 52 If you plan to use M$ Excel files for import (type=excel), you will need:
69    
70     Spreadsheet::ParseExcel
71    
72 dpavlin 132 If you plan to use import from MARC files you will also need
73    
74     MARC
75    
76 dpavlin 255
77     2.1 Installation on Debian GNU/Linux
78    
79     You will need following packages to get started:
80    
81     perl
82     swish-e
83    
84     and all additional packages which are dependencies.
85    
86     You also don't have to install all CPAN modules manually. Just use
87     following Debian packages:
88    
89     libtext-unaccent-perl
90     libconfig-inifiles-perl
91     libdbd-pg-perl or some other DBD driver
92     libdbd-sqlite-perl like DBD::SQLite
93     libhtml-template-perl
94     libxml-simple-perl
95     libtext-iconv-perl
96     tdb-dev (for TDB_File module later)
97     libhtml-parser-perl
98    
99     and install following packages by hand from CPAN
100     because they are not part of Debian distribution:
101    
102     CGI::Application
103     HTML::Pager
104     HTML::FillInForm
105     SWISH
106     SWISH::Fork
107    
108     and optionally some of those modules:
109    
110     Spreadsheet::ParseExcel
111     MARC
112    
113     For compilation of OpenIsis in next step, you will also need following
114     packages:
115    
116     make
117     gcc
118     libc-dev
119    
120 dpavlin 132 3. You will need OpenIsis if you are using ISIS as an import format.
121 dpavlin 133 Currently, WebPAC uses OpenIsis 0.9.0 which *HAVE TO BE PATCHED*
122 dpavlin 132 with special patch so that perl module OpenIsis.pm have close call
123     (because there is hard-limit of 32 ISIS files in OpenIsis.pm, and that
124     is too low for our use).
125    
126 dpavlin 255 You can do that yourself, or if you did checkout of our subversion repository
127     you will already have latest OpenIsis in webpac/openisis/ directory.
128    
129     If you want to do it yourself, first get OpenIsis from:
130 dpavlin 132 http://openisis.org/Doc/GetIt
131    
132 dpavlin 255 Then get patch for close from:
133 dpavlin 132 http://www.rot13.org/~dpavlin/projects/openisis-0.9.0-perl_close.diff
134    
135 dpavlin 255 Unpack OpenIsis archive and apply patch -p0 to source tree.
136 dpavlin 132
137 dpavlin 255 Eater way, now you got OpenIsis 0.9.0 with close support for perl. So,
138     first compile C parts:
139    
140     make
141    
142     And then compile perl module and install it:
143    
144     make perl
145 dpavlin 132 cd perl
146     sudo make install
147    
148 dpavlin 255 Since you need development tools on target machine to compile OpenIsis,
149     you might want to compile it on another machine and just copy perl module.
150    
151 dpavlin 132 4. edit global.conf and all2xml.conf to suit your needs. Comments inside
152     those files should help get you started.
153    

Properties

Name Value
cvs2svn:cvs-rev 1.6

  ViewVC Help
Powered by ViewVC 1.1.26