[轉貼] UT+Windows with Apache + MySQL 架站使用手冊

阿輝

<font size=4>UT架站使用手冊 / Big5繁體版 </font>
  
◎ what is UltraThreads?  
  
UltraThreads (UT) 是個基於 Perl 和 MySQL 的討論區軟體。UT 的界面和使用方式類似 UBB，但功能遠遠強過於 UBB 。
  
--------------------------------------------------------------------------------  
使用 MySQL 資料庫，速度快，儲存空間少。  
同時兼容 mod_perl 最佳化和 普通 CGI 方式。  
任意數目的討論區類別，討論區板塊。  
使用方便，不需要每次輸入登入密碼。  
加密板塊、會員板塊的安全性極強。  
平舖、樹型目錄的顯示方式。  
用戶定制的內容很多，基本上顯示在畫面上的內容都可由用戶自行設定顯示方式。  
方便且強大的後台管理功能，管理員和版主有各有不同的管理權限。  
資料庫備份，討論區文章發表流量分析。  
投票功能，線上信箱功能 (private messages)，察看在線人數/狀態。  
界面採用語言包，只要改寫語言包就可以實現本地化。  
更詳細的功能介紹http://www.ultrathreads.com。  
  
--------------------------------------------------------------------------------  
  
◎UltraThreads (UT) 的系統需求  
  
BSD / Linux / Windows NT / 2000 伺服器  
MySQL 資料庫  
Perl / Mod_perl 的使用權限  
  
--------------------------------------------------------------------------------  
  
【Windows with Apache + MySQL安裝方式】  
  
首先，你必須擁有一個作業系統；大多數的人都使用微軟公司出的 Windows系列，特別建議您最好使用Windows NT 以上等級架設，才會讓你的系統趨於穩定跟安全。  
UT使用的資料庫管理系統是MySQL，這套系統完全免費，使用者可以免費下載  
  
http://www.mysql.com/downloads/  
  
由於，MySQL沒有正式的 Client 管理系統，你可以酌量選擇安裝 phpMyAdmin，這套系統可以讓你遠端管理 MySQL  
資料庫(注一)  
  
再來是安裝 Apache 的網頁伺服器軟體，讓你的系統可以開放 WWW 提供給別人參觀，並且支援 CGI 的處理  
  
http://www.apache.org/dist/httpd/binaries/win32/  
  
然後是讓 Apache 提供 Per l組譯功能；因為 UT 運用了模組 (Perl Modules) 功能，使之功能強大，所以你必須先準備好以下模組才能讓 UT 正常運作  
  
CGI::Carp  
POSIX  
Time::Local  
Socket  
DBI  
DBD-Mysql  
MD5  
Image::Size  
  
如果不知道自己已經安裝了什麼模組你可以去下載  
  
http://www.ultrathreads.com/xfiles/perldiver_1_1.zip  
  
它可以檢查出來你已經安裝的模組，如果缺少哪些模組就來這裡找找  
  
http://www.activestate.com/PPMPackages/zips/6xx-builds-only/  
  
PS:我在安裝Perl Modules之前發現只需要安裝DBI，DBD-Mysql，Image::Size這三樣^^  
  
Step.1 Install Apache  
  
把剛剛下載完回來的apache_1.3.22-win32-x86.msi按兩下  
  
●下一步至Server information的時候，請記得輸入適當的資料  
  
以 http://www.708room.idv.tw 為例子 Network domain 輸入 708room.idv.tw  
Server name 輸入網址 www.708room.idv.tw (如果沒有網域名稱則輸入IP Address)  
  
Administrator's Email輸入你的管理員信箱  
  
下面還有兩個選項則是選擇第一個是否成為系統服務;第二個則是當啟動為某個人的時候才為系統服務(預設值選第一個)  
  
●下一步選擇預設值Complete(完整安裝)  
  
●接著到安裝路徑當然可以隨個人喜好不同,只要你非常清楚你的安裝路徑在哪裡!否則就設定跟我一樣^^"  
  
預設值為C:\Program Files\Apache Group\  
  
