Notes from James, Andy and Evan's installation efforts



  top

Reading documentation

It expects to have a virtual domain already set up. The installer will ask for this. We're not doing that at the moment so this line will fail in the installer but that's OK for now.

Usually, documentation is found at /usr/share/

/usr/share/doc/ezpublish-src/

If we want to read gz files, put a z infront of less or cat. ie zless README.gz

Look first for the README.Debian. This is normally the fastest way for the Debian package.

Copy the localezcreate script into /usr/local/sbin. This was zipped so unzip it. Unzip it:

gunzip [filename]

We don't need to worry about the virtual hosts stuff for the time being.

You'll have to make this script executable.

chmod a+x localezcreate

  • You'll have to be root to do this stuff.
  • Make sure the /var/www
    folder has write permissions for the www-data
    user who is the default user when running the localezcreate
    script (we had to run chown -R
    www-data /var/www )

Run

localezcreate [mysqluser] [localhost]

Don't worry about the virtual hosts - we haven't set them up yet.

Chapter 3 in EzPublish documentation is about setting up without virtual hosts. We started off editing site.ini and renamed it site.ini.php.

Then we edited sitedir.ini.

  top

Getting languages to work

It doesn't automatically install the zipped language files so we unzipped the en_GB_org.tar.gz into the main ez folder. Copied /usr/src/ezpublish/lang/en_GB_org.tar.gz into /var/www/ez and extracted it.

sudo tar -xvzf en_GB_org.tar.gz

All the directories were called en_GB_org whereas in the site.ini file it was only en_GB. Where the documentation said rename site.ini to site.ini.php, this didn't seem to work and the site was still using site.ini.

There are references to both site.ini and site.ini.php. So we made a simlink from site.ini to site.ini.php.

ln -s [from link] [to link]

We then had to secure site.ini. One way to do this is with an Apache directory setting. To do this we need to go into /etc/apache/httpd.conf and set up a directory directive.

<Directory /var/www/ez>

AllowOverride FileInfo AuthConfig Limit

Order allow,deny

Allow from all

</Directory>

Then we can put a restriction on the site.ini file by putting a .htaccess

in the folder

It then worked.