| Version 27 (modified by rock, 15 years ago) (diff) |
|---|
Eucalyptus 管理者手冊
【0.序言】
- 本文件參考 Eucalyptus Administrator Guide v1.5，分為5部份：(1)必要環境的設定，(2)安裝，(3)配置，(4)管理，(5)問題排解
- Euc 分為三個元件： 元件間透過 SOAP with WS-security 溝通，一個 Cluster 只會有一個 head node 來執行Cluster controller 和每個 node 都個有一個 Node controller
- Euc 3個元件的架構圖:
- Cloud controller (CLC) -> Java 寫的程式，負責高階的資源排程和系統 accounting，此外也提供 Web services 和網頁介面讓外界使用者可以連接
- Cluster controller (CC) -> 用 C 撰寫，在 Apache 內當成 Web server 來佈署
- Node controller (NC) -> 用 C 撰寫，在 Apache 內當成 Web server 來佈署
【1.必要環境】
1.1 編譯 Euc 所需的套件
- (1)C compilers (2)Java Developer Kit - SDK version 1.6 or above (3)Apache ant 1.6.5 or above (4)Curl development package (5)openssl development package (6)zlib development package
1.2 執行 Euc 所需的套件
| Front-end | (1) Java6 (2) Apache ant -> cloud controller (3)Java(TM) Cryptography Extension-JCE (4) Run a server on port 25 & Exim, postfix to send mail (5) Dhcp3-server (6) iptables, vlan(vconfig) (7) 如果從 rpm 安裝的話，必須再安裝 xen-libs RPM |
| Node | (1) xen > 3.0.X： enabule Unix Socket for Euc to contorl Xen -> xend-unix-server yes，Euc 透過 libvirt >0.6.0 與 hypervisior 互動，需確定 libvrt 是正常的來執行 Eucalyptus Node Controller (2) Euc 支援各種網路型式 : vlan (vconfig), bridge-utils, xen-utils |
| 與 Euc 互動的套件 | 需安裝 EC2 command-line tools： (1)ec2-api-tools-1.3-30349 (2)ec2-ami-tools-1.3-26357 |
【2.安裝】
2.1 從 Source 安裝
2.2 從套件檔安裝 (deb)
【3.配置】
3.1 系統配置
- Front-end
$EUCALYPTUS/usr/sbin/euca_conf -cc Y -cloud Y -nc N $EUCALYPTUS/etc/eucalyptus/eucalyptus.conf
- Node controler
$EUCALYPTUS/usr/sbin/euca_conf -nodes "<hostname1> ... <hostnamen>" $EUCALYPTUS/etc/eucalyptus/eucalyptus.conf
- 設定 storage 存放 image template
for x in hostname1 hostname2 ... hostnameN ; do \ ssh $x "mkdir -p /usr/local/instances/; $EUCALYPTUS/usr/sbin/euca_conf -cc N -cloud N -nc Y -instances /usr/local/instances $EUCALYPTUS/etc/eucalyptus/eucalyptus.conf" done
- 網路配置 (提供三種高階的網路 modes，必須選擇合適的網路模式再 front-end 和 node 在 'eucalyptus.conf'設定檔內)
- SYSTEM Mode -> 最簡單的網路配置，Euc 發 random MAC 位址，使用 Xen Bridge，配合 DHCP 來發 IP，適合小環境測試用
- STATIC Mode -> 此模式可讓 Euc 管理者管理 VM 的 MAC 和 IP 位址(和 SYSTEM Mode 一樣會使用到 Xen Bridge 和 DHCP)，適合當管理者有一群 MAC/IP 時
- MANAGED Mode -> 最有特色的 modes，但也相當多的約束，Euc 管理需定義一個大的網路 (private 且 unrouteable)給 VMs，Euc 使用者可定義 'named networks' 和 'security groups'，舉例來說使用者可以選擇是否允許 ping (ICMP) 或 ssh (TCP, port 22)到他們的 VMs，此外，Eua 也可定義一個 Public Network Pool(在Amazon 稱為 elastic IP)。此 mode 適用於需要 security groups, elastic IPs 和 VM network isolation
使用 SYSTEM和 STATIC 會關掉一些特色 (1)VMs間的進出規則(在Amzaon EC2 稱為 security groups) (2)使用者可控制和動態IPs分配再開機和執行期間(在Amazon EC2 稱為 elastic IPs) (3)VMs間的網路流量的的隔離
3.2 啟動 Euc
- 啟動
$ $EUCALYPTUS/etc/init.d/eucalyptus start
- 停止
$ $EUCALYPTUS/etc/init.d/eucalyptus stop
- 設定開機自動啟動
$ ln -sf $EUCALYPTUS/etc/init.d/eucalyptus /etc/init.d/eucalyptus ### 以下兩者擇一即可 ### $ update-rc.d eucalyptus defaults $ chkconfig eucalyptus on
- 第1次執行 Euc 的設定
- 在 CLC 那台 登入 https://localhost:8443/ (admin/admin)
- 修改 admin 密碼
- 修改 mail
- 確認網址和 Walrus service(Euc Storage)
- 到'Configuration'標籤，選擇'Add Cluster'再'Save clusters'之後，會產生認証的 Key，需手動分配給所有的 nodes
### 這個指令會使用 rsync 和 ssh 來散佈 key ### $ $EUCALYPTUS/usr/sbin/euca_sync_key -c $EUCALYPTUS/etc/eucalyptus/eucalyptus.conf
- 最後，你必須產生使用者的認証，選擇 'Credentials' 標籤和按下 'Download certificates' 來下載，你能使用 基於 x509 的 EC2 tools 和第3方工具(rightscale.com)
$ mkdir $HOME/.euca ### 當你要使用 Euc時，source 此檔案 ### $ source $HOME/.euca/eucarc
- 在 CLC 那台 登入 https://localhost:8443/ (admin/admin)
【4.管理】
4.1 Euc 印象檔管理
- 執行前的注意事項: (1)已 source 'eucaer' 檔案 (2)user 可以註冊 Image，但只有管理者可以註冊 kernel/ramdisks (3)已安裝EC2 tools： ec2-api-tools-1.3-30349 和 ec2-ami-tools-1.3-26357)
- 新增 Image
### Euc 提供的 test image ### $ cd $EUCALYPTUS_SRC/eucalyptus-src-deps $ tar zxvf euca-ttylinux.tgz ### 新增 Kernel 到 Walrus 並再 Euc 註冊此 Kernel ### $ ec2-bundle-image -i ttylinux/vmlinuz-2.6.16.33-xen --kernel true $ ec2-upload-bundle -b kernel-bucket -m /tmp/vmlinuz-2.6.16.33-xen.manifest.xml $ ec2-register kernel-bucket/vmlinuz-2.6.16.33-xen.manifest.xml ### 增加 root FS Image 給 Walrus ### $ ec2-bundle-image -i ttylinux/ttylinux.img $ ec2-upload-bundle -b image-bucket -m /tmp/ttylinux.img.manifest.xml $ ec2-register image-bucket/ttylinux.img.manifest.xml ### 測試的 Image 可以不用 ramdisks，但若需要可以用以下指令新增 ### $ ec2-bundle-image -i <path/to/my/>initrd.img --ramdisk true $ ec2-upload-bundle -b <bucket_name> -m <path/to/my/>initrd.img.manifest.xml $ ec2-register <bucket_name>/initrd.img.manifest.xml
- 分配 Kernel 和 Ramdisks 給 VMs (有三種方法)
- 在 'ec2-bundle-image' 步驟指定
$ ec2-bundle-image -i <path/to/my/>vmimage.img --kernel <eki-XXXXXXXX> --ramdisk <eri-XXXXXXXX>
- 再執行時指定 'ec2-run-instances'
ec2-run-instances <emi-XXXXXXXX> --kernel <eki-XXXXXXXX> --ramdisk <eri-XXXXXXXX>
- 在 https://your.cloud.server:8443 選擇 'Configuration' 標籤，新增 <eki-xxxxxxxx> 和 <eri-xxxxxxxx> 作為預設的 kernel 和 ramdisk
- 在 'ec2-bundle-image' 步驟指定
- 刪除 Image
### 先取消註冊 ### ec2-deregister <emi-XXXXXXXX> ### 移除存於 bucke 的檔案 ### ec2-delete-bundle -a $EC2_ACCESS_KEY -s $EC2_SECRET_KEY --url $S3_URL -b <bucket> -p <file prefix> ### 移除檔案和 bucke (--clear)### ec2-delete-bundle -a $EC2_ACCESS_KEY -s $EC2_SECRET_KEY --url $S3_URL -b <bucket> -p <file prefix> --clear
4.2 Euc 管理
- 管理者環境
- 目前管理者只能透過命令列來管理，需注意Euc的路徑必須正確被宣告，才能正常執行指令
### 宣告 EUCALYPTUS 路徑 ### $ export EUCALYPTUS=/path/to/eucalyptus
- 目前管理者只能透過命令列來管理，需注意Euc的路徑必須正確被宣告，才能正常執行指令
- 印象檔管理
- 參考之前
- Node管理
### 可編輯 $EUCALYPTUS/etc/eucalyptus/eucalyptus.conf 來修改 node 列表 ### NODES="vm-container-0-0 vm-container-0-1" ### 當增加node，記的將 key 複製給 node ### ${EUCALYPTUS}/usr/sbin/euca_sync_key - 使用者管理
- 使用者註冊 -> 可到 https://your.front.end.hostname:8443/ 註冊，點選Apply for account，之候選填相關的資訊，直到管理者審核後會發mail通知註冊成功
- 增加使用者 -> 管理者也可直接透過 wen 介面增加，點選 'Users' 標籤並選 'Add User'
- 管理使用者 -> 管理者透過網頁 'disable' 或 'delete' 使用者
【5.問題排解】
- 重新啟動
- 當 front-end 要重啟時，需要關掉所有的 VMs (可使用 client tools )，或是手動使用 'xm destroy'
### 再 head node 執行 ### /etc/init.d/eucalyptus restart
- 當 front-end 要重啟時，需要關掉所有的 VMs (可使用 client tools )，或是手動使用 'xm destroy'
- 問題判斷
- 若是有些無法正常運作，第一步可以參考文件檢查 installation/configuration/networking 部份，來確定元件是否正常運作，資源是否可被 instances 使用，eucarc 使否正確被 source和認証，也可使用以下指令來了解系Cloud 系統狀態
$ ec2-describe-availability-zones verbose AVAILABILITYZONE cluster <hostname of your front-end> AVAILABILITYZONE |- vm types free / max cpu ram disk AVAILABILITYZONE |- m1.small 0128 / 0128 1 128 10 AVAILABILITYZONE |- c1.medium 0128 / 0128 1 256 10 AVAILABILITYZONE |- m1.large 0064 / 0064 2 512 10 AVAILABILITYZONE |- m1.xlarge 0064 / 0064 2 1024 20 AVAILABILITYZONE |- c1.xlarge 0032 / 0032 4 2048 20 AVAILABILITYZONE |- <node-hostname-a> certs[cc=true,nc=true] @ Sun Jan 04 15:13:30 PST 2009 AVAILABILITYZONE |- <node-hostname-b> certs[cc=true,nc=true] @ Sun Jan 04 15:13:30 PST 2009 AVAILABILITYZONE |- <node-hostname-c> certs[cc=true,nc=true] @ Sun Jan 04 15:13:30 PST 2009 AVAILABILITYZONE |- <node-hostname-d> certs[cc=true,nc=true] @ Sun Jan 04 15:13:30 PST 2009 AVAILABILITYZONE |- <node-hostname-e> certs[cc=true,nc=true] @ Sun Jan 04 15:13:30 PST 2009 AVAILABILITYZONE |- <node-hostname-f> certs[cc=true,nc=true] @ Sun Jan 04 15:13:30 PST 2009 ...
- 若是有些無法正常運作，第一步可以參考文件檢查 installation/configuration/networking 部份，來確定元件是否正常運作，資源是否可被 instances 使用，eucarc 使否正確被 source和認証，也可使用以下指令來了解系Cloud 系統狀態
- log file -> $EUCALYPTUS/var/log/eucalyptus/
- 在 front-end 的 CLC -> 'cloud-output.log' 和 'cloud-debug.log'
- 在 front-end/Head Node 的 CC 'cc.log' 和 'httpd-cc_error_log'
- 每個 node 的 NC -> 'nc.log' 和 'httpd-nc_error_log
【想法】
- 和 EC2 相比，Euc 少了 (1)計費或租約機制 (2)類似 S3 的 Storage 機制 (3)似乎沒整合 migrate 的機制。不過畢竟是學校單位的成品，無法做到全面兼顧，但是其架構和想法非常值得參考
- 剛看完版本 1.4 的安裝，想不到隔幾天 1.5 就出來了 @@ (有一些步驟有些改了)
- 1.5 主要增加了 EBS 的支持，新的網路架構 MANAGED-NOVLAN mode，支援 KVM
【Reference】
- Eucalyptus Administrator Guide v1.5
- Eucalyptus : A Technical Report on an Elastic Utility Computing Archietcture Linking Your Programs to Useful Systems
Attachments (4)
-
A_Tech_Report_Euc.pdf
(394.0 KB) -
added by rock 15 years ago.
Eucalyptus : A Technical Report on an Elastic Utility Computing Archietcture Linking Your Programs to Useful Systems
- euc_3com.png (13.5 KB) - added by rock 15 years ago.
- sign.png (47.5 KB) - added by rock 15 years ago.
- architecture.png (16.0 KB) - added by rock 15 years ago.
Download all attachments as: .zip