我習慣安裝在D:所以把C:改為D:  
D:\Program Files\Apache Group\
●接下來就是一直Next直到安裝完成，Apache安裝到此可以告一段落  
  
Step.2 Install ActivePerl-5.6.1.630  
  
各位請下載ActivePerl-5.6.1.630 package  
  
PS:大家會質疑網頁不是有ActivePerl-5.6.1.630-MSWin32-x86.msi可以直接安裝嗎? 事實上我使用 *.msi 的 ActivePerl 反而無法安裝 DBD-Mysql 所以大家先下載 *.zip 檔吧，如果你是第一次安裝，可以把這行省略  
  
●解壓縮 ActivePerl-5.6.1.630-MSWin32-x86.zip 該目錄應該會有個 Installer.bat 檔案,按兩下吧  
(請仔細看我的MSDOS視窗的設定)  
  
Name "main::TEST" used only once: possible typo at D:\Downloads\ActivePerl-5.6.1 .630-MSWin32-x86\Installer.bat line 462. Welcome to ActivePerl. This installer can install ActivePerl in any location of your choice. You do not need Administrator privileges. However, please make sure that you have write access to this location. Enter top level directory for install [c:\Perl]: d:\usr The typical ActivePerl software installation requires 35 megabytes. Please make sure enough free space is available before continuing. ActivePerl 630 will be installed into 'd:\usr' Proceed? [y] y If you have a development environment (e.g. Visual Studio) that you wish to use with Perl, you should ensure that your environment (e.g. %LIB% and %INCLUDE%) is set before installing, for example, by running vcvars32.bat first. Proceed? [y] y Create shortcuts to the HTML documentation? [y] Add the Perl/bin directory to the PATH? [y] y Copying files... 1581 File(s) copied 4 File(s) copied Finished copying files... Configuring Perl installation at d:\usr Configuring d:\usr/lib/Config.pm for use in d:\usr... Configuring Perl ... Configuring PPM for use in d:\usr... Configuring PPM ... Build directory is now E:\TEMP. If you are behind a firewall, you may need to set the following environment variables so that PPM will operate properly: set HTTP_proxy=address:port [e.g. 192.0.0.1:8080] set HTTP_proxy_user=username set HTTP_proxy_pass=password set HTTP_proxy_agent=agent [e.g. "Mozilla/5.0"] This simplified installation program currently does *not*: o set up MSWin32 file associations o configure Perl for use with a Web Server Refer to your Operating System and/or Web Server documentation for details on how to to perform these modifications. Thank you for installing ActivePerl! Press return to exit.  
  
Step.3 Check Perl installed  
  
剛剛提到一個小的 CGI 程式可以檢查我們目前已經安裝的 Perl Modules  
  
現在把perldiver_1_1.zip解壓縮並且把裡面的perldiver.cgi檔案複製到  
D:\Program Files\Apache Group\Apache\cgi-bin\  
  
接著打開IE瀏覽器輸入http://localhost/cgi-bin/perldiver.cgi  
  
這時應該看到測試結果,直接看到畫面下面的 Installed Modules  
  
應該有這三樣 DBI，DBD-Mysql，Image::Size 沒有安裝，其他都有了  
  
所以執行D:\usr\bin\ppm.bat安裝這三樣modules  
  
