Changes between Version 10 and Version 11 of doc/install/debian/auth-server

Show
Ignore:
Timestamp:
12/12/06 11:45:32 (11 years ago)
Author:
pascal.charest@…
Comment:

a bit clearer

Legend:

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

    v10 v11  
    55December 11th, 2006 - This document is currently a draft and not completed! There might be a lot more package that is really required in the "prerequisites" section.  
    66 
    7 = Step-by-step instructions = 
    8  
    9  
    10 == Install the distro == 
     7 
     8= Install the distro = 
    119A minimum install without any specific package is enough, as long as you have internet access and apt installed. 
    1210 
    1311 
    14 == Install prerequisites == 
     12= Install prerequisites = 
    1513Before we install anything lets be sure we have access to internet and that our apt database is updated 
    1614{{{ 
     
    2321}}} 
    2422 
    25 It also require a database server. PostgreSQL 8.1 and 7.4 are available. 8.1 is harder to configure but faster. The how-to for 8.1 is not finished. 
     23 
     24= Database server install = 
     25 
     26It also require a database server. PostgreSQL 8.1 and 7.4 are available. 8.1 is harder to configure but faster on current computer. The how-to for 8.1 is not finished so I guess you will have to stick with postgresql-7.4. If you install 8.1, going back to 7.4 won't be as easy as installing a direct installation of 7.4. 
     27 
    2628{{{ 
    2729apt-get install postgresql-8.1 
    2830}}} 
     31 
    2932or 
     33 
    3034{{{ 
    3135apt-get install postgresql-7.4 
     
    3337 
    3438 
    35 == PostgreSQL 8.1 configuration file == 
    36  
    37 It will crash at install, you must then do some tricky configuration 
     39== Configure PostgreSQL 8.1 == 
     40 
     41If you selected postgresql-8.1, it will crash at install. You must configure postgresql.conf before being able to launch the services.  
    3842{{{ 
    3943nano /etc/postgresql/8.1/main/postgresql.conf 
    4044}}} 
    41 and change: 
     45 
     46This isn't a good security setting, you should make sure to configure the whole thing later on! Right now, you need, at least to change:  
    4247{{{ 
    4348#listen_addresses='localhost' 
    44 }}} 
    45  
     49SSL = true 
     50}}} 
    4651for 
    47  
    4852{{{ 
    4953listen_addresse='*' 
    50 }}} 
    51  
    52 NOTE: this is not a good security setting, you should make sure you change that later on!  
    53  
    54 == Install prerequisites - step2 == 
     54SSL = false 
     55}}} 
     56 
     57 
     58== Configure PostgreSQL 7.4 == 
     59You will have to change : 
     60{{{ 
     61nano /etc/postgresql/7.4/main/postgresql.conf 
     62}}} 
     63 
     64{{{ 
     65#tcpip_socket =false 
     66}}} 
     67to 
     68{{{ 
     69tcpip_socket = true 
     70}}} 
     71 
     72 
     73 
     74= Install prerequisites - step2 = 
    5575 
    5676We also need some specifics librairies 
     
    84104}}} 
    85105 
    86 == Configure PostgreSQL 7.4 === 
    87 You will have to change : 
    88 {{{ 
    89 nano /etc/postgresql/7.4/main/postgresql.conf 
    90 }}} 
    91  
    92 {{{ 
    93 #tcpip_socket =false 
    94 }}} 
    95 to 
    96 {{{ 
    97 tcpip_socket = true 
    98 }}} 
    99  
    100  
    101  
    102 == Install the auth server == 
     106 
     107= Install the auth server = 
    103108{{{ 
    104109svn checkout https://dev.wifidog.org/svn/trunk/wifidog-auth 
     
    107112 
    108113 
    109 == Apache 2 configuration file == 
     114= Apache 2 configuration file = 
    110115We need to change the document root. We take for granted that this server will be of no other "web" use... if it is, guess you'll have to learn how to configure apache2. 
    111116 
     
    126131}}} 
    127132 
    128 remove the rewrite rule around line 16 
     133remove the rewrite rule around line 17 
    129134 
    130135restart apache2: 
     
    136141 
    137142 
    138 == Configure locale in wifidog.conf ==  
    139 If you are using an english only server on which locale "ca_FR" isn't installed, you will have to change the file : 
     143= Configure locale in wifidog.conf =  
     144If you have installed locales-all and you want to keep the "french" default portal page, this step isn't needed. In other cases: you will have to change the file config.php 
    140145{{{ 
    141146nano /var/www/wifidog-auth/wifidog/config.php 
    142147}}} 
     148 
    143149on line 208 (ctrl+w+enter, ctrl+t+enter, 208) remplace 
     150 
    144151{{{ 
    145152define('DEFAULT_LANG', 'fr_CA'); 
    146  
    147153}}} 
    148154by 
     
    151157}}} 
    152158 
    153 == Configure mail server == 
     159 
     160= Configure mail server = 
    154161You need to have a valid mailer in order to mail account confirmation!  
    155162 
     
    160167Select the "internet site with smart host" configuration option and answer the next series of questions.  
    161168 
    162 == Configure the auth server == 
     169 
     170= Configure the auth server = 
     171 
     172 
    163173 
    164174Go to http://your-domaine.com/install.php and follow the instructions. They will ask to : 
     175 
     1761) First screen 
    165177 
    166178create a wifidog user in postgres 
     
    169181createuser wifidog --pwprompt  
    170182}}} 
    171 answer no to the three questions and create a db owned by this new user 
     183IF you have PostgreSQL 8.1 : answer no to the three questions 
     184IF you have PostgreSQL 7.4 : answer no to the two questions 
     185 
     186create a database owned by this new user 
    172187{{{ 
    173188createdb wifidog --encoding=UTF-8 --owner=wifidog 
     
    180195and click next in your browser (it will ask for the password in dog_cookie.txt) 
    181196 
    182 You will have to copy-paste the big serie of command, click refresh and next...  
     197 
     1982) Second screen: 
     199Verification of the installed software. If you followed this guide, you have everything install (except Radius support).  
     200 
     2013) Third screen: 
     202 
     203You will have to copy-paste the big serie of command, click refresh and next. The easiest way of doing that is if you have a ssh connection to your box (this is why I proposed openssh-server package earlier) 
     204 
     2054) Fourth screen 
    183206Click install for simplepie, then next 
    184207Click install for feedpressreview, then next 
    185  
    186 Do not install Phlickr and put your password in the next screen. 
     208Click NEXT when asked to install Phlickr (it is already installed, even if the system doesn't see it). 
     209 
     2105) Fill out your db information..