Changes between Initial Version and Version 1 of doc/install/auth-server

Show
Ignore:
Timestamp:
01/23/06 00:49:36 (14 years ago)
Author:
benoitg
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • doc/install/auth-server

    v1 v1  
     1= Wifidog Portal installation = 
     2 
     3'''Work in progress'''. More to come : informations, details, tips, debug, screenshots, allouette ! 
     4 
     5The term '''Auth-server''' and '''portal''' are used in this guide and mean the same thing. 
     6 
     7---- 
     8 
     9== Requirements == 
     10 
     11=== PHP5 === 
     12 * A working web server with PHP5. Apache httpd server is recommended. Using a virtual host is also a good idea. 
     13 * Needed Extentions      : '''pgsql''', '''dom''' and '''mbstring''' 
     14 * Optional Extentions    : '''xml''', '''gettext''', '''mcrypt''', '''mhash''' and '''xmlrpc''' 
     15 * PEAR Extentions        : '''radius''', '''Auth_RADIUS''' and '''Crypt_CHAP''' 
     16 * Additional PHP library : '''Smarty''', '''MagpieRSS''' and '''Phlickr''' 
     17 
     18It is highly recommended to install optional extentions to activate all features of the portal. If you are not sure which extentions are installed, '''install.php''' will detect all of them and display usefull informations to help you. The additional PHP library will be automatiqualy downloaded and installed by '''install.php''' (if you want them). 
     19 
     20=== PostgreSQL === 
     21 
     22A properly configure PosgreSQL server. The '''install.php''' script does not apply any special security methods to the Posgresql database server. It is the system administrator's job to grant the right permissions databases access. 
     23 
     24== Quick Install == 
     25 
     26 1. Retreive Wifidog Auth-Server sources from CVS (see [wiki:Download]) 
     27 1. In your favorite web browser open http://server.com/wifidog/install.php and follow instructions to the end. 
     28 1. Set language in config.php 
     29 1. Log in as admin and fill network information, create hotspots and content. 
     30 
     31== Download the sources == 
     32 
     33Please go the [wiki:Download] page and follow instructions to retreive the portal sources. 
     34 
     35== install.php == 
     36 
     37=== Introduction === 
     38 
     39Also '''install.php''' is not doing all it might do to help an easy installation (missing language and radius configuration). But it will quickly give you a working portal and you will be able to login as an administrator and customize your network, hotspot, content, users, etc. 
     40 
     41Firstly, you need to open '''install.php''' in your browser. If try another portal page and the auth-server was not previously configured, your browser will be redirected automaticaly to '''install.php''' (detected by smarty missing files). 
     42 
     43http://www.ilesansfil.org/dist/pascal/images/install/01-welcome.png 
     44 
     45Follow the instructions on the page to create the wifidog user and database. The command use are at the command line. You can use another way to do this (like [http://phppgadmin.sourceforge.net phpPgAdmin]) 
     46 
     47The first time you open '''install.php''', the script will generate a random password in the file '''/tmp/dog_cookie.txt'''. This is only a small security control to disallow remote user to do bad things with fresh auth-server install. The file will will only be the random password, no username are needed. 
     48 
     49=== Version === 
     50 
     51TODO text 
     52 
     53http://www.ilesansfil.org/dist/pascal/images/install/02-version.png 
     54 
     55=== Permission === 
     56 
     57This page detect missing files or missing write permissions. It will give you tips by generating command line to execute to solve these issue (mkdir and chmod command). The command are only generated to help the user and are not the only issue to solve permissions errors. 
     58 
     59The navigation buttons (Back and Next) will be available only if the permissions are ok. Hit the Refresh button to update the page status after you did your changes. 
     60 
     61http://www.ilesansfil.org/dist/pascal/images/install/03-permission.png 
     62 
     63=== Smarty === 
     64 
     65Smarty is needed by the auth-server, you are not allowed to skip this installation ... click Next 
     66 
     67http://www.ilesansfil.org/dist/pascal/images/install/04-smarty.png 
     68 
     69=== MagpieRSS === 
     70 
     71Depending on your needs, MagpieRSS can be installed or not. It's recommended to install it to activate all features of the portal. 
     72 
     73http://www.ilesansfil.org/dist/pascal/images/install/05-magpie.png 
     74 
     75=== Phlickr === 
     76 
     77Depending on your needs, Phlickr can be installed or not. It's recommended to install it to activate all features of the portal. 
     78 
     79=== Database access === 
     80 
     81TODO : screenshot + text 
     82 
     83 * Fill in informations 
     84 * Test connection 
     85 
     86=== Database initialisation === 
     87 
     88TODO : screenshot + text 
     89 
     90 * Create DB schema 
     91 * Fill in initial DB data 
     92 * Upgrade schema if needed 
     93 
     94=== Options === 
     95 
     96TODO : screenshot + text 
     97 
     98=== Languages === 
     99 
     100Not yet implemented. Coding in progress ... 
     101 
     102=== Radius === 
     103 
     104Not yet implemented ... 
     105 
     106=== Admin account === 
     107 
     108TODO : screenshot + text 
     109 
     110By clicking '''Next''' you will be redirected to your Wifidog portal page. 
     111 
     112=== Debugging === 
     113 
     114 * Direct page access (Table of content) : http://server.com/install.php?page=toc 
     115 * !PhpInfo : http://server.com/install.php?page=phpinfo 
     116 
     117---- 
     118 
     119== TODO == 
     120 
     121Information to Add on : 
     122 * Installation debugging (install.php) 
     123 * Postgresql access configuration 
     124 * Google Map 
     125 * DB backup 
     126 * DB optimization 
     127 * PHP tuning ? 
     128 * MySQL ? 
     129 * Auth-server Admin quick configuration (Network name, support email, etc) 
     130 * PHP config file (php.ini) recommended settings