-
Eric Rasmussen authoredEric Rasmussen authored
README 5.86 KiB
********
** How to set up UNL_Elgg:
********
Run the setup.sh script to symlink all the necessary plugins
./setup.sh
Create a mysql database named unl_social
Import the full_dump.sql file*
mysql -u root unl_social < full_dump.sql
Browse to the elgg directory in your web browser and do elgg's installation:
Create the local elgg/.htaccess file using the sample on the install page
Be sure to set the correct RewriteBase /workspace/UNL_Elgg/elgg/ for example.
Create the local elgg/engine/settings.php file.
Be sure to specify unl_social as the database name
Add this settings file to your svn:ignore list
Create a local directory named elgg_data for elgg to write to outside of the web root.
Change the permissions so Apache has write access to it.
sudo chown _www elgg_data
Install pear http://pear.php.net/manual/en/installation.getting.php
Install the UNL_Templates pear packages
pear channel-discover pear.unl.edu && pear install unl/UNL_Templates-beta unl/UNL_Services_Peoplefinder-beta DB
Set the correct site url within the unl_social database:
UPDATE elggsites_entity SET url='http://ucommbieber.unl.edu/workspace/UNL_Elgg/elgg/' WHERE guid=1;
UPDATE elggdatalists SET value = '/Users/bbieber/Documents/workspace/UNL_Elgg/elgg/' WHERE name = 'path';
UPDATE elggdatalists SET value = '/Users/bbieber/Documents/workspace/UNL_Elgg/elgg_data/' WHERE name = 'dataroot';
Make sure the local site has an updated copy of the unl templatedependents
******
** Troubleshooting
******
After navigating to the elgg dir in your browser and filling in the correct database info -
if you get the error that elgg can't connect to your database do this:
1. find your php.ini file, probably located at /etc/php.ini.default and rename it to php.ini
2. edit the mysql.default_socket line to include the path to your mysql.sock file, e.g.
mysql.default_socket = /private/tmp/mysql.sock
If the mobile site or the regular site starts pulling in the Absolute template rather than the specified template
you may need to set up a symbolic link for the wdn directory. The UNL_Templates package will
>> cd elgg/
>> ln -s /var/www/html/wdn wdn
*******
** Notes on importing data:
*******
****From here on out we will be dumping data from the live server to import on testing instances only. Changes on test
instances that modify database fields must be documented and repeated on the live server after testing.
full_dump.sql is is full copy of the mysql database that must be modified upon import.
safe_dump.sql can be imported without the need for modification
when importing full_dump.sql, you must modify certain rows in the tables elggdatalists and elggsites_entity so
that they pertain to the local elgg site instance. (so if you see something like
http://ucommjuhl.unl.edu/UNL_Elgg/elgg, change it!)
*******
** Notes on importing data for dev to local machine:
*******
-On 'live' machine: ftp a copy of the database to your machine
scp /backups/mysql/daily/unl_social/unl_social_2010-04-22_00h10m.Thursday.sql.gz usernameonlocalmachine@yourmachine.com:/Path/To/Transer/To
-On 'dev' machine: unzip it
gunzip unl_social_2010-04-22_00h10m.Thursday.sql.gz
-import it
mysql -u username -p < /Path/To/unl_social_2010-04-22_00h10m.Thursday.sql
-Set the correct site url within the unl_social database:
mysql -u username -p
use unl_social;
UPDATE elggsites_entity SET url='http://ucommmeranda.unl.edu/workspace/UNL_Elgg/elgg/' WHERE guid=1;
UPDATE elggdatalists SET value = '/Users/smeranda/Documents/workspace/UNL_Elgg/elgg/' WHERE name = 'path';
UPDATE elggdatalists SET value = '/Users/smeranda/Documents/workspace/UNL_Elgg/elgg_data/' WHERE name = 'dataroot';
-zip up elgg_data and ftp that
zip -r newfilename elgg_data
-replace your local copy of elgg_data with this one and make sure apache (could be _www or apache or ?) has write access to it
cd path/to/elgg_data
sudo chown -R _www *
*******
** Plugin info
*******
Just run the setup.sh script. If any plugins are added, add this to the setup.sh script.
elgg https://code.elgg.org/elgg/trunk/
elgg/mod/groups https://code.elgg.org/extensions/plugins/groups
elgg/mod/notifications https://code.elgg.org/extensions/plugins/notifications
elgg/mod/profile https://code.elgg.org/extensions/plugins/profile
elgg/mod/reportedcontent https://code.elgg.org/extensions/plugins/reportedcontent
elgg/mod/riverdashboard https://code.elgg.org/extensions/plugins/riverdashboard
elgg/mod/thewire https://code.elgg.org/extensions/plugins/thewire
elgg/mod/flexprofile http://its-gforge.unl.edu/svn/unl_elgg/trunk/flexprofile_mj
elgg/mod/form http://its-gforge.unl.edu/svn/unl_elgg/trunk/plugins/form
elgg/mod/globe http://its-gforge.unl.edu/svn/unl_elgg/trunk/plugins/globe
elgg/mod/messages http://its-gforge.unl.edu/svn/unl_elgg/trunk/plugins/messages
elgg/mod/browse http://its-gforge.unl.edu/svn/unl_elgg/trunk/plugins/browse
elgg/mod/mass_mailouts http://its-gforge.unl.edu/svn/unl_elgg/trunk/plugins/mass_mailouts
elgg/mod/cas_auth_unl http://its-gforge.unl.edu/svn/unl_elgg/trunk/plugins/cas_auth_unl
elgg/mod/customindex http://its-gforge.unl.edu/svn/unl_elgg/trunk/plugins/customindex
elgg/mod/unl_theme http://its-gforge.unl.edu/svn/unl_elgg/trunk/plugins/unl_theme
elgg/featured/ http://its-gforge.unl.edu/svn/unl_huskers/trunk/
*******
** Patches
*******
All patches are located in the /pathces directory. These include:
patches/relationship_get_set_public.diff *__get __set not declared correctly
patches/lowercase_post.diff *Forms use POST which doesn't validate
patches/strip_tags_name_field.diff *Display Name field allowed html that often was not escaped upon output
patches/add_closing_labels.diff
*******
** Things to look out for when new versions of Elgg are released
*******
-- Are there changes to /elgg/actions/login.php and /elgg/actions/logout.php ?????
We have overridden those actions with our own in the cas_auth_unl plugin