The setup wizard

These documentation pages are no longer maintained. Please visit the new documentation site.

This section will guide you through and explain the various steps of the setup wizard.

The setup wizard is designed to automate the initial setup and configuration of a fresh Exponential installation. It can be started using a web browser immediately after that the necessary installation steps (described in the previous sections) are completed. The setup wizard will be automatically run the first time someone tries to access/browse the "index.php" file located in the Exponential directory.

The back button can be used to jump back to previous steps in order to modify settings. The setup wizard does not store or modify any data before the final step; thus, it can be safely restarted by re-browsing the "index.php".

Once the setup wizard is finished (all steps are completed), Exponential will not run it again when the "index.php" file is browsed. However, the wizard can be re-activated by changing the "CheckValidity" setting in the "settings/override/site.ini.append" file from "false" to "true".

A typical setup cycle consists of 11 steps:

1. Welcome page
2. System check
3. Outgoing E-mail
4. Database initialization
5. Language support
6. Site templates
7. Site access configuration
8. Site details
9. Site security
10. Site registration
11. Finish

Please note that some of the pages will be omitted during a bundled installation process. This is because some settings are already predefined in the bundled installations.

Welcome

This is the initial page of the setup wizard. By clicking "Next", the wizard will either jump to the "System Check" page (if some things need to be fixed) or the "Outgoing E-mail" page (if everything is okay).

System check

This page usually appears if some critical issues/problems were detected. It will displays information about important things that need to be fixed (and how to fix them) before the setup wizard can continue.

Issues
There may be several issues/problems, numbered and described within a section on the page. A suggestion to each problem is presented below the description of the problem itself. The setup guide will probably suggest that you run a couple of shell commands (in order to fix permissions, etc.). These commands must be executed within a system shell, where the current working directory is the Exponential directory. From the setup wizard page: simply copy & paste the commands into the shell. The system check will be re-run when the "Next" button is clicked.

Ignoring tests
Some issues/problems may be ignored using a checkbox labelled "Ignore this test". However, it is recommended to fix all issues rather than ignoring them.

Outgoing E-mail

The Exponential system uses E-mail to send out notices such as user registration and content approval. This section is used to configure how Exponential delivers its outgoing E-mail.

There are two options:
- Direct delivery through sendmail (must be available on the server).
- Indirect delivery using an SMTP relay server.

On Linux/UNIX: try to use sendmail, if unavailable: fall back to SMTP.
On Windows: use an SMTP server.

Sendmail:
Mail is delivered directly using the sendmail transfer agent. The sendmail binary is usually available on most Linux/UNIX systems. If sendmail is not available then SMTP should be used.

SMTP:
Mail is delivered through an SMTP server. At the minimum, the hostname of the SMTP server must be specified.

Database initialization

The setup will automatically detect database-support that has been compiled into the PHP scripting engine. If both MySQL and PostgreSQL is supported, the user will be able to choose one of these using a set of radio buttons (not shown in the screenshot above).

Information about the hostname of the server running the database engine, and a username/password combination needs to be provided. When clicking "Next" and if MySQL is used, the setup wizard will attempt to connect to the database. The setup will only continue if it is able to connect to the specified MySQL server with the specified username/password combination. PostgreSQL parameters are tested at a later stage during the setup wizard.

Language support

The Exponential system supports multiple languages. This step in the setup wizard allows the user to choose the primary language and additional languages for the site(s) being installed. The selected languages are used when displaying the administration interface, to determine character sets, date / number formats, etc. Only one primary language can be used. However, it is possible to use several additional languages. Additional languages may also be installed at later point (when the site is up and running). The radio buttons are used to choose the primary language, the checkboxes are used to choose additional languages.

Site templates

This step allows the user to install multiple sites. There are seven demonstration sites and a plain site. The plain site should be used when starting from scratch. The demonstration sites are examples that can be easily extended and built upon. They contain some artwork (images), CSS code and Exponential specific template files. Each site is unique, which means that each site needs its own database.

Site access configuration

The access method determines how the site(s) will be accessed from within a web browser. There are three options:

- URL
- Port
- Hostname

URL
This is the default and recommended setting. The different sites are accessed using a specific notation in the URL. This is done by inserting some text right after the "index.php" part of the URL. Example:

http://www.eaxmple.com/index.php/admin
http://www.example.com/index.php/user

Port
A port number is appended to the hostname of the web server, the port number determines which site to display/access. Example:

http://www.example.com:80
http://www.example.com:81

This option requires additional changes to the configuration file of the web server.

Hostname
Each site is assigned a unique hostname and can be accessed using that specific hostname. Example:

http://admin.example.com/
http://user.example.com/

This option requires changes on the DNS server.

Site details

This step allows the user to modify site specific things like the name of the site, which database to use, etc. At the minimum, a database must be chosen for each site that is being installed. The available databases will be displayed in the "Database:" dropdown box(es). The "Refresh" button can be used to update the list(s) (if a database is being created at this point).

If one or more of the databases already contain some data, the "Site Details" page will reappear and ask what to do. Possible actions are:

- Leave the data and add new
- Remove existing data
- Leave the data and do nothing
- I've chosen a new database

The last option is to be used when another database is chosen.

Site security

This step suggests some basic modifications that should be carried out in order to secure the site(s) being installed. The suggested security tweaks basically deny access to the configuration files. It is important to either install the .htaccess file or set up Virtual Host Mode access; or else the site(s) will be vulnerable.

Site registration

It is possible to register the Exponential installation. This can be done automatically from within the setup wizard, which will send an E-mail to 7x. No confidential data will be transmitted and 7x will not misuse or sell these details. The information is used internally for statistics and improvment of Exponential. Typical things that will be sent:

- System details (OS type, etc)
- The test results
- The database type
- The site name
- The url of the site
- Languages chosen

 

Finish

This is the last page of the setup wizard. The sites you've chosen to install have been installed. The different sites (and their respective user and administration sections) can be reached through the URLs shown on this page. It is a good idea to store the information displayed on this page.

Reactivating Setup Wizard

If for any reason you want to setup your site from scratch, you can do so by changing the value of Checkvalidity setting to true

[SiteAccessSettings]

CheckValidity=true

in file settings/override/site.ini.append.php.

Comments

exponential-3.9.3

I have error when I try to install exponential-3.9.3. How to fix this using shell commends:
Fatal error: Allowed memory size of 67108864 bytes exhausted (tried to allocate 18000 bytes) in /home/damian/domains/site.com/public_html/site/lib/ezi18n/classes/ezchartransform.php on line 296
Fatal error: Exponential did not finish its request

The execution of Exponential was abruptly ended, the debug output is present below.

-

-

Error before installation

I download latest version and try to install.
But install didn't start and I recive error -

....
Fatal error: Exponential did not finish its request

After discovering your code I found this line :)
file:
lib/eztemplate/classes/eztemplatefileresource.php
line ~250

was:
$text = file_get_contents( $path );
change to:
$text = eZFile::getContents( $path );

And it start work fine :)

Error after Instalation

After goig thru all the instalation process whem I am about to access either User site, Admin site I get the following message:

Fatal error: Maximum execution time of 60 seconds exceeded in c:\exponential\exponential\lib\ezxml\classes\ezxml.php on line 271
Fatal error: Exponential did not finish its request

The execution of Exponential was abruptly ended, the debug output is present below.
I tried changing the file ezxml.php by other versions and the oonly change I obtain is on the line number. If someone knows how I could troubleshoot this problem help!!! P/S I got this same problem after going thru the installation process on three diferent PC s. 2 with Windows XP and the other one with Windows 2000.

Class ezmail error

I get the following error when I click "next" at the "Site Administrator" (78%) section. Any ideas?

Luke

Fatal error: Undefined class name 'ezmail'
in /home/pixeldis/public_html/exponential/kernel/setup/steps/ezstep_site_admin.php on line 90
Fatal error: Exponential did not finish its request

The execution of Exponential was abruptly ended, the debug output is present below.

Postgresql install must have pgcrypto (postgresql-contrib package)

If you will use postgresql, your machine MUST have pgcrypto (and its digest function) installed (at least for exponential 3.5.0).
See
http://ez.no/exponential/documenta...varying_does_not_exist_on_postgresql
Regards.
Andre Felipe Machado

Postgresql sockets connection instead of TCP/IP

If you have to connect to Postgresql server using sockets instead of TCP/IP, and you are using the Exponential 3.5.x , you should leave "servername" field BLANK.
If you use localhost, ip, or some domain name, Exponential will try to connect using tcp/ip.
This hint could be included in documentation and the setup wizard screen.
Regards.
Andre Felipe Machado

Failure in last step: "Finished" page times out -- a possible solution

During the last stage, a lot of processing towards configuration is being performed. Whenever this isn't going to succeed and a timeout (usually after 30 seconds or so) occurs, it's best to redo the installation but now in a minimal mini config: don't add translations in step "Language Support", use 'plain template' in step "Site Templates" and don't send site registration data. This might reduce the installation time below the time out limit.

In general, the creation of the database has been performed succesfully. Still, if some installation steps seem to be performed with errors, redo these manually as described in the documentation (manual installation). Take special notice of the creation of your site specific directories (settings/siteaccess/<yoursite>/, settings/siteaccess/<yoursite>_admin/ and settings/override/, where <yoursite>=plain in case of the plain site selection), and the related chown and chmod of these as well as the /var directories, as mentioned in the manual installation guide.

Follow the golden KISS rule and gradually increase complexity. Don't take one step further as long as the current step seems to misbehave.

Re-run Instructions Don't Work

While I appreciate that you have added information to text on how to re-run the configuration wizard, those instructions don't work. It seems everyone (including myself), gets a timeout error when trying to re-run the wizard.

I cannot login when I finish install

I install exponential 3.4.1 successfully.After that,I run admin interface but I cannot login. I also used the default username(admin) and password(publish) but it didn't work.
I tried signup a new account but it didn't work too.

how can I login as administrator in admin interface, please help me...
thanks

Suggested changes

Hi,
@7x: Please update this page with the current 3.4.x install wizard, as this is a bit new (and very nice).
@all: If you have problems with installing Exponential, please use the Forums (in "Community") to ask questions or post problems.
@ez, again: Please remove all comments, that are "done", such as the ones about reactivating the install wizard (it's in the text now). I also suggest, that you put my hint to the installation forum somewhere on this page, or it will consist of lot's of installation problem posts soon. (and yes, remove this comment, too, if you like).

help !! ive almost finished the installation when i received the following error

Fatal error: Call to a member function on a non-object in /home/judea/public_html/ez/kernel/classes/ezcontentobjectversion.php on line 912
Fatal error: Exponential did not finish it's request

The execution of Exponential was abruptly ended, the debug output is present below.


if anyone knows how to fix please post or email me at info@defendisrael.net

this screen pops up right after i click on the registration

Database Initialization wizard at set up

Database will not initialize despite all server, username & password details being correct and checked via mysql monitor. Can anyone tell me best way to find out why this is?

Use Wizard to Create Additional Sites

Is it possible to use the wizard to create additional sites for a single Exponential installation? My intuition is that it is possible, but I thought I'd post here to see if anyone has any specific instructions on how to do this.

Ted Stresen-Reuter

Help

http://geoff.rhsforum.com/exponential

What is wrong? All thought i had to do was upload "Exponential" into my directory, what else do I need to do? I already have PHP and MySql, do I need to make a new database?

Please help!

An error occured while loading http://localhost/exponential/:

I get to the end, using the wizard, but then I get this message

An error occured while loading http://localhost/exponential/:

Connection to host localhost is broken.

What could I be doing wrong?

Help me please!!!

Fatal error: Call to a member function on a non-object in /home/willburn/public_html/kernel/classes/ezpackage.php on line 1884
Fatal error: Exponential did not finish it's request

The execution of Exponential was abruptly ended, the debug output is present below.

can anybody help me with this?

Error message

I'm also getting the error message:

>> Fatal error: Maximum execution time of 30 seconds exceeded in /var/www/html/lib/ezi18n/classes/ezcharsetinfo.php on line 64
>> Fatal error: Exponential did not finish it's request
>>
>> The execution of Exponential was abruptly ended, the debug output is present below.

And it's not running on a P166 ;-), but a P2,4GHz 512MB RAM so the system should be ok.

I get this message when I try to access one of the sites at the end of the installation wizard.

Re: problems

Hi,

What kind of hardware are you running Exponential on? Sounds like you're trying to run it on a P166 or something.

Balazs

problems

Fatal error: Maximum execution time of 60 seconds exceeded in /hsphere/local/home/nicolays/patrick.lye.no/lib/eztemplate/classes/eztemplate.php on line 1456
Fatal error: Exponential did not finish it's request

The execution of Exponential was abruptly ended, the debug output is present below.


can anybody help me with this?

Contents

Installation

Normal installation
Bundled installation
Manual installation
The setup wizard
The cronjob script
Virtual Host setup
upgrading
Adding extensions
removing exponential


Created

17/09/2003
10:59:04 am
by Balazs Halasy

Last updated

16/03/2004
1:21:42 am
by liu spider

Authors

Balazs Halasy
liu spider



This page is part of the Exponential documentation. The documentation is available under the GNU Free Documentation License. All contributions will be released under the terms of this license.