#!/usr/bin/php -qC * @copyright (c) 2006 by Ralf Becker * @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License * @version $Id$ */ chdir(dirname(__FILE__)); // to enable our relative pathes to work if (isset($_SERVER['HTTP_HOST'])) // security precaution: forbit calling setup-cli as web-page { die('

setup-cli.php must NOT be called as web-page --> exiting !!!

'); } elseif ($_SERVER['argc'] > 1) { $arguments = $_SERVER['argv']; array_shift($arguments); $action = array_shift($arguments); } else { $action = '--version'; } // setting the language from the enviroment $_POST['ConfigLang'] = get_lang($charset); create_http_enviroment(); // guessing the docroot etc. // setting up the $GLOBALS['egw_setup'] object AND including the header.inc.php if it exists $GLOBALS['egw_info'] = array( 'flags' => array( 'currentapp' => 'home', 'noapi' => true, )); include('inc/functions.inc.php'); $GLOBALS['egw_setup']->translation->no_translation_marker = ''; $GLOBALS['egw_setup']->system_charset = $charset; function cli_exception_handler(Exception $e) { fail($e->getCode(),$e->getMessage()); } set_exception_handler('cli_exception_handler'); if ((float) PHP_VERSION < $GLOBALS['egw_setup']->required_php_version) { fail(98,lang('You are using PHP version %1. eGroupWare now requires %2 or later, recommended is PHP %3.',PHP_VERSION,$GLOBALS['egw_setup']->required_php_version,$GLOBALS['egw_setup']->recommended_php_version)); } switch($action) { case '--version': case '--check': setup_cmd::check_installed($arguments[0],0,true); break; case '--create-header': case '--edit-header': case '--upgrade-header': case '--update-header': do_header($action == '--create-header',$arguments); break; case '--install': do_install($arguments[0]); break; case '--config': do_config($arguments); break; case '--admin': do_admin($arguments[0]); break; case '--language': do_lang($arguments[0]); break; case '--update': do_update($arguments[0]); break; case '--backup': do_backup($arguments[0]); break; case '--languages': echo html_entity_decode(file_get_contents('lang/languages'),ENT_COMPAT,'utf-8'); break; case '--charsets': echo html_entity_decode(implode("\n",$GLOBALS['egw_setup']->translation->get_charsets(false)),ENT_COMPAT,'utf-8')."\n"; break; case '--exit-codes': list_exit_codes(); break; case '--help': case '--usage': do_usage($arguments[0]); break; default: fail(90,lang("Unknown option '%1' !!!",$action)); } exit(0); /** * Configure eGroupWare * * @param array $args domain(default),[config user(admin)],password,[,name=value,...] --files-dir --backup-dir --mailserver */ function do_config($args) { $options = _check_auth_config(array_shift($args),15); $values = array(); foreach($options as $option) { list($name,$value) = explode('=',$option,2); $values[$name] = $value; } static $config = array( '--files-dir' => 'files_dir', '--backup-dir' => 'backup_dir', '--temp-dir' => 'temp_dir', '--webserver-url' => 'webserver_url', '--mailserver' => array( //server,{IMAP|IMAPS|POP|POPS},[domain],[{standard(default)|vmailmgr = add domain for mailserver login}] 'mail_server', array('name' => 'mail_server_type','allowed' => array('imap','imaps','pop3','pop3s')), 'mail_suffix', array('name' => 'mail_login_type','allowed' => array('standard','vmailmgr')), ), '--cyrus' => array( 'imapAdminUsername', 'imapAdminPW', array('name' => 'imapType','default' => 3), array('name' => 'imapEnableCyrusAdmin','default' => 'yes'), ), '--sieve' => array( array('name' => 'imapSieveServer','default' => 'localhost'), array('name' => 'imapSievePort','default' => 2000), array('name' => 'imapEnableSieve','default' => 'yes'), // null or yes ), '--postfix' => array( array('name' => 'editforwardingaddress','allowed' => array('yes',null)), array('name' => 'smtpType','default' => 2), ), '--smtpserver' => array( //smtp server,[smtp port],[smtp user],[smtp password] 'smtp_server','smtp_port','smtp_auth_user','smtp_auth_passwd','' ), '--account-auth' => array( array('name' => 'account_repository','allowed' => array('sql','ldap')), array('name' => 'auth_type','allowed' => array('sql','ldap','mail','ads','http','sqlssl','nis','pam')), array('name' => 'sql_encryption','allowed' => array('md5','blowfish_crypt','md5_crypt','crypt')), 'check_save_password','allow_cookie_auth'), '--ldap-host' => 'ldap_host', '--ldap-root-dn' => 'ldap_root_dn', '--ldap-root-pw' => 'ldap_root_pw', '--ldap-context' => 'ldap_context', '--ldap-group-context' => 'ldap_group_context', ); $do_ea_profile = false; while (($arg = array_shift($args))) { if (!isset($config[$arg])) fail(90,lang("Unknown option '%1' !!!",$arg)); $options = array(); if (substr($args[0],0,2) !== '--') { $options = is_array($config[$arg]) ? explode(',',array_shift($args)) : array(array_shift($args)); } $options[] = ''; $options[] = ''; foreach($options as $n => $value) { if ($value === '' && is_array($config[$arg]) && !isset($config[$arg][$n]['default'])) continue; $name = is_array($config[$arg]) || $n ? $config[$arg][$n] : $config[$arg]; if (is_array($name)) { if (isset($name['allowed']) && !in_array($value,$name['allowed'])) { fail(91,lang("'%1' is not allowed as %2. arguments of option %3 !!!",$value,1+$n,$arg)); } if (!$value && isset($name['default'])) $value = $name['default']; $name = $name['name']; } $values[$name] = $value; } if (in_array($arg,array('--mailserver','--smtpserver','--cyrus','--postfix','--sieve'))) { $do_ea_profile = true; } } foreach($values as $name => $value) { $GLOBALS['egw_setup']->db->insert($GLOBALS['egw_setup']->config_table,array( 'config_value' => $value, ),array( 'config_app' => 'phpgwapi', 'config_name' => $name, ),__LINE__,__FILE__); } if (count($values)) { echo lang('Configuration changed.')."\n"; if ($do_ea_profile) do_emailadmin($values); } echo "\n".lang('Current configuration:')."\n"; $GLOBALS['egw_setup']->db->select($GLOBALS['egw_setup']->config_table,'config_name,config_value',array( 'config_app' => 'phpgwapi', "(config_name LIKE '%\\_dir' OR (config_name LIKE 'mail%' AND config_name != 'mail_footer') OR config_name LIKE 'smtp\\_%' OR config_name LIKE 'ldap%' OR config_name IN ('webserver_url','system_charset','auth_type','account_repository'))", ),__LINE__,__FILE__); while (($row = $GLOBALS['egw_setup']->db->row(true))) { echo str_pad($row['config_name'].':',22).$row['config_value']."\n"; } } /** * Updates the default EMailAdmin profile * * @param array $values */ function do_emailadmin() { $GLOBALS['egw_setup']->db->select($GLOBALS['egw_setup']->config_table,'config_name,config_value',array( 'config_app' => 'phpgwapi', "((config_name LIKE 'mail%' AND config_name != 'mail_footer') OR config_name LIKE 'smtp%' OR config_name LIKE 'imap%' OR config_name='editforwardingaddress')", ),__LINE__,__FILE__); while (($row = $GLOBALS['egw_setup']->db->row(true))) { $config[$row['config_name']] = $row['config_value']; } $config['smtpAuth'] = $config['smtp_auth_user'] ? 'yes' : null; $emailadmin =& CreateObject('emailadmin.bo',-1,false); // false=no session stuff $emailadmin->setDefaultProfile($config); echo "\n".lang('EMailAdmin profile updated:')."\n"; foreach($config as $name => $value) { echo str_pad($name.':',22).$value."\n"; } } /** * Create an admin account * * @param string $arg domain(default),[config user(admin)],password,username,password,[first name],[last name],[email] */ function do_admin($arg) { list($_POST['username'],$_POST['passwd'],$_POST['fname'],$_POST['lname'],$_POST['email']) = _check_auth_config($arg,15); $_POST['passwd2'] = $_POST['passwd']; if (!$_POST['fname']) $_POST['fname'] = 'Admin'; if (!$_POST['lname']) $_POST['lname'] = 'User'; $_POST['submit'] = true; $error = include('admin_account.php'); switch ($error) { case 41: fail(41,lang('Error in admin-creation !!!')); case 42: fail(42,lang('Error in group-creation !!!')); } echo lang('Admin account successful created.')."\n"; } /** * Backup one or all domains * * @param string $arg domain(all),[config user(admin)],password,[backup-file, 'no' for no backup or empty for default name] * @param boolean $quite_check quiten the call to _check_auth_config */ function do_backup($arg,$quite_check=false) { list($domain,,,$backup) = $options = explode(',',$arg); $domains = $GLOBALS['egw_domain']; if ($domain && $domain != 'all') { $domains = array($domain => $GLOBALS['egw_domain'][$domain]); } foreach($domains as $domain => $data) { $options[0] = $domain; if ($quite_check) ob_start(); _check_auth_config(implode(',',$options),14); if ($quite_check) ob_end_clean(); if ($backup == 'no') { echo lang('Backup skipped!')."\n"; } else { $db_backup =& CreateObject('phpgwapi.db_backup'); if (is_resource($f = $db_backup->fopen_backup($backup))) { echo lang('Backup started, this might take a few minutes ...')."\n"; $db_backup->backup($f); fclose($f); echo lang('Backup finished')."\n"; } else // backup failed ==> dont start the upgrade { fail(50,lang('Backup failed').': '.$f); } } } } /** * Update one or all domains * * @param string $arg domain(all),[config user(admin)],password,[backup-file, 'no' for no backup or empty for default name] */ function do_update($arg) { global $setup_info; list($domain,,,$no_backup) = $options = explode(',',$arg); $domains = $GLOBALS['egw_domain']; if ($domain && $domain != 'all') { $domains = array($domain => $GLOBALS['egw_domain'][$domain]); } foreach($domains as $domain => $data) { $options[0] = $domain; $arg = implode(',',$options); _check_auth_config($arg,14); if ($GLOBALS['egw_info']['setup']['stage']['db'] != 4) { echo lang('No update necessary, domain %1(%2) is up to date.',$domain,$data['db_type'])."\n"; } else { echo lang('Start updating the database ...')."\n"; do_backup($arg,true); ob_start(); $GLOBALS['egw_setup']->process->init_process(); // we need a new schema-proc instance for each new domain $GLOBALS['egw_setup']->process->pass($setup_info,'upgrade',false); $messages = ob_get_contents(); ob_end_clean(); if ($messages) echo strip_tags($messages)."\n"; echo lang('Update finished.')."\n"; } } } /** * Install / update languages * * @param string $arg domain(all),[config user(admin)],password,[+][lang1][,lang2,...] */ function do_lang($arg) { global $setup_info; list($domain) = $options = explode(',',$arg); $domains = $GLOBALS['egw_domain']; if ($domain && $domain != 'all') { $domains = array($domain => $GLOBALS['egw_domain'][$domain]); } foreach($domains as $domain => $data) { $options[0] = $domain; $arg = implode(',',$options); $langs = _check_auth_config($arg,15,false); // false = leave eGW's charset, dont set ours!!! $GLOBALS['egw_setup']->translation->setup_translation_sql(); if ($langs[0]{0} === '+' || !count($langs)) // update / add to existing languages { if ($langs[0]{0} === '+') { if ($langs[0] === '+') { array_shift($langs); } else { $langs[0] = substr($langs[0],1); } } $installed_langs = $GLOBALS['egw_setup']->translation->sql->get_installed_langs(true); if (is_array($installed_langs)) { $langs = array_merge($langs,array_keys($installed_langs)); } } $langs = array_unique($langs); echo lang('Start updating languages %1 ...',implode(',',$langs))."\n"; $GLOBALS['egw_setup']->translation->sql->install_langs($langs); echo lang('Languages updated.')."\n"; } } /** * Check if eGW is installed according to $stop and we have the necessary authorization for config * * The password can be specified as parameter, via the enviroment variable EGW_CLI_PASSWORD or * querier from the user. Specifying it as parameter can be security problem! * * We allow the config user/pw of the domain OR the header admin user/pw! * * @param string $arg [domain(default)],[user(admin)],password * @param int $stop see setup_cmd::check_installed * @param boolean $set_lang=true set our charset, overwriting the charset of the eGW installation, default true * @return array with unprocessed arguments from $arg */ function _check_auth_config($arg,$stop,$set_lang=true) { $options = explode(',',$arg); if (!($domain = array_shift($options))) $domain = 'default'; $user = array_shift($options); $password = array_shift($options); _fetch_user_password($user,$password); setup_cmd::check_installed($domain,$stop,true); // reset charset for the output to the charset used by the OS if ($set_lang) $GLOBALS['egw_setup']->system_charset = $GLOBALS['charset']; setup_cmd::check_setup_auth($user,$password,$domain); return $options; } /** * Install eGroupWare * * @param string $args domain,[config user(admin)],password,[backup-file],[charset] */ function do_install($args) { global $setup_info; list($domain,$user,$password,$backup,$charset) = explode(',',$args); _fetch_user_password($user,$password); $cmd = new setup_cmd_install($domain,$user,$password,$backup,$charset,true); echo $cmd->run()."\n"; } /** * Set defaults for user and password or queries the password from the user * * @param string &$user * @param string &$password */ function _fetch_user_password(&$user,&$password) { // read password from enviroment or query it from user, if not given if (!$user) $user = 'admin'; if (!$password && !($password = $_SERVER['EGW_CLI_PASSWORD'])) { echo lang('Admin password to header manager').' '; $password = trim(fgets($f = fopen('php://stdin','rb'))); fclose($f); } } /** * Create, edit or update the header.inc.php * * @param boolean $create true = create new header, false = edit (or update) existing header * @param array $arguments * @return int */ function do_header($create,&$arguments) { if (!$create) { // read password from enviroment or query it from user, if not given @list($password,$user) = $options = explode(',',@$arguments[0]); _fetch_user_password($options[1],$options[0]); $arguments[0] = implode(',',$options); } array_unshift($arguments,$create ? '--create-header' : '--edit-header'); $cmd = new setup_cmd_header($create?'create':'edit',$arguments); try { $msg = $cmd->run(); } catch(Exception $e) { fail($e->getCode(),$e->getMessage()); } echo "\n$msg\n\n"; exit(0); } /** * Reads the users language from the enviroment * * @param string &$charset charset set in LANG enviroment variable or the default utf-8 * @return string 2 or 5 digit language code used in eGW */ function get_lang(&$charset) { @list($lang,$nation,$charset) = split("[_.]",strtolower($_SERVER['LANG'])); foreach(file('lang/languages') as $line) { list($code,$language) = explode("\t",$line); $languages[$code] = $language; } if (isset($languages[$lang.'-'.$nation])) return $lang.'-'.$nation; if (isset($languages[$lang])) return $lang; return 'en'; } /** * Try guessing the document root of the webserver, should work for RH, SuSE, debian and plesk */ function create_http_enviroment() { $_SERVER['SCRIPT_FILENAME'] = __FILE__; foreach(array('httpsdocs','httpdocs','htdocs','html','www') as $docroottop) { $parts = explode($docroottop,__FILE__); if (count($parts) == 2) { $_SERVER['DOCUMENT_ROOT'] = $parts[0].$docroottop; $_SERVER['PHP_SELF'] = str_replace('\\','/',$parts[1]); break; } } //print_r($_SERVER); exit; } /** * Echos usage message */ function do_usage($what='') { echo lang('Usage: %1 command [additional options]',basename($_SERVER['argv'][0]))."\n\n"; if (!$what) { echo '--check '.lang('checks eGroupWare\'s installed, it\'s versions and necessary upgrads (return values see --exit-codes)')."\n"; echo '--install '.lang('domain(default),[config user(admin)],password,[backup to install],[charset(default depends on language)]')."\n"; } if (!$what || $what == 'config') { echo '--config '.lang('domain(default),[config user(admin)],password,[name=value,...] sets config values beside:')."\n"; if (!$what) echo ' --help config '.lang('gives further options')."\n"; } if ($what == 'config') { echo ' --files-dir, --backup-dir, --temp-dir '.lang('path to various directories: have to exist and be writeable by the webserver')."\n"; echo ' --webserver-url '.lang('eg. /egroupware or http://domain.com/egroupware, default: %1',str_replace('/setup/setup-cli.php','',$_SERVER['PHP_SELF']))."\n"; echo ' --mailserver '.lang('host,{imap | pop3 | imaps | pop3s},[domain],[{standard(default)|vmailmgr = add domain for mailserver login}]')."\n"; echo ' --smtpserver '.lang('host,[smtp port],[smtp user],[smtp password]')."\n"; echo ' --postfix '.lang('Postfix with LDAP: [yes(user edit forwarding)]')."\n"; echo ' --cyrus '.lang('Cyrus IMAP: Admin user,Password')."\n"; echo ' --sieve '.lang('Sieve: Host[,Port(2000)]')."\n"; echo ' --account-auth '.lang('account repository{sql(default) | ldap},[authentication{sql | ldap | mail | ads | http | ...}],[sql encrypttion{md5 | blowfish_crypt | md5_crypt | crypt}],[check save password{ (default)|True}],[allow cookie auth{ (default)|True}]')."\n"; echo ' --ldap-host --ldap-root-dn --ldap-root-pw --ldap-context --ldap-group-context'."\n"; } if (!$what) { echo '--admin '.lang('creates an admin user: domain(default),[config user(admin)],password,username,password,[first name],[last name],[email]')."\n"; echo '--language '.lang('install or update translations: domain(all),[config user(admin)],password,[[+]lang1[,lang2,...]] + adds, no langs update existing ones')."\n"; echo '--backup '.lang('domain(all),[config user(admin)],password,[file-name(default: backup-dir/db_backup-YYYYMMDDHHii)]')."\n"; echo '--update '.lang('run a database schema update (if necessary): domain(all),[config user(admin)],password')."\n"; echo lang('You can use the header user and password for every domain too. If the password is not set via the commandline, it is read from the enviroment variable EGW_CLI_PASSWORD or queried from the user.')."\n"; } if (!$what || $what == 'header') { echo lang('Create or edit the eGroupWare configuration file: header.inc.php:')."\n"; echo '--create-header '.lang('header-password[,header-user(admin)]')."\n"; echo '--edit-header '.lang('[header-password],[header-user],[new-password],[new-user]')."\n"; if (!$what) echo ' --help header '.lang('gives further options')."\n"; } if ($what == 'header') { echo "\n".lang('Additional options and there defaults (in brackets)')."\n"; echo '--server-root '.lang('path of eGroupWare install directory (default auto-detected)')."\n"; echo '--session-type '.lang('{db | php(default) | php-restore}')."\n"; echo '--limit-access '.lang('comma separated ip-addresses or host-names, default access to setup from everywhere')."\n"; echo '--mcrypt '.lang('use mcrypt to crypt session-data: {off(default) | on},[mcrypt-init-vector(default randomly generated)],[mcrypt-version]')."\n"; echo '--db-persistent '.lang('use persistent db connections: {on(default) | off}')."\n"; echo '--domain-selectbox '.lang('{off(default) | on}')."\n"; echo "\n".lang('Adding, editing or deleting an eGroupWare domain / database instance:')."\n"; echo '--domain '.lang('add or edit a domain: [domain-name(default)],[db-name(egroupware)],[db-user(egroupware)],db-password,[db-type(mysql)],[db-host(localhost)],[db-port(db specific)],[config-user(as header)],[config-passwd(as header)]')."\n"; echo '--delete-domain '.lang('domain-name')."\n"; } if (!$what) { echo '--help list '.lang('List availible values')."\n"; } if ($what == 'list') { echo lang('List availible values').":\n"; echo '--languages '.lang('list of availible translations')."\n"; echo '--charsets '.lang('charsets used by the different languages')."\n"; echo '--exit-codes '.lang('all exit codes of the command line interface')."\n"; } if (!$what || !in_array($what,array('config','header','list'))) { echo '--help [config|header|list] '.lang('gives further options')."\n"; } } function fail($exit_code,$message) { echo $message."\n"; exit($exit_code); } /** * List all exit codes used by the command line interface * * The list is generated by "greping" this file for calls to the fail() function. * Calls to fail() have to be in one line, to be recogniced! */ function list_exit_codes() { error_reporting(error_reporting() & ~E_NOTICE); $codes = array('Ok'); foreach(file(__FILE__) as $n => $line) { if (preg_match('/fail\(([0-9]+),(.*)\);/',$line,$matches)) { //echo "Line $n: $matches[1]: $matches[2]\n"; @eval('$codes['.$matches[1].'] = '.$matches[2].';'); } } ksort($codes,SORT_NUMERIC); foreach($codes as $num => $msg) { echo $num."\t".str_replace("\n","\n\t",$msg)."\n"; } }