Skip to the content
Documentation
Version 6.x Supported

The setup wizard

Written by Graham Brookins, Updated by Graham Brookins Maintainers: Geir Arne Waaler, André Rømcke, Andrea Melo, Ricardo Correia, Graham Brookins
No ratings yet

The setup wizard is the installer of Exponential 6 in the browser. It checks the machine, asks one page of questions per step and then creates the site. It is the easiest way to a first install; for repeatable installs use the kickstarter (Automated installation) or one console command (Normal installation), which run the same steps.

Start it

settings/site.ini ships with [SiteAccessSettings] CheckValidity=true. While it is true, every request goes to the setup wizard instead of the site; the last step writes CheckValidity=false into settings/override/site.ini.append.php. So: get the code (Installation), serve the installation root with a web server, and open its address in a browser. For a test on your own machine, Velocity's php engine is enough:

php bin/php/console exp:velocity start --engine=php
# then open http://localhost:8087/ in a browser

While the wizard runs, only the browser that started it gets through; every other visitor sees "The site is being set up" (HTTP 503). The hold ends with the wizard's last page, or 30 minutes after its last request. If a kickstart.ini is in the installation root, the wizard reads it: steps with Continue=true are skipped and the others are pre-filled. Move it away to answer every page yourself.

The pages

Page What to enter
Welcome Nothing; continue.
System check The critical tests: directory permissions, PHP version, a database extension, image conversion, memory limit, execution time, allow_url_fopen, sessions, file uploads, zlib, dom, iconv, mbstring, intl, xsl, the time zone and the Zeta Components. Each problem comes with its fix, for permissions the exact chmod and chown commands. Fix and press Next.
System finetuning Optional tests (curl, GD, ImageMagick, the other database extensions, TrueType text functions, open_basedir). Fix and press Finetune, or press Next.
Outgoing Email Sendmail/MTA, or SMTP with server, user and password (on Windows only SMTP).
Choose database system SQLite is listed first and preselected; then the other systems whose PHP extension is loaded.
Database initialization Server, port, database name, user, password, socket. For SQLite only the file name, kept in var/storage/sqlite3/.
Language support The primary language and any additional languages.
Site package The site package to install; the bundled one is preselected.
Package language options Shown when the package has languages you did not choose: create, map or skip each.
Site access configuration How the siteaccesses site, admin and editor are told apart: by URL path, by port or by host name.
Site details Title, URL, the path, port or host of each siteaccess, and the database. When the database already holds tables, choose what to do with them: remove existing data, leave it and add new, or leave it and do nothing.
Site administrator First name, last name, e-mail and password of the admin user: at least 10 characters.
Site security Shown when the site does not run in virtual host mode: copy the rewrite rules with ./console exp:setup:htaccess --apply (or cp .htaccess_root .htaccess).
Registration A page about the community; nothing to enter, nothing is sent.
Finished After the site is created (this can take a few minutes): the addresses of the public, admin and editor sites, and the user name admin.

The wizard logs its progress to var/log/setup.log. In its last step it also writes the cron job into the crontab of the user that owns the installation directory; check with php bin/php/console exp:installcrontab --show.

When the site creation fails

The page "Creating sites" lists coded errors, for example EZSW-005 (the database connection failed) or EZSW-041 (the site package could not be fetched). var/log/setup.log holds the details. Fix the cause and press Retry; with a database server, choose to remove the existing data so half-written tables are replaced.

When the server reaches the internet only through a proxy, set it before downloading the site package, in settings/override/site.ini.append.php:

[ProxySettings]
ProxyServer=http://proxy.example.com:3128
User=
Password=

Restart a wizard that stopped

  • If another browser gets "The site is being set up", wait 30 minutes after the last wizard request, or end the hold: php bin/php/maintenance.php status, then php bin/php/maintenance.php off.
  • To run the wizard again on an installed site: back up the database, settings/override/ and settings/siteaccess/, set CheckValidity=true in settings/override/site.ini.append.php, clear the INI cache (php bin/php/ezcache.php --clear-tag=ini), restart Velocity if it serves the site, and open the site.

