/[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

Contents of /branches/hidra/INSTALL

Parent Directory Parent Directory | Revision Log Revision Log


Revision 248 - (show annotations)
Mon Mar 8 20:32:36 2004 UTC (15 years, 8 months ago) by dpavlin
File size: 4114 byte(s)
much improved installation instructions, especially
for Debian GNU/Linux distributions

1 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 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
10 dbi_* parameters in global.conf [global] section (which you want
11 to do anyway to specify user and password to connect to database).
12
13 If you use PostgreSQL, you have to first create database:
14
15 $ createdb webpac
16 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
25 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 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:
43
44 $ 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 DBD::Pg or some other DBD driver
54 CGI::Application
55 HTML::Pager
56 HTML::Template
57 HTML::FillInForm
58 SWISH
59 SWISH::Fork and of course, swish-e executable
60 XML::Simple
61
62 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:
66
67 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

Properties

Name Value
cvs2svn:cvs-rev 1.6

  ViewVC Help
Powered by ViewVC 1.1.26