註: 以下文件乃編改自清大楓橋驛站 Maple BBS 3.02 版之使用手冊。
Quick Install Guide                                            [WindTopBBS]
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

                          WindTopBBS Ver 3.02

                             快速安裝文件

               Modified by 元智資工  沈俊興(statue.bbs@bbs.yzu.edu.tw)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

                        目      錄

                (一) 建立 BBS 帳號

                (二) 取得最新版本的 WindTopBBS

                (三) 編譯程式

                (四) 安裝及完成後的測試

                (五) 其他

──────────────────────────────────────
(一) 建立 BBS 帳號
──────────────────────────────────────

1.0     以 [root] 的帳號 login。

1.1     建立 [/home/bbs] 目錄作為 BBS 的家。

1.2     使用 vipw 增加下列 user :

        bbs:*:9999:99::0:0:BBS Administrator:/home/bbs:/bin/tcsh

        修改 bbs 使用者的密碼:

        passwd bbs

1.3     在 /etc/group 中設定 bbs 的 group :

        如果是 BSD 系統,請增加:

        bbs:*:99:bbs

        如果是 Linux 系統,請增加:

        bbs:*:999:bbs

        並修改 src/include/config.h 中的

        #define BBSGID          999

1.4     設定檔案的屬性:

        chown -R bbs.bbs /home/bbs

──────────────────────────────────────
(二) 取得最新版本的 WindTopBBS
──────────────────────────────────────

2.0     以 [bbs] 的帳號 login。

2.1     Anonymous ftp://ftp-cnpa.admin.yzu.edu.tw/WindTop/

2.2     將所取得的程式 WindTopBBS-xxx.tar.gz 放到 [home/bbs] 底下,執行:

           gtar xvfz WindTopBBS-xxx.tar.gz  (如果使用 GNU tar)
        或
           gzip -d WindTopBBS-xxx.tar.gz | tar xvf -

──────────────────────────────────────
(三) 編譯程式
──────────────────────────────────────

3.0     更換工作目錄至 src/include,修改 config.h

3.1     更換工作目錄至 src/lib,修改 Makefile,挑選合適的 OS 設定
        執行 make

3.2     依序更換工作目錄至 src/maple src/util src/bmtad src/bgopherd
        src/bpop3d,執行 make,依說明挑選合適的 OS,然後執行
        make os-type install

3.3     若須轉信則更換工作目錄至 src/innbbsd,修改 Makefile,設定
        適當之 ADMINUSER BBSHOME BBSADDR 三欄位
        執行 make 挑選合適的 OS,完成後執行 make install

──────────────────────────────────────
(四) 安裝及完成後的測試
──────────────────────────────────────

4.0     WindTopBBS 內含 telnetd、smtpd、fingerd、gopherd、pop3d
        若要使用上述 WindTopBBS 量身訂製的 daemon,請先停止系統原有相對
        應之服務。各 service 均可以 standalone 或是 inetd 啟動。

4.1     以 inetd 啟動:

        ■ 修改 /etc/inetd.conf,增加如下設定,若原先已有相同的 service
           請取消原先的設定。

telnet  stream  tcp     wait    bbs     /home/bbs/bin/bbsd      bbsd -i
finger  stream  tcp     wait    bbs     /home/bbs/bin/bguard    bguard -i
pop3    stream  tcp     wait    bbs     /home/bbs/bin/bpop3d    bpop3d -i
gopher  stream  tcp     wait    bbs     /home/bbs/bin/gemd      gemd -i
smtp    stream  tcp     wait    bbs     /home/bbs/bin/bmtad     bmtad -i
xchat   stream  tcp     wait    bbs     /home/bbs/bin/xchatd    xchatd -i
bbsnntp stream  tcp     wait    bbs     /home/bbs/innd/innbbsd  innbbsd -i

        ■ 修改 /etc/services,增加下列設定

xchat           3838/tcp
xchat           3838/udp
bbsnntp         7777/tcp           usenet       #Network News Transfer Protocol
bbsnntp         7777/udp           usenet       #Network News Transfer Protocol

        ■ 以 [root] 帳號執行 kill -1 `cat /var/run/inetd.pid`
           以重新啟動 inetd

4.2     以 standalone 啟動:

        ■ 先確定各 service 是否已有其他程式提供服務
        ■ 以 [root] 帳號執行

             /home/bbs/bin/bbsd
             /home/bbs/bin/gemd
             /home/bbs/bin/bpop3d
             /home/bbs/bin/bguard

4.3     以 [bbs] 帳號執行 bin/camera; bin/account; bin/xchatd

4.4     測試 bbs 主程式:

        telnet localhost
        打 [new] 來註冊,先以 [SYSOP] 這個 ID 來取得 BBS 站的管理權。

4.6     建立基本看板 [sysop]、[junk]、[deleted]、[ActiveInfo],先試試 post。

    ■ 請參照 doc/README.SYSOP 的 "如何建立看板?" 一節

4.7     再 new 一個 ID 試試 talk、chat。

[註1]  'sysop' 這個字不區分大小寫。
[註2]   inetd 與 standalone 可交叉配合使用,只要不相衝突即可
        另,M3 依然可用 sendmail 搭配 mailpost/bbsmail 運作。

[註3]   standalone daemon 測試正常後,可加入 /etc/rc.local 開機自動啟動

#
# WindTopBBS
#
su bbs -c '/home/bbs/bin/camera'

for i in /home/bbs/bin/bbsd /home/bbs/bin/bmtad /home/bbs/bin/bpop3d \
         /home/bbs/bin/gemd /home/bbs/bin/bguard /home/bbs/bin/xchatd ; do
       if test -x $i; then
               $i
       fi
done

if [ -f /home/bbs/innd/innbbsd ]; then
    su bbs -c '/home/bbs/innd/innbbsd'
fi


──────────────────────────────────────
(五) 其他
──────────────────────────────────────

5.0     如何放上新程式呢?
        因為目前 WindTopBBS 已經改為 daemon 啟動,所以在重跑新 daemon 之前
        需先將原先的 parent process kill 掉。

        執行方法:

        tail /home/bbs/run/bbs.pid 找出 processid

        246     30/Jul/1998 15:05:11    3001
        268     30/Jul/1998 15:05:11    3456
        244     30/Jul/1998 15:05:11    23

        列在第一欄的就是 pid,用 [root] 帳號執行 kill -9 246 268 244
        然後再重跑 bbsd 即可。

5.1     假如您要別人不用註冊就能參觀您的站台,請用 new 建立 guest 帳號,
        如果您不想有 geust 帳號,請在 etc/badid 中加入 guest。

5.2     另外,如果您使用 FreeBSD,請注意您系統的密碼編碼方式是 MD5 還是
        DES,若沒安裝的話,請先安裝 DES ,否則使用者將無法再次上站,
        因為 MD5 編碼後的長度超過 PASSLEN 。

5.3     寫了一個 sed.sh 用來替代相關的字串,如 "元智大學", "風之塔",
        "bbs.yzu.edu.tw", "140.138.2.235" 等字串,請修改 sed.sh 中的設定
        部分後使用,請在 install.sh 前使用,。 install.sh 將以上的步驟寫
        成 script ,如果是要安裝全新的 BBS 可以試試,目前在 FreeBSD 底下
        測試正常。
        sed.sh install.sh 仍在測試中,所以............:)

--
                                                    元智資工 沈俊興
                                   E-Mail: statue.bbs@bbs.yzu.edu.tw