软件安装

1. 部署环境说明

部署csyun的物理机的硬件需求如下：

提示

上面是主流配置，如果只是简单试用，内存8GB也是可以的，硬盘不做过多要求，需要考虑的是上传镜像文件的大小和需要创建的虚拟机所要占用的空间。

部署csyun云平台的环境需要是独立的物理机，一套csyun可以管理多台物理机。通常是在其中一台物理机上部署csyun-server和csyun-agent的服务，其他的只需部署csyun-agnet即可。csyun-server和csyun-agent软件是都是安装在root用户下，也运行root用户下。
除前面快速入门-一键安装中使用一键安装脚本进行安装之外，我们还可以把安装包下载下来，手工一步一步的安装。

需要安装的安装包如下：

• X.Y.Z：版本号，如3.1.0;
• os：操作系统缩写名，如el7、el8；
• platform：cpu类型，如x86_64、aarch64。

注意

csyun的部署需要安装csumdb、csyun-server、csyun-agent三个部分，安装顺序不可颠倒。

要选择和自己操作系统对应的版本，本文所使用的操作系统为ubuntu22.04，所对应程序包为ubuntu2204的版本。

2. csumdb的安装

您可以在下面的中启乘数科技官方提供的地址下载相应的安装包：

根据服务器操作系统和平台类型下载对应csumdb：

wget https://csudata.oss-cn-hangzhou.aliyuncs.com/csumdb/csumdb1.1.2.ubuntu2204.x86_64.bin

我们将csyun产品的安装的大部分指令集成在了安装脚本中，执行bash指令便会实现自动安装：

bash csumdb1.1.2.ubuntu2204.x86_64.bin

上面的安装命令会自动创建一个csumdb的用户和组，用户的根目录为/home/csumdb

root@cssrv30:/opt/download# ll /home/
total 16
drwxr-xr-x  4 root   root   4096 Aug 26 05:41 ./
drwxr-xr-x 17 root   root   4096 Aug 26 05:38 ../
drwxr-x---  8 csumdb csumdb 4096 Aug 13 03:47 csumdb/
drwxr-x---  2 ubuntu ubuntu 4096 Jul 28 07:44 ubuntu/

切换到csumdb用户下

su - csumdb

启动数据库

pg_ctl start

数据库的启动过程如下：

csumdb@cssrv30:~$ pg_ctl start
waiting for server to start....2024-08-26 14:43:39.708 CST [2829] LOG:  starting PostgreSQL 12.16 on x86_64-pc-linux-gnu, compiled by gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0, 64-bit
2024-08-26 14:43:39.708 CST [2829] LOG:  listening on IPv4 address "0.0.0.0", port 3500
2024-08-26 14:43:39.708 CST [2829] LOG:  listening on IPv6 address "::", port 3500
2024-08-26 14:43:39.711 CST [2829] LOG:  listening on Unix socket "/tmp/.s.PGSQL.3500"
2024-08-26 14:43:39.723 CST [2829] LOG:  redirecting log output to logging collector process
2024-08-26 14:43:39.723 CST [2829] HINT:  Future log output will appear in directory "log".
 done
server started

3. csyun-server的安装

您可以在下面的中启乘数科技官方提供的地址下载相应的安装包：

以下操作需要在root用户下执行。

根据服务器操作系统和平台类型下载对应csyun-server：

wget https://csudata.oss-cn-hangzhou.aliyuncs.com/csyun/3.1.0/csyun-server3.1.0.ubuntu2204.x86_64.bin

执行安装命令：

bash csyun-server3.1.0.ubuntu2204.x86_64.bin

注意

必须要在root用户下进行安装，否则会报文件权限问题(Permission denied)，安装失败。

安装过程如下：

