| 1 | $Id$ |
|---|
| 2 | |
|---|
| 3 | kbsbbs 在 RedHat Linux 8/9 上的安装指南 |
|---|
| 4 | |
|---|
| 5 | 本文介绍如何在 RedHat Linux 8/9 系统上安装 kbsbbs 系统。与以往 |
|---|
| 6 | 安装方法不同的是，本文的方法尽可能使用 RedHat 自带的软件，例如 apache |
|---|
| 7 | 和 php 等。此外，本文的方法可使 kbsbbs 的 www 模块同时适合 apache 和 |
|---|
| 8 | apache2。 |
|---|
| 9 | |
|---|
| 10 | 1. 需要的软件 |
|---|
| 11 | httpd 必须 |
|---|
| 12 | httpd-devel 必须 |
|---|
| 13 | php 必须 |
|---|
| 14 | php-devel 必须 |
|---|
| 15 | zlib-devel 必须 |
|---|
| 16 | openssl-devel 必须 |
|---|
| 17 | gmp-devel 必须 |
|---|
| 18 | gd 必须 |
|---|
| 19 | libesmtp-devel 可选 |
|---|
| 20 | (以上软件可直接用 RedHat 光盘里的安装) |
|---|
| 21 | |
|---|
| 22 | mysql 可选 |
|---|
| 23 | mysql-devel 可选 |
|---|
| 24 | mysql-server 可选 |
|---|
| 25 | php-mysql 可选 |
|---|
| 26 | (以上 4 个只有当加入 mysql 支持的情况下才需要) |
|---|
| 27 | |
|---|
| 28 | autoconf-2.57 必须 |
|---|
| 29 | automake-1.6.X 必须 |
|---|
| 30 | libtool-1.4.X 必须 |
|---|
| 31 | (以上 3 个可以从 dev.kcn.cn 下载 rpm 包安装或者下载源代码自己编译安装) |
|---|
| 32 | |
|---|
| 33 | 2. 编译安装 kbsbbs |
|---|
| 34 | 下载 kbsbbs 的源代码有两种方法，一种是通过 cvs 方式获取，另一种是下载每 |
|---|
| 35 | 日更新的 kbsbbs-snapshot 代码包。用 cvs 方式下载源代码请参考 doc/README.cvs |
|---|
| 36 | 文件。 |
|---|
| 37 | |
|---|
| 38 | 注意在 site/ 子目录里面有名字为 fb2k-v2.c 和 fb2k-v2.h 的文件，这两个文件 |
|---|
| 39 | 是站点定制文件，本文以这两个文件为例子进行讲解。注意验证 fb2k-v2.h 文件中 |
|---|
| 40 | BBSUID 和 BBSGID 与本地系统的 bbs 用户的 uid gid 是否一致，如果不一致请调整到 |
|---|
| 41 | 一致。 |
|---|
| 42 | |
|---|
| 43 | |
|---|
| 44 | 然后进入 kbsbbs 的源代码目录，执行下列命令完成编译。 |
|---|
| 45 | contrib/build-RH9.sh |
|---|
| 46 | |
|---|
| 47 | 编译成功后，用下列命令进行安装。 |
|---|
| 48 | make install |
|---|
| 49 | make install-home |
|---|
| 50 | 然后将 kbsbbs 源代码目录 bbs2www/html 下的文件复制到 /var/www/html/。 |
|---|
| 51 | |
|---|
| 52 | 3. 运行 kbsbbs |
|---|
| 53 | 下面这些步骤有些需要 root 权限，为方便起见，直接切换到 root 用户。 |
|---|
| 54 | cd /usr/local |
|---|
| 55 | chown -R bbs:bbs bbs |
|---|
| 56 | cd bbs/bin |
|---|
| 57 | ./miscd daemon |
|---|
| 58 | ./bbslogd |
|---|
| 59 | ./bbsd -p 23 (可以使用其他端口，如果用 23 的话， |
|---|
| 60 | 需要把系统的 telnet 服务关闭) |
|---|
| 61 | ./newpop3d (提供 POP3/POP3S 方式取信) |
|---|
| 62 | |
|---|
| 63 | 如果还想提供 ssh 方式的连接，请阅读 doc/INSTALL.ssh 文件。 |
|---|
| 64 | |
|---|
| 65 | 4. 初始化 kbsbbs |
|---|
| 66 | 首先登录到 bbs 上，用 telnet 127.0.0.1 命令，如果 bbsd 不是运行在 23 |
|---|
| 67 | 端口，则还需在命令行上提供端口参数。 |
|---|
| 68 | |
|---|
| 69 | 连上 bbs 之后，首先输入 new 新建 SYSOP 帐号，一定要用全部大写的 SYSOP。 |
|---|
| 70 | 然后再新建一个 guest 帐号(kbsbbs 的 www 模块要求系统中必须有 guest 用户)。 |
|---|
| 71 | |
|---|
| 72 | 其他的管理功能比如开版操作可以用 SYSOP 帐号进行，可以参考 kbsbbs 中 |
|---|
| 73 | doc/ 目录的文件及 水木社区 (http://newsmth.net/) BBSMan_Dev 版的文章。 |
|---|
| 74 | |
|---|
| 75 | 5. 配置 apache 和 php |
|---|
| 76 | 下面这些步骤同样用 root 用户进行。 |
|---|
| 77 | cd /usr/lib/php4 (或者是 /usr/lib/php) |
|---|
| 78 | ln -s /var/www/libexec/bbs/libphpbbslib.so |
|---|
| 79 | |
|---|
| 80 | 编辑 /etc/php.ini 文件，修改 |
|---|
| 81 | short_open_tag = Off |
|---|
| 82 | magic_quotes_gpc = off |
|---|
| 83 | 在 Dynamic Extension 之下添加 |
|---|
| 84 | extension=libphpbbslib.so |
|---|
| 85 | |
|---|
| 86 | cd /etc/httpd/conf |
|---|
| 87 | 编辑 httpd.conf 文件，修改 |
|---|
| 88 | User bbs |
|---|
| 89 | Group bbs |
|---|
| 90 | 修改默认 Charset 头，在文件适当位置加入 |
|---|
| 91 | AddLanguage zh-cn .cn |
|---|
| 92 | AddLanguage cn .cn |
|---|
| 93 | AddCharset gb2312 .Gb2312 .gb2312 |
|---|
| 94 | AddDefaultCharset gb2312 |
|---|
| 95 | |
|---|
| 96 | 特别提醒千万不要在 httpd.conf 里面加入 AddType application/x-httpd-php .php， |
|---|
| 97 | 因为 /etc/httpd/conf.d/php.conf 已经设置了 PHP filter。 |
|---|
| 98 | |
|---|
| 99 | 最后使用 /etc/rc.d/init.d/httpd start 来启动 httpd 服务，如果原来已经 |
|---|
| 100 | 启动了 httpd 服务，则可通过 /etc/rc.d/init.d/httpd restart 来重启 httpd 服务。 |
|---|
| 101 | |
|---|
| 102 | 6. 出现故障 |
|---|
| 103 | 下面的方法可用来检查 kbsbbs 的 phpbbslib extension 是否起作用。 |
|---|
| 104 | |
|---|
| 105 | 编写 info.php 文件，置于 /var/www/html 目录中，内容如下： |
|---|
| 106 | <?php |
|---|
| 107 | phpinfo(); |
|---|
| 108 | ?> |
|---|
| 109 | |
|---|
| 110 | 然后在浏览器中输入地址 http://server_address/info.php，查看输出页面， |
|---|
| 111 | 如果页面中没有 kbs_bbs support enabled 这一行，说明 kbsbbs 的 phpbbslib |
|---|
| 112 | extension 没有起作用。 |
|---|
| 113 | |
|---|
| 114 | 最后要把 info.php 文件删除。 |
|---|
| 115 | |
|---|
| 116 | 其他问题请发信给 dev@dev.kcn.cn |
|---|
| 117 | |
|---|
