{"id":115,"date":"2011-04-20T19:21:11","date_gmt":"2011-04-20T23:21:11","guid":{"rendered":"http:\/\/galencharlton.com\/blog\/?p=115"},"modified":"2013-03-20T17:03:47","modified_gmt":"2013-03-21T00:03:47","slug":"reading-upgrade-instructions-is-fundamental","status":"publish","type":"post","link":"https:\/\/galencharlton.com\/blog\/2011\/04\/reading-upgrade-instructions-is-fundamental\/","title":{"rendered":"Reading (upgrade instructions) is fundamental!"},"content":{"rendered":"<p>There are lot of good changes coming in Koha 3.4.0, which will be released tomorrow.  Check out the <a href=\"http:\/\/git.koha-community.org\/gitweb\/?p=koha.git;a=blob;f=misc\/release_notes\/release_notes_3_4_0.txt\">current draft of the release notes<\/a>.  But this release of Koha includes some major architectural changes, and although the upgrade process is simple, it definitely pays to read the <a href=\"http:\/\/git.koha-community.org\/gitweb\/?p=koha.git;a=blob;f=INSTALL\">instructions<\/a> first. \u00a0<\/p>\n<p>In particular, there are two upgrade steps that should not be missed:<\/p>\n<h3>Install Template::Toolkit<\/h3>\n<p>Koha 3.4.0 uses the Template::Toolkit Perl module instead of HTML::Template::Pro for the OPAC and staff interface templates. \u00a0Template::Toolkit must be installed before trying to run the web updater, as the web installer itself now uses TT. \u00a0If you run Koha on Debian or Ubuntu, run <code>apt-get install libtemplate-perl<\/code>.  On other Linux and Unix platforms, install the packaged version of TT if available; if a packaged version isn&#8217;t available, run <code>cpan Template.<\/code><\/p>\n<p>Note that if you&#8217;re following the instructions, running <code>.\/koha_perl_deps.pl -u -m<\/code> will catch the TT dependency requirement.  Just don&#8217;t forget to actually install it.<\/p>\n<h3>Run scripts to update your bib records<\/h3>\n<p>Koha 3.4.0 will no longer store copies of the item record data as MARC fields in the bibliographic records.  This resolves a long-standing performance issue where changing an item record (even just to change its status when it is checked out) required that Koha update the bibliographic record as well.  However, this means that during upgrade it is necessary to touch all of the bib records in order to remove the item tags.  To do this, run the following steps:<\/p>\n<pre class=\"crayon:false\">misc\/maintenance\/remove_items_from_biblioitems.pl --run\r\nmisc\/migration_tools\/rebuild_zebra.pl -b -r<\/pre>\n<p>This can take several hours on a large database, so plan accordingly.<\/p>\n<div class=\"sharedaddy sd-sharing-enabled\"><div class=\"robots-nocontent sd-block sd-social sd-social-icon-text sd-sharing\"><h3 class=\"sd-title\">Share this:<\/h3><div class=\"sd-content\"><ul><li class=\"share-twitter\"><a rel=\"nofollow noopener noreferrer\" data-shared=\"sharing-twitter-115\" class=\"share-twitter sd-button share-icon\" href=\"https:\/\/galencharlton.com\/blog\/2011\/04\/reading-upgrade-instructions-is-fundamental\/?share=twitter\" target=\"_blank\" title=\"Click to share on Twitter\"><span>Twitter<\/span><\/a><\/li><li><a href=\"#\" class=\"sharing-anchor sd-button share-more\"><span>More<\/span><\/a><\/li><li class=\"share-end\"><\/li><\/ul><div class=\"sharing-hidden\"><div class=\"inner\" style=\"display: none;\"><ul><li class=\"share-tumblr\"><a rel=\"nofollow noopener noreferrer\" data-shared=\"\" class=\"share-tumblr sd-button share-icon\" href=\"https:\/\/galencharlton.com\/blog\/2011\/04\/reading-upgrade-instructions-is-fundamental\/?share=tumblr\" target=\"_blank\" title=\"Click to share on Tumblr\"><span>Tumblr<\/span><\/a><\/li><li class=\"share-reddit\"><a rel=\"nofollow noopener noreferrer\" data-shared=\"\" class=\"share-reddit sd-button share-icon\" href=\"https:\/\/galencharlton.com\/blog\/2011\/04\/reading-upgrade-instructions-is-fundamental\/?share=reddit\" target=\"_blank\" title=\"Click to share on Reddit\"><span>Reddit<\/span><\/a><\/li><li class=\"share-end\"><\/li><li class=\"share-print\"><a rel=\"nofollow noopener noreferrer\" data-shared=\"\" class=\"share-print sd-button share-icon\" href=\"https:\/\/galencharlton.com\/blog\/2011\/04\/reading-upgrade-instructions-is-fundamental\/\" target=\"_blank\" title=\"Click to print\"><span>Print<\/span><\/a><\/li><li class=\"share-end\"><\/li><\/ul><\/div><\/div><\/div><\/div><\/div>","protected":false},"excerpt":{"rendered":"<p>There are lot of good changes coming in Koha 3.4.0, which will be released tomorrow. Check out the current draft of the release notes. But&#8230;<\/p>\n<div class=\"sharedaddy sd-sharing-enabled\"><div class=\"robots-nocontent sd-block sd-social sd-social-icon-text sd-sharing\"><h3 class=\"sd-title\">Share this:<\/h3><div class=\"sd-content\"><ul><li class=\"share-twitter\"><a rel=\"nofollow noopener noreferrer\" data-shared=\"sharing-twitter-115\" class=\"share-twitter sd-button share-icon\" href=\"https:\/\/galencharlton.com\/blog\/2011\/04\/reading-upgrade-instructions-is-fundamental\/?share=twitter\" target=\"_blank\" title=\"Click to share on Twitter\"><span>Twitter<\/span><\/a><\/li><li><a href=\"#\" class=\"sharing-anchor sd-button share-more\"><span>More<\/span><\/a><\/li><li class=\"share-end\"><\/li><\/ul><div class=\"sharing-hidden\"><div class=\"inner\" style=\"display: none;\"><ul><li class=\"share-tumblr\"><a rel=\"nofollow noopener noreferrer\" data-shared=\"\" class=\"share-tumblr sd-button share-icon\" href=\"https:\/\/galencharlton.com\/blog\/2011\/04\/reading-upgrade-instructions-is-fundamental\/?share=tumblr\" target=\"_blank\" title=\"Click to share on Tumblr\"><span>Tumblr<\/span><\/a><\/li><li class=\"share-reddit\"><a rel=\"nofollow noopener noreferrer\" data-shared=\"\" class=\"share-reddit sd-button share-icon\" href=\"https:\/\/galencharlton.com\/blog\/2011\/04\/reading-upgrade-instructions-is-fundamental\/?share=reddit\" target=\"_blank\" title=\"Click to share on Reddit\"><span>Reddit<\/span><\/a><\/li><li class=\"share-end\"><\/li><li class=\"share-print\"><a rel=\"nofollow noopener noreferrer\" data-shared=\"\" class=\"share-print sd-button share-icon\" href=\"https:\/\/galencharlton.com\/blog\/2011\/04\/reading-upgrade-instructions-is-fundamental\/\" target=\"_blank\" title=\"Click to print\"><span>Print<\/span><\/a><\/li><li class=\"share-end\"><\/li><\/ul><\/div><\/div><\/div><\/div><\/div>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"spay_email":"","jetpack_publicize_message":"","jetpack_is_tweetstorm":false},"categories":[10],"tags":[],"jetpack_featured_media_url":"","jetpack_publicize_connections":[],"jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p3gJ9y-1R","_links":{"self":[{"href":"https:\/\/galencharlton.com\/blog\/wp-json\/wp\/v2\/posts\/115"}],"collection":[{"href":"https:\/\/galencharlton.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/galencharlton.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/galencharlton.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/galencharlton.com\/blog\/wp-json\/wp\/v2\/comments?post=115"}],"version-history":[{"count":6,"href":"https:\/\/galencharlton.com\/blog\/wp-json\/wp\/v2\/posts\/115\/revisions"}],"predecessor-version":[{"id":423,"href":"https:\/\/galencharlton.com\/blog\/wp-json\/wp\/v2\/posts\/115\/revisions\/423"}],"wp:attachment":[{"href":"https:\/\/galencharlton.com\/blog\/wp-json\/wp\/v2\/media?parent=115"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/galencharlton.com\/blog\/wp-json\/wp\/v2\/categories?post=115"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/galencharlton.com\/blog\/wp-json\/wp\/v2\/tags?post=115"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}