{{i18nTranslate('_layout.t11')}} {{i18nGetLang()==='zh' ? 'EN' : '中文'}}

# 升级管理平台

可以选择使用命令升级、在线升级，或手动升级。

> 严重注意：升级之后，无法自动降级，请根据自身需求谨慎决定是否升级到最新版本。

## 升级方式1：使用edge-admin命令升级

在安装有GoEdge管理系统的服务器上使用以下命令升级：

    edge-admin upgrade

如果系统提示找不到`edge-admin`命令，你可以填写完整的命令路径：

    你安装的管理系统目录/bin/edge-admin upgrade

## 升级方式2：在线升级

在管理系统“系统设置” – “基础设置” – “检查更新“页面点击”开始检查“：

然后在出现的新版本信息中点击“安装新版本”：

即可等待系统下载并安装新版本，安装后会有短暂的重启时间，请耐心等待完成后即可访问。

## 升级方式3：手动升级

1. 在官网下载新的管理平台压缩包，放到EdgeAdmin安装目录的所在目录下：

       edge-admin/
       edge-admin-xxx-xxx-vxxx.zip

2. 备份配置文件：为了防止不小心删除原有的配置文件，可以备份原安装目录下的：

       edge-admin/
         configs/  -- 需要备份的配置目录1
         edge-api/
            configs/  -- 需要备份的配置目录2

   在安装完成后，如果发现重新进入了安装界面，请将备份的配置目录重新覆盖相应的位置，然后重启edge-admin服务进程；
3. 在目标服务器上解压后覆盖原有的安装目录，注意 不要 删除原来安装目录下的任何文件，以防丢失配置：

       unzip -o edge-admin-xxx-xxx-vxxx.zip

   执行后，会自动覆盖 `edge-admin/` 目录下的所有文件
4. 重启管理平台进程：

       cd $EdgeAdmin安装目录
       bin/edge-admin restart

### 特殊情况处理

特殊情况下，如果你的安装目录名 不是 `edge-admin`，你需要将解压后的目录拷贝到实际的安装目录下面：

    unzip -o edge-admin-xxx-xxx-vxxx.zip
    cp -R -f edge-admin/* $EdgeAdmin安装目录

然后再重启 `edge-admin` 进程。

如果你找不到自己EdgeAdmin安装位置，可以使用 `edge-boot` 来查看edge-admin进程（前提是你已经安装了edge-boot）：

    edge-boot ls

结果类似于

    [root@localhost ~]# edge-boot ls
    Process       |  Pid    | Version |  Path
    ==================================================
    edge-admin    |  9577   |  0.4.9  | /usr/local/goedge/edge-admin/bin/edge-admin

其中 `/usr/local/goedge/edge-admin` 就是安装目录；如果没有结果，说明当前系统中尚未启动任何EdgeAdmin。

## 数据库相关

数据库是通过API节点升级的，如果用户在安装时选择的是启动自带的API节点，则每次在重启的时候，都会自动检查数据库是否有升级，并自动执行升级；如果是用户单独自行安装的API节点，可以在升级完API节点后，重启API节点，就会自动执行数据库升级。

如果数据库数据量比较大，为了防止启动`edge-api`等待时间过长，你可以先升级数据库：

    cd $EdgeAPI安装目录
    bin/edge-api upgrade

等完成后，再重启`edge-api`进程。

## 常见问题

### 可以跨版本升级吗？

GoEdge是支持跨版本升级的，比如从 v0.2.0 升级到 v1.2.0，是允许的。

{{i18nTranslate('_layout.t27')}}
{{i18nTranslate('_layout.t12')}}