boa移值手册

Boa版本：
boa-0.94.13
交叉编译器版本：
arm-linux-gcc 4.1.2
操作系统平台：
Linux -- Red Hat 9.0
开发板平台：
Arm -- TX2440A
说明：Boa服务器的移植可分成两部分，一个是在x86平台上移植，即在虚拟机的linux下，另一个是在arm平台上移植，即在开发板上的linux下，本手册的前四步，都是在虚拟机上做移植，第五步是移植到发开板上。
一> 编译boa程序
1. 下载boa-0.94.13.tar.gz
2. 解压
3. #./configure
4. #make
编译会出错：
util.c: 100: 1: pasting “t” and “->” does not give a valid preprocessing token make: [util.o] Error1
解决方法:
修改compat.h中的
#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff
为：
#define TIMEZONE_OFFSET(foo) foo->tm_gmtoff
二> 修改配置文件boa.conf
1. 建立/etc/boa目录, 并复制boa.conf到/etc/boa目录下，并按照以下步骤进行修改。
2. 修改访问权限：修改User nobody 为 User 0 ; 修改Group nogroup 为 Group 0
2
3. 设定日志目录：boa日志有两部分，Errorlog 和 AccessLog
一般情况下为/var/log/boa/error_log 和 /var/log/boa/access_log两个文件。所以根据自己的情况情况设置日志目录：
ErrorLog /var/log/boa/error_log
AccessLog /var/log/boa/access_log
(注意:这里/var/log/boa目录必须为可写，否则会出项错误:log.c:73 – Unable to dup2 the error log: Bad file r.)
在启动脚本里将var挂载成ramfs: mount –n –t ramfs ramfs /var
4. 设置html文件目录: DocumentRoot /var/www
5. 设置默认首页: DirectoryIndex index.html
6. 设置cgi脚本目录: 将
ScriptAlias /cgi-bin/ /usr/lib/cgi-bin
修改为
ScriptAlias /cgi-bin/ /var/www/cgi-bin
这些目录可以自己修改，但是要和网页存放的目录一致
三> 根据第二步设置建立相关文件夹并放入文件:
1. 根据(第二.3步)的设置建立/var/boa 文件夹。
2. 根据(第二.4步)的设置建立/var/www 文件夹, 并在此目录下存放html文件(包括index.html文件)。
3. 根据(第二.6步)的设置建立/var/www/cgi-bin 文件夹, 并存放一些用来测试的cgi脚本。
四> OK，运行boa程序。
在windows 下通过(虚拟机的IP地址)这种形式访问，进行测试。
五> 移植到开发板
1>. (第一.3步)操作完成之后，修改Makefile文件:
将:
CC = gcc
CPP = gcc -E
该为:
CC = arm-linux-gcc
CPP = arm-linux-gcc -E
#make
3
#arm-linux-strip boa //去掉调试信息，减少boa体积
2>. 拷贝PC上/etc/mime.types文件到开发板/etc目录下
如果不用mimi.types，可将boa.conf文件中
MimeTypes /etc/mime.types
修改为:
MimeTypes /dev/null
boa配置相关目录:
1. boa.conf 的存放目录:
默认boa.conf是在/etc/boa.conf目录的，boa运行时会自动去找/etc/bon.conf目录。
这个设定是在define.h文件中定义的，可在编译之前进行修改。
2. log目录: 分为 Errorlog 和 AccessLog 两个目录，可在boa.conf中修改。
如:
ErrorLog /var/log/boa/error_log
AccessLog /var/log/boa/access_log
3. html文件存放目录, 可在boa.conf文件中修改。
如: DocumentRoot /var/www
4. cgi脚本存放目录, 可在boa.conf文件中修改。
如: ScriptAlias /cgi-bin/ /var/www/cgi-bin
5. mime.types存放目录, 可在boa.conf文件中修改。
如: MimeTypes /etc/mime.types
将网页文件放在/var/www目录下，cgi脚本放在/var/www/cgi-bin目录下。
在开发板上运行boa，在主机IE上输入开发板IP，可看到网页
六> 常见错误：
这些错误内容可查看/var/log/boa/error_log文件
1>. 错误1: gethostbyname:: No such file or directory
解决办法: 修改boa.conf 去掉 ServerName 前的注释符号(#)
4
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 bug!: 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
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