From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1QfIq7-0007V9-Qe for garchives@archives.gentoo.org; Fri, 08 Jul 2011 21:44:00 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 8ABAF21C06D; Fri, 8 Jul 2011 21:43:52 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 33DE621C06D for ; Fri, 8 Jul 2011 21:43:52 +0000 (UTC) Received: from pelican.gentoo.org (unknown [66.219.59.40]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 973212AC10A for ; Fri, 8 Jul 2011 21:43:51 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by pelican.gentoo.org (Postfix) with ESMTP id BE97F8003D for ; Fri, 8 Jul 2011 21:43:50 +0000 (UTC) From: "Anthony G. Basile" To: gentoo-commits@lists.gentoo.org Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Anthony G. Basile" Message-ID: <23fcd71dd417e56584a86290aaf6eb9f62e1679d.blueness@gentoo> Subject: [gentoo-commits] dev/blueness:master commit in: www-apps/moodle/files/, www-apps/moodle/ X-VCS-Repository: dev/blueness X-VCS-Files: www-apps/moodle/Manifest www-apps/moodle/files/config.php www-apps/moodle/files/postinstall-en.txt www-apps/moodle/files/postinstall-nodb-en.txt X-VCS-Directories: www-apps/moodle/files/ www-apps/moodle/ X-VCS-Committer: blueness X-VCS-Committer-Name: Anthony G. Basile X-VCS-Revision: 23fcd71dd417e56584a86290aaf6eb9f62e1679d Date: Fri, 8 Jul 2011 21:43:50 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: quoted-printable X-Archives-Salt: X-Archives-Hash: 6d6a8382949fc83f4f0935f62cc0b413 commit: 23fcd71dd417e56584a86290aaf6eb9f62e1679d Author: Anthony G. Basile gentoo org> AuthorDate: Fri Jul 8 21:43:46 2011 +0000 Commit: Anthony G. Basile gentoo org> CommitDate: Fri Jul 8 21:43:46 2011 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=3Ddev/blueness.git;a= =3Dcommit;h=3D23fcd71d www-apps/moodle: added needed FILESDIR (Portage version: 2.1.10.3/git/Linux x86_64, signed Manifest commit with = key 0xD0455535) --- www-apps/moodle/Manifest | 9 +- www-apps/moodle/files/config.php | 29 ++++ www-apps/moodle/files/postinstall-en.txt | 220 +++++++++++++++++++= ++++++ www-apps/moodle/files/postinstall-nodb-en.txt | 6 + 4 files changed, 261 insertions(+), 3 deletions(-) diff --git a/www-apps/moodle/Manifest b/www-apps/moodle/Manifest index 0663f1d..7373353 100644 --- a/www-apps/moodle/Manifest +++ b/www-apps/moodle/Manifest @@ -1,6 +1,9 @@ -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA256 =20 +AUX config.php 718 RMD160 9e4b97aafca65da8648466d11728c457fff439ab SHA1 = d71fc86158e82f706ca2cdfe1efe2e8de62cc607 SHA256 c62a37c0d81043ee4ca7fc4d7= 610d19dc2df426d556eb3285d7b1fe367a44a8d +AUX postinstall-en.txt 6524 RMD160 d3799bc5cdc283e787c1b5d08935a8d7851d0= c8d SHA1 097744447c046848611bfe53d5191518465f1c6d SHA256 dad8831abc23179e= bcd2c2431f11d83346c142175c59da47cf5f913c928de667 +AUX postinstall-nodb-en.txt 171 RMD160 88ff71d95c63f1b5d76e398c3566ada75= 954cdf4 SHA1 26748e5f24207ef5cb145e3668e1f17cdcddf699 SHA256 f39ff660a1ca= fbbd96ce18c46f056450ace04df5ac401eeccaf16441d54f3b6a DIST moodle-2.1.tgz 23128617 RMD160 ed0758ffd1534c907ff27f5b9c5d1b285e49= 9239 SHA1 9d7830f7b16621c22813634f19baae56cd565315 SHA256 8739ab133be9973= 6ae7d9f004b4163b332dfd135c064899f84b24b8867ea2810 EBUILD moodle-2.1.ebuild 3582 RMD160 1a8cf4d09c3ea6c68f1644e02be8d9d5d68= a4690 SHA1 e61e0972e3d87fa74ebbb1632e5aa6be8dc36a54 SHA256 c5b2ec282ecb89= b101d9a6c75839f95567736d6b3da66d48ff2e11a9ffe31947 MISC ChangeLog 136 RMD160 fc9660fde19ae47a1042914c33b3122a7f4f3915 SHA1 = 68b48ffe651aa2fe5cd9b1668048476974c7dc58 SHA256 6ebbd5bae600a73b1d85e89ee= 5765d127d4feef5e8d04a48a4ac7b1dfd8fe243 @@ -8,7 +11,7 @@ MISC metadata.xml 256 RMD160 7cd5a16a6eade95f71d40edbb47= 29baadfbc7649 SHA1 809ee -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.17 (GNU/Linux) =20 -iEYEAREIAAYFAk4XcR0ACgkQl5yvQNBFVTV0FQCghRJy0uLoMs/71jDn2dfwZJnL -ZOcAn0JjY3g8SKF+UDeWerSRwQHIlOxl -=3Dvdxu +iEYEAREIAAYFAk4XehIACgkQl5yvQNBFVTUfFgCggcylUUbaT1nL1VvFZBuo7Vxy +RSsAmwYaQBEHyxoPw3FzjoUjRdvMVU7T +=3DxBBp -----END PGP SIGNATURE----- diff --git a/www-apps/moodle/files/config.php b/www-apps/moodle/files/con= fig.php new file mode 100644 index 0000000..c959b4a --- /dev/null +++ b/www-apps/moodle/files/config.php @@ -0,0 +1,29 @@ +dbtype =3D 'mydb'; +$CFG->dbhost =3D 'localhost'; +$CFG->dbname =3D 'moodle_db'; +$CFG->dbuser =3D 'moodle_user'; +$CFG->dbpass =3D 'moodle_pass'; +$CFG->prefix =3D 'mdl_'; + +$CFG->dbpersist =3D false; + +$CFG->wwwroot =3D 'http://localhost/moodle'; +$CFG->dirroot =3D '/var/www/localhost/htdocs/moodle'; +$CFG->dataroot =3D '/var/www/localhost/moodle' ; + +$CFG->directorypermissions =3D 02777; + +$CFG->admin =3D 'admin'; + +if (file_exists("$CFG->dirroot/lib/setup.php")) { + include_once("$CFG->dirroot/lib/setup.php"); +} else { + echo "

Could not find this file: $CFG->dirroot/lib/setup.php

"; + echo "

Please supply this file or reinstall moodle

"; + die; +} +?> diff --git a/www-apps/moodle/files/postinstall-en.txt b/www-apps/moodle/f= iles/postinstall-en.txt new file mode 100644 index 0000000..6a5b44b --- /dev/null +++ b/www-apps/moodle/files/postinstall-en.txt @@ -0,0 +1,220 @@ +NEW INSTALLS + +0 Check to see if webapp-config automatically installed + moodle for you in /var/www/localhost/htdocs. You should + see a directory in there called moodle. If it didn't + install it manually: + + webapp-config -d moodle -I moodle X.Y.Z + + Replace X.Y.Z with whatever version you just emerged. + +1 Edit the config.php file found at + + /var/www/localhost/htdocs/moodle/config.php + + You should probably change the database password, + $CFG->dbpass =3D 'moodle_pass' to something more + obscure. Also, if your system has a FQDN, change + the $CFG->wwwroot =3D 'http://localhost/moodle' + to match the URL of your moodle installation. + =20 + =20 + IF YOU ARE USING MYSQL, do step 2a + IF YOU ARE USING POSTGRESQL, do step 2b + + +2a Create a new mysql database and account with the + appropriate privileges. Make sure the username, + password and database match their values in + config.php from step 1. + =20 + Connect to your mysql server using + =20 + mysql -p -u root + + and at the mysql> prompt issue the following commands + + CREATE DATABASE moodle_db; + GRANT ALL ON moodle_db.* + TO moodle_user@localhost + IDENTIFIED BY 'moodle_pass'; + flush privileges; + +2b Issue the following commands at a shell, making sure + the username, password and database match their values + in config.php from step 1. + + su - postgres + psql -c "create user moodle_user createdb;" template1 + psql -c "alter user moodle_user with encrypted password 'moodle_pass'= ;" template1 + psql -c "create database moodle_db with encoding 'unicode';" -U moodl= e_user template1 + psql -c "alter user moodle_user nocreatedb;" template1 + su - root + /etc/init.d/postgresql-X.Y reload + + Replace X.Y with your version postgresql. + + NOTE: Moodle docs say that moodle only works with + postgresql-7, but I've used it with 8 no problems. + +3 Direct your browser to the URL in step 1. You should see + the license agreement. Click "Yes" to continue. + +4 You are now about to install. Click the checkbox for + "Unattended operation" and "Continue" to start. Follow + the wizard as you "Setup administrator account" and configure + the "Front Page settings". + +5 You now have a working installation. Before putting it + into production, you'll probably want to check that + everything is sane. In the "Site Administration" block, + click on + + Server -> Environment + + Make sure that you've got the green okay on all the + Server Checks. If you don't, click on the ? icons for + popup help. + +6 Add a cron-job to root's crontab. + + su - root + crontab -e # fcrontab -e if you use fcron + + then add the line + + */30 * * * * root php -q /var/www/localhost/htdocs/moodle/admin/cron.= php > /dev/null + +7 For more information on installing moodle, see + + http://docs.moodle.org/en/Installing_Moodle + + For information on working with moodle, see + + http://moodle.org/support/ + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +UPGRADES + +0 Before any upgade you should backup your database in case you have + to roll back. The moodle dirroot directory ($CFG->dirroot in the + config.php file) isn't as critical since you can always reinstall + that with web-apps. The moodle data root ($CFG->dataroot in config.p= hp), + where files are uploaded, will not be touched. But the upgrade will + probably change your db schema, and the new format may not be backwar= d + compatible. For mysql use + + mysqldump -u moodle_user -p -C -Q -e --create-options moodle_db > moodl= e-backup.sql + + or for postgresql use + + su - postgres + pg_dump moodle_db > moodle-backup.sql + + If you have to fall back, you can do so using + + mysql -p -u moodle_user moodle_db < moodle-backup.sql + + or + + su - postgres + psql moodle_db < moodle-backup.sql + + TEST THIS! PRACTICE THIS! Make sure it will work for you if you + have to fall back. + +1 Emerge the new moodle ebuild. Be prepared to add USE flags for + php and re-emerge it since upgrades may require new functionality + from php. Remember to restart apache after re-emerging php! + +2 If the ebuild didn't do it for you, update using + + webapp-config -d moodle -U moodle X.Y.Z + +3 Aim your browser to the URL in the config.php file defined + by $CFG->wwwroot. You will get a message that you are about + to automatically upgrade your server and cannot go back. + This is why you backed up your db in step 1. You can go back + if you use webapp-config to install the older version AND + drop the new db and restart the old one. You did practice + restoring, right? + +4 Click "Continue" and follow through with the upgrade. + + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +UNINSTALL + +1 Make sure you really want to do this. I mean REALLY! + After step 3 you will be past the point of no return. + +2 If you just want to uninstall the webapp, do the following + and no more! + + emerge --unmerge moodle + + Your data is still in the db and in the moodledata dir. + + + !!!!!!!!! POINT OF NO RETURN !!!!!!!!! + +3 Uninstall the uploaded files + + rm -rf /var/lib/moodledata + + + IF YOU ARE USING MYSQL, do step 4a + IF YOU ARE USING POSTGRESQL, do step 4b + + +4a Connect to your mysql server using 'mysql -p -u root' and + at the mysql> prompt issue the following commands: + + DROP DATABASE moodle_db; + DROP USER moodle_user@localhost ; + +4b Issue the following commands + + su - postgres + psql -c "drop database moodle_db;" template1 + psql -c "drop user moodle_user;" template1 + +5 Remove the root cron-job + + su - root + crontab -e # fcrontab -e if you use fcron + + and delete the line added above. + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +ADDITIONAL PHP REQUIREMENTS + + Moodle allows for many method of authentication. To see + what these are, in the "Site Administration" block, click + on + + Users -> Authentication -> Manage Authentication + + Moodle will try to authenticate by each method in order + until it either succeeds or exhausts the list and fails. + + In order to use some of these methods, you need to make + sure PHP was compiled with the correct support. You will + know that you do not have the correct support compiled in + if authentication by all previous methods fails, and you + encounter a method for which PHP does not have support. + An error will be thrown and reported in the web page. + =20 + Currently, the ebuild has support for the following + + Auth Method USE flag + + IMAP(S) or POP3(S) imap + LDAP or CAS ldap + External database odbc + RADIUS radius + diff --git a/www-apps/moodle/files/postinstall-nodb-en.txt b/www-apps/moo= dle/files/postinstall-nodb-en.txt new file mode 100644 index 0000000..9126994 --- /dev/null +++ b/www-apps/moodle/files/postinstall-nodb-en.txt @@ -0,0 +1,6 @@ +You have not specified which database you are going to use. +You are on your own! Go to + + http://docs.moodle.org/en/Installing_Moodle + +and follow the instructions there.