--- doc/build/Attic/loncapasqldatabase.html 2001/02/14 15:24:16 1.10 +++ doc/build/Attic/loncapasqldatabase.html 2002/09/23 01:25:09 1.18 @@ -8,7 +8,7 @@ Scott Harrison
-Last updated: 02/14/2001 +Last updated: 02/15/2001
This file describes issues associated with LON-CAPA @@ -32,6 +32,72 @@ and a SQL database.
+The current database is implemented assuming a non-adjustable +architecture involving these data fields (specific to each version +of a resource). +
+Security occurs as a function of the user 'www', +and the permissions on the files in the /usr/local/mysql +directory. (These files and directories should +be 700, 600, 500, 400, etc; not allow access to anyone +but user 'www'.) +
++These commands create the loncapameta database. +
+mysql> CREATE DATABASE IF NOT EXISTS loncapa; +mysql> USE loncapa; +mysql> CREATE TABLE IF NOT EXISTS metadata (title TEXT, author TEXT, subject TEXT, url TEXT, keywords TEXT, version TEXT, notes TEXT, abstract TEXT, mime TEXT, language TEXT, creationdate DATETIME, lastrevisiondate DATETIME, owner TEXT, copyright TEXT, FULLTEXT idx_title (title), FULLTEXT idx_author (author), FULLTEXT idx_subject (subject), FULLTEXT idx_url (url), FULLTEXT idx_keywords (keywords), FULLTEXT idx_version (version), FULLTEXT idx_notes (notes), FULLTEXT idx_abstract (abstract), FULLTEXT idx_mime (mime), FULLTEXT idx_language (language), FULLTEXT idx_owner (owner), FULLTEXT idx_copyright (copyright)) TYPE=MYISAM; +mysql> INSERT INTO metadata VALUES ('The Structure of Scientific Revolutions','Thomas S. Kuhn','scientific philosophy','/res/msu/shh1/poobah2.html','aphorisms, theories, paradigm, revolution','current','still developing','This famous book stands out in contrast to the more rigid theories of Popper.','html','seniso','1999-03-03 12:34:56','1999-03-03 3:12:00','shh1@msu.edu','default'); +mysql> SELECT * FROM metadata WHERE title REGEXP "1"; ++ +
+Current time values for things. +
+fenchurch.lite.msu.edu +Mem: 46812K av, 45632K used, 1180K free, 14756K shrd, 4292K buff +Swap: 1148608K av, 11260K used, 1137348K free 13244K cached + +Red Hat Linux release 6.2 (Zoot) +Kernel 2.2.16-3 on an i586 ++
+An important quote from the manual: +
+In MySQL Version 3.23.23 or later, you can also create special FULLTEXT indexes. They are used for full-text search. Only the MyISAM table type supports FULLTEXT indexes. They can be created only from +VARCHAR and TEXT columns. Indexing always happens over the entire column and partial indexing is not supported. See section 25.2 MySQL Full-text Search for details. ++ +
+I plan on using a MyISAM table type with 11 metadata fields of column +type=TEXT. +
+It might be worthwhile to look at /usr/local/mysql/manual.html. It is quite in depth.
@@ -224,6 +290,51 @@ that is subsequently compiled). wind up in /usr/local/mysql-3.23.33-pc-linux-gnu-i686 except for a link from /usr/local/mysql to /usr/local/mysql-3.23.33-pc-linux-gnu-i686 and some files involved in system process handling (/etc/rc.d/*/*mysql). ++(As user=root) +cd /usr/local/; +tar xzvf mysql-3.23.33-pc-linux-gnu-i686.tar.gz +ln -s /usr/local/mysql-3.23.33-pc-linux-gnu-i686 mysql +cd /usr/local/mysql +chown -R www /usr/local/mysql/. +chgrp -R users /usr/local/mysql/. +chmod -R g-w,g-r,g-x /usr/local/mysql/. +(probably also want chmod -R a-w,a-r,a-x /usr/local/mysql/.) + +Alter safe_mysqld +and support-files/mysql.server to use 'localhosts' instead +of `bin/hostname`. Also, to use user 'www' instead of 'mysql'. + +(These changes could be done with /etc/my.cnf, but +I think this approach makes sure the database NEVER +gets screwed up due to somebody forgetting to install /etc/my.cnf). + +Change this line in mysql.server from + pid_file=$datadir/`@HOSTNAME@`.pid +to + pid_file=$datadir/localhost.pid + +Change this line in safe_mysqld from +user=root +to +user=www + +Change this line in safe_mysqld from + pid_file=$DATADIR/`/bin/hostname`.pid +to + pid_file=$DATADIR/localhost.pid + +Change this line in safe_mysqld from +test -z "$err_log" && err_log=$DATADIR/`/bin/hostname`.err +to +test -z "$err_log" && err_log=$DATADIR/localhost.err + +cp -p support-files/mysql.server /etc/rc.d/init.d/mysql +chmod 755 /etc/rc.d/init.d/mysql +/sbin/chkconfig --add mysql +/etc/rc.d/init.d/mysql start + +
This is how I installed the Msql-Mysql-modules perl modules.
@@ -248,6 +359,8 @@ contains the subdir 'include'. [/usr/loc Which database should I use for testing the MySQL drivers? [test] On which host is database test running (hostname, ip address or host:port) [localhost] +User name for connecting to database test? [undef] +Password for connecting to database test? [undef] [root@fenchurch Msql-Mysql-modules-1.2215]# make [root@fenchurch Msql-Mysql-modules-1.2215]# make test make[1]: Entering directory `/home/user/Msql-Mysql-modules-1.2215/mysql' @@ -292,7 +405,7 @@ These files are installed.This is how I installed the DBI perl modules. -
+$dbh [root@fenchurch DBI-1.14]# perl Makefile.PL *** Note: The optional PlRPC-modules (RPC::PlServer etc) are not installed. @@ -331,7 +444,7 @@ All tests successful, 1 test skipped. Files=7, Tests=179, 7 wallclock secs ( 6.46 cusr + 0.49 csys = 6.95 CPU) PERL_DL_NONLAZY=1 /usr/bin/perl -Iblib/arch -Iblib/lib -I/usr/lib/perl5/5.00503/i386-linux -I/usr/lib/perl5/5.00503 test.pl test.pl -DBI test application $Revision: 1.10 $ +DBI test application $Revision: 1.18 $ Using /home/user/DBI-1.14/blib Switch: DBI 1.14 by Tim Bunce, 1.14 Available Drivers: ADO, ExampleP, Multiplex, Proxy, mysql @@ -413,9 +526,10 @@ and typing the several "make" commands fConfiguration (automated)
-Not yet developed. This will be part of an interface -present on LON-CAPA systems that can be launched by -entering the command /usr/sbin/loncapaconfig. +Not yet stabilized. We are looking at webmin +and/or a text-UI tool with less software dependencies +than the python-anaconda hunk represented by +the prior loncapaconfig.
Manual configuration
@@ -443,7 +557,7 @@ VALUES ('localhost','www',password('newm
Granting privileges to user 'www':
-GRANT ALL PRIVILEGES ON *.* TO www@localhost; +GRANT ALL PRIVILEGES ON loncapa.* TO www@localhost; FLUSH PRIVILEGES;@@ -504,13 +618,13 @@ As user www, run this command enter the password as SOMEPASSWORD To add the user www to the MySQL server, and grant all -privileges on *.* to www@localhost identified by 'SOMEPASSWORD' +privileges on loncapa.* to www@localhost identified by 'SOMEPASSWORD' with grant option; INSERT INTO user (Host, User, Password) VALUES ('localhost','www',password('SOMEPASSWORD')); -GRANT ALL PRIVILEGES ON *.* TO www@localhost; +GRANT ALL PRIVILEGES ON loncapa.* TO www@localhost; FLUSH PRIVILEGES; @@ -522,6 +636,21 @@ An up-to-date lond and lonsql.Testing
+To test the backend MySQL database, a number of commands should be +run after installation. +
+These are sections of perl code which helps test the LON-CAPA network.
** TEST the database connection with my current tester.pl code which mimics what command will eventually be sent through lonc.