云平台用户手册

云平台使用手册

目录

云平台使用手册 (1)

安装 (2)

模块布局 (2)

安装各组件 (2)

启动前设置 (7)

启动 (7)

Cloud-controller (8)

Cloud-node (8)

使用 (8)

目录解析 (8)

配置文件解析 (8)

功能点描述 (11)

整体系统功能布局 (11)

Admin登陆 (12)

查看物理机资源列表 (13)

增加/删除物理节点 (13)

查看虚拟机资源列表 (13)

激活public IP (14)

查看内核镜像列表 (15)

上传image镜像文件 (16)

查看虚拟机资源 (16)

创建虚拟机资源 (17)

使用虚拟机资源 (18)

问题解决 (19)

一些公共的探求问题的方法： (19)

FAQ (20)

附录 (20)

安装

模块布局

●系统由一个cloud-controller和若干个cloud-node组成。

●用户直接请求/访问cloud-controller

安装各组件

注意：cloud-controller与cloud-node安装的内容应该完全一致，安装时的各项参数（安装参数，路径设置等）应该完全一致。

一、安装linux

●版本：CentOS 5.5 64bit版本

●可以在虚拟机中安装，设置版本时，网卡模式选择NAT。

●内存2048M以上。

●CPU可以选择2（CPU）*2（Cores）的规格。

●注意：

?安装后以root账号登陆（后续安装/运行均使用root账户）

?需要保证该linux可以访问网络。

?需要安装中文字体支持，否则中文会显示为乱码。

（安装完中文字体后，如果仍然为乱码，运行fc-cache -fv）

二、准备安装文件

目录结构如下：

●cloud_source——安装文件根目录

?cloud_dep——安装eucalyptus的依赖文件夹

◆Python-2.7.2…——python 2.7安装包

◆Httpd-2.2.21…——apache 2.2.21安装包

◆I386——32bit操作系统的依赖包

●……

◆X86_64——64bit操作系统的依赖包

●……

?cloud_source——eucalyptus的安装文件

◆euca2ools-1.3.1-src-deps.tar.gz ——cloud控制台依赖包

◆eucal2ools-1.3.1.tar.gz ——cloud控制台安装包

◆eucalyptus-2.0.3-src-deps.tar.gz ——cloud主程序依赖包

◆eucalyptus-2.0.3-src-offline.tar.gz ——cloud主程序安装包

◆install_cloud.sh ——整体安装脚本

三、安装XEN

安装原因：

1）Sinobpo-cloud是基于XEN虚拟机的云平台。Xen是Sinobpo-cloud平台运行的基础。

安装步骤：

1

2

(xend-http-server yes)

(xend-address localhost)

3

-rw-r--r-- 1 root root 2.1M 06-01 02:33 vmlinuz-2.6.18-238.12.1.el5xen

-rw-r--r-- 1 root root 412K 06-01 01:15 xen.gz-2.6.18-238.12.1.el5

-rwxr-xr-x 1 root root 956K 06-01 03:27 xen-syms-2.6.18-238.12.1.el5

4）修改max_loop值

这里的loop指的是/dev/loop*。/dev/loop*指的是linux下虚拟的挂载点。在xen创建虚拟机时，xen会将kernel/image/ramdisk分别挂在到3个loop虚拟设备上，用

以创建虚拟机对象。

默认linux仅支持8个loop设备，因此单台机器最多支持创建2个虚拟机对象。

因此，如果我们需要创建更多的虚拟机，必须要放大loop设备数量。

5

输出：

Name ID Mem(MiB) VCPUs State Time(s)

Domain-0 0 7531 4 r----- 17.5

出现上述结果表示xen启动正常

四、安装依赖系统包

安装步骤：

注意：这步骤需要保证linux可以访问网络。

五、安装apache 2.2.21

安装原因：

1）eucalyptus的三个核心模块：cloud-control, cloud-cluster, cloud-node均以apache-module的方式运行，apache是三者运行的基础

2）默认apache无法以root方式运行。因此我们必须hack apache使之可以以root权限运行。

安装步骤：

1

2

3

编译时增加BIG_SECURITY_HOLE的宏定义

4

5）调整

此时系统中原版本apache与新版本apache并存，因此需要指明新apache的位置，以便后面cloud-controller/cloud-cluster/cloud-node调用。

6

输出：

Server version: Apache/2.2.21 (Unix)

Server built: Sep 25 2011 09:34:09

Server's Module Magic Number: 20051115:30

Server loaded: APR 1.2.7, APR-Util 1.2.7

Compiled using: APR 1.2.7, APR-Util 1.2.7

Architecture: 32-bit

Server MPM: Prefork

threaded: no

forked: yes (variable process count)

Server compiled with....

-D BIG_SECURITY_HOLE

-D APACHE_MPM_DIR="server/mpm/prefork"

-D APR_HAS_SENDFILE

-D APR_HAS_MMAP

-D APR_HAVE_IPV6 (IPv4-mapped addresses enabled)

-D APR_USE_SYSVSEM_SERIALIZE

-D APR_USE_PTHREAD_SERIALIZE