Screenshots of the pages are not included here. The installation book describes every field, its checks and what it writes: The setup wizard. After the install: sign in as admin and change the password (Installation), and set up the web server (Virtual host setup).

The reader comments below this page were written for the setup wizard of the eZ Publish era and are kept as they were.

In this section

Contributors

Comments (22 historical)

Written by readers of the earlier documentation sites, kept as they were.

  1. Access to User and Admin site

    Nish ·

    Hello,
    I missed to save the page or note down URL of USER SITE and ADMIN SITE. How can I access them now?
    Thanks,

  2. dont exist

    Sergio ·

    ... to restart the installation wizard after its successful finishing by specifying "CheckValidity=true" in the "settings/override/site.ini.append.php" file so that the setup wizard will be initiated when trying to access the site-
    Exactlly, this is my problem, my Ez installation is succesfully but when i access to home, the installation wizard start another time.
    In my ftp dont exist this file settings/override/site.ini.append.php
    ¿?¿?¿?¿?¿?¿?¿? what can i do ?¿?¿?¿?¿?¿?
    thanks
    congratulations by this excelent cms-

  3. help

    hor ·

    hello
    i unzipped ez files into an directory of my pesonal site, this directory is called ez
    i called the url http://www.hor848.com/ez/index.php (hor848.com is my personal site)
    and i've got:
    Parse error: syntax error, unexpected ',', expecting '(' in /web/htdocs/www.hor848.com/home/ez/index.php on line 121
    someone kow why??
    many many thx

    1. Re: help

      Meier ·

      I received the same error and found out that i used PHP 4, so i updated to PHP5.
      This solved the problem!

  4. Database

    Sam ·

    My host is 1and1. I have several mysql databases. My problem is, on the database initialization, i'm not asked which database to use i.e:
    Servername:
    Port:
    Username:
    Password:
    Socket (optional):
    database: <<<<<<(missing)
    So when i get to the stage of site access, i'm presented my username as the database of choice. For my, the Username & Database name are different.
    As a result, i can't install exponential.
    How can i resolve this problem?

    1. Re: Database

      Svitlana Shatokhina ·

      Step 5 ("Database initialization") is where you tell the wizard how to connect to the database server. The wizard will display the available databases and suggest you to choose one during step 9 ("Site details").

      1. Re: Re: Database

        Michael ·

        I get the same error when choosing either MySQL or MySQL Improved... does not look like the instructions.

  5. AcceptPathInfo On

    Antun Basic ·

    I have started to install Exponential on to my host server. When set english as default language i go to next step i get error notice:
    You need to enable AcceptPathInfo in your Apache config file, if you're using apache 2.x. If you're running apache 1.3, Exponential will not run in CGI mode.
    Check the Apache documentation, or enter the following into your httpd.conf file.
    AcceptPathInfo On
    My host has Apache 2.x but i can't edit httpd.conf file because i don't have access to it. I got answer from my host provider that i can do the same thing with .htaccess file but i do not know how to do that. I have tried all the options already and now i ask you for help!
    Thank you

  6. Install Error

    Shishir ·

    I am getting the error below after clicking on last screen where data is inserted in MySQL and site is initialized. When I click on refresh after this error, I get 2 errors -
    EZSW-004
    Failed inserting data to mysql
    Table 'ezapprove_items' already exists
    EZSW-040
    Failed to initialize site package 'ezwebin_site'
    Error I get after providing all details and passing through the installation steps.
    ========================================================
    Server error!
    The server encountered an internal error and was unable to complete your request.
    Error message:
    Premature end of script headers: php-fcgi-starter
    If you think this is a server error, please contact the webmaster.
    Error 500
    creditacademy.info
    Tue Dec 23 15:50:00 2008
    Apache

    1. Re: Install Error

      quieldeguzman ·

      Same problem here. Did you already come up with the solution for this?

  7. site details

    luis monteiro ·

    i am having troubles on instalation:
    Warning
    The database [monteiro_portal] cannot be used, the setup wizard wants to create the site in [utf-8] but the database has been created using character set [iso-8859-1]. You will have to choose a database having support for [utf-8] or modify [monteiro_portal] .
    What do I have to do?

    1. Re: site details

      Alex ·

      I have the same problem here. I installed MySQL administrator and can't connect to database.

      1. Re: Re: site details

        eCristian ·

        The same on me ""the setup wizard wants to create the site in [utf-8] but the database has been created using character set []. "

  8. Where can I find the admin interface ??

    Cesar ·

    In Site details i write:
    Tittle : My Site Name
    Site URL : http://www.MySiteName.com
    User Path: my_site_name
    Admin Path: my_site_Name_admin
    But In Finished I see:
    URL: User Site (Link=Eng) Admin site (Link= my_site_name_admin)
    The links go nowhere.
    Try the URL given in an answer above (Try - Log in to the administration interface of eZ publish: http://mysite.com/intranet/index.php/plain_site_admin), with the word "intranet" and it is not. But I can not log in to the administration interface of eZ publish.
    Where can I find the admin interface : http://ez.no/var/doc/storage/imag...r/14645-3-eng-GB/view_folder_doc.png
    Please help.
    Thanks

  9. Database Initialization Error

    Masoud ·

    Server: hosted
    Port: 3306
    Type: MySQL
    When adding the database details, I get the following error message:
    Fatal error: Class 'ezcBaseOptions' not found in /homepages/46/d218878200/htdocs/iranbusinessjournal/kernel/private/options/ezpextensionoptions.php on line 54
    Fatal error: Exponential did not finish its request
    The execution of Exponential was abruptly ended, the debug output is present below.
    I have tried this with Improved MySQL and had same error message!
    Any idea?

  10. db utf error

    iamageneralist ·

    I am getting an error that indicates "the setup wizard wants to create the site in [utf-8] but the database has been created using character set [iso-8859-1]" however in my db manager console it indicates "MySQL charset: UTF-8 Unicode (utf8)" which would seem to indicate I have it set up the way it is supposed to be but ez is not recognizing it. I have tried both the MySQL and the MySQL improved options and they both get stuck on this same error.

    1. Re: db utf error

      Jure ·

      Same here. And i have utf-8 db.

  11. Site Security htaccess message

    Dante ·

    Here is what I get:
    Site security
    Your site is not running in a virtual host mode, this is insecure. It is recommended to run Exponential in virtual host mode. If you do not have the possibility to use virtual host mode, you should follow the instructions below about how to install an .htaccess file. The .htaccess file tells the web server to restrict the access to certain files.
    If you have shell access, you can run the following commands.
    cd /hsphere/local/home/dante22e/givespamachance.com/spamville
    cp .htaccess_root .htaccess
    If you do not have shell access, you will have to copy the file using an FTP client or ask your hosting provider to do this for you.
    ----
    help.
    My web hosting service is useless and I can't understand what to do. I have WebShell editor to play with the files/folders.

    1. Re: Site Security htaccess message

      Dante ·

      LOL did I just post info that can harm me? I'm tired. I wonder if the comments above can be deleted? admin?

  12. Installation Error

    Mohd ·

    Hello
    I uploaded ALL file of eZ publish 4.3 to my host server.
    when I start the installation i get the following:
    Fatal error: Class 'eZPersistentObject' not found in /home/training/public_html/ez/kernel/classes/ezsection.php on line 37
    Fatal error: Exponential did not finish its request
    The execution of Exponential was abruptly ended, debug information can be found in the log files normally placed in var/log/*
    Any comments!

Comments

Add a comment

Comments are read by a moderator before they appear.