root@cssrv30:/opt/download# bash csyun-server3.1.0.ubuntu2204.x86_64.bin 
==== Installation is starting ...
Usage: /usr/bin/which [-a] args
==== Your ip is 10.197.160.30/20
your network is 10.197.160.0
your http port is 8090
==== register systemd service ...
Recognize this operating system is ubuntu2204.x86_64
Created symlink /etc/systemd/system/multi-user.target.wants/csyun-webvnc.service → /etc/systemd/system/csyun-webvnc.service.
register service csyun-webvnc sucessfully.
Created symlink /etc/systemd/system/multi-user.target.wants/csyun-server.service → /etc/systemd/system/csyun-server.service.
register service csyun-server sucessfully.
Created symlink /etc/systemd/system/multi-user.target.wants/csyun-dhcpd.service → /etc/systemd/system/csyun-dhcpd.service.
register service csyun-dhcpd sucessfully.
==== register systemd service ok.
==== Installation is complete.

安装完成后会自动拉起csyun-server服务，但对于Alpine(没有systemctl命令)或者无法注册systemd服务的，则需要通过手工启动服务：

/opt/csyun-server/bin/csyun-server start

如果有成功注册systemd服务，可以使用下面的命令查看csyun-server服务的状态：

systemctl status csyun-server

输出的结果如下：

