X-Git-Url: http://git.rot13.org/?a=blobdiff_plain;f=INSTALL.debian;h=bfb94e269e2352adbf91ca087c565f5e3c9295d8;hb=248747c747c153af44c6ec2dd39626ff99bb31dd;hp=ed2ae75944709f10b7133d28735d7b9641f4ade3;hpb=04c3d859414666cacd7fa6853bbe8f60de971da2;p=koha.git

diff --git a/INSTALL.debian b/INSTALL.debian
index ed2ae75944..bfb94e269e 100644
--- a/INSTALL.debian
+++ b/INSTALL.debian
@@ -110,7 +110,9 @@ 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
+                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
@@ -267,7 +269,7 @@ Finally, remove the test database:
     ( answer questions )
     $ make
     $ make test
-    $ sudo make install
+    $ 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
@@ -277,7 +279,11 @@ Finally, remove the test database:
 Add the following lines to /etc/apache2/ports.conf:
 
     Listen 80
-    Listen 8080
+	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:
 
@@ -294,8 +300,8 @@ virtual hosts for full instructions.
 
 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 :-)
+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
@@ -312,7 +318,7 @@ Option 1: run the Zebra processes from the command line:
     on the Zebra index; in development mode, you may wish to use your system
     user.
 
-    Zebraqueue Daemon:
+    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
@@ -331,7 +337,7 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
     
     $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
 
-    Zebraqueue Daemon:
+    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 )
@@ -354,6 +360,25 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
     $ 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
@@ -370,7 +395,8 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
 
 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
+	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.