ythtbbs安装
ytht bbs 安裝手冊
本文由 ytht系統(tǒng)維護(hù)組負(fù)責(zé)維護(hù)。
在參閱多人文章后整理得到。
您認(rèn)為在本文中發(fā)現(xiàn)了懷疑有錯的地方，或是不通的語句、錯字別字，請與sofire@ytht.net聯(lián)系。
準(zhǔn)備工作：
1:確認(rèn)安裝了常見開發(fā)軟件包，如 gcc ，autoconf，automake等
2:如果要安裝運(yùn)行web服務(wù)，確認(rèn)安裝了apache服務(wù)器
3:有root權(quán)限，同時不要過分使用，否則很容易出權(quán)限問題
4:可以不安裝mysql, fastcgi等軟件，這些可以在完善系統(tǒng)時考慮
5:了解su useradd passwd cvs 等命令的使用，和環(huán)境變量的知識
下面以rh9環(huán)境說明ytht的安裝。
過程中沒有提到安裝錯誤，如果遇到，請參閱本文后面的補(bǔ)充說明。
一： 建立bbs用戶
使用下面的命令建立用戶
$ su -
[root]# useradd -u9999 -g99 －d /home/bbs bbs
[root]# passwd bbs
添加bbs帳戶，用戶id是9999,組id是99，初始目錄是/home/bbs ，目錄可以按照需要改動。
二：獲得ytht最新代碼
下載ytht的源代碼，并放在/home/src目錄下，：
[root]# cvs -z9 co -d /home/src bbs ?＃這步可以省掉，但是你應(yīng)該知道代碼放的位置
把代碼屬主更改成bbs：
[root]# chown -R 9999.99 /home/src
下面開始安裝telnet服務(wù)的安裝
三：配置編譯參數(shù)
現(xiàn)在不需要用root權(quán)限，換成bbs用戶吧。
[bbs]$ cd /home/src
[bbs]$ ./makedist.sh
[bbs]$ ./configure
注意 checking for xxx 信息，如果出現(xiàn) no，表明有的服務(wù)暫時不能使用。但不影響基本服務(wù)的安裝
然后出現(xiàn)：
Home directory of BBS --> [/home/bbs]
UID of BBS --> [9999]
GID of BBS --> [99]
USER of BBS --> [bbs]
The ID of your site --> [YTHT]
The name of your site --> [一塌糊涂 BBS]
The domain name of your site --> [ytht.net]
The ip address of your site --> [162.105.31.222]
The location of your site --> [北京大學(xué)]
Email of your bbs administrator --> [sysop@ytht.org]
Maximum number of users --> [250000]
Maximum number of boards --> [1000]
Maximum number of on-line users --> [30000]
Runtime Maximum number of on-line users --> [30000]
BBS listen port --> [23]
BBS listen port(BIG5) --> [2300]
MySQL DATABASE NAME --> [test]
MySQL USER NAME --> [test]
MySQL USER PASSWORD --> [test]
cgi install directory --> [/home/httpd/cgi-bin]
html install directory --> [/home/httpd/html/2001]
the initial mark string for webpage --> [Ytht.Net]
上面的信息，按照實(shí)際情況填寫，如果不滿意，可以重新運(yùn)行 ./configure ，再次填寫。
更多內(nèi)容，請參閱 bbsconfig 文件。
四：編譯源代碼并安裝telnet服務(wù)
[bbs]$ make
這一步會自動編譯安裝 /home/src/ythtlib 和 /home/src/libythtbbs 下的內(nèi)容，并編譯
/home/src/src 和 /home/src/local_utl 下的內(nèi)容。編譯通過后, 繼續(xù)運(yùn)行：
[bbs]$ make install
這一步會建立 bbs 的目錄系統(tǒng)，并安裝 /home/src/local_utl 和 /home/src/src 下的可
執(zhí)行程序到 bbs 的 bin 目錄。
如果已經(jīng)存在/home/bbs目錄，會出現(xiàn)提示： Warning: /home/bbs already exists, overwrite whole bbs
輸入 y 繼續(xù)，請?zhí)貏e注意，如果以前安裝過bbs， 會覆蓋很多東西，比如 .BOARDS 文件，導(dǎo)致新開的版丟失；
.PASSWDS文件，導(dǎo)致所有的用戶資料丟失；就這兩樣你就知道這個操作的危險性了。
所以，只有在首次安裝bbs 或者完全重新安裝時，才可以在/home/src 目錄下使用 make install。
為了更高效的運(yùn)行telnet服務(wù)，加入下面工作：
[root]# mount none /home/bbs/bbstmpfs -t tmpfs -o size=128m
[bbs]$ ?cd /home/bbs
[bbs]$ ?ln -s /home/bbs/bbstmpfs/tmp tmpfast
[bbs]$ ?ln -s /home/bbs/bbstmpfs/dynamic dynamic
初始化 shm：
[bbs]$ /home/bbs/bin/shminit
運(yùn)行bbsd 守護(hù)程序：
[root]# /home/bbs/bin/bbsd
到此，telnet 服務(wù)基本安裝完成！
五：登錄注冊 SYSOP 和 guest 賬號
注意 SYSOP 賬號的大小寫。
到此，就可以輕松一下了。
六：配置web服務(wù)
確認(rèn)安裝了apache，如果沒有，可以用redhat9帶的rpm包安裝；也可以用ytht帶的源代碼安裝，詳情參閱補(bǔ)充說明，此處以rehdat9的默認(rèn)安裝為例。
修改配置文件 httpd.conf
本文使用ytht默認(rèn)參數(shù)，故
user 和 group 屬性就是 bbs
cgi-bin目錄的路徑是： /home/httpd/cgi-bin
html目錄路徑是：/home/httpd/html/2001
SMAGIC ,即the initial mark string ，設(shè)置的是 Ytht.Net
按照上面的參數(shù)修改配置文件（只列出修改過的地方），您在設(shè)置的時候，請使用正確的參數(shù)。：
1. 修改user 和 group 屬性
?User bbs
?Group bbs
2. 修改cgi-bin的目錄的路徑
?ScriptAlias /cgi-bin/ "/home/httpd/cgi-bin"
?<Directory "/home/httpd/cgi-bin">
3. 修改html目錄的路徑
?DocumentRoot "/home/httpd/html/2001"
?<Directory "/home/httpd/html/2001">
4. 加上url重寫規(guī)則，在配置文件最后添加上
?RewriteEngine on
?RewriteRule ^/Ytht.Net(.*)/bbschat(.*) /cgi-bin/www/bbschat [PT]
?RewriteRule ^/Ytht.Net(.*)$ /cgi-bin/www [PT]
?RewriteRule ?^/$ ???????/cgi-bin/www [PT]
七：運(yùn)行web服務(wù)
[root]# /etc/init.d/httpd start
用瀏覽器登錄，終于看到糊涂的小白菜了......
并且能正常登錄
發(fā)表一下文章看看......正常
到此，想必你已經(jīng)精疲力盡了。該好好休息一下。
八：補(bǔ)充說明
安裝bbs，沒有不出問題的。所以，必須要有良好的心理素質(zhì)。
下面的問題，都是經(jīng)典。不得不看。
1. nobody的組號也是99
把/etc/group中的nobody改成bbs；或者把nobody的組號換成一個其他數(shù)，比如98，再建立bbs組，或者不改也可以。
順便說一下， bbs的uid和gid沒有固定的數(shù)值，可以是任意的；也沒有固定的id，用sbb也可以。
只需要在 configure 時候填寫正確的 bbsusername uid gid 即可
2. 運(yùn)行./makedist.sh時出現(xiàn)下面的錯誤：
cp: cannot stat `/usr/share/automake/config.sub': No such file or directory
cp: cannot stat `/usr/share/automake/config.guess': No such file or directory
cp: cannot stat `/usr/share/automake/install-sh': No such file or directory
在/usr/share目錄下，可能有 automake-1.4 automake-1.5 automake-1.6 ，但沒有 automake 目錄，
所以，修改一下makedist.sh文件，把/usr/share/automake換成/usr/share/automake-1.6，
或者用下面命令：
[root]# ln -s /usr/share/automake-1.6 /usr/share/automake
此處選擇了版本較高的automake，沒有特別的原因。
3. 運(yùn)行./configure命令時出現(xiàn) checking for xxxxxxx ??no
如果不影響下一步，可以暫時不管。在完善系統(tǒng)時再安裝。當(dāng)然，現(xiàn)在安裝上更好。具體安裝方法參閱其他文章。（如過還沒有，請到y(tǒng)tht的bbsdev版查找）
4. the initial mark string for webpage是什么意思？
看個實(shí)例： http://www.ytht.net/Ytht.NetBNLAAACWVZHCONHFTJTZHNCXDGEEFBVRCWZWP_B/?t=1080891866
??????????????????????????????～～～～～就是這個
在bbsconfig 文件中是 LAST_SMAGIC
???????????????
5. 不想每次運(yùn)行./configure 時都重新填寫一遍
修改/home/bbs/bbsconfig 文件 。
6. 關(guān)于mount命令
因?yàn)閠mpfs每次重啟機(jī)器都要mount，于是在/etc/fstab的最后加一行
/home/bbs/bbstmpfs ?????/home/bbs/bbstmpfs ?????tmpfs ??size=8M 0 0
大小的選擇：一般來說，18000人的站點(diǎn)，tmpfs 尺寸在512M比較合適，
一般的站點(diǎn)，根據(jù)自己的內(nèi)存規(guī)模和上站人數(shù)適當(dāng)調(diào)整即可，
由于內(nèi)核的分配特點(diǎn)，這里如果分配大了，實(shí)際上不會浪費(fèi)內(nèi)存的
7. 為什么不能把 bbsd 綁定在 23號端口
使用 root 賬號
8. 錯誤提示： please init shm first
沒有運(yùn)行 bin/shminit 程序
沒有這個程序？忘了在 local_utl目錄下運(yùn)行 make install 了。
9. 注冊了 sysop 賬號，但不是 SYSOP（注意全是大寫），怎么辦
重新注冊！ 把賬號文件 /home/bbs/.PASSWDS 刪了，或者把文件中的sysop改成其他賬號名，然后重新注冊。
10. 怎么配置 httpd.conf 都不能成
運(yùn)行下面的命令，看看輸出:
export SCRIPT_URL=/
/home/httpd/cgi-bin/www
如果正確，應(yīng)該是 ytht 的首頁
11. 什么是“沒有實(shí)現(xiàn)的功能”
輸入了不正確的參數(shù)給www，比如把login 輸入為 logni ，或者其他一些不知名的原因。
12. 不能看圖 ??
上面的安裝說明中沒有安裝這個附件：atthttpd
到 /home/bbs/src/atthttpd 目錄下運(yùn)行：
??make
??[bbs] ./atthttpd
注意：不要 用root賬號，而 是 bbs 賬號
13. 尋找錯誤的蛛絲馬跡
stdout stderr －－標(biāo)準(zhǔn)輸出，標(biāo)準(zhǔn)錯誤輸出，其實(shí)是指屏幕信息，大部分的問題都在屏幕上
/home/bbs/deverrlog －－ bbs 常見錯誤
/var/log/httpd/* ?－－httpd 服務(wù)不正常，就趕緊到這里來看原因，有的系統(tǒng)可能不在這里，而在其他地方。
gdb －－自己調(diào)試吧
14. 怎么安裝 software 目錄下的軟件
太復(fù)雜，這兒提供不了，得在其他文檔中說明。
15. 怎么安裝 xxx ？
請參閱《安裝xxx》（可能還沒有寫呢，別急，會有的）。
本文參考：
littleflypig的《今天cvs安裝ytht的筆記》
小椰子的《2003.01.10 ythtbbs代碼的安裝步驟》
lepton的《關(guān)于BBS代碼安裝使用修改的幾個tips》
本文由 ytht系統(tǒng)維護(hù)組負(fù)責(zé)維護(hù)。
在參閱多人文章后整理得到。
您認(rèn)為在本文中發(fā)現(xiàn)了懷疑有錯的地方，或是不通的語句、錯字別字，請與sofire@ytht.net聯(lián)系。
準(zhǔn)備工作：
1:確認(rèn)安裝了常見開發(fā)軟件包，如 gcc ，autoconf，automake等
2:如果要安裝運(yùn)行web服務(wù)，確認(rèn)安裝了apache服務(wù)器
3:有root權(quán)限，同時不要過分使用，否則很容易出權(quán)限問題
4:可以不安裝mysql, fastcgi等軟件，這些可以在完善系統(tǒng)時考慮
5:了解su useradd passwd cvs 等命令的使用，和環(huán)境變量的知識
下面以rh9環(huán)境說明ytht的安裝。
過程中沒有提到安裝錯誤，如果遇到，請參閱本文后面的補(bǔ)充說明。
一： 建立bbs用戶
使用下面的命令建立用戶
$ su -
[root]# useradd -u9999 -g99 －d /home/bbs bbs
[root]# passwd bbs
添加bbs帳戶，用戶id是9999,組id是99，初始目錄是/home/bbs ，目錄可以按照需要改動。
二：獲得ytht最新代碼
下載ytht的源代碼，并放在/home/src目錄下，：
[root]# cvs -z9 co -d /home/src bbs ?＃這步可以省掉，但是你應(yīng)該知道代碼放的位置
把代碼屬主更改成bbs：
[root]# chown -R 9999.99 /home/src
下面開始安裝telnet服務(wù)的安裝
三：配置編譯參數(shù)
現(xiàn)在不需要用root權(quán)限，換成bbs用戶吧。
[bbs]$ cd /home/src
[bbs]$ ./makedist.sh
[bbs]$ ./configure
注意 checking for xxx 信息，如果出現(xiàn) no，表明有的服務(wù)暫時不能使用。但不影響基本服務(wù)的安裝
然后出現(xiàn)：
Home directory of BBS --> [/home/bbs]
UID of BBS --> [9999]
GID of BBS --> [99]
USER of BBS --> [bbs]
The ID of your site --> [YTHT]
The name of your site --> [一塌糊涂 BBS]
The domain name of your site --> [ytht.net]
The ip address of your site --> [162.105.31.222]
The location of your site --> [北京大學(xué)]
Email of your bbs administrator --> [sysop@ytht.org]
Maximum number of users --> [250000]
Maximum number of boards --> [1000]
Maximum number of on-line users --> [30000]
Runtime Maximum number of on-line users --> [30000]
BBS listen port --> [23]
BBS listen port(BIG5) --> [2300]
MySQL DATABASE NAME --> [test]
MySQL USER NAME --> [test]
MySQL USER PASSWORD --> [test]
cgi install directory --> [/home/httpd/cgi-bin]
html install directory --> [/home/httpd/html/2001]
the initial mark string for webpage --> [Ytht.Net]
上面的信息，按照實(shí)際情況填寫，如果不滿意，可以重新運(yùn)行 ./configure ，再次填寫。
更多內(nèi)容，請參閱 bbsconfig 文件。
四：編譯源代碼并安裝telnet服務(wù)
[bbs]$ make
這一步會自動編譯安裝 /home/src/ythtlib 和 /home/src/libythtbbs 下的內(nèi)容，并編譯
/home/src/src 和 /home/src/local_utl 下的內(nèi)容。編譯通過后, 繼續(xù)運(yùn)行：
[bbs]$ make install
這一步會建立 bbs 的目錄系統(tǒng)，并安裝 /home/src/local_utl 和 /home/src/src 下的可
執(zhí)行程序到 bbs 的 bin 目錄。
如果已經(jīng)存在/home/bbs目錄，會出現(xiàn)提示： Warning: /home/bbs already exists, overwrite whole bbs
輸入 y 繼續(xù)，請?zhí)貏e注意，如果以前安裝過bbs， 會覆蓋很多東西，比如 .BOARDS 文件，導(dǎo)致新開的版丟失；
.PASSWDS文件，導(dǎo)致所有的用戶資料丟失；就這兩樣你就知道這個操作的危險性了。
所以，只有在首次安裝bbs 或者完全重新安裝時，才可以在/home/src 目錄下使用 make install。
為了更高效的運(yùn)行telnet服務(wù)，加入下面工作：
[root]# mount none /home/bbs/bbstmpfs -t tmpfs -o size=128m
[bbs]$ ?cd /home/bbs
[bbs]$ ?ln -s /home/bbs/bbstmpfs/tmp tmpfast
[bbs]$ ?ln -s /home/bbs/bbstmpfs/dynamic dynamic
初始化 shm：
[bbs]$ /home/bbs/bin/shminit
運(yùn)行bbsd 守護(hù)程序：
[root]# /home/bbs/bin/bbsd
到此，telnet 服務(wù)基本安裝完成！
五：登錄注冊 SYSOP 和 guest 賬號
注意 SYSOP 賬號的大小寫。
到此，就可以輕松一下了。
六：配置web服務(wù)
確認(rèn)安裝了apache，如果沒有，可以用redhat9帶的rpm包安裝；也可以用ytht帶的源代碼安裝，詳情參閱補(bǔ)充說明，此處以rehdat9的默認(rèn)安裝為例。
修改配置文件 httpd.conf
本文使用ytht默認(rèn)參數(shù)，故
user 和 group 屬性就是 bbs
cgi-bin目錄的路徑是： /home/httpd/cgi-bin
html目錄路徑是：/home/httpd/html/2001
SMAGIC ,即the initial mark string ，設(shè)置的是 Ytht.Net
按照上面的參數(shù)修改配置文件（只列出修改過的地方），您在設(shè)置的時候，請使用正確的參數(shù)。：
1. 修改user 和 group 屬性
?User bbs
?Group bbs
2. 修改cgi-bin的目錄的路徑
?ScriptAlias /cgi-bin/ "/home/httpd/cgi-bin"
?<Directory "/home/httpd/cgi-bin">
3. 修改html目錄的路徑
?DocumentRoot "/home/httpd/html/2001"
?<Directory "/home/httpd/html/2001">
4. 加上url重寫規(guī)則，在配置文件最后添加上
?RewriteEngine on
?RewriteRule ^/Ytht.Net(.*)/bbschat(.*) /cgi-bin/www/bbschat [PT]
?RewriteRule ^/Ytht.Net(.*)$ /cgi-bin/www [PT]
?RewriteRule ?^/$ ???????/cgi-bin/www [PT]
七：運(yùn)行web服務(wù)
[root]# /etc/init.d/httpd start
用瀏覽器登錄，終于看到糊涂的小白菜了......
并且能正常登錄
發(fā)表一下文章看看......正常
到此，想必你已經(jīng)精疲力盡了。該好好休息一下。
八：補(bǔ)充說明
安裝bbs，沒有不出問題的。所以，必須要有良好的心理素質(zhì)。
下面的問題，都是經(jīng)典。不得不看。
1. nobody的組號也是99
把/etc/group中的nobody改成bbs；或者把nobody的組號換成一個其他數(shù)，比如98，再建立bbs組，或者不改也可以。
順便說一下， bbs的uid和gid沒有固定的數(shù)值，可以是任意的；也沒有固定的id，用sbb也可以。
只需要在 configure 時候填寫正確的 bbsusername uid gid 即可
2. 運(yùn)行./makedist.sh時出現(xiàn)下面的錯誤：
cp: cannot stat `/usr/share/automake/config.sub': No such file or directory
cp: cannot stat `/usr/share/automake/config.guess': No such file or directory
cp: cannot stat `/usr/share/automake/install-sh': No such file or directory
在/usr/share目錄下，可能有 automake-1.4 automake-1.5 automake-1.6 ，但沒有 automake 目錄，
所以，修改一下makedist.sh文件，把/usr/share/automake換成/usr/share/automake-1.6，
或者用下面命令：
[root]# ln -s /usr/share/automake-1.6 /usr/share/automake
此處選擇了版本較高的automake，沒有特別的原因。
3. 運(yùn)行./configure命令時出現(xiàn) checking for xxxxxxx ??no
如果不影響下一步，可以暫時不管。在完善系統(tǒng)時再安裝。當(dāng)然，現(xiàn)在安裝上更好。具體安裝方法參閱其他文章。（如過還沒有，請到y(tǒng)tht的bbsdev版查找）
4. the initial mark string for webpage是什么意思？
看個實(shí)例： http://www.ytht.net/Ytht.NetBNLAAACWVZHCONHFTJTZHNCXDGEEFBVRCWZWP_B/?t=1080891866
??????????????????????????????～～～～～就是這個
在bbsconfig 文件中是 LAST_SMAGIC
???????????????
5. 不想每次運(yùn)行./configure 時都重新填寫一遍
修改/home/bbs/bbsconfig 文件 。
6. 關(guān)于mount命令
因?yàn)閠mpfs每次重啟機(jī)器都要mount，于是在/etc/fstab的最后加一行
/home/bbs/bbstmpfs ?????/home/bbs/bbstmpfs ?????tmpfs ??size=8M 0 0
大小的選擇：一般來說，18000人的站點(diǎn)，tmpfs 尺寸在512M比較合適，
一般的站點(diǎn)，根據(jù)自己的內(nèi)存規(guī)模和上站人數(shù)適當(dāng)調(diào)整即可，
由于內(nèi)核的分配特點(diǎn)，這里如果分配大了，實(shí)際上不會浪費(fèi)內(nèi)存的
7. 為什么不能把 bbsd 綁定在 23號端口
使用 root 賬號
8. 錯誤提示： please init shm first
沒有運(yùn)行 bin/shminit 程序
沒有這個程序？忘了在 local_utl目錄下運(yùn)行 make install 了。
9. 注冊了 sysop 賬號，但不是 SYSOP（注意全是大寫），怎么辦
重新注冊！ 把賬號文件 /home/bbs/.PASSWDS 刪了，或者把文件中的sysop改成其他賬號名，然后重新注冊。
10. 怎么配置 httpd.conf 都不能成
運(yùn)行下面的命令，看看輸出:
export SCRIPT_URL=/
/home/httpd/cgi-bin/www
如果正確，應(yīng)該是 ytht 的首頁
11. 什么是“沒有實(shí)現(xiàn)的功能”
輸入了不正確的參數(shù)給www，比如把login 輸入為 logni ，或者其他一些不知名的原因。
12. 不能看圖 ??
上面的安裝說明中沒有安裝這個附件：atthttpd
到 /home/bbs/src/atthttpd 目錄下運(yùn)行：
??make
??[bbs] ./atthttpd
注意：不要 用root賬號，而 是 bbs 賬號
13. 尋找錯誤的蛛絲馬跡
stdout stderr －－標(biāo)準(zhǔn)輸出，標(biāo)準(zhǔn)錯誤輸出，其實(shí)是指屏幕信息，大部分的問題都在屏幕上
/home/bbs/deverrlog －－ bbs 常見錯誤
/var/log/httpd/* ?－－httpd 服務(wù)不正常，就趕緊到這里來看原因，有的系統(tǒng)可能不在這里，而在其他地方。
gdb －－自己調(diào)試吧
14. 怎么安裝 software 目錄下的軟件
太復(fù)雜，這兒提供不了，得在其他文檔中說明。
15. 怎么安裝 xxx ？
請參閱《安裝xxx》（可能還沒有寫呢，別急，會有的）。
本文參考：
littleflypig的《今天cvs安裝ytht的筆記》
小椰子的《2003.01.10 ythtbbs代碼的安裝步驟》
lepton的《關(guān)于BBS代碼安裝使用修改的幾個tips》
總結(jié)
- 上一篇： 经典对白2
- 下一篇： 信息收集之——FOFA网站常用搜索语法