Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Moving everything around and ditching kohaversion.pl

  • Loading branch information...
commit 65c19ccb6c1d3af3241f6fc96c9f3008037c3ae2 1 parent 14434da
Clay Fouts ctfliblime authored
Showing with 29 additions and 5,394 deletions.
  1. +1 −5 INSTALL
  2. +0 −459 INSTALL.debian
  3. +0 −317 INSTALL.debian-lenny
  4. +0 −1,264 INSTALL.fedora7
  5. +0 −2,894 INSTALL.opensuse
  6. +0 −410 INSTALL.ubuntu
  7. +0 −12 MANIFEST.SKIP
  8. +28 −33 Makefile.PL
  9. 0  { → cgi}/about.pl
  10. 0  { → cgi}/acqui/acqui-home.pl
  11. 0  { → cgi}/acqui/addorder.pl
  12. 0  { → cgi}/acqui/basket.pl
  13. 0  { → cgi}/acqui/bookfund.pl
  14. 0  { → cgi}/acqui/booksellers.pl
  15. 0  { → cgi}/acqui/currency.pl
  16. 0  { → cgi}/acqui/finishreceive.pl
  17. 0  { → cgi}/acqui/histsearch.pl
  18. 0  { → cgi}/acqui/lateorders.pl
  19. 0  { → cgi}/acqui/neworderbiblio.pl
  20. 0  { → cgi}/acqui/neworderempty.pl
  21. 0  { → cgi}/acqui/newordersuggestion.pl
  22. 0  { → cgi}/acqui/orderreceive.pl
  23. 0  { → cgi}/acqui/parcel.pl
  24. 0  { → cgi}/acqui/parcels.pl
  25. 0  { → cgi}/acqui/spent.pl
  26. 0  { → cgi}/acqui/supplier.pl
  27. 0  { → cgi}/acqui/updatesupplier.pl
  28. 0  { → cgi}/admin/admin-home.pl
  29. 0  { → cgi}/admin/aqbookfund.pl
  30. 0  { → cgi}/admin/aqbudget.pl
  31. 0  { → cgi}/admin/auth_subfields_structure.pl
  32. 0  { → cgi}/admin/auth_tag_structure.pl
  33. 0  { → cgi}/admin/authorised_values.pl
  34. 0  { → cgi}/admin/authtypes.pl
  35. 0  { → cgi}/admin/biblio_framework.pl
  36. 0  { → cgi}/admin/branch_transfer_limits.pl
  37. 0  { → cgi}/admin/branches.pl
  38. 0  { → cgi}/admin/categorie.pl
  39. 0  { → cgi}/admin/checkmarc.pl
  40. 0  { → cgi}/admin/cities.pl
  41. 0  { → cgi}/admin/classsources.pl
  42. 0  { → cgi}/admin/currency.pl
  43. 0  { → cgi}/admin/env_tz_test.pl
  44. 0  { → cgi}/admin/item_circulation_alerts.pl
  45. 0  { → cgi}/admin/itemstatus.pl
  46. 0  { → cgi}/admin/itemtypes.pl
  47. 0  { → cgi}/admin/koha2marclinks.pl
  48. 0  { → cgi}/admin/marc_subfields_structure.pl
  49. 0  { → cgi}/admin/marctagstructure.pl
  50. 0  { → cgi}/admin/matching-rules.pl
  51. 0  { → cgi}/admin/patron-attr-types.pl
  52. 0  { → cgi}/admin/printers.pl
  53. 0  { → cgi}/admin/roadtype.pl
  54. 0  { → cgi}/admin/smart-rules.pl
  55. 0  { → cgi}/admin/stopwords.pl
  56. 0  { → cgi}/admin/systempreferences.pl
  57. 0  { → cgi}/admin/z3950servers.pl
  58. 0  { → cgi}/authorities/auth_finder.pl
  59. 0  { → cgi}/authorities/authorities-home.pl
  60. 0  { → cgi}/authorities/authorities.pl
  61. 0  { → cgi}/authorities/blinddetail-biblio-search.pl
  62. 0  { → cgi}/authorities/detail-biblio-search.pl
  63. 0  { → cgi}/authorities/detail.pl
  64. 0  { → cgi}/catalogue/ISBDdetail.pl
  65. 0  { → cgi}/catalogue/MARCdetail.pl
  66. 0  { → cgi}/catalogue/cardview.pl
  67. 0  { → cgi}/catalogue/detail.pl
  68. 0  { → cgi}/catalogue/detailprint.pl
  69. 0  { → cgi}/catalogue/export.pl
  70. 0  { → cgi}/catalogue/issuehistory.pl
  71. 0  { → cgi}/catalogue/itemholds.pl
  72. 0  { → cgi}/catalogue/labeledMARCdetail.pl
  73. 0  { → cgi}/catalogue/moredetail.pl
  74. 0  { → cgi}/catalogue/search.pl
  75. 0  { → cgi}/catalogue/showmarc.pl
  76. 0  { → cgi}/catalogue/suggest.pl
  77. 0  { → cgi}/catalogue/updateitem.pl
  78. 0  { → cgi}/cataloguing/addbiblio.pl
  79. 0  { → cgi}/cataloguing/addbooks.pl
  80. 0  { → cgi}/cataloguing/additem.pl
  81. 0  { → cgi}/cataloguing/biblios.pl
  82. 0  { → cgi}/cataloguing/check_barcode.pl
  83. 0  { → cgi}/cataloguing/plugin_launcher.pl
  84. 0  { → cgi}/cataloguing/value_builder/barcode.pl
  85. 0  { → cgi}/cataloguing/value_builder/dateaccessioned.pl
  86. 0  { → cgi}/cataloguing/value_builder/labs_theses.pl
  87. 0  { → cgi}/cataloguing/value_builder/macles.pl
  88. 0  { → cgi}/cataloguing/value_builder/marc21_field_003.pl
  89. 0  { → cgi}/cataloguing/value_builder/marc21_field_005.pl
  90. 0  { → cgi}/cataloguing/value_builder/marc21_field_006.pl
  91. 0  { → cgi}/cataloguing/value_builder/marc21_field_007.pl
  92. 0  { → cgi}/cataloguing/value_builder/marc21_field_008.pl
  93. 0  { → cgi}/cataloguing/value_builder/marc21_field_008_authorities.pl
  94. 0  { → cgi}/cataloguing/value_builder/marc21_field_040c.pl
  95. 0  { → cgi}/cataloguing/value_builder/marc21_field_040d.pl
  96. 0  { → cgi}/cataloguing/value_builder/marc21_leader.pl
  97. 0  { → cgi}/cataloguing/value_builder/marc21_leader_authorities.pl
  98. 0  { → cgi}/cataloguing/value_builder/marc21_leader_book.pl
  99. 0  { → cgi}/cataloguing/value_builder/marc21_leader_computerfile.pl
  100. 0  { → cgi}/cataloguing/value_builder/marc21_leader_video.pl
  101. 0  { → cgi}/cataloguing/value_builder/unimarc_field_010.pl
  102. 0  { → cgi}/cataloguing/value_builder/unimarc_field_100.pl
  103. 0  { → cgi}/cataloguing/value_builder/unimarc_field_105.pl
  104. 0  { → cgi}/cataloguing/value_builder/unimarc_field_106.pl
  105. 0  { → cgi}/cataloguing/value_builder/unimarc_field_110.pl
  106. 0  { → cgi}/cataloguing/value_builder/unimarc_field_115a.pl
  107. 0  { → cgi}/cataloguing/value_builder/unimarc_field_115b.pl
  108. 0  { → cgi}/cataloguing/value_builder/unimarc_field_116.pl
  109. 0  { → cgi}/cataloguing/value_builder/unimarc_field_117.pl
  110. 0  { → cgi}/cataloguing/value_builder/unimarc_field_120.pl
  111. 0  { → cgi}/cataloguing/value_builder/unimarc_field_121a.pl
  112. 0  { → cgi}/cataloguing/value_builder/unimarc_field_121b.pl
  113. 0  { → cgi}/cataloguing/value_builder/unimarc_field_122.pl
  114. 0  { → cgi}/cataloguing/value_builder/unimarc_field_123a.pl
  115. 0  { → cgi}/cataloguing/value_builder/unimarc_field_123d.pl
  116. 0  { → cgi}/cataloguing/value_builder/unimarc_field_123e.pl
  117. 0  { → cgi}/cataloguing/value_builder/unimarc_field_123f.pl
  118. 0  { → cgi}/cataloguing/value_builder/unimarc_field_123g.pl
  119. 0  { → cgi}/cataloguing/value_builder/unimarc_field_123i.pl
  120. 0  { → cgi}/cataloguing/value_builder/unimarc_field_123j.pl
  121. 0  { → cgi}/cataloguing/value_builder/unimarc_field_124.pl
  122. 0  { → cgi}/cataloguing/value_builder/unimarc_field_124a.pl
  123. 0  { → cgi}/cataloguing/value_builder/unimarc_field_124b.pl
  124. 0  { → cgi}/cataloguing/value_builder/unimarc_field_124c.pl
  125. 0  { → cgi}/cataloguing/value_builder/unimarc_field_124d.pl
  126. 0  { → cgi}/cataloguing/value_builder/unimarc_field_124e.pl
  127. 0  { → cgi}/cataloguing/value_builder/unimarc_field_124f.pl
  128. 0  { → cgi}/cataloguing/value_builder/unimarc_field_124g.pl
  129. 0  { → cgi}/cataloguing/value_builder/unimarc_field_125.pl
  130. 0  { → cgi}/cataloguing/value_builder/unimarc_field_125a.pl
  131. 0  { → cgi}/cataloguing/value_builder/unimarc_field_125b.pl
  132. 0  { → cgi}/cataloguing/value_builder/unimarc_field_126.pl
  133. 0  { → cgi}/cataloguing/value_builder/unimarc_field_126a.pl
  134. 0  { → cgi}/cataloguing/value_builder/unimarc_field_126b.pl
  135. 0  { → cgi}/cataloguing/value_builder/unimarc_field_127.pl
  136. 0  { → cgi}/cataloguing/value_builder/unimarc_field_128a.pl
  137. 0  { → cgi}/cataloguing/value_builder/unimarc_field_128b.pl
  138. 0  { → cgi}/cataloguing/value_builder/unimarc_field_128c.pl
  139. 0  { → cgi}/cataloguing/value_builder/unimarc_field_130.pl
  140. 0  { → cgi}/cataloguing/value_builder/unimarc_field_135a.pl
  141. 0  { → cgi}/cataloguing/value_builder/unimarc_field_140.pl
  142. 0  { → cgi}/cataloguing/value_builder/unimarc_field_141.pl
  143. 0  { → cgi}/cataloguing/value_builder/unimarc_field_210c.pl
  144. 0  { → cgi}/cataloguing/value_builder/unimarc_field_225a.pl
  145. 0  { → cgi}/cataloguing/value_builder/unimarc_field_4XX.pl
  146. 0  { → cgi}/cataloguing/value_builder/unimarc_field_700-4.pl
  147. 0  { → cgi}/cataloguing/value_builder/unimarc_leader.pl
  148. 0  { → cgi}/cataloguing/z3950_search.pl
  149. 0  { → cgi}/changelanguage.pl
  150. 0  { → cgi}/circ/add_message.pl
  151. 0  { → cgi}/circ/barcode-img.pl
  152. 0  { → cgi}/circ/billing.pl
  153. 0  { → cgi}/circ/bookcount.pl
  154. 0  { → cgi}/circ/branchoverdues.pl
  155. 0  { → cgi}/circ/branchtransfers.pl
  156. 0  { → cgi}/circ/circulation-home.pl
  157. 0  { → cgi}/circ/circulation.pl
  158. 0  { → cgi}/circ/courses.pl
  159. 0  { → cgi}/circ/del_message.pl
  160. 0  { → cgi}/circ/fastcat.pl
  161. 0  { → cgi}/circ/hold-transfer-slip.pl
  162. 0  { → cgi}/circ/overdue.pl
  163. 0  { → cgi}/circ/pendingreserves.pl
  164. 0  { → cgi}/circ/reserveratios.pl
  165. 0  { → cgi}/circ/returns.pl
  166. 0  { → cgi}/circ/selectbranchprinter.pl
  167. 0  { → cgi}/circ/stats.pl
  168. 0  { → cgi}/circ/transferstoreceive.pl
  169. 0  { → cgi}/circ/view_holdsqueue.pl
  170. 0  { → cgi}/circ/waitingreserves.pl
  171. 0  { → cgi}/circ/ypattrodue-attr-search-authvalue.pl
  172. 0  { → cgi}/circ/ysearch.pl
  173. 0  { → cgi}/clubs_services/clubs_services.pl
  174. 0  { → cgi}/clubs_services/clubs_services_enrollments.pl
  175. 0  { → cgi}/clubs_services/edit_archetypes.pl
  176. 0  { → cgi}/clubs_services/edit_clubs_services.pl
  177. 0  { → cgi}/clubs_services/enroll_clubs_services.pl
  178. 0  { → cgi}/edithelp.pl
  179. 0  { → cgi}/errors/400.pl
  180. 0  { → cgi}/errors/401.pl
  181. 0  { → cgi}/errors/402.pl
  182. 0  { → cgi}/errors/403.pl
  183. 0  { → cgi}/errors/404.pl
  184. 0  { → cgi}/errors/500.pl
  185. 0  { → cgi}/help.pl
  186. 0  { → cgi}/labels/label-create-csv.pl
  187. 0  { → cgi}/labels/label-create-pdf.pl
  188. 0  { → cgi}/labels/label-create-xml.pl
  189. 0  { → cgi}/labels/label-edit-batch.pl
  190. 0  { → cgi}/labels/label-edit-layout.pl
  191. 0  { → cgi}/labels/label-edit-profile.pl
  192. 0  { → cgi}/labels/label-edit-template.pl
  193. 0  { → cgi}/labels/label-home.pl
  194. 0  { → cgi}/labels/label-item-search.pl
  195. 0  { → cgi}/labels/label-manage.pl
  196. 0  { → cgi}/labels/label-print.pl
  197. 0  { → cgi}/labels/label-testsplit.pl
  198. 0  { → cgi}/labels/pcard-member-search.pl
  199. 0  { → cgi}/labels/spinelabel-home.pl
  200. 0  { → cgi}/labels/spinelabel-print.pl
  201. 0  { → cgi}/mainpage.pl
  202. 0  { → cgi}/members/boraccount.pl
  203. 0  { → cgi}/members/borrower-basket.pl
  204. 0  { → cgi}/members/borrowers_details.pl
  205. 0  { → cgi}/members/bulkedit.pl
  206. 0  { → cgi}/members/clubs_services.pl
  207. 0  { → cgi}/members/clubs_services_enroll.pl
  208. 0  { → cgi}/members/default_messageprefs.pl
  209. 0  { → cgi}/members/deletemem.pl
  210. 0  { → cgi}/members/guarantor_search.pl
  211. 0  { → cgi}/members/holdhistory.pl
  212. 0  { → cgi}/members/lost_items.pl
  213. 0  { → cgi}/members/mancredit.pl
  214. 0  { → cgi}/members/maninvoice.pl
  215. 0  { → cgi}/members/member-flags.pl
  216. 0  { → cgi}/members/member-password.pl
  217. 0  { → cgi}/members/member-picupload.pl
  218. 0  { → cgi}/members/member.pl
  219. 0  { → cgi}/members/memberentry.pl
  220. 0  { → cgi}/members/membernote.pl
  221. 0  { → cgi}/members/members-home.pl
  222. 0  { → cgi}/members/messaging.pl
  223. 0  { → cgi}/members/mod_member_lists.pl
  224. 0  { → cgi}/members/moremember.pl
  225. 0  { → cgi}/members/patronimage.pl
  226. 0  { → cgi}/members/pay.pl
  227. 0  { → cgi}/members/paycollect.pl
  228. 0  { → cgi}/members/readingrec.pl
  229. 0  { → cgi}/members/refund.pl
  230. 0  { → cgi}/members/restore_cardnumber.pl
  231. 0  { → cgi}/members/setdebar.pl
  232. 0  { → cgi}/members/setstatus.pl
  233. 0  { → cgi}/members/update-child.pl
  234. 0  { → cgi}/offline_circ/process_koc.pl
  235. 0  { → cgi}/opac/changelanguage.pl
  236. 0  { → cgi}/opac/errors/400.pl
  237. 0  { → cgi}/opac/errors/401.pl
  238. 0  { → cgi}/opac/errors/402.pl
  239. 0  { → cgi}/opac/errors/403.pl
  240. 0  { → cgi}/opac/errors/404.pl
  241. 0  { → cgi}/opac/errors/500.pl
  242. 0  { → cgi}/opac/ilsdi.pl
  243. 0  { → cgi}/opac/maintenance.pl
  244. 0  { → cgi}/opac/oai.pl
  245. 0  { → cgi}/opac/opac-ISBDdetail.pl
  246. 0  { → cgi}/opac/opac-MARCdetail.pl
  247. 0  { → cgi}/opac/opac-account.pl
  248. 0  { → cgi}/opac/opac-addbybiblionumber.pl
  249. 0  { → cgi}/opac/opac-alert-subscribe.pl
  250. 0  { → cgi}/opac/opac-authorities-home.pl
  251. 0  { → cgi}/opac/opac-authoritiesdetail.pl
  252. 0  { → cgi}/opac/opac-basket.pl
  253. 0  { → cgi}/opac/opac-browser.pl
  254. 0  { → cgi}/opac/opac-changelanguage.pl
  255. 0  { → cgi}/opac/opac-clubsAndServices-enroll.pl
  256. 0  { → cgi}/opac/opac-clubsAndServices.pl
  257. 0  { → cgi}/opac/opac-coursereserves.pl
  258. 0  { → cgi}/opac/opac-detail.pl
  259. 0  { → cgi}/opac/opac-detailprint.pl
  260. 0  { → cgi}/opac/opac-downloadshelf.pl
  261. 0  { → cgi}/opac/opac-export.pl
  262. 0  { → cgi}/opac/opac-holdhistory.pl
  263. 0  { → cgi}/opac/opac-ics.pl
  264. 0  { → cgi}/opac/opac-logout.pl
  265. 0  { → cgi}/opac/opac-main.pl
  266. 0  { → cgi}/opac/opac-messaging.pl
  267. 0  { → cgi}/opac/opac-moddisplay.pl
  268. 0  { → cgi}/opac/opac-modrequest.pl
  269. 0  { → cgi}/opac/opac-mymessages.pl
  270. 0  { → cgi}/opac/opac-passwd.pl
  271. 0  { → cgi}/opac/opac-readingrecord.pl
  272. 0  { → cgi}/opac/opac-renew.pl
  273. 0  { → cgi}/opac/opac-reserve.pl
  274. 0  { → cgi}/opac/opac-review.pl
  275. 0  { → cgi}/opac/opac-search.pl
  276. 0  { → cgi}/opac/opac-sendbasket.pl
  277. 0  { → cgi}/opac/opac-sendshelf.pl
  278. 0  { → cgi}/opac/opac-serial-issues.pl
  279. 0  { → cgi}/opac/opac-shelves.pl
  280. 0  { → cgi}/opac/opac-showmarc.pl
  281. 0  { → cgi}/opac/opac-showreviews.pl
  282. 0  { → cgi}/opac/opac-suggestions.pl
  283. 0  { → cgi}/opac/opac-tags.pl
  284. 0  { → cgi}/opac/opac-tags_subject.pl
  285. 0  { → cgi}/opac/opac-topissues.pl
  286. 0  { → cgi}/opac/opac-update_reading_history.pl
  287. 0  { → cgi}/opac/opac-user.pl
  288. 0  { → cgi}/opac/opac-userdetails.pl
  289. 0  { → cgi}/opac/opac-userupdate.pl
  290. 0  { → cgi}/opac/rss/DO_NOT_REMOVE
  291. 0  { → cgi}/opac/sco/help.pl
  292. 0  { → cgi}/opac/sco/sco-main.pl
  293. 0  { → cgi}/opac/sco/sco-patron-image.pl
  294. 0  { → cgi}/opac/unapi
  295. 0  { → cgi}/periodicals/acqui-search-result.pl
  296. 0  { → cgi}/periodicals/acqui-search.pl
  297. 0  { → cgi}/periodicals/delete.pl
  298. 0  { → cgi}/periodicals/format_sequence.pl
  299. 0  { → cgi}/periodicals/periodical-bib-search.pl
  300. 0  { → cgi}/periodicals/periodical_serial-edit.pl
