setup/class_setupStep_Checks.inc

   1 <?php
   2
   3 /*
   4    This code is part of GOsa (https://gosa.gonicus.de)
   5    Copyright (C) 2007 Fabian Hickert
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 2 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program; if not, write to the Free Software
  19    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  20 */
  21
  22
  23 class Step_Checks extends setup_step
  24 {
  25   var $basic_checks = array();
  26   var $config_checks= array();
  27   var $is_writeable = array();
  28   var $header_image = "images/system.png";
  29
  30   function Step_Checks()
  31   {
  32     $this->update_strings();
  33   }
  34
  35
  36   function update_strings()
  37   {
  38     $this->s_title      = _("Installation check");
  39     $this->s_title_long = _("Installation check");
  40     $this->s_info       = _("Basic checks for PHP version and required extensions.");
  41   }
  42
  43
  44   /* Execute and display template */
  45   function execute()
  46   {
  47     $this->run_checks();
  48     $smarty = get_smarty();
  49     $smarty->assign("basic"       ,$this->basic_checks);
  50     $smarty->assign("config"      ,$this->config_checks);
  51     $smarty->assign("is_writeable",$this->is_writeable);
  52     return($smarty->fetch(get_template_path("setup_checks.tpl",TRUE,dirname(__FILE__))));
  53   }
  54
  55
  56   /* Execute all checks */
  57   function run_checks()
  58   {
  59     $this->basic_checks = array();
  60     $this->config_checks = array();
  61     $this->is_writeable = array();
  62
  63     /* PHP version check */
  64     $N = _("Checking PHP version");
  65     $D = sprintf(_("PHP must be of version %s / %s or above."),"4.3.10","5.2.0");
  66     $S = _("GOsa requires functionality that is not available (or buggy) in older PHP versions. Please update to a supported version.");
  67     $R = $this->check_php_version();
  68     $M = TRUE;
  69     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
  70
  71     /* Checking imap extension */
  72     $N = _("Checking for LDAP support");
  73     $D = _("This is the main extension used by GOsa and therefore really required.");
  74     $S = _("The ldap extension (php4-ldap/php5-ldap) is required to communicate with your LDAP server.");
  75     $R = is_callable("ldap_bind");
  76     $M = TRUE;
  77     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
  78
  79     /* Check for gettext support */
  80     $N = _("Checking for gettext support");
  81     $D = _("Gettext support is required for internationalization.");
  82     $S = _("Please make sure that the extension is activated.");
  83     $R = is_callable("bindtextdomain");
  84     $M = TRUE;
  85     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
  86
  87     /* Checing for iconv */
  88     $N = _("Checking for iconv support");
  89     $D = _("This module is used by GOsa to convert samba munged dial informations and is therefore required. ");
  90     $S = _("Please make sure that the extension is activated.");
  91     $R = is_callable("iconv");
  92     $M = TRUE;
  93     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
  94
  95     /* Check for installed mhash module */
  96     $N = _("Checking for mhash support");
  97     $D = _("You'll need this module to make use of SSHA encryption");
  98     $S = _("The mhash module for PHP 4/5 is not available.Please install php4-mhash/php5-mhash.");
  99     $R = is_callable("mhash");
 100     $M = FALSE;
 101     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 102
 103     /* Is imap module available */
 104     $N = _("Checking for IMAP support");
 105     $D = _("The IMAP module is needed to communicate with the IMAP server. GOsa retrieves status information, creates and deletes mail users, etc.");
 106     $S = _("This module is used to communicate with your mail server. Please install php4-imap/php5-imap.");
 107     $R = is_callable("imap_open");
 108     $M = TRUE;
 109     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 110
 111     /* Check getacl in imap module */
 112     $N = _("Checking for getacl in IMAP implementation");
 113     $D = _("The getacl support is needed to handle shared folder permissions. Old IMAP extensions are not capable of reading acl's. You need a recent PHP version to use this feature.");
 114     $S = $D;
 115     $R = is_callable("imap_getacl");
 116     $M = TRUE;
 117     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 118
 119     /* Mysql module loaded ? */
 120     $N = _("Checking for MySQL support");
 121     $D = _("MySQL support is needed to communicate with several supported databases.");
 122     $S = _("This module is required to communicate with database servers (GOfax, asterisk, GLPI, etc.). Please install php4-mysql/php5-mysql");
 123     $R = is_callable("mysql_query");
 124     $M = TRUE;
 125     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 126
 127     /* Checking for kadm5 module */
 128     $N = _("Checking for kadm5 support");
 129     $D = _("Managing users in kerberos requires the kadm5 module which is downloadable via PEAR network.");
 130     $S = _("This module is required to manage user in kerberos, it is downloadable via PEAR network");
 131     $R = is_callable("kadm5_init_with_password");
 132     $M = FALSE;
 133     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 134
 135     /* Snmp module available ? */
 136     $N = _("Checking for SNMP support");
 137     $D = _("The simple network management protocol is needed to get status information from clients.");
 138     $S = _("This module is required for client monitoring. Please install php4-snmp/php5-snmp.");
 139     $R = is_callable("snmpget");
 140     $M = FALSE;
 141     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 142
 143     /* Checking for Cups module */
 144     $N = _("Checking for CUPS support");
 145     $D = _("In order to read available printers via the IPP protocol instead of printcap files, you've to install the CUPS module.");
 146     $S = $D;
 147     $R = is_callable("cups_get_dest_list");
 148     $M = FALSE;
 149     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 150
 151     /* Checking for F ping utility */
 152     $query= "LC_ALL=C LANG=C fping -v 2>&1";
 153     $output= shell_exec ($query);
 154     $N = _("Checking for fping utility");
 155     $D = _("The fping utility is used if you've got a thin client based terminal environment.");
 156     $S = _("The fping utility is only used in thin client based terminal environment.");
 157     $R = preg_match("/^fping:/", $output);
 158     $M = FALSE;
 159     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 160
 161     /* Checking generate LM/NT password hashes */
 162     $query= "mkntpwd 2>&1";
 163     $output= shell_exec ($query);
 164     $have_mkntpwd= preg_match("/^Usage: mkntpwd /", $output);
 165     if (!$have_mkntpwd){
 166       $query= 'LC_ALL=C LANG=C perl -MCrypt::SmbHash -e "print join(q[:], ntlmgen $ARGV[0]), $/;" &>/dev/null';
 167       system ($query, $ret);
 168       $have_mkntpwd |= ($ret == 0);
 169     }
 170
 171     $N = _("SAMBA password hash generation");
 172     $D = _("In order to use SAMBA 2/3 passwords, you've to install additional packages to generate password hashes.");
 173     $S = _("In order to use SAMBA 2/3 you've to install additional perl libraries. Take a look at mkntpasswd.");
 174     $R = $have_mkntpwd;
 175     $M = TRUE;
 176     $this->basic_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 177
 178
 179     /* PHP Configuration checks
 180      */
 181
 182     /* Register_globals off */
 183     $N = "register_globals = <b>"._("Off")."</b>";
 184     $D = _("register_globals is a PHP mechanism to register all global variables to be accessible from scripts without changing the scope. This may be a security risk.");
 185     $S = _("Search for 'register_globals' in your php.ini and switch it to 'Off'.");
 186     $R = ini_get("register_globals") == 0;
 187     $M = FALSE;
 188     $this->config_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 189
 190
 191     /* session lifetime set to >=86400 seconds ? */
 192     $N = "session.gc_maxlifetime &gt;= <b>86400</b>";
 193     $D = _("PHP uses this value for the garbage collector to delete old sessions.")." ".
 194          _("Setting this value to one day will prevent loosing session and cookies before they really timeout.");
 195     $S = _("Search for 'session.gc_maxlifetime' in your php.ini and set it to 86400 or higher.");
 196     $R = ini_get("session.gc_maxlifetime") >= 86400;
 197     $M = FALSE;
 198     $this->config_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 199
 200     /* Session auto start must be turned off */
 201     $session_auto_start = ini_get('session.auto_start');
 202     $N = "session.auto_start = <b>"._("Off")."</b>";
 203     $D = _("In Order to use GOsa without any trouble, the session.auto_register option in your php.ini should be set to 'Off'.");
 204     $S = _("Search for 'session.auto_start' in your php.ini and set it to 'Off'.");
 205     $R = !$session_auto_start['local_value'];
 206     $M = TRUE;
 207     $this->config_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 208
 209     /* Check if memory limit is set to 32 or > */
 210     $N = "memory_limit &gt;= <b>32</b>";
 211     $D = _("GOsa needs at least 32MB of memory. Setting it below this limit may cause errors that are not reproducable! Increase it for larger setups.");
 212     $S = _("Search for 'memory_limit' in your php.ini and set it to '32M' or higher.");
 213     $R = ini_get('memory_limit') >= 32 ;
 214     $M = TRUE;
 215     $this->config_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 216
 217     /* Implicit Flush disabled can increase performance */
 218     $N = "implicit_flush = <b>"._("Off")."</b>";
 219     $D = _("This option influences the PHP output handling. Turn this Option off, to increase performance.");
 220     $S = _("Search for 'implicit_flush' in your php.ini and set it to 'Off'.");
 221     $R = !ini_get('implicit_flush');
 222     $M = FALSE;
 223     $this->config_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 224
 225     /* Check if execution time is set to 30 */
 226     $N = "max_execution_time &gt;= <b>30</b>";
 227     $D = _("The Execution time should be at least 30 seconds.");
 228     $S = _("Search for 'max_execution_time' in your php.ini and set it to '30' or higher.");
 229     $R = ini_get("max_execution_time") >= 30 ;
 230     $M = TRUE;
 231     $this->config_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 232
 233     /* Expose php should be set to off */
 234     $N = "expose_php = <b>"._("Off")."</b>";
 235     $D = _("Increase the server security by setting expose_php to 'off'. PHP won't send any information about the server you are running in this case.");
 236     $S = _("Search for 'expose_php' in your php.ini and set if to 'Off'.");
 237     $R = !ini_get("expose_php");
 238     $M = FALSE;
 239     $this->config_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 240
 241     /* Automatic quoting must be turned on */
 242     $N = "magic_quotes_gpc = <b>"._("On")."</b>";
 243     $D = _("Increase your server security by setting magic_quotes_gpc to 'on'. PHP will escape all quotes in strings in this case.");
 244     $S = _("Search for 'magic_quotes_gpc' in your php.ini and set it to 'On'.");
 245     $R = ini_get('magic_quotes_gpc');
 246     $M = TRUE;
 247     $this->config_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 248
 249     /* Emulating old stuff? */
 250     if (!preg_match('/^4/', phpversion())){
 251       $N = "zend.ze1_compatibility_mode = <b>"._("Off")."</b>";
 252       $D = _("Increase your server performance by setting magic_quotes_gpc to 'off'.");
 253       $S = _("Search for 'zend.ze1_compatibility_mode' in your php.ini and set it to 'Off'.");
 254       $R = !ini_get('zend.ze1_compatibility_mode');
 255       $M = FALSE;
 256       $this->config_checks[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 257     }
 258
 259
 260     /* Configuration file
 261      */
 262
 263     /* Check if we can create a config file.*/
 264     $N = _("Configuration writeable");
 265     $D = _("The configuration file can't be written");
 266     $S = sprintf(_("GOsa reads its configuration from a file located in (%s/%s). The setup can write the configuration directly if it is writeable."),CONFIG_DIR,CONFIG_FILE);
 267     $R =    ( file_exists(CONFIG_DIR."/".CONFIG_FILE) && is_writeable(CONFIG_DIR."/".CONFIG_FILE)) // is there a config file ?
 268         ||  (!file_exists(CONFIG_DIR."/".CONFIG_FILE) && is_writeable(CONFIG_DIR));  // There is non, but can we create a file there ?
 269     $M = FALSE;
 270     $this->is_writeable[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 271
 272     /* If we have writeaccess to the config dir, check if there is already a config file */
 273 #    if($R){
 274 #
 275 #      /* check if there is already a config file. */
 276 #      $N = _("No old configuration file.");
 277 #      $D = "";//_("");
 278 #      $S = _("If there is already a configuration file, this file will be overwritten when GOsa setup finishes. Please move your old config file away.");
 279 #      $R =  !file_exists(CONFIG_DIR."/".CONFIG_FILE);
 280 #      $M = FALSE;
 281 #      $this->is_writeable[] = array("NAME" => $N , "DESC" => $D , "RESULT" => $R , "SOLUTION" => $S , "MUST" => $M );
 282 #    }
 283   }
 284
 285
 286   function save_object()
 287   {
 288      /* If everything is fine, set this step to completed
 289      *  and allow switching to next setup step
 290      */
 291     $failed = false;
 292     foreach(array("basic_checks","config_checks","is_writeable") as $type){
 293       foreach($this->$type as $obj){
 294
 295         if($obj['MUST'] && !$obj['RESULT']){
 296           $failed = true;
 297           break;
 298         }
 299       }
 300     }
 301     $this->is_completed = !$failed;
 302   }
 303
 304
 305   /* Check if current PHP version is compatible
 306       with the current version of GOsa */
 307   function check_php_version()
 308   {
 309     if(preg_match("/^5/",phpversion())){
 310       return(version_compare(phpversion(),"5.2.0",">="));
 311     }else{
 312       return(version_compare(phpversion(),"4.3.10",">="));
 313     }
 314   }
 315 }
 316
 317 // vim:tabstop=2:expandtab:shiftwidth=2:filetype=php:syntax:ruler:
 318 ?>