PPM interactive shell (2.1.5) - type 'help' for available commands.  
PPM> install DBI  
Install package 'DBI?' (y/N): y  
Installing package 'DBI'...  
Bytes transferred: 243541  
Writing D:\usr\site\lib\auto\DBI\.packlist  
PPM> install DBD-Mysql  
Install package 'DBD-Mysql?' (y/N): y  
Installing package 'DBD-Mysql'...  
Bytes transferred: 126147  
Installing D:\usr\site\lib\auto\DBD\mysql\mysql.bs  
Installing D:\usr\site\lib\auto\DBD\mysql\mysql.dll  
Installing D:\usr\site\lib\auto\DBD\mysql\mysql.exp  
Installing D:\usr\site\lib\auto\DBD\mysql\mysql.lib  
Installing D:\usr\html\site\lib\Mysql.html  
Installing D:\usr\html\site\lib\DBD\mysql.html  
Installing D:\usr\html\site\lib\Bundle\DBD\mysql.html  
Installing D:\usr\site\lib\Mysql.pm  
Installing D:\usr\site\lib\Mysql\Statement.pm  
Installing D:\usr\site\lib\DBD\mysql.pm  
Installing D:\usr\site\lib\Bundle\DBD\mysql.pm  
Installing D:\usr\bin\dbimon  
Installing D:\usr\bin\dbimon.bat  
Writing D:\usr\site\lib\auto\DBD\Mysql\.packlist  
PPM> install Image-Size  
Install package 'Image-Size?' (y/N): y  
Installing package 'Image-Size'...  
Bytes transferred: 16707  
Installing D:\usr\html\site\lib\Image\Size.html  
Installing D:\usr\site\lib\Image\Size.pm  
Installing D:\usr\site\lib\auto\Image\Size\autosplit.ix  
Installing D:\usr\site\lib\auto\Image\Size\bmpsize.al  
Installing D:\usr\site\lib\auto\Image\Size\gifsize.al  
Installing D:\usr\site\lib\auto\Image\Size\jpegsize.al  
Installing D:\usr\site\lib\auto\Image\Size\pngsize.al  
Installing D:\usr\site\lib\auto\Image\Size\ppmsize.al  
Installing D:\usr\site\lib\auto\Image\Size\psdsize.al  
Installing D:\usr\site\lib\auto\Image\Size\tiffsize.al  
Installing D:\usr\site\lib\auto\Image\Size\xbmsize.al  
Installing D:\usr\site\lib\auto\Image\Size\xpmsize.al  
Installing D:\usr\bin\imgsize  
Installing D:\usr\bin\imgsize.bat  
Writing D:\usr\site\lib\auto\Image\Size\.packlist  
PPM> quit  
  
如果不放心還可以返回剛剛的 http://localhost/cgi-bin/perldiver.cgi 查看是否安裝成功^^"  
  
Step.4 Install MySQL  
  
1.打開mysql-3.23.44-win.zip執行setup.exe  
2.直到安裝路徑一樣D:\mysql ->Complete -> Finish PS:如果MySQL沒有產生捷徑的話,請到D:\mysql\bin\執行winmysqladmin.exe  
3.第一次啟動mySQL會叫你設定帳號密碼,這時候請非常小心清楚的設定你的帳號,這個帳號是攸關資料庫生死的權利  
4.這時請檢查一下右下角的icon是否呈現綠燈,如果是代表MySQL正常運作  
  
Step.5 Import UT SQL ->MySQL  
  
0.為你的論壇增設一個資料庫名稱(例如:ultrathreads),則請開啟MySQL視窗到Database,你應該會看到Databases裡面有預設兩個資料庫(mysql和test),這時按下主機點右鍵[Create Database]->輸入[ultratherads]  
  
