wiki:Eucalyptus/Install

Context Navigation

Version 27 (modified by rock, 16 years ago) (diff)
--

【0.序言】
【1.必要環境】
1. 1.1 編譯 Euc 所需的套件
2. 1.2 執行 Euc 所需的套件
【2.安裝】
1. 2.1 從 Source 安裝
2. 2.2 從套件檔安裝 (deb)
【3.配置】
1. 3.1 系統配置
2. 3.2 啟動 Euc
【4.管理】
1. 4.1 Euc 印象檔管理
2. 4.2 Euc 管理
【5.問題排解】
【想法】
【Reference】

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個元件的架構圖:
1. Cloud controller (CLC) -> Java 寫的程式，負責高階的資源排程和系統 accounting，此外也提供 Web services 和網頁介面讓外界使用者可以連接
2. Cluster controller (CC) -> 用 C 撰寫，在 Apache 內當成 Web server 來佈署
3. 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'設定檔內)
1. SYSTEM Mode -> 最簡單的網路配置，Euc 發 random MAC 位址，使用 Xen Bridge，配合 DHCP 來發 IP，適合小環境測試用
2. STATIC Mode -> 此模式可讓 Euc 管理者管理 VM 的 MAC 和 IP 位址(和 SYSTEM Mode 一樣會使用到 Xen Bridge 和 DHCP)，適合當管理者有一群 MAC/IP 時
3. 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 的設定
1. 在 CLC 那台登入 https://localhost:8443/ (admin/admin)
  - 修改 admin 密碼
  - 修改 mail
  - 確認網址和 Walrus service(Euc Storage)
2. 到'Configuration'標籤，選擇'Add Cluster'再'Save clusters'之後，會產生認証的 Key，需手動分配給所有的 nodes
```
### 這個指令會使用 rsync 和 ssh 來散佈 key ###
$ $EUCALYPTUS/usr/sbin/euca_sync_key -c $EUCALYPTUS/etc/eucalyptus/eucalyptus.conf 
```
3. 最後，你必須產生使用者的認証，選擇 'Credentials' 標籤和按下 'Download certificates' 來下載，你能使用基於 x509 的 EC2 tools 和第3方工具(rightscale.com)
```
$ mkdir $HOME/.euca

### 當你要使用 Euc時，source 此檔案 ###
$ source $HOME/.euca/eucarc
```

【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 (有三種方法)
1. 在 'ec2-bundle-image' 步驟指定
```
$ ec2-bundle-image -i <path/to/my/>vmimage.img --kernel <eki-XXXXXXXX> --ramdisk <eri-XXXXXXXX>
```
2. 再執行時指定 'ec2-run-instances'
```
ec2-run-instances <emi-XXXXXXXX> --kernel <eki-XXXXXXXX> --ramdisk <eri-XXXXXXXX>
```
3. 在 https://your.cloud.server:8443 選擇 'Configuration' 標籤，新增 <eki-xxxxxxxx> 和 <eri-xxxxxxxx> 作為預設的 kernel 和 ramdisk

刪除 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  
```
印象檔管理
- 參考之前

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 
```

問題判斷

若是有些無法正常運作，第一步可以參考文件檢查 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
...

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】

Attachments (4)

A_Tech_Report_Euc.pdf (394.0 KB) - added by rock 16 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 16 years ago.
sign.png (47.5 KB) - added by rock 16 years ago.
architecture.png (16.0 KB) - added by rock 15 years ago.

Download all attachments as: .zip

Download in other formats:

Plain Text