备份与还原

# Project提供了两种备份方式
- 一种是Admin用户通过页面备份，
- 另一种是通过命令备份。

本文选择通过命令备份的方式

## 备份内容
a. 存储在Postgres中的数据；
b. 配置文件；
c. 上传的文件(附件)；
d. Git/SVN仓库(如果有的话)。

## 页面备份
1. 备份页面
(1) 使用Admin账户登录后点击右上角头像，进入"Administration->Backup"页面：
![](/media/202405/2024-05-13_092236_9905080.5327901533985637.png)

(2) 生成备份Token
Backup 令牌:`13aa75e55ac91a683733086a3822291ba83b8ca96aade7bb281b37436eb697db`
![](/media/202405/2024-05-13_095903_0866170.894305489920226.png)

(3) 请求备份
![](/media/202405/2024-05-13_095454_6097990.6609707663176434.png)

(4) 备份后会自动下载
![](/media/202405/2024-05-13_095531_0436840.4871284127424358.png)

## 命令备份
### 备份前

(1) 停止Open Project服务
```
sudo systemctl stop openproject
```
### 备份
```
sudo openproject run backup
```

### 备份后
(1) 备份目录
```
/var/db/openproject/backup
```
![](/media/202405/2024-05-13_100250_5347750.06991897766849542.png)

(2) 注意
为确保备份文件的安全性，强烈建议将该文件备份至其他主机。

### 还原

#### 还原前
(1) 停止Open Project服务
```shell
sudo systemctl stop openproject
```

2. 还原
(1) 还原附件文件
```shell
sudo tar xzf /var/db/openproject/backup/attachments-20191119210038.tar.gz -C /var/db/openproject/files
```

(2) 还原配置文件
```shell
sudo tar xzf /var/db/openproject/backup/conf-20191119210038.tar.gz -C /etc/openproject
```
(3) 解压仓库文件
```shell
sudo tar xzf /var/db/openproject/backup/git-repositories-20191119210038.tar.gz -C /var/db/openproject/git
sudo tar xzf /var/db/openproject/backup/svn-repositories-20191119210038.tar.gz -C /var/db/openproject/svn
```
(4) 数据库还原

a. 首先查询Open Project实例对应的数据库链接字符串
```shell
sudo openproject config:get DATABASE_URL
```

该命令执行的结果：
```shell
postgres://<dbusername>:<dbpassword>@<dbhost>:<dbport>/<dbname>
```
b. 数据库还原
```shell
sudo pg_restore --clean --if-exists --dbname $(sudo openproject config:get DATABASE_URL) postgresql-dump-20200804094017.pgdump
```
参数"--clean --if-exists" 将清空数据库。

c. 异常1
pg_restore会尝试将备份库中的用户名设置为新库的owner，如果目标数据库与备份库的用户名不同，则会报错，此时需要添加"--no-owner"参数来避免报错。

d. 异常2
如果恢复数据库时，出现错误提示"Error while PROCESSING TOC […] cannot drop constraint"，则需要删除并重建目标数据库：
```shell
sudo su - postgres -c psql
DROP DATABASE openproject; CREATE DATABASE openproject OWNER openproject;
```
3. 还原后
(1) 重启
```shell
sudo systemctl restart openproject
```
## 参考
### 官方
(1) 备份
https://www.openproject.org/docs/system-admin-guide/backup/
https://www.openproject.org/docs/installation-and-operations/operation/backing-up/

(2) 还原
https://www.openproject.org/docs/installation-and-operations/operation/restoring/