-D SINGLE_LISTEN_UNSERIALIZED_ACCEPT

-D APR_HAS_OTHER_CHILD

-D AP_HAVE_RELIABLE_PIPED_LOGS

-D DYNAMIC_MODULE_LIMIT=128

-D HTTPD_ROOT="/usr/local/apache2"

-D SUEXEC_BIN="/usr/local/apache2/bin/suexec"

-D DEFAULT_PIDLOG="logs/httpd.pid"

-D DEFAULT_SCOREBOARD="logs/apache_runtime_status"

-D DEFAULT_LOCKFILE="logs/accept.lock"

-D DEFAULT_ERRORLOG="logs/error_log"

-D AP_TYPES_CONFIG_FILE="conf/mime.types"

-D SERVER_CONFIG_FILE="conf/httpd.conf"

六、安装python 2.7

安装原因：

1）python 2.7是cloud的核心访问工具cloudtools的依赖库。系统默认的python 2.4.3无法正常工作

安装步骤：

1）准备Python（附带安装包中已有，不需要下载）

2

3

4

输出（出现飘红词则表明安装正确）：

Python 2.7.2 (default, Aug 21 2011, 09:36:32)

[GCC 4.1.2 20080704 (Red Hat 4.1.2-50)] on linux2

Type "help", "copyright", "credits" or "license" for more information.

七、安装Sinobpo-cloud依赖包

安装步骤：

1

2

八、安装Sinobpo-cloud

安装步骤：

1

2

注意：$(installed_path)为安装目录，可自己定义。

启动前设置

1）同步CC/NC的时钟

如果cc/nc时钟不同步，则无法加入到同一个网络中。

2

3

4

5

注意：init最后阶段需要进行3个模块的密钥同步，因此需输入cloud-controller机器的root密码三次。

启动

所有控制命令路径均为：/home/sinobpo-cloud/bin/，其中/home/ sinobpo-cloud为sinobpo-cloud平台的安装路径。

先启动cloud-controller，待启动完成后再启动cloud-node。否则cloud-node无法启动。

Cloud-controller

1）启动

./cc-start.sh

2）重启（修改了配置文件后，必须重启才能生效）

./cc-restart.sh

3）停止

./cc-stop.sh

Cloud-node

1）启动

./nc-start.sh

2）重启（修改了配置文件后，必须重启才能生效）

./nc-restart.sh

3）停止

./nc-stop.sh

使用

目录解析

了解sinobpo-cloud安装目录结构有助于对sinobpo-cloud平台进行更全面的掌握，也有助于更快的修改sinobpo-cloud的配置项，查看错误日志以解决问题。

由于sinobpo-cloud的目录结构过于复杂，下面仅列出比较关键的几个目录。

●/home/ sinobpo-cloud ——主目录

?etc/eucalyptus/ ——sinobpo-cloud配置信息目录

?usr/sbin/ ——sinobpo-cloud自带的命令字

?bin/ ——简化sinobpo-cloud操作命令目录，满足绝大多数功能

?var/tmp/ ——sinobpo-cloud在运行时存放临时文件的目录

?var/data/ ——sinobpo-cloud运行时需要加载的mapping文件目录

?var/image/ ——image压缩包存放文件夹

?var/log/eucalyptus/——sinobpo-cloud运行时日志文件路径（查问题时依赖）配置文件解析

sinobpo-cloud的配置文件制定了sinobpo-cloud的操作行为，了解配置项的含义后，可根据自己的需要进行调整。下面会介绍几个关键的配置文件内容。

配置文件均存放在：/home/ sinobpo-cloud /etc/eucalyptus/目录下。

二、eucalyptus.conf

eucalyptus.conf文件是eucalyptus系统的核心文件，内容较多。通常来讲，我们只需要修改eucalyptus.conf中的一部分信息满足需要。下文中仅描述了我们需要重点关注的部分字

功能点描述

整体系统功能布局

Admin

创建虚拟机资源时，需要指明：

●内核镜像名称

●虚拟机资源类型

●指定IP

因此在创建虚拟机之前，我们需要保证：

●系统中有可用的内核镜像（如没有，需要上传）

●系统中有可用的IP资源（如没有，需要激活public IP）

●系统中有合适的虚拟机资源类型（默认5种，数据可以修改）

Admin登陆

Sinobpo-cloud平台拥有基于web的UI。访问：https://{cloud-controller-ip}:8443即可以登录页面。

只有admin账号才有全部权限。所以需要以admin账号登陆。

初次登录时，需要输入完整的用户账号信息。

登陆后，进入用户信息界面，如下：

查看物理机资源列表

进入“物理节点列表”标签页后，界面如下：

如果物理节点发生了改动，点击“刷新”进行请求重新探测。

增加/删除物理节点

●在“添加节点”后的输入框中输入IP，然后点“添加节点”按钮，可以添加一个IP。

添加时需要输入目标机的root密码，系统将进行nc/cc间的密钥同步工作。

●点击条目后的“删除”，可以卸载此节点。

查看虚拟机资源列表

展示的内容分为两部分：

●可用的虚拟机硬件资源列表

●可用的IP资源列表