Sorry, we could not display the entire diff because too many files (1,463) changed.
6 INSTALL
View
@@ -57,10 +57,6 @@ Default installation instructions:
system)
9. Browse to http://servername:8080/ and answer the questions
-OR if you want to install all dependencies from CPAN and are root, you can
-replace steps 1-3 with "perl install-CPAN.pl" but this is non-standard and
-may not be safe. Nevertheless, it's pretty cool when it works.
-
The defaults will install Koha to places that follow relevant standards,
such as the File Hierarchy Standard. If you want to install Koha to a
different directory like /opt/koha, then replace step 1 with (for example):
@@ -70,7 +66,7 @@ different directory like /opt/koha, then replace step 1 with (for example):
You can change most of the defaults in a similar way, such as DB_HOST.
For full instructions on how to override the default settings, run
-$ perldoc rewrite-config.PL
+$ perldoc installer/rewrite-config.PL
UPGRADE
459 INSTALL.debian
View
@@ -1,459 +0,0 @@
-=============================
-Installation Guide for Installing Koha on Debian Etch with MySQL 5
-=============================
-
-Copyright (C) 2007, 2008 LibLime (http://liblime.com)
-
-Maintainer: Joshua Ferraro (jmf AT liblime DOT com)
-
-Feedback/bug reports: Koha Developer's List:
-http://lists.koha.org/mailman/listinfo/koha-devel
-
-This document last modified: 30 April 2008
-
-Installation Instructions
-=============================
-
-All commands can be performed as a system user with sudo privileges,
-as indicated or by running the command directly as root.
-
-1. Prepare System and Install Dependencies
-
-1.1 Install Debian Etch via Businesscard CD
-
-See http://www.debian.org/releases/etch/debian-installer/
-
-WARNING: use Perl 5.8 (a library Koha depends on,
-MARC::File::XML may not work with Perl 5.10, see:
-http://bugs.koha.org/cgi-bin/bugzilla/show_bug.cgi?id=2309),
-
-1.2 Set up your locale
-
-Your locale should be set to UTF-8, as should Apache2 and MySQL 5.
-This step is VERY IMPORTANT for a UNICODE compliant system. Please
-read over the following document carefully:
-
-http://wiki.koha.org/doku.php?id=encodingscratchpad
-
-IMPORTANT: You _MUST_ follow all the steps outlined there for
- Apache2, MySQL 5, etc. BEFORE you install Koha.
-
-1.3 Set up apt sources for Git, Yaz and Zebra packages
-
-Edit your /etc/apt/sources.list file and add the following:
-
- # Index Data
- deb http://ftp.indexdata.dk/debian etch main
- deb-src http://ftp.indexdata.dk/debian etch main
-
- # Backports
- deb http://www.backports.org/debian etch-backports main contrib non-free
-
-Backports packages are signed with a key you can install as follows:
-
- $ sudo apt-get update
- $ sudo apt-get install debian-backports-keyring
-
-The Index Data packages are signed with a key you can install as follows:
-
- $ wget http://ftp.indexdata.dk/debian/indexdata.asc
- $ sudo apt-key add indexdata.asc
-
-Run the following command to update your system:
-
- $ sudo apt-get update
- $ sudo apt-get -t etch-backports install git-core git-email
- $ sudo apt-get install yaz idzebra-2.0 idzebra-2.0-doc
-
-1.4 Get Koha
-
-1.4.1 Option A: Download Koha via Git (optional)
-
- $ git clone git://git.koha.org/pub/scm/koha.git kohaclone
- $ cd kohaclone
- $ git checkout -b myinstall origin
-
-Note: for more information about Git, please see the Koha Git Usage Guide:
-
- http://wiki.koha.org/doku.php?id=en:development:git_usage
-
-1.4.2 Option B: Download Koha from http://download.koha.org
-
- $ wget http://download.koha.org/koha-3.00.00-beta.tar.gz
- ( Note: use the latest stable version)
-
-1.5 Install additional Debian dependencies
-
-IMPORTANT: You should only use CPAN for Perl dependencies which are NOT
- available from the package maintainer. You have been warned!
-
-Using the debian.packages file included in the Koha source tree,
-run the following:
-
- $ sudo dpkg --set-selections < install_misc/debian.packages
-
-Now start dselect:
-
- $ sudo dselect
-
-Choose [I]nstall and accept packages to be installed (hit return)
-
-(may take a while)
-
-Choose [C]onfigure, [R]emove and [Q]uit until dselect has completed.
-
-1.6 Install Perl dependencies that aren't packaged into Debian Etch
-sources
-
-Run the following command:
-
- $ sudo cpan MARC::Record Class::Accessor MARC::Charset MARC::File::XML \
- Net::Z3950::ZOOM HTML::Template::Pro MARC::Crosswalk::DublinCore \
- PDF::Reuse PDF::Reuse::Barcode Data::ICal GD::Barcode::UPCE \
- XML::RSS Algorithm::CheckDigits::M43_001 Biblio::EndnoteStyle POE \
- Schedule::At DBD::SQLite GD SMS::Send HTTP::OAI IPC::Cmd
-
-
- WARNINGS:
- 1.6.1 A Perl library Koha depends on, MARC::File::XML may not work with Perl
- 5.10, see: http://bugs.koha.org/cgi-bin/bugzilla/show_bug.cgi?id=2309),
-
- 1.6.2 Recent versions of CGI::Session have caused some issues for users;
- as of this release date, we suggest downloading the CGI::Session::Serialize::yaml
- tarball direct from CPAN and install it directly rather than using the cpan command
-
- 1.6.3 There is a known but benign error in the test case for Barcode::Code128,
- which is required by PDF::Reuse::Barcode. If this module is not installed,
- you can do a forced installation of Barcode::Code128.
-
-Note: you may need to run CPAN initialization if you've not run cpan
-before:
-
- /etc/perl/CPAN/Config.pm initialized.
-
- CPAN is the world-wide archive of perl resources. It consists of about
- 100 sites that all replicate the same contents all around the globe.
- Many countries have at least one CPAN site already. The resources
- found on CPAN are easily accessible with the CPAN.pm module. If you
- want to use CPAN.pm, you have to configure it properly.
-
- If you do not want to enter a dialog now, you can answer 'no' to this
- question and I'll try to autoconfigure. (Note: you can revisit this
- dialog anytime later by typing 'o conf init' at the cpan prompt.)
-
- Are you ready for manual configuration? [yes]
-
-When the configuration is completed CPAN will install the Perl modules.
-
-2. Configuration of dependencies
-
-2.1 Update root MySQL password (if dselect didn't do it for you already)
-
- $ sudo mysqladmin password <password>
-
-2.2 Create the Koha database
-
- Create the database and user with associated privileges:
-
- $ mysqladmin -uroot -p<password> create <kohadatabasename>
- $ mysql -uroot -p<password>
-
- Welcome to the MySQL monitor. Commands end with ; or \g.
- Your MySQL connection id is 22
- Server version: 5.0.32-Debian_7etch3-log Debian etch distribution
-
- Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
-
- mysql> grant all on <kohadatabasename>.* to '<kohadatabaseuser>'@'localhost' identified by '<kohadatabaseuserpassword>';
- Query OK, 0 rows affected (0.00 sec)
-
- mysql> flush privileges;
- Query OK, 0 rows affected (0.00 sec)
-
- mysql> quit
-
-2.3 Test your SAX Parser and correct where necessary
-
- You must be sure you're using the XML::LibXML SAX parser, not Expat or PurePerl, both of which have outstanding bugs with pre-composed characters. You can test your SAX parser by running:
-
- $ cd koha
- $ misc/sax_parser_print.pl
-
- You should see something like::
-
- XML::LibXML::SAX::Parser=HASH(0x81fe220)
-
- If you're using PurePerl or Expat, you'll need to edit your
- ini file, typically located at:
-
- /etc/perl/XML/SAX/ParserDetails.ini
-
-2.4 Install DBD::mysql Perl module
-
-In order to handle UTF-8 correctly, Koha requires at least version 4.004
-of the DBD::mysql Perl module. However, Debian Etch has a stable package
-only for version 3.0008, so it is necessary to install the module from CPAN.
-DBD::mysql's test suite needs to use a MySQL 'test' DB which doesn't exist
-anymore. So there are two options to install DBD::mysql:
-
- (1) install without test suite,
- (2) install with test suite requiring a test MySQL DB creation.
-
-2.4.1 Install without test suite
-
-Force install DBD::mysql:
-
- $ sudo cpan
- cpan> force install DBD::mysql
-
-2.4.2 Create test database in order to install DBD::mysql
-
-Because of DBD::mysql's test suite, it is necessary to temporarily create a
-test database and user:
-
- $ mysql -uroot -p<password>
-
- Create the database and user with associated privileges:
-
- Welcome to the MySQL monitor. Commands end with ; or \g.
- Your MySQL connection id is 22
- Server version: 5.0.32-Debian_7etch3-log Debian etch distribution
-
- Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
-
- mysql> create database test;
- Query OK, 1 row affected (0.00 sec)
-
- mysql> grant all on test.* to 'test'@'localhost' identified by 'test';
- Query OK, 0 rows affected (0.00 sec)
- (test database, user, and password can be different if need be)
-
- mysql> flush privileges;
- Query OK, 0 rows affected (0.00 sec)
-
- mysql> quit
-
-Next install DBD::mysql:
-
- $ sudo cpan
-
- cpan> o conf makepl_arg
- (get current value of this CPAN parameter)
-
- cpan> o conf makepl_arg "--testdb=test --testuser=test --testpass=test"
-
- cpan> install DBD::mysql
-
- cpan> o conf makepl_arg ''
-
- OR
-
- cpan> o conf makepl_arg '<old setting>'
-
- (restore this setting so as to not interfere with future CPAN installs).
-
-
-Finally, remove the test database:
-
- $ mysql -uroot -p<password>
-
- mysql> drop database test;
- Query OK, 1 row affected (0.00 sec)
-
- mysql> exit
- Bye
-
-3. Run the Koha installer
-
- $ perl Makefile.PL
- ( answer questions )
- $ make
- $ make test
- $ sudo make install #If doing a -dev install, skip the sudo!
-
-4. Configure and start Apache
- $ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
- (note that the path to koha-httpd.conf may be different depending on your
- installation choices)
-
-Add the following lines to /etc/apache2/ports.conf:
-
- Listen 80
- Listen 8080
-
-(Note: It may be productive to use different DNS entries and NamedVirtualHosts
-directives in Apache to separate the staff and OPAC clients, to eliminate a
-cross-client authentication nuisance, but it will work fine like this.)
-
-Run the following commands:
-
- $ sudo a2enmod rewrite
- $ sudo a2ensite koha
- $ sudo apache2ctl restart
-
-Note: you may still see the usual Apache default site if your VirtualHost
-configuration isn't correct. The command "sudo a2dissite default" may be a
-quick fix, but may have side-effects. See the Apache HTTPD manual section on
-virtual hosts for full instructions.
-
-5. Configure and start Zebra
-
-Note: it's recommended that you daemonize the Zebra process and add it to your
-startup profile. For a non-production test/development installation, running
-Zebra from the command line can be useful. Otherwise you will want zebrasrv
-running when Apache/Koha is.
-
-Note: it's also recommended that you create a Koha system user, which you will
-have specified during the install process. Alternatively, Zebra can be
-configured to run as the root user.
-
-Option 1: run the Zebra processes from the command line:
-
- Zebra Server:
- $ sudo -u ${KOHA_USER} zebrasrv -f /etc/koha/koha-conf.xml
- (note that the path to koha-conf.xml may be different depending on your
- installation choices)
-
- Note: the user you run Zebra as will be the only user with write permission
- on the Zebra index; in development mode, you may wish to use your system
- user.
-
- Zebraqueue Daemon (not recommended -- use rebuild_zebra in crontab instead):
- $ sudo -u ${KOHA_USER} misc/bin/zebraqueue_daemon.pl
-
- Note: if you are running in this mode, you may wish to defer starting the
- zebraqueue until you've run the web installer (see below).
-
-Option 2: run the Zebra processes as daemons, and add to startup process:
-
-Note that references to $SCRIPT_DIR refer to the directory where
-Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
-
- Zebra Server:
- $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
- (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)
- $ sudo update-rc.d koha-zebra-daemon defaults
- ( Note: see man chkconfig(8) on other distros )
-
- $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
-
- Zebraqueue Daemon (not recommended -- use rebuild_zebra in crontab instead):
- $ sudo ln -s ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh /etc/init.d/koha-zebraqueue-daemon
- $ sudo update-rc.d koha-zebraqueue-daemon defaults
- ( Note: see man chkconfig(8) on other distros )
-
- $ sudo ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh start
-
-6. Run the Web Installer, populate the database, initial configuration of settings
-
- Point your browser to http://<servername>:8080/
-
- It should redirect you to the Web Installer where you can continue the setup.
- You can install the sample data for libraries, patrons, etc. via the Web Installer
-
-7. What next?
-
- Once the installer has completed, you can import and index MARC records from the
- command line thusly (Note: you can also use the 'Stage MARC records for import' from
- the Tools area of Koha's Staff Client to import a batch of MARC records):
-
- $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml
- (note: use the correct path to your koha-conf.xml)
-
-7.0 Schedule crontab jobs
- Do you want Koha to:
- send mail?
- automatically index added records?
- generate overdue or advance notices?
- mark items lost after they are long overdue?
- assess fines?
-
- All these and other regularly scheduled background tasks are handled by crontab.
- You need to examine the example crontab file, edit a copy to your liking, and schedule it.
-
- $ crontab -l # just check if you have any other jobs already scheduled
- $ cp ./misc/cronjobs/crontab.example my_crontab
- $ vi my_crontab # select jobs or adjust times.
- $ # If you had already scheduled lines, add them at the bottom.
- $ crontab my_crontab # This overwrites your scheduled jobs with the new ones.
-
- If you want to check to confirm, you can run crontab -l again.
-
-7.1 Import:
- Bibliographic data in MARC21 format
- $ misc/migration-tools/bulkmarcimport.pl -file /path/to/marc.iso2709
- Authority data in MARC21 format
- $ misc/migration-tools/bulkauthimport.pl -file /path/to/auth.iso2709
-
-7.2 Fast Index:
- $ misc/migration-tools/rebuild_zebra.pl -b -w
-
- Once the indexing has completed, you will be able to search for records in your
- system. NOTE: if you don't run the Fast Index utility, and you have the index
- updates scheduled as per 7.3 the indexing process will happen in the background,
- but it will be orders of magnitude slower.
-
-7.3 Schedule regular index updates
- run rebuild_zebra.pl -b -a -z as a regular cron job, check misc/cronjobs/crontab.example
- for usage examples. Do not schedule rebuild_zebra AND run zebraqueue. Pick one or the other.
- See 7.0 above.
-
-7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
- change the <listen> options to listen on a TCP port; then restart the zebra daemon.
-
-UPGRADE
-=======
-If you are upgrading from a previous installation of Koha 3, you can
-use the following:
-
- perl Makefile.PL --prev-install-log /path/to/koha-install-log
- make
- make test
- sudo make upgrade
-
-Uninstall Instructions
-=============================
-1) Stop Services:
- $ sudo a2dissite koha
- $ sudo rm /etc/apache2/sites-available/koha
- $ sudo apache2ctl restart
-
- $ sudo update-rc.d koha-zebra-daemon remove
- $ sudo rm /etc/init.d/koha-zebra-daemon
-
-2) Remove Database and Indexes
-
- # MySQL
- $ mysql -u<kohauser> -p<kohapassword>
- > drop database koha;
-
- # Zebra Indexes
- $ zebraidx -c <prefix>/etc/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init
- $ zebraidx -c <prefix>/etc/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init
-
-3) Remove Koha Install Directories and Configuration Files
- Don't forget about any crontab entries
-
-Tested on the following operating environments
-==============================================
-- Debian Etch 4.0
-
-Installer Bug reports
-=====================
-Please send any installer bug reports to jmf AT liblime DOT com
-
-Other Notes
-=====================
-This file is part of Koha
-
-Koha is free software; you can redistribute it and/or modify it under the
-terms of the GNU General Public License as published by the Free Software
-Foundation; either version 2 of the License, or (at your option) any later
-version.
-
-Koha is distributed in the hope that it will be useful, but WITHOUT ANY
-WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
-A PARTICULAR PURPOSE. See the GNU General Public License for more details.
-You should have received a copy of the GNU General Public License along with
-Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
-Suite 330, Boston, MA 02111-1307 USA
317 INSTALL.debian-lenny
View
@@ -1,317 +0,0 @@
-=============================
-Installation Guide for Installing Koha on Debian Lenny with MySQL 5
-=============================
-
-Feedback/bug reports: Koha Developer's List:
-http://lists.koha.org/mailman/listinfo/koha-devel
-
-This document last modified: 13 March 2009
-
-Installation Instructions
-=============================
-
-All commands can be performed as a system user with sudo privileges,
-as indicated or by running the command directly as root.
-
-1. Prepare System and Install Dependencies
-
-1.1 Install Debian Lenny via Businesscard CD
-
-See http://www.debian.org/releases/lenny/debian-installer/
-
-1.3 Set up Indexdata apt sources for Yaz and Zebra packages
-
-Edit your /etc/apt/sources.list file and add the following:
-
- # Index Data
- deb http://ftp.indexdata.dk/debian lenny main
- deb-src http://ftp.indexdata.dk/debian lenny main
-
-The Index Data packages are signed with a key you can install as follows:
-
- $ wget http://ftp.indexdata.dk/debian/indexdata.asc
- $ sudo apt-key add indexdata.asc
-
-1.4 Get Koha
-
-1.4.1 Option A: Download Koha via Git (optional)
-
- $ sudo apt-get install git-core git-email
- $ git clone git://git.koha.org/pub/scm/koha.git kohaclone
- $ cd kohaclone
- $ git checkout -b myinstall origin
-
-Note: for more information about Git, please see the Koha Git Usage Guide:
-
- http://wiki.koha.org/doku.php?id=en:development:git_usage
-
-1.4.2 Option B: Download Koha from http://download.koha.org
-
-Find the latest Koha stable version on http://download.koha.org
-and get it:
-
- $ wget http://download.koha.org/koha-3.00.01-stable.tar.gz
-
-1.5 Install additional Debian dependencies
-
-IMPORTANT: You should only use CPAN for Perl dependencies which are NOT
- available from the package maintainer. You have been warned!
-
-Using the debian-lenny.packages file included in the Koha source tree,
-run the following:
-
- $ sudo dpkg --set-selections < install_misc/debian-lenny.packages
-
-Now start dselect:
-
- $ sudo apt-get install dselect
- $ sudo dselect
-
-Choose [I]nstall and accept packages to be installed (hit return)
-
-(may take a while)
-
-Choose [C]onfigure, [R]emove and [Q]uit until dselect has completed.
-
-1.6 Install Perl dependencies that aren't packaged into Debian Lenny
-sources
-
-Run the following command:
-
- $ sudo cpan Algorithm::CheckDigits SMS::Send HTTP::OAI
-
-Note: you may need to run CPAN initialization if you've not run cpan
-before:
-
- /etc/perl/CPAN/Config.pm initialized.
-
- CPAN is the world-wide archive of perl resources. It consists of about
- 100 sites that all replicate the same contents all around the globe.
- Many countries have at least one CPAN site already. The resources
- found on CPAN are easily accessible with the CPAN.pm module. If you
- want to use CPAN.pm, you have to configure it properly.
-
- If you do not want to enter a dialog now, you can answer 'no' to this
- question and I'll try to autoconfigure. (Note: you can revisit this
- dialog anytime later by typing 'o conf init' at the cpan prompt.)
-
- Are you ready for manual configuration? [yes]
-
-When the configuration is completed CPAN will install the Perl modules.
-
-2. Configuration of dependencies
-
-2.1 Update root MySQL password (if dselect didn't do it for you already)
-
- $ sudo mysqladmin password <password>
-
-2.2 Create the Koha database
-
- Create the database and user with associated privileges:
-
- $ mysqladmin -uroot -p<password> create <kohadatabasename>
- $ mysql -uroot -p<password>
-
- Welcome to the MySQL monitor. Commands end with ; or \g.
- Your MySQL connection id is 22
- Server version: 5.0.51a-24 (Debian)
-
- Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
-
- mysql> grant all on <kohadatabasename>.* to '<kohadatabaseuser>'@'localhost' identified by '<kohadatabaseuserpassword>';
- Query OK, 0 rows affected (0.00 sec)
-
- mysql> flush privileges;
- Query OK, 0 rows affected (0.00 sec)
-
- mysql> quit
-
-2.3 Test your SAX Parser and correct where necessary
-
-You must be sure you're using the XML::LibXML SAX parser, not Expat or
-PurePerl, both of which have outstanding bugs with pre-composed characters.
-You can test your SAX parser by running:
-
- $ cd koha
- $ misc/sax_parser_print.pl
-
- You should see something like::
-
- XML::LibXML::SAX::Parser=HASH(0x81fe220)
-
- If you're using PurePerl or Expat, you'll need to edit your
- ini file, typically located at:
-
- /etc/perl/XML/SAX/ParserDetails.ini
-
-
-3. Run the Koha installer
-
- $ perl Makefile.PL
- ( answer questions )
- $ make
- $ make test
- $ sudo make install
-
-4. Configure and start Apache
- $ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
- (note that the path to koha-httpd.conf may be different depending on your
- installation choices)
-
-Add the following lines to /etc/apache2/ports.conf:
-
- Listen 80
- Listen 8080
-
-Run the following commands:
-
- $ sudo a2enmod rewrite
- $ sudo a2ensite koha
- $ sudo apache2ctl restart
-
-Note: you may still see the usual Apache default site if your VirtualHost
-configuration isn't correct. The command "sudo a2dissite default" may be a
-quick fix, but may have side-effects. See the Apache HTTPD manual section on
-virtual hosts for full instructions.
-
-5. Configure and start Zebra
-
-Note: it's recommended that you daemonize the Zebra process and add it to your
-startup profile. For a non-production test/development installation, running
-Zebra from the command line can be useful. Pick from the two available options
-below, or roll your own :-)
-
-Note: it's also recommended that you create a Koha system user, which you will
-have specified during the install process. Alternatively, Zebra can be
-configured to run as the root user.
-
-Option 1: run the Zebra processes from the command line:
-
- Zebra Server:
- $ sudo -u ${KOHA_USER} zebrasrv -f /etc/koha/koha-conf.xml
- (note that the path to koha-conf.xml may be different depending on your
- installation choices)
-
- Note: the user you run Zebra as will be the only user with write permission
- on the Zebra index; in development mode, you may wish to use your system
- user.
-
- Zebraqueue Daemon:
- $ sudo -u ${KOHA_USER} misc/bin/zebraqueue_daemon.pl
-
- Note: if you are running in this mode, you may wish to defer starting the
- zebraqueue until you've run the web installer (see below).
-
-Option 2: run the Zebra processes as daemons, and add to startup process:
-
-Note that references to $SCRIPT_DIR refer to the directory where
-Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
-
- Zebra Server:
- $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
- (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)
- $ sudo update-rc.d koha-zebra-daemon defaults
- ( Note: see man chkconfig(8) on other distros )
-
- $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
-
- Zebraqueue Daemon:
- $ sudo ln -s ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh /etc/init.d/koha-zebraqueue-daemon
- $ sudo update-rc.d koha-zebraqueue-daemon defaults
- ( Note: see man chkconfig(8) on other distros )
-
- $ sudo ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh start
-
-6. Run the Web Installer, populate the database, initial configuration of settings
-
- Point your browser to http://<servername>:8080/
-
- It should redirect you to the Web Installer where you can continue the setup.
- You can install the sample data for libraries, patrons, etc. via the Web Installer
-
-7. What next?
-
- Once the installer has completed, you can import and index MARC records from the
- command line thusly (Note: you can also use the 'Stage MARC records for import' from
- the Tools area of Koha's Staff Client to import a batch of MARC records):
-
- $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml
- (note: use the correct path to your koha-conf.xml)
-
-7.1 Import:
- Bibliographic data in MARC21 format
- $ misc/migration-tools/bulkmarcimport.pl -file /path/to/marc.iso2709
- Authority data in MARC21 format
- $ misc/migration-tools/bulkauthimport.pl -file /path/to/auth.iso2709
-
-7.2 Fast Index:
- $ misc/migration-tools/rebuild_zebra.pl -b -w
-
- Once the indexing has completed, you will be able to search for records in your
- system. NOTE: if you don't run the Fast Index utility, and you have the index
- updates scheduled as per 7.3 the indexing process will happen in the background,
- but it will be orders of magnitude slower.
-
-7.3 Schedule regular index updates
- run rebuild_zebra.pl -b -a -z as a regular cron job,
- check misc/cronjobs/crontab.example for usage examples
-
-7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
- change the <listen> options to listen on a TCP port; then restart the zebra daemon.
-
-UPGRADE
-=======
-If you are upgrading from a previous installation of Koha 3, you can
-use the following:
-
- perl Makefile.PL --prev-install-log /path/to/koha-install-log
- make
- make test
- sudo make upgrade
-
-Uninstall Instructions
-=============================
-1) Stop Services:
- $ sudo a2dissite koha
- $ sudo rm /etc/apache2/sites-available/koha
- $ sudo apache2ctl restart
-
- $ sudo update-rc.d koha-zebra-daemon remove
- $ sudo rm /etc/init.d/koha-zebra-daemon
-
-2) Remove Database and Indexes
-
- # MySQL
- $ mysql -u<kohauser> -p<kohapassword>
- > drop database koha;
-
- # Zebra Indexes
- $ zebraidx -c <prefix>/etc/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init
- $ zebraidx -c <prefix>/etc/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init
-
-3) Remove Koha Install Directories and Configuration Files
- Don't forget about any crontab entries
-
-Tested on the following operating environments
-==============================================
-- Debian Lenny 5.0
-
-Installer Bug reports
-=====================
-Please send any installer bug reports to jmf AT liblime DOT com
-
-Other Notes
-=====================
-This file is part of Koha
-
-Koha is free software; you can redistribute it and/or modify it under the
-terms of the GNU General Public License as published by the Free Software
-Foundation; either version 2 of the License, or (at your option) any later
-version.
-
-Koha is distributed in the hope that it will be useful, but WITHOUT ANY
-WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
-A PARTICULAR PURPOSE. See the GNU General Public License for more details.
-You should have received a copy of the GNU General Public License along with
-Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
-Suite 330, Boston, MA 02111-1307 USA
1,264 INSTALL.fedora7
View
@@ -1,1264 +0,0 @@
-=============================
-Installation Guide for Installing Koha on Fedora Core 7
-=============================
-
-Copyright (C) 2008, Department of Computer and Information
-Science, Library of the University Lyon 2, France
-
-Translated by: Google with help from Joshua Ferraro
-(jmf AT liblime DOT com)
-
-Feedback/bug reports: Koha Developer's List:
-http://lists.koha.org/mailman/listinfo/koha-devel
-
-This document last modified: 30 April 2008
-
-Installation Instructions
-=============================
-This document was prepared in order to help you discover (or
-test) Koha (Integrated Library System).
-
-The installation of Linux system described below is a basic,
-it is not designed for a production server (e.g., security,
-load balancing .. are not described).
-
-This document describes the different stages of installing
-the software to version 3.00 koha beta on a Fedora 7 Linux.
-Your mileage may vary with different RedHat distributions.
-
-1. LINUX SYSTEM INSTALLATION
-
-System: Linux Fedora 7 (May 2007) Linux Redhat
-The Linux distribution Fedora 7 is downloadable from the
-Fedora website:
-
-http://fedoraproject.org/
-
-The Fedora website also offers additional content such as
-documentation, FAQ, etc.
-
-Using the entire disk (removal of existing partitions and
-therefore permanent loss of data stored on the disk) is
-the easiest method; This is not the best practice for a
-production system, but is useful for testing purposes.
-
-Check that the computer is able to boot from a CD or DVD,
-perhaps by changing the boot order in the bios.
-
-Place the CD or DVD in the drive and restart the machine.
-
-Settings when installing Linux (French specific, may not apply)
-
-Language: French (French)
-Choice of keyboard: French (Latin9) recognized by default.
-Removal of existing Linux partitions
-Host Name: NomMachine.NomDomaine.fr
-Time zone: Europe/Paris. Click on the map or select from the
-list and check system clock to UTC.
-Informing the root password, which is the administrator account.
-
-The installation of the system will automatically start and may
-take between 15 to 30 minutes to complete.
-
-Click Restart.
-
-Enter the default options.
-For Firewall, check www http server (configuration of the firewall).
-Create a user koha with the password kohakoha (eg)
-The koha is therefore created and the group koha which this user belongs.
-
-Setting the homepage
-Enter root, then the password root.
-
-With Fedora, GNOME is the default environment.
-
-To use KDE default (as we at Lyon 2 have done), close the session,
-having recovered the KDE packages on Add/Remove software. For the
-french interface, go through the package manager and seek, then
-install kde-french.
-
-On the login prompt, go to Options è Select Session and choose KDE. A
-the next connection, the system will ask if you want to use KDE or
-GNOME by default. Also on the login prompt, go to Languages and
-choose the French.
-
-The installation of Linux system is complete.
-
-1.2 Verification of system settings
-
-You must be logged in as administrator of the system (root).
-
--- Make sure the environment is KDE. The taskbar is at the
-bottom of the screen and left of this bar is the menu K.
-
--- Check that the system is in french and click on K.
-
--- Create a few shortcuts in making a drag and drop the following
-items in the taskbar:
-
-Menu K è è Internet Firefox Web Browser
-Menu K è è Terminal System
-Menu K è è Services System Management Services
-
--- Check that the koha and the group koha are created:
-Menu K è è System Users and Groups
-
--- Check that web servers Apache and MySQL are installed.
-Menu K è è Services System Management Services
-
-The lines httpd (demon Apache) and mysqld (demon MySQL) must be
-included in the line of services. You must configure these two
-services so that they are lançés automatically at boot. Check th
-e box to the left of the service, click the Start button at the
-top of the list, if the two services start without any problem,
-validate the change of manager services by clicking on Save or
-File menu è save changes
-
-Close the services manager.
-
-If one or both services are absent, it is necessary to install Apache
-and/or MySQL. To do so, go in the Package Manager, choose and
-select Apache server and/or MySQL. In the case of MySQL, we must
-not forget MySQL-devel (available in packages optional). Finally,
-start the installation.
-
-1.3 Installation of additional software
-
-The software installation Koha requires adding additional programs
-to your system linux based on a standard installation. This list may
-be slightly different depending on the version and support (Live
-CD or DVD).
-
-List of software to add
-Libxml2-devel
-Libxslt-devel
-TCL
-Bzip2-devel
-GCC
-Perl-CPAN
-Perl-ExtUtils-AutoInstall
-Ncftp
-Wget
-Gdbm-devel
-Expat-devel
-Tcp_wrappers-devel
-Libicu (see below)
-git-1.5.3.7-1.fc8 [is not necessary for the installation of koha, but
- useful if one participates in the development of koha.]
-PhPMyAdmin
-Libicu
-Libicu-devel
-
-To add software Linux Fedora, you have two tools
-
-A graphical tool
-Menu K è è System Add/Remove software
-
-Click on the Search tab
-Enter the name of the software in the zone entry and click the
-Search button;
-
-The software that match your search are listed.
-Make sure the check box is checked if the tick and click Apply to
-add software to your system.
-
-A tool mode Terminal YUM
-The YUM documentation is available on the Fedora site
-
-Open a terminal window (K Menu è è Terminal System)
-
-Examples of using YUM:
-Is the web browser Firefox installed?
-Type the command: yum list firefox
-This command will launch the software yum, and asked it to list
-the information on the Firefox.
-Yum visit the various deposits of software for Fedora (fedora,
-updates, etc.). And said that the firefox software is installed
-on this machine (version 2.0.0.3-4.fc7) and there is a
-downloadable version newer ( version 2.0.0.10-2.fc7)
-
-************************************************** ****************
-Screenshot
-[root @ nomduserveur ~] # yum list firefox
-Loading "installonlyn" plugin
-fedora 100% |=========================| 2.1 kB 00:00
-updates 100% |=========================| 2.3 kB 00:00
-Installed Packages
-firefox.i386 2.0.0.3-4.fc7 installed
-Packages Available
-firefox.i386 2.0.0.10-2.fc7 updates
-************************************************** ****************
-
-Updated software firefox by the command yum update firefox.
-YUM inspect the system to check whether it is necessary to update
-other software used by firefox.
-confirm your request y
-
-Installation of new software by the command yum install firefox.
-
-
-Verification
-Check whether these programs are installed using the command rpm
-with option-q followed by the name of the software, possibly separated
-by a space.
-Example:
-rpm-q libxml2-devel libxslt-devel tcl bzip2-devel gcc mysql-devel-perl CPAN perl-ExtUtils-AutoInstall ncftp wget gdbm devel-expat-devel tcp_wrappers-devel
-
-NB: The tool rpm (Redhat Package Manager) allows facilities
-management software under the Linux distribution Fedora.
-
-Special case: the library libicu under Fedora 8
-Under Fedora 8:
-The library libicu, is standard in the distribution Fedora.
-Version 3.8 of this library installed with Fedora 8 is too recent
-and poses a problem when installing software and ZEBRA YAZ, the
-company Indexdata who compiled these two programs with version 3.6
-of the library, it is therefore necessary to remove the libicu 3.8
-library and replace it with version 3.6.
-
-Uninstall the library libicu - 3.8-1.fc8
-
-With the web browser, download the library libicu-3.6-18.fc7.i386.rpm
-(old version, choose the version Fedora 7 for i386) here:
-
- HYPERLINK "http://rpmfind.net/linux/rpm2html/search.php?query=libicutu.so.36" http://rpmfind.net/linux/rpm2html/search.php?query=libicutu.so.36
-
-Download the package rpm
-Open a terminal window, a menu K> System> Terminal
-find the file libicu-3.6-18.fc7.i386.rpm
-Desktop CD
-ls-l
-
-decompress the archive with the command: rpm-ivh libicu-3.6-18.fc7.i386.rpm
-
-Setting 1.4 for the use of unicode
-
-VERY IMPORTANT
-UNICODE must be set up correctly before installing Koha.
-
-1.4.1 The Linux system is it configured to use UNICODE?
-
-For more information:
- HYPERLINK "http://wiki.koha.org/doku.php?id=encodingscratchpad" http://wiki.koha.org/doku.php?id=encodingscratchpad
-
-To check, open a terminal window and type the locale.
-You must obtain:
-LANG = en_GB.UTF-8
-...
-
-1.4.2 The web server Apache 2 is it configured to use UNICODE?
-
-To verify, using a text editor, open the httpd.conf file located
-in /etc/httpd/conf and look if it contains the directive:
-
-AddDefaultCharset UTF-8
-
-1.4.3 The MySQL server is it configured to use UNICODE?
-
-NB: mysqld service must be started.
-In a Terminal window, type the command mysql, then an SQL
-to display variables content server configuration.
-Text of query:
-
-show where variable_name variables like 'char%';
-
-******************************************************************
-Screenshot
-mysql> show where variable_name variables like 'char%';
-+--------------------------+----------------------------+
-| Variable_name | Value |
-+--------------------------+----------------------------+
-| Character_set_client | latin1 |
-| Character_set_connection | latin1 |
-| Character_set_database | latin1 |
-| Character_set_filesystem | Binary |
-| Character_set_results | latin1 |
-| Character_set_server | latin1 |
-| Character_set_system | utf8 |
-| Character_sets_dir | /usr/share/mysql/charsets/ |
-+--------------------------+----------------------------+
-8 rows in set (0.00 sec)
-******************************************************************
-
-Some variables are not properly configured (latin1), so we have to
-change the configuration file server MySQL.
-Leaving the mysql client by the command quit.
-
-Using a text editor, open the file my.cnf located in the directory /
-etc and add these 3 lines in the section [mysqld]:
-
-default-character-set = utf8
-character-set-server = utf8
-skip-character-set-client-handshake
-
-To ensure that this change is taken into account, restart the server
-Mysql using the following command in a terminal window:
-mysqld restart service
-
-Check that changing the parameters was taken into account by reconnecting
-the MySQL server with the command mysql, then typing the query:
-
-show where variable_name variables like 'char%';
-The variables contain well utf8 /
-Quit MySQL by the command quit
-
-******************************************************************
-Screenshot
- MySQL
-Welcome to the MySQL monitor. Commands end with; or \g.
-Your MySQL connection id is 2
-Server version: 5.0.45 Source distribution
-
-Type 'help,' or '\h' for help. Type '\c' to clear the buffer.
-
-mysql> show where variable_name variables like 'char%';
-+--------------------------+----------------------------+
-| Variable_name | Value |
-+--------------------------+----------------------------+
-| Character_set_client | utf8 |
-| Character_set_connection | utf8 |
-| Character_set_database | utf8 |
-| Character_set_filesystem | Binary |
-| Character_set_results | utf8 |
-| Character_set_server | utf8 |
-| Character_set_system | utf8 |
-| Character_sets_dir | /usr/share/mysql/charsets/ |
-+--------------------------+----------------------------+
-8 rows in set (0.00 sec)
-
-MySQL> quit
-Bye
-******************************************************************
-
-Some information for the use of MySQL here: HYPERLINK "http://doc.ubuntu-fr.org/mysql" http://doc.ubuntu-fr.org/mysql
-
-2 INSTALLATION OF ZEBRA SERVER INDEXING
-
-For libraries that must manage several tens of thousands of bib records
-it is recommended that you install the server indexing ZEBRA. Otherwise
-(far fewer records to manage), it is not necessary to install ZEBRA.
-
-The software installation ZEBRA requires prior installation of software
-modules YAZ client and server Z3950.
-
-The installation is as administrator (root).
-
-NB: the creation of files yaz and zebra is only necessary if you use
-the graphical
-
-Website for downloads: HYPERLINK "http://www.indexdata.dk/software/" http://www.indexdata.dk/software/
-
-
-2.1 Installation of the software YAZ
-
-Creating a file needed for the installation of Yaz
-Create files redhat in the directory /usr/src
-SOURCES Create a folder in the directory /usr/src/redhat
-NB: redhat lowercase and uppercase SOURCES.
-
-Installing Yaz by the command:
-rpm-ivh ftp://ftp.indexdata.dk/pub/yaz/redhat/fc6/ *- 3.0.24 *.*. rpm
-Check the final published version and replace -3.0.24 by the number
-of the current version.
-
-Check the installation by the command:
-rpm-q libyaz3 libyaz3-devel yaz yaz-debuginfo yaz-icu-yaz illclient yaz-3.0.24-1.src
-
-
-2.2 Installation of the software ZEBRA
-
-To install packages from the version 2.0.26-1:
-rpm-ivh ftp://ftp.indexdata.dk/pub/zebra/redhat/fc6/ *- 2.0.26-1 .*. rpm
-Check dernère published version and replace -2.0.26-1 by the
-number of the current version.
-
-Check the installation by the command:
-rpm-q libidzebra-2.0-2.0-libidzebra modules idzebra-2.0 idzebra-2.0-debuginfo libidzebra-2.0-devel idzebra-2.0
-
-3 INSTALLATION OF KOHA 3.0
-
-Important Reminder:
-Make sure, BEFORE you install koha, that the system Linux, the MySQL
-server and the Apache server are configured to use the Unicode
-format (cf. 1.4).
-
-
-Download koha here: HYPERLINK "http://download.koha.org/koha-3.00.00-beta2.tar.gz" http://download.koha.org/koha-3.00.00-beta2.tar.gz
-
-3.1 Decompression of the archive koha 3.0
-
-Save the file in the directory /usr/share.
-Opening a window Terminal, and placing himself in the directory /usr/share by the command:
-cd /usr/share
-verify the presence of compressed file koha by the command:
-ls-l * Koha
-Unzip the file with the command tar:
-tar-xvf koha-3.00.00-beta2.tar.gz
-You get a folder koha-3.00.00-beta2, which contains folders and files needed for the installation of software koha.
-
-NB: the installation procedure is described in the text files "INSTALL"
-and "INSTALL debian", the second is more complete.
-
-
-3.2 Protect access to the database server MySQL
-
-Update the password root server MySQL (by default, unprotected access to databases)
-In a Terminal window:
-sudo password mysqladmin Koha
-
-3.3 Creation of a database MySQL test
-
-The basic test is immediately under Fedora. We must remove the existing basic
-test and then create a basic test MySQL provisional, which will be deleted
-after installing koha.
-
-mysql-u root-p
-Enter password: kohakoha (eg)
-
-mysql> drop test database;
-Query OK, 0 rows affected (0.06 sec)
-
-mysql> create database test;
-Query OK, 1 row affected (0.00 sec)
-
-mysql> grant all on test .* to 'test' @ 'localhost' identified by 'test';
-Query OK, 0 rows affected (0.00 sec)
-
-MySQL> flush privileges;
-Query OK, 0 rows affected (0.00 sec)
-
-MySQL> quit
-Bye
-
-
-3.4 Creation of the MySQL database koha
-
-Creation of the database, a user kohaadmin with password and defining its
-privileges.
-
-In a Terminal window:
-mysql-u root-p
-Enter password: type kohakoha (eg a password for root)
-Create Database Koha;
-grant all on koha .* to 'kohaadmin' @ 'localhost' identified by 'kohakoha';
-flush privileges;
-quit;
-
-3.5 Configuration CPAN
-
-The koha software is written in Perl. You have access to deposits modules
-written in perl (CPAN) to download some libraries on your system. The Perl
-language of origin is installed on most Linux distributions, but some modules
-must be installed.
-During the first use of cpan, you must configure.
-
-Open a terminal window and type the command cpan
-
-During the installation of modules, validate the additions of modules when
-necessary. Indicate the continent and the country. Select 3 or 4 CPAN deposits
-in the proposed list.
-
-It is possible to force the installation of a module. In this case, in a
-Terminal window, type:
-
-cpan
-then force install NomDuModule
-then quit
-
-******************************************************************
-Screenshot:
-/usr/lib/perl5/5.8.8/CPAN/Config.pm initialized.
-
-
-CPAN is the world-wide archive of perl resources. It consists of about
-100 sites that all replicate the same contents all around the globe.
-Many countries have at least one CPAN site already. The resources
-found on CPAN are easily accessible with the CPAN.pm module. If you
-want to use CPAN.pm, you have to configure it properly.
-
-If you do not want to enter a dialog now, you can answer 'no' to this
-question and I'll try to autoconfigure. (Note: you can revisit this
-dialog anytime later by typing 'o conf init' at the cpan prompt.)
-
-Are you ready for manual configuration? [yes]
-
-
-The following questions are intended to help you with the
-configuration. The CPAN module needs a directory of its own to cache
-important index files and maybe keep a temporary mirror of CPAN files.
-This may be a site-wide directory or a personal directory.
-
-
-
-First of all, I'd like to create this directory. Where?
-
-CPAN build and cache directory? [/ root/.cpan]
-
-
-If you want, I can keep the source files after a build in the cpan
-Home directory. If you choose so then future builds will take the
-files from there. If you do not want to keep them, answer to the 0
-Next question.
-
-
-
-How big should the disk cache be for keeping the build directories
-with all the intermediate files?
-
-Cache size for build directory (in MB)? [10]
-
-
-By default, each time the CPAN module is started, scanning cache
-is performed to keep the cache size in sync. To prevent from this,
-disable the cache scanning with 'never'.
-
-Perform cache scanning (atstart or never)? [atstart]
-
-
-To considerably speed up the initial CPAN shell startup, it is
-Storable possible to use to create a cache of metadata. If Storable
-is not available, the normal index mechanism will be used.
-
-Cache metadata (yes/no)? [yes]
-
-
-The next option deals with the charset your terminal supports. In
-general CPAN is English speaking territory, thus the charset does not
-matter much, but some of the aliens out there who upload their
-software to CPAN bear names that are outside the ASCII range. If your
-terminal supports UTF-8, you say no to the next question, if it
-supports ISO-8859-1 (also known as LATIN1) then you say yes, and if it
-neither supports nor, your answer does not matter, you will not be
-able to read the names of some authors anyway. If you answer no, names
-will be output in UTF-8.
-Your terminal expects iso-8859-1 (yes/no) [yes]
-
-If you have one of the readline packages (Term: ReadLine: Perl,
-Term: ReadLine: Gnu, possibly others) installed, the interactive CPAN
-Shell will have history support. The next two questions deal with the
-filename of the history file and with its size. If you do not want to
-set this variable, please hit SPACE RETURN to the following question.
-
-File to save your history? [/root/.cpan/histfile]
-Number of lines to save? [100]
-
-
-The CPAN module can detect when a module that which you are trying to
-build depends on prerequisites. If this happens, it can build the
-prerequisites for you automatically ('follow'), ask you for
-confirmation ('ask'), or just ignore them ('ignore'). Please set your
-policy to one of the three values.
-
-Policy on building prerequisites (follow, ask or ignore)? [ask]
-
-
-The CPAN module will need a few external programs to work properly.
-Please correct me, if I guess the wrong path for a program. Do not
-panic if you do not have some of them, just press ENTER for those. To
-disable the use of a download program, you can type a space followed
-by ENTER.
-
-
-Where is your gzip program? [/bin/gzip]
-Where is your tar program? [/bin/tar]
-Where is your unzip program? [/usr/bin/unzip]
-Where is your make program? [/usr/bin/make]
-Where is your links program? [/usr/bin/links]
-Where is your wget program? [/usr/bin/wget]
-Where is your ncftpget program? [/usr/bin/ncftpget]
-Where is your ftp program? [/usr/bin/ftp]
-Where is your gpg program? [/usr/bin/gpg]
-What is your favorite pager program? [/usr/bin/less]
-What is your favorite shell? [/bin/bash]
-
-
-Every Makefile.PL is run by perl in a separate process. Likewise we
-run 'make' and 'make install' in processes. If you have any
-parameters (eg PREFIX, LIB, UNINST or the like) you want to pass
-to the calls, please specify them here.
-
-If you do not understand this question, just press ENTER.
-
-Parameters for the 'perl Makefile.PL' command?
-Typical frequently used settings:
-
- PREFIX = ~/perl non-root users (please see manual for more hints)
-
-
-Every Makefile.PL is run by perl in a separate process. Likewise we
-run 'make' and 'make install' in processes. If you have any
-parameters (eg PREFIX, LIB, UNINST or the like) you want to pass
-to the calls, please specify them here.
-
-If you do not understand this question, just press ENTER.
-
-Parameters for the 'perl Makefile.PL' command?
-Typical frequently used settings:
-
- PREFIX = ~/perl non-root users (please see manual for more hints)
-
-Your choice: []
-Parameters for the 'make' command?
-Typical frequently used setting:
-
- J3 dual-processor system
-
-Your choice: []
-Parameters for the 'make install' command?
-Typical frequently used setting:
-
- UNINST = 1 to always uninstall potentially conflicting files
-
-Your choice: []
-
-
-Sometimes you may wish to leave the processes run by CPAN alone
-without caring about them. As sometimes contains the Makefile.PL
-question you're expected to answer, you can set a timer that will
-kill a 'perl Makefile.PL' process after the specified time in seconds.
-
-If you set this value to 0, these processes will wait forever. This is
-the default and recommended setting.
-
-
-Timeout for inactivity during Makefile.PL? [0]
-
-
-If you're accessing the net via proxies, you can specify them in the
-CPAN configuration or via environment variables. The variable in
-the $ CPAN:: Config takes precedence.
-
-Your ftp_proxy?
-Your http_proxy?
-Your no_proxy?
-You have no/root/.cpan/sources/MIRRORED.BY
- I'm trying to fetch one
-CPAN: LWP:: UserAgent loaded ok
-Fetching with LWP:
- ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY
-Fetching with LWP:
- ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY.gz
-Fetching with Net: FTP:
- ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY
-
-
-Now we need to know where your favorite CPAN sites are located. Push
-a few sites onto the array (just in case the first on the array will not
-work). If you are mirroring CPAN to your local workstation, specify a
-file: URL.
-
-First, pick a nearby continent and country (you can pick several of
-each, separated by spaces, or none if you just want to keep your
-existing selections). Then, you will be presented with a list of URLs
-CPAN of mirrors in the countries you selected, along with previously
-selected URLs. Select some of those URLs, or just keep the old list.
-Finally, you will be prompted for any extra URLs - file:, ftp:, or
-http:-- that host a CPAN mirror.
-
-(1) Africa
-(2) Asia
-(3) Central America
-(4) Europe
-(5) North America
-(6) Oceania
-(7) South America
-Select your continent (or several nearby continents) [] 4
-Sorry! since you do not have any existing picks, you must make a
-Geographic selection.
-
-(1) Austria
-(2) Belgium
-(3) Bosnia and Herzegovina
-(4) Bulgaria
-(5) Croatia
-(6) Czech Republic
-(7) Denmark
-(8) Finland
-(9) France
-(10) Germany
-(11) Greece
-(12) Hungary
-(13) Iceland
-(14) Ireland
-(15) Italy
-(16) Latvia
-15 more items, hit SPACE RETURN to show them
-Select your country (or several nearby countries) [] 9
-Sorry! since you do not have any existing picks, you must make a
-Geographic selection.
-
-(1) ftp://cpan.cict.fr/pub/CPAN/
-(2) ftp://cpan.mirrors.easynet.fr/pub/ftp.cpan.org/
-(3) ftp://distrib-coffee.ipsl.jussieu.fr/pub/mirrors/cpan/
-(4) ftp://ftp.crihan.fr/mirrors/ftp.cpan.org/
-(5) ftp://ftp.erasme.org/pub/CPAN/
-(6) ftp://ftp.inria.fr/pub/CPAN/
-(7) ftp://ftp.oleane.net/pub/CPAN/
-(8) ftp://ftp.pasteur.fr/pub/computing/CPAN/
-(9) ftp://ftp.u-strasbg.fr/CPAN
-(10) ftp://mir1.ovh.net/ftp.cpan.org
-(11) ftp://miroir-francais.fr/pub/cpan/
-(12) http://cpan.ebsd.net/
-(13) http://cpan.enstimac.fr/
-(14) http://cpan.univ-paris.com
-Select URLs as many as you like (by number),
-put them on one line, separated by blanks, e.g. '1 4 5 [] 1 2 4 10
-
-Enter another URL or RETURN to quit: []
-New set of picks:
- ftp://cpan.cict.fr/pub/CPAN/
- ftp://cpan.mirrors.easynet.fr/pub/ftp.cpan.org/
- ftp://ftp.crihan.fr/mirrors/ftp.cpan.org/
- ftp://mir1.ovh.net/ftp.cpan.org
-
-
-commit: wrote /usr/lib/perl5/5.8.8/CPAN/Config.pm
-Terminal does not support AddHistory.
-
-cpan shell - CPAN exploration and modules installation (v1.7602)
-ReadLine support available (try 'install Bundle: CPAN')
-
-cpan> quit
-************************************************** ****************
-
-Type quit to break cpan
-
-
-
-3.6 Installation of additional modules from CPAN
-
-3.6.1 modules installation
-
-Install Command: cpan NomDuModule to install and validate the default
-choice for each question.
-
-List of modules required to koha need to install:
-Class::Accessor
-XML::SAX
-XML::RSS
-XML::LibXML::SAX
-MARC::Record
-MARC::Charset
-MARC::Charset::Constants
-MARC::File::XML
-MARC::Crosswalk::DublinCore
-Net::Z3950::ZOOM
-Net::LDAP::Filter
-HTML::Template::Pro
-Data::ICal
-GD::Barcode::UPCE
-Algorithm::CheckDigits::M43_001
-Biblio::EndnoteStyle
-Schedule::At
-Barcode::Code128
-CGI::Session
-Class::Factory::Util
-Date::ICal
-Date::Manip
-Lingua::Stem
-List::MoreUtils
-PDF::Reuse
-PDF::Reuse::Barcode
-PDF::API2
-PDF::API2::Util
-Text::CSV
-Text::CSV_XS
-XML::Dumper
-XML::LibXSLT
-XML::Simple
-YAML::Syck
-Unix::Syslog
-POE
-Date::Calc
-
-
-3.6.2 Installation of modules - Cases difficult
-
-In some cases, we must force the installation of modules. The two
-modules (and sometimes others) need to force the installation.
-Type the command cpan, then:
-
-force install Mail: Sendmail ======= force install ok For this unit
-should be Ctrl + C, when he attempted to send an e-mail.
-force install Net:: LDAP ======= force install ok
-
-
-
-3.6.3 Installing module access MySQL DBMS
-
-Installation of the connector DBD::mysql for perl
-
-We will have to rebuild this module because koha requires the latest version.
-
-In a window Terminal:
-cpan
-cpan> o conf makepl_arg
- (search parameters for the CPAN)
-
-cpan> o conf makepl_arg "- testdb = test - testuser = test - testpass = test"
-
-cpan> install DBD:: mysql
-
-cpan> o conf makepl_arg''
- (clean to avoid interference with future installations modules).
-
-cpan> quit
-
-
-Destruction of the basis of test MySQL
-
-In a terminal window
-mysql-u root-p
-Enter password: kohakoha
-Database drop test;
-quit
-
-
-3.7 Test SAX Parser
-
-In a Terminal window, go to the installation directory koha.
-CD /usr/share/koha-3.00.00-alpha/misc
-launch the script sax_parser_print.pl
-./sax_parser_print.pl
-which returns: XML::LibXML::SAX = HASH (0x895a3fc)
-
-The file /usr/lib/perl5/site_perl/5.8.8/XML/SAX/ParserDetails.ini should be amended to
-contain the final (save the other lines to comment or delete):
-[XML::LibXML::SAX::Parser]
-Http://xml.org/sax/features/namespaces = 1
-
-
-3.8 Installation of Koha
-
-Opening a window Terminal and placed in the directory koha
-CD /usr/share/koha-3.00.00-alpha
-launch the script Makefile.PL
-perl Makefile.PL
-
-Most options are to be validated by default. The data to information are
-password based koha, format Marc (Marc21 or Unimarc), language indexing
-Zebra (or en). It should be noted that the three ports will be open:
-3306, 9998, 9999.
-
-************************************************** ****************
-Screenshot
-By default, Koha can be installed in one of three ways:
-
-Standard: Install files in conformance with the Filesystem
- Hierarchy Standard (FHS). This is the default mode
- and should be used when installing a production
- Koha system. On Unix systems, root access is
- needed to complete a standard installation.
-
-single: Install files under a single directory. This option
- is useful for installing Koha without root access, eg,
- on a web host that allows CGI scripts and MySQL databases
- but requires the user to keep all files under the user's
- HOME directory.
-
-dev: Create a set of symbolic links and configuration files to
- Koha allow to run directly from the source distribution.
- This mode is useful for developers who want to run
- Koha from a git clone.
-
-Installation mode (dev, single, standard) [standard]
-
-Please specify the directory under which most Koha files
-will be installed.
-
-Note that if you are planning in installing more than
-one instance of Koha, you may want to modify the last
-component of the directory path, which will be used
-as the package name in the FHS layout.
-
-Base installation directory [/usr/share/koha]
-
-Since you are using the 'standard' install
-mode, you should run 'make install' as root.
-However, it is recommended that a non-root
-user (on Unix and Linux platforms) have
-ownership of Koha's files, including the
-Zebra indexes if applicable.
-
-Please specify a user account. This
-user account does not need to exist
-right now, but it needs to exist
-before you run 'make install'. Please
-note that for security reasons, this
-user should not be the same as the user
-account Apache runs under.
-
-User account [koha]
-
-Please specify the group that should own
-Koha's files. As above, this group need
-not exist right now, but should be created
-before you run 'make install'.
-
-Group [koha]
-
-Please specify which database engine you will use
-to store data in Koha. The choices are MySQL and
-PostgreSQL; please note that at the moment
-PostgreSQL support is highly experimental.
-
-DBMS to use (Pg, mysql) [mysql]
-
-Please specify the name or address of your
-database server. Note that the database
-does not have to exist at this point, it
-can be created after running 'make install'
-and before you try using Koha for the first time.
-
-Database server [localhost]
-
-Please specify the port used to connect to the
-DMBS [3306]
-
-Please specify the name of the database to be
-used by Koha [koha]
-
-Please specify the user that owns the database to be
-used by Koha [kohaadmin]
-
-Please specify the password of the user that owns the
-database to be used by Koha [katikoan] kohakoha
-
-Koha can use the Zebra search engine for high-performance
-searching of bibliographic and authority records. If you
-have installed the Zebra software and would like to use it,
-please answer 'yes' to the following question. Otherwise,
-Koha will default to using its internal search engine.
-
-Please note that if you choose *NOT* to install Zebra,
-koha-conf.xml will still contain some references to Zebra
-settings. Those references will be ignored by Koha.
-
-
-Install the Zebra configuration files? (no, yes) [yes]
-
-Since you've chosen to use Zebra with Koha,
-you must specify the primary MARC format of the
-records to be indexed by Zebra.
-
-Koha provides Zebra configuration files for MARC 21
-and UNIMARC.
-
-MARC format for Zebra indexing (marc21, unimarc) [marc21] unimarc
-
-Koha supplies Zebra configuration files tuned for
-searching either English (en) or French (fr) MARC
-records.
-
-
-Primary language for Zebra indexing (en, fr) [en] fr
-
-Please specify Zebra database user [kohauser]
-
-Please specify the Zebra database password [zebrastripes]
-
-Since you've chosen to use Zebra, you can enable the SRU/
-Z39.50 Server if you so choose, but you must specify a
-few configuration options for it.
-
-Please note that if you choose *NOT* to configure SRU,
-koha-conf.xml will still contain some references to SRU
-settings. Those references will be ignored by Koha.
-
-
-Install the SRU configuration files? (no, yes) [yes]
-
-SRU Database host? [localhost]
-
-SRU port for bibliographic data? [9998]
-
-SRU port for authority data? [9999]
-
-
-
-
-Koha will be installed with the following configuration parameters:
-
-DB_HOST localhost
-DB_NAME koha
-DB_PASS koha
-DB_PORT 3306
-DB_TYPE mysql
-DB_USER kohaadmin
-INSTALL_BASE /usr/share/koha
-INSTALL_MODE standard
-INSTALL_SRU yes
-INSTALL_ZEBRA yes
-KOHA_GROUP koha
-KOHA_USER koha
-ZEBRA_LANGUAGE fr
-ZEBRA_MARC_FORMAT unimarc
-ZEBRA_PASS zebrastripes
-ZEBRA_SRU_AUTHORITIES_POR9999
-ZEBRA_SRU_BIBLIOS_PORT 9998
-ZEBRA_SRU_HOST localhost
-ZEBRA_USER kohauser
-
-and in the following directories:
-
-DOC_DIR /usr/share/koha/doc
-INTRANET_CGI_DIR /usr/share/koha/intranet/cgi-bin
-INTRANET_TMPL_DIR /usr/share/koha/intranet/htdocs/intranet-tmpl
-INTRANET_WWW_DIR /usr/share/koha/intranet/htdocs
-KOHA_CONF_DIR /etc/koha
-LOG_DIR /var/log/koha
-MAN_DIR /usr/share/koha/man
-MISC_DIR /usr/share/koha/misc
-OPAC_CGI_DIR /usr/share/koha/opac/cgi-bin
-OPAC_TMPL_DIR /usr/share/koha/opac/htdocs/opac-tmpl
-OPAC_WWW_DIR /usr/share/koha/opac/htdocs
-PERL_MODULE_DIR /usr/share/koha/lib
-SCRIPT_DIR /usr/share/koha/bin
-ZEBRA_CONF_DIR /etc/koha/zebradb
-ZEBRA_DATA_DIR /var/lib/koha/zebradb
-ZEBRA_LOCK_DIR /var/lock/koha/zebradb
-ZEBRA_RUN_DIR /var/run/koha/zebradb
-
-
-To change any configuration setting, please run
-perl Makefile.PL again. To override one of the target
-directories, you can do so on the command line like this:
-
-perl Makefile.PL PERL_MODULE_DIR=/usr/share/perl/5.8
-
-You can also set different default values for parameters
-or override directory locations by using environment variables.
-
-For example:
-
-export DB_USER=my_koha
-perl Makefile.PL
-
-or
-
-DB_USER=my_koha DOC_DIR=/usr/local/info perl Makefile.PL
-
-Checking if your kit is complete...
-Looks good
-Writing Makefile for koha
-************************************************** ****************
-
-Taper la commande make
-
-Taper la commande make test (ne pas tenir compte des erreurs listées)
-
-Taper la commande make install
-
-
-
-4 CONFIGURATION POST INSTALLATION
-
-.1 Saving environment variables
-
-As indicated at the end of the installation (see screen shot), we must add two environment variables:
-
-Entering the two lines below a window in Terminal:
-export KOHA_CONF=/etc/koha/koha-conf.xml
-export PERL5LIB=/usr/share/koha/lib
-
-Seizures of this event, both variables are recorded on a temporary basis. If these variables are definitely enr
-egistrées we must add these two lines in the file. bash_profile or. bashrc users root and koha.
-
-
-4.2 Creation of the database
-The base is not created. It is a bug, we must launch a script to recreate it. In a Terminal window, type:
-mysql -user=kohaadmin -password=kohakoha koha </usr/share/koha-3.00.00-alpha/installer/data/mysql/kohastructure.sql;
-
-Explanation:
-mysql è launches client mysql
--- user = kohaadmin è behalf of the user base
--- password = kohakoha è password for this user
-koha è the name of the database
-<È means setting the result of a script (here, the base koha)
-/usr/share/koha-3.00.00-alpha/installer/data/mysql/kohastructure.sql è address sql script to execute
-Do not forget the sign at the end of the investigation.
-
-To check if the base is well rebuilt: mysql-u-p kohaadmin
-Enter password: kohakoha
-
-
-******************************************************************
-Screenshot
-Welcome to the MySQL monitor. Commands end with; or \g.
-Your MySQL connection id is 51
-Server version: 5.0.45 Source distribution
-
-Type 'help,' or '\h' for help. Type '\c' to clear the buffer.
-
-MySQL> use Koha;
-Reading table information for completion of table and column names
-You can turn off this feature to get a quicker startup with A -
-
-Database changed
-MySQL> show tables;
-+----------------------------+
-| Tables_in_koha |
-+----------------------------+
-| accountlines |
-| accountoffsets |
-| action_logs |
-| alert |
-| aqbasket |
-| aqbookfund |
-| aqbooksellers |
-| aqbudget |
-| aqorderbreakdown |
-| aqorderdelivery |
-| aqorders |
-| auth_header |
-| auth_subfield_structure |
-| auth_tag_structure |
-| auth_types |
-| authorised_values |
-| biblio |
-| biblio_framework |
-| biblioitems |
-| borrowers |
-| branchcategories |
-| branches |
-| branchrelations |
-| branchtransfers |
-| browser |
-| categories |
-| cities |
-| class_sort_rules |
-| class_sources |
-| currency |
-| deletedbiblio |
-| deletedbiblioitems |
-| deletedborrowers |
-| deleteditems |
-| ethnicity |
-| import_batches |
-| import_biblios |
-| import_items |
-| import_record_matches |
-| import_records |
-| issues |
-| issuingrules |
-| items |
-| itemtypes |
-| labels |
-| labels_conf |
-| labels_templates |
-| language_descriptions |
-| language_rfc4646_to_iso639 |
-| language_script_bidi |
-| language_script_mapping |
-| language_subtag_registry |
-| letter |
-| marc_matchers |
-| marc_subfield_structure |
-| marc_tag_structure |
-| matchchecks |
-| matcher_matchpoints |
-| matchpoint_component_norms |
-| matchpoint_components |
-| matchpoints |
-| notifys |
-| nozebra |
-| opac_news |
-| overduerules |
-| printers |
-| repeatable_holidays |
-| reports_dictionary |
-| reserveconstraints |
-| reserves |
-| reviews |
-| roadtype |
-| saved_reports |
-| saved_sql |
-| serial |
-| services_throttle |
-| sessions |
-| special_holidays |
-| statistics |
-| stopwords |
-| subscription |
-| subscriptionhistory |
-| subscriptionroutinglist |
-| suggestions |
-| systempreferences |
-| tags |
-| userflags |
-| virtualshelfcontents |
-| virtualshelves |
-| z3950servers |
-| zebraqueue |
-+----------------------------+
-94 rows in set (0.00 sec)
-
-mysql> quit
-******************************************************************
-
-4.3 Changing the configuration of the Apache server
-
-Create a link koha in the directory /etc/httpd/conf.d/ pointing to the configuration file of koha for apache.
-Open /etc/koha/koha-httpd.conf and paste the contents of this file at the end of /etc/httpd/conf/httpd.conf
-
-Editing httpd.conf located in the directory /etc/httpd/conf, so the Apache web server is reachable on port 8
-0 (standard) and also on port 8080.
-Find string Listen 80 and add a new line below with the string Listen 8080
-Restarting the service httpd. On a Terminal window, type service httpd restart.
-
-Lancer Zebra Server
-zebrasrv east /usr/bin
-with the name zebrasrv-2.0
-go to the directory /usr/bin
-cd /usr/bin
-koha become user by typing the command su:
-su Koha
-zebra start the server by the command:
-./zebrasrv-2.0-f /etc/koha/koha-conf.xml
-
-Starting the daemon Zebraqueue
-zebraqueue_daemon.pl is in /usr/share/koha/bin
-go in /usr/share/koha/bin
-cd /usr/share/koha/bin
-and launch the script zebraqueue_daemon.pl
-. /zebraqueue_daemon.pl
-
-
-4.4 loading data for tests
-
-This step helps to have some input in Koha for testing purposes (table cataloguing default, etc.).
-
-Disable temporarily SElinux
-SE-LINUX blocking access to KOHA.
-Menu K Hotel è è SElinux
-Then turn off Selinux and relaunch the service iptables
-
-Unlocking ports
-It must grant access to ports 3306, 9998 and 9999
-Menu K Hotel è è Firewall and SElinux
-Other ports and click Add button.
-When the 3 ports are added, click Apply, then click the button.
-
-Using the Web installer
-We must move the fr located in /usr/share/koha/intranet/cgi-bin/data/mysql en-US (installer points to the directory
-en-ing and not en).
-
-Connect to Koha: HYPERLINK "http://localhost:8080/" http://localhost:8080 and use the Web installer french (en-US).
-
--- Validate Step 1 (dependencies);
--- Step 2 (settings of the database on two screens);
--- A Phase 3, click on Install the basic settings (screen 1), select the declination Marc (Unimarc_complet in our
-Where Unimarc_lecture_pub; screen 2), select default settings and then click on Import (only settings obligat
-oires are checked by default; screen 3);
--- The screen 4 summarizes what has been imported, while low demand to opt for a configuration Zebra (our choice) or NoZebra;
--- Finally, the screen 5 indicates the end of the installation; then you just have to click Finish.
-
-Complements
-Connect to PhPMyadmin: HYPERLINK "http://localhost/phpmyadmin" http://localhost/phpmyadmin
-Connect to interface professional Koha: HYPERLINK "http://localhost:8080/" http://localhost:8080
-Connect to online catalogue Koha: HYPERLINK "http://localhost:80/" http://localhost:80
-
-Zebra is in /etc/koha
-The files perl Koha professional can be found in /usr/share/koha/intranet/cgi-bin (then a large repertoire by fonctionnal
-ities of SIGB)
-The files perl Koha public are in /usr/share/koha/koha/cgi-bin
2,894 INSTALL.opensuse
View
0 additions, 2,894 deletions not shown
410 INSTALL.ubuntu
View
@@ -1,410 +0,0 @@
-=============================
-Installation Guide for Installing Koha on Ubuntu Jaunty (9.04) with MySQL 5
-=============================
-
-Copyright (C) 2007, 2008 LibLime (http://liblime.com)
-
-Original author: Joshua Ferraro (jmf AT liblime DOT com)
-Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu)
-
-Feedback/bug reports: Koha Developer's List:
-http://lists.koha.org/mailman/listinfo/koha-devel
-
-This document last modified: 22 June 2009
-
-Installation Instructions
-=============================
-
-All commands can be performed as a system user with sudo privileges,
-as indicated or by running the command directly as root.
-
-1. Prepare System and Install Dependencies
-
-1.1 Install Ubuntu Jaunty via CD
-
-See http://www.ubuntu.com/getubuntu/download
-
-1.2 Set up your locale
-
-Your locale should be set to UTF-8, as should Apache2 and MySQL 5.
-This step is VERY IMPORTANT for a UNICODE compliant system. Please
-read over the following document carefully:
-
-http://wiki.koha.org/doku.php?id=encodingscratchpad
-
-You can verify your system locale by typing the following command:
-
- $ locale
-
-IMPORTANT: You _MUST_ follow all the steps outlined there for
- Apache2, MySQL 5, etc. BEFORE you install Koha.
-
-1.3 Install the Yaz and Zebra packages
-
-Run the following command to update your system:
-
- $ sudo apt-get update
- $ sudo apt-get install yaz idzebra-2.0 idzebra-2.0-doc
-
-1.4 Get Koha
-
-1.4.1 Option A: Download Koha via Git (optional)
-
- $ sudo apt-get install git-core git-email
- $ git clone git://git.koha.org/pub/scm/koha.git kohaclone
- $ cd kohaclone
- $ git checkout -b myinstall origin
-
-Note: for more information about Git, please see the Koha Git Usage Guide:
-
- http://wiki.koha.org/doku.php?id=en:development:git_usage
-
-1.4.2 Option B: Download Koha from http://download.koha.org
-
- $ wget http://download.koha.org/koha-3.00.02.tar.gz
- ( Note: use the latest stable version)
-
-1.5 Install additional Ubuntu dependencies
-
-IMPORTANT: You should only use CPAN for Perl dependencies which are NOT
- available from the package maintainer. You have been warned!
-
-Using the ubuntu.packages file included in the Koha source tree,
-run the following:
-
- $ sudo dpkg --set-selections < install_misc/ubuntu.packages
-
-Now start dselect (you may need to 'sudo apt-get install dselect'):
-
- $ sudo dselect
-
-Choose [I]nstall and accept packages to be installed (hit return)
-
-(may take a while)
-
-Choose [C]onfigure, [R]emove and [Q]uit until dselect has completed.
-
-1.6 Install Perl dependencies that aren't packaged into Ubuntu Jaunty
-sources
-
-Run the following command:
-
- $ sudo cpan MARC::Crosswalk::DublinCore GD GD::Barcode::UPCE Email::Date \
- HTML::Scrubber Algorithm::CheckDigits::M43_001 Biblio::EndnoteStyle
-
-Note: you may need to run CPAN initialization if you've not run cpan
-before:
-
- /etc/perl/CPAN/Config.pm initialized.
-
- CPAN is the world-wide archive of perl resources. It consists of about
- 100 sites that all replicate the same contents all around the globe.
- Many countries have at least one CPAN site already. The resources
- found on CPAN are easily accessible with the CPAN.pm module. If you
- want to use CPAN.pm, you have to configure it properly.
-
- If you do not want to enter a dialog now, you can answer 'no' to this
- question and I'll try to autoconfigure. (Note: you can revisit this
- dialog anytime later by typing 'o conf init' at the cpan prompt.)
-
- Are you ready for manual configuration? [yes]
-
-When the configuration is completed CPAN will install the Perl modules.
-
-2. Configuration of dependencies
-
-2.1 Update root MySQL password (if dselect didn't do it for you already)
-
- $ sudo mysqladmin password <password>
-
-2.2 Create the Koha database
-
- Create the database and user with associated privileges:
-
- $ mysqladmin -uroot -p<password> create <kohadatabasename>
- $ mysql -uroot -p<password>
-
- Welcome to the MySQL monitor. Commands end with ; or \g.
- Your MySQL connection id is 22
- Server version: 5.0.32-Debian_7etch3-log Debian etch distribution
-
- Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
-
- mysql> grant all on <kohadatabasename>.* to '<kohadatabaseuser>'@'localhost' identified by '<kohadatabaseuserpassword>';
- Query OK, 0 rows affected (0.00 sec)
-
- mysql> flush privileges;
- Query OK, 0 rows affected (0.00 sec)
-
- mysql> quit
-
-2.3 Test your SAX Parser and correct where necessary
-
- You must be sure you're using the XML::LibXML SAX parser, not Expat or PurePerl, both of which have outstanding bugs with pre-composed characters. You can test your SAX parser by running:
-
- $ cd koha
- $ misc/sax_parser_print.pl
-
- You should see something like::
-
- XML::LibXML::SAX::Parser=HASH(0x81fe220)
-
- If you're using PurePerl or Expat, you'll need to edit your
- ini file, typically located at:
-
- /etc/perl/XML/SAX/ParserDetails.ini
-
-2.4 Install DBD::mysql Perl module
-
-In order to handle UTF-8 correctly, Koha requires at least version 4.004
-of the DBD::mysql Perl module. However, Debian Etch has a stable package
-only for version 3.0008, so it is necessary to install the module from CPAN.
-DBD::mysql's test suite needs to use a MySQL 'test' DB which doesn't exist
-anymore. So there are two options to install DBD::mysql:
-
- (1) install without test suite,
- (2) install with test suite requiring a test MySQL DB creation.
-
-2.4.1 Install without test suite
-
-Force install DBD::mysql:
-
- $ sudo cpan
- cpan> force install DBD::mysql
-
-2.4.2 Create test database in order to install DBD::mysql
-
-Because of DBD::mysql's test suite, it is necessary to temporarily create a
-test database and user:
-
- $ mysql -uroot -p<password>
-
- Create the database and user with associated privileges:
-
- Welcome to the MySQL monitor. Commands end with ; or \g.
- Your MySQL connection id is 22
- Server version: 5.0.32-Debian_7etch3-log Debian etch distribution
-
- Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
-
- mysql> create database test;
- Query OK, 1 row affected (0.00 sec)
-
- mysql> grant all on test.* to 'test'@'localhost' identified by 'test';
- Query OK, 0 rows affected (0.00 sec)
- (test database, user, and password can be different if need be)
-
- mysql> flush privileges;
- Query OK, 0 rows affected (0.00 sec)
-
- mysql> quit
-
-Next install DBD::mysql:
-
- $ sudo cpan
-
- cpan> o conf makepl_arg
- (get current value of this CPAN parameter)
-
- cpan> o conf makepl_arg "--testdb=test --testuser=test --testpass=test"
-
- cpan> install DBD::mysql
-
- cpan> o conf makepl_arg ''
-
- OR
-
- cpan> o conf makepl_arg '<old setting>'
-
- (restore this setting so as to not interfere with future CPAN installs).
-
-
-Finally, remove the test database:
-
- $ mysql -uroot -p<password>
-
- mysql> drop database test;
- Query OK, 1 row affected (0.00 sec)
-
- mysql> exit
- Bye
-
-3. Run the Koha installer
-
- $ perl Makefile.PL
- ( answer questions )
- $ make
- $ make test
- $ sudo make install
-
-4. Configure and start Apache
- $ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
- (note that the path to koha-httpd.conf may be different depending on your
- installation choices)
-
-Add the following lines to /etc/apache2/ports.conf:
-
- Listen 80
- Listen 8080
-
-If not running named virtual hosts (The default koha installation does not use named virtual hosts.), comment out the following line:
-
- NameVirtualHost *:80
-
-Run the following commands:
-
- $ sudo a2enmod rewrite
- $ sudo a2ensite koha
- $ sudo apache2ctl restart
-
-Note: you may still see the usual Apache default site if your VirtualHost
-configuration isn't correct. The command "sudo a2dissite default" may be a
-quick fix, but may have side-effects. See the Apache HTTPD manual section on
-virtual hosts for full instructions.
-
-5. Configure and start Zebra
-
-Note: it's recommended that you daemonize the Zebra process and add it to your
-startup profile. For a non-production test/development installation, running
-Zebra from the command line can be useful. Pick from the two available options
-below, or roll your own :-)
-
-Note: it's also recommended that you create a Koha system user, which you will
-have specified during the install process. Alternatively, Zebra can be
-configured to run as the root user.
-
-To add a user do:
-
- $ sudo adduser koha
-
-
-Option 1: run the Zebra processes from the command line:
-
- Zebra Server:
- $ sudo -u ${KOHA_USER} zebrasrv -f /etc/koha/koha-conf.xml
- (note that the path to koha-conf.xml may be different depending on your
- installation choices)
-
- Note: the user you run Zebra as will be the only user with write permission
- on the Zebra index; in development mode, you may wish to use your system
- user.
-
- Zebraqueue Daemon:
- $ sudo -u ${KOHA_USER} misc/bin/zebraqueue_daemon.pl
-
- Note: if you are running in this mode, you may wish to defer starting the
- zebraqueue until you've run the web installer (see below).
-
-Option 2: run the Zebra processes as daemons, and add to startup process:
-
-Note that references to $SCRIPT_DIR refer to the directory where
-Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
-
- Zebra Server:
- $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
- (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)
- $ sudo update-rc.d koha-zebra-daemon defaults
- ( Note: see man chkconfig(8) on other distros )
-
- $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
-
- Zebraqueue Daemon:
- $ sudo ln -s ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh /etc/init.d/koha-zebraqueue-daemon
- $ sudo update-rc.d koha-zebraqueue-daemon defaults
- ( Note: see man chkconfig(8) on other distros )
-
- $ sudo ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh start
-
-6. Run the Web Installer, populate the database, initial configuration of settings
-
- Point your browser to http://<servername>:8080/
-
- It should redirect you to the Web Installer where you can continue the setup.
- You can install the sample data for libraries, patrons, etc. via the Web Installer
-
-7. What next?
-
- Once the installer has completed, you can import and index MARC records from the
- command line thusly (Note: you can also use the 'Stage MARC records for import' from
- the Tools area of Koha's Staff Client to import a batch of MARC records):
-
- $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml
- (note: use the correct path to your koha-conf.xml)
-
-7.1 Import:
- Bibliographic data in MARC21 format
- $ misc/migration-tools/bulkmarcimport.pl -file /path/to/marc.iso2709
- Authority data in MARC21 format
- $ misc/migration-tools/bulkauthimport.pl -file /path/to/auth.iso2709
-
-7.2 Fast Index:
- $ misc/migration-tools/rebuild_zebra.pl -b -w
-
- Once the indexing has completed, you will be able to search for records in your
- system. NOTE: if you don't run the Fast Index utility, and you have the index
- updates scheduled as per 7.3 the indexing process will happen in the background,
- but it will be orders of magnitude slower.
-
-7.3 Schedule regular index updates
- run rebuild_zebra.pl -b -a -z as a regular cron job, check misc/cronjobs/crontab.example
- for usage examples
-
-7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
- change the <listen> options to listen on a TCP port; then restart the zebra daemon.
-
-UPGRADE
-=======
-If you are upgrading from a previous installation of Koha 3, you can
-use the following:
-
- perl Makefile.PL --prev-install-log /path/to/koha-install-log
- make
- make test
- sudo make upgrade
-
-Uninstall Instructions
-=============================
-1) Stop Services:
- $ sudo a2dissite koha
- $ sudo rm /etc/apache2/sites-available/koha
- $ sudo apache2ctl restart
-
- $ sudo update-rc.d koha-zebra-daemon remove
- $ sudo rm /etc/init.d/koha-zebra-daemon
-
-2) Remove Database and Indexes
-
- # MySQL
- $ mysql -u<kohauser> -p<kohapassword>
- > drop database koha;
-
- # Zebra Indexes
- $ zebraidx -c <prefix>/etc/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init
- $ zebraidx -c <prefix>/etc/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init
-
-3) Remove Koha Install Directories and Configuration Files
- Don't forget about any crontab entries
-
-Tested on the following operating environments
-==============================================
-- Ubuntu Jaunty Jackalope 9.04
-
-Installer Bug reports
-=====================
-Please log any installer bug reports at http://bugs.koha.org
-
-Other Notes
-=====================
-This file is part of Koha
-
-Koha is free software; you can redistribute it and/or modify it under the
-terms of the GNU General Public License as published by the Free Software
-Foundation; either version 2 of the License, or (at your option) any later
-version.
-
-Koha is distributed in the hope that it will be useful, but WITHOUT ANY
-WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
-A PARTICULAR PURPOSE. See the GNU General Public License for more details.
-You should have received a copy of the GNU General Public License along with
-Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
-Suite 330, Boston, MA 02111-1307 USA
12 MANIFEST.SKIP
View
@@ -1,12 +0,0 @@
-Makefile$
-release_notes_2
-release_notes_1
-\bCVS/
-~$
-\.patch$
-\.orig$
-\.old$
-\.bak$
-[ ]
-\.git/
-MANIFEST.bak
61 Makefile.PL
View
@@ -241,10 +241,10 @@ my $target_map = {
'./acqui' => 'INTRANET_CGI_DIR',
'./admin' => 'INTRANET_CGI_DIR',
'./authorities' => 'INTRANET_CGI_DIR',
- './C4' => 'PERL_MODULE_DIR',
- './C4/SIP/t' => 'NONE',
- './C4/SIP/koha_test' => 'NONE',
- './C4/tests' => 'NONE',
+ './lib/C4' => 'PERL_MODULE_DIR',
+ './lib/C4/SIP/t' => 'NONE',
+ './lib/C4/SIP/koha_test' => 'NONE',
+ './lib/C4/tests' => 'NONE',
'./catalogue' => 'INTRANET_CGI_DIR',
'./cataloguing' => 'INTRANET_CGI_DIR',
'./changelanguage.pl' => 'INTRANET_CGI_DIR',
@@ -261,7 +261,6 @@ my $target_map = {
'./errors' => {target => 'INTRANET_CGI_DIR'},
'./koha-tmpl/intranet-tmpl' => {target => 'INTRANET_TMPL_DIR', trimdir => -1},
'./koha-tmpl/opac-tmpl' => {target => 'OPAC_TMPL_DIR', trimdir => -1},
- './kohaversion.pl' => 'INTRANET_CGI_DIR',
'./labels' => 'INTRANET_CGI_DIR',
'./mainpage.pl' => 'INTRANET_CGI_DIR',
'./Makefile.PL' => 'NONE',
@@ -278,22 +277,22 @@ my $target_map = {
'./reports' => 'INTRANET_CGI_DIR',
'./reserve' => 'INTRANET_CGI_DIR',
'./reviews' => 'INTRANET_CGI_DIR',
- './rewrite-config.PL' => 'NONE',
+ './installer/rewrite-config.PL' => 'NONE',
'./reviews' => 'INTRANET_CGI_DIR',
'./serials' => 'INTRANET_CGI_DIR',
- './skel' => 'NONE',
- './skel/var/log/koha' => { target => 'LOG_DIR', trimdir => -1 },
- './skel/var/run/koha/zebradb' => { target => 'ZEBRA_RUN_DIR', trimdir => -1 },
- './skel/var/lock/koha/zebradb/authorities' => { target => 'ZEBRA_LOCK_DIR', trimdir => 6 },
- './skel/var/lib/koha/zebradb/authorities/key' => { target => 'ZEBRA_DATA_DIR', trimdir => 6 },
- './skel/var/lib/koha/zebradb/authorities/register' => { target => 'ZEBRA_DATA_DIR', trimdir => 6 },
- './skel/var/lib/koha/zebradb/authorities/shadow' => { target => 'ZEBRA_DATA_DIR', trimdir => 6 },
- './skel/var/lib/koha/zebradb/authorities/tmp' => { target => 'ZEBRA_DATA_DIR', trimdir => 6 },
- './skel/var/lock/koha/zebradb/biblios' => { target => 'ZEBRA_LOCK_DIR', trimdir => 6 },
- './skel/var/lib/koha/zebradb/biblios/key' => { target => 'ZEBRA_DATA_DIR', trimdir => 6 },
- './skel/var/lib/koha/zebradb/biblios/register' => { target => 'ZEBRA_DATA_DIR', trimdir => 6 },
- './skel/var/lib/koha/zebradb/biblios/shadow' => { target => 'ZEBRA_DATA_DIR', trimdir => 6 },
- './skel/var/lib/koha/zebradb/biblios/tmp' => { target => 'ZEBRA_DATA_DIR', trimdir => 6 },
+ './installer/skel' => 'NONE',
+ './installer/skel/var/log/koha' => { target => 'LOG_DIR', trimdir => -1 },
+ './installer/skel/var/run/koha/zebradb' => { target => 'ZEBRA_RUN_DIR', trimdir => -1 },
+ './installer/skel/var/lock/koha/zebradb/authorities' => { target => 'ZEBRA_LOCK_DIR', trimdir => 7 },
+ './installer/skel/var/lib/koha/zebradb/authorities/key' => { target => 'ZEBRA_DATA_DIR', trimdir => 7 },
+ './installer/skel/var/lib/koha/zebradb/authorities/register' => { target => 'ZEBRA_DATA_DIR', trimdir => 7 },
+ './installer/skel/var/lib/koha/zebradb/authorities/shadow' => { target => 'ZEBRA_DATA_DIR', trimdir => 7 },
+ './installer/skel/var/lib/koha/zebradb/authorities/tmp' => { target => 'ZEBRA_DATA_DIR', trimdir => 7 },
+ './installer/skel/var/lock/koha/zebradb/biblios' => { target => 'ZEBRA_LOCK_DIR', trimdir => 7 },
+ './installer/skel/var/lib/koha/zebradb/biblios/key' => { target => 'ZEBRA_DATA_DIR', trimdir => 7 },
+ './installer/skel/var/lib/koha/zebradb/biblios/register' => { target => 'ZEBRA_DATA_DIR', trimdir => 7 },