root@cssrv30:/opt/download# systemctl status csyun-server
● csyun-server.service - csyun-server
     Loaded: loaded (/etc/systemd/system/csyun-server.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2024-08-26 14:44:59 CST; 1min 44s ago
    Process: 3030 ExecStartPre=/opt/csyun-server/bin/csyun-server stop (code=exited, status=0/SUCCESS)
    Process: 3048 ExecStart=/opt/csyun-server/bin/csyun-server start (code=exited, status=0/SUCCESS)
   Main PID: 3128 (csyun-server)
      Tasks: 18 (limit: 18792)
     Memory: 20.2M
        CPU: 1.665s
     CGroup: /system.slice/csyun-server.service
             └─3128 /opt/csyun-server/bin/csyun-server start
8月 26 14:44:58 cssrv30 csyun-server[3030]: csyun-server not running
8月 26 14:44:59 cssrv30 csyun-server[3048]: 2024-08-26 14:44:59,057 INFO csyun-server v3.1.0 Copyright (c) 2018-2023 CSUDATA.COM All rights reserved.
8月 26 14:44:59 cssrv30 csyun-server[3048]: 2024-08-26 14:44:59,058 INFO Start loading configuration ...
8月 26 14:44:59 cssrv30 csyun-server[3048]: 2024-08-26 14:44:59,091 INFO Complete configuration loading.
8月 26 14:44:59 cssrv30 csyun-server[3048]: 2024-08-26 14:44:59,094 INFO Recognize this operating system is ubuntu2204.x86_64
8月 26 14:44:59 cssrv30 csyun-server[3048]: 2024-08-26 14:44:59,570 WARNING Upgrade: Please run it manually: alter table csyun drop column zfs_id;
8月 26 14:44:59 cssrv30 csyun-server[3048]: 2024-08-26 14:44:59,570 WARNING Upgrade: Please run it manually: drop table csyun_zfs;
8月 26 14:44:59 cssrv30 csyun-server[3048]: 2024-08-26 14:44:59,570 WARNING Upgrade: Please run it manually: drop table csyun_zfs_need_destroy;
8月 26 14:44:59 cssrv30 csyun-server[3048]: 2024-08-26 14:44:59,570 WARNING Upgrade: Please run it manually: drop table csyun_vm_template_zfs;
8月 26 14:44:59 cssrv30 systemd[1]: Started csyun-server.

下面我们登录Web页面(http://IP:8090 用户名admin，密码cstech)查看，IP替换成安装csyun-server时选择的IP：

注意

当前先不要进行初始化操作，需要等安装完csyun-agent后再执行。

初始化操作目的是在安装了csyun-agent的机器上初始化存储池和网络。所以需要等安装完csyun-agent后才能执行。

4. csyun-agent的安装

您可以在下面的中启乘数科技官方提供的地址下载相应的安装包：

以下操作需要在root用户下执行。

根据服务器操作系统和平台类型下载对应csyun-agent：

wget https://csudata.oss-cn-hangzhou.aliyuncs.com/csyun/3.1.0/csyun-agent3.1.0.ubuntu2204.x86_64.bin

执行安装命令：

bash csyun-agent3.1.0.ubuntu2204.x86_64.bin

输入csyun-server的IP地址，在本例中csyun-server的IP地址为10.197.160.30，根据自己的情况填写服务端的IP地址

Enter csyun-server IP Addr: 10.197.160.30

安装完成后会自动拉起csyun-agent服务，但对于Alpine(没有systemctl命令)或者无法注册systemd服务的，则需要通过手工启动服务：

/opt/csyun-agent/bin/csyun-agent start

如果有成功注册systemd服务，可以使用下面的命令查看csyun-agent服务的状态：

systemctl status csyun-agent

看到状态为active时，说明服务已正常启动：

root@cssrv30:/opt/download# systemctl status csyun-agent
● csyun-agent.service - csyun-agent
     Loaded: loaded (/etc/systemd/system/csyun-agent.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2024-08-26 14:49:34 CST; 12min ago
    Process: 3634 ExecStartPre=/opt/csyun-agent/bin/csyun-agent stop (code=exited, status=0/SUCCESS)
    Process: 3656 ExecStart=/opt/csyun-agent/bin/csyun-agent start (code=exited, status=0/SUCCESS)
   Main PID: 3662 (csyun-agent)
      Tasks: 12 (limit: 18792)
     Memory: 16.8M
        CPU: 9.648s
     CGroup: /system.slice/csyun-agent.service
             └─3662 /opt/csyun-agent/bin/csyun-agent start
8月 26 14:49:34 cssrv30 systemd[1]: Starting csyun-agent...
8月 26 14:49:34 cssrv30 csyun-agent[3634]: csyun-agent not running
8月 26 14:49:34 cssrv30 csyun-agent[3656]: 2024-08-26 14:49:34,560 INFO csyun-agent v3.1.0 Copyright (c) 2018-2023 CSUDATA.COM All rights reserved.
8月 26 14:49:34 cssrv30 csyun-agent[3656]: 2024-08-26 14:49:34,561 INFO Start loading configuration ...
8月 26 14:49:34 cssrv30 csyun-agent[3656]: 2024-08-26 14:49:34,561 INFO Complete configuration loading.
8月 26 14:49:34 cssrv30 systemd[1]: Started csyun-agent.

5. csyun云平台初始化

未初始化的系统，登录Web页面时会弹出一个初始化的欢迎界面:

点下开始，进入到初始化虚拟机模板这一步骤：

再次点击下一步，进入初始化存储池这一步骤：

• 默认存储类型：可以选择文件目录或者ZFS，如果选择ZFS，则需要先在所有安装过csyun-agent的物理机上安装好zfs。
• 默认存储池路径：存储虚拟机文件的目录，默认值/vms，此目录如果不存在会自动创建。
• ISO存储池类型：可以选择文件目录或者ZFS，如果选择ZFS，则需要先在所有安装过csyun-agent的物理机上安装好zfs。
• ISO存储池路径：存储系统镜像文件的目录，默认值/isoimg，此目录如果不存在会自动创建。

再次点击下一步，进入初始化网络这一步骤：

在上图中进行网络的初始化配置。如果选择了初始化网络，则会将目前该csyun-server管理的所有csyun-agent机器都进行桥接网络的自动配置。如果您暂时不想初始化网络，也可以选择暂时跳过。下次登录时此界面会继续弹出来。

注意

初始化网络时会短暂断开网络，初始化成功就会恢复网络，如果初始化网络失败或者配置时间超过1分钟，则会恢复原网络配置，网络恢复。

完成初始化网络后的界面

完成网络的初始化后，整个初始化工作就完成了。