CloudStack升級中文指南: 4.1.x/4.2.x 至 4.3版本
本文翻譯於官方文檔,當考慮到衆多朋友方便查閱,特翻譯成中文供大家參考。
原文連接:http://docs.cloudstack.apache.org/projects/cloudstack-release-notes/en/latest/rnotes.html
那啥,我讀書不多,要是翻譯不對別噴我。
爲了方便大家,製作了pdf文檔,在附件。
稍後我會給出具體升級案例指導。
大多數CS用戶在安裝或者更新時採用包管理系統,比如RPM或者APT. 本指南將指導你如何通過RPM、YUM (針對 Red Hat Enterprise Linux 或者CentOS), 或 APT和Debian (針對 Ubuntu).
備註
不管使用何種虛擬化.該手冊將指導你如何進行升級工作.
在現有CS4.1、4.2平臺中,使用管理賬戶登錄管理控制檯。
在左邊導航中,點擊模版。
選擇模版視圖.
點擊註冊模版.
註冊模版信息如下面表格所示.
在註冊模版對話框中, 按如下表格填寫 (切記,不可改變如下信息):
虛擬化 描述 XenServer Name: systemvm-xenserver-4.3
Description: systemvm-xenserver-4.3
URL: http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-xen.vhd.bz2
Zone: Choose the zone where this hypervisor is used
Hypervisor: XenServer
Format: VHD
OS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in the dropdown)
Extractable: no
Password Enabled: no
Public: no
Featured: no
KVM Name: systemvm-kvm-4.3
Description: systemvm-kvm-4.3
URL: http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-kvm.qcow2.bz2
Zone: Choose the zone where this hypervisor is used
Hypervisor: KVM
Format: QCOW2
OS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in the dropdown)
Extractable: no
Password Enabled: no
Public: no
Featured: no
VMware Name: systemvm-vmware-4.3
Description: systemvm-vmware-4.3
URL: http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-vmware.ova
Zone: Choose the zone where this hypervisor is used
Hypervisor: VMware
Format: OVA
OS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in the dropdown)
Extractable: no
Password Enabled: no
Public: no
Featured: no
通過4.2.1源碼包創建RPM或Debian軟件包(視情況而定) ,通過CloudStack下載頁面:http://cloudstack.apache.org/downloads.html 查找社區成員提供的軟件包倉庫 . 你會需要步驟 8 或 11.
通過源碼包創建Cloudstack安裝包說明: Installation Guide.
停止你的cloudstack-management服務. 在management主機中運行如下命令:
# service cloudstack-management stop
如果你在運行usage server 或usage servers, 則停止如下服務:
# service cloudstack-usage stop
對Mysql數據庫做備份.如果你遇到任何問題或需要回滾升級, 這將協助或恢復您的現有環境. 按系統提示輸入你的密碼.
# mysqldump -u root -p cloud > cloudstack-backup.sql
(僅KVM主機) 如果使用了本地存儲作爲主存儲,該存儲路徑需要確認可以通過驗證.從cloud.storage_pool 表查詢本地存儲信息:
#mysql -u cloud -p -e "select id,name,path from cloud.storage_pool where pool_type='Filesystem'"
如果本地存儲路徑最後有斜槓“/”, 則移除:
#mysql -u cloud -p -e 'update cloud.storage_pool set path="/var/lib/libvirt/images" where path="/var/lib/libvirt/images/"';
如果你在使用Ubuntu,遵循如下步驟進行軟件包的升級. 如果沒有,跳至步驟11.
Note
Community Packages:這一步假設你在使用社區提供的CloudStack倉庫. 如果你創建了自己的軟件包和yum倉庫, 在如下例子中,替換你自己的URL.
第一步要做的就是配置所有的Cloudstack主機的倉庫源列表. 包括所有的management主機和kvm主機 . (運行VMware 或 Xen的主機不需要更改 .)
首先打開
/etc/apt/sources.list.d/cloudstack.list
在任何需要安裝cloudstack軟件包的主機上 .這個文件應該包含一行如下信息:
deb http://cloudstack.apt-get.eu/ubuntu precise 4.0
我們將它更改爲新的軟件包倉庫:
deb http://cloudstack.apt-get.eu/ubuntu precise 4.2
如果你使用自己的軟件包倉庫, 改變這一行信息爲你自己的4.3.0倉庫..
更新apt包列表:
$ sudo apt-get update
現在你配置好軟件倉庫, 可以開始安裝
cloudstack-management
. 這一步會有很多依賴的包被安裝.$ sudo apt-get install cloudstack-management
你需要手動安裝
cloudstack-agent
:$ sudo apt-get install cloudstack-agent
在安裝
cloudstack-agent期間
, APT會從/etc/cloud/agent拷貝你的agent.properties
,log4j-cloud.xml
, 和environment.properties
文件到/etc/cloudstack/agent
.當提示是否保留你的配置時, 選擇“是”.
驗證該文件中
/etc/cloudstack/agent/environment.properties
有如下記錄:paths.script=/usr/share/cloudstack-common
如果不存在,則添加此行.
重啓agent服務:
service cloudstack-agent stop killall jsvc service cloudstack-agent start
(僅VMware) VMware集羣需要做額外的操作. 這些步驟不會影響雲中正在運行的虛擬機. 這些步驟只針對雲環境中使用的 VMware集羣:
停止Management服務:
service cloudstack-management stop
生成加密後的VCenter密碼:
java -classpath /usr/share/cloudstack-common/lib/jasypt-1.9.0.jar org.jasypt.intf.cli.JasyptPBEStringEncryptionCLI encrypt.sh input="_your_vCenter_password_"password="`cat /etc/cloudstack/management/key`"verbose=false
保存此步驟的輸出, 我們需要將其替換cluster_details和vmware_data_center中的純文本密碼
查找cluster_details表中要被更新的行ID:
mysql -u <username> -p<password>
select * from cloud.cluster_details;
更新純文本密碼爲加密密碼:
update cloud.cluster_details set value='_ciphertext_from_step_1_' where id= _id_from_step_2_;
確認如下表被更新:
select * from cloud.cluster_details;
查找vmware_data_center表中要被更新的行ID:
select * from cloud.vmware_data_center;
更新純文本密碼爲加密密碼:
update cloud.vmware_data_center set password='_ciphertext_from_step_1_' where id= _id_from_step_5_;
確認如下表被更新:
select * from cloud.vmware_data_center;
啓動Management服務
service cloudstack-management start
(僅KVM) 每一個KVM主機需要額外的步驟 These steps will not affect running guests in the cloud. 該步驟只針對雲環境中的KVM主機.
配置CloudStack的yum倉庫.
停止agent服務.
# service cloustack-agent stop
升級agent軟件.
# yum update cloudstack-agent
啓動agent.
# service cloudstack-agent start
如果你使用CentOS 或 RHEL,遵循如下步驟進行軟件包的升級. 如果沒有,跳至步驟 13.
備註
Community Packages: 這一步假設你在使用社區提供的CloudStack倉庫. 如果你創建了自己的軟件包和yum倉庫, 在如下例子中,替換你自己的URL.
第一步要做的就是配置所有的Cloudstack主機的yum軟件包倉庫. 包括所有的management主機和kvm主機.
(運行VMware 或 Xen的主機不需要更改.)
首先打開
/etc/yum.repos.d/cloudstack.repo
在任何需要安裝cloudstack軟件包的主機上.這個文件內容應該類似於下面的:
[apache-cloudstack]name=Apache CloudStack baseurl=http://cloudstack.apt-get.eu/rhel/4.0/ enabled=1 gpgcheck=0
如果你在使用社區提供的軟件包倉庫, 改變基礎URL爲:http://cloudstack.apt-get.eu/rhel/4.3/
如果你使用自己的軟件包倉庫, 改變這一行信息爲你自己的倉庫.
現在你已經配置好軟件倉庫, 可以開始升級新的
cloudstack-management軟件包來更新舊的軟件包
.$ sudo yum upgrade cloudstack-management
針對KVM主機, 你需要升級
cloud-agent
軟件包, 新版本爲:cloudstack-agent
.$ sudo yum upgrade cloudstack-agent
驗證該文件中
/etc/cloudstack/agent/environment.properties
有如下記錄:paths.script=/usr/share/cloudstack-common
如果不存在,則添加此行.
重啓agent服務:
service cloudstack-agent stop killall jsvc service cloudstack-agent start
現在啓動cloudstack-management服務:
# service cloudstack-management start
一旦你升級了管理服務器的軟件包, 你需要重啓系統虛擬機. 確保使用全局變量 “integration.api.port” 將管理端口設置爲8096. 在升級結束後cloud-sysvmadm腳本會使用這個端口.關於如何設置這個參數, 請看 “Setting Global Configuration Parameters” 這個安裝指南. 改變這個參數需要重新啓動管理服務.
還要確認在你本地主機防火牆中開放8096端口.
這裏有個腳本幫助你做這些。運行這個腳本時你需要提供Mysql實例主機IP地址和認證信息:
# nohup cloudstack-sysvmadm -d IP address -u cloud -p -a > sysvm.log 2>&1 &
你可以監控該日誌進程. 系統VM重啓需要花費一些時間.
# tail -f sysvm.log
在輸出文件sysvm.log中你會看到類似如下信息:
Stopping and starting 1 secondary storage vm(s)... Done stopping and starting secondary storage vm(s) Stopping and starting 1 console proxy vm(s)... Done stopping and starting console proxy vm(s). Stopping and starting 4 running routing vm(s)... Done restarting router(s).
備註
針對 Xen Hosts: 複製 vhd-utils: 此步驟只針對使用CS管理的XEN主機.
複製文件
vhd-utils
到/usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver
.