1. 把 ut0507.zip 解壓縮  
2. 把裡面的 ut_tables.sql 複製到 mySQL/bin 的目錄裡面 (D:\mysql\bin)  
3. 打開編輯器修改 ut_tables.sql 的第二行(use dbName改為你剛剛為論壇設的資料庫名稱 (use ultrathreads)
4.打開 DOS 視窗，跳到 D:\mysql\bin,打 "mysql < ut_tables.sql"，如果沒有問題則不會顯示任何資料，你可以到 mysql 視窗查看 databases 的詳細資料表  
5. 環境設定已經完成了,恭喜你  
  
Step.6 Setting UT  
  
0.新增"D:\Program Files\Apache Group\Apache\cgi-bin\ultrathreads\"目錄,"D:\Program Files\Apache Group\Apache\htdocs\ultrathreads\"目錄 1.把剛剛解壓縮的ut0507.zip裡面的cgi-bin目錄全部檔案複製到D:\Program Files\Apache Group\Apache\cgi-bin\ultrathreads\ 2.複製noncgi資料夾內檔案到"D:\Program Files\Apache Group\Apache\htdocs\ultrathreads\"目錄 3.打開編輯器修改"D:\Program Files\Apache Group\Apache\cgi-bin\ultrathreads\UTConfig.pm"  
  
$cfg{'dbName'} = "ultrathreads";#剛剛你設的資料庫名稱  
$cfg{'dbUser'} = "root";#第一次安裝mySQL的帳號  
$cfg{'dbPassword'} = "12345678";#第一次安裝mySQL的密碼  
$cfg{'dbServer'} = "localhost";#安裝在本機則設為localhost,請勿輸入IP或是Domain name  
$cfg{'uniqueCookie'} = "ultrathreads";#為了識別不同UT的Coockies,則請務必設為不同的名稱  
# 以下設定檔請務必更改  
$cfg{'forumClosed'} = 0;#請設為0啟動論壇  
$cfg{'baseUrl'} = "http://127.0.0.1";#請輸入您架設UT主機的IP或是DNS  
$cfg{'cgiPath'} = "/cgi-bin/ultrathreads";#輸入"相對路徑"UT的cgi-bin位址  
$cfg{'nonCgiPath'} = "/ultrathreads";#輸入"相對路徑"UT的noncgi位址  
$cfg{'cgiDir'} = "D:/Program Files/Apache Group/Apache/cgi-bin/ultrathreads";#輸入"絕對路徑"UT的cgi-bin位址  
$cfg{'nonCgiDir'} = "D:/Program Files/Apache Group/Apache/htdocs/ultrathreads";#輸入"絕對路徑"UT的noncgi位址  
$cfg{'attachFsPath'} = "D:/Program Files/Apache Group/Apache/htdocs/ultrathreads/attach";#輸入"絕對路徑"UT的attach位址  
$cfg{'attachUrlPath'} = "/ultrathreads/attach";#輸入"相對路徑"UT的attach位址  
$cfg{'backupFsPath'} = "D:/Program Files/Apache Group/Apache/htdocs/ultrathreads/backup";#輸入"絕對路徑"UT的backup位址  
$cfg{'backupUrlPath'} = "/ultrathreads/backup";#輸入"相對路徑"UT的backup位址  
$cfg{'adminEmail'} = 'kelvin@ultrathreads.com';#輸入網站管理員的Email  
$cfg{'forumEmail'} = 'kelvin@ultrathreads.com';#輸入論壇管理員的Email  
$cfg{'maxAttachLen'} = 1024000;  
$cfg{'maxSubjectLen'} = 50;  
$cfg{'userExpiration'} = 180;  
$cfg{'logoutUrl'} = "http://www.ultrathreads.com";#輸入登出論壇的網址  
  
4. 設定好之後 UT 就大公告成!  
5. 請第一次使用 UT 時用瀏覽器輸入 http://localhost/cgi-bin/ultrathreads/forum.cgi  
6. 註冊成為第一個會員,並同時授與論壇管理員權利  
7. 開新版區請先新增主版區 (Category) 才能新增子版區 (Board)  
  
--------------------------------------------------------------------------------  
  
Q&A  
  
Q:如果在新增board的時候出現錯誤訊息"Unknown column 'image' in 'field list'"  
A:請修改board_create_x.cgi,第54行的image=1,改成ImgTag=1,  
--------------------------------------------------------------------------------  
  
Edittion by LPJ 2001-11-29  
若有錯誤請不吝來信指教或是到708Room資源論壇發問  
PS:轉載時請保持文章完整性響應智慧財產權^^

jamesanna

挖哩...怎麼有這種東西，找了好久，真的是皇天不付苦心人，
真的是謝謝阿輝大大了，要出門工作了，晚上回來再試好了。
謝謝囉，阿輝。

阿輝

這篇是轉貼的~~~
  
我打算自己重新寫一篇..^^
  
另外 PIL 版本的 Web Server Packge 也在研究中..^^
  

jamesanna wrote:
挖哩...怎麼有這種東西，找了好久，真的是皇天不付苦心人，
真的是謝謝阿輝大大了，要出門工作了，晚上回來再試好了。
謝謝囉，阿輝。

jamesanna

雖是轉貼的，但已經很實用了，非常期待阿輝的大作：
我看就叫[$#65282]PalmIsLife 論壇建構實例(PIL中文化論壇套件)[$#65282]好了，呵呵。
到時一定捧場。

小酒蟲

Apache 記得換到 1.3.26
Security problems....

jenwei

抓一個小bug
MySQL 不是完全免費，以下節錄自 MySQL Licensing Policyhttp://www.mysql.com/products/licensing.html
  
3. Commercial use for everyone else
If your application is not licensed under GPL or compatible OSI license approved by MySQL AB and you intend to distribute MySQL software (be that internally or externally), you must first obtain a commercial license to the MySQL software in question.
  
More specifically:
  
a) If you include the MySQL server in your non Open Source application, you need a commercial licence for the MySQL server
  
b) If you include one of the MySQL drivers in your non Open Source application (so that your application can run with MySQL), you need a commercial licence for the driver(s) in question. The MySQL drivers currently include an ODBC driver, a JDBC driver and the C language library.
  
