快速安装指引

Nano 云平台的设计场景是在多服务器节点集群中工作，但是也可以将所有模块部署在同一个服务器或者虚拟机，实现 All In One 的最小验证部署，然后逐步扩容到更大集群。

Nano 平台提供了 Installer 安装程序用于自动化部署，最新版本 Installer 可以通过 官网下载 或者 Github 发布页面 获取。

Installer 会自行选择最合适的配置进行建议， 对于初次安装 Nano 的新用户，安装过程中尽量不要调整任何参数，也不要使用地址池或者存储池 ，如需调整参数、修改配置或者直接升级二进制文件，请在熟悉产品后进行操作。

请安装前务必阅读 常见问题 和 快速入门手册，熟悉相关概念和流程再进行操作

服务器要求

• 至少一台支持虚拟化的 X86 服务器或者打开嵌套虚拟化（Intel VT-x/AMD-v）的虚拟机
• 2 核 4G 内存 50GB 磁盘和一个网络设备
• 操作系统使用 CentOS 7 Minimal 并且网络能够正常通讯，如有 Raid/LVM 请先完成配置，再进行 Nano 安装

安装前必读 <非常重要>

• 尽量使用 Dell iDrac 或者 IPMI 远程管理协议安装 Nano，不要使用 SSH，因为安装过程中会重新配置宿主机网络，某些设备网卡会中断连接导致安装失败
• 不要禁用或者停止 Firewalld 和 Selinux 服务，Nano 模块会配置防火墙规则和镜像文件存储规则，服务停止会导致模块之间网络访问异常或者文件权限异常
• 默认情况下"/var/lib/libvirt/images"路径存储云主机磁盘文件，"/opt/nano/core/data"存储系统镜像文件，所以 Nano 默认使用路径/下磁盘空间进行分配，安装前请确保给/路径分配足够的磁盘空间。
• Installer 选择网卡时，仅选择名称为"em"开头、支持组播且处于 up 状态的网卡，开始安装前请提前检查，以免查找不到网络设备
• 避免在安装 Nano 前安装 qemu 服务，否则可能会因为预装 qemu 绑定用户不同，导致启动实例失败
• 确保 yum 源可用，installer 安装过程中如果本地离线 rpm 不可用时，会转为 yum 在线安装
• 平台安装成功后，先向默认资源池 default 添加一个资源节点后创建一个空白云主机并且启动，验证安装是否正常，正常后再尝试其他功能。
• 地址池和存储池是面向熟手的功能，一旦出现问题，排查非常复杂，不建议初期使用。

全新安装

第一步. 下载并安装所有模块

$wget https://pan.miku.video/f/W7MUQ/nano_installer_1.3.1.tar.gz
$tar zxfv nano_installer_1.3.1.tar.gz
$cd nano_installer
$./installer

输入"0,1,2"或者"3"在当前服务器安装所有模块. 当您第一次安装 Nano 时，建议您使用安装程序建议的默认配置，无需修改。 如果你有多个网卡设备，请在安装程序的提示中选择连接内网的网卡设备进行安装。

配置详情可参考 快速入门手册

第二步. 启动所有服务

模块安装完成后，需要启动模块以提供服务，模块默认安装在/opt/nano 目录下。使用命令手动启动所有模块（假定所有模块安装在同一台服务器）， 请注意，必须首先启动 Core 模块 。

$cd /opt/nano/core
$./core start
$cd ../cell
$./cell start
$ cd ../frontend
$./frontend start

当 front-end 模块成功启动后，会提示一个形如"192.168.6.3:5870"的监听地址，使用 Chrome 或者 Firefox 打开这个地址就可以进行平台管理了。

第三步. 使用 Web 门户管理平台

在浏览器中首次打开 Nano 管理页面，会提示创建一个初始管理员，成功后就可以登录平台。

登录系统之后，首先在计算资源池里添加一个资源节点，然后创建一个空白云主机并且启动，验证系统是否安装成功。如果成功就可以开始探索 Nano 提供的各种丰富功能了。

你也可以上传或者构建新的光盘镜像或者磁盘镜像，用于快速批量部署实例。其他详细配置选项请参考配置手册

升级安装

Nano 所有模块使用 go 编译为二进制可执行文件，无需外部库依赖，配置和数据文件格式通常保持后向兼容，无需用户干预。

Nano 能够通过两种方式进行升级，启动 Installer 并且选择”4”可以进行自动升级，自动升级会根据用户输入的安装路径，检查已经安装模块进行替换，并且自动停止并重启运行中的模块，是推荐的升级方式。

当自动升级方式出现问题时，可以选择手动升级，只需要使用”./模块名 stop”停止运行中的模块文件，替换可执行文件后使用”./模块名 start”重新启动服务即可。

唯一例外是 FrontEnd 模块还包含前端页面文件，所以升级时，除了要替换可执行文件，还需要手工将页面和 js 脚本文件从发布包中复制 resource 目录下进行覆盖。