在fedora11上安装boa webserver服务器

1、下载Boa Webserver的

2、解压并编译Boa Webserver
编译过程中可能出现错误，部分的错误处理方法

编译时错误处理：

1：
编译需要bison(yacc的GNU版本）和flex，如果没有这2个将报错，因此：
$ sudo apt-get install flex bison

2：
util.c:100:1: error: pasting "t" and "->" does not give a valid preprocessing token
make: *** [util.o] Error 1
解决办法：修改src/compat.h文件。
#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff 改为
#define TIMEZONE_OFFSET(foo) foo->tm_gmtoff

3：
error_log：
[24/Mar/2008:16:23:51 +0000] boa.c:226 - icky Linux kernel bug!: Success
解决方法：修改src/boa.c，将下面一段代码注释。

 if (setuid(0) != -1) {
DIE("icky Linux kernel bug!");
}

$ tar -zxvf boa-0.94.13.tar.gz
$ cd boa-0.94.13/src/
$ ./configure
$ make

3、配置Boa Webserver环境
编译后在boa-0.94.13/src/中有2个二进制文件，那就是我们需要的执行档，只需拷贝到/bin或者/sbin等执行目录里面(建议使用/bin)。同时注意这里的操作权限：
$ sudo cp boa/boa-0.94.13/src/boa   /bin
$ sudo cp boa-0.94.13/src/boa_indexer /bin

Boa Webserver的配置文件是boa.conf。该文件需要被放置在/etc/boa目录下。同时我们需要对boa.conf稍做修改：
# mkdir /etc/boa
# cp boa/boa-0.94.13/boa.conf /etc/boa
# vim /etc/boa/boa.conf
a)修改：    Group nogroup
为：     Group 0
b)修改：   ScriptAlias /cgi-bin/ /usr/lib/cgi-bin
为：        ScriptAlias /cgi-bin/ /var/www/cgi-bin
修改Group的参数为0是因为系统中没有nogroup组，如果你没有nobody用户，那么User nobody也要做相应修改(修改成自己的用户名亦可)。其它采用默认设置。如有必要，可以参看<附录>中的参数说明。

建立一些Boa Webserver必要的文件目录：
# mkdir -p /var/www/cgi-bin
# mkdir -p /var/log/boa

目录/var/www/用于保存HTML文档，而/var/www/cgi-bin用于保存CGI脚本。
目录/var/log/boa是相关的日志文件保存目录。

4、测试
我们也可以做一下Boa CGI测试。拷贝boa-0.94.13/examples/里的cgi-test.cgi脚本文件。
# cp boa-0.94.13/examples/cgi-test.cgi /var/www/cgi-bin
在浏览器中输入：

这时可能还不能正常访问，发现运行boa时
返回success: gethostbyname，说是success其实我根本就不能正常访问网页

还要将boa.conf中的ServerName               这里默认是注释掉的，一定要去掉注释

改为ServerName                你的主机名

还有问题，就是我编写了一个hello.cgi的文件，我将其放在/var/www/cgi-bin中，但是访问时出现

The requested URL /cgi-bin/hello.cgi was not found on this .
若放在/var/www中，访问时不是执行hello.cgi而是提示保存文件。

后来看boa.conf

# ScriptAlias: Maps a virtual path to a directory for serving scripts
# Example: ScriptAlias /htbin/ /www/htbin/

ScriptAlias /cgi-bin/ /var/www/cgi-bin
上行写错了，要改为
ScriptAlias /cgi-bin/ /var/www/cgi-bin/
少了“/”
为了这个，花了一个多小时

总结：在玩boa过程中遇到不少问题，在编译成功后，要测试boa时，
记住第1步：ps -e|grep boa来检查你的boa服务真的是运行成功运行起来了吗？没有就不用打开测试网页了
这时网页当然打不开
第2步：打开测试网页若有错一般是和boa.conf有关

==============================================================

