The requirements for doing a normal installation must be met. Re= ad the "Requirements for doing a normal installation" section first!
Proceed only if you have access to a Windows based system with IIS, PHP,= MySQL or PostgreSQL already installed and running (do not use Apache 2.x f= or Windows, at least for production servers).
This section will guide you through the following steps:
Known issue with running PHP5.3 on MySQL: Some Windows =
users with both IPv4 and IPv6 installed experience problems connecting to t=
he database server using host names like "localhost"... If you experience p=
roblems, try using IPv4 address like "127.0.0.1". This is due =
to a connectivity problem when running PHP5.3 on MySQL. So, please replace =
the database server name "localhost" with the IP address of th=
e machine, or "127.0.0.1", which is reserved for the local hos=
t.
A database must be created before running the setup wizard. The followin= g text explains how to set up a database using either MySQL or PostgreSQL.<= /p>
Log in as the root user (or any other MySQL user that has the CREATE, CR= EATE USER and GRANT OPTION privil= eges):
mysql --host=3D<mysql_host> --port=3D<port> -u <mysql_u= ser> -p<mysql_password>=20
Note that if MySQL is installed on the same server, the "--host" parameter can be omitted. If the "--port" parameter is o=
mitted, the default port for MySQL traffic will be used (port 3306).
The MySQL client should display a "mysql>" prompt.
Create a new database:
mysql> CREATE DATABASE <database> CHARACTER SET utf8;= =20
Grant access permissions:
mysql> GRANT ALL ON <database>.* TO <user>@<ezp_host= > IDENTIFIED BY '<password>';=20
Note that if the specified user account does not exist, it will be creat= ed.
| Reference | Description |
|---|---|
| <mysql_host> | The hostname of the MySQL database server. |
| <port> | The port number that will be used to connect to = the MySQL database server. |
| <mysql_user> | The MySQL user (if no user is set up, use "root"= ). |
| <mysql_password> | The password that belongs to the <mysql_user&= gt;. |
| <database> | The name of the database, for example "my_new_da= tabase". |
| <user> | The username that will be used to access the dat= abase. |
| <ezp_host> | The hostname of the server on which eZ Publish w= ill be running. (may be 'localhost' if MySQL is installed on the same serve= r). |
| <password> | The password you wish to set in or= der to limit access to the database. |
Log in as the postgres user (or any other PostgreSQL user that has suffi= cient privileges to create = roles and databases):
psql -h <psql_host> -p <port> -U <psql_user> -W=20
Note that if PostgreSQL is installed on the same server, the "-h" parameter can be omitted. If the "-p" parameter is omit=
ted, the default port for PostgreSQL traffic will be used (in most cases, p=
ort 5432).
The PostgreSQL client will ask you to specify the password that belongs =
to the <psql_user>. If the password is correct, the clie=
nt should display a "<psql_user>=3D#" prompt.
Create a new database:
postgres=3D# CREATE DATABASE <database> ENCODING=3D'utf8';= =20
Create a new user:
postgres=3D# CREATE USER <user> PASSWORD '<password>';=20
Grant access permissions:
postgres=3D# GRANT ALL PRIVILEGES ON DATABASE <database> TO <= user>;=20
Import the "pgcrypto" module into = the new database:
postgres=3D# \c <database> <database>=3D# \i '<path_to_pgcrypto>'=20
| Reference | Description |
|---|---|
| <psql_host> | The hostname of the PostgreSQL database server.<= /td> |
| <port> | The port number that will be used = to connect to the PostgreSQL database server. |
| <psql_user> | The PostgreSQL user (if no user is set up, use "=
postgresql"). |
| <database> | The name of the database, for example "my_=
new_database". |
| <user> | The username that will be used to access the dat= abase. |
| <password> | The password you wish to set in order to limit a= ccess to the database. |
| <path_to_pgcrypto> | The path to the "pgcrypto.sql" file=
, for example "C:\\Program Files\\PostgreSQL\\8.2\\share\\contrib\\pg=
crypto.sql". |
The latest community version of eZ Publish can be downloaded from http://share.ez.no/downloads.
Use your favorite utility to unpack the downloaded eZ Publish archive to= a web-served directory (a directory that is reachable using a web browser)= . The extraction utility will unpack eZ Publish into a subdirectory called = "ezpublish-5.x.y". Feel free to rename this directory to something more mea= ningful, for example "my_site".
To be able to run eZ Publish 5 correctly, assets need to be exposed in t= he public 'web' folder.
The following commands will first symlink eZ Publish 5 assets in "Bundle= s" and the second will symlink assets (design files like images, scripts an= d css, and files in var folder) from eZ Publish Legacy
cd /<ezp5-root> php ezpublish/console assets:install --symlink web php ezpublish/console ezpublish:legacy:assets_install --symlink web php ezpublish/console assetic:dump --env=3Dprod web=20
Note: In both cases "web" is the default folder and can=
be skipped from the command. Further information about alternative options=
is available with -h just like it is with "php ezpublish/c=
onsole -h".
Note: On windows, you will need an elevated pr= ompt, which means you will need Administrator privileges for the symli= nk command to work.
For help on how to set up a virtual host and rewrite rules on IIS, you w= ill find some information on the community website (e.g. in this forum thread).
Warning regarding APC
If you are planning to use APC to speed up your site, please be sure to = check the available notes here, before entering the setup wizard chapter.
The setup wizard can be started using a web browser immediately after th=
e previous steps (described in this section) are completed. It will be auto=
matically run the first time someone tries to access/browse the index.php f=
ile located in the eZ Publish directory. Let's assume that we are using a s=
erver with the hostname "www.example.com" and that after unpac=
king, the eZ Publish directory was renamed to "my_site".
You can choose between a Virtual Host based configuration, or a non Virtual Host config= uration by using an .htacc= ess file.
If eZ Publish was unpacked into a directory called "my_site=
" under the document root, the setup wizard can be initiated by browsing th=
e following URL: http://www.example.com/my_sit=
e/index.php.
Refer to "The setup wizard" section for a detailed description of the web based setup wizard.