eGroupWare安装中文手册（上）
原文地址：
http://blog.sina.com.cn/s/blog_7cb52fa8 ... html一、安装需求
要安装 eGroupWare，服务器应该符合以下最低系统要求
Pentium III 或 AMD K6, 800Mhz 或更高
500 MB 空间用于软件的安装
额外的空间用于上传和 E-mail 附件
256 MB RAM
(注: 以上只是最低系统配置的原则。而更快的处理器, 更多的内存或额外的硬盘空间也许是必需的。)
另外，eGroupWare 要求以下的安装软件：
操作系统: Windows (98/ME, NT/2000/XP/Vista), Linux, Mac OS X(10.3.4 或更高)
(注: 其它操作系统也许是非官方支持的。)
最新的 eGroupWare 官方版本软件包
(可用来源
http://www.egroupware.org)
网络服务器 - Apache, IIS 或其它支持 PHP 的网络服务器
推荐: Apache 2; 至少 php 4.3, 推荐: php 5.1+)
数据库 (SQL) 例如 MySQL, Postgres, MaxDB, MsSQL?...
(注: 至少 MySQL 4.1 或 5.0 (参见 Release Notes for 1.4))
SMTP 服务器，例如 Postfix, Exim, Sendmail, Mercury ...
(注: 后缀的扩展支持)
网页浏览器 - Firefox, Internet Explorer, Safari, Opera, Camino
(注: 所有符合标准的浏览器应可工作)
客户 IMAP 服务器例如: Cyrus, DB-Mail, Courier, Mercury (Windows)
(注: 对于 Cyrus & DB Mail 的扩展支持)(POP3 不被支持)
客户浏览器例如：Firefox, Internet Explorer ...
(注: 推荐使用 Firefox)
Apachefriends 编译了一个对于使用 eGroupWare 必需的所有需求的安装程序, 包括一个网络服务器,数据库服务器和邮件服务器。访问他们的网站
http://www.apachefriends.org 下载 XAMPP安装程序。
二、下载和解压缩 eGroupWare 软件包
你可以在 的eGroupWare 下载页面 下载 eGroupWare 软件包。
我们提供以下未签名的软件包:
*.tar.gz
*.tar.bz2
*.zip
也有一个签名的文件, 密钥 eGroupWare 软件包 packager AT egroupware DOT org (密钥号 7AF22C5C), 以 md5软件包效验。 密钥可在
http://blackhole.pca.dfn.de 下载。指纹是: 915D 3F65 55F8AB18 34C6 22A1 2E24 11E0 7AF2 2C5C
该 rpm 软件包是开发和签名使用 SuSE Build Service。
软件包可以在 'docroot' 和 eGroupWare 要求的任何目录安装。如果你在 'docroot' 里的目录安装,请注意：常常 alias/manual (Apache manual)存在防止我们的手动执行。
程序的全新安装在以下章节概述; 升级在更新安装(第 2.4 章)中说明。
程序的全新安装可以参阅开始安装,而升级可参阅更新安装。
三、eGroupWare 设置
1、开始安装
为了开始通过浏览器安装eGroupWare，你首先要进入相关的Internet安装目录地址。
如果你的计算机的DNS名称为domain.com (如果你在服务器上操做，就是local host), 你的网页服务器的根目录为是/srv/www /htdocs，并且你将 压缩的eGroupWareand解压到了 /srv/www/htdocs/egroupware, 那么这个Internet安装地址就为:
http://domain.com/egroupware/
如果提示“ 500: Internal ServerError”,说明你的Apache服务器设置文件“.htaccess”不允许在eGroupWare安装目录下创建文件夹。
解决办法有两个：
a) 更改“.htaccess”文件，更改 “AllowOverrideNone”为“ AllowOverrideFileInfo”，注意与你的安装文件匹配的目录，例如：
<Directory "/var/www /html"> AllowOverride FileInfo ...</Directory>b) 将“.htaccess”重命名，这样这个文件就不会被Apache使用。如果你这样改的话，你就需要人工在“php.ini”文件中进行设置。
现在会出现eGroupWare模块安装的欢迎界面，并且你能选择安装所用的语言。
然后，就可以执行安装前检查了：
eGroupWare将检查安装环境，对每一项检查有三个可能的结果:
检查通过
表示提醒，并且会提供额外的信息，包括哪些参数需要更改，大部分参数是有关'php.ini'文件（这个提醒会告诉你php.ini文件的位置）
检查错误，你必须更正后才能继续，系统会提示要更改的内容。
eGroupWare安装检查的典型提示如下：
Checking required PHP version4.3+ (recommended 5.0): 5.0.5 ==> True
检查PHP版本大于4.3
Checking php.ini: safe_mode =Off: ini_get('safe_mode')='' = Off
Checking php.ini:magic_quotes_runtime = Off: ini_get('magic_quotes_runtime')='0' =Off
Checking php.ini:register_globals = Off: ini_get('register_globals')='0' = Off
Checking php.ini: memory_limit>= 16M: ini_get('memory_limit')='8'
memory_limit (maximum memory available for a script) is set toless than 16MB: some programs require more than the recommended 8MB- be prepared for occasional errors! memory_limit(运行脚本允许使用的最大内存)的设置小于16MB：一些程序运行时需要的内存大于默认的8MB--可能会出现不可预料的错误。Please make the following changes in your 'php.ini' file(path/php.ini): memory_limit=16M
请在你的“php.ini”文件中做下列修改：memory_limit=16M
And reload your Webserver, in order to implement thechanges:
并且重新启动你的网页服务进程，以便应用这些更改：
under Windows: using the XAMPP Control-Panel
在windows下，请使用控制面板。
under Linux: reload webserver e.g. /etc/init.d/httpd reload orusin XAMPP via /opt/lampp/lampp reloadapache
在Linux下：重新启动网页服务器进程，例如：使用“/etc/init.d/httpd”命令
under MacOSX: enter the following line in a Terminal Window:/Applications/xampp/xamppfiles/mampp reloadapache
Checking php.ini:max_execution_time >= 30:ini_get('max_execution_time')='60'
Checking php.ini: file_uploads= On: ini_get('file_uploads')='1' = On
Checking php.ini: include_pathcontain .:ini_get('include_path')='.:/Applications/xampp/xamppfiles/lib/php'
Checking extension mysql isloaded or loadable: True
Checking extension pgsql is loaded orloadable: False
The pgsql extension is needed, if you plan to use a pgSQLdatabase.
如果你要使用pgSQL数据库，那么需要pgsql扩展。
If you plan to use MySQL as the database, you can ignorethis warning
如果你计划使用MySQL数据库，你可以忽略这个警告。
Checking if the mssql extensionis loaded or loadable: True
Checking extension odbc isloaded or loadable: True
Checking extension oci8 is loaded orloadable: False
The oci extension is needed, if you plan to use an Oracledatabase.
如果你计划使用Oracle数据库的话，需要oci扩展
Checking extension mbstring isloaded or loadable: True
Checking php.ini:mbstring.func_overload = 7:ini_get('mbstring.func_overload')=''
You only need to change this parameter in the php.ini fileif you will be working with different languages (differentcharacter sets!) simultaneously in eGroupWare. Use the 'unicodeutf-8' character set to cover all languages, or, e.g. the'iso-8859-1' for all West-European languages.
如果你要在eGroupWare中同时使用多种语言的话，你仅需要更改php.ini中的语言参数，使用“unicodeutf-8”以包含所有语言。
Checking extension imap is loaded orloadable: False
The extension imap (php extension) is needed by both email programs(even if you use the POP3-protocol).
检查imap扩展是否被装入：否
imap扩展被电子邮件程序所需要（即使你使用POP3协议）
Under Windows, all php extensions must be explicitly loadedin the php.ini file. To do this, remove the semi-colon '";"' fromin front of the corresponding line,'extension=php_imap.dll'.
在Windows中，所有的php扩展必须被明确指明允许装入。你必须移出相关行前面的“；”，
'extension=php_imap.dll'。
UnderLinux, the php extensions are usually individual packages, that is,for 'imap' the package 'php(4|5)_imap' must beinstalled.
在Linux下，php扩展一般在不同的软件包中，这就是说，对于imap扩展，“php4_imap”或“php5_imap”必须被安装。
Checking extension session isloaded or loadable: True
Checking PEAR is installed:True
Checking PEAR:og is installed:False
检查PEAR：Log已被安装：否
PEAR:og is needed by SyncML.
PEAR：Log被SyncML功能需要。
'''For Linux or MacOSX?the following must be carried out in a terminal window as'root':
pear install Auth_SASL'''
对于Linux或MacOSX，你必须以root身份在终端窗口中执行“pear install Auth_SASL”
Checking for GD support...:True
Checking file-permissions of .for not world writable: $sysuser/admin drwxr-xr-x
This might take a while, please wait ...
Checking if the webserver canwrite on the php.ini setting session.save_path='/var/lib/php5':wwwrun/root drwxr-xr-x
检查是否网页服务进程具有写入php.ini中设置的会话保存目录/var/lib/php5'的权限
If this test fails, you will NOT be able to log into PHPsessions in eGroupWare: "Your session cannot be verified."!!!
如果这个检查失败，在eGroupWare会话中将不能记录到PHP会话中，会出现“你的会话不能被更改”测错误提示。
Please fix the above errors () and warnings( ).（请修复上述错误和警告或继续安装头文件）
or continue with Header Management
2、管理头文件
文件'header.inc.php'是一个包含eGroupWare设置的基础配置文件。
里面的内容如下：
Server Root e.g. for Windows:C:/Programs/xampp/htdocs/egroupware or for Linux:/var/www/html/egroupware or for Mac OS-X:/Applications/xampp/htdocs/egroupwareThese settings are usually automatically recognised and shouldgenerally not be changed.EGroupWare服务根目录 windows下示例：C:/Programs/xampp/htdocs/egroupware Linux或 Mac OS-X下：/Applications/xampp/htdocs/egroupware这个设置一般能够被自动识别，一般不需要修改。
Include Root (this should be the same asServer Root unless you know what you are doing)
包含的根目录(这个设置一般与服务器根目录相同)
Admin user for header manager e.g.admin, and a, Admin password to headermanagerThis admin-user is needed if changes will be made to the headerfile after installation. (e.g. additional sessions (eGroupWareDomains)) - the lower Login-field of Setup头文件管理用户名和头文件管理用户密码：在安装完成后，如果需要更改头文件，这个用户将被需要。
Limit access to setup to the following addresses,networks or hostnames (e.g.127.0.0.1,10.1.1,myhost.dnydns.org)Important, since the Setup-Login has no protection againstbrute-force attacks (random password attempts).在下列地址、网络或主机名禁止进行安装的操作。重要，因为安装登陆操作不能避免被暴力破解。
Persistent connections: Do you want persistentconnections (higher performance, but consumes moreresources)?
静态连接：你需要静态连接吗?(高的性能，但是消耗更过资源)
Sessions Type: What type of sessionsmanagement do you want to use?
会话类型：你将使用那种会话管理？
PHP session management may perform better)
PHP 会话管理有较高的性能
PHP plus restore gives by far the best performance, as itstores the eGW enviroment completly in the session. Unfortunallysome PHP/Apache packages have problems with it (Apache crashes andyou can't login anymore).
PHP + 的回收提供了最大的性能改善，因为它把eGW环境完全保存在会话中。不幸的是一些PHP/Apache安装包在这个设置中存在问题（如Apache崩溃后，你将不能登陆）
'Database': Saves the session in a database -is theslowest
数据库：把会话保存在数据库中---是最慢的一种方式。
Enable MCrypt: Not all mcrypt algorithms andmodes work with eGroupWare. If you experience problems tryswitching it off.
使用 MCrypt：不是所有的MCrypt算法和方式都适用于 eGroupWare。如果你在使用中遇到了问题，你可以关闭这个功能。Use MCrypt if you are located on a 'shared-Webhost' (i.e.multiple users share a webserver, often the case in purchasedwebspace) since otherwise passwords, for example, are not encryptedand can be read by other host users!
如果你的eGroupWare位于共享的服务器上（例如：多个用户共享一个服务器，通常为购买的网页空间）这时你需要MCrypt，因为如果不是通过密码认证，你的文件可被其他用户读取。
MCrypt initialisation vector: This should bearound 30 bytes in length. (Note: The default has been randomlygenerated.) It is recommended that you don't change anythinghere.
MCrypt初始化向量：这个值的长度应为30字节。（注意：缺省值被随机产生）建议你不要修改这里的值。
Domain select box on login: If you usemultiple database sessions (eGroupWare Domains), you can selectthese via a drop-down list when logging in. Otherwise, you can alsoaccess the various database sessions via "username@session"; forthe 'default' session (the first domain created), you may enteronly the user name.
登录时选择域：如果你使用多个数据库会话，你可以通过一个下拉菜单选择你要登录的域。你也可以使用“用户名@域”这样的格式登录不同的域。如果你要登录默认的域（你创建的第一个域），你只需要输入用户名。
Datebase: Use the text field (automaticallyset to 'default') to select, and the tickbox to delete, adomain.
数据库：使用文本区去选择，或删除一个域。
DB Type: Which database type do you want touse with eGroupWare? You may choose among all installed databases,for which a php extension was "found" (see als Check Installation)
数据库类型：你要使用过的数据库类型。你可以从所有PHP扩展中安装的数据库中选择。
DB Host: Hostname/IP of database server. Ifyou are using Postgres, leave this empty to use the prefered unixdomain sockets instead of a tcp/ip connection. If you are runningODBC / MaxDB, enter a DSN (data source name) to use
数据库主机：数据库服务器的主机名或IP。如果你使用Postgres数据库，则保持这个区域为空，这样就可以使用推荐的UNIX域套接字代替tcp/ip连接。如果你使用ODBC/MaxDB，则输入一个数据源名称。
DB Port: TCP port number of databaseserver
数据库端口：数据库服务器的端口号。
DB Name: You may enter a name for yourdatabase in this text field (do not use any spaces or specialcharacters). The default is "egroupware".
数据库名称：你可以在这个文本区中输入一个数据库名称（注意中间不要使用空格）。缺省的名称为“egroupware”。
DB User: Name of the DB-user that eGroupWareuses to connect, in conjunction with the DBPassword.
数据库用户名：用于连接eGroupWare数据库的数据库用户名，与数据库密码相匹配。
Configuration User und ConfigurationPassword: Password that is needed for the configurationlogin, the upper of the two logins at Setup. If you use only one database session (eGW Domain), youshould use the same user name and password as for the HeaderManagement.
配置用户名和密码：用于配置登录的用户名和密码（安装页面的上两个文本框）。如果你只有一个数据库会话（eGW域），你应该使用与头管理相同的用户名和密码。
Below these options, there are three buttons for
在这些功能下面，有三个按钮
[Create Configuration]: saves yourconfiguration in the file 'header.inc.php', if the webserver haswrite privileges in your eGroupWare installation directory,which is not recommended on a permanentbasis!
[创建设置文件]：如果你的网页服务器对你的eGRoupWare安装目录有写权限的话（在实际应用中，这种做法是不推荐的），把当前你的设置保存在 header.inc.php 中
[Download]: Here you can download yoursettings (automatically named 'header.inc.php' from the webserverto you local computer and then, e.g. saved via FTP back to theeGroupWare installation directory.
【下载】：你可以下载配置文件到你的本地计算机（配置文件被自动命名为 header.inc.php），然后可以通过FTP保存到eGroupWare安装目录
[View]: Shows the file with all settings.
【查看】：显示所有的设置内容。
更多内容，请参阅：
原文：
http://blog.sina.com.cn/s/blog_7cb52fa80100tm4p.html