Install eZ publish 3 manually
eZ publish 3 requirements
You need to have Apache, MySQL, ImageMagick and PHP installed to run eZ publish 3.
PHP needs to have compiled-in support for either MySQL (--with-mysql) or PostgreSQL (--with-pgsql)
For image conversion support you need to have GD compiled in PHP or
ImageMagick installed on your system.
The installation process for the above programs are very well documented on
their homepage, so we will not include that here.
Installation on Linux, FreeBSD and Mac OS X
- Unpack ezpublish-xxx.tar.gz into the folder
$ tar xvfz ezpublish-xxx.tar.gz -C <httproot>
- Now go to the extracted eZ publish directory
$ cd <httproot>/ezpublish-xxx/
- Run the modfix.sh script
$ bin/modfix.sh
Database setup
MySQL
We need to login, create a new database, grant permissions to a user and insert a database.
$ mysql -u root -p <password> - You should now have a "mysql>" prompt, create a new database
mysql> create database <name_of_database>
- Grant permissions
mysql> grant all on <name_of_database>.* to <user>@localhost
identified by '<password>';
- If you don't want to install demodata
$ mysql -u <user> -p<password> <name_of_database>
< <httproot>/ezpublish-xxx/kernel/sql/mysql/kernel_clean.sql
If you do want the demodata $ mysql -u <user> -p<password> <name_of_database>
< <httproot>/ezpublish-xxx/kernel/sql/mysql/demokernel.sql
PosgreSQL
We need to login, create a new database, grant permissions to a user and insert a database.
- Become the PostgreSQL super user (normally called postgres)
$ su <postgres_super_user>
- Create a postgresql user
$ createuser <user>
- Create a database
$ createdb <name_of_database>
- Demodata is not available for PostgreSQL at the moment, so we have to install the kernel_clean.sql file
$ psql -U <ezpublish_user> <name_of_database>
< <httproot>/ezpublish-xxx/kernel/sql/postgresql/kernel_clean.sql
Demo data
Demodata is only available for MySQL. Before you proceed make sure you
installed the demokernel.sql file and NOT the kernel_clean.sql file.
To install the demodata all you have to do is unpack the var.tgz file
- Go to <httproot>\ezpublish-xxx
$ cd <httproot>/ezpublish-xxx
- Unpack var.tgz
$ tar xvfz var.tgz
Open <httproot>/ezpublish-xxx/settings/site.ini with your favourite editor
and set the correct setting in the [Database Settings] section.
You need to select what database implementation you would like to use,
hostname of database server to connect to, username, password and database name.
[Database Settings]
# Use either ezmysql or ezpostgresql
Database Implementation=ezpostgresql
# Name of server to connect to
Server=localhost
# DB user name
User=<user>
# DB Password
Password=<password>
# database name you have created on previous step
Database=<name_of_database>
Virtualhost setup
You can use eZ publish with a virtualhost setup. When using a virtualhost you
don't need to specify the index.php in the URL.
Below is a sample configuration for virtualhost setup. Include this in your apache config file and restart apache when you are done.
<Virtualhost <you_ip_address>>
<Directory <httproot>/ezpublish-xxx/>
Options FollowSymLinks Indexes ExecCGI
AllowOverride None
</Directory>
RewriteEngine On
RewriteRule !\.(gif|css|jpg|png)$ <httproot>/ezpublish-xxx/index.php
ServerAdmin root@localhost
DocumentRoot <httproot>/ezpublish-xxx/
ServerName <you_ip_address>
</VirtualHost>
Siteaccess settings
For help on how to configure site access, head over to the site access section
Installation on Windows
- Unpack ezpublish-xxx.tar.gz into the <httproot> folder. Use a program that supports .tar.gz files, like WinZip.
- Go to <httproot>\ezpublish-xxx
- Make sure the directory var\cache\ini exists, if not, create it.
Database setup
MySQL
We need to login, create a new database, grant permissions to a user and insert a database.
- Open a console window (start->run->cmd.exe or start->run->command.exe depending on the Windows version)
- Go to your the location of mysql and find the mysql.exe file (should be under bin\)
- Run
mysql.exe -u root -p <your_mysql_password>
- You should now have have a mysql> prompt. Type these mysql statements
mysql> create database <name_of_database>;
- Grant permissions
mysql> grant all on .* to <user>@localhost identified
by '<password>';
- If you don't want demodata
$ mysql.exe -u <user> -p<password> <name_of_database>
< <httproot>\ezpublish-xxx\kernel\sql\mysql\kernel_clean.sql
If you do want demodata $ mysql.exe -u<user> -p<password> <name_of_database>
< <httproot>\ezpublish-xxx\kernel\sql/mysql\demokernel.sql
Demo data
Demodata is only available for MySQL. Before you proceed make sure you
installed the demokernel.sql file and NOT the kernel_clean.sql file.
To install the demodata all you have to do is unpack the var.tgz file
- Go to <httproot>\ezpublish-xxx
- Unpack var.tgz into <httproot>\ezpublish-xxx
Open <httproot>/ezpublish-xxx/settings/site.ini in notepad and set the correct settings in the [Database Settings] section.
You need to set what database implementation you use, hostname of database
server to connect to, user name, password, database name.
[Database Settings]
# Use either ezmysql or ezpostgresql
DatabaseImplementation=ezpostgresql
# Name of server to connect to
Server=localhost
# DB user name
User=<user>
# DB Password
Password=<password>
# database name you have created on previous step
Database=<name_of_database>
Virtualhost setup
You can use eZ publish with a virtualhost setup. When using a virtualhost you don't need to specify the index.php in the URL.
Make sure these lines exists in your apache configfile and is not commented out
LoadModule rewrite_module modules/mod_rewrite.so
AddModule mod_rewrite.c
Below is a sample configuration for virtualhost setup. Include this in your apache config file and restart apache when you are done.
<VirtualHost <your_ip_adress>>
<Directory <httproot>/ezpublish-xxx/>
Options FollowSymLinks Indexes ExecCGI
AllowOverride None
</Directory>
RewriteEngine On
RewriteRule !\.(gif|css|jpg|png|jar)$ /index.php
ServerAdmin root@localhost
DocumentRoot <httproot>/ezpublish-xxx
ServerName <your_ip_adress>
</VirtualHost>
Note:The rewrite rule is releative to the http root and use '/' (slash) not '\' (backslash)
Siteaccess settings
For help on how to configure site access, head over to the site access section
|
