快速安装指引

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://nanos.cloud/files/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目录下进行覆盖。