文档与支持

Nano

API接口文档

常见问题

Nano能做什么？

Nano是虚拟化云平台，可以把你的物理服务器集群转换为计算资源池，并在之上动态分配管理云主机，有效提高IT设施的资源利用效率，节省管理成本。

Nano提供从资源监控、实例管理、镜像到快照等一系列便捷管理手段，提高运维人员的工作效率。Nano提供完整的API和纯HTML5的管理页面，你可以定制自己的云平台产品，或者集成到现有平台当中。

安装Nano有什么要求？

至少一台支持虚拟化的X86服务器或者打开嵌套虚拟化的虚拟机
2核4G内存50GB磁盘和一个网络设备
CentOS 7 Minimal
操作系统安装完成并且网络就绪

如何安装Nano？

详见快速开始，通常安装时间为三分钟左右

能否在虚拟机安装Nano？

理论上支持嵌套虚拟化的技术都可以使用，已测试虚拟化技术：

VMware Station，可以安装，需要打开CPU的嵌套虚拟化开关
VMware ESXi，可以安装，需要启用网络混杂模式
VirtualBox，不可安装

Nano安装过程中网络中断

Installer安装过程中，会构建桥接网络并且重启网络服务，对于常见的Dell系列服务器和VMware实例，该操作不会中断网络连接。但是确实有部分服务器可能因为网络驱动原因，会导致网络中断，这种情况请使用服务器的IPMI或者类似远程管理界面进行安装，而不要使用SSH。

Installer或者Cell启动时提示"no default route available"

Nano所在服务器必须配置好默认路由才能正常工作，如果模块检测不到默认路由，则需要手工配置再启动服务。
假设网络中默认网关为192.168.1.1，则在安装Nano的服务器上执行指令：

$ ip route add default via 192.168.1.1

Installer提示"firewalld service stopped/disabled"

Nano需要在防火墙设置允许组播协议后，才能正常工作，请打开firewalld服务并设置为开机启动状态。你也可以输入yes强制继续安装，但是安装完成的集群很可能无法正常工作。

Installer安装过程中无法找到宿主机的可用网卡

安装过程中，Installer会在宿主机目前网卡清单中，选择以‘em’开头、能够进行组播、单播并且处于up状态的活动网口。
如果没有找到可用网口，请检查是否名称不匹配、标志位异常或者尚未正常启动。

Core启动提示"query timeout"

Core内置了ImageServer模块，需要使用组播协议进行通讯，Installer安装时已经在Firewalld上配置了允许组播报文。但是已知部分用户关闭firewalld导致该规则不生效，而产生本报错对于这种场景请打开firewalld；使用iptables的用户如果有相同问题，请手动添加相应规则。

Cell启动提示"query timeout"

Cell模块启动时需要通过连接Core模块完成自我发现和组网，请检查Core模块是否启动。如果已经启动，请检查服务器网络配置和模块的通讯域配置信息是否一致

创建云主机时提示资源不足，比如：no cell has enough disk

Nano创建云主机时，会从指定资源池的各节点中根据请求的云主机配置和实时负载，选择最合适的节点部署云主机。
上述错误表示目前没有资源节点可以满足请求的要求，通常会有以下几种情况：

资源池中尚未添加资源节点。请添加节点后重新尝试
资源池中有可用节点，但是节点被禁用或者处于离线状态。请恢复节点后重新尝试
资源池中有资源节点，但是没有任何节点的可用资源满足创建要求（Nano会为操作系统正常运行保留部分资源）
节点资源充足，但是磁盘空间未正确分配给Nano。请检查仪表盘上的资源池可用磁盘容量，使用lvm为"/"路径增加磁盘空间或者修改cell节点的存储路径

从磁盘镜像克隆创建新云主机时，提示resize image fail

Nano克隆云主机时，会先将源磁盘镜像复制为新主机系统磁盘，然后调用qemu-img指令将磁盘大小调整为用户要求的系统磁盘尺寸。
如果新建云主机的系统磁盘容量小于磁盘镜像的原始大小，则可能出现该错误。
请尝试创建系统盘容量更大的云主机或者构建更小尺寸的磁盘镜像。

启动云主机或者使用镜像时，系统提示权限不足：Permission denied

Nano使用qemu启动云主机实例，如果qemu启动时使用的用户帐号没有权限访问云主机文件，则可能产生该报错。
该错误通常是由于用户在使用Installer安装Nano之前已经安装了qemu，qemu服务绑定了默认帐号，而Nano创建的磁盘文件通常是root用户，导致qemu用户无法访问。
可以检查“/etc/libvirt/qemu.conf”文件定位并修复该问题

Nano安装之后能否使用yum更新系统软件

可以
Nano使用go编译为独立的二进制程序，无特殊外部依赖要求，宿主机可以使用yum进行日常的更新维护。

Nano的服务能否配置成开机启动

可以
Nano所有模块均支持在任意位置调用，可以使用绝对路径配置在rc.local或者自行编写systemd服务实现开机启动。

升级0.9.1之后看不到原有云主机和镜像了

由于新版本只能查看自己拥有的云主机和镜像，请执行以下指令修改资源归属并重启服务，否则会无法看到自己的云主机和镜像资源。以当前用户为nano，用户组为admin为例

更新Core模块镜像归属
$sed -i 's/\"owner\": \"admin\"/\"owner\": \"nano\"/' /opt/nano/core/data/image.data
$sed -i 's/\"group\": \"manager\"/\"group\": \"admin\"/' /opt/nano/core/data/image.data

更新Cell模块云主机归属
$sed -i 's/\"user\": \"admin\"/\"user\": \"nano\"/' /opt/nano/cell/data/instance.data
$sed -i 's/\"group\": \"manager\"/\"group\": \"admin\"/' /opt/nano/cell/data/instance.data

社区支持

欢迎加入QQ群：Nano Cloud(819161083)，及时获取最新动态与技术支持

技术支持QQ群
(Nano Cloud 819161083)

API接口文档

常见问题

社区支持

资源链接

产品

开发资源

社区资源