
KubeSphere 虚拟化（KSV）是由 KubeSphere 衍生的轻量化虚拟机管理平台，支持单节点部署和多节点部署，便捷易用，满足企业级虚拟化业务需求。

KSV 基于 K3s，相较于传统虚拟化架构，KSV 更轻量、更灵活。借助 K3s 底层框架，KSV 可以实现服务自愈、快速弹性伸缩、灵活调度等能力。

## 虚拟化技术

虚拟化技术可以从有限的硬件资源中划分出多个相对独立的环境供多个用户或多个业务应用使用。

虚拟机是利用虚拟化技术整合 CPU、内存、网络、存储等物理硬件资源从而创建出的虚拟计算机系统。每台虚拟机内部都模拟了整套硬件环境。不同的虚拟机之间通过软件实现资源隔离。

虚拟化技术可以通过对硬件资源进行整合提高硬件资源的利用率。在传统的应用部署模式下，每台主机上只部署一个应用以避免资源抢占。通常单个应用并不会消耗主机提供的所有资源，从而系统中存在许多闲置资源。通过采用虚拟化技术，多台主机的硬件资源可以组成一个较大的资源池，应用运行在资源池划分出的虚拟机中。管理员根据应用的实际需求为虚拟机分配硬件资源并对资源进行动态调整，从而提高系统的硬件资源利用率。

## KSV 功能特性

作为企业级虚拟化平台，KSV 提供简单易用的 Web 控制台，帮助用户快速实现企业硬件资源的虚拟化。

KSV 目前提供以下功能特性：

* **系统资源概览**：提供系统设备状态、资源使用情况、物理吞吐等概览信息，帮助用户快速获取系统资源的实时状态。
* **节点管理**：提供集群节点的汇总列表及每个节点资源使用情况、虚拟机状态、健康状态、网络状态等详情信息。
* **IP 池管理**：提供 IP 池汇总列表及各 IP 池的详情，支持创建和删除 IP 池以及编辑 IP 池信息。
* **虚拟机管理**：提供虚拟机汇总列表和各虚拟机的详情，支持创建和删除虚拟机、编辑虚拟机信息、远程连接虚拟机、暴露虚拟机服务、挂载和卸载磁盘、创建和删除虚拟机快照、编辑快照信息、从快照还原虚拟机以及查看和删除虚拟机还原记录。
* **镜像管理**：提供镜像汇总列表和各镜像的详情，支持创建和删除镜像、编辑镜像信息、共享镜像和取消镜像共享。
* **磁盘管理**：提供磁盘汇总列表和各磁盘的详情，支持创建和删除磁盘、编辑磁盘信息、查看磁盘所属的虚拟机、对磁盘进行扩容、创建和删除磁盘快照、编辑快照信息、从快照还原磁盘以及查看和删除磁盘还原记录。
* **告警管理**：提供告警信息汇总列表、告警策略汇总列表和各告警策略的详情，支持创建、编辑以及删除告警策略。
* **日志管理**：提供系统日志汇总列表、各系统日志的详情、操作日志汇总列表和各操作日志的详情，并支持查看实时系统日志和导出系统日志文件到本地。
* **项目管理**：提供项目汇总列表和各项目的详情，支持创建和删除项目、编辑项目信息、邀请和移除项目成员以及修改项目成员角色。
* **用户管理**：提供用户汇总列表和各用户的详情，支持创建和删除用户、编辑用户信息以及修改用户密码。
* **KSV 助手**：提供资源操作进度和可选功能的下载链接，支持查看添加节点和创建镜像的操作进度。

## KSV 业务场景

KSV 具备轻量、灵活、易交付等特点。作为企业级虚拟化平台，KSV 可支撑个人用户、小微企业和大型企业的多种虚拟化业务需求。

* 个人用户可使用 KSV 在家庭或工作 PC 中搭建虚拟机环境，用于开发、测试和学习。

* 小微型企业可使用 KSV 搭建虚拟环境，以极低的学习成本和资金成本快速实现企业业务的数字化和自动化。

* 大型企业可将 KSV 应用于大规模边缘设备系统或物联网系统，结合 AI 算法及应用，实现数据就近处理和超低时延。

## 技术支持

