| 8 | |
| 9 | = 架設 BOINC Server = |
| 10 | |
| 11 | BOINC Server 的架設方式有兩種: |
| 12 | |
| 13 | 1. 使用 [http://boinc.berkeley.edu/trac/wiki/VirtualMachines BOINC 團隊提供的 VMWare Image] 進行測試 |
| 14 | * Linux 上如果遇到權限問題, 請確認解壓縮之後, vmx 檔案是否具備執行權限(Execution) |
| 15 | * [狀況] 使用 [http://boincdl.ssl.berkeley.edu/dl/debian-40r0-i386-boinc.zip Berkeley Debian Etch 4.0r0 32bit], 網路卡一直無法正常啟動, 故轉而使用自行製作的 vmware image. |
| 16 | 2. 從 BOINC 官方 SVN 下載原始碼編譯並自行安裝相關套件 |
| 17 | * 使用自製 Debian Etch 4.0r0 版本的 Xen VM 並執行[#自行安裝 以下]的步驟 |
| 18 | |
| 19 | == 使用 BOINC 官方 VMWare Image == |
| 20 | |
| 21 | 根據[http://boinc.berkeley.edu/trac/wiki/VirtualMachines 官方文件]的說明, 安裝 BONIC Server 最容易的方法是安裝[http://www.vmware.com/download/player/ VMWare player] (免費軟體/freeware)。目前有兩個 VMWare Image 可以下載: |
| 22 | |
| 23 | * [http://boincdl.ssl.berkeley.edu/dl/debian-40r0-i386-boinc.zip Berkeley BOINC 團隊提供的 VMWare Image - Debian Etch 4.0r0 32bit] |
| 24 | * [http://boincdl.ssl.berkeley.edu/dl/ubuntu-server-7.04-i386-boinc.zip Berkeley BOINC 團隊提供的 VMWare Image - Ubuntu Feisty 7.04 32-bit] |
| 25 | |
| 26 | == 自行安裝 == |
| 27 | |
| 28 | === 前置作業 === |
| 29 | |
| 30 | * 以下的步驟是在 Xen 的環境下完成, Xen 的安裝步驟請參考 [wiki:Xen_Installation Xen Installation How-To] |
| 31 | * '''前置作業''': 建立 BOINC Server Xen VM (Etch) |
| 32 | {{{ |
| 33 | xen-server:~# xen-create-image -dir /home/xen --dist etch --debootstrap --fs reiserfs --accounts --kernel /boot/vmlinuz-2.6.18-6-xen-vserver-amd64 --initrd /boot/initrd.img-2.6.18-6-xen-vserver-amd64 --hostname boinc-server --ip 140.110.X.X --gateway 140.110.X.X --netmask 255.255.255.0 --mirror http://free.nchc.org.tw/debian |
| 34 | xen-server:~# xm create /etc/xen/boinc-server.cfg |
| 35 | xen-server:~# xm list |
| 36 | Name ID Mem(MiB) VCPUs State Time(s) |
| 37 | Domain-0 0 1878 4 r----- 1478.4 |
| 38 | bonic-server 1 128 1 -b---- 1035.7 |
| 39 | }}} |
| 40 | * 使用 root 帳號登入, 別忘了要設定密碼喔!! 否則用 xen-create-image 產生 VM 時請記得加 --passwd |
| 41 | {{{ |
| 42 | xen-server:~# xm console bonic-server |
| 43 | boinc-server login: root |
| 44 | boinc-server:~# passwd |
| 45 | }}} |
| 46 | |
| 47 | |
| 48 | === 安裝 BOINC Server 相關軟體 === |
| 49 | |
| 50 | * [參考文獻] [http://boinc.berkeley.edu/trac/wiki/ServerIntro#cookbook-debian40 Cookbook for Debian 4.0] |
| 51 | * |
| 52 | * BOINC Server 基本的套件需求 |
| 53 | {{{ |
| 54 | boinc-server:~# apt-get update |
| 55 | boinc-server:~# apt-get upgrade |
| 56 | boinc-server:~# apt-get install m4 make autoconf automake gcc g++ pkg-config libtool subversion vim apache2-mpm-prefork libapache2-mod-php5 mysql-server mysql-client-5.0 mysql-client-5.0 php5-mysql php5-cli php5-gd phpmyadmin python-mysqldb libmysql++-dev libssl-dev libphp-phpmailer |
| 57 | }}} |
| 58 | * [備註] libphp-phpmailer - 供 BOINC 專案註冊帳號寄信用 (參考 Linux Magazine Issue 71 October 2006 "Building distributed application with BOINC"([http://www.linux-magazine.com/issue/71/Distributed_Applications_With_BOINC.pdf PDF Download])) |
| 59 | * 建立 BOINC 管理者帳號 |
| 60 | {{{ |
| 61 | boinc-server:~# adduser boincadm |
| 62 | }}} |
| 63 | * 修改 MySQL Server 預設 root 密碼 |
| 64 | {{{ |
| 65 | boinc-server:~# mysql_install_db |
| 66 | boinc-server:~# mysqladmin -h localhost -u root password '新的 MySQL Root 密碼' |
| 67 | }}} |
| 68 | * 建立 BOINC SQL 管理者 boincadm 權限 |
| 69 | {{{ |
| 70 | boinc-server:~# mysql -h localhost -u root -p |
| 71 | mysql> GRANT ALL ON *.* TO 'boincadm'@'localhost'; |
| 72 | mysql> SET PASSWORD FOR 'boincadm'@'localhost'=''; |
| 73 | mysql> quit |
| 74 | }}} |
| 75 | * 編譯 BOINC 原始檔 |
| 76 | {{{ |
| 77 | boinc-server:~# svn co http://boinc.berkeley.edu/svn/trunk/boinc boinc_trunk |
| 78 | boinc-server:~# cd ~/boinc_trunk |
| 79 | boinc-server:~/boinc_trunk# svn update |
| 80 | boinc-server:~/boinc_trunk# ./_autosetup |
| 81 | boinc-server:~/boinc_trunk# ./configure --disable-client --enable-unicode --without-x |
| 82 | boinc-server:~/boinc_trunk# make |
| 83 | }}} |
| 84 | |
| 85 | * 建立 BOINC Project 範例 |
| 86 | {{{ |
| 87 | boinc-server:~# cd ~/boinc_trunk/tools |
| 88 | boinc-server:~/boinc_trunk/tools# ./make_project --url_base http://140.110.X.X/ --db_host localhost --db_user boincadm --project_root /var/www/boinc_projects --delete_prev_inst --drop_db_first --test_app bioinfo |
| 89 | boinc-server:~/boinc_trunk/tools# chown -R www-data:www-data /var/www/boinc_projects |
| 90 | boinc-server:~/boinc_trunk/tools# cd /var/www/boinc_projects |
| 91 | boinc-server:/var/www/boinc_projects# cp bioinfo.httpd.conf /etc/apache2/sites-available/bioinfo |
| 92 | boinc-server:/var/www/boinc_projects# ln -s /etc/apache2/sites-available/bioinfo /etc/apache2/sites-enabled/bioinfo |
| 93 | boinc-server:/var/www/boinc_projects# apache2ctl -t |
| 94 | boinc-server:/var/www/boinc_projects# apache2ctl restart |
| 95 | boinc-server:/var/www/boinc_projects# cat bioinfo.cronjob >> /var/spool/cron/crontabs/root |
| 96 | }}} |
| 97 | * 由於範例專案預設不能申請帳號, 因此要把 disable_account_creation 的選項改為 0 |
| 98 | {{{ |
| 99 | #!diff |
| 100 | --- /var/www/boinc_projects/config.xml.org 2008-04-29 12:27:35.000000000 +0000 |
| 101 | +++ /var/www/boinc_projects/config.xml 2008-04-29 11:54:40.000000000 +0000 |
| 102 | @@ -17,7 +17,7 @@ |
| 103 | 3 |
| 104 | </sched_debug_level> |
| 105 | <disable_account_creation> |
| 106 | - 1 |
| 107 | + 0 |
| 108 | </disable_account_creation> |
| 109 | <uldl_dir_fanout> |
| 110 | 1024 |
| 111 | }}} |
| 112 | * 修改 project.xml 架構設定檔:可只留下 i686 Linux 跟 x86_64 Linux 兩種版本,也就是預設只有 Linux 32 位元跟 64 位元兩種 CPU 架構可以執行 uppercase 範例專案(與下一個步驟有關) |
| 113 | {{{ |
| 114 | #!diff |
| 115 | --- /var/www/boinc_projects/project.xml.org 2008-05-07 18:49:53.000000000 -0700 |
| 116 | +++ /var/www/boinc_projects/project.xml 2008-05-07 18:50:23.000000000 -0700 |
| 117 | @@ -1,13 +1,5 @@ |
| 118 | <boinc> |
| 119 | <platform> |
| 120 | - <name>windows_intelx86</name> |
| 121 | - <user_friendly_name>Microsoft Windows (98 or later) running on an Intel x86-compatible CPU</user_friendly_name> |
| 122 | - </platform> |
| 123 | - <platform> |
| 124 | - <name>windows_x86_64</name> |
| 125 | - <user_friendly_name>Microsoft Windows running on an AMD x86_64 or Intel EM64T CPU</user_friendly_name> |
| 126 | - </platform> |
| 127 | - <platform> |
| 128 | <name>i686-pc-linux-gnu</name> |
| 129 | <user_friendly_name>Linux running on an Intel x86-compatible CPU</user_friendly_name> |
| 130 | </platform> |
| 131 | @@ -15,34 +7,6 @@ |
| 132 | <name>x86_64-pc-linux-gnu</name> |
| 133 | <user_friendly_name>Linux running on an AMD x86_64 or Intel EM64T CPU</user_friendly_name> |
| 134 | </platform> |
| 135 | - <platform> |
| 136 | - <name>powerpc-apple-darwin</name> |
| 137 | - <user_friendly_name>Mac OS X 10.3 or later running on Motorola PowerPC</user_friendly_name> |
| 138 | - </platform> |
| 139 | - <platform> |
| 140 | - <name>i686-apple-darwin</name> |
| 141 | - <user_friendly_name>Mac OS 10.4 or later running on Intel</user_friendly_name> |
| 142 | - </platform> |
| 143 | - <platform> |
| 144 | - <name>sparc-sun-solaris2.7</name> |
| 145 | - <user_friendly_name>Solaris 2.7 running on a SPARC-compatible CPU</user_friendly_name> |
| 146 | - </platform> |
| 147 | - <platform> |
| 148 | - <name>sparc-sun-solaris</name> |
| 149 | - <user_friendly_name>Solaris 2.8 or later running on a SPARC-compatible CPU</user_friendly_name> |
| 150 | - </platform> |
| 151 | - <platform> |
| 152 | - <name>sparc64-sun-solaris</name> |
| 153 | - <user_friendly_name>Solaris 2.8 or later running on a SPARC 64-bit CPU</user_friendly_name> |
| 154 | - </platform> |
| 155 | - <platform> |
| 156 | - <name>powerpc64-ps3-linux-gnu</name> |
| 157 | - <user_friendly_name>Sony Playstation 3 running Linux</user_friendly_name> |
| 158 | - </platform> |
| 159 | - <platform> |
| 160 | - <name>anonymous</name> |
| 161 | - <user_friendly_name>anonymous</user_friendly_name> |
| 162 | - </platform> |
| 163 | <app> |
| 164 | <name>uppercase</name> |
| 165 | <user_friendly_name>upperCASE</user_friendly_name> |
| 166 | }}} |
| 167 | * 確認範例專案的應用程式(BOINC Application)有 project.xml 中定義的二進位程式檔 |
| 168 | {{{ |
| 169 | boinc-server:/var/www/boinc_projects# cd apps/uppercase |
| 170 | boinc-server:/var/www/boinc_projects/apps/uppercase# ls |
| 171 | uppercase_1.1_i686-pc-linux-gnu |
| 172 | boinc-server:/var/www/boinc_projects/apps/uppercase# mkdir -p uppercase_1.1_x86_64-pc-linux-gnu |
| 173 | boinc-server:/var/www/boinc_projects/apps/uppercase# cp uppercase_1.1_i686-pc-linux-gnu/uppercase_1.1_i686-pc-linux-gnu uppercase_1.1_x86_64-pc-linux-gnu/uppercase_1.1_x86_64-pc-linux-gnu |
| 174 | }}} |
| 175 | * 注意:目錄的命名法則為『應用程式名稱_版本_CPU架構-作業系統』,而二進位程式檔的『版本』、『CPU架構』及『作業系統』都必須與目錄一致,也必須跟 project.xml 中寫的一致(參考 BOINC 官方網站註明的『已支援CPU架構、作業系統』),否則會在執行 bin/update_versions 時出現錯誤。 |
| 176 | {{{ |
| 177 | boinc-server:/var/www/boinc_projects# bin/update_versions |
| 178 | Ignoring directory (no main program found - it has to be named the same as the directory) /var/www/boinc_projects/apps/uppercase/uppercase_1.1_x86_64-pc-linux-gnu |
| 179 | No new versions found! |
| 180 | }}} |
| 181 | * 編輯專案網頁相關設定 html/project/project.inc |
| 182 | {{{ |
| 183 | #!diff |
| 184 | --- project.inc.org 2008-05-07 19:33:47.000000000 -0700 |
| 185 | +++ project.inc 2008-05-07 19:36:00.000000000 -0700 |
| 186 | @@ -7,7 +7,7 @@ |
| 187 | require_once("../inc/util.inc"); |
| 188 | |
| 189 | $master_url = parse_config(get_config(), "<master_url>"); |
| 190 | -define("PROJECT", "REPLACE WITH PROJECT NAME"); |
| 191 | +define("PROJECT", "Bioinfo@Home"); |
| 192 | define("URL_BASE", $master_url); |
| 193 | define("IMAGE_PATH", "../user_profile/images/"); |
| 194 | define("IMAGE_URL", "user_profile/images/"); |
| 195 | @@ -15,14 +15,14 @@ |
| 196 | define("PROFILE_URL", "user_profile/"); |
| 197 | define("LANGUAGE_FILE", "languages.txt"); |
| 198 | define("STYLESHEET", "white.css"); |
| 199 | -define("COPYRIGHT_HOLDER", "REPLACE WITH COPYRIGHT HOLDER"); |
| 200 | -define("SYS_ADMIN_EMAIL", "admin@$master_url"); |
| 201 | -define("UOTD_ADMIN_EMAIL", "admin@$master_url"); |
| 202 | +define("COPYRIGHT_HOLDER", "NCHC,Taiwan"); |
| 203 | +define("SYS_ADMIN_EMAIL", "YOURNAME@NCHC.ORG.TW"); |
| 204 | +define("UOTD_ADMIN_EMAIL", "YOURNAME@NCHC.ORG.TW"); |
| 205 | // who gets user of the day pool running low e-mails? |
| 206 | |
| 207 | // Email addresses separated by pipe ( | ) that will receive user reported |
| 208 | // offensive forum posts. |
| 209 | -define("POST_REPORT_EMAILS", "moderator1@$master_url|moderator2@$master_url"); |
| 210 | +define("POST_REPORT_EMAILS", "YOURNAME@NCHC.ORG.TW|YOURNAME2@NCHC.ORG.TW"); |
| 211 | |
| 212 | function project_banner($title) { |
| 213 | // Put your project title and logo here |
| 214 | }}} |
| 215 | * 啟動範例專案 |
| 216 | {{{ |
| 217 | boinc-server:/var/www/boinc_projects# bin/xadd |
| 218 | boinc-server:/var/www/boinc_projects# bin/update_versions |
| 219 | boinc-server:/var/www/boinc_projects# bin/start |
| 220 | boinc-server:/var/www/boinc_projects# bin/status |
| 221 | }}} |
| 222 | * 檢視 BOINC Project 範例 |
| 223 | * 專案計畫首頁 - http://140.110.X.X/bioinfo |
| 224 | * 專案管理首頁 - http://140.110.X.X/bioinfo_ops/ |
| 225 | |
| 226 | == 測試 BOINC Project 範例 == |
| 227 | |
| 228 | * STEP 1: 首先安裝 boinc-client |
| 229 | {{{ |
| 230 | boinc-client:~# apt-get install boinc-client |
| 231 | }}} |
| 232 | * STEP 2: 其次是前往 http://140.110.X.X/bioinfo/create_account_form.php 註冊帳號 |
| 233 | * 取得 Account key , 例如: 8346cd95017b110ee2ecd88ed7734981 |
| 234 | * [備註] 相同的資訊可以登入後, 在 http://140.110.X.X/bioinfo/home.php 取得 |
| 235 | * 亦可使用命令列取得 Account key |
| 236 | {{{ |
| 237 | boinc-client:~# boinc_cmd --create_account http://140.110.X.X/bioinfo ${YOUR_EMAIL} "${YOUR_PASSWORD}" ${YOUR_ID} |
| 238 | status: Success |
| 239 | poll status: operation in progress |
| 240 | poll status: operation in progress |
| 241 | account key: 8346cd95017b110ee2ecd88ed7734981 |
| 242 | }}} |
| 243 | * STEP 3: 測試 boinc-client 登入 BOINC Project 範例 |
| 244 | * [方法一] 直接執行 boinc |
| 245 | {{{ |
| 246 | boinc-client:~# boinc -attach_project http://140.110.X.X/bioinfo 8346cd95017b110ee2ecd88ed7734981 & |
| 247 | ########################### 說明 ######################################### |
| 248 | boinc-server:~# boinc -attach_project ${專案網址} ${線上申請到的_Account_key} & |
| 249 | }}} |
| 250 | * [方法二] 讓 boinc-client 跑在背景, 再用 boinc_cmd 去加入 project |
| 251 | {{{ |
| 252 | boinc-client:~# /etc/init.d/boinc-client start |
| 253 | ##### 加入專案 ##### |
| 254 | boinc-client:~# boinc_cmd --project_attach http://140.110.X.X/bioinfo 8346cd95017b110ee2ecd88ed7734981 |
| 255 | ##### 取得狀態 ##### |
| 256 | boinc-client:~# boinc_cmd --get_state |
| 257 | ##### 離開專案 ##### |
| 258 | boinc-client:~# boinc_cmd --project http://140.110.X.X/bioinfo detach |
| 259 | }}} |
| 260 | |
| 261 | == 錯誤排除 == |
| 262 | |
| 263 | * [狀況一] 當 boinc client 加入專案後, 一直無法取得系統狀態. 查看 /var/lib/boinc_client/sched_replay_* 出現以下訊息 |
| 264 | {{{ |
| 265 | }}} |
| 266 | * [參考] [http://scilincdev.blogspot.com/2006/12/boinc-server-shared-memory-error.html BOINC Server Shared Memory Error] |