Source: https://dev-docs.yueshu.com.cn/v5.3.2/visualization/studio/upgrade/
Documentation version: v5.3.2

# 升级悦数图管理

本文介绍如何将悦数图管理升级到新版本。请使用与当前安装方式相同的方式升级，并先备份配置和数据。v5.3.2 的安装包位于 [GitHub Releases](https://github.com/vesoft-inc/nebula-ng-studio/releases/tag/v5.3.2)。

Caution

新版本可能升级数据库结构。请确认备份可用后再升级；只换回旧版本程序，不一定能恢复数据库。

## Docker Compose

1. 备份部署目录中的`studio-compose.yaml`和 Docker 数据卷`studio-data`。如果挂载了`config-release.yaml`，也请备份该文件。使用 MySQL 时，还需单独备份 MySQL 数据库。
2. 在 [Docker Hub 镜像页面](https://hub.docker.com/r/vesoft/nebula-studio/tags)确认目标版本的标签，将`studio-compose.yaml`中`studio`服务的`image`改为`vesoft/nebula-studio:<版本号>`。将`<版本号>`替换为目标版本，例如`5.3.2`。
3. 

在部署目录运行：

````
docker compose -f studio-compose.yaml pull studio
docker compose -f studio-compose.yaml up -d
docker compose -f studio-compose.yaml ps

````

4. 

访问图管理，确认配置和数据正常。

## TAR 包

1. 

进入旧版本的安装目录，停止服务：

````
sudo ./scripts/studio.service stop all
sudo ./scripts/studio.service status all

````

2. 

备份旧安装目录。使用 SQLite 时，请同时备份`data/studio.db`及同目录下的`studio.db-wal`、`studio.db-shm`文件（如有）；使用 MySQL 时，单独备份数据库。

3. 从[目标版本的发布页](https://github.com/vesoft-inc/nebula-ng-studio/releases)下载与操作系统和架构对应的 TAR 包，解压到一个新目录，不要覆盖旧目录。
4. 对照新旧版本的`etc/config.yaml`，将自定义配置写入新文件。使用 SQLite 时，将备份的数据库文件复制到新安装目录中的对应位置。
5. 进入新安装目录，启动服务并检查状态：

````
sudo ./scripts/studio.service start all
sudo ./scripts/studio.service status all

````

确认页面和数据正常后，再清理旧安装目录。

## RPM 或 DEB 包

1. 

停止服务。备份`/etc/nebula-studio/config.yaml`；如果使用了`/etc/nebula-studio/studio.env`，也备份该文件。默认使用 SQLite 时，备份`/var/lib/nebula-studio`目录，确保包含`studio.db`及可能存在的`studio.db-wal`、`studio.db-shm`；使用 MySQL 时，单独备份 MySQL 数据库。

````
sudo systemctl stop nebula-studio.service

````

2. 

从[目标版本的发布页](https://github.com/vesoft-inc/nebula-ng-studio/releases)下载与操作系统和架构对应的包。RPM 包运行`sudo rpm -Uvh <下载的RPM文件>`；DEB 包运行`sudo dpkg -i <下载的DEB文件>`。

3. 

检查`/etc/nebula-studio/config.yaml`中的自定义配置，启动服务并检查状态：

````
sudo systemctl start nebula-studio.service
sudo systemctl status nebula-studio.service

````

4. 

访问图管理，确认配置和数据正常。