Bugzilla – Attachment 57697 Details for
Bug 17626
INSTALL files are outdated
Home
|
New
|
Browse
|
Search
|
[?]
|
Reports
|
Help
|
New Account
|
Log In
[x]
|
Forgot Password
Login:
[x]
[patch]
Bug 17626: Remove existing install instructions and link to the wiki pages instead
Bug-17626-Remove-existing-install-instructions-and.patch (text/plain), 7.17 KB, created by
Nick Clemens (kidclamp)
on 2016-11-22 10:48:00 UTC
(
hide
)
Description:
Bug 17626: Remove existing install instructions and link to the wiki pages instead
Filename:
MIME Type:
Creator:
Nick Clemens (kidclamp)
Created:
2016-11-22 10:48:00 UTC
Size:
7.17 KB
patch
obsolete
>From 3ee257e9220698b74df803f23abddcbe98e52cd9 Mon Sep 17 00:00:00 2001 >From: Jonathan Druart <jonathan.druart@bugs.koha-community.org> >Date: Tue, 15 Nov 2016 08:55:04 +0000 >Subject: [PATCH] Bug 17626: Remove existing install instructions and link to > the wiki pages instead > >Since we are pretty bad to maintain INSTALL files, I'd suggest to point >to the wiki. > >Signed-off-by: Katrin Fischer <katrin.fischer@bsz-bw.de> > >Signed-off-by: Nick Clemens <nick@bywatersolutions.com> >--- > INSTALL | 161 +++------------------------------------------------------------- > 1 file changed, 6 insertions(+), 155 deletions(-) > >diff --git a/INSTALL b/INSTALL >index ffe69ae..0366342 100644 >--- a/INSTALL >+++ b/INSTALL >@@ -1,157 +1,8 @@ >-Koha 3 - the next-generation release of the award-winning Koha open-source >-integrated library system. >+For instructions on how to install Koha on Ubuntu from packages, please >+consult http://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages > >-Koha is the first open-source Integrated Library System. Developed initially in >-New Zealand by Katipo Communications, Ltd and first deployed in January of 2000 >-for the Horowhenua Library Trust, it is currently maintained by a team of >-software providers and library technology staff from around the globe. Learn >-more about the Koha project at http://koha-community.org. >+For instructions on how to install Koha on Debian from packages, please >+consult https://wiki.koha-community.org/wiki/Debian > >-INSTALLATION >-============ >- >-You need to have a server running Perl 5.10 or later, MySQL 5, Zebra >-2.0.22 or greater and a webserver (preferably Apache2) before installing >-Koha. >- >-MySQL 5: Create a database called 'koha,' owned by 'kohaadmin' >-user, with a password set. Note: kohaadmin must have at least the >-following privileges: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, >-ALTER, and LOCK TABLES. >- >-Default installation instructions: >- >-1. perl Makefile.PL >- (you will be prompted to answer a number of questions and you will >- need to install some Perl dependencies) >- WARNING: >- >- 1.1 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.2. Optional foreign language installation: >- If you would like more languages and not only English, >- cd misc/translator >- perl translate install fr-FR # or use your preferred language codes >- >-2. make >-3.(optional) make test >-4. sudo make install >-5. 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) >-6. sudo a2enmod rewrite deflate >-7. sudo a2ensite koha && /etc/init.d/apache2 reload >-8. sudo zebrasrv -f /etc/koha/koha-conf.xml >- (note that you will want to run Zebra in daemon mode for a production >- system) >-9. Browse to http://servername:8080/ and answer the questions >-10. Optionally add a robots.txt file. See README.robots for details >- >-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): >- >-1. perl Makefile.PL INTRANET_CGI_DIR=/www/cgi-bin >- >-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 >- >-UPGRADE >-======= >-If you are running in another language other than english, please >-switch to english before doing the upgrade, the templating system has >-changed and the templates will need to be regenerated. >-Once you have upgraded, please regenerate your templates in your >-chosen languages. >- >-If you are upgrading from a previous installation of Koha 3.x, you can >-use the following: >- >- ./koha_perl_deps.pl -u -m # to identify new Perl dependencies >- >-Install any missing modules >-IMPORTANT: Koha 3.4.0 and greater uses Template::Toolkit, this must be installed >-before the webinstaller can run >- >-On debian/ubuntu >- sudo apt-get install libtemplate-perl >- >-Other Linux/Unix platforms >-Use the packaged version or install from CPAN >- cpan Template >- >- perl Makefile.PL --prev-install-log /path/to/koha-install-log >- make >- make test >- sudo make upgrade >- >-Koha 3.4.x or later no longer stores items in biblio records. >-If you are upgrading from an older version ou will need to do the >-following two steps, they can take a long time (several hours) to >-complete for large databases >- >- misc/maintenance/remove_items_from_biblioitems.pl --run >- misc/migration_tools/rebuild_zebra.pl -b -r >- >-WHAT NEXT? >- >-1. Running the Web Installer allows you to install sample data for libraries, patrons, etc. >- but you may want to install additional data such as bibliographic and authorities. >- >- 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) >- >-2. 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 >- >-3. 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. >- >-4. Schedule regular index updates >- run rebuild_zebra.pl -b -a -z as a regular cron job, check the 'misc/cronjobs/crontab.example' file for usage examples >- >- You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra >- >-5. 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. >- >- >-IF YOU HAVE PROBLEMS >-==================== >- >-IF THIS IS A PRE-RELEASE TREE: please contact developers by email via >-http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel >-or >-http://dir.gmane.org/gmane.education.libraries.koha.devel >- >-IF THIS IS A RELEASED VERSION: please see the support pages at >-http://www.koha-community.org/ >- >-Released versions usually have three-digit numbers, like 3.06.00, >-while other version number styles are usually snapshots or previews. >- >- >-DEVELOPER NOTES >-=============== >- >-For instructions on how to package releases, run perldoc Makefile.PL >+If you are a developer, you should take a look at KohaDevBox >+https://github.com/digibib/kohadevbox >-- >2.1.4
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Diff
View Attachment As Raw
Actions:
View
|
Diff
|
Splinter Review
Attachments on
bug 17626
:
57473
|
57474
|
57666
|
57667
|
57668
|
57696
| 57697 |
57698