boa服务器移植

Boa在PC平台上开发环境的搭建

 

STEP 1：

# cd boa-0.94.13-i386/src

# ./configure

# make

 

STEP 2：

在/etc目录下建立一个boa目录，在里面放置Boa的主要配置文件boa.conf，可以从Boa-0.94.13-i386下拷贝，修改配置文件如下：

Group nogroup 修改为 Group 0

ScriptAlias /cgi-bin/ /usr/lib/cgi-bin 修改为 ScriptAlias /cgi-bin/ /var/www/cgi-bin

其它采用默认设置。

 

STEP 3：

建立日志文件所在目录，/var/log/boa

建立HTML文档所在目录，/var/www，将静态网页存入该目录（可将主机/usr/share/doc/HTML目录下的index.html文件和img目录复制到/var/www目录下）。

建立CGI脚本所在目录/var/www/cgi-bin，将cgi脚本放在该目录下（在example/cgi-test.cgi）。

 

STEP 4：测试

在虚拟机上运行Boa程序，在Windows中打开IE，输入1，即打开/var/www/index.html。

拷贝boa-0.94.13-i386/examples/cgi-test.cgi到/var/www/cgi-bin目录下，在Windows IE中输入，可打开Boa CGI test

 

boa服务器移植:

一> 编译boa程序
1. www.boa.org下载boa-0.94.13.tar.gz
2. 解压
3. ./configure
4. make
编译时用2.95.3以上的版本会出错：
util.c: 100: 1: pasting “t” and “->” does not give a valid preprocessing token make: [util.o] Error1

解决方法:
方法1>. 修改compat.h中的
#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff
为：
#define TIMEZONE_OFFSET(foo) foo->tm_gmtoff

方法2>. 改用2.95.3版本的编译器。

二> 修改配置文件boa.conf (配置的时候，配置文件的目录可根据自己的情况设置路径，主要考虑到可写问题)
 1. 建立/etc/boa目录, 并复制boa.conf到/etc/boa目录下，并按照以下步骤进行修改。
 2. 修改访问权限：修改User nobody 为 User 0 ; 修改Group nogroup 为 Group 0
 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.)

 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 下通过http://172.20.223.151这种形式访问，进行测试。


五> 移植到开发板
  1>. (第一.3步)操作完成之后，修改Makefile文件:
   将:
    CC = gcc
    CPP = gcc -E    
   该为:
    CC = arm-linux-gcc
    CPP = arm-linux-gcc -E
   make即可。
  2>. 拷贝PC上/etc/mime.types文件到开发板/etc目录下
      或者将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


六> 常见错误：
 1>. 错误1: gethostbyname:: No such file or directory
     解决办法: 修改boa.conf 去掉 ServerName www.your.org.here 前的注释符号(#)
 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