常见错误小结：
1>. 错误1: gethostbyname:: No such file or directory
解决办法: 修改boa.conf 去掉 ServerName 前的注释符号(#)
2>. 错误1: util.c:100:1: error: pasting "t" and "->" does not give a valid preprocessing token make: *** [util.o]
解决办法: 修改 src/compat.h
找到
#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff
修改成
#define TIMEZONE_OFFSET(foo) (foo)->tm_gmtoff
3>. 错误2: boa.c:211 - getpwuid: No such file or directory
解决办法: 修改src/boa.c
注释掉下面这段程序:
if (passwdbuf == NULL) {
DIE(”getpwuid”);
}
if (initgroups(passwdbuf->pw_name, passwdbuf->pw_gid) == -1) {
DIE(”initgroups”);
}
即修改为:
#if 0
if (passwdbuf == NULL) {
DIE(”getpwuid”);
}
if (initgroups(passwdbuf->pw_name, passwdbuf->pw_gid) == -1) {
DIE(”initgroups”);
}
#endif
4>. 错误3: boa.c:228 - icky Linux kernel No such file or directory
解决办法: 修改src/boa.c
注释掉下面语句:
if (setuid(0) != -1) {
DIE(”icky Linux kernel bug!”);
}
即修改为:
#if 0
if (setuid(0) != -1) {
DIE(”icky Linux kernel bug!”);
}
#endif
5>. 错误4: log.c:73 unable to dup2 the error log:bad file descriptor
解决方法:
方法1> 确定日志目录对与所有用户都具有可读/写的权限
方法2> 修改src/log.c (建议采用方法1)
注释掉
if (dup2(error_log, STDERR_FILENO) == -1) {
DIE("unable to dup2 the error log");
}
即修改为:
#if 0
if (dup2(error_log, STDERR_FILENO) == -1) {
DIE("unable to dup2 the error log");
}
#endif

Boa Webserver配置参数说明：
Port：boa服务器监听的端口，默认的端口是80。如果端口小于1024，则必须是root用户启动。
Listen：绑定的ip地址。不使用这个参数时，将绑定所有的地址。
User：连接到服务器的客户端的身份，可以是用户名或UID。（为什么非要指定为文件的所有者才能访问网页呢？nobody用户也有读权限啊）
Group：连接到服务器的客户端的组，可以是组名或GID。
ServerAdmin：服务器出故障时要通知的邮箱地址。
ErrorLog：指定错误日志文件。如果路径没有以“/”开始，则相对于ServerRoot路径。没有配置时默认的文件是/dev/stderr。若不想记录日志，指定文件为/dev/null。
AccessLog：设置存取日志文件，与ErrorLog类似。
UseLocaltime：设置使用本地时间，使用UTC时注释这个参数。这个参数没有值。
VerboseCGILogs：在错误日志文件中记录CGI启动和停止时间，若不记录，注释这个参数。这个参数没有值。
ServerName：指定服务器的名称，当客户端使用gethostname + gethostbyname时返回给客户端。
VirtualHost：虚拟主机开关。使用此参数，则会在DocumentRoot设定的目录添加一个ip地址作为新的DocumentRoot来处理客户端的请求。如DocumentRoot设置为/var/www，则则转换成/var/www/127.0.0.1/，若注释此参数，则为/var/www/。
DocumentRoot：HTML文件的根目录（也就是网站的目录）。
UserDir：指定用户目录。
DirectoryIndex：指定预生成目录信息的文件，注释此变量将使用DirectoryMaker变量。这个变量也就是设置默认主页的文件名。
DirectoryMaker：指定用于生成目录的程序，注释此变量将不允许列目录。
DirectoryCache：当DirectoryIndex文件不存在，而DirecotryMaker又被注释掉时，将列出这个参数指定目录给客户端。
KeepAliveMax：每个连接允许的请求数量。如果将此值设为" 0 "，将不限制请求的数目。
KeepAliveTimeOut：在关闭持久连接前等待下一个请求的秒数。（秒）。
MimeTypes：设置包含mimetypes信息的文件，一般是/etc/mime.types。
DefaultType：默认的mimetype类型，一般是text/html。
CGIPath：相当于给CGI程序使用的$PATH变量。
SinglePostLimit：一次POST允许最大的字节数，默认是1MB.
AddType: 增加MimeType没有指定的类型，例: AddType type extension [extension ...]。要使用cgi，必须添加cgi类型：AddType application/x-httpd-cgi cgi
Redirect：重定向文件
Aliases：指定路径的别名。
ScriptAlias：指定脚本路径的虚拟路径。