激活public IP

注意到，上图中的IP资源状态栏，均为nobody。Nobody表明该IP无法被admin所使用。使用前必须要激活。

点击“激活全部IP”按钮。

当IP状态变为available时，标明这个IP可用于分配给虚拟机。

注明：最后一个IP（188.160）被预设为保留IP，无法激活。查看内核镜像列表

内核镜像列表列举了当前系统中全部可以使用的镜像。镜像名称，用以辨别镜像的身份，在创建虚拟机时必须指明。

镜像文件决定了虚拟机创建之后所拥有的操作系统，以及内部含有的组件。

上传image镜像文件

如果需要，可以创建自己的镜像文件后，上传到系统中，供用户所使用。

在“添加镜像”按钮后的输入框中输入镜像名称，并选取制作好的image_file。

注意：

●需要保证image_file的路径同之前euca_func.conf中所给出的IMAGE_PATH相同。

●需要保证制作的image_file中包含image_file, kernel_file, ramdisk_file三种类型的文

件。

●需要保证三种类型的文件名同euca_func.conf所配置的文件名相同。

查看虚拟机资源

此处列出了已有的虚拟机节点信息。

创建虚拟机资源

上图中是创建虚拟机的状态行。注意到输入框（输入虚拟机名称）后是3个listbox，需要管理员指明虚拟机创建时的三个参数。

需要注意，下拉框内数据，需要到对应的页面上刷新一次才能够更新。

虚拟机硬件类型（与前文中所示的“虚拟机资源类型列表”一致）：

虚拟机内核镜像列表（与前文所示的“虚拟机镜像名列表”一致）：

虚拟机IP分配列表（与前文所示的“虚拟机可用IP列表”一致）：

IP分配时可以根据需要，选择“随机地址”，也可以“给定地址”。

创建虚拟机

创建虚拟机比较耗时，在sinobpo-cloud内部，创建虚拟机分成两步骤：

1、创建桩

首先，sinobpo-cloud创建桩。此时，虚拟机资源进行了占位，正在启动过程中，无法使用，虚拟机状态为pending。如下图所示：

2、启动完成

启动完成后，手动刷新，则会出现完成后的情况。虚拟机状态为“running”。此时虚拟机资源可以开始被使用。

使用虚拟机资源

虚拟机资源创建完成后，虚拟机状态变为“running”。列表如下所示：

此时需要注入“用户名密码”以供用户访问。

在“注入用户名”后的输入框中输入用户名、密码，点击“注入用户名”后：

注意到，用户名/密码，已经展现了刚才所输入的信息。需注意：密码仅支持“大小写英文字母/数字/下划线”。

用户此时可以进行登录：

问题解决

一些公共的探求问题的方法：

●查看euca_func.conf，其中所配置的路径、命令、端口均配置正确。

?需要保证配置中的路径，均存在且可以被访问（保证为root权限）

?需要保证命令（python），可以被运行。

?需要保证端口与cloudclient.conf中所配置的一致。

●重启cloud-controller/cloud-node。使用cc-restart/nc-restart命令重启服务。

●使用df -h来查看是否有足够的硬盘空间

?sda1/sda2两块主分区空间需要预留4G以上

●查看日志

所有日志均放在/home/sinobpo-cloud/var/log/eucalyptus/中。

应该重点关注下述两个日志文件：

?Cloud-output.log

?Cloud-error.log

FAQ

一、Cloud-controller是否已经启动，并且正常运行？

●查看https://localhost:8443是否能够打开

●查看var/log/ sinobpo-cloud /cloud-output.log是否正常滚动

●查看var/log/ sinobpo-cloud /cc.log是否正常滚动

●使用系统内置命令查看，可以看到之前所配置的IP：

?/home/ sinobpo-cloud /usr/sbin/euca_conf --list-clusters

?/home/ sinobpo-cloud /usr/sbin/euca_conf --list-scs

?/home/ sinobpo-cloud /usr/sbin/euca_conf --list-walruses

?/home/ sinobpo-cloud /usr/sbin/euca_conf --list-nodes

二、Cloud-node是否正常运行，并且已经加入云平台？

●在WebUI中查看物理节点状态。

●查看var/log/ sinobpo-cloud /nc.log是否正常滚动。

●/home/ sinobpo-cloud /usr/sbin/euca_conf --list-nodes，是否可以把nc的ip列举出

来。

三、Eucalyptus重启后会丢失虚拟机信息么？

管理员可以自由重启sinobpo-cloud，已经创建的虚拟机不会受到任何影响。

四、创建虚拟机后始终处于pending状态，为什么？

●可能正在等待内核镜像文件拷贝。请耐心等待。

●请查看var/log/ sinobpo-cloud /nc.log查看是否有错误发生。

●可能由于资源不足（硬盘空间，IP地址资源），请注意检查每台机器的linux硬盘空

间，以及IP资源情况。

五、客户端通过ssh无法加入给定虚拟机，怎么办？

●虚拟机外部IP是否能够ping通？内部IP是否能够ping通？

●查看客户机的DNS和router设置情况。

客户机需要跟cloud-controller同网段。

附录