安道生練功房 - 分享經驗，累積智慧

由於2.1.6有滿多Bug已經在2.1.7裡面修正了，故我便嘗試將本站升級至這個開發中的版本，順便進行中文化。
步驟或過程大致如下，供大家參考：
升級前的環境
v2.1.6安裝在/home/andowson/www/forum下
資料庫名稱和使用者名稱都是forum
升級後的環境
v2.1.7-dev改安裝在/home/andowson/www下
資料庫名稱和使用者名稱還是原來的forum
改換目錄主要的原因是讓網址好看一點
以前是/forum/forums/list.page
升級後改成/forums/list.page

1.由CVS中下載2.1.7-dev
cd /home/andowson/www
cvs -d ":pserver:cvs.dev.java.net:/cvs" checkout jforum
=>將會在目前工作目錄下建立jforum目錄
2.備份資料庫，假設資料庫名稱和使用者名稱都是forum
本站用的是PostgreSQL 7.4.13-2的版本，參考了http://www.twpug.net/docs/pgsqldoc-7.4-big5/backup.html這個網址的說明，實際上我用的指令如下：
su - postgres
pg_dump forum > /tmp/forum.bak

3.建立測試用的資料庫，假設資料庫名稱和使用者名稱都是test
這邊如果按照文件上的作法
createdb -T template0 test
則建立出來的資料庫擁有者會是postgres，如果我們要用不同的資料庫使用者來連資料庫，將會遭遇到一些權限上的問題。於是我採用底下的作法
psql -c "create user test createdb;" template1
psql -c "create database test with encoding 'unicode';" -U test template1
psql -c "alter user test nocreatedb;" template1
psql -c "alter user test with encrypted password 'test';" template1

4.還原資料庫到test
cp /tmp/forum.bak /tmp/test.bak
vi /tmp/test.bak
將
SET SESSION AUTHORIZATION 'forum';
改為
SET SESSION AUTHORIZATION 'test';

psql test < /tmp/test.bak

5.升級JForum資料庫schmea
psql test test -f /home/andowson/www/jforum/upgrade/2.1.7/postgresql_2.1.6_to_2.1.7.sql
如果沒有錯誤發生的話，就可以執行底下的指令
vacuumdb -a -z
如果有錯誤的話，就修正一下postgresql_2.1.6_to_2.1.7.sql的內容，然後將資料庫及使用者刪除後，再回到步驟3和步驟4重新還原一次
dropdb test
dropuser test
離開資料庫作業
exit

我們的目標是要將JForum安裝在/home/andowson/www目錄下，目前下載的程式碼是在/home/andowson/www/jforum下
6. 複製JForum需要的檔案到正式站台目錄下
cd /home/andowson/www
cp -rf /home/andowson/www/jforum/templates .
cp -rf /home/andowson/www/jforum/images .
cp -rf /home/andowson/www/jforum/upload .
cp -rf /home/andowson/www/jforum/tmp .
cp -rf /home/andowson/www/jforum/WEB-INF .
cp -rf /home/andowson/www/jforum/*.txt .
rm -rf upload/2005
chmod 775 upload
chmod 775 tmp
chmod 775 images/avatar

將原本2.1.6的檔案複製過來，假設是放在/home/andowson/www/forum下
cp -rfp /home/andowson/www/forum/upload/* upload
cp -rfp /home/andowson/www/forum/images/avatar/* images/avatar
cp -rfp /home/andowson/www/forum/templates/default/styles/zh_TW.css templates/default/styles/.
cp -rfp /home/andowson/www/forum/WEB-INF/config/jforum-custom.conf WEB-INF/config/.
cp -rfp /home/andowson/www/forum/index.htm .

底下需要root權限
chgrp -R tomcat /home/andowson/www

7. 修改/home/andowson/www/jforum/build.xml
將產生的classes設定到/home/andowosn/www/WEB-INF/classes下
將
<property name="build.dir" location="build" />
改為
<property name="build.dir" location="/home/andowson/www/WEB-INF" />
存檔後，執行
ant
即可編譯出新的classes

8.修改WEB-INF/config/jforum-custom.conf裡面有關資料庫的設定

9.重起啟動tomcat
service tomcat restart

10.連結到網站首頁
怎麼所有版面通通不見了？
照官方網站的說明，我們必須用admin的帳號重新登入，把群組的權限重新設定一次即可

11.開始功能測試
建議測試項目:
註冊兩個會員user1, user2，並啟用帳號
用user1發表有附加檔案文章
用user2回覆user1的文章，檢查user1有沒有收到通知信
用user2發私人訊息給user1，檢查user1有沒有收到通知信
搜尋文章

12.如果功能測試沒問題的話，我們即可進行正式升級
關閉tomcat以免別人來連
service tomcat stop

升級正式資料庫
su - postgres
psql forum forum -f /home/andowson/www/jforum/upgrade/2.1.7/postgresql_2.1.6_to_2.1.7.sql
vacuumdb -a -z
exit

修改jforum-custom.conf

如果有進行檔案上傳等的話，先把相關檔案刪除
rm -rf upload
rm -rf images/avatar
重新複製一次
cp -rfp /home/andowson/www/forum/upload upload
cp -rfp /home/andowson/www/forum/images/avatar images/avatar
chmod 775 upload
chmod 775 tmp
chmod 775 images/avatar

重新啟動tomcat
service tomcat start

再用admin進行一次權限設定

OK，大功告成！