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

Diff of /trunk2/INSTALL

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

revision 132 by dpavlin, Thu Oct 9 10:22:35 2003 UTC revision 304 by dpavlin, Sat Apr 17 20:40:28 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.
# Line 25  don't work for you. Line 25  don't work for 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 36  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 like DBD::SQLite
                                 use the one which came with distribution  
                                 (e.g. libdbd-pg-perl on Debian)  
54          CGI::Application          CGI::Application
         HTML::Pager  
55          HTML::Template          HTML::Template
56          HTML::FillInForm          HTML::FillInForm
57          SWISH          SWISH::API
         SWISH::Fork             and of course, swish-e executable  
                                 (e.g. swish-e package on Debian)  
58          XML::Simple          XML::Simple
59            Text::Iconv
60            TDB_File
61            HTML::Entities          (part of HTML::Parser)
62    
63     CPAN shell will also download some more modules to satisfy dependencies.     CPAN shell will also download some more modules to satisfy dependencies.
64    
65    
66     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:
67    
68          Spreadsheet::ParseExcel          Spreadsheet::ParseExcel
# Line 58  don't work for you. Line 71  don't work for you.
71    
72          MARC          MARC
73    
74    
75    2.1 Installation on Debian GNU/Linux
76    
77       You will need following packages to get started:
78    
79            perl
80            swish-e
81    
82       and all additional packages which are dependencies.
83    
84       You also don't have to install all CPAN modules manually. Just use
85       following Debian packages:
86    
87            libtext-unaccent-perl
88            libconfig-inifiles-perl
89            libdbd-pg-perl          or some other DBD driver
90            libdbd-sqlite-perl      like DBD::SQLite
91            libhtml-template-perl
92            libxml-simple-perl
93            libtext-iconv-perl
94            tdb-dev                 (for TDB_File module later)
95            libhtml-parser-perl
96    
97       and install following packages by hand from CPAN
98       because they are not part of Debian distribution:
99    
100            CGI::Application
101            HTML::FillInForm
102            SWISH::API
103    
104       and optionally some of those modules:
105    
106            Spreadsheet::ParseExcel
107            MARC
108    
109       For compilation of OpenIsis in next step, you will also need following
110       packages:
111    
112            make
113            gcc
114            libc-dev
115    
116  3. You will need OpenIsis if you are using ISIS as an import format.  3. You will need OpenIsis if you are using ISIS as an import format.
117     Currently, WebPac uses OpenIsis 0.9.0 which *HAVE TO BE PATCHED*     Currently, WebPAC uses OpenIsis 0.9.0 which *HAVE TO BE PATCHED*
118     with special patch so that perl module OpenIsis.pm have close call     with special patch so that perl module OpenIsis.pm have close call
119     (because there is hard-limit of 32 ISIS files in OpenIsis.pm, and that     (because there is hard-limit of 32 ISIS files in OpenIsis.pm, and that
120     is too low for our use).     is too low for our use).
121    
122     Get OpenIsis from:     You can do that yourself, or if you did checkout of our subversion repository
123       you will already have latest OpenIsis in webpac/openisis/ directory.
124    
125       If you want to do it yourself, first get OpenIsis from:
126          http://openisis.org/Doc/GetIt          http://openisis.org/Doc/GetIt
127    
128     Get patch for close from:     Then get patch for close from:
129          http://www.rot13.org/~dpavlin/projects/openisis-0.9.0-perl_close.diff          http://www.rot13.org/~dpavlin/projects/openisis-0.9.0-perl_close.diff
130    
131     Unpack OpenIsis archive and apply patch -p0 to source tree. Type make, and     Unpack OpenIsis archive and apply patch -p0 to source tree.
132     than:  
133       Eater way, now you got OpenIsis 0.9.0 with close support for perl. So,
134       first compile C parts:
135    
136            make
137    
138       And then compile perl module and install it:
139    
140            make perl
141          cd perl          cd perl
         perl Makefile.PL  
         make  
142          sudo make install          sudo make install
143    
144  4. edit global.conf and all2xml.conf to suit your needs. Comments inside     Since you need development tools on target machine to compile OpenIsis,
145       you might want to compile it on another machine and just copy perl module.
146    
147    4. Edit global.conf and all2xml.conf to suit your needs. Comments inside
148     those files should help get you started.     those files should help get you started.
149    
150    5. All perl code will use locale to do sorting. That also include indexes
151       which, while being RDBMS-based, also use perl sorting (because each
152       entry has ordinal number created by perl). So, be sure that LC_COLLATE
153       environment variable is configured for your locale (which also has to
154       be enabled, check dpkg-reconfigure locales if you are using Debian).

Legend:
Removed from v.132  
changed lines
  Added in v.304

  ViewVC Help
Powered by ViewVC 1.1.26