6 # This script checks for required updates to the database.
8 # Part of the Koha Library Software www.koha.org
9 # Licensed under the GPL.
12 # - Would also be a good idea to offer to do a backup at this time...
14 # NOTE: If you do something more than once in here, make it table driven.
24 # FIXME - The user might be installing a new database, so can't rely
25 # on /etc/koha.conf anyway.
32 %existingtables, # tables already in database
36 $type, $null, $key, $default, $extra,
37 $prefitem, # preference item in systempreferences table
44 my $dbh = C4::Context->dbh;
45 print "connected to your DB. Checking & modifying it\n" unless $silent;
50 # Tables to add if they don't exist
52 shelfcontents => "( shelfnumber int not null,
53 itemnumber int not null,
55 bookshelf => "( shelfnumber int auto_increment primary key,
56 shelfname char(255))",
57 z3950queue => "( id int auto_increment primary key,
66 identifier char(30))",
67 z3950results => "( id int auto_increment primary key,
77 branchrelations => "( branchcode varchar(4),
78 categorycode varchar(4))",
79 websites => "( websitenumber int(11) NOT NULL auto_increment,
80 biblionumber int(11) NOT NULL default '0',
84 PRIMARY KEY (websitenumber) )",
85 marcrecorddone => "( isbn char(40),
88 controlnumber char(40))",
89 uploadedmarc => "( id int(11) NOT NULL auto_increment PRIMARY KEY,
91 hidden smallint(6) default NULL,
92 name varchar(255) default NULL)",
93 ethnicity => "( code varchar(10) NOT NULL default '',
94 name varchar(255) default NULL,
95 PRIMARY KEY (code) )",
96 sessions => "( sessionID varchar(255) NOT NULL default '',
97 userid varchar(255) default NULL,
98 ip varchar(16) default NULL,
100 PRIMARY KEY (sessionID) )",
101 sessionqueries => "( sessionID varchar(255) NOT NULL default '',
102 userid char(100) NOT NULL default '',
103 ip char(18) NOT NULL default '',
104 url text NOT NULL default '' )",
105 bibliothesaurus => "( id bigint(20) NOT NULL auto_increment,
106 freelib char(255) NOT NULL default '',
107 stdlib char(255) NOT NULL default '',
108 category char(10) NOT NULL default '',
109 level tinyint(4) NOT NULL default '1',
110 hierarchy char(80) NOT NULL default '',
111 father char(80) NOT NULL default '',
113 KEY freelib (freelib),
115 KEY category (category),
116 KEY hierarchy (hierarchy)
119 bibid bigint(20) unsigned NOT NULL auto_increment,
120 biblionumber int(11) NOT NULL default '0',
121 datecreated date NOT NULL default '0000-00-00',
122 datemodified date default NULL,
123 origincode char(20) default NULL,
125 KEY origincode (origincode),
126 KEY biblionumber (biblionumber)
128 marc_blob_subfield => "(
129 blobidlink bigint(20) NOT NULL auto_increment,
130 subfieldvalue longtext NOT NULL,
131 PRIMARY KEY (blobidlink)
133 marc_subfield_structure => "(
134 tagfield char(3) NOT NULL default '',
135 tagsubfield char(1) NOT NULL default '',
136 liblibrarian char(255) NOT NULL default '',
137 libopac char(255) NOT NULL default '',
138 repeatable tinyint(4) NOT NULL default '0',
139 mandatory tinyint(4) NOT NULL default '0',
140 kohafield char(40) default NULL,
141 tab tinyint(1) default NULL,
142 authorised_value char(10) default NULL,
143 thesaurus_category char(10) default NULL,
144 value_builder char(80) default NULL,
145 PRIMARY KEY (tagfield,tagsubfield),
146 KEY kohafield (kohafield),
149 marc_subfield_table => "(
150 subfieldid bigint(20) unsigned NOT NULL auto_increment,
151 bibid bigint(20) unsigned NOT NULL default '0',
152 tag char(3) NOT NULL default '',
153 tagorder tinyint(4) NOT NULL default '1',
154 tag_indicator char(2) NOT NULL default '',
155 subfieldcode char(1) NOT NULL default '',
156 subfieldorder tinyint(4) NOT NULL default '1',
157 subfieldvalue varchar(255) default NULL,
158 valuebloblink bigint(20) default NULL,
159 PRIMARY KEY (subfieldid),
162 KEY tag_indicator (tag_indicator),
163 KEY subfieldorder (subfieldorder),
164 KEY subfieldcode (subfieldcode),
165 KEY subfieldvalue (subfieldvalue),
166 KEY tagorder (tagorder)
168 marc_tag_structure => "(
169 tagfield char(3) NOT NULL default '',
170 liblibrarian char(255) NOT NULL default '',
171 libopac char(255) NOT NULL default '',
172 repeatable tinyint(4) NOT NULL default '0',
173 mandatory tinyint(4) NOT NULL default '0',
174 authorised_value char(10) default NULL,
175 PRIMARY KEY (tagfield)
178 bibid bigint(20) NOT NULL default '0',
179 tag char(3) NOT NULL default '',
180 tagorder tinyint(4) NOT NULL default '1',
181 subfieldid char(1) NOT NULL default '',
182 subfieldorder tinyint(4) NOT NULL default '1',
183 word varchar(255) NOT NULL default '',
184 sndx_word varchar(255) NOT NULL default '',
187 KEY tagorder (tagorder),
188 KEY subfieldid (subfieldid),
189 KEY subfieldorder (subfieldorder),
191 KEY sndx_word (sndx_word)
193 marc_breeding => "( id bigint(20) NOT NULL auto_increment,
194 file varchar(80) NOT NULL default '',
195 isbn varchar(10) NOT NULL default '',
196 title varchar(128) default NULL,
197 author varchar(80) default NULL,
199 encoding varchar(40) default NULL,
204 authorised_values => "(id int(11) NOT NULL auto_increment,
205 category char(10) NOT NULL default '',
206 authorised_value char(80) NOT NULL default '',
211 userflags => "( bit int(11) NOT NULL default '0',
212 flag char(30), flagdesc char(255),
216 authtypecode char(10) not NULL,
217 authtypetext char(255) not NULL,
218 auth_tag_to_report char(3) not NULL,
219 summary text not NULL,
220 PRIMARY KEY (authtypecode)
222 biblio_framework => "(
223 frameworkcode char(4) not NULL,
224 frameworktext char(255) not NULL,
225 PRIMARY KEY (frameworkcode)
227 auth_subfield_structure => "(
228 authtypecode char(10) NOT NULL default '',
229 tagfield char(3) NOT NULL default '',
230 tagsubfield char(1) NOT NULL default '',
231 liblibrarian char(255) NOT NULL default '',
232 libopac char(255) NOT NULL default '',
233 repeatable tinyint(4) NOT NULL default '0',
234 mandatory tinyint(4) NOT NULL default '0',
235 tab tinyint(1) default NULL,
236 authorised_value char(10) default NULL,
237 value_builder char(80) default NULL,
238 seealso char(255) default NULL,
239 PRIMARY KEY (authtypecode,tagfield,tagsubfield),
240 KEY tab (authtypecode,tab)
242 auth_tag_structure => "(
243 authtypecode char(10) NOT NULL default '',
244 tagfield char(3) NOT NULL default '',
245 liblibrarian char(255) NOT NULL default '',
246 libopac char(255) NOT NULL default '',
247 repeatable tinyint(4) NOT NULL default '0',
248 mandatory tinyint(4) NOT NULL default '0',
249 authorised_value char(10) default NULL,
250 PRIMARY KEY (authtypecode,tagfield)
253 authid bigint(20) unsigned NOT NULL auto_increment,
254 authtypecode char(10) NOT NULL default '',
255 datecreated date NOT NULL default '0000-00-00',
256 datemodified date default NULL,
257 origincode char(20) default NULL,
258 PRIMARY KEY (authid),
259 KEY origincode (origincode),
261 auth_subfield_table => "(
262 subfieldid bigint(20) unsigned NOT NULL auto_increment,
263 authid bigint(20) unsigned NOT NULL default '0',
264 tag char(3) NOT NULL default '',
265 tagorder tinyint(4) NOT NULL default '1',
266 tag_indicator char(2) NOT NULL default '',
267 subfieldcode char(1) NOT NULL default '',
268 subfieldorder tinyint(4) NOT NULL default '1',
269 subfieldvalue varchar(255) default NULL,
270 PRIMARY KEY (subfieldid),
273 KEY subfieldcode (subfieldcode),
274 KEY subfieldvalue (subfieldvalue)
277 authid bigint(20) NOT NULL default '0',
278 tagsubfield char(4) NOT NULL default '',
279 tagorder tinyint(4) NOT NULL default '1',
280 subfieldorder tinyint(4) NOT NULL default '1',
281 word varchar(255) NOT NULL default '',
282 sndx_word varchar(255) NOT NULL default '',
284 KEY marc_search (tagsubfield,word),
286 KEY sndx_word (sndx_word)
289 suggestionid int(8) NOT NULL auto_increment,
290 suggestedby int(11) NOT NULL default '0',
291 managedby int(11) default NULL,
292 status varchar(10) NOT NULL default '',
294 author varchar(80) default NULL,
295 title varchar(80) default NULL,
296 copyrightdate smallint(6) default NULL,
297 publishercode varchar(255) default NULL,
298 date timestamp(8) NOT NULL,
299 volumedesc char(255) default NULL,
300 publicationyear smallint(6) default NULL,
301 place char(255) default NULL,
302 isbn char(10) default NULL,
303 mailoverseeing smallint(1) default 0,
304 PRIMARY KEY (suggestionnumber),
305 KEY suggestedby (suggestedby),
306 KEY managedby (managedby)
308 aqbasket => "(basketno int(11) NOT NULL auto_increment,
311 booksellerid varchar(10),
312 authorisedby varchar(10),
313 booksellerinvoicenumber text,
314 PRIMARY KEY (basketno)
318 my %requirefields = (
319 biblio => { 'abstract' => 'text' },
320 deletedbiblio => { 'abstract' => 'text', 'marc' => 'blob' },
321 deleteditems => { 'marc' => 'blob', 'paidfor' => 'text' },
323 'lccn' => 'char(25)',
324 'url' => 'varchar(255)',
327 deletedbiblioitems => {
328 'lccn' => 'char(25)',
329 'url' => 'varchar(255)',
332 branchtransfers => { 'datearrived' => 'datetime' },
333 statistics => { 'borrowernumber' => 'int(11)' },
335 'invoicedisc' => 'float(6,4)',
336 'nocalc' => 'int(11)'
339 'userid' => 'char(30)',
340 'password' => 'char(30)',
341 'flags' => 'int(11)',
342 'textmessaging' => 'varchar(30)',
343 'zipcode' => 'varchar(25)',
344 'homezipcode' => 'varchar(25)',
345 'sort1' => 'char(80)',
346 'sort2' => 'char(80)',
348 aqorders => { 'budgetdate' => 'date',
349 'sort1' => 'char(80)',
350 'sort2' => 'char(80)', },
351 aqbudget => {'aqbudgetid' => 'tinyint(4) auto_increment primary key'},
352 items => {'paidfor' => 'text'},
354 #added so that reference items are not available for reserves...
355 itemtypes => { 'notforloan' => 'smallint(6)' },
356 systempreferences => { 'explanation' => 'char(80)',
357 'type' => 'char(20)',
358 'options' => 'text' },
359 z3950servers => { 'syntax' => 'char(80)' },
360 marc_tag_structure =>{
361 'frameworkcode' => 'char(4) not NULL default \'\''},
362 marc_subfield_structure =>{'seealso' => 'char(255)',
363 'frameworkcode' => 'char(4) not NULL default \'\'',
364 'hidden' => 'tinyint(1)',
365 'isurl' => 'tinyint(1)',
367 bookshelf => {'owner' => 'char(80)',
368 'category' => 'char(1)',
370 marc_biblio => { 'frameworkcode' => 'char(4) not NULL default \'\'' },
373 my %dropable_table = (
374 classification => 'classification',
375 multipart => 'multipart',
376 multivolume => 'multivolume',
377 newitems => 'newitems',
378 procedures => 'procedures',
379 publisher => 'publisher',
380 searchstats => 'searchstats',
381 serialissues => 'serialissues',
384 my %uselessfields = (
385 aqorders => "requisitionedby,authorisedby,booksellerid,
386 deliverydays,followupdays,
387 numberfollowupsallowed,numberfollowupssent,
388 dateprinted,sourced,quantityreceiveddamaged,
389 subscriptionfrom,subscriptionto
392 # the other hash contains other actions that can't be done elsewhere. they are done
393 # either BEFORE of AFTER everything else, depending on "when" entry (default => AFTER)
395 # The tabledata hash contains data that should be in the tables.
396 # The uniquefieldrequired hash entry is used to determine which (if any) fields
397 # must not exist in the table for this row to be inserted. If the
398 # uniquefieldrequired entry is already in the table, the existing data is not
399 # modified, unless the forceupdate hash entry is also set. Fields in the
400 # anonymous "forceupdate" hash will be forced to be updated to the default
401 # values given in the %tabledata hash.
406 uniquefieldrequired => 'bit',
408 flag => 'superlibrarian',
409 flagdesc => 'Access to all librarian functions',
413 uniquefieldrequired => 'bit',
416 flagdesc => 'Circulate books',
420 uniquefieldrequired => 'bit',
423 flagdesc => 'View Catalogue (Librarian Interface)',
427 uniquefieldrequired => 'bit',
429 flag => 'parameters',
430 flagdesc => 'Set Koha system paramters',
434 uniquefieldrequired => 'bit',
437 flagdesc => 'Add or modify borrowers',
441 uniquefieldrequired => 'bit',
443 flag => 'permissions',
444 flagdesc => 'Set user permissions',
448 uniquefieldrequired => 'bit',
450 flag => 'reserveforothers',
451 flagdesc => 'Reserve books for patrons',
455 uniquefieldrequired => 'bit',
458 flagdesc => 'Borrow books',
462 uniquefieldrequired => 'bit',
464 flag => 'reserveforself',
465 flagdesc => 'Reserve books for self',
469 uniquefieldrequired => 'bit',
471 flag => 'editcatalogue',
472 flagdesc => 'Edit Catalogue (Modify bibliographic/holdings data)',
476 uniquefieldrequired => 'bit',
478 flag => 'updatecharges',
479 flagdesc => 'Update borrower charges',
483 systempreferences => [
485 uniquefieldrequired => 'variable',
486 forceupdate => { 'explanation' => 1,
488 variable => 'LibraryName',
489 value => '<i><b>Koha<br/>Free Software ILS<br/><br/></b>Koha : a gift, a contribution<br/> in Maori</i>',
490 explanation => 'Library name as shown on main opac page',
495 uniquefieldrequired => 'variable',
496 forceupdate => { 'explanation' => 1,
498 variable => 'autoMemberNum',
500 explanation => 'Member number is auto-calculated',
505 uniquefieldrequired => 'variable',
506 forceupdate => { 'explanation' => 1,
509 variable => 'acquisitions',
512 'Normal, budget-based acquisitions, or Simple bibliographic-data acquisitions',
514 options => 'simple|normal'
517 uniquefieldrequired => 'variable',
518 forceupdate => { 'explanation' => 1,
521 variable => 'dateformat',
524 'date format (us mm/dd/yyyy, metric dd/mm/yyy, ISO yyyy/mm/dd)',
526 options => 'metric|us|iso'
529 uniquefieldrequired => 'variable',
530 variable => 'template',
531 forceupdate => { 'explanation' => 1,
534 explanation => 'Preference order for intranet interface templates',
538 uniquefieldrequired => 'variable',
539 variable => 'autoBarcode',
540 forceupdate => { 'explanation' => 1,
543 explanation => 'Barcode is auto-calculated',
547 uniquefieldrequired => 'variable',
548 variable => 'insecure',
549 forceupdate => { 'explanation' => 1,
553 'If YES, no auth at all is needed. Be careful if you set this to yes!',
557 uniquefieldrequired => 'variable',
558 variable => 'authoritysep',
559 forceupdate => { 'explanation' => 1,
564 'the separator used in authority/thesaurus. Usually --',
569 uniquefieldrequired => 'variable',
570 variable => 'opaclanguages',
571 forceupdate => { 'explanation' => 1,
574 explanation => 'Set the preferred order for translations. The top language will be tried first.',
578 uniquefieldrequired => 'variable',
579 variable => 'opacthemes',
580 forceupdate => { 'explanation' => 1,
583 explanation => 'Set the preferred order for themes. The top theme will be tried first.',
587 uniquefieldrequired => 'variable',
588 variable => 'timeout',
589 forceupdate => { 'explanation' => 1,
592 explanation => 'Inactivity timeout for cookies authentication (in seconds)',
596 uniquefieldrequired => 'variable',
598 forceupdate => { 'explanation' => 1,
601 explanation => 'Turn on MARC support',
605 uniquefieldrequired => 'variable',
606 variable => 'marcflavour',
607 forceupdate => { 'explanation' => 1,
612 'your MARC flavor (MARC21 or UNIMARC) used for character encoding',
614 options => 'MARC21|UNIMARC'
617 uniquefieldrequired => 'variable',
618 variable => 'checkdigit',
620 forceupdate => { 'explanation' => 1,
623 explanation => 'Validity checks on membership number: none or "Katipo" style checks',
625 options => 'none|katipo'
628 uniquefieldrequired => 'variable',
629 variable => 'maxoutstanding',
630 forceupdate => { 'explanation' => 1,
634 'maximum amount withstanding to be able make reserves ',
638 uniquefieldrequired => 'variable',
639 variable => 'maxreserves',
640 forceupdate => { 'explanation' => 1,
644 'maximum number of reserves a member can make',
649 uniquefieldrequired => 'variable',
650 variable => 'noissuescharge',
651 forceupdate => { 'explanation' => 1,
655 'maximum amount withstanding to be able to check out an item',
660 uniquefieldrequired => 'variable',
661 variable => 'KohaAdminEmailAddress',
662 forceupdate => { 'explanation' => 1,
664 value => 'your.mail@here',
665 explanation => 'the email address where borrowers modifs are sent',
669 uniquefieldrequired => 'variable',
671 forceupdate => { 'explanation' => 1,
674 explanation => 'the gist rate. NOT in %, but in numeric form (0.12 for 12%)',
678 uniquefieldrequired => 'variable',
679 variable => 'ldapserver',
680 forceupdate => { 'explanation' => 1,
683 explanation => 'your ldap server',
687 uniquefieldrequired => 'variable',
688 variable => 'ldapinfos',
689 forceupdate => { 'explanation' => 1,
692 explanation => 'ldap info. The ldap will be used in dn : uid=xxx, <ldapinfos>',
696 uniquefieldrequired => 'variable',
697 variable => 'printcirculationslips',
698 forceupdate => { 'explanation' => 1,
701 explanation => 'if set to 1, print circulation slips. If set to 0, don\'t',
705 uniquefieldrequired => 'variable',
706 variable => 'suggestion',
707 forceupdate => { 'explanation' => 1,
710 explanation => 'if set to 1, suggestions are activated in OPAC',
714 uniquefieldrequired => 'variable',
716 forceupdate => { 'explanation' => 1,
718 value => 'Fill with appropriate value...',
719 explanation => 'ISBD',
723 uniquefieldrequired => 'variable',
724 variable => 'virtualshelves',
725 forceupdate => { 'explanation' => 1,
728 explanation => 'Set virtual shelves management ON or OFF',
735 my %fielddefinitions = (
738 field => 'printername',
747 field => 'bookfundid',
756 field => 'aqbudgetid',
757 type => 'tinyint(4)',
761 extra => 'auto_increment'
771 extra => 'auto_increment'
776 field => 'z3950random',
777 type => 'varchar(40)',
785 type => 'varchar(40)',
799 # Get version of MySQL database engine.
800 my $mysqlversion = `mysqld --version`;
801 $mysqlversion =~ /Ver (\S*) /;
803 if ( $mysqlversion ge '3.23' ) {
804 print "Could convert to MyISAM database tables...\n" unless $silent;
807 #---------------------------------
810 # Collect all tables into a list
811 $sth = $dbh->prepare("show tables");
813 while ( my ($table) = $sth->fetchrow ) {
814 $existingtables{$table} = 1;
818 # Now add any missing tables
819 foreach $table ( keys %requiretables ) {
820 unless ( $existingtables{$table} ) {
821 print "Adding $table table...\n" unless $silent;
822 my $sth = $dbh->prepare("create table $table $requiretables{$table}");
825 print "Error : $sth->errstr \n";
831 # now drop useless tables
832 foreach $table ( keys %dropable_table ) {
833 if ( $existingtables{$table} ) {
834 print "Dropping unused table $table\n" if $debug and not $silent;
835 $dbh->do("drop table $table");
837 print "Error : $dbh->errstr \n";
841 unless ( $existingtables{'z3950servers'} ) {
842 #MJR: added syntax entries to close bug 624
843 print "Adding z3950servers table...\n" unless $silent;
844 my $sti = $dbh->prepare( "create table z3950servers (
857 $sti = $dbh->prepare( "insert into z3950servers
858 values ('z3950.loc.gov',
862 'Library of Congress',
867 unless ( $existingtables{'issuingrules'} ) {
868 $dbh->do("alter table categoryitem rename issuingrules");
869 $dbh->do("ALTER TABLE issuingrules ADD maxissueqty int(4) default NULL");
870 $dbh->do("ALTER TABLE issuingrules ADD issuelength int(4) default NULL");
871 $dbh->do("ALTER TABLE issuingrules ADD branchcode varchar(4) NOT NULL default ''");
872 print "renaming categoryitem\n" unless $silent;
876 #---------------------------------
879 foreach $table ( keys %requirefields ) {
880 print "Check table $table\n" if $debug and not $silent;
881 $sth = $dbh->prepare("show columns from $table");
884 while ( ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
886 $types{$column} = $type;
888 foreach $column ( keys %{ $requirefields{$table} } ) {
889 print " Check column $column [$types{$column}]\n" if $debug and not $silent;
890 if ( !$types{$column} ) {
892 # column doesn't exist
893 print "Adding $column field to $table table...\n" unless $silent;
894 $query = "alter table $table
895 add column $column " . $requirefields{$table}->{$column};
896 print "Execute: $query\n" if $debug;
897 my $sti = $dbh->prepare($query);
900 print "**Error : $sti->errstr \n";
907 foreach $table ( keys %fielddefinitions ) {
908 print "Check table $table\n" if $debug;
909 $sth = $dbh->prepare("show columns from $table");
912 while ( ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
914 $definitions->{$column}->{type} = $type;
915 $definitions->{$column}->{null} = $null;
916 $definitions->{$column}->{key} = $key;
917 $definitions->{$column}->{default} = $default;
918 $definitions->{$column}->{extra} = $extra;
920 my $fieldrow = $fielddefinitions{$table};
921 foreach my $row (@$fieldrow) {
922 my $field = $row->{field};
923 my $type = $row->{type};
924 my $null = $row->{null};
925 my $key = $row->{key};
926 my $default = $row->{default};
927 $default="''" unless $default;
928 my $extra = $row->{extra};
929 my $def = $definitions->{$field};
930 unless ( $type eq $def->{type}
931 && $null eq $def->{null}
932 && $key eq $def->{key}
933 && $default eq $def->{default}
934 && $extra eq $def->{extra} )
940 if ( $key eq 'PRI' ) {
941 $key = 'PRIMARY KEY';
943 unless ( $extra eq 'auto_increment' ) {
946 # if it's a new column use "add", if it's an old one, use "change".
948 if ($definitions->{$field}->{type}) {
949 $action="change $field"
953 # if it's a primary key, drop the previous pk, before altering the table
955 if ($key ne 'PRIMARY KEY') {
956 $sth =$dbh->prepare("alter table $table $action $field $type $null $key $extra default ?");
958 $sth =$dbh->prepare("alter table $table drop primary key, $action $field $type $null $key $extra default ?");
960 $sth->execute($default);
961 print " Alter $field in $table\n" unless $silent;
966 # Get list of columns from borrowers table
969 $sth = $dbh->prepare("show columns from borrowers");
971 while ( my ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
973 $itemtypes{$column} = $type;
974 $nullenabled{$column} = $null;
977 unless ( $itemtypes{'cardnumber'} eq 'varchar(20)' ) {
978 $itemtypes{'cardnumber'} =~ /varchar\((\d+)\)/;
980 if ( $oldlength < 16 ) {
981 print "Setting maximum cardnumber length to 16 (was $oldlength) and marking unique.\n" unless $silent;
984 "alter table borrowers change cardnumber cardnumber varchar(16)");
989 "alter table borrowers drop index cardnumber");
994 "alter table borrowers add unique(cardnumber)");
1000 # Get list of columns from items table
1001 $sth = $dbh->prepare("show columns from items");
1003 while ( my ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
1005 $itemtypes{$column} = $type;
1006 $nullenabled{$column} = $null;
1009 unless ( $itemtypes{'barcode'} eq 'varchar(20)' ) {
1010 $itemtypes{'barcode'} =~ /varchar\((\d+)\)/;
1012 if ( $oldlength < 20 ) {
1013 print "Setting maximum barcode length to 20 (was $oldlength).\n" unless $silent;
1016 "alter table items change barcode barcode varchar(20)");
1021 # dropping unique barcode index & setting barcode to null allowed.
1023 $sth = $dbh->prepare("show index from items");
1025 while ( my ( $table, $non_unique, $key_name, $Seq_in_index, $Column_name, $Collation, $cardinality, $sub_part, $Packed, $comment ) = $sth->fetchrow )
1027 if ($key_name eq 'barcode' && $non_unique eq 0) {
1028 print "dropping BARCODE index to enable empty barcodes\n" unless $silent;
1029 $dbh->do("ALTER TABLE `items` DROP INDEX `barcode`");
1032 $dbh->do("ALTER TABLE `items` CHANGE `barcode` `barcode` VARCHAR( 20 )") unless ($nullenabled{barcode} eq 'YES');
1035 # creating fulltext index in bibliothesaurus if needed
1037 $sth = $dbh->prepare("show index from bibliothesaurus");
1040 while ( my ( $table, $non_unique, $key_name, $Seq_in_index, $Column_name, $Collation, $cardinality, $sub_part, $Packed, $comment ) = $sth->fetchrow )
1042 if ($key_name eq 'category_2') {
1046 print "Creating fulltext index on bibliothesaurus\n" unless $exists or $silent;
1047 $dbh->do('create fulltext index category_2 on bibliothesaurus (category,freelib)') unless $exists;
1050 # creating index in z3950results if needed
1052 $sth = $dbh->prepare("show index from z3950results");
1055 while ( my ( $table, $non_unique, $key_name, $Seq_in_index, $Column_name, $Collation, $cardinality, $sub_part, $Packed, $comment ) = $sth->fetchrow )
1057 if ($key_name eq 'query_server') {
1061 print "Creating index on z3950results\n" unless $exists or $silent;
1062 $dbh->do('create unique index query_server on z3950results (queryid,server)') unless $exists;
1064 # changing z3950daemon field to NULL in marc_breeding
1065 $dbh->do("ALTER TABLE `marc_breeding` CHANGE `z3950random` `z3950random` VARCHAR( 40 )");
1067 # making borrowernumber an auto_increment field
1068 $dbh->do("ALTER TABLE `borrowers` CHANGE `borrowernumber` `borrowernumber` INTEGER auto_increment");
1070 # changing indexes in marc_*_structure to use frameworkcode
1071 $dbh->do('alter table marc_subfield_structure drop index tab');
1072 $dbh->do('create index tab on marc_subfield_structure (frameworkcode,tab)');
1073 $dbh->do('alter table marc_subfield_structure drop index kohafield');
1074 $dbh->do('create index kohafield on marc_subfield_structure (frameworkcode,kohafield)');
1077 # extending the timestamp in branchtransfers...
1078 my %branchtransfers;
1080 $sth = $dbh->prepare("show columns from branchtransfers");
1082 while ( my ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
1084 $branchtransfers{$column} = $type;
1087 unless ( $branchtransfers{'datesent'} eq 'datetime' ) {
1088 print "Setting type of datesent in branchtransfers to datetime.\n" unless $silent;
1091 "alter table branchtransfers change datesent datesent datetime");
1095 unless ( $branchtransfers{'datearrived'} eq 'datetime' ) {
1096 print "Setting type of datearrived in branchtransfers to datetime.\n" unless $silent;
1099 "alter table branchtransfers change datearrived datearrived datetime");
1103 # changing the branchcategories table around...
1104 my %branchcategories;
1106 $sth = $dbh->prepare("show columns from branchcategories");
1108 while ( my ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
1110 $branchcategories{$column} = $type;
1113 unless ( $branchcategories{'categorycode'} eq 'varchar(4)' ) {
1115 "Setting type of categorycode in branchcategories to varchar(4),\n and making the primary key.\n" unless $silent;
1118 "alter table branchcategories change categorycode categorycode varchar(4) not null"
1123 "alter table branchcategories add primary key (categorycode)");
1127 unless ( $branchcategories{'categoryname'} eq 'text' ) {
1128 print "Changing branchcode in branchcategories to categoryname text.\n" unless $silent;
1131 "alter table branchcategories change branchcode categoryname text");
1135 unless ( $branchcategories{'codedescription'} eq 'text' ) {
1137 "Replacing branchholding in branchcategories with codedescription text.\n" unless $silent;
1140 "alter table branchcategories change branchholding codedescription text"
1145 # changing the items table around...
1148 $sth = $dbh->prepare("show columns from items");
1150 while ( my ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
1152 $items{$column} = $type;
1155 if ($items{'bulk'} eq "varchar(30)") {
1156 print " Setting callnumber in items table\n" unless $silent;
1158 $dbh->prepare("ALTER TABLE `items` CHANGE `bulk` `itemcallnumber` VARCHAR( 30 ) DEFAULT NULL");
1160 $sti = $dbh->prepare("update marc_subfield_structure set kohafield=\"items.itemcallnumber\" where kohafield=\"items.bulk\"");
1164 # changing the marc_subfield_structure table around...
1165 my %marc_subfield_structure;
1167 $sth = $dbh->prepare("show columns from marc_subfield_structure");
1169 while ( my ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
1171 $marc_subfield_structure{$column} = $type;
1174 if ($marc_subfield_structure{thesaurus_category}) {
1175 print " changing thesaurus_category in marc_subfield_structure table\n" unless $silent;
1177 $dbh->prepare("ALTER TABLE marc_subfield_structure CHANGE `thesaurus_category` `authtypecode` VARCHAR(10 ) DEFAULT NULL");
1182 # creating index in issuingrules if needed
1184 $sth = $dbh->prepare("show index from issuingrules");
1187 while ( my ( $table, $non_unique, $key_name, $Seq_in_index, $Column_name, $Collation, $cardinality, $sub_part, $Packed, $comment ) = $sth->fetchrow )
1189 if ($key_name eq 'PRIMARY') {
1193 print "Creating index on issuing rules\n" unless $exists or $silent;
1194 $dbh->do('ALTER TABLE issuingrules ADD PRIMARY KEY ( branchcode, categorycode, itemtype )') unless $exists;
1196 $dbh->do('ALTER TABLE marc_tag_structure drop primary key');
1197 $dbh->do('ALTER TABLE marc_tag_structure ADD PRIMARY KEY ( frameworkcode, tagfield )');
1199 $dbh->do('ALTER TABLE marc_subfield_structure drop primary key');
1200 $dbh->do('ALTER TABLE marc_subfield_structure ADD PRIMARY KEY ( frameworkcode, tagfield, tagsubfield )');
1202 # Get list of columns from marc_word table
1205 $sth = $dbh->prepare("show columns from marc_word");
1207 while ( my ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
1209 $marc_word{$column} = $type;
1210 $nullenabled{$column} = $null;
1212 if ($marc_word{subfieldid}) {
1213 #create field tagsubfield, copy tag+subfieldid, then drop tag and subfieldid
1214 print "Modifying marc_word (concat on tag and subfield for better perfs)\n" unless $silent;
1215 $dbh->do("ALTER TABLE `marc_word` ADD `tagsubfield` CHAR( 4 ) NOT NULL AFTER `bibid`");
1216 $dbh->do("update marc_word set tagsubfield=concat(tag,subfieldid)");
1217 $dbh->do("alter table marc_word drop tag");
1218 $dbh->do("alter table marc_word drop subfieldid");
1219 $dbh->do("create index Search_Marc on marc_word (tagsubfield,word)");
1221 # Populate tables with required data
1223 # fill aqbasket if it's empty and aqorder is not
1224 # => it means it has just been created & must be filled
1225 $sth = $dbh->prepare("select count(*) from aqbasket");
1227 if ($sth->fetchrow == 0) {
1228 $sth = $dbh->prepare("select count(*) from aqorders");
1230 if ($sth->fetchrow >0) {
1231 print "Populating new table aqbasket\n";
1232 print "IMPORTANT NOTE: error message \"Duplicate entry 'X' for key 1\" may appear. it should not be a real trouble\n";
1233 $sth=$dbh->prepare("select distinct basketno,booksellerid,authorisedby,entrydate,booksellerinvoicenumber from aqorders");
1235 my ($basketno,$booksellerid,$authorisedby,$entrydate,$booksellerinvoicenumber);
1236 my $sth2 = $dbh->prepare("insert into aqbasket (basketno,creationdate,booksellerid,authorisedby,booksellerinvoicenumber) values (?,?,?,?,?)");
1237 while (($basketno,$booksellerid,$authorisedby,$entrydate,$booksellerinvoicenumber) = $sth->fetchrow) {
1238 print "$basketno,$entrydate,$booksellerid,$authorisedby,$booksellerinvoicenumber\n";
1239 $sth2->execute($basketno,$entrydate,$booksellerid,$authorisedby,$booksellerinvoicenumber);
1243 foreach my $table ( keys %tabledata ) {
1244 print "Checking for data required in table $table...\n" unless $silent;
1245 my $tablerows = $tabledata{$table};
1246 foreach my $row (@$tablerows) {
1247 my $uniquefieldrequired = $row->{uniquefieldrequired};
1248 my $uniquevalue = $row->{$uniquefieldrequired};
1249 my $forceupdate = $row->{forceupdate};
1252 "select $uniquefieldrequired from $table where $uniquefieldrequired=?"
1254 $sth->execute($uniquevalue);
1256 foreach my $field (keys %$forceupdate) {
1257 if ($forceupdate->{$field}) {
1258 my $sth=$dbh->prepare("update systempreferences set $field=? where $uniquefieldrequired=?");
1259 $sth->execute($row->{$field}, $uniquevalue);
1263 print "Adding row to $table: " unless $silent;
1267 foreach my $field ( keys %$row ) {
1268 next if $field eq 'uniquefieldrequired';
1269 next if $field eq 'forceupdate';
1270 my $value = $row->{$field};
1271 push @values, $value;
1272 print " $field => $value" unless $silent;
1273 $fieldlist .= "$field,";
1274 $placeholders .= "?,";
1276 print "\n" unless $silent;
1277 $fieldlist =~ s/,$//;
1278 $placeholders =~ s/,$//;
1281 "insert into $table ($fieldlist) values ($placeholders)");
1282 $sth->execute(@values);
1287 # at last, remove useless fields
1288 foreach $table ( keys %uselessfields ) {
1289 my @fields = split /,/,$uselessfields{$table};
1290 foreach my $fieldtodrop (@fields) {
1291 $fieldtodrop =~ s/\t//g;
1292 $fieldtodrop =~ s/\n//g;
1293 print "deleting $fieldtodrop field in $table...\n" unless $silent;
1294 my $sth = $dbh->prepare("alter table $table drop $fieldtodrop");
1297 print "Error : $sth->errstr \n";
1309 # Revision 1.91 2004/07/15 09:52:28 tipaul
1310 # Acquisition & Suggestion :
1311 # * acquisition rewritte : create a aqbasket table to deal with "bookseller order header".
1312 # * add "close basket" feature : a closed basket can't be modified
1313 # * suggestion feature : manage suggestions in acquisition (after suggestion filled in OPAC)
1315 # Revision 1.90 2004/07/06 08:24:18 tipaul
1316 # adding 2 free fields that can be used for sorting purposes
1318 # Revision 1.89 2004/07/02 15:55:08 tipaul
1319 # Adding 2 new fields, called "sort1" and "sort2"
1320 # They can be used for sorting & statistics reasons by the library.
1322 # Revision 1.88 2004/06/26 23:34:26 rangi
1325 # Revision 1.87 2004/06/23 13:03:09 tipaul
1326 # fixes in DB structure
1328 # Revision 1.86 2004/06/22 11:30:57 tipaul
1329 # adding -s (silent) flag, to have a silent install.
1330 # only updater will be verbose
1332 # Revision 1.85 2004/06/17 15:19:44 tipaul
1333 # missing Marc_Search index on marc_word
1335 # Revision 1.84 2004/06/17 08:25:21 tipaul
1336 # DB modifs : merging tag & subfield in marc_word table
1338 # Revision 1.83 2004/06/10 08:32:02 tipaul
1339 # MARC authority management (continued)
1341 # Revision 1.82 2004/06/03 12:46:58 tipaul
1342 # * frameworks and itemtypes are independant
1344 # WARNING : will work only if applied to a 2.0 base. some modifs have been done since last commit that will NOT be applied if you run updatedatabase again.
1346 # Revision 1.81 2004/05/28 09:56:21 tipaul
1349 # Revision 1.80 2004/05/28 08:32:00 tipaul
1351 # * MARC authority file
1352 # * seealso & hidden in MARC biblio structure.
1354 # Revision 1.79 2004/05/18 09:50:07 tipaul
1355 # *** empty log message ***
1357 # Revision 1.78 2004/05/10 09:29:33 tipaul
1358 # css is now the default theme for OPAC.
1359 # It will be the theme used for improvements and new things in OPAC.
1361 # Revision 1.77 2004/05/06 14:56:51 tipaul
1362 # adding table issuingrules (previously called categoryitem
1364 # Revision 1.76 2004/05/03 09:32:25 tipaul
1365 # adding printcirculationsplit parameter (already existed, but was not in systempref by defaul)
1367 # Revision 1.75 2004/04/14 19:49:00 tipaul
1368 # seealso field set to 255 chars
1370 # Revision 1.74 2004/03/11 16:10:16 tipaul
1371 # *** empty log message ***
1373 # Revision 1.73 2004/03/06 20:26:13 tipaul
1374 # adding seealso feature in MARC searches