TnfshMoe PIX安裝教學

這篇文章是TnfshMoe PIX的自行架設安裝教學。

TnfshMoe PIX 使用分散式儲存架構，由於一個GAE帳號可以申請十台伺服器(十個子網域)，而每個伺服器有5G的儲存空間以及1G的日流量。TnfshMoe PIX需要一台首頁伺服器，並且至少還需一台檔案伺服器，首頁伺服器因使用量大，故不存放圖片檔。一台檔案伺服器可提供5G的空間，兩台就是10G，依此類推，一個帳號可以提供一台首頁伺服器和九台網頁伺服器，也就是一個GAE帳號可以提供45G的圖片存放空間。


這裡是註冊 GAE 帳號的教學：http://nchc-gae.blogspot.com/2009/05/google-app-engine.html
請注意一個GAE帳號就需要一台手機認證，因此，若要申辦多個帳號，則必須準備多台手機，在Gmail認證過的手機可以再次認證。

我們要先新增伺服器，以便接下來的架設。請至http://appengine.google.com，登入您的GAE帳號，先新增一個首頁伺服器，這是架設完成之後的首頁網址，請三思而後取名。在本教學中，以demopixx.appspot.com為首頁範例。

新增完成後，我們要繼續新增檔案伺服器。這些伺服器的名字就小菜隨意，反正是系統內部溝通需求，不必簡單好記也無傷大雅。

例：demopixx001.appspot.com，demopixx002.appspot.com，依此類推，檔案伺服器可用不同GAE帳號架設。

以下是架設TnfshMoe PIX前必須先安裝的軟體：

1. 至 Java 官方網站下載 JDK 的x86版本(x64版本會有問題)或是直接下載 http://download.oracle.com/otn-pub/java/jdk/7u2-b13/jdk-7u2-windows-i586.exe 。
2. 至 http://code.google.com/intl/zh-TW/appengine/downloads.html 下載 "Java 專用的 Google 應用服務引擎 SDK" 。
3. 至http://ant.apache.org/bindownload.cgi 下載 Apache Ant ，或是直接下載 http://apache.cdpa.nsysu.edu.tw//ant/binaries/apache-ant-1.8.2-bin.zip 。
4. 至 https://github.com/tnfshmoe/TnfshMoePIX 點選左上角的 ZIP 下載 TnfshMoe PIX 安裝包。

請將這些檔案放置於一個純英文路徑資料夾下，方便等一下的安裝操作。

首先，安裝 JDK ，強烈建議直接安裝於 C:\ 下(預設會安裝在Program Files中)，否則後面的步驟可能會出現問題。

以下解壓縮動作，請都解壓到同一個資料夾下。

解壓縮 TnfshMoe PIX 安裝包，並將資料夾名稱改為 tnfshmoepix ，方便操作。

解壓縮 appengine-java-sdk-xxxxx.zip 到 tnfshmoepix 資料夾下，並將資料夾改名為 appengine-java-sdk ，注意不要多一層資料夾，appengine-java-sdk 點進去後應該是直接看到一些檔案，放在跟 tnfshmoepix 同個資料夾下。

解壓縮 apache-ant-xxx-bin.zip，並將資料夾改名為 apache-ant  (注意不要多一層資料夾， apache-ant  點進去後應該是直接看到一些檔案)

接著編輯 tnfshmoepix/build.xml 進行相關設定，由於檔案是 Linux 換行格式，Windows 下可能會出現換行異常的問題，可以考慮用 Notepad++ 進行編輯。

修改 <property name="TITLE" value="TnfshMoe" /> 的 Tnfshmoe 為你想用的網站標題。

例如：<property name="TITLE" value="TnfshMoeTEST" />，TnfshMoeTEST為網站的標題。 

修改 <property name="INDEXURL" value="tnfshmoe.appspot.com" /> 的 tnfshmoe.appspot.com 為你的首頁伺服器網址。

例如：<property name="INDEXURL" value="demopixx.appspot.com" />，demopixx.appspot.com為首頁伺服器網址。

修改 <property name="SECURITY" value="8s9jxyefkzjefee98kezdf" /> 的 8s9jxyefkzjefee98kezdf 為任意的一串隨機亂碼，只能用小寫英文字母跟數字，長度不要超過22個字元。

接著備份 tnfshmoepix 資料夾，等一下萬一操作失誤，刪除原本的 tnfshmoepix 資料夾，用備份的替代。

開啟命令提示字元(開始→執行→輸入cmd→enter)，輸入以下指令：
cd C:\TnfshMoe所在資料夾

set PATH=%PATH%;你的 JDK bin 路徑
(如果JDK bin路徑是在 C:\Java\jdk1.7.0_02\bin，則輸入set PATH=%PATH%;C:\Java\jdk1.7.0_02\bin

set JAVA_HOME="C:\Java\jdk1.7.0_02"

..\apache-ant\bin\ant init　　注意最前面的..\不要忘記輸入

appengine-java-sdk\bin\appcfg -e GAE的Email帳號 -A 首頁伺服器名稱 update indexwar
如果您的GAE帳號是testpix@gmail.com，首頁伺服器是demopixx，則請輸入appengine-java-sdk\bin\appcfg -e testpix@gmail.com -A demopixx update indexwar 。會要求輸入密碼，請輸入之後按Enter。

appengine-java-sdk\bin\appcfg -e GAE的Email帳號 -A 檔案伺服器名稱 update serverwar
如果您的GAE帳號是testpix@gmail.com，檔案伺服器是demopix001，則請輸入appengine-java-sdk\bin\appcfg -e testpix@gmail.com -A demopix001 update serverwar 。檔案伺服器可以無限新增，如要新增多台，請一台一台輸入指令。可新增不同GAE帳號下的檔案伺服器，但是EMAIL帳號要使用該伺服器的擁有者帳號。

用瀏覽器，開啟 首頁伺服器網址/init(如 http://demopixx.appspot.com/init ) 和每個 檔案伺服器網址/init (如 http://demopix001.appspot.com/init 和 http://demopi002.appspot.com/init) 對伺服器進行初始化。若網址開啟後為空白網頁，代表初始化成功。

到首頁伺服器的後台 -> Datastore Viwer。

點 id=某數字 進入資料修改畫面，將 value 設定為你第一台檔案伺服器網址。

 如果還有其他檔案伺服器，點上面的 Create ，點 Next ，設定 value 設定為你第二台檔案伺服器網址(其餘以此類推)。

最後設定好的畫面。

接著在命令提示字元輸入以下指令：

..\apache-ant\bin\ant finish

appengine-java-sdk\bin\appcfg -e GAE的Email帳號 -A 首頁伺服器名稱(如 demopixx) update indexwar

用瀏覽器，開啟 首頁伺服器網址/init ，再初始化一次首頁伺服器。

這樣即可安裝完成。如在安裝過程中，遇到任何問題，請在本教學下方留言詳述問題發生情形，我們將盡速為您解答。