[[http://www.noahsclassifieds.org|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. [[configuration:permissions|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.