summaryrefslogblamecommitdiffstats
path: root/docs/INSTALL
blob: 6b7d8c817147a1ab0c373c33047a670628580880 (plain) (tree)






















                                                           









                                                                           

                                                                            
                   
                                                                     
                                                         
                                            

                                                     



                                         


                                     
 
                       




                                                               



                                                                          



                                                                      

                                     



                                                                 

                                                                       
                                                                    



                                                        
底下是快速安裝的方法

==

先取得 root 權限

1. 打 vipw, 加入底下兩行

   bbs:*:9999:99::0:0:Ptt BBS:/home/bbs:/home/bbs/bin/bbsrf
   bbsadm::9999:99::0:0:Ptt BBS:/home/bbs:/bin/csh

2. 執行 passwd bbsadm 設 bbsadm的密碼
3. 在 /etc/group 中加入一行

   bbs:*:99:

4. 執行 mkdir /home/bbs
5. 執行 chown bbs.bbs /home/bbs
6. 執行 chmod 700 /home/bbs

然後切換成 bbsadm 的身份

7. 取得解開 pttbbs-VERSION.tar.gz (任何目錄下皆可).

   或透過 cvs來取得 (強烈建議)
   touch ~/.cvspass
   cvs -d :pserver:cvs@ptt2.csie.ntu.edu.tw:/var/db/cvsroot login
    (不用打密碼, 直接按 Enter過去)
   cvs -d :pserver:cvs@ptt2.csie.ntu.edu.tw:/var/db/cvsroot checkout pttbbs
   使用此法的朋友, 將來您可以直接在 pttbbs/ 下用
      cvs update
   更新到最新版本的 pttbbs

8. 執行 cd pttbbs
9. 如果之前沒有設定過 pttbbs.conf 的話, 請 cp sample/pttbbs.conf pttbbs.conf
10.修改 pttbbs.conf
 * 如果您是用 Linux系統, 請先安裝 pmake, 然後將 make alias 成 pmake *
11.執行 make OSTYPE=FreeBSD BBSHOME=/home/bbs all install
    (Linux使用者請把 "FreeBSD" 改成 "linux")
12.如果是新架起來的站, 請執行 cd sample; make install
13.執行 cd /home/bbs; bin/initbbs

假如一切都很順利的話,這樣子大概就安裝完了
接下來是啟動 bbs 的部份

14.執行 bin/uhash_loader (*註1, *註2)
15.執行 bin/shmctl utmpsortd
16.用 root 執行 bin/mbbsd 23 (註2)

17.新功能請參考 ADVANCE
telnet localhost 23 看看
new一個帳號叫SYSOP,然後logout再login, 這樣子就會擁有站長權限囉~
再new一個帳號叫 guest, 這樣子別人就可以用 guest 參觀你的站了
開板,開群組,以及搬動群組的方法請看 PttSrc 板的文摘

18.為了讓開機的時候會自己把 bbs (以及所須要的程式) 跑起來,
   若您使用 FreeBSD, 您可以將 sample/pttbbs.sh 拷貝到 /usr/local/etc/rc.d/
   之後您可以重新開機試試看是不是在重開後可以正常運作 :)

註:
1. 這個程式是在 initial shared memory 用的, 只有開機後第一次執行, 或是
   你手動清除 shm 後才需要執行

2. 如果您跑了 uhash_loader 並沒有看到
      total XXXXX names loaded.
   而是看到其他的錯誤訊息
    (例如 [shmget error] key = 4cc, errno = 22: Invalid argument)
   可能是您作業系統 shared-memory 上限不足,
   請參考 FAQ中加大 shared-memory 部份的說明.

3. bin/mbbsd 23 是指定要 bind 23 port, 依照 UNIX 規定, 1024 以下的 port
   須要有 root 權限, 所以如果要 bind 23 port 的話就要用 root 去執行,
   3000 port 則不需要.
   請參考 docs/ADVANCE , 安裝好 bbsctl ,
   之後您就可以透過 bbsctl 直接在其他權限下 (如 bbsadm )
   來啟動可以 bind port 23 的 mbbsd.