Initial revision

git-svn-id: http://opensvn.csie.org/pttbbs/pttbbs/trunk/pttbbs@1 63ad8ddf-47c3-0310-b6dd-a9e9d9715204

1 files changed, 49 insertions, 0 deletions

diff --git a/docs/INSTALL b/docs/INSTALL
new file mode 100644
index 00000000..5bd484d5
--- /dev/null
+++ b/docs/INSTALL
@@ -0,0 +1,49 @@
+底下是快速安裝的方法
+
+==
+
+先取得 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 (任何目錄下皆可).
+8. 執行 cd pttbbs
+9. 如果之前沒有設定過 pttbbs.conf 的話, 請 cp sample/pttbbs.conf pttbbs.conf
+10. 修改 pttbbs.conf
+11. 執行 make OSTYPE=FreeBSD BBSHOME=/home/bbs all install
+    (Linux使用者請把 "FreeBSD" 改成 "linux")
+12. 如果是新架起來的站, 請執行 cd sample; make install
+12. 執行 cd /home/bbs; bin/initbbs
+
+假如一切都很順利的話,這樣子大概就安裝完了
+接下來是啟動 bbs 的部份
+
+13. 執行 bin/uhash_loader (*註1)
+14. 用 root 執行 bin/mbbsd 23 (註2)
+
+telnet localhost 23 看看
+new一個帳號叫SYSOP,然後logout再login, 這樣子就會擁有站長權限囉~
+再new一個帳號叫 guest, 這樣子別人就可以用 guest 參觀你的站了
+開板,開群組,以及搬動群組的方法請看 PttSrc 板的文摘
+
+註:
+1. 這個程式是在 initial shared memory 用的, 只有開機後第一次執行, 或是
+   你手動清除 shm 後才需要執行
+
+2. bin/mbbsd 23 是指定要 bind 23 port, 依照 UNIX 規定, 1024 以下的 port
+   須要有 root 權限, 所以如果要 bind 23 port 的話就要用 root 去執行,
+   3000 port 則不需要