c) If you use MySQL Software within your organisation and you don't want to risk it falling under the GPL license, you are welcome to purchase a commercial license.
  
d) Many users opt for the commercial licence simply because under it MySQL AB takes responsibility for its products. Under the GPL licence, there are no warranties or representations from the developer (i.e. from MySQL AB).
  
4. Exceptions and free commercial licences
If you represent a non-profit organisation or an academic institution, we recommend you to put your own application under GPL. Thereby you are free to use MySQL software free of charge under the GPL licence. (We also believe that if you have strong reasons not to go GPL, you also have the monetary means to purchase commercial licences.)
  
If you are a private individual you are free to use MySQL software for your personal applications, as long as you do not distribute them.
  
Please note that even if you ship a free demo version of your own application, the above rules apply.

我靠
你知道这篇文章我等了多久了吗
整整10小时
我从上午9点开始搞，怎么弄也弄不会安装
不象雷奥论坛，傻瓜式安装
我在大陆找了半天都找不到教程

tkjoseph

Originally posted by babysky at 2004-2-25 07:34 PM:
我靠
你知道这篇文章我等了多久了吗
整整10小时
我从上午9点开始搞，怎么弄也弄不会安装
不象雷奥论坛，傻瓜式安装
我在大陆找了半天都找不到教程

請不要在這邊用情緒話字眼...
還有,誰管你等這篇多久?

小酒蟲

Originally posted by jenwei at 2003-8-7 08:26:
MySQL 不是完全免費，以下節錄自 MySQL Licensing Policyhttp://www.mysql.com/products/licensing.html

If your application is not licensed under GPL or compatible OSI license approved by MySQL AB and you intend to distribute MySQL software (be that internally or externally), you must first obtain a commercial license to the MySQL software in question.

不過 UT 有說：「用戶可以自行修改 UltraThreads 的源代碼以滿足其自身的需要，但不允許重新發售或轉送修改過的 UltraThreads。」所以用 UT 的需不需要也一併要買 MySQL？
不允許重新轉送修改過的 UltraThreads 似乎不符合 GPL 要求？

Originally posted by babysky at 2004-2-25 04:34:
我靠
你知道篇文章我等了多久了
不象雷，傻瓜式安
我在大找了半天都找不到教程

UT 也是你們大陸佬搞出來的啊，怪台灣人做什麼？

[ Last edited by 小酒蟲 on 2004-5-28 at 21:49 ]

qekyaj

may I ask what is sql?

Dragoon

Originally posted by 小酒蟲 at 2004-5-29 12:44 PM:

不過 UT 有說：「用戶可以自行修改 UltraThreads 的源代碼以滿足其自身的需要，但不允許重新發售或轉送修改過的 UltraThreads。」所以用 UT 的需不需要也一併要買 MySQL？
不允許重新轉送修改過的 UltraThreads 似乎不符合 GPL 要求？

[ Last edited by 小酒蟲 on 2004-5-28 at 21:49 ]

GPL 應該是規範:
修改後的東西如果要釋出, 必須連同原始碼一起釋出.

個人要怎麼改採用 GPL 授權的軟體只要不釋出應該無所謂.

unicorn_khh

現在只能遠端搖控回台灣的windows server伺服器, 常受限連線時間, 還沒把專題論壇搞起來,不過這篇使用手冊真是實用, 減少很多摸瞎的時間, 感謝