KSV 目前处于生产可用阶段。您可以将有关问题提交到 [KubeSphere 开发者社区](https://kubesphere.com.cn/forum/t/virtualization)。

介绍 KSV 的功能特性和优势应用场景。

KubeSphere 虚拟化介绍

本节介绍如何在单节点模式下安装、升级、卸载 KubeSphere 虚拟化（KSV）以及如何在集群中添加节点。

KSV 目前支持以下安装模式：

- 单节点模式：安装在单个服务器节点上，适用于测试环境。
- 多节点模式：安装在多个服务器节点上，适用于生产环境。有关多节点模式，请参阅[多节点模式安装和升级](../install-ksv-in-multi-node-mode/)。

## 前提条件

- 服务器节点的操作系统需要为 Linux 操作系统，Linux 内核版本必须在 4 以上。建议使用 Ubuntu 18.04、Ubuntu 20.04、CentOS 7.9、CentOS 8.5、统信 UOS、银河麒麟 V10 或华为 EulerOS。其他操作系统尚未充分测试，可能存在未知问题。未来将支持更多操作系统。

  检查操作系统版本：

  ```bash
  cat /etc/issue
  ```

- 服务器节点的硬件配置必须满足以下条件：

  <table>
    <tbody>
      <tr>
      	<th>硬件</th>
       	<th>最低配置</th>
        <th>推荐配置</th>
      </tr>
      <tr>
        <td>CPU</td>
        <td>4 核</td>
        <td>8 核</td>
      </tr>
      <tr>
        <td>内存</td>
        <td>8 GB</td>
        <td>16 GB</td>
      </tr>
      <tr>
        <td>系统磁盘</td>
        <td>100 GB</td>
        <td>100 GB</td>
      </tr>
    </tbody>
  </table>

  检查 CPU 核心数（两行命令回显结果相乘为服务器节点 CPU 核心总数）：

  ```bash
  cat /proc/cpuinfo | grep "physical id" | sort | uniq | wc -l
  ```

  ```bash
  cat /proc/cpuinfo | grep "cpu cores" | uniq
  ```

  检查内存大小：

  ```bash
  cat /proc/meminfo | grep MemTotal
  ```

  检查可用磁盘大小：

  ```bash
  df -hl
  ```

- 服务器节点必须至少具有 1 个未格式化且未分区的磁盘，或 1 个未格式化的分区。该磁盘或分区的最低配置为 100 GB，推荐配置为 200 GB。

  检查服务器节点磁盘分区：

  ```bash
  lsblk -f
  ```

  例如，以下回显表明 vdb 磁盘为满足条件的设备：
  ```bash
NAME                  FSTYPE      LABEL UUID                                   MOUNTPOINT
vda
└─vda1                LVM2_member       >eSO50t-GkUV-YKTH-WsGq-hNJY-eKNf-3i07IB
 ├─ubuntu--vg-root    ext4              c2366f76-6e21-4f10-a8f3-6776212e2fe4   /
 └─ubuntu--vg-swap_1  swap              9492a3dc-ad75-47cd-9596-678e8cf17ff9   [SWAP]
vdb
  ```

- 服务器节点需要支持虚拟化。如果服务器节点不支持虚拟化，KSV 将以模拟模式运行。该模式将占用更多资源，且可能影响性能。

  检查服务器节点是否支持虚拟化（若无回显则不支持虚拟化）：

  ```bash
  grep -E '(svm|vmx)' /proc/cpuinfo
  ```

## 安装 KSV

1. 以 `root` 用户登录服务器节点。

2. 执行以下命令检查节点服务器的架构：

   ```bash
   uname -m
   ```

2. 根据节点服务器的架构类型下载安装包。

   - x86 架构
   
     执行以下命令下载安装包（安装包大小约 4.5 GB）：
   
     ```bash
     curl -OL https://virtualization.kubesphere.cloud/v1.5.0/kubesphere-virtualization-x86_64-v1.5.0.tar.gz
     ```
   
     执行以下命令解压安装包：
   
     ```bash
     tar -zxvf kubesphere-virtualization-x86_64-v1.5.0.tar.gz
     ```
   
     执行以下命令进入安装包解压后生成的目录：
   
     ```bash
     cd kubesphere-virtualization-x86_64
     ```
   
   - ARM64 架构
   
     执行以下命令下载安装包（安装包大小约 4.2 GB）：
     
     ```bash
     curl -OL https://virtualization.kubesphere.cloud/v1.5.0/kubesphere-virtualization-arm64-v1.5.0.tar.gz
     ```
     
     执行以下命令解压安装包：
     
     ```bash
     tar -zxvf kubesphere-virtualization-arm64-v1.5.0.tar.gz
     ```
     
     执行以下命令进入安装包解压后生成的目录：
     
     ```bash
     cd kubesphere-virtualization-arm64
     ```
   
5. 执行以下命令开始安装：

   ```bash
    ./install.sh -a --ratio <超卖比>
   ```

  <Notice type='note'>

    - `--ratio` 参数为可选参数，用于指定 KSV 集群的超卖比，取值为 1 至 10 的整数。如果未设置 `--ratio` 参数，超卖比默认值为 `2`。
    - 超卖比将决定 KSV 可创建虚拟机的总数。可创建虚拟机的总数 = 集群 CPU 核心总数 x 超卖比。
    - 只有新安装 KSV 时可以设置超卖比，升级 KSV 时不支持修改超卖比。
    - 安装可能需要较长时间，请等待安装完成。

  </Notice>

   如果显示如下信息则安装成功：

   ```bash
   #####################################################
   ###     Welcome to KubeSphere Virtualization!     ###
   #####################################################

   Console: http://172.16.0.59:30880
   Username: admin
   Password: P@88w0rd

   NOTE：
   Please change the default password of the admin user
   after login.

   #####################################################
   https://kubesphere.cloud/ksv/     2021-04-29 14:03:45
   #####################################################
   ```

6. 从安装成功回显中的 `Console`、`Username` 和 `Password` 参数分别获取 KSV Web 控制台的地址、系统管理员用户名和系统管理员密码。

   <Notice type='note'>

   KSV Web 控制台提供以下默认用户：

   - 系统管理员：用户名 `admin`，密码 `P@88w0rd`。
   - `default` 项目管理员：用户名 `project-default-admin`，密码 `123456`。
   - `default` 项目操作员：用户名 `project-default-operator`，密码 `123456`。

   </Notice>

7. （可选）安装结束后，执行以下命令查看安装日志：

   ```bash
   ksv logs
   ```

## 添加节点

- 使用 KSV Web 控制台添加节点

  1. 以系统 `admin` 用户登录 KSV Web 控制台。

  2. 在页面顶部的菜单栏中点击**节点**以打开节点列表页。

  3. 在节点列表页面点击**添加**。在**添加节点**页面，为即将添加的节点设置以下参数：

     <table border='1'>
       <tbody>
         <tr>
         <th width='150'>参数</th>
         <th>描述</th>
         </tr>
         <tr>
         <td>名称</td>
         <td>用户自定义的节点名称。名称只能包含小写字母、数字和连字符（-），必须以小写字母或数字开头和结尾，最长 16 个字符。如果同时添加多个节点，系统将自动在不同节点的名称后增加序列号。</td>
         </tr>
         <tr>
         <td>内部 IP 地址</td>
         <td>集群内各节点可访问的内部 IP 地址。您需要手动输入每个节点的 IP 地址。在<b>内部 IP 地址</b>右侧点击 <img src ="/images/docs/ksv/management/nodes/add-ip-address.png" width='20'/>/<img src ="/images/docs/ksv/management/nodes/delete-ip-address.png" width='20' align='center'/> 可增加/减少待添加的节点的数量。</td>
         </tr>
         <tr>
         <td>数量</td>
         <td>需要添加的节点的数量。目前支持同时添加最多 50 个节点。</td>
         </tr>
         <tr>
         <td>SSH 认证方式</td>
           <td>节点的 SSH 认证方式。<br/><ul><li><b>用户名和密码</b>：使用用户名和密码登录服务器节点。</li></ul><ul><li><b>SSH 密钥</b>：使用 SSH 密钥登录服务器节点。</li></ul></td>
         </tr>
         <tr>
           <td>端口</td>
           <td>用于 SSH 登录节点的端口号。</td>
         </tr>
       </tbody>
     </table>

    <Notice type='note'>

    添加多个节点并选择使用 SSH 密钥登录时，您需要预先为所有待添加的节点设置相同的 SSH 密钥。

    </Notice>

  4. 点击**确定**。节点添加完成后将显示在节点列表中。

    <Notice type='note'>

    在页面右下角的 **KSV 助手**中，点击**操作进度**并选择**节点**可查看待添加的节点的进度。

    </Notice>

  5. 如需在环境满足要求后开启高可用，您需要以 `root` 用户登录服务器节点，进入安装包解压后生成的目录，并执行以下命令：

     ```bash
     ksv set-ceph-ha
     ```

     如果显示如下信息则高可用开启成功：

     ```bash
     set pool 2 size to 3
     ```
      <Notice type='note'>

      - 目前，KSV 只支持添加节点，不支持删除节点。
      - 单节点模式下，KSV 支持使用控制台添加最多 2 个节点。如需使用控制台添加更多节点，则需要购买商业版许可证。有关更多信息，请参阅[软件许可证](../../license)。

    </Notice>

- 使用终端添加节点

  1. 以 `root` 用户登录服务器节点。

  2. 进入安装包解压后生成的目录。

  3. 执行以下命令编辑 `config-sample.yaml` 文件并在 `hosts` 和 `roleGroups` 参数下配置新增的节点信息：

     ```bash
     vi config-sample.yaml
     ```

     <Notice type='note'>

     有关参数配置，请参阅[多节点模式安装 KSV](../install-ksv-in-multi-node-mode/#安装-ksv)。

     </Notice>

  4. 执行以下命令开始添加节点：

     ```bash
     ./add-nodes.sh
     ```

     如果显示如下信息则节点添加成功：

     ```bash
     Congratulations! Scaling cluster is successful.
     ```
  
  5. 如需在环境满足要求后开启高可用，您需要执行以下命令：
  
     ```bash
     ksv set-ceph-ha
     ```
  
     如果显示如下信息则高可用开启成功：
  
     ```
     set pool 2 size to 3
     ```

## 升级 KSV

如果系统中已安装旧版本的 KSV，可执行以下步骤升级 KSV 版本。

1. 执行[安装 KSV](#安装-ksv) 步骤 1 至步骤 4。

2. 执行以下命令升级 KSV：

   ```bash
   ./upgrade.sh
   ```

3. 执行以下命令开启 KSV Web 控制台添加节点功能：
  ```bash
  ksv upload-config {old package dir}
  ```
  <Notice type='note'>

  在 KSV Web 控制台添加节点是 KSV v1.1.0 版本的新增功能。如需从 KSV v1.1.0 之前的版本升级，则需要执行以上命令才能在 Web 控制台开启该功能。

  </Notice>

4. 升级完成后执行以下命令查看日志：

   ```bash
   ksv logs
   ```

   如果显示如下信息则升级成功：

   ```bash
   #####################################################
   ###     Welcome to KubeSphere Virtualization!     ###
   #####################################################
   
   Console: http://172.16.0.59:30880
   Username: admin
   Password: P@88w0rd
   
   NOTE：
   Please change the default password of the admin user
   after login.
   
   #####################################################
   https://kubesphere.cloud/ksv/     2021-04-29 14:03:45
   #####################################################
   ```

## 卸载 KSV

1. 以 `root` 用户登录服务器节点。

2. 进入安装包解压后生成的目录。

3. 执行以下命令开始卸载：

   ```bash
   ./uninstall.sh -a
   ```

   如果显示如下信息则卸载成功：

   ```bash
   INFO[14:25:16 CST] Successful.
   ```

   <Notice type='note'>

   如卸载持续时间超过 15 分钟，您可以尝试重启机器再卸载 KSV。

   </Notice>

介绍如何在单节点模式下安装、升级、卸载 KSV 以及如何在集群中添加节点。

单节点模式安装和升级

本节介绍如何在多节点模式下安装、升级、卸载 KubeSphere 虚拟化（KSV）以及如何在集群中添加节点。

KSV 目前支持以下安装模式：

* 单节点模式：安装在单个服务器节点上，适用于测试环境。有关单节点模式，请参阅[单节点模式安装和升级](../install-ksv-in-single-node-mode/)。
* 多节点模式：安装在多个服务器节点上，适用于生产环境。

## 前提条件

* 多节点模式需要至少 3 个服务器节点。

* 服务器节点的操作系统需要为 Linux 操作系统，Linux 内核版本必须在 4 以上。建议使用 Ubuntu 18.04、Ubuntu 20.04、CentOS 7.9、CentOS 8.5、统信 UOS、银河麒麟 V10 或华为 EulerOS。其他操作系统尚未充分测试，可能存在未知问题。未来将支持更多操作系统。

  检查操作系统版本：

  ```bash
  cat /etc/issue
  ```

* 每个服务器节点的硬件配置都必须满足以下条件：

  <table>
    <tbody>
      <tr>
      	<th>硬件</th>
       	<th>最低配置</th>
        <th>推荐配置</th>
      </tr>
      <tr>
        <td>CPU</td>
        <td>4 核</td>
        <td>8 核</td>
      </tr>
      <tr>
        <td>内存</td>
        <td>8 GB</td>
        <td>16 GB</td>
      </tr>
      <tr>
        <td>系统磁盘</td>
        <td>100 GB</td>
        <td>100 GB</td>
      </tr>
    </tbody>
  </table>

  检查 CPU 核心数（两行命令回显结果相乘为服务器节点 CPU 核心总数）：

  ```bash
  cat /proc/cpuinfo | grep "physical id" | sort | uniq | wc -l
  ```

  ```bash
  cat /proc/cpuinfo | grep "cpu cores" | uniq
  ```

  检查内存大小：

  ```bash
  cat /proc/meminfo | grep MemTotal
  ```

  检查可用磁盘大小：

  ```bash
  df -hl
  ```

* 多节点模式下必须确保至少 3 个服务器节点用作工作节点（控制节点同时也可以为工作节点）。每个工作节点都必须至少具有 1 个未格式化且未分区的磁盘，或 1 个未格式化的分区。该磁盘或分区的最低配置为 100 GB，推荐配置为 200 GB。

  检查工作节点磁盘分区：

  ```bash
  lsblk -f
  ```

  例如，以下回显表明 vdb 磁盘为满足条件的设备：

  ```bash
  NAME                  FSTYPE      LABEL UUID                                   MOUNTPOINT
  vda
  └─vda1                LVM2_member       >eSO50t-GkUV-YKTH-WsGq-hNJY-eKNf-3i07IB
   ├─ubuntu--vg-root    ext4              c2366f76-6e21-4f10-a8f3-6776212e2fe4   /
   └─ubuntu--vg-swap_1  swap              9492a3dc-ad75-47cd-9596-678e8cf17ff9   [SWAP]
  vdb
  ```

* 所有服务器节点都需要支持虚拟化。如果存在不支持虚拟化的服务器节点，KSV 将以模拟模式运行。该模式将占用更多资源，且可能影响性能。

  检查服务器节点是否支持虚拟化（若无回显则不支持虚拟化）：

  ```bash
  grep -E '(svm|vmx)' /proc/cpuinfo
  ```

* 所有服务器节点的时间必须同步。

## 安装 KSV

1. 以 `root` 用户登录任意服务器节点。

2. 执行以下命令检查节点服务器的架构：

   ```bash
   uname -m
   ```

3. 根据节点服务器的架构类型下载安装包。

   - x86 架构

     执行以下命令下载安装包（安装包大小约 4.5 GB）：

     ```bash
     curl -OL https://virtualization.kubesphere.cloud/v1.5.0/kubesphere-virtualization-x86_64-v1.5.0.tar.gz
     ```

     执行以下命令解压安装包：

     ```bash
     tar -zxvf kubesphere-virtualization-x86_64-v1.5.0.tar.gz
     ```

     执行以下命令进入安装包解压后生成的目录：

     ```bash
     cd kubesphere-virtualization-x86_64
     ```

   - ARM64 架构

     执行以下命令下载安装包（安装包大小约 4.2 GB）：
     
     ```bash
     curl -OL https://virtualization.kubesphere.cloud/v1.5.0/kubesphere-virtualization-arm64-v1.5.0.tar.gz
     ```
     
     执行以下命令解压安装包：
     
     ```bash
     tar -zxvf kubesphere-virtualization-arm64-v1.5.0.tar.gz
     ```
     
     执行以下命令进入安装包解压后生成的目录：
     
     ```bash
     cd kubesphere-virtualization-arm64
     ```

5. 执行以下命令编辑 `config-sample.yaml` 文件并在 `hosts` 和 `roleGroups` 参数下配置节点信息：

   ```bash
   vi config-sample.yaml
   ```

   以下为示例配置：

   ```yaml
      hosts:
      - {name: node1, address: 172.16.0.2, internalAddress: 172.16.0.2, port: 8022, user: ubuntu, password: Qcloud@123}
      - {name: node2, address: 172.16.0.3, internalAddress: 172.16.0.3, password: Qcloud@123}
      - {name: node3, address: 172.16.0.4, internalAddress: 172.16.0.4, privateKeyPath: "~/.ssh/id_rsa"}
      roleGroups:
        etcd:
        - node1
        controlPlane:
        - node1
        - node[2:3]
        worker:
        - node1
        - node[2:3]
   ```

   相关参数描述如下：

   <table border="1">
   <tbody>
   <tr>
     <th width='150'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <th colSpan='2'>hosts</th>
   </tr>
   <tr>
     <td>name</td>
     <td>节点名称。</td>
   </tr>
   <tr>
     <td>address</td>
     <td>节点的 SSH 登录 IP 地址。</td>
   </tr>
   <tr>
     <td>internalAddress</td>
     <td>节点在子网内部的 IP 地址。</td>
   </tr>
   <tr>
     <td>port</td>
     <td>节点的 SSH 端口号。如果使用默认端口 22 可不设置此参数。</td>
   </tr>
   <tr>
     <td>user</td>
     <td>节点的 SSH 登录用户名，该用户必须为 <code>root</code> 用户或其他具有 <code>sudo</code> 命令执行权限的用户。如果使用 <code>root</code> 用户可不设置此参数。</td>
   </tr>
   <tr>
     <td>password</td>
     <td>节点的 SSH 登录密码。如果已经设置 <code>privateKeyPath</code> 可不设置此参数。</td>
   </tr>
   <tr>
     <td>privateKeyPath</td>
     <td>节点的 SSH 登录密钥的路径。如果已经设置 <code>password</code> 可不设置此参数。</td>
   </tr>
   <tr>
     <th colSpan='2'>roleGroups</th>
   </tr>
   <tr>
     <td>etcd</td>
     <td>安装 etcd 数据库的节点，一般设置为集群控制节点。</td>
   </tr>
   <tr>
     <td>controlPlane</td>
     <td>集群控制节点。集群中可设置多个控制节点。</td>
   </tr>
   <tr>
     <td>worker</td>
     <td>集群工作节点。工作节点上可以创建虚拟机。多节点模式下集群中必须至少有 3 个工作节点，控制节点同时也可以是工作节点。</td>
   </tr>
   </tbody>
   </table>

6. 执行以下命令开始安装：

   ```bash
   ./install.sh -m --ratio <超卖比>
   ```

   <Notice type='note'>

   * `--ratio` 参数为可选参数，用于指定 KSV 集群的超卖比，取值为 1 至 10 的整数。如果未设置 `--ratio` 参数，超卖比默认值为 `2`。
   * 超卖比将决定 KSV 可创建虚拟机的总数。可创建虚拟机的总数 = 集群 CPU 核心总数 x 超卖比。
   * 只有新安装 KSV 时可以设置超卖比，升级 KSV 时不支持修改超卖比。
   * 安装可能需要较长时间，请等待安装完成。
   
   </Notice>
   
   如果显示如下信息则安装成功：
   
   ```yaml
   #####################################################
   ###     Welcome to KubeSphere Virtualization!     ###
   #####################################################
   
   Console: http://172.16.0.59:30880
   Username: admin
   Password: P@88w0rd
   
   NOTE：
   Please change the default password of the admin user 
   after login.
   
   #####################################################
   https://kubesphere.cloud/ksv/     2021-04-29 14:03:45
   #####################################################
   ```

7. 从安装成功回显中的 `Console`、`Username` 和 `Password` 参数分别获取 KSV Web 控制台的地址、系统管理员用户名和系统管理员密码。

   <Notice type='note'>

   KSV Web 控制台提供以下默认用户：

   * 系统管理员：用户名 `admin`，密码 `P@88w0rd`。
   * `default` 项目管理员：用户名 `project-default-admin`，密码 `123456`。
   * `default` 项目操作员：用户名 `project-default-operator`，密码 `123456`。

   </Notice>

8. （可选）安装结束后，执行以下命令查看安装日志：

   ```bash
   ksv logs
   ```

## 添加节点

- 使用 KSV Web 控制台添加节点

  1. 以系统 `admin` 用户登录 KSV Web 控制台。

  2. 在页面顶部的菜单栏中点击**节点**以打开节点列表页。

  3. 在节点列表页面点击**添加**。在**添加节点**页面，为即将添加的节点设置以下参数：

     <table border='1'>
       <tbody>
         <tr>
         <th width='150'>参数</th>
         <th>描述</th>
         </tr>
         <tr>
         <td>名称</td>
         <td>用户自定义的节点名称。名称只能包含小写字母、数字和连字符（-），必须以小写字母或数字开头和结尾，最长 16 个字符。如果同时添加多个节点，系统将自动在不同节点的名称后增加序列号。</td>
         </tr>
         <tr>
         <td>内部 IP 地址</td>
         <td>集群内各节点可访问的内部 IP 地址。您需要手动输入每个节点的 IP 地址。在<b>内部 IP 地址</b>右侧点击 <img src ="/images/docs/ksv/management/nodes/add-ip-address.png" width='25'/>/<img src ="/images/docs/ksv/management/nodes/delete-ip-address.png" width='25' align='center'/> 可增加/减少待添加的节点的数量。</td>
         </tr>
         <tr>
         <td>数量</td>
         <td>需要添加的节点的数量。目前支持同时添加最多 50 个节点。</td>
         </tr>
         <tr>
         <td>SSH 认证方式</td>
           <td>节点的 SSH 认证方式。<br/><ul><li><b>用户名和密码</b>：使用用户名和密码登录服务器节点。</li></ul><ul><li><b>SSH 密钥</b>：使用 SSH 密钥登录服务器节点。</li></ul></td>
         </tr>
         <tr>
           <td>端口</td>
           <td>用于 SSH 登录节点的端口号。</td>
         </tr>
       </tbody>
     </table>

    <Notice type='note'>

    添加多个节点并选择使用 SSH 密钥登录时，您需要预先为所有待添加的节点设置相同的 SSH 密钥。

    </Notice>

  4. 点击**确定**。节点添加完成后将显示在节点列表中。

     <Notice type='note'>

     - 在页面右下角的 **KSV 助手**中，点击**操作进度**并选择**节点**可查看待添加的节点的进度。
     - 目前，KSV 只支持添加节点，不支持删除节点。
     - 您需要购买商业版许可证才能在 Web 控制台添加节点。有关更多信息，请参阅[软件许可证](../../license)。

     </Notice>

- 使用终端添加节点

  1. 以 `root` 用户登录服务器节点。

  2. 进入安装包解压后生成的目录。

  3. 执行以下命令编辑 `config-sample.yaml` 文件并在 `hosts` 和 `roleGroups` 参数下配置新增的节点信息：

     ```bash
     vi config-sample.yaml
     ```

     <Notice type='note'>

     有关参数配置请参阅[安装 KSV](#安装-ksv)。

     </Notice>

  4. 执行以下命令开始添加节点：

     ```bash
     ./add-nodes.sh
     ```

     如果显示如下信息则节点添加成功：

     ```bash
     Congratulations! Scaling cluster is successful.
     ```

## 升级 KSV

如果系统中已安装过旧版本的 KSV，可执行以下步骤升级 KSV 版本。

1. 登录安装 KSV 时所使用的服务器节点。

2. 执行[安装 KSV](#安装-ksv) 步骤 2 至步骤 4。

3. 执行以下命令升级 KSV：

   ```bash
   ./upgrade.sh
   ```

4. 执行以下命令开启 KSV Web 控制台添加节点功能：
  ```bash
  ksv upload-config {old package dir}
  ```
  <Notice type='note'>

  在 KSV Web 控制台添加节点是 v1.1.0 版本的新增功能。如需从 KSV v1.1.0 之前的版本升级，则需要执行以上命令才能在 Web 控制台开启该功能。

  </Notice>

5. 升级完成后执行以下命令查看安装日志：

   ```bash
   ksv logs
   ```

   如果显示如下信息则升级成功：

   ```bash
   #####################################################
   ###     Welcome to KubeSphere Virtualization!     ###
   #####################################################
   
   Console: http://172.16.0.59:30880
   Username: admin
   Password: P@88w0rd
   
   NOTE：
   Please change the default password of the admin user 
   after login.
   
   #####################################################
   https://kubesphere.cloud/ksv/     2021-04-29 14:03:45
   #####################################################
   ```

## 卸载 KSV

1. 以 `root` 用户登录保存安装包的服务器节点。

2. 进入安装包解压后生成的目录。

3. 执行以下命令开始卸载：

   ```bash
   ./uninstall.sh -m
   ```

   如果显示如下信息则卸载成功：

   ```bash
   INFO[14:25:16 CST] Successful. 
   ```

  <Notice type='note'>

  如卸载持续时间超过 15 分钟，您可以尝试重启机器再卸载 KSV。

  </Notice>

介绍如何在多节点模式下安装、升级、卸载 KSV 以及如何在集群中添加节点。

多节点模式安装和升级

介绍如何安装、升级、卸载 KSV 以及如何在集群中添加节点。

安装指南


本节介绍如何登录 KubeSphere 虚拟化（KSV）Web 控制台以及 Web 控制台的功能模块、功能页面和常见图标。

## 登录 Web 控制台

1. 打开 Web 浏览器，在地址栏中输入 KSV Web 控制台的 IP 地址和端口号。

   <Notice type='note'>

   * 您可以从 KSV 安装成功的回显或安装日志中获取 KSV Web 控制台的 IP 地址和端口号。有关更多信息，请参阅[安装指南](../../installation/)。
   * 取决于您的网络环境，您可能需要配置防火墙策略和流量转发策略。有关具体操作，请联系您的网络环境管理员。

   </Notice>

2. （可选）在 KSV Web 控制台的登录页面，点击 **English** 或**简体中文**可切换语言。

3. 在 KSV Web 控制台的登录页面，输入用户信息然后点击**登录**。

   <Notice type='note'>

   KSV Web 控制台提供以下默认用户：

   * 系统管理员：用户名 `admin`，密码 `P@88w0rd`。
   * `default` 项目管理员：用户名 `project-default-admin`，密码 `123456`。
   * `default` 项目操作员：用户名 `project-default-operator`，密码 `123456`。

   </Notice>

   <img src='/images/docs/ksv/management/web-console-introduction/login-page.png'/>

4. （可选）登录成功后，在页面右上角点击 <img src='/images/docs/ksv/management/web-console-introduction/set-login-user.png' width='15'/>，然后在下拉列表中点击**当前用户设置**可修改当前登录用户的邮箱、密码以及 KSV Web 控制台的语言。

5. （可选）在页面右上角点击 <img src='/images/docs/ksv/management/web-console-introduction/set-login-user.png' width='15'/>，然后在下拉列表中点击**版本说明**可查看当前 KSV 版本的更新内容。

6. 在页面右上角点击 <img src='/images/docs/ksv/management/web-console-introduction/set-login-user.png' width='15'/>，然后在下拉列表中点击**激活**可对 KSV 进行激活。未激活状态下 KSV 部分功能受限。有关更多信息请参阅[软件许可证](../../license/)。

7. 在页面右上角点击 <img src='/images/docs/ksv/management/web-console-introduction/set-login-user.png' width='15'/>，然后在下拉列表中点击**关于 KSV** 可查看 KSV 用户许可协议。有关更多信息请参阅[软件许可证](../../license/)。

8. （可选）在页面右上角点击 <img src='/images/docs/ksv/management/web-console-introduction/set-login-user.png' width='15'/>，然后点击**登出**可退出 KSV Web 控制台。

## 功能模块

KSV Web 控制台提供以下功能模块：

<table border="1">
<tbody>
<tr>
  <th width='100'>功能模块</th>
  <th width='200'>可见性</th>
  <th>描述</th>
</tr>
<tr>
  <td>概览</td>
  <td>仅系统 <code>admin</code> 用户可见</td>
  <td>提供系统设备状态、资源使用情况、物理吞吐等概览信息，帮助您快速获取系统资源的实时状态。</td>
</tr>
<tr>
  <td>节点</td>
  <td>仅系统 <code>admin</code> 用户可见</td>
  <td>节点是集群中的基础服务器，在集群节点上可以创建虚拟机。此模块提供集群节点的汇总列表及每个节点的资源使用情况、虚拟机状态、健康状态、网络状态等详情信息。</td>
</tr>
<tr>
  <td>IP 池</td>
  <td>仅系统 <code>admin</code> 用户可见</td>
  <td>IP 池与 KSV 基础设施环境中配置的网络相对应，用于将虚拟机分配到特定的网络中并为虚拟机提供 IP 地址。此模块提供 IP 池汇总列表和各 IP 池的详情，并支持以下操作：<ul><li>创建和删除 IP 池</li><li>编辑 IP 池信息</li></ul></td>
</tr>
<tr>
  <td>虚拟机</td>
  <td>所有用户可见</td>
  <td>虚拟机创建在 KSV 集群节点上，可以用于运行工作负载。此模块提供虚拟机汇总列表和各虚拟机的详情，并支持以下操作：<ul><li>创建和删除虚拟机</li><li>编辑虚拟机信息</li><li>启动和关闭虚拟机</li><li>远程连接虚拟机</li><li>暴露虚拟机服务</li><li>挂载和卸载磁盘</li><li>创建和删除虚拟机快照</li><li>编辑快照信息</li><li>从快照还原虚拟机</li><li>查看和删除虚拟机还原记录</li></ul></td>
</tr>
<tr>
  <td>镜像</td>
  <td>所有用户可见</td>
  <td>镜像是带有操作系统的虚拟机模板，可用于创建虚拟机。此模块提供镜像汇总列表和各镜像的详情，并支持以下操作：<ul><li>创建和删除镜像</li><li>编辑镜像信息</li><li>共享镜像和取消镜像共享</li></ul></td>
</tr>
<tr>
  <td>磁盘</td>
  <td>所有用户可见</td>
  <td>磁盘可以挂载到虚拟机上用于存储数据。此模块提供磁盘汇总列表和各磁盘的详情，并支持以下操作：<ul><li>创建和删除磁盘</li><li>编辑磁盘信息</li><li>查看磁盘所属的虚拟机</li><li>对磁盘进行扩容</li><li>创建和删除磁盘快照</li><li>编辑快照信息</li><li>从快照还原磁盘</li><li>查看和删除磁盘还原记录</li></ul></td>
</tr>
<tr>
  <td>告警</td>
  <td>仅系统 <code>admin</code> 用户可见</td>
  <td>告警可用于监控集群资源。此模块提供告警信息汇总列表、告警策略汇总列表和各告警策略的详情，并支持以下操作：<ul><li>创建告警策略</li><li>编辑告警策略</li><li>删除告警策略</li></ul></td>
</tr> 
<tr>
  <td>日志</td>
  <td>仅系统 <code>admin</code> 用户可见</td>
  <td>日志包括系统日志和操作日志，系统日志收集系统中的日志数据，操作日志可以用于查看用户的操作记录。此模块提供系统日志汇总列表、各系统日志的详情、操作日志汇总列表和各操作日志的详情，并支持以下操作：<ul><li>查看实时系统日志</li><li>将系统日志文件导出到本地</li></ul></td>
</tr> 
<tr>
  <td>项目</td>
  <td>所有用户可见</td>
  <td>项目用于对资源进行分组管理。您可以将用户分配到项目中，并指定用户的角色以控制用户在项目中的权限。此模块提供项目汇总列表和各项目的详情，并支持以下操作：<ul><li>创建和删除项目</li><li>编辑项目信息</li><li>邀请和移除项目成员</li><li>修改项目成员角色</li></ul></td>
</tr>
<tr>
  <td>用户</td>
  <td>仅系统 <code>admin</code> 用户可见</td>
  <td>用户可以被分配到项目中并根据用户的项目角色获得不同的权限。此模块提供用户汇总列表和各用户的详情，并支持以下操作：<ul><li>创建和删除用户</li><li>编辑用户信息</li><li>修改用户密码</li></ul></td>
</tr>
<tr>
  <td>KSV 助手</td>
  <td>所有用户可见</td>
  <td>KSV 助手提供资源操作进度和可选功能的下载链接。此模块提供告警和日志功能的下载链接，并支持查看添加节点和创建镜像的操作进度。</td>
</tr>
</tbody>
</table>

## 功能页面

除**概览**页面外，KSV Web 控制台的各功能模块都提供资源列表页面和资源详情页面，帮助您快速获取各类资源的汇总信息和单个资源的详情。具体介绍如下：

* 资源列表页面

  展示各类资源的汇总信息。KSV Web 控制台提供节点、IP 池、虚拟机、镜像、磁盘、项目、告警、日志和用户的资源列表页面。以下以虚拟机列表页面为例：

  <img src='/images/docs/ksv/management/web-console-introduction/vm-list-zh.png'/>

* 资源详情页面

  展示单个资源的详情信息并支持对单个资源进行操作。根据不同的资源类型，资源详情页面提供的信息和支持的操作有所不同。KSV Web 控制台提供节点、IP 池、虚拟机、镜像、磁盘、项目、告警、日志和用户的资源详情页面。以下以虚拟机详情页面为例：

  <img src='/images/docs/ksv/management/web-console-introduction/vm-details-zh.png'/>

## 常见图标

KSV Web 控制台的常见图标介绍如下：

<table border="1">
<tbody>
<tr>
  <th width='150'>图标</th>
  <th>描述</th>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/show-drop-down-list.png' width='13'/></td>
  <td>展开下拉列表。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/hide-drop-down-list.png' width='13'/></td>
  <td>收起下拉列表。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/refresh.png' width='15'/></td>
  <td>刷新数据。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/search.png' width='15'/></td>
  <td>搜索资源。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/indicator-critical.png' width='8'/>/<img src='/images/docs/ksv/management/web-console-introduction/indicator-warning.png' width='8'/>/<img src='/images/docs/ksv/management/web-console-introduction/indicator-notice.png' width='8'/>/<img src='/images/docs/ksv/management/web-console-introduction/indicator-normal.png' width='8'/>/<img src='/images/docs/ksv/management/web-console-introduction/indicator-stopped.png' width='8'/></td>
  <td>资源状态图标。具体含义请参阅各功能模块的管理指南。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/operation-menu.png' width='13'/></td>
  <td>展开/收起资源操作菜单。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/delete-resource.png' width='13'/></td>
  <td>删除资源。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/return-to-resource-list.png' width='15'/></td>
  <td>返回上一页面。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/add-item.png' width='13'/></td>
  <td>增加条目。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/delete-item.png' width='13'/></td>
  <td>减少条目。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/next.png' width='18'/></td>
  <td>打开列表下一页。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/previous.png' width='18'/></td>
  <td>返回列表上一页。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/show-password.png' width='15'/></td>
  <td>显示密码明文。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/hide-password.png' width='15'/></td>
  <td>隐藏密码明文。</td>
</tr>
<tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/ascend.png' width='15'/></td>
  <td>按照升序排列条目。</td>
</tr>
  <tr>
  <td><img src='/images/docs/ksv/management/web-console-introduction/descend.png' width='15'/></td>
  <td>按照降序排列条目。</td>
</tr>
</tbody>
</table>


介绍如何登录 KSV Web 控制台以及 Web 控制台的功能模块、功能页面和常见图标。

Web 控制台介绍


本节介绍如何使用 KubeSphere 虚拟化（KSV）Web 控制台的**概览**功能。

**概览**功能提供集群资源的概览信息，帮助您快速获取集群资源的实时状态。

<Notice type='note'>

**概览**功能仅对系统 `admin` 用户可见。如需使用**概览**功能，您需要以系统 `admin` 用户登录。

</Notice>

## 查看概览页面

**概览**页面在系统 `admin` 用户登录 KSV Web 控制后默认显示。

如需从其他页面返回**概览**页面，请在页面顶部的菜单栏中点击**概览**。

## 页面描述

**概览**页面如下图所示：

<img src ='/images/docs/ksv/management/overview/overview-page.png'/>

各功能区描述如下：

<table border="1">
<tbody>
<tr>
  <th width='60'>序号</th>
  <th width='190'>功能区名称</th>
  <th>描述</th>
</tr>
<tr>
  <td>1</td>
  <td>集群资源</td>
  <td>显示集群 CPU、内存、磁盘资源的使用情况。<br/><ul><li><b>已使用</b>：集群中已实际占用的资源数量。</li><li><b>总计</b>：KSV 可用的资源总量。</li></ul></td>
</tr>
  <tr>
  <td>2</td>
  <td>虚拟资源</td>
    <td>显示集群 vCPU 已使用核心数、vCPU 核心总数、超卖比和已创建的虚拟机、磁盘、IP 池的数量。<br/>
      对于 <b>vCPU</b>：<br/><ul><li><b>已使用</b>：KSV 平台上已使用的 vCPU 核心数。</li><li><b>总计</b>：KSV 平台上可使用的 vCPU 核心总数。可使用的 vCPU 核心总数 = 集群 CPU 核心总数 x 超卖比。超卖比可在安装 KSV 时设置，有关更多信息，请参阅<a href='../../installation/'>安装指南</a>。</li></ul></td>
</tr>
<tr>
  <td>3</td>
  <td>虚拟机资源用量 Top 5</td>
  <td>显示集群中特定资源用量最高的 5 台虚拟机的名称。您可以点击下拉列表选择按 <b>CPU 使用率</b>或<b>内存使用率</b>排序。</td>
</tr>
<tr>
  <td>4</td>
  <td>IOPS 和物理吞吐量</td>
  <td>显示集群实时 IOPS 和物理吞吐量。<ul><li><b>IOPS</b>：集群每秒读写操作数，每隔 5 分钟采样一次。</li><li><b>物理吞吐量</b>：集群每秒读写数据量，每隔 5 分钟采样一次。</li></ul></td>
</tr>
<tr>
  <td>5</td>
  <td>集群节点</td>
  <td>显示集群创建后已运行的天数和集群节点当前的健康状态。<ul><li><img src ='/images/docs/ksv/management/overview/node-running.png' width='25'/>/<img src ='/images/docs/ksv/management/overview/node-faulty.png' width='25'/>：表示每个节点的健康状态。<img src ='/images/docs/ksv/management/overview/node-running.png' width='25'/> 表示节点运行正常，<img src ='/images/docs/ksv/management/overview/node-faulty.png' width='25'/> 表示节点存在告警。有关节点健康状态的更多信息，请参阅<a href='../nodes/'>节点</a>。</li><li><b>控制节点</b>：显示正常控制节点数和控制节点总数。</li><li><b>工作节点</b>：显示正常工作节点数和工作节点总数。</li></ul></td>
</tr>
<tr>
  <td>6</td>
  <td>节点资源用量 Top 3</td>
  <td>显示集群中特定资源用量最高的 3 个节点的名称。您可以点击下拉列表选择按 <b>CPU 使用率</b>、<b>内存使用率</b>或<b>磁盘使用率</b>排序。</td>
</tr>
</tbody>
</table>


介绍如何使用 KSV Web 控制台的概览功能。

概览


本节介绍如何使用 KubeSphere 虚拟化（KSV）Web 控制台的**节点**功能。

节点是 KSV 集群中的基础服务器，在集群节点上可以创建虚拟机。**节点**功能提供集群节点汇总列表和各节点的详情，帮助您快速获取集群节点的实时状态。

<Notice type='note'>

**节点**功能仅对系统 `admin` 用户可见。如需使用**节点**功能，您需要以系统 `admin` 用户登录。

</Notice>

## 节点列表页面

### 查看节点列表

1. 以系统 `admin` 用户登录 KSV Web 控制台。

2. 在页面顶部的菜单栏中点击**节点**以打开节点列表页面。

   节点列表页面展示集群中所有的节点，并提供以下信息：

   <table border="1">
   <tbody>
   <tr>
     <th width='150'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <td>名称</td>
     <td>节点的名称。在单节点模式下，节点名称由系统自动分配。在多节点模式下，节点名称由用户在<a href='../../installation/install-ksv-in-multi-node-mode/#安装-ksv'>安装 KSV </a>时指定。</td>
   </tr>
   <tr>
     <td>IP 地址</td>
     <td>节点的 IP 地址。</td>
   </tr>
   <tr>
     <td>角色</td>
     <td>节点在集群中的角色。<ul><li>在单节点模式下，节点同时为控制节点和工作节点。</li><li>在多节点模式下，节点的角色由用户在<a href='../../installation/install-ksv-in-multi-node-mode/#安装-ksv'>安装 KSV 和添加节点</a>时指定，可以为控制节点、工作节点或同时为控制节点和工作节点。</li><li>工作节点上可以创建虚拟机。</li></ul></td>
   </tr>
   <tr>
    <td>健康状态</td>
     <td>节点的健康状态，包括以下状态类型：<ul><li><b>正常</b>：节点运行正常。</li><li><b>告警</b>：节点存在告警。</li></ul>在告警状态下，将光标移动到<b>告警</b>可查看具体的告警消息，包括以下告警消息：<ul><li><b>节点心跳信号已连续中断超过 40s。</b></li><li><b>可用内存小于 100 MiB。</b></li><li><b>可用磁盘空间小于 15%。</b></li><li><b>节点上无法创建虚拟机。</b>节点在后端环境中被手动标记为不可调度时显示此消息。</li><li><b>节点状态异常。</b>如果出现此告警消息，则表明节点存在故障，需要检查节点的软件或硬件。</li></ul></td>
   </tr>
   <tr>
     <td>虚拟机</td>
     <td>节点中已创建的虚拟机数量。</td>
   </tr>
   <tr>
     <td>CPU 用量</td>
     <td>节点的 CPU 用量。</td>
   </tr>
   <tr>
     <td>内存用量</td>
     <td>节点的内存用量。</td>
   </tr>
   <tr>
     <td>磁盘用量</td>
     <td>节点的磁盘用量。</td>
   </tr>
   <tr>
     <td>创建时间</td>
     <td>节点的创建时间。</td>
   </tr>
   </tbody>
   </table>
   
3. （可选）点击节点列表上方的搜索框并设置搜索条件，可按名称或健康状态搜索节点（例如，使用`名称:ab` 搜索名称包含字符串 `ab` 的节点）。

4. （可选）在节点列表右上角点击 <img src='/images/docs/ksv/management/nodes/refresh.png' width='15px'/> 可刷新列表数据。

5. （可选）在节点列表右侧的**相关资源**区域，点击需要查看的资源类型可快速打开对应的资源列表页面。

### 添加节点

1. 在节点列表页面点击**添加**。

2. 在**添加节点**页面，为即将添加的节点设置以下参数。

   <table border='1'>
     <tbody>
       <tr>
       <th width='150'>参数</th>
       <th>描述</th>
       </tr>
       <tr>
       <td>名称</td>
       <td>用户自定义的节点名称。名称只能包含小写字母、数字和连字符（-），必须以小写字母或数字开头和结尾，最长 16 个字符。如果同时添加多个节点，系统将自动在不同节点的名称后增加序列号。</td>
       </tr>
       <tr>
       <td>内部 IP 地址</td>
       <td>集群内各节点可访问的内部 IP 地址。您需要手动输入每个节点的 IP 地址。在<b>内部 IP 地址</b>右侧点击 <img src ="/images/docs/ksv/management/nodes/add-ip-address.png" width='20'/>/<img src ="/images/docs/ksv/management/nodes/delete-ip-address.png" width='20' align='center'/> 可增加/减少待添加的节点的数量。</td>
       </tr>
       <tr>
       <td>数量</td>
       <td>需要添加的节点的数量。目前支持同时添加最多 50 个节点。</td>
       </tr>
       <tr>
       <td>SSH 认证方式</td>
         <td>节点的 SSH 认证方式。<br/><ul><li><b>用户名和密码</b>：使用用户名和密码登录服务器节点。</li></ul><ul><li><b>SSH 密钥</b>：使用 SSH 密钥登录服务器节点。</li></ul></td>
       </tr>
       <tr>
         <td>端口</td>
         <td>用于 SSH 登录节点的端口号。</td>
       </tr>
     </tbody>
   </table>

   <Notice type='note'>

   添加多个节点并选择使用 SSH 密钥登录时，您需要预先为所有待添加的节点设置相同的 SSH 密钥。

   </Notice>

3. 点击**确定**。节点添加完成后将显示在节点列表中。
  
  <Notice type='note'>

    在页面右下角的 **KSV 助手**中，点击**操作进度**并选择**节点**可查看待添加的节点的进度。

    </Notice>

4. 如需在环境满足要求后开启高可用，您需要以 `root` 用户登录服务器节点，进入安装包解压后生成的目录，并执行以下命令：
  ```
  ksv set-ceph-ha
  ```
  如果显示如下信息则高可用开启成功：
  ```
  set pool 2 size to 3
  ```
  <Notice type='note'>

    - 目前，KSV 只支持添加节点，不支持删除节点。
    - 单节点模式下，KSV 支持使用控制台添加最多 2 个节点。如需使用控制台添加更多节点，则需要购买商业版许可证。有关更多信息，请参阅[软件许可证](../../license)。

  </Notice>
  
## 节点详情页面

### 查看节点详情

1. 在节点列表页面，点击节点的名称可打开节点的详情页面。

2. （可选）在**资源使用情况**曲线图中查看节点的实时 CPU 和内存使用情况。

3. （可选）在**网络状态**曲线图中查看节点的实时出入流量状态。

4. （可选）在**虚拟机**列表中查看节点上运行的虚拟机。有关虚拟机的更多信息，请参阅[虚拟机](../vms/)。

5. （可选）在**事件**列表中查看节点上发生的事件。点击事件列表右上角的**导出**可导出事件的详细信息。

   <table border="1">
   <tbody>
   <tr>
     <th width='150px'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <td>类型</td>
     <td>事件的类型，包括以下状态类型：<ul><li><b>正常</b>：节点上的正常事件。</li><li><b>异常</b>：节点上的异常事件。</li></ul></td>
   </tr>
   <tr>
     <td>原因</td>
     <td>记录该事件的原因。</td>
   </tr>
   <tr>
     <td>发生时间</td>
     <td>事件的发生时间。</td>
   </tr>
     <tr>
     <td>来源</td>
     <td>事件的来源组件。</td>
   </tr>
     <tr>
     <td>消息</td>
     <td>事件的详细信息。</td>
   </tr>
   </tbody>
   </table>

6. （可选）在页面右侧的**资源状态**区域查看节点 CPU、内存、磁盘的使用情况。

   <table border="1">
   <tbody>
   <tr>
     <th width='150px'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <td>节点 CPU</td>
     <td>显示节点上实际已使用的CPU核心数和 CPU 核心总数。</td>
   </tr>
   <tr>
     <td>节点内存</td>
     <td>显示节点上实际已使用的内存大小和内存总量。</td>
   </tr>
   <tr>
     <td>节点磁盘</td>
     <td>显示节点上实际已使用的磁盘大小和磁盘总量。</td>
   </tr>
   </tbody>
   </table>

### 迁移虚拟机

如果节点的**健康状态**为**告警**，您可以将节点上的虚拟机迁移到其他节点。

1. 在虚拟机详情页面左上角点击**迁移虚拟机**。

2. 在弹出的对话框中点击**确定**以将虚拟机迁移到其他节点。

<Notice type='warning'>

此操作将中断虚拟机上运行的业务。请确认节点是否已宕机，如未宕机则不需要执行此操作。

</Notice>

<Notice type='note'>

* **迁移虚拟机**按钮只有在节点的**健康状态**为**告警**时才会显示。
* 取决于集群中剩余的可用资源，部分虚拟机可能无法迁移成功。有关更多信息，请参阅[虚拟机](../vms/)。

</Notice>


介绍如何使用 KSV Web 控制台的节点功能。

节点


本节介绍如何使用 KubeSphere 虚拟化（KSV）Web 控制台的 **IP 池**功能。

IP 池与 KSV 基础设施环境中配置的网络相对应，用于将虚拟机分配到特定的网络中并为虚拟机提供 IP 地址。**IP 池**功能提供 IP 池汇总列表和各 IP 池的详情，并支持创建和删除 IP 池以及编辑 IP 池信息。

<Notice type='note'>

* **IP 池**功能仅对系统 `admin` 用户可见。如需使用 **IP 池**功能，您需要以系统 `admin` 用户登录。
* **IP 池**功能目前只支持 IPv4。

</Notice>

## IP 池列表页面

### 查看 IP 池列表

1. 以系统 `admin` 用户登录 KSV Web 控制台。

2. 在页面顶部的菜单栏中选择 **IP 池**以打开 IP 池列表页面。

   IP 池列表展示系统中所有的 IP 池，并提供以下信息：

   <table border="1">
   <tbody>
   <tr>
     <th width='150'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <td>名称</td>
     <td>用户自定义的 IP 池名称。</td>
   </tr>
   <tr>
     <td>ID</td>
     <td>IP 池在系统中的通用唯一标识符，由系统自动分配。</td>
   </tr>
   <tr>
     <td>VLAN ID</td>
     <td>IP 池对应网络的 VLAN ID。</td>
   </tr>
   <tr>
     <td>网段</td>
     <td>IP 池对应的网段。</td>
   </tr>
   <tr>
     <td>网关</td>
     <td>IP 池对应网络的网关地址。</td>
   </tr>
     <tr>
     <td>创建者和创建时间</td>
     <td>IP 池的创建者和创建时间。</td>
   </tr>
   </tbody>
   </table>
   
   
   有关以上参数的更多信息，请参阅[创建 IP 池](#创建-ip-池)。
   
3. （可选）点击 IP 池列表上方的搜索框并设置搜索条件，可按 ID 或名称搜索 IP 池（例如，使用`名称:ab` 搜索名称包含字符串 `ab` 的 IP 池）。

4. （可选）在 IP 池列表右上角点击 <img src="/images/docs/ksv/management/ip-pools/refresh.png" width='15'/> 可刷新列表数据。

5. （可选）在 IP 池列表右侧的**相关资源**区域，点击需要查看的资源类型可快速打开对应的资源列表页面。

### 创建 IP 池

<Notice type='note'>

创建 IP 池前，您需要在 KSV 基础设施环境中创建 IP 池对应的网络。与 IP 池绑定的虚拟机将被分配到 IP 池对应的网络中。有关如何创建所需的网络，请联系基础设施环境的网络管理员。

</Notice>

1. 在 IP 池列表页面点击**创建**。

2. 在**创建 IP 池**页面，为即将创建的 IP 池设置以下参数：

   <table border="1">
   <tbody>
   <tr>
     <th width='200'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <td>名称</td>
     <td>用户自定义的 IP 池名称。名称只能包含小写字母、数字和连字符（-），必须以小写字母或数字开头和结尾，最长 16 个字符。</td>
   </tr>
   <tr>
     <td>网段</td>
     <td>IP 池对应网络的地址段，支持无类别域间路由（CIDR）。</td>
   </tr>
   <tr>
     <td>启始 IP 地址/结束 IP 地址</td>
     <td>IP 池包含的 IP 地址范围。如果网络中的部分地址已被占用，您需要设置 IP 地址的范围以避免地址冲突。</td>
   </tr>
   <tr>
     <td>网关</td>
     <td>IP 池对应网络的网关地址，该地址必须属于 IP 池的网段并且与节点网卡的 IP 地址网络连通。</td>
   </tr>
   <tr>
     <td>VLAN ID</td>
     <td>IP 池对应网络的 VLAN ID，取值范围为 0–4095。<code>0</code> 表示无 VLAN ID，<code>4095</code> 表示所有 VLAN ID。</td>
   </tr>
   <tr>
     <td>节点网卡</td>
     <td>KSV 集群节点的网卡名称。与 IP 池绑定的虚拟机将通过该网卡连接网络。节点网卡将决定与 IP 池绑定的虚拟机创建在哪个集群节点上。<ul><li>如果网卡名称在 KSV 集群中唯一，与 IP 池绑定的虚拟机将创建在该网卡所在的节点上。</li><li>如果网卡名称在多个集群节点上都存在，与 IP 池绑定的虚拟机将创建在具有该网卡名称的某一节点上。</li></ul></td>
   </tr>
   <tr>
     <td>域名服务器（可选）</td>
     <td>IP 池对应网络的域名服务器地址，该地址必须与节点网卡的 IP 地址网络连通。在<b>域名服务器</b>右侧点击 <img src ="/images/docs/ksv/management/ip-pools/add-item.png" width='13'/>/<img src ="/images/docs/ksv/management/ip-pools/delete-item.png" width='13' align='center'/> 可增加/减少域名服务器数量。</td>
   </tr>
   <tr>
     <td>描述（可选）</td>
     <td>用户自定义的 IP 池描述信息。描述可包含任意字符，最长 128 个字符。</td>
   </tr>
   </tbody>
   </table>

3. 点击**创建**。IP 池创建后将显示在 IP 池列表中。

### 批量删除 IP 池

1. 在 IP 池列表页面，选择需要删除的 IP 池名称左侧的复选框，然后在列表上方点击**删除**。

2. 在弹出的对话框中点击**确定**可批量删除多个 IP 池。

   <Notice type='warning'>

   IP 池删除后无法恢复，请谨慎执行此操作。

   </Notice>

   <Notice type='note'>

   如果存在与 IP 池绑定的虚拟机，您需要删除所有与 IP 池绑定的虚拟机才能删除 IP 池。有关如何删除虚拟机，请参阅[删除虚拟机](../vms/#删除虚拟机)和[批量操作虚拟机](../vms/#批量操作虚拟机)。

   </Notice>

## IP 池详情页面

### 查看 IP 池详情

1. 在 IP 池列表页面，点击 IP 池的名称可打开 IP 池的详情页面。

2. （可选）点击 <img src ="/images/docs/ksv/management/ip-pools/vm-list.png" width='13'/> 可查看已绑定到 IP 池的虚拟机列表，点击 <img src ="/images/docs/ksv/management/ip-pools/vm-topology.png" width='13'/> 可查看已绑定到 IP 池的虚拟机的网络拓扑。

### 编辑 IP 池信息

1. 在 IP 池详情页面左上角点击**编辑**。

2. 在弹出的对话框中修改 IP 池的**名称**、**描述**和**域名服务器**，然后点击**确定**。有关更多信息，请参阅[创建 IP 池](#创建-ip-池)。

### 删除 IP 池

1. 在 IP 池详情页面左上角点击**删除**。

2. 在弹出的对话框中点击**确定**可删除 IP 池。

   <Notice type='warning'>

   IP 池删除后无法恢复，请谨慎执行此操作。

   </Notice>

   <Notice type='note'>

   如果存在与 IP 池绑定的虚拟机，您需要删除所有与 IP 池绑定的虚拟机才能删除 IP 池。有关如何删除虚拟机，请参阅[删除虚拟机](../vms/#删除虚拟机)和[批量操作虚拟机](../vms/#批量操作虚拟机)。

   </Notice>

介绍如何使用 KSV Web 控制台的 IP 池功能。

IP 池

介绍如何使用 KSV Web 控制台的虚拟机功能。

虚拟机


本节介绍如何使用 KubeSphere 虚拟化（KSV）Web 控制台的**镜像**功能。

镜像是带有操作系统的虚拟机模板，可用于创建虚拟机。**镜像**功能提供镜像汇总列表和各镜像的详情，并支持创建和删除镜像、编辑镜像信息、共享镜像和取消镜像共享。

**镜像**功能对所有用户可见。`admin` 用户可以查看系统中的所有镜像并且可以对镜像执行所有操作，其他具有不同角色的用户在**镜像**功能中的权限如下：

<table border="1">
<tbody>
<tr>
  <th width='100'>用户</th>
  <th width='100'>项目角色</th>
  <th>权限</th>
</tr>
<tr>
  <td>普通用户</td>
  <td>管理员</td>
  <td>可以查看用户所属项目中的镜像并且可以对镜像执行所有操作。</td>
</tr>
<tr>
  <td>普通用户</td>
  <td>操作员</td>
  <td>可以查看用户所属项目中的镜像并且可以对镜像执行所有操作。</td>
</tr>
<tr>
  <td>普通用户</td>
  <td>观察员</td>
  <td>只能查看用户所属项目中的镜像，不能对镜像执行操作。</td>
</tr>
</tbody>
</table>

## 镜像列表页面

### 查看镜像列表

1. 以系统 `admin` 用户或属于至少一个项目的其他用户登录 KSV Web 控制台。有关更多信息，请参阅[用户](../users/)。

2. 在页面顶部的菜单栏中点击**镜像**以打开镜像列表页面。

3. 在镜像列表左上角的下拉列表中选择一个项目以查看特定项目中的镜像。

   <Notice type='note'>

   项目下拉列表中仅显示当前登录用户所属的项目。

   </Notice>

   镜像列表展示当前项目中的所有镜像，并提供以下信息：

   <table border="1">
   <tbody>
   <tr>
     <th width='150'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <td>名称</td>
     <td>用户自定义的镜像名称。</td>
   </tr>
   <tr>
     <td>ID</td>
     <td>镜像在系统中的通用唯一标识符。</td>
   </tr>
   <tr>
     <td>状态</td>
     <td>镜像当前的状态，包括以下状态类型：<ul><li><img src ="/images/docs/ksv/management/images/indicator-normal.png" width='8'/>：镜像已创建完成并且可用。</li><li><img src ="/images/docs/ksv/management/images/indicator-notice.png" width='8'/>：镜像正在创建中。</li><li><img src ="/images/docs/ksv/management/images/indicator-warning-flicker.gif" width='8'/>：镜像正在等待创建。</li></ul>如果镜像状态异常，镜像名称下方将显示以下状态消息：<ul><li>镜像创建失败</li><li>镜像导入失败</li></ul></td>
   </tr>
   <tr>
     <td>类型</td>
     <td>镜像是否已共享给其他项目。包括以下类型：<ul><li><b>私有</b>：镜像只能在当前项目中使用。</li><li><b>共享</b>：镜像已共享给系统中的其他项目，其他项目可通过复制获取该镜像。</li></ul></td>
   </tr>
   <tr>
     <td>操作系统</td>
     <td>镜像的操作系统类型。</td>
   </tr>
   <tr>
     <td>容量</td>
     <td>镜像的系统盘容量。</td>
   </tr>
   <tr>
     <td>创建者和创建时间</td>
     <td>镜像的创建者和创建时间。</td>
   </tr>
   </tbody>
   </table>
   
4. （可选）点击镜像列表上方的搜索框并设置搜索条件，可按 ID、名称、或镜像是否已共享搜索镜像（例如，使用`名称:ab` 搜索名称包含字符串 `ab` 的镜像）。

5. （可选）在镜像列表右上角点击 <img src="/images/docs/ksv/management/images/refresh.png" width='15'/> 可刷新列表数据。

6. （可选）在镜像列表右侧的**相关资源**区域，点击需要查看的资源类型可快速打开对应的资源列表页面。

### 创建镜像

* 上传镜像

  1. 在镜像列表页面点击**创建**。

  2. 在**创建镜像**页面，点击**上传镜像**。

  3. 点击 <img src="/images/docs/ksv/management/images/upload.png" width='15'/>，然后选择本地存储的镜像文件，或点击**通过 URL 上传**。

     下表提供常用镜像的下载地址。

     <table border ='1'>
     <tbody>
     <tr>
       <th width='150'>镜像</th>
       <th>下载地址</th>
       </tr>
       <tr>
       <td>CentOS</td>
      <td><a href='https://virtualization.kubesphere.cloud/images/centOS-7-x86_64-GenericCloud-2111.qcow2'>CentOS 7</a><br/>
         <a href='https://virtualization.kubesphere.cloud/images/centOS-8-x86_64-GenericCloud-8.4.21053.qcow2'>CentOS 8</a><br/>
         </td>
       </tr>
       <tr>
         <td>Debian</td>
         <td><a href='https://virtualization.kubesphere.cloud/images/debian-9.13.31-20211221-openstack-amd64.qcow2'>Debian 9.13</a><br/>
         <a href='https://virtualization.kubesphere.cloud/images/debian-10.11.2-20211129-openstack-amd64.qcow2'>Debian 10.11</a><br/></td>
       </tr>
       <tr>
       <td>Ubuntu</td>
       <td><a href='https://virtualization.kubesphere.cloud/images/ubuntu_16.04_LTS_server-cloudimg-amd64.img'>Ubuntu 16.04</a><br/>
         <a href='https://virtualization.kubesphere.cloud/images/ubuntu_18.04_LTS_server-cloudimg-amd64.img'>Ubuntu 18.04</a><br/>
         <a href='https://virtualization.kubesphere.cloud/images/ubuntu_20.04_LTS_server-cloudimg-amd64.img'>Ubuntu 20.04</a><br/>
         </td>
       </tr>
        <tr>
         <td>Fedora</td>
         <td><a href='https://virtualization.kubesphere.cloud/images/fedora-Cloud-Base-35-1.2.x86_64.qcow2'>Fedora 35</a></td>
       </tr>
        <tr>
         <td>Windows</td>
         <td><a href='https://virtualization.kubesphere.cloud/images/win/cn_windows_10_consumer_editions_version_21h1_x64_dvd_1baf479d.iso'>Windows 10</a><br/>
         <a href='https://virtualization.kubesphere.cloud/images/win/zh-cn_windows_server_2022_x64_dvd_6c73507d.iso'>Windows Server 2022</a></td>
       </tr>
       </tbody>
       </table>
     
     <Notice type='note'>
     
     - 您也可以将本地存储的镜像文件拖动到 <img src="/images/docs/ksv/management/images/upload.png" width='15'/> 处进行上传。
     - 目前支持 IMG、QCOW2、XZ、TAR、GZ、ISO 和 RAW 格式的镜像文件。
     - 镜像文件上传后将存储在文件服务器中。如果文件服务器中存在同名镜像文件，则需要修改镜像文件的名称或删除镜像服务器中的已有镜像文件，然后重新上传。
     
     </Notice>

   4. 为镜像设置以下参数：

      <table border='1'>
      <tbody>
       <tr>
         <th width='150'>参数</th>
         <th>描述</th>
       </tr>
       <tr>
         <td>镜像文件</td>
         <td>虚拟机镜像文件。<ul><li>如果在步骤 3 已上传本地镜像文件，则无需配置此参数。</li><li>如果在步骤 3 选择<b>通过 URL 上传</b>，则需要在此处设置镜像文件的 URL。URL 指向的文件格式必须为 IMG、QCOW2、XZ、TAR、GZ、ISO 或 RAW。</li></ul></td>
       </tr>
       <tr>
         <td>操作系统</td>
         <td>镜像的操作系统类型。您可以点击下拉列表选择系统内置的操作系统类型，或选择<b>自定义</b>然后手动输入操作系统类型和版本。</td>
       </tr>
       <tr>
         <td>版本</td>
         <td>镜像的操作系统版本。</td>
       </tr>
       <tr>
         <td>镜像名称</td>
         <td>用户自定义的镜像名称。名称只能包含小写字母、数字和连字符（-），必须以小写字母或数字开头和结尾，最长 16 个字符。</td>
       </tr>
       <tr>
         <td>默认配置</td>
         <td>使用该镜像创建的虚拟机的默认 CPU、内存和磁盘配置。</td>
       </tr>
       <tr>
         <td>描述</td>
         <td>用户自定义的镜像描述信息。描述可包含任意字符，最长 128 个字符。</td>
       </tr>
      </tbody>
      </table>

  5. 点击**创建**。镜像创建后将显示在镜像列表中。

* 复制镜像

   1. 在镜像列表页面点击**创建**。

   2. 在**创建镜像**页面，点击**复制镜像**。

   3. 在**复制镜像**页面，在需要复制的镜像右侧点击**复制**。

      <Notice type='note'>

      只有其他项目共享的镜像才可以复制。有关更多信息，请参阅[共享镜像](#共享镜像)和[取消镜像共享](#取消镜像共享)。

      </Notice>

   4. 在弹出的对话框中设置镜像在当前项目中的名称。

   5. 点击**确定**。镜像创建后将显示在镜像列表中。

### 批量操作镜像

1. 在镜像列表页面，选择需要操作的镜像名称左侧的复选框，然后在列表上方点击**共享**或**删除**。

2. 在弹出的对话框中点击**确定**可批量共享或删除镜像。

   <Notice type='warning'>

   镜像删除后无法恢复，请谨慎删除镜像。

   </Notice>

## 镜像详情页面

在镜像列表页面，点击镜像的名称可打开镜像的详情页面。

### 编辑镜像信息

1. 在镜像详情页面左上角点击**编辑**。

2. 在弹出的对话框中修改镜像的**名称**、**默认配置**、**磁盘容量**和**描述**，然后点击**确定**。有关更多信息，请参阅[创建镜像](#创建镜像)。

### 共享镜像

1. 在镜像详情页面左上角点击**共享**。

2. 在弹出的对话框中点击**确定**。镜像共享后，其他项目可通过复制获取该镜像。

### 取消镜像共享

1. 在镜像详情页面左上角点击**取消共享**。

2. 在弹出的对话框中点击**确定**。镜像共享取消后，其他项目不能再通过复制获取该镜像。已经复制的镜像不受影响。

### 删除镜像

1. 在镜像详情页面左上角点击**删除**。

2. 在弹出的对话框中点击**确定**。

   <Notice type='warning'>

   镜像删除后无法恢复，请谨慎执行此操作。

   </Notice>





介绍如何使用 KSV Web 控制台的镜像功能。

镜像


本节介绍如何使用 KubeSphere 虚拟化（KSV）Web 控制台的**磁盘**功能。

磁盘可挂载到虚拟机上用于存储数据。**磁盘**功能提供磁盘汇总列表和各磁盘的详情，并支持创建和删除磁盘、编辑磁盘信息、查看磁盘所属的虚拟机、对磁盘进行扩容、创建和删除磁盘快照、编辑快照信息、从快照还原磁盘以及查看和删除磁盘还原记录。

**磁盘**功能对所有用户可见。`admin` 用户可以查看系统中的所有磁盘并且可以对镜像执行所有操作，其他具有不同角色的用户在**磁盘**功能中的权限如下：

<table border="1">
<tbody>
<tr>
  <th width='100'>用户</th>
  <th width='100'>项目角色</th>
  <th>权限</th>
</tr>
<tr>
  <td>普通用户</td>
  <td>管理员</td>
  <td>可以查看用户所属项目中的磁盘并且可以对磁盘执行所有操作。</td>
</tr>
<tr>
  <td>普通用户</td>
  <td>操作员</td>
  <td>可以查看用户所属项目中的磁盘并且可以对磁盘执行所有操作。</td>
</tr>
<tr>
  <td>普通用户</td>
  <td>观察员</td>
  <td>只能查看用户所属项目中的磁盘，不能对磁盘执行操作。</td>
</tr>
</tbody>
</table>

## 磁盘列表页面

### 查看磁盘列表

1. 以系统 `admin` 用户或属于至少一个项目的其他用户登录 KSV Web 控制台。有关更多信息，请参阅[用户](../users/)。

2. 在页面顶部的菜单栏中点击**磁盘**以打开磁盘列表页面。

3. 在磁盘列表左上角的下拉列表中选择一个项目以查看特定项目中的磁盘。

   <Notice type='note'>

   项目下拉列表中仅显示当前登录用户所属的项目。

   </Notice>

   磁盘列表展示当前项目中的所有磁盘，并提供以下信息：

   <table border="1">
   <tbody>
   <tr>
     <th width='150'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <td>名称</td>
     <td>用户自定义的磁盘名称。</td>
   </tr>
   <tr>
     <td>ID</td>
     <td>磁盘在系统中的通用唯一标识符。</td>
   </tr>
   <tr>
     <td>状态</td>
     <td>磁盘当前的状态，包括以下状态类型：<ul><li><img src ="/images/docs/ksv/management/disks/indicator-normal.png" width='8'/>：磁盘已创建完成。</li><li><img src ="/images/docs/ksv/management/disks/indicator-notice.png" width='8'/>：磁盘正在创建中。</li><li><img src ="/images/docs/ksv/management/disks/indicator-warning-flicker.gif" width='8'/>：磁盘正在等待创建。</li></ul></td>
   </tr>
   <tr>
     <td>磁盘类型</td>
     <td>磁盘的类型。系统盘名称下方显示<b>系统盘</b>，数据盘不特别显示磁盘类型。</td>
   </tr>
   <tr>
     <td>虚拟机</td>
     <td>磁盘所挂载的虚拟机的 UUID。</td>
   </tr>
   <tr>
     <td>容量</td>
     <td>磁盘的容量。</td>
   </tr>
   <tr>
     <td>创建者和创建时间</td>
     <td>磁盘的创建者和创建时间。</td>
   </tr>
   </tbody>
   </table>

4. （可选）点击磁盘列表上方的搜索框并设置搜索条件，可按 ID 或名称搜索磁盘（例如，使用`名称:ab` 搜索名称包含字符串 `ab` 的磁盘）。

5. （可选）在磁盘列表右上角点击 <img src="/images/docs/ksv/management/disks/refresh.png" width='15'/> 可刷新列表数据。

6. （可选）在磁盘列表右侧的**相关资源**区域，点击需要查看的资源类型可快速打开对应的资源列表页面。

### 创建磁盘

1. 在磁盘列表页面点击**创建**。

2. 在弹出的对话框中为磁盘设置以下参数：

   <table>
     <thead>
       <tr>
         <th width='150'>参数</th><th>描述</th>
       </tr>
     </thead>
     <tbody>
       <tr>
         <td>名称</td><td>用户自定义的磁盘名称。名称只能包含小写字母、数字和连字符（-），必须以小写字母或数字开头和结尾，最长 16 个字符。如果同时创建多个磁盘，系统将自动在不同磁盘的名称后增加序列号。</td>
       </tr>
       <tr>
         <td>容量</td><td>磁盘的容量，最小值为 10 GiB。磁盘的容量不能超过集群可用的磁盘总量，否则磁盘将创建失败。</td>
       </tr>
       <tr>
         <td>数量</td><td>需要创建的磁盘的数量。目前支持同时创建最多 50 个磁盘。</td>
       </tr>
       <tr>
         <td>描述（可选）</td><td>用户自定义的磁盘描述信息。描述可包含任意字符，最长 128 个字符。</td>
       </tr>
     </tbody>
   </table>

3. 点击**创建**。磁盘创建后将显示在磁盘列表中。

### 批量删除磁盘

1. 在磁盘列表页面，选择需要删除的磁盘名称左侧的复选框，然后在列表上方点击**删除**。

2. 在弹出的对话框中点击**确定**可批量删除多个磁盘。

   <Notice type='note'>

   * 只支持手动删除数据盘。如需删除系统盘，您需要删除系统盘所属的虚拟机。
   * 如果数据盘已经挂载到虚拟机，需要先将数据盘从虚拟机卸载才能删除。有关如何卸载数据盘，请参阅[卸载数据盘](../vms/#卸载数据盘)。
   
   </Notice>
   
   <Notice type='warning'>
   
   磁盘删除后无法恢复，请谨慎执行此操作。
   
   </Notice>

## 磁盘详情页面

在磁盘列表页面，点击磁盘的名称可打开磁盘的详情页面。

### 编辑磁盘信息

1. 在磁盘详情页面左上角点击**编辑**。

2. 在弹出的对话框中修改磁盘的**名称**、**容量**和**描述**，然后点击**确定**。有关更多信息，请参阅[创建磁盘](#创建磁盘)。

   <Notice type='note'>

   * 系统盘扩容需要在虚拟机详情页面进行操作。有关如何扩容系统盘，请参阅[调整虚拟机资源](../vms/#调整虚拟机资源)。
   * 磁盘容量只能增加，不能减少。
   * 对于已挂载到虚拟机的磁盘，扩容后需要重启虚拟机才能使新配置生效。

   </Notice>

### 创建磁盘快照

1. 在磁盘详情页面左上角点击**创建快照**。

2. 在弹出的对话框中设置快照的**名称**和**描述**。

   <Notice type='note'>

   系统自动按 `<年>-<月>-<日>-<时>-<分>-<秒>.snapshot` 格式生成快照名称，您也可以自定义快照的名称。快照名称可包含任意字符，最长 30 个字符。

   </Notice>

3. 点击**创建**。快照创建后将显示在磁盘详情页面的快照列表中。

### 编辑快照信息

1. 在快照列表中，在需要编辑的快照右侧点击 <img src="/images/docs/ksv/management/disks/operation-menu.png" width='13'/>，然后在下拉列表中选择**编辑**。

2. 在弹出的对话框中修改快照的**名称**和**描述**，然后点击**确定**。有关更多信息，请参阅[创建磁盘快照](#创建磁盘快照)。

### 从快照还原磁盘

<Notice type='note'>

只允许还原未挂载到虚拟机的数据盘，系统盘和已挂载到虚拟机的数据盘不能还原。

</Notice>

1. 在快照列表中，在需要使用的快照右侧点击 <img src="/images/docs/ksv/management/disks/operation-menu.png" width='13'/>，然后在下拉列表中选择**还原磁盘**。

2. 在弹出的对话框中输入磁盘还原记录的名称，然后点击**确定**。

   <Notice type='warning'>

   此操作将覆盖磁盘中的数据，请谨慎执行此操作。

   </Notice>

### 查看和删除还原记录

1. 在快照列表中，在快照右下角点击**展开**可查看使用快照还原磁盘的记录。

2. 在需要删除的还原记录右侧点击 <img src="/images/docs/ksv/management/disks/operation-menu.png" width='13'/>，然后在下拉列表中选择**删除**。

3. 在弹出的对话框中点击**确定**可删除还原记录。

   <Notice type='warning'>

   磁盘还原记录删除后无法恢复，请谨慎执行此操作。

   </Notice>

### 删除磁盘快照

1. 在快照列表中，在需要删除的快照右侧点击 <img src="/images/docs/ksv/management/disks/operation-menu.png" width='13'/>，然后在下拉列表中选择**删除**。

2. 在弹出的对话框中点击**确定**可删除快照。

   <Notice type='warning'>

   快照删除后无法恢复，请谨慎执行此操作。

   </Notice>

### 删除磁盘

1. 在磁盘详情页面左上角点击**删除**。

2. 在弹出的对话框中点击**确定**可删除磁盘。

   <Notice type='note'>

   * 只支持手动删除数据盘。如需删除系统盘，您需要删除系统盘所属的虚拟机。
   * 如果数据盘已经挂载到虚拟机，需要先将数据盘从虚拟机卸载才能删除。有关如何卸载数据盘，请参阅[卸载数据盘](../vms/#卸载数据盘)。

   </Notice>

   <Notice type='warning'>

   磁盘删除后无法恢复，请谨慎执行此操作。

   </Notice>

介绍如何使用 KSV Web 控制台的磁盘功能。

磁盘


本节介绍如何使用 KubeSphere 虚拟化（KSV）Web 控制台的**项目**功能。

项目用于对资源进行分组管理。您可以将用户分配到项目中，并指定用户的角色以控制用户在项目中的权限。**项目**功能提供项目汇总列表和各项目的详情，并支持创建和删除项目、编辑项目信息、邀请和移除项目成员以及修改项目成员角色。

**项目**功能对所有用户可见。`admin` 用户可以查看系统中的所有项目并且可以对项目执行所有操作，其他具有不同角色的用户在**项目**功能中的权限如下：

<table border="1">
<tbody>
<tr>
  <th width='100'>用户</th>
  <th width='100'>项目角色</th>
  <th>权限</th>
</tr>
<tr>
  <td>普通用户</td>
  <td>管理员</td>
  <td>可以查看用户所属的项目并且可以执行除创建和删除项目之外的操作。</td>
</tr>
<tr>
  <td>普通用户</td>
  <td>操作员</td>
  <td>只能查看用户所属的项目，不能对项目执行操作。</td>
</tr>
<tr>
  <td>普通用户</td>
  <td>观察员</td>
  <td>只能查看用户所属的项目，不能对项目执行操作。</td>
</tr>
</tbody>
</table>



## 项目列表页面

### 查看项目列表

1. 以系统 `admin` 用户或属于至少一个项目的其他用户登录 KSV Web 控制台。有关更多信息，请参阅[用户](../users/)。

2. 在页面顶部的菜单栏中点击**项目**以打开项目列表页面。

   <Notice type='note'>

   对于 `admin` 用户，项目列表页面显示系统中所有的项目。对于其他用户，项目列表页面仅显示用户所属的项目。

   </Notice>

   项目列表展示当前用户所属的项目，并提供以下信息：

   <table border="1">
   <tbody>
   <tr>
     <th width='150'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <td>名称</td>
     <td>用户自定义的项目名称。</td>
   </tr>
   <tr>
     <td>别名</td>
     <td>用户自定义的项目别名。</td>
   </tr>
   <tr>
     <td>状态</td>
     <td>项目当前的状态，包括以下状态类型：<ul><li><img src ="/images/docs/ksv/management/projects/indicator-normal.png" width='8'/> <b>活跃</b>：项目状态正常。</li><li><img src ="/images/docs/ksv/management/projects/indicator-warning-flicker.gif" width='8'/> <b>结束中</b>：项目正在删除中。</li></ul></td>
   </tr>
   <tr>
     <td>CPU 用量</td>
     <td>项目中已使用的 CPU 核心数。</td>
   </tr>
   <tr>
     <td>内存用量</td>
     <td>项目中已使用的内存容量。</td>
   </tr>
   <tr>
     <td>创建者和创建时间</td>
     <td>项目的创建者和创建时间。</td>
   </tr>
   </tbody>
   </table>
   
4. （可选）点击项目列表上方的搜索框并设置搜索条件，可按名称搜索项目（例如，使用 `名称:ab` 搜索名称包含字符串 `ab` 的项目）。

5. （可选）在项目列表右上角点击 <img src="/images/docs/ksv/management/projects/refresh.png" width='15'/> 可刷新列表数据。

6. （可选）在项目列表右侧的**相关资源**区域，点击需要查看的资源类型可快速打开对应的资源列表页面。

### 创建项目

1. 在项目列表页面点击**创建**。

2. 在弹出的对话框中设置项目的**名称**、**别名**和**描述**。

   <table border="1">
   <tbody>
   <tr>
     <th width='150'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <td>名称</td>
     <td>用户自定义的项目名称。名称只能包含小写字母、数字和连字符（-），必须以小写字母或数字开头和结尾，最长 16 个字符。</td>
   </tr>
   <tr>
     <td>别名</td>
     <td>用户自定义的项目别名。别名可以包含任意字符，最长 63 个字符。</td>
   </tr>
   <tr>
     <td>描述</td>
     <td>用户自定义的项目描述。描述可以包含任意字符，最长 128 个字符。</td>
   </tr>
   </tbody>
   </table>

3. 点击**创建**。项目创建后将显示在项目列表中。

### 批量删除项目

1. 在项目列表页面，选择需要删除的项目名称左侧的复选框，然后在列表上方点击**删除**。

2. 在弹出的对话框中点击**确定**可批量删除多个项目。

   <Notice type='warning'>

   项目删除后无法恢复，同时项目中的所有虚拟机、镜像和磁盘也将一并删除，请谨慎执行此操作。

   </Notice>

## 项目详情页面

### 查看项目详情

1. 在项目列表页面，点击项目的名称可打开项目的详情页面。

2. （可选）在**虚拟资源**区域可查看当前项目中已创建的虚拟资源数量，包括 vCPU、内存、虚拟机、镜像和磁盘。

3. （可选）在项目详情页面下方的成员列表中可查看当前项目的成员信息。

### 编辑项目信息

1. 在项目详情页面左上角点击**编辑**。

2. 在弹出的对话框中修改项目的**名称**和**描述**，然后点击**确定**。有关更多信息，请参阅[创建项目](#创建项目)。

### 邀请和移除成员

1. 在项目详情页面左上角点击**邀请用户**。

2. 在弹出的对话框中，在需要邀请的用户右侧点击 <img src="/images/docs/ksv/management/projects/invite-user.png" width='70'/>，然后在下拉列表中选择用户在项目中的角色。有关不同项目角色在 KSV 各功能模块中的权限，请参阅各功能模块的管理指南。

   <Notice type='note'>

   `admin` 用户默认属于系统中的所有项目并在所有项目中具有`管理员`角色。

   </Notice>

3. 点击**确定**。用户被邀请至项目后将显示在项目详情页面的项目成员列表中。

4. 在项目成员右侧点击 <img src="/images/docs/ksv/management/projects/operation-menu.png" width='13'/>，然后在下拉列表中选择**移除成员**可移除项目成员。

### 修改成员角色

1. 在项目成员列表中，在项目成员右侧点击 <img src="/images/docs/ksv/management/projects/operation-menu.png" width='13'/>，然后在下拉列表中选择**修改角色**。

2. 在弹出的对话框中设置成员的角色，然后点击**确定**。有关不同项目角色在 KSV 各功能模块中的权限，请参阅各功能模块的管理指南。

### 删除项目

1. 在项目详情页面左上角点击**删除**。

2. 在弹出的对话框中输入项目名称，然后点击**确定**可删除项目。

   <Notice type='warning'>

   项目删除后无法恢复，同时项目中的所有虚拟机、镜像和磁盘也将一并删除，请谨慎执行此操作。

   </Notice>

介绍如何使用 KSV Web 控制台的项目功能。

项目


本节介绍如何使用 KubeSphere 虚拟化（KSV）Web 控制台的**告警**功能。

告警用于监控集群资源。您可以创建告警策略，并在告警策略触发后查看告警消息。**告警**功能提供告警消息汇总列表、告警策略汇总列表和告警策略的详情，并支持创建告警策略、删除告警策略以及编辑告警策略。

<Notice type='note'>

- **告警**功能仅对系统 `admin` 用户可见。如需使用**告警**功能，您需要以系统 `admin` 用户登录。
- 如需卸载**告警**功能，请参阅<a href='../ksv-assistant/#卸载告警'>卸载告警</a>。

</Notice>

## 告警消息列表页面

1. 以系统 `admin` 用户登录 KSV Web 控制台。

2. 在页面顶部的菜单栏中点击**告警**以打开告警消息列表页面。

   告警消息列表页面展示集群中的全部告警消息，并提供以下信息：

   <table border='1'>
     <tbody>
       <tr>
         <th width='150'>参数</th>
         <th>描述</th>
       </tr>
       <tr>
         <td>告警消息</td>
         <td>告警策略触发后自动生成的告警消息。</td>
       </tr>
       <tr>
         <td>告警状态</td>
         <td>告警的状态，包括以下状态类型：<ul><li><b>触发中</b>：告警满足告警规则的时间达到告警持续时间。</li></ul><ul><li><b>待触发</b>：告警满足告警规则的时间小于告警持续时间。</li></ul><ul><li><b>未触发</b>：告警未满足告警策略中的全部条件。</li></ul></td>
       </tr>
       <tr>
         <td>告警级别</td>
         <td>创建告警策略时，用户自定义的告警的严重程度。有关更多信息，请参阅<a href='#创建告警策略'>创建告警策略</a>。</td>
       </tr>
       <tr>
         <td>告警策略</td>
         <td>告警策略的名称。点击告警策略的名称可查看<a href='#告警策略详情页面'>告警策略详情页面</a>。</td>
       </tr>
       <tr>
         <td>监控目标</td>
         <td>告警的监控目标。</td>
       </tr>
       <tr>
         <td>告警激活时间</td>
         <td>告警的激活时间。</td>
       </tr>
     </tbody>
   </table>

3. （可选）点击告警消息列表上方的搜索框并设置搜索条件，可按告警状态或告警级别搜索告警消息（例如，使用`告警状态:触发中`搜索触发中的告警消息）。

4. （可选）在告警消息列表右上角点击 <img src='/images/docs/ksv/management/nodes/refresh.png' width='15px'/> 可刷新列表数据。

5. （可选）在告警消息列表右侧的**相关资源**区域，点击需要查看的资源类型可快速打开对应的资源列表页面。

## 告警策略列表页面

### 查看告警策略列表

1. 点击**告警策略**页签以打开告警策略列表页面。

   告警策略列表页面展示集群中所有的告警策略，并提供以下信息：

   <table border='1'>
     <tbody>
       <tr>
         <th width='150'>参数</th>
         <th>描述</th>
       </tr>
       <tr>
         <td>名称</td>
         <td>告警策略的名称。</td>
       </tr>
       <tr>
         <td>告警状态</td>
         <td>告警的状态，包括以下状态类型：<ul><li><b>触发中</b>：告警满足告警规则的时间达到告警持续时间。</li></ul><ul><li><b>待触发</b>：告警满足告警规则的时间小于告警持续时间。</li></ul><ul><li><b>未触发</b>：告警未满足告警策略中的全部条件。</li></ul></td>
       </tr>
       <tr>
         <td>告警级别</td>
         <td>创建告警策略时，用户自定义的告警的严重程度。有关更多信息，请参阅<a href='#创建告警策略'>创建告警策略</a>。</td>
       </tr>
       <tr>
         <td>告警激活时间</td>
         <td>告警的激活时间。</td>
       </tr>
     </tbody>
   </table>

2. （可选）点击告警策略列表上方的搜索框并设置搜索条件，可按名称、告警状态或告警级别搜索告警策略（例如，使用`名称:ab` 搜索名称包含字符串 `ab` 的告警策略）。

3. （可选）在告警策略列表右上角点击 <img src='/images/docs/ksv/management/nodes/refresh.png' width='15px'/> 可刷新列表数据。

4. （可选）在告警策略列表右侧的**相关资源**区域，点击需要查看的资源类型可快速打开对应的资源列表页面。

### 创建告警策略

1. 在告警策略列表页面点击**创建**。

2. 在**基本信息**页签，为即将创建的告警策略设置以下参数：

   <table border='1'>
     <tbody>
       <tr>
         <th width='200'>参数</th>
         <th>描述</th>
       </tr>
       <tr>
         <td>名称</td>
         <td>用户自定义的告警策略名称。名称只能包含小写字母、数字和连字符（-），必须以小写字母或数字开头和结尾，最长 16 个字符。</td>
       </tr>
       <tr>
         <td>别名（可选）</td>
         <td>告警策略的别名。别名可包含任意字符，最长 16 个字符。</td>
       </tr>
       <tr>
         <td>告警持续时间（分钟）</td>
         <td>告警的持续时间。告警满足告警规则的时间达到预设值后，告警将变为触发中状态。您可以从下拉框中选择告警持续时间，或者自定义告警持续时间。</td>
       </tr>
       <tr>
         <td>告警级别</td>
         <td>告警的严重程度，包括以下三个级别：<ul><li><b>危险告警</b>：提醒用户需要快速对告警问题进行处理。</li></ul><ul><li><b>重要告警</b>：提醒用户资源出现问题，但不需要采取特定行动。</li></ul><ul><li><b>一般告警</b>：提醒用户应该注意，但还没有造成特定问题。</li></ul></td>
       </tr>
       <tr>
         <td>描述（可选）</td>
         <td>用户自定义的告警策略描述信息。描述可包含任意字符，最长 128 个字符。</td>
       </tr>
     </tbody>
   </table>

3. 点击**下一步**。

4. 在**告警规则**页签，为告警策略设置告警规则，包含以下参数：

   <table border='1'>
     <tbody>
       <tr>
         <th width='200'>参数</th>
         <th>描述</th>
       </tr>
       <tr>
         <td>监控目标类别</td>
         <td>需要监控的目标类别。目前支持对<a href='../nodes'>节点</a>和<a href='../vms'>虚拟机</a>进行监控。</td>
       </tr>
       <tr>
         <td>监控目标</td>
         <td>需要进行监控的目标。您可以对一个或多个目标进行监控。</td>
       </tr>
       <tr>
         <td>告警规则</td>
         <td>为告警策略设置告警规则。根据监控目标类别的不同，支持的告警规则也有所不同。对于<b>节点</b>，可以对以下指标设置规则：<ul><li><b>CPU 利用率</b></li></ul><ul><li><b>可用内存</b></li></ul><ul><li><b>内存利用率</b></li></ul><ul><li><b>本地磁盘可用空间</b></li></ul><ul><li><b>本地磁盘空间利用率</b></li></ul><ul><li><b>本地磁盘读取 IOPS</b></li></ul><ul><li><b>本地磁盘写入 IOPS</b></li></ul><ul><li><b>本地磁盘读取吞吐量</b></li></ul><ul><li><b>本地磁盘写入吞吐量</b></li></ul>对于<b>虚拟机</b>，可以对以下指标设置规则：<ul><li><b>CPU 利用率</b></li></ul><ul><li><b>内存利用率</b></li></ul><ul><li><b>本地磁盘读取 IOPS</b></li></ul><ul><li><b>本地磁盘写入 IOPS</b></li></ul><ul><li><b>网络发送数据速率</b></li></ul><ul><li><b>网络接收数据速率</b></li></ul></td>
       </tr>
     </tbody>
   </table>

5. 点击**确定**。告警策略创建后将显示在告警策略列表中。

### 批量操作告警策略

1. 在告警策略列表页面，选择需要操作的告警策略名称左侧的复选框，然后在列表上方点击**删除**。

2. 在弹出的对话框中点击**确定**可批量删除告警策略。

   <Notice type='warning'>

   告警策略删除后无法恢复，请谨慎执行此操作。

   </Notice>

## 告警策略详情页面

在告警策略列表页面，点击告警策略的名称可打开告警策略的详情页面。

### 编辑告警策略信息

1. 在告警策略详情页面左上角点击**编辑**。
2. 在弹出的对话框中，编辑告警的**基本信息**和**告警规则**并点击**确定**。有关更多信息，请参阅<a href='#创建告警策略'>创建告警策略</a>。

### 删除告警策略

1. 在告警策略详情页面左上角点击**删除**。

2. 在弹出的对话框中点击**确定**可删除告警策略。

   <Notice type='warning'>

   告警策略删除后无法恢复，请谨慎执行此操作。

   </Notice>

介绍如何使用 KSV Web 控制台的告警功能。

告警


本节介绍如何使用 KubeSphere 虚拟化（KSV）Web 控制台的**日志**功能。

日志包括系统日志和操作日志，系统日志收集系统中的日志数据，操作日志可以用于查看用户的操作记录。**日志**功能提供系统日志汇总列表、各系统日志的详情、操作日志汇总列表和各操作日志的详情，并支持查看实时系统日志和导出系统日志文件到本地。

<Notice type='note'>

- 如需卸载**日志**功能，请参阅<a href='../ksv-assistant/#卸载日志'>卸载日志</a>。
- **日志**功能仅对系统 `admin` 用户可见。如需使用**日志**功能，您需要以系统 `admin` 用户登录。
- 日志的默认保留期限为 `7` 天。

</Notice>

## 操作日志列表页面

1. 以系统 `admin` 用户登录 KSV Web 控制台。

2. 在页面顶部的菜单栏中点击**日志**以打开操作日志列表页面。

   操作日志列表展示集群中所有的操作日志，并提供以下信息：

   <table>
   <tbody>
   <tr>
   <th width="200">参数</th>
   <th>描述</th>
   </tr>
   <tr>
   <td>时间</td>
   <td>操作日志的记录时间。</td>
   </tr>
   <tr>
   <td>操作行为</td>
   <td>对给定资源所执行的操作。</td>
   </tr>
   <tr>
   <td>状态</td>
   <td>服务器对浏览器请求作出的响应状态。</td>
   </tr>
   <tr>
   <td>项目</td>
   <td>被操作的资源所在的项目。</td>
   </tr>
   <tr>
   <td>资源类型与名称</td>
   <td>被操作的资源的类型与名称。</td>
   </tr>
   <tr>
   <td>操作者</td>
   <td>对资源进行操作的用户。</td>
   </tr>
   </tbody>
   </table>

3. （可选）点击操作日志列表上方的搜索框并设置搜索条件，可按项目、操作行为或时间范围搜索操作日志（例如，使用`项目:default` 搜索 `default` 项目中的操作日志）。
4. （可选）在操作日志列表右上角点击 <img src="/images/docs/ksv/management/images/refresh.png" width='15'/> 可刷新列表数据。
5. （可选）在操作日志列表右侧的**相关资源**区域，点击需要查看的资源类型可快速打开对应的资源列表页面。

## 操作日志详情页面

点击操作日志列表中的日志条目可查看该条操作日志的详情，包括：

- **源 IP 地址**：访问资源的机器的 IP 地址。
- **原因**：HTTP 请求失败的原因。

  <Notice type='note'>

  有关其他参数的更多信息，请参阅<a href='#操作日志列表页面'>操作日志列表页面</a>。

  </Notice>

## 系统日志列表页面

1. 点击**系统日志**页签以打开系统日志列表页面。

   系统日志列表页面展示系统中的日志数据，并提供以下信息：

   <table border='1'>
     <tbody>
       <tr>
         <th width='150'>参数</th>
         <th>描述</th>
       </tr>
       <tr>
         <td>组件名称</td>
         <td>KSV 集群中各个组件的名称。组件包括 KSV Web 控制台上的项目和后台的系统组件。</td>
       </tr>
       <tr>
         <td>时间</td>
         <td>记录该日志条目的时间。</td>
       </tr>
       <tr>
         <td>消息</td>
         <td>各个组件返回的日志消息。</td>
       </tr>
     </tbody>
   </table>

3. （可选）点击系统日志列表上方的搜索框并设置搜索条件，可按关键字、组件名称或时间范围搜索系统日志（例如，使用`关键字:error` 搜索包含字符串 `error` 的日志条目）。
4. （可选）在系统日志列表右上角点击 <img src='/images/docs/ksv/management/nodes/refresh.png' width='15px'/> 可刷新列表数据。
5. （可选）在系统日志列表右侧的**相关资源**区域，点击需要查看的资源类型可快速打开对应的资源列表页面。

## 系统日志详情页面

1. 在系统日志列表页面，点击日志条目可打开系统日志的详情页面。

2. （可选）点击左上角的 <img src='/images/docs/ksv/management/logs/time-range.png' width='15px'/>。在弹出的对话框中选择时间范围或自定义时间范围，点击**确定**，可查看特定时间范围内的系统日志。

3. （可选）点击上方的 <img src='/images/docs/ksv/management/logs/clear.png' width='15px'/> 可清空当前搜索框中的日志。点击上方的搜索框并输入关键字，可按关键字搜索日志（例如，输入 `failed` 搜索名称包含字符串 `failed` 的系统日志）。

4. （可选）点击上方的 <img src='/images/docs/ksv/management/logs/start.png' width='15px'/>/<img src='/images/docs/ksv/management/logs/stop.png' width='15px'/> 开始或停止查看实时系统日志。点击 <img src='/images/docs/ksv/management/logs/refresh-rate.png' width='15px'/> 并设置刷新频率可按照刷新频率刷新实时系统日志。

5. （可选）点击上方的 <img src='/images/docs/ksv/management/logs/export.png' width='15px' height='15px'/> 以 `.txt` 格式导出当前页面的系统日志。





介绍如何使用 KSV Web 控制台的日志功能。

日志


本节介绍如何使用 KubeSphere 虚拟化（KSV）Web 控制台的**用户**功能。

用户可以被分配到项目中并根据用户的项目角色获得不同的权限。**用户**功能提供用户汇总列表和各用户的详情，并支持创建和删除用户、编辑用户信息以及修改用户密码。

<Notice type='note'>

**用户**功能仅对系统 `admin`  用户可见。如需使用**用户**功能，您需要以系统 `admin` 用户登录。

</Notice>

## 用户列表页面

### 查看用户列表

1. 以系统 `admin` 用户登录 KSV Web 控制台。

2. 在页面右上角点击 <img src="/images/docs/ksv/management/users/set-login-user.png" width='13'/>，然后点击**用户管理**以打开用户列表页面。

   用户列表展示系统中所有的用户，并提供以下信息：

   <table border="1">
   <tbody>
   <tr>
     <th width='150'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <td>名称</td>
     <td>用户的名称。</td>
   </tr>
   <tr>
     <td>邮箱</td>
     <td>用户的邮箱地址。邮箱地址可用于登录 KSV Web 控制台。</td>
   </tr>
    <tr>
     <td>项目 / 角色</td>
     <td>用户所属的项目和用户在项目中的角色。</td>
   </tr>
   <tr>
     <td>状态</td>
     <td>用户当前的状态，包括以下状态类型：<ul><li><img src ="/images/docs/ksv/management/users/indicator-normal.png" width='8'/> <b>活跃</b>：用户状态正常。</li><li><img src ="/images/docs/ksv/management/users/indicator-critical.png" width='8'/> <b>多次登录失败</b>：用户在 10 分钟内连续登录失败次数大于或等于 5 次。</li></ul></td>
   </tr>
   <tr>
     <td>最后登录时间</td>
     <td>用户最后一次登录 Web 控制台的时间。</td>
   </tr>
   <tr>
     <td>创建者</td>
     <td>用户的创建者。目前只有 <code>admin</code> 用户可以创建用户。</td>
   </tr>
   <tr>
     <td>创建时间</td>
     <td>用户的创建时间。</td>
   </tr>
   </tbody>
   </table>
   
3. （可选）点击用户列表上方的搜索框并设置搜索条件，可按名称搜索用户（例如，使用`名称:ab` 搜索名称包含字符串 `ab` 的用户）。

4. （可选）在用户列表右上角点击 <img src="/images/docs/ksv/management/users/refresh.png" width='15'/> 可刷新列表数据。

5. （可选）在用户列表右侧的**相关资源**区域，点击需要查看的资源类型可快速打开对应的资源列表页面。

### 创建用户

1. 在用户列表页面点击**创建**。

2. 在弹出的对话框中设置用户的信息。

   <table border="1">
   <tbody>
   <tr>
     <th width='150'>参数</th>
     <th>描述</th>
   </tr>
   <tr>
     <td>用户名</td>
     <td>用户的名称。用户名只能包含小写字母、数字和连字符（-），必须以小写字母或数字开头和结尾，最长 16 个字符。</td>
   </tr>
   <tr>
     <td>邮箱</td>
     <td>用户的邮箱地址。邮箱地址可用于登录 KSV Web 控制台。</td>
   </tr>
   <tr>
     <td>密码</td>
     <td>用户的密码。密码必须包含数字、大写字母和小写字母，长度为 6 至 64 字符。</td>
   </tr>
   <tr>
     <td>项目（可选）</td>
     <td>用户所属的项目。如果创建用户时没有设置用户所属的项目，用户登录 Web 控制台后将无法查看和操作任何资源。您可以在用户创建后手动将用户邀请到项目中。有关更多信息，请参阅<a href='../projects/#邀请和移除成员'>邀请和移除成员</a>。</td>
   </tr>
   <tr>
     <td>角色（可选）</td>
     <td>用户在项目中的角色。有关不同项目角色在 KSV 各功能模块中的权限，请参阅各功能模块的管理指南。</td>
   </tr>
   <tr>
     <td>描述（可选）</td>
     <td>用户自定义的项目描述信息。描述可包含任意字符，最长 128 个字符。</td>
   </tr>
   </tbody>
   </table>

3. 点击**确定**。用户创建后将显示在用户列表中。

### 批量删除用户

1. 在用户列表页面，选择需要删除的用户名称左侧的复选框，然后在列表上方点击**删除**。

2. 在弹出的对话框中点击**确定**可批量删除多个用户。

   <Notice type='warning'>

   用户删除后无法恢复，请谨慎执行此操作。

   </Notice>

## 用户详情页面

### 查看用户详情

1. 在用户列表页面，点击用户的名称可打开用户的详情页面。
2. （可选）在**项目**区域可查看用户所属的项目，包括项目名称、描述、用户在项目中的角色和用户的状态。
2. （可选）在**登录历史**区域可查看用户的登录历史记录，包括登录时间、是否登录成功、源 IP 地址和描述信息。

### 编辑用户信息

1. 在用户详情页面左上角点击**编辑**。
2. 在弹出的对话框中修改用户的**邮箱**和**描述**，然后点击**确定**。有关更多信息，请参阅[创建用户](#创建用户)。

### 修改密码

1. 在用户详情页面左上角点击**修改密码**。
2. 在弹出的对话框输入新密码，重复输入新密码，然后点击**确定**。

   <Notice type='note'>

   密码必须包含数字、大写字母和小写字母，长度为 6 至 64 字符。

   </Notice>

### 删除用户

1. 在用户详情页面左上角点击**删除**。
2. 在弹出的对话框中点击**确定**。

   <Notice type='note'>

   `admin` 用户无法删除。

   </Notice>

   <Notice type='warning'>

   用户删除后无法恢复，请谨慎执行此操作。

   </Notice>

用户


本节介绍如何使用 KubeSphere 虚拟化（KSV）Web 控制台的 **KSV 助手**功能。

KSV 助手用于显示资源操作进度。**KSV 助手**中显示镜像上传的进度、镜像复制的进度以及添加节点的进度。

**KSV 助手**功能对所有用户可见，不同用户可以在 **KSV 助手**中查看自己所进行的资源操作的进度。

## 操作进度

### 查看镜像进度

1. 以系统 `admin` 用户或属于至少一个项目的其他用户登录 KSV Web 控制台。有关更多信息，请参阅[用户](../users/)。

2. 点击页面右下角的 **KSV 助手**以打开 KSV 助手的页面。

3. 点击**操作进度**，然后选择**镜像**以查看镜像的操作进度。

   <Notice type='note'>

   您需要先上传镜像或者复制镜像才能查看镜像的操作进度。有关更多信息，请参阅[创建镜像](../images/#创建镜像)。

   </Notice>

   操作进度列表展示当前用户进行的所有镜像操作的进度，并提供以下信息：

   <table border='1'>
     <tbody>
       <tr>
         <th>参数</th>
         <th>描述</th>
       </tr>
       <tr>
         <td>镜像状态</td>
         <td>镜像当前的状态，包括以下状态类型：<ul><li><b>镜像上传中</b>：镜像正在上传中。</li></ul><ul><li><b>镜像复制中</b>：镜像正在等待创建。</li></ul>如果镜像状态异常，镜像状态右侧将显示消息：<b>错误</b>。</td>
       </tr>
       <tr>
         <td>镜像名称</td>
         <td>显示正在复制中的镜像的名称。对于正在上传中的镜像，则不会显示镜像名称。</td>
       </tr>
       <tr>
         <td>进度</td>
         <td>镜像的操作进度。</td>
       </tr>
     </tbody>
   </table>

4. 点击进度条右侧的 **×** 可删除上传或复制的镜像。

   <Notice type='warning'>

   镜像删除后无法恢复，请谨慎执行此操作。

   </Notice>

### 查看节点进度

1. 以系统 `admin` 用户登录 KSV Web 控制台。有关更多信息，请参阅[用户](../users/)。

2. 点击页面右下角的 **KSV 助手**以打开 KSV 助手的页面。

3. 点击**操作进度**，然后选择**节点**以查看节点的操作进度。

   <Notice type='note'>

   您需要先添加节点才能查看节点的操作进度。有关更多信息，请参阅[添加节点](../nodes/#添加节点)。

   </Notice>

   操作进度列表展示当前用户进行的所有节点操作的进度，并提供以下信息：

   <table border='1'>
     <tbody>
       <tr>
         <th>参数</th>
         <th>描述</th>
       </tr>
       <tr>
         <td>节点状态</td>
         <td>节点当前的状态，包括以下状态类型：<ul><li><b>节点准备中</b>：节点正在准备创建。</li></ul><ul><li><b>节点创建中</b>：节点正在创建中。</li></ul>如果节点状态异常，节点状态右侧将显示状态消息：<b>错误</b>。</td>
       </tr>
   <tr>
     <td>节点名称</td>
     <td>正在添加中的节点的名称。如果同时添加多个节点，系统将自动在不同节点的名称后增加序列号。</td>
   </tr>
       <tr>
         <td>进度</td>
         <td>节点的操作进度。</td>
       </tr>
     </tbody>
   </table>

  <Notice type='note'>

  添加节点时，该进程不能暂停或删除。

  </Notice>

## 可选功能

### 安装告警

1. 以 `root` 用户登录安装 KSV 的服务器节点。

2. 执行以下命令安装告警：
     ```bash
     kubectl -n kubesphere-system patch cc ks-installer --type merge --patch '{"spec":{"alerting":{"enabled":true}}}'
     ```

3. （可选）执行以下命令查看安装日志：

   ```bash
   ksv logs
   ```

### 卸载告警

1. 登录安装 KSV 的服务器节点。

2. 执行以下命令停用告警：

   ```bash
   kubectl -n kubesphere-system patch cc ks-installer --type merge --patch '{"spec":{"alerting":{"enabled":false}}}'
   ```

### 安装日志

1. 以 `root` 用户登录安装 KSV 的服务器节点。

2. 执行以下命令安装日志：

     ```bash
     kubectl -n kubesphere-system patch cc ks-installer --type merge --patch '{"spec":{"logging":{"enabled":true},"auditing":{"enabled":true}}}'
     ```
   
3. （可选）执行以下命令查看安装日志：

   ```bash
   ksv logs
   ```

### 卸载日志

1. 登录安装 KSV 的服务器节点。

2. 执行以下命令停用日志：

   ```bash
   kubectl -n kubesphere-system patch cc ks-installer --type merge --patch '{"spec":{"logging":{"enabled":false},"auditing":{"enabled":false}}}'
   ```


介绍如何使用 KSV Web 控制台的 KSV 助手功能。

KSV 助手

介绍如何使用 KSV Web 控制台管理虚拟机相关资源和查看资源状态。

管理指南


本节介绍如何查看 KubeSphere 虚拟化（KSV）用户许可协议、激活 KSV 和查看许可证信息。

KSV 目前提供以下许可证类型：

* 试用版许可证：KSV 安装后处于未激活状态，许可证默认为试用版许可证。允许用户对最多部署 3 个节点、最多创建 9 台虚拟机。试用版许可证不限制有效期。
* 商业版许可证：您可以购买商业版许可证并使用激活码对 KSV 进行激活。除根据您的实际购买情况限定资源管理规模和有效期外，商业版许可证提供 KSV 的全部功能。

## 查看用户许可协议

1. 登录 KSV Web 控制台，在页面右上角点击 <img src='/images/docs/ksv/license/set-login-user.png' width='15'/>，然后在下拉列表中点击**关于 KSV**。

2. 在弹出的对话框中点击**《最终用户软件许可协议》**可查看 KSV 用户许可协议。

   <Notice type='note'>

   如果您已下载、复制、安装或以其他任何方式使用 KSV 软件，则视为已经接受《最终用户软件许可协议》。为了使用 KSV 软件，请您务必审慎阅读、充分理解《最终用户软件许可协议》各条款内容。

   </Notice>

## 激活 KSV 和查看许可证信息

1. 以 `admin` 用户登录 KSV Web 控制台，在页面右上角点击 <img src='/images/docs/ksv/license/set-login-user.png' width='15'/>，然后在下拉列表中点击**激活**。

   <Notice type='note'>

   您必须以 `admin` 用户登录才能激活 KSV。

   </Notice>

2. 在**激活**对话框，复制**集群 ID** 并提供给 KSV 的技术支持团队。

   <img src='/images/docs/ksv/license/activation-zh.png' width='400'/>

2. 在**激活**对话框，输入激活码，然后点击**提交**可对 KSV 进行激活。

   激活成功后，**激活**对话框中将显示当前许可证的相关信息。下表介绍 KSV 许可证的相关参数：

   <table>
     <thead>
       <tr>
         <th width='200'>参数</th><th>描述</th>
       </tr>
     </thead>
     <tbody>
       <tr>
         <td>集群 ID</td><td>许可证对应的集群的 ID。每个 KSV 激活码都与特定的集群绑定，如果激活码与集群 ID 不匹配则 KSV 无法激活成功。</td>
       </tr>
       <tr>
         <td>授权用户</td><td>许可证授予的用户的名称。</td>
       </tr>
       <tr>
         <td>CPU 数量上限</td><td>许可证允许虚拟化的 CPU 数量。根据用户的实际购买情况，每个商业版许可证都支持对特定数量的 CPU 进行虚拟化。</td>
       </tr>
       <tr>
         <td>签发时间</td><td>许可证的签发时间。许可证的有效期从许可证的签发时间而非 KSV 的激活时间开始计算。许可证到期后，无论许可证是否已经用于激活 KSV，许可证都将失效。</td>
       </tr>
       <tr>
         <td>到期时间</td><td>许可证的到期时间。商业版许可证到期后将自动转变为试用版许可证。</td>
       </tr>
     </tbody>
   </table>

3. 在页面顶部的菜单栏中点击**概览**以打开**概览**页面。
   
   **概览**页面右上角显示许可证状态。下图为许可证状态的示例：
   
   <img src='/images/docs/ksv/license/license-status-zh.png' width='400'/>
   
   下表介绍许可证的各类状态：
   
   <table>
     <thead>
       <tr>
         <th width='250'>状态</th><th>描述</th>
       </tr>
     </thead>
     <tbody>
       <tr>
         <td>无状态信息</td><td>KSV 已激活成功且当前时间距许可证到期时间超过 30 天。</td>
       </tr>
       <tr>
         <td>未激活</td><td>KSV 未激活，当前许可证为试用版许可证。</td>
       </tr>
       <tr>
         <td>许可证无效</td><td>当前使用的激活码无效，激活失败。</td>
       </tr>
       <tr>
         <td>CPU 数量超出许可上限</td><td>集群中实际存在的 CPU 数量超出许可证允许虚拟化的 CPU 数量上限。</td>
       </tr>
       <tr>
         <td>许可证和集群不匹配</td><td>当前使用的激活码与安装 KSV 的集群不匹配，激活失败。</td>
       </tr>
       <tr>
         <td>许可证到期时间：&lt;年&gt;-&lt;月&gt;-&lt;日&gt;</td><td>许可证的到期时间。当前时间距许可证到期时间不足 30 天时将显示此状态消息。</td>
       </tr>
       <tr>
         <td>许可证已到期</td><td>当前许可许证已到期。商业版许可证到期后将转变为试用版许可证。</td>
       </tr>
     </tbody>
   </table>





介绍如何查看 KSV 用户许可协议、激活 KSV 和查看许可证信息。

软件许可证

本节汇总 KubeSphere 虚拟化（KSV）平台的常见问题。

- [底层原理](#底层原理)
- [安装注意事项](#安装注意事项)
- [问题排查](#问题排查)
  
  - [安装 KSV 时，OpenSSL 出现报错信息该如何处理？](#安装-ksv-时，openssl-出现报错信息该如何处理？)
  - [安装 KSV 时，磁盘出现报错信息该如何处理？](#安装-ksv-时，磁盘出现报错信息该如何处理？)
  - [安装 KSV 时，CoreDNS 无法正常运行该如何处理？](#安装-ksv-时，coredns-无法正常运行该如何处理？)
  - [安装 KSV 时，进度流程卡在 MinIO 该如何处理？](#安装-ksv-时，进度流程卡在-minio-该如何处理？)
  - [安装 KSV 时，为什么提示服务器不支持虚拟化？](#安装-ksv-时，为什么提示服务器不支持虚拟化？)
  - [如何重置用户密码？](#如何重置用户密码？)
  - [如何创建 IP 池？](#如何创建-ip-池？)
  - [为什么虚拟机状态消息一直显示为等待资源中？](#为什么虚拟机状态消息一直显示为等待资源中？)
  - [为什么虚拟机状态消息一直显示为调度错误？](#为什么虚拟机状态消息一直显示为调度错误？)
  - [KSV 支持上传哪些格式的镜像文件？](#ksv-支持上传哪些格式的镜像文件？)
  - [镜像文件较大时，可以使用其他方式上传吗？](#镜像文件较大时，可以使用其他方式上传吗？)
  - [为什么挂载的磁盘没有生效？](#为什么挂载的磁盘没有生效？)
  - [KSV 平台能否对接第三方存储？](#ksv-平台能否对接第三方存储？)
  - [如何设置统一的外网出口？](#如何设置统一的外网出口？)

## 底层原理

KSV 的底层原理描述如下表所示：

<table border='1'>
  <tbody>
    <tr>
    <th width='100'>名称</th>
    <th>描述</th>
    </tr>
    <tr>
    <td>虚拟机</td>
    <td>KSV 底层使用 KubeVirt 插件，支持对虚拟机的生命周期管理、状态管理和连接管理。</td>
    </tr>
    <tr>
    <td>网络</td>
    <td>KSV 底层使用 Multus 插件，在节点网卡上创建 MacVTap（用于简化虚拟化桥接网络的设备驱动程序）作为虚拟机的网卡。通过设置 IP 池，虚拟机可以与服务器节点在同一个网段中，方便用户的访问。</td>
    </tr>
    <tr>
    <td>镜像</td>
    <td>KSV 底层使用 CDI 插件将镜像导入到持久卷中，通过持久卷的克隆实现系统盘创建。</td>
    </tr>
    <tr>
    <td>存储</td>
      <td>KSV 支持与 Kubernetes 的 CSI 插件联动，实现存储相关资源的管理。</td>
    </tr>
  </tbody>
</table>

## 安装注意事项

安装 KSV 之前，请阅读并遵循以下注意事项：
- 为服务器设置默认路由（网关）。
- 安装前，建议使用以下脚本清理为 Ceph 预留的磁盘。执行时请注意替换脚本中的盘符。清理完成后，请重启服务器。
  ```bash
  DISK="/dev/sdX" 
 
  # Zap the disk to a fresh, usable state (zap-all is important, b/c MBR has to be clean)
  sgdisk --zap-all $DISK
 
  # Wipe a large portion of the beginning of the disk to remove more LVM metadata that may be present
  dd if=/dev/zero of="$DISK" bs=1M count=100 oflag=direct,dsync
 
  # SSDs may be better cleaned with blkdiscard instead of dd
  blkdiscard $DISK
 
  # Inform the OS of partition table changes
  partprobe $DISK
  ```
- 若条件允许或当前环境为生产环境，建议在 etcd 中使用 SSD 盘。默认 etcd 的数据目录为 `/var/lib/etcd`。
- 若系统盘空间较小或当前环境为生产环境，建议在 `/var/lib/rancher` 目录下挂载 100 GB 及以上的硬盘。

## 问题排查

### 安装 KSV 时，OpenSSL 出现报错信息该如何处理？


#### 问题描述
安装 KSV 时，OpenSSL 出现如下报错信息：
  ```bash
  error: openssl: /usr/lib/x86_64-linux-gnu/libssl.so.1.1: version `OPENSSL_1_1_1' not found (required by openssl)
  openssl: /usr/lib/x86_64-linux-gnu/libcrypto.so.1.1: version `OPENSSL_1_1_1' not found (required by openssl)
  : exit status 1 
  ```

  此问题是由于系统软件版本过低导致。
  

#### 解决方案
执行命令 `apt update` 和 `apt upgrade` 更新系统软件包，更新完成后重新安装 KSV 即可。

### 安装 KSV 时，磁盘出现报错信息该如何处理？


#### 问题描述
安装 KSV 时，磁盘出现报错信息，导致 KSV 安装失败。


#### 解决方案
1. 执行以下脚本，清理 Ceph 磁盘：
      ```bash
      DISK="/dev/sdX"

      # Zap the disk to a fresh, usable state (zap-all is important, b/c MBR has to be clean)
      sgdisk --zap-all $DISK

      # Wipe a large portion of the beginning of the disk to remove more LVM metadata that may be present
      dd if=/dev/zero of="$DISK" bs=1M count=100 oflag=direct,dsync

      # SSDs may be better cleaned with blkdiscard instead of dd
      blkdiscard $DISK

      # Inform the OS of partition table changes
      partprobe $DISK
      ```
2. 脚本执行完成后，重新安装 KSV。

### 安装 KSV 时，CoreDNS 无法正常运行该如何处理？


#### 问题描述
安装 KSV 时，CoreDNS 运行出错，不处于 `Running` 状态。


#### 解决方案
1. 执行 `kubectl get pod -n kube-system` 查看 CoreDNS 的状态。若 CoreDNS 的状态不是 `Running`，则需要修改 CoreDNS 的配置。
2. 执行 `kubectl edit cm -n kube-system coredns` 修改 CoreDNS 的配置。
3. 将配置项 `forward . /etc/resolv.conf` 修改为 `forward . 8.8.8.8`。修改完成后，保存并退出。
4. 执行 `kubectl rollout restart deploy -n kube-system coredns` 重启 CoreDNS。

### 安装 KSV 时，进度流程卡在 MinIO 该如何处理？


#### 问题描述
安装流程卡在 MinIO，导致 KSV 安装失败。本问题一般是由于 CoreDNS 或存储异常导致，可检查环境中 CoreDNS 和存储的状态进行问题排查。请注意，存储系统应该为裸设备或裸分区，即未分区或未格式化的存储系统。


#### 解决方案
1. 执行 `ksv logs` 查看日志信息。若是由于 MinIO 导致的安装失败，会返回如下信息：
   ```bash
   1. check the storage configuration and storage server
   2. make sure the DNS address in /etc/resolv.conf is available
   3. execute 'kubectl logs -n kubesphere-system -l job-name=minio-make-bucket-job' to watch logs
   4. execute 'helm -n kubesphere-system uninstall ks-minio && kubectl -n kubesphere-system delete job minio-make-bucket-job'
   5. Restart the installer pod in kubesphere-system namespace
   ```
2. 检查 CoreDNS 状态。若 CoreDNS 状态异常，可参考 [安装 KSV 时，CoreDNS 无法正常运行该如何处理](#安装-ksv-时，coredns-无法正常运行该如何处理？) 进行问题排查。
3. 检查存储状态。若存储状态异常，执行以下操作进行问题排查：
   1. 执行 `kubectl get pod -n rook-ceph` 查看 Ceph 组件状态。
   2. 检查是否存在 `rook-ceph-osd-x-xxxxx` 相关的 pod。若存在，检查 pod 是否处于 `Running` 状态。
   3. 若上述步骤中不存在处于 `Running` 状态的 pod，请确定服务器是否为 Ceph 预留了未格式化的磁盘。
   4. 如果存在满足上述要求的磁盘，执行 [安装注意事项](#安装注意事项) 中的脚本对磁盘进行清理。磁盘清理完成后，重启服务器。
  
### 安装 KSV 时，为什么提示服务器不支持虚拟化？


#### 问题描述
安装 KSV 时，系统返回如下信息，提示安装程序未识别到服务器虚拟化支持：
  ```bash
  Some nodes do not support virtualization. KSV will run in emulation mode. The emulation mode may occupy more resources and may affect performance.
  ```

目前发现某些国产 ARM64 CPU 服务器无法识别服务器虚拟化，但其虚拟化是正常且可使用的。由于安装时开启的是模拟虚拟化，导致创建虚拟机失败。


#### 解决方案
1. 编辑集群配置文件 `kubectl edit cc -n kubesphere-system ks-installer`，将配置 `spec.virtualization` 中的 `useEmulation` 设置为 `false`。
2. 保存并退出，查看日志，等待运行完成即可。

### 如何重置用户密码？
  1. 登录服务器节点。

  2. 执行以下命令重置用户的密码：

     ```bash
     kubectl patch users <用户名> -p '{"spec":{"password":"<新的密码>"}}' --type='merge' && kubectl annotate users <用户名> iam.kubesphere.io/password-encrypted-
     ```

     <Notice type='note'>

     - 您需要将命令中的`<用户名>`参数替换为实际的用户名，将`<新的密码>`参数修改为新的密码。
     - 建议在新的密码中包含数字、大写字母和小写字母，长度设置为 6 至 64 个字符。

     </Notice>

### 如何创建 IP 池？

以下视频演示如何在 KSV Web 控制台创建 IP 池：

<video src="/videos/docs/ksv/create-an-ip-pool.mp4" controls></video>


### 为什么虚拟机状态消息一直显示为等待资源中？

  **等待资源中**意味着系统正在等待创建虚拟机所需的资源。您可以查看对应的磁盘是否创建成功。磁盘创建失败通常是因为设置的容量过大，这时可以删除虚拟机，在重新创建虚拟机时降低磁盘容量大小。

### 为什么虚拟机状态消息一直显示为调度错误？

  **调度错误**意味着虚拟机调度失败，可能原因及解决方法如下：

  <table border='1'>
    <tbody>
      <tr>
      <th width='220'>可能原因</th>
      <th>解决方法</th>
      </tr>
      <tr>
      <td>虚拟机 CPU 或内存参数设置过大，导致虚拟机调度失败。</td>
      <td>您可以删除虚拟机，并在重新创建虚拟机时降低 CPU 或内存大小。</td>
      </tr>
      <tr>
      <td>某些服务器节点不支持虚拟化。</td>
        <td>使用 <code>root</code> 用户登录任意服务器节点，执行 <code>grep -E '(svm|vmx)' /proc/cpuinfo</code> 命令，若无回显则不支持虚拟化。</td>
      </tr>
      <tr>
      <td>选择的 IP 池与实际环境不符合，导致虚拟机调度失败。</td>
        <td>预置的 IP 池所设置的网卡名为 <code>eth0</code>，如果机器网卡名称不同，则需要重新创建 IP 池，并设置物理网卡为服务器节点的实际网卡名。在创建虚拟机时选择正确的 IP 池。</td>
      </tr>
    </tbody>
  </table>

### KSV 支持上传哪些格式的镜像文件？

  KSV 支持上传 IMG、QCOW2、XZ、TAR、GZ、ISO 和 RAW 格式的镜像文件。如果服务器节点有外部访问权限，也支持 HTTP 方式上传镜像文件。

### 镜像文件较大时，可以使用其他方式上传吗？

  KSV 支持从本地或通过 URL 上传镜像。当镜像文件较大时，也支持 FTP 上传。


#### 解决方案

1. 以 `root` 用户登录集群中的任意服务器节点。

2. 执行以下命令获取 FTP 登录的用户名和密码：

   ```bash
   ksv ftp-server
   ```

3. 执行以下命令 FTP 连接集群中的任意服务器节点：

   ```bash
   ftp <节点 IP 地址>
   ```

   <Notice type='note'>

   您需要将`<节点 IP 地址>`替换为您自己的服务器节点 IP 地址。

   </Notice>

4. 使用步骤 2 返回的用户名和密码登录 FTP 服务器。

5. 执行以下命令将本地镜像文件上传到 FTP 服务器：

   ```bash
   put <本地镜像文件路径>
   ```

   例如：

   ```bash
   put /pitrix/img/ubuntu_16.04_LTS_server-cloudimg-amd64.img
   ```

6. 在 KSV Web 控制台的**上传镜像**页面，通过 URL `http://minio.kubesphere-system.svc:9000/qingcloud-images/ubuntu_16.04_LTS_server-cloudimg-amd64.img` 上传镜像。

   <Notice type='note'>

   您需要将`<本地镜像文件路径>`替换成您自己的本地镜像文件路径，将 `ubuntu_16.04_LTS_server-cloudimg-amd64.img` 替换为将要上传的镜像文件名称。

   </Notice>

### 为什么挂载的磁盘没有生效？

  对于单独创建的磁盘，第一次进行动态挂载时，需要重启虚拟机才能生效。后续的热插拔则无须重启虚拟机。

### KSV 平台能否对接第三方存储？

可以对接。第三方的存储服务器需要支持 CSI 接口，若支持 CSI 接口，青云可以根据第三方的 CSI 接口规则进行适配和测试。

### 如何设置统一的外网出口？


#### 操作场景

在多节点集群中，只开放了一台节点服务器用于外网访问，其他节点服务器上的虚拟机需要通过已开放外网的节点服务器访问外网。


#### 原理说明

已开放外网的节点服务器有两张网卡（例如，`网卡 A` 和`网卡 B`），`网卡 A` 只连接内网。在 KSV 的 IP 池中使用`网卡 A` 创建内网网络，通过以下命令将内网的 IP 地址转换为`网卡 B` 的 IP 地址用于外网访问。


#### 解决方案

1. 使用 `root` 用户登录已开放外网的节点服务器。

2. 执行以下命令：

   ```bash
   iptables -t nat -A POSTROUTING -s <内网网段> -o <网卡 B 名称> -j MASQUERADE
   ```

   您需要将`<内网网段>`和`<网卡 B 名称>`替换为您自己的网段和网卡名称，例如：

   ```bash
   iptables -t nat -A POSTROUTING -s 192.168.0.0/16 -o eno2 -j MASQUERADE
   ```

3. 登录需要访问外网的节点服务器，执行以下命令：

   ```bash
   ip r add default via <内网地址>
   ```

   您需要将`<内网地址>`替换为已开放外网访问的节点服务器的内网 IP 地址，例如：

   ```bash
   ip r add default via 192.168.0.1
   ```

常见问题


<table>
  <tbody>
    <tr>
      <td width='200'>AI</td>
      <td width='300'>Artificial Intelligence</td>
      <td>人工智能</td>
    </tr>
    <tr>
      <td>CIDR</td>
      <td>Classless Inter-Domain Routing</td>
      <td>无类别域间路由</td>
    </tr>
    <tr>
      <td>CPU</td>
      <td>Central Processing Unit</td>
      <td>中央处理器</td>
    </tr>
    <tr>
      <td>IOPS</td>
      <td>Input/Output Operations Per Second</td>
      <td>每秒输入/输出操作数</td>
    </tr>
    <tr>
      <td>IP</td>
      <td>Internet Protocol</td>
      <td>互联网协议</td>
    </tr>
    <tr>
      <td>KSV</td>
      <td>KubeSphere Virtualization</td>
      <td>KubeSphere 虚拟化</td>
    </tr>
    <tr>
      <td>PC</td>
      <td>Personal Computer</td>
      <td>个人电脑</td>
    </tr>
    <tr>
      <td>SSH</td>
      <td>Secure Shell</td>
      <td>安全外壳协议</td>
    </tr>
    <tr>
      <td>TCP</td>
      <td>Transmission Control Protocol</td>
      <td>传输控制协议</td>
    </tr>
    <tr>
      <td>UDP</td>
      <td>User Datagram Protocol</td>
      <td>用户数据报协议</td>
    </tr>
    <tr>
      <td>URL</td>
      <td>Uniform Resource Locator</td>
      <td>统一资源定位符</td>
    </tr>
    <tr>
      <td>UUID</td>
      <td>Universally Unique Identifier</td>
      <td>通用唯一标识符</td>
    </tr>
    <tr>
      <td>VLAN</td>
      <td>Virtual Local Area Network</td>
      <td>虚拟局域网</td>
    </tr>
    <tr>
      <td>VM</td>
      <td>Virtual Machine</td>
      <td>虚拟机</td>
    </tr>
    <tr>
      <td>VNC</td>
      <td>Virtual Network Console</td>
      <td>虚拟网络控制台</td>
    </tr>
  </tbody>
</table>


介绍本文档涉及的术语和缩略语。

术语和缩略语


## 新增功能

- 新增支持多物理网卡。

- 新增支持虚拟机资源纵向扩容。

- 新增支持磁盘扩容。

- 新增日志功能。

## 功能优化

- 对用户登录历史的描述进行中文翻译。

- 对表格排序的外观进行优化。

- 不再支持本地存储版安装包。

- 超卖比调整为 1-4，默认为 2。

- 主节点改为控制平面节点。

## 变更详情

### 为虚拟机添加多物理网卡
每张网卡对应一个 IP 池。在**创建虚拟机**页面的**系统配置**区域，可为虚拟机选择多个 IP 池，使虚拟机可以连接到不同的网络中。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.2.0/multi-nics.png' width='550'/>

### 虚拟机资源纵向扩容
在虚拟机详情页面，点击右上角的**编辑**。在**编辑虚拟机**对话框中的**默认配置**区域，可修改虚拟机的内存和 CPU；在**磁盘容量**区域，可对虚拟机的数据盘和系统盘进行扩容。修改完成后，点击左上角的**重启**使新配置生效。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.2.0/scale-up-vm.png' width='550'/>

### 单个磁盘扩容
在磁盘详情页面，点击左上角的**编辑**。在编辑磁盘对话框，修改**容量**可对数据盘进行扩容。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.2.0/increase-disk-capacity.png' width='550'/>

### 开发者日志
日志功能模块记录 KSV 平台上全部组件（包括 Web 控制台的项目和后台组件）的日志信息。您可以根据刷新频率查看实时日志并将日志文件导出到本地。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.2.0/developer-logs.png' width='550'/>  

点击列表内容可查看日志的详细信息。具体页面详情如下图所示。 
&ensp;<img src ='/images/docs/ksv/release-notes/v1.2.0/log-details.png' width='550'/>

v1.2.0 版本说明


## 新增功能

- 新增支持操作日志管理功能。

- 新增支持删除文件服务器中的同名镜像文件。

## 功能优化

- **编辑虚拟机**功能拆分为**编辑**和**调整资源**。

- 优化虚拟机详情页面的快捷操作菜单。

- 未激活 KSV 时，虚拟机数量达到上限 9 台后可以继续创建，但超出限制的虚拟机会被锁定。

- 使用 ISO 镜像创建的虚拟机默认使用 VNC 连接。

## 问题修复

- 解决超卖算法造成的扩容的问题。

## 变更详情

### 操作日志管理
操作日志可以用于查看用户的操作记录。操作日志功能模块提供操作日志列表和操作日志详情，包括操作日志的记录时间、操作行为、服务器的响应状态、被操作资源的所在项目、资源类型与名称、操作者、源 IP 地址以及原因。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.3.0/operation-logs.png' width='550'/>

### 镜像管理
#### 删除文件服务器中的同名镜像文件
镜像文件上传后将存储在文件服务器中。如果文件服务器中存在同名的镜像文件，KSV 支持删除文件服务器中已有的镜像文件。在弹出的对话框中，点击**删除**，然后重新上传镜像文件即可。具体页面详情如下图所示。
&ensp;<img src ='/images/docs/ksv/release-notes/v1.3.0/delete-existing-image.png' width='550'/>

### 虚拟机管理

#### 调整虚拟机资源后提示是否重启虚拟机
在虚拟机详情页面，点击左上角的**调整资源**。在**调整资源**对话框中，可修改虚拟机的核心数、内存大小和磁盘容量。修改完成后，点击**确定**。在弹出的对话框，点击**重启**可立即重启虚拟机，点击**取消**可保存新配置。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.3.0/adjust-resource.png' width='550'/>
&ensp;<img src ='/images/docs/ksv/release-notes/v1.3.0/restart-vm.png' width='550'/>

#### 优化虚拟机详情页面的快捷操作菜单
在虚拟机详情页面的左上角，点击**更多**可对虚拟机进行更多操作。
&ensp;<img src ='/images/docs/ksv/release-notes/v1.3.0/quick-actions.png' width='550'/>

#### 虚拟机锁定
未激活 KSV 时，系统中虚拟机的创建数量最多可为 9 台，超出数量的虚拟机将在 Web控制台上被锁定。
&ensp;<img src ='/images/docs/ksv/release-notes/v1.3.0/lcok-vm.png' width='550'/>

v1.3.0 版本说明


## 新增功能

- 新增支持创建虚拟机时手动设置 IP 地址。
- 新增支持暴露虚拟机服务功能。
- 新增支持查看用户所属项目和角色。

## 功能优化

- 虚拟机**调整资源**可更改网卡配置。

- 在虚拟机列表页面点击右键可显示虚拟机快捷操作菜单。

## 问题修复

- 去掉 ISO 镜像创建的虚拟机的终端连接方式。

- 解决了卸载 KSV 出现卡死无法卸载的问题。

- 修复了磁盘扩容后列表页信息未更新的问题。

## 变更详情

### 虚拟机管理

#### 创建虚拟机页面设计重构

在创建虚拟机页面，对系统配置区域进行设计重构，配置选项展示更加直观。具体页面详情如下图所示。

**v1.4.0**  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.4.0/system-config-v1.4.0.png' width='550'/>

**v1.3.0**  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.4.0/system-config-v1.3.0.png' width='550'/>

#### 创建虚拟机时手动设置 IP 地址
在**系统配置**页面的**网络**区域，从下拉列表中选择一个 IP 池并选择**手动设置 IP 地址**，便可手动为虚拟机设置 IP 地址。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.4.0/add-ip.png' width='550'/>

#### 暴露虚拟机服务
创建虚拟机时，指定服务的端口名称、端口号和协议可开放虚拟机的服务端口。KSV 根据端口号自动进行端口映射，您可以通过 ssh <用户名>@<IP 地址> -p <映射端口> 来访问虚拟机服务。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.4.0/expose-vm-1.png' width='550'/>
&ensp;<img src ='/images/docs/ksv/release-notes/v1.4.0/expose-vm-2.png' width='550'/>

#### 更改虚拟机网卡配置
在虚拟机详情页面，点击左上角的**调整资源**，便可在**网络**区域为虚拟机添加 IP 池、删除已有 IP 池、为虚拟机指定 IP 地址等。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.4.0/modify-resource.png' width='550'/>

#### 虚拟机快捷操作
在虚拟机列表的空白区域，点击右键可弹出快捷操作菜单对虚拟机进行启动、重启、关闭、删除等快捷操作。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.4.0/quick-actions-vm.png' width='550'/>

### 用户管理
#### 查看用户所属项目和项目角色
用户列表页面显示用户所属的项目和在项目中具有的角色。您也可以在用户详情页面查看用户的项目和角色信息。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.4.0/user-mgmt.png' width='550'/>

v1.4.0 版本说明


## 安装项变更
- CPU 超卖比设置范围变更为 1-10。
- 告警日志模块整合到主安装包中，无需单独下载功能包。

## 新增功能

- 新增虚拟机模板功能，支持基于模板创建虚拟机。
- 新增克隆虚拟机功能，支持基于虚拟机创建虚拟机。
- 新增支持查看历史资源监控数据。可查看**最近 1 小时**、**最近 6 小时**、**最近 12 小时**和**最近 24 小时**的历史资源监控数据。
- 新增虚拟机强制关闭和强制重启功能。
- 新增定时器功能。

## 功能优化

- 支持系统镜像。
- 调整某些资源的命名规则。部分资源名称支持含有大写字母。
- 调整用户账号的密码强度规则。
- 虚拟机网卡增加了**默认**标识。

## 问题修复
- 修复了最小化配置 4c8G 安装时无法导入镜像的问题。
- 修复了创建虚拟机选取自定义配置时，右侧配置汇总不同步变更的问题。
- 修复了虚拟机重启后 SSH 密钥失效的问题。
- 修复了镜像名称格式异常导致无法保存的问题。
- 修复了输入数据盘大小为 1024（或其倍数）时扩容单位显示异常的问题。

## 变更详情

### 开启告警日志
新版本将告警日志模块整合到主安装包中。KSV 安装完成后，可使用以下方法开启告警和日志审计功能。
- 开启告警
    ```bash
    kubectl -n kubesphere-system patch cc ks-installer --type merge --patch '{"spec":{"alerting":{"enabled":true}}}'
    ```
- 开启日志审计
    ```bash
    kubectl -n kubesphere-system patch cc ks-installer --type merge --patch '{"spec":{"logging":{"enabled":true},"auditing":{"enabled":true}}}'
    ```

### 虚拟机模板
新增虚拟机模板功能，支持基于模板创建虚拟机。

#### 新建模板
KSV 支持两种方式新建模板：手动配置和复制其他共享模板。

#### 基于模板创建虚拟机
在**虚拟机**页面，点击页面右方的**创建**。在弹出的下拉列表中，选择**基于模板**，然后根据页面提示基于模板创建虚拟机。  
基于模板创建虚拟机中的所有元素均可进行再次调整，但不会保存为版本。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.5.0/create-vm-by-template.png' width='650'/>

#### 版本
KSV 支持为一个虚拟机模板保存 5 个不同配置的版本，您可在模板列表、模板详情和基于模板创建虚拟机时切换版本。

#### 共享模板
虚拟机模板拥有**共享**属性，开启共享后，该模板可与其他项目的用户共享。

#### 导入/导出模板
KSV 平台支持以 YAML 文件的形式导入/导出虚拟机模板。

### 虚拟机克隆
新增克隆虚拟机功能，支持基于虚拟机创建虚拟机。  
您可以在虚拟机列表页右键菜单或虚拟机详情页的**更多**菜单中执行克隆虚拟机操作。克隆虚拟机需要额外编辑虚拟机名称、网络、数量、描述（非必须）内容，其他配置则会与原虚拟机保持一致。  

#### 基于虚拟机创建虚拟机
在**虚拟机**页面，点击右上角的**创建**。在弹出的下拉列表中，选择**基于虚拟机**，然后根据页面提示克隆虚拟机。创建时不可修改除虚拟机名称、网络、数量、描述以外的任何配置。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.5.0/clone-vm.png' width='650'/>

### 查看历史资源监控数据
新增支持查看历史资源监控数据。  
在**概览**页面的**虚拟资源**区域，点击图表右上方的下拉框，可选择查看**最近 1 小时**、**最近 6 小时**、**最近 12 小时**或**最近 24 小时**的历史资源监控数据。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.5.0/resource-monitoring.png' width='650'/>

### 强制关闭或重启虚拟机
新增虚拟机强制关闭和强制重启功能。  
在虚拟机详情页面，点击**更多**。在弹出的操作列表中，选择**强制关闭**或**强制重启**，然后根据页面提示强制关闭或重启虚拟机。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.5.0/force-restart-close-vm.png' width='650'/>

### 定时器
新增定时器功能，可用于创建定时任务，比如定时开关主机、创建备份等。具体页面详情如下图所示。  
&ensp;<img src ='/images/docs/ksv/release-notes/v1.5.0/timer.png' width='650'/>

#### 定时策略
定时策略支持每 *N* 小时、每天、每 *N* 天、每周和每月五种时段策略。其中，每 *N* 天和每 *N* 小时是从任务开启或服务器完全启动后开始计算的。

#### 定时任务
可根据不同的执行操作选择定时任务的操作对象，操作对象可以为多个，但执行策略是唯一的。

#### 允许失败次数
定时任务执行中可能会存在虚拟机状态异常等原因导致备份失败，KSV 平台在备份失败后会再次执行定时任务，尝试 3-8 次（用户配置）后执行停止任务或跳过本次任务的操作。

### 系统镜像
admin 用户上传的所有镜像为系统镜像，平台内的其他账户在创建虚拟机时可直接调用系统镜像创建虚拟机。


v1.5.0 版本说明

版本说明

介绍如何利用 Veeam 的 Kasten K10 软件保护 KSV 的项目和虚拟机。

利用 Veeam 的 Kasten K10 软件保护 KSV 的项目和虚拟机

技术博客

KubeSphere 虚拟化（KSV）是由 KubeSphere 衍生的轻量化虚拟机管理平台，支持单节点部署和多节点部署，便捷易用，满足企业级虚拟化业务需求。