Project: eZpedia - Quick installation

Setting up a clone of ezpedia is very complex process at the moment. I have compiled this installation procedure from my sessions over last couple of days, it works for me at the moment and hopefully is helpful to get others going until more streamlined method is made. Thanks for Kristof for providing original guide and for help on #ezpedia channel!

Procedure

First, download the eZ publish version currently used by eZpedia.

See the " Powered by" footer at the bottom of primary site to know which version is currently in use and find download link on http://ez.no/download/ez_publish

wget http://ez.no/content/download/177164/1198601/file/ezpublish-3.9.2-gpl.tar.bz2

Unpack the package into your web space and rename the directory to something unique. All further work will be within that directory.

tar -xjf ezpublish-3.9.2-gpl.tar.bz2
 
mv ezpublish-3.9.2 ezpedia
cd ezpedia

Configure apache virtual host to newly created directory and verify it works, you should be greeted with first page of eZ publish installation wizard. You can proceed with the wizard to finetune environment or skip this step if environment is already verified to work with ez publish. Note that you may need to tweak paths of external programs like imagemagick etc. (FIXME: can someone verify it actually works without completing wizard?)

Apache configuration is highly site dependent and out of scope for this guide.

Download current ezpedia mysql database dump, create the database, set up access permissions and import the dump. Substitute your own database name and password below and write them up, they will be used in next steps.

wget http://pubsvn.ez.no/downloads/ezpedia_mirror.sql.gz
 
mysql
 
 
mysql> CREATE DATABASE ezpedia DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
 
mysql> grant all privileges on ezpedia.* to ezpedia@localhost identified by 'mypassword';
 
mysql> flush privileges;
 
mysql> quit
 
gunzip -v ezpedia_mirror.sql.gz
 
 
mysql ezpedia < ezpedia_mirror.sql

Next we need to download number of extensions ezpedia uses. Most of them can be get easily from svn.

cd extension
 
svn checkout http://pubsvn.ez.no/community/trunk/extension/changelog
 
svn checkout http://pubsvn.ez.no/community/trunk/extension/extract
 
svn checkout http://pubsvn.ez.no/community/trunk/extension/ezauthorcontact
 
svn checkout http://pubsvn.ez.no/community/trunk/extension/ezsh
 
svn checkout http://pubsvn.ez.no/community/trunk/extension/redirect
 
svn checkout http://pubsvn.ez.no/community/trunk/extension/sckcreatecopyevent
 
svn checkout http://svn.projects.ez.no/ezpedia/trunk/extension/wikidesign

Some of extensions are not in svn and must be installed manually. Check their home pages for latest dowload link.

Google maps location.

str_replace

wget http://ez.no/content/download/150076/978800/file/gmaplocation.zip
 
wget http://ez.no/content/download/86843/348646/file/str_replace.zip
 
unzip gmaplocation.zip
 
unzip str_replace.zip
 
cd ..

At this point you have two options. If you choose to use the new design (you can see it on the test site http://design.ezpedia.org ), then add the extension ezpediadesign as well. Make sure that it's in the ActiveExtensions setting before wikidesign, because it uses some other templates.

svn checkout http://svn.projects.ez.no/ezpedia/trunk/extension/ezpediadesign
 
cd ..

If you rather llike to use the current design used on ezpedia.org, then download the ezpedia site style design files into site design directory.

cd design
 
svn checkout http://svn.projects.ez.no/ezpedia/trunk/site_styles/design/wiki/
 
cd ..

Next we need to configure ini files. Luckily, basic configuration can be downloaded in one package.

wget http://pubsvn.ez.no/downloads/ezpedia_mirror_settings.tar.gz
 
tar -vxzf ezpedia_mirror_settings.tar.gz

Some settings must be modified manually accordingly to your database and site setup. Substitute your database name, database user name and password from database setup step above.

Required fields are listed below, you may want to read through these ini files and do additional modifications to your taste.

Google maps key can be generated on their signup page.

(FIXME: gmap call on user page does not seem to use key that is set here. Someone verify and fix.)

settings/override/site.ini.append.php
[DatabaseSettings]
DatabaseImplementation=ezmysql
Server=localhost
User=ezpedia
Password=mypassword
Database=ezpedia
 
[SiteSettings]
SiteURL=http://ezpedia.mydomain.com
GMapsKey=long_ugly_key_here_8hw36785d682436583246d745
 
 
[MailSettings]
AdminEmail=myemail@mydomain.com

(FIXME: how to modify these? Short explanation needed. Commenting out all except english at moment.)

settings/override/wiki.ini.append.php
[RegionalSettings]
SiteURLList[eng-GB]=http://ezpedia.mydomain.com/
#SiteURLList[dut-NL]=http://ezpedia.org/wiki/nl/
#SiteURLList[fre-FR]=http://ezpedia.org/wiki/fr/
#SiteURLList[esl-ES]=http://ezpedia.org/wiki/es/
#SiteURLList[ger-DE]=http://ezpedia.org/wiki/de/

Next we need to add the storage files which are downloaded as one package.

cd var/plain_site;
 
wget http://pubsvn.ez.no/downloads/ezpedia_mirror_storage.tar.gz
 
tar -vxzf ezpedia_mirror_storage.tar.gz

At this point you should be done and the ezpedia front page should be loaded when you point your browser to its URL, http://ezpedia.mydomain.com/ in this example. If not, backtrace and verify your steps and ask for help on IRC (#ezpedia channel on freenode)