Back to the main site

install.php details

The web based install wizard of Noah's Classifieds is very simple to use - it has only three steps - and you can probably go through them without reading this detailed description. The three steps are:

  • Step 1: Checking,
  • Step 2: Setup,
  • Step 3: Install.

Step 1: Checking

In this step, the following system requirements will be checked by the install script:

  • Whether the script can create (or write if already exists) the app/config.php file. This is actually not a mandatory requirement: you can create this file yourself manually and the wizard will give you every necessary guidance to do this in the further steps, but it's still easier if the install script does it! If you get a message that the install script can't create app/config.php, and you want to fix this, you can create/upload an empty config.php file into your app directory and give it enough permissions that the script can write it. If you did it, refresh the install.php in your browser to see the effect. Click here to read more about setting file permissions!
  • It checks if MySql exists on the server. Per default, localhost is used as the MySql server. If you have the MySql on a different server, you can still install Noah's, but you must enter than the MySql host name in Step 2,
  • It tries to connect to the MySql server with the root user name and without using any password. Note that even if this succeeds, from security point of view, it is strongly recommended that you use an other database user than root and you access it with a password. You can set up the database user and password in Step 2

The wizard displays the following information on the screen in this step:

  • The results of the above checking,
  • The program terms and conditions,
  • A checkbox with which you accept the terms and conditions,
  • An Edit button that leads to Step 2 and/or an Install button that leads to Step3. The latter is only displayed if the script could access MySql with the given parameters.

Step 2: Setup

In this step, you can enter the necessary MySql database access details. Use localhost as the Hostname if MySql resides on your web server. You must enter an existing MySql user name! You can probably create new database users through the control panel of your server - read it's documentation about how to do it. If the database user you enter here has create database permissions, you can enter a new name as Database name and the install script will create it as a database then. More often, however, you must also create the database through the control panel before the installation.

If you submit this form, you will be forwarded to Step 1 again, and the database access will be tested with the just entered database access details. If the access fails, you can return to Step 2 again by clicking on the Edit button.

Step 3: Install

If the database connection could be successfully established, an Install button will be displayed. If you click on it, all the necessary database setup will be performed: the tables will be created and filled with some default data. Additionally, if the app/config.php file couldn't be created in Step 1, the program displays the content you have to copy/paste to create the config.php file manually. Because config.php stores the database access details, it is essential for the proper working of Noah's Classifieds that it exists in the app directory! Whether it is created by the install script, or by you manually, it has to be there, so that Noah's can use the database.

 
install/instructions.txt · Last modified: 2008/07/28 02:46 by admin
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki