Bitnami-Redmine备份迁移恢复

刺骨的言语ヽ痛彻心扉 2022-08-05 00:41 539阅读 0赞

事情起因

Redmine 作为一款项目管理软件，曾经很是流行，现如今风光不在，不过依然在某些场景下受到欢迎。

常见的 Redmine 使用方式为：Redmine + markdown + svn/git ，这种组合可以满足项目进度管理、代码管理、文档管理的需求。

在使用过程中，最为头疼的莫过于 markdown 的集成，官方给出的插件太过陈旧，而第三方插件，或多或少都会引起 redmine 访问不稳定，还会导致CPU跑满，机器宕掉，这一度让小伙伴的情绪处于失控的边缘，于是乎，就下决心动动这个老古董。

经过调研发现，redmine 3.x 版本内置了 markdown 插件，于是乎，把老版本的数据迁移到新版本似乎是个不错的选择。

这里有两个选择：

可以在原 redmine 2.6 的基础上进行升级，不过之前安装的过程中，ruby 的版本已经有点混乱，做起来会比较麻烦，再者官方没有提供无缝升级文档，还有一个是 3.0 的数据库不兼容 2.6；

当然也可以重新搭建一个新的 redmine 3.0，这样会更干净一些，后续的维护包袱也会小一些，所以下面就以此方法为准。

环境（迁移前）

系统：CentOS 6.6 x64

软件：Bitnami-Redmine 2.6

目录：/opt/redmine

服务器：11.11.11.11

环境（迁移后）

系统：CentOS 7.0 x64

软件：Bitnami-Redmine 3.0

目录：/opt/redmine

服务器：22.22.22.22

数据库备份（旧服务器）

（1）备份数据库

这里有一个小插曲，之前安装的小伙伴说，没有留意安装过程中有让填写 mysql 密码，所以，有必要手动恢复一下 root 密码，操作如下

（2）停止 redmine

  1. cd /opt/redmine
  2. ./ctlscript.sh stop

（3）使用安全模式启动 msyql，跳过权限认证（此处的操作会使数据库处于危险之中，所以操作之前一定在停掉mysql）

  1. ./mysql/bin/mysqld_safe --skip-grant-tables &
  2. ./mysql/bin/mysql -uroot

（4）恢复 mysql root 的密码为 123456

  1. update mysql.user set password=PASSWORD('123456') where User='root';
  2. flush privileges;
  3. quit

（5）查找 mysql 进程，并且关闭

  1. ps -ef|grep mysql

找到进程PID后，可以使用 kill -9 pid 命令来关掉进程
（6）启动 redmine

  1. ./ctlscript.sh start

（7）备份数据库到 当前目录的 bitnami_redmine.sql 文件

  1. ./mysql/bin/mysqldump -uroot -p'123456' bitnami_redmine > bitnami_redmine.sql

（8）使用文本工具编辑 bitnami_redmine.sql 文件，使用新的服务器 22.22.22.22 替换 旧的 11.11.11.11

数据库恢复（新服务器）

（9）安装 bitnami-redmine

安装不作为此文章的重点，所以，就选择性跳过了，后续我会再补一篇《Bitnami-Redmine 快速部署》文章。

此处只给出 bitnami-redmine 的下载地址 https://bitnami.com/stack/redmine/installer ，下载之后，对照 README 文档操作就可以了，几乎是一键式安装，比较轻松。

（10）启动 bitnami-redmine

  1. cd /opt/redmine
  2. ./ctlscript.sh start

（11）备份数据库

  1. ./mysql/bin/mysqldump -uroot -p'123456' bitnami_redmine > bitnami_redmine_bak.sql

（12）使用 mysql 命令清理 bitnami_redmine 数据库

  1. ./mysql/bin/mysql -uroot -p'123456'
  3. DROP DATABASE bitnami_redmine;
  4. CREATE DATABASE bitnami_redmine;
  5. quit

（13）上传 bitnami_redmine.sql 到 /opt/redmine ，并恢复旧数据库

  1. ./mysql/bin/mysql -uroot -p'123456' bitnami_redmine < bitnami_redmine.sql

（14）接下来的基本上是体力活了，因为上面提到 redmine 从 2.6 升级到 3.0 数据库结构发生的改变，所以涉及到的数据表，需要手动修复

主要修改如下：
用户表 users 中，删除了 email 字段，拆分为单独的 邮件地址表 email_addresses
users 表的插入语句，手动删除 email 字段即可；
至于新增的 email_addresses 表，懒一点的办法就是所有操作完成后，手动在管理后台中给每个用户添加邮件，每个用户60秒足够了（注意此处添加邮件会修改掉用户的密码，设置一个统一的，强制用户登录修改吧）

问题状态表 issue_statuses 中，删除中 is_default 字段
issue_statuses 表的插入语句，手动删除 email 字段即可；

角色表 roles 中，添加了 users_visibility 字段
roles 表的插入语句中，每个 VALLUES 的末字段添加一个 ‘all’ 即可

跟踪表 tracker 中，添加了 default_status_id 字段
tracker 表的插入语句中，每个 VALUES 的末字段添加一个 1 即可

wiki表 wiki_redirects 中，添加了 redirects_to_wiki_id 字段
此处的旧项目中，并未用到此表，所以操作无从谈起

为了方便操作，可以将数据库修复操作，放在一个文件 bitnami_redmine_upgrade_26_to_30.sql 中，

【特别注意】如下代码中，出现了 … 字符，这里代表中，需要替换为你的旧数据库中的真实数据，如果没有数据，可以直接删除所在 INSERT 行

【此处有坑】保存此文件时，一定要注意，文档格式为UTF-8，否则在下面的导入中，会一直报错，在管理后台的表现就是，缺少数据

  1. USE bitnami_redmine;
  3. DROP TABLE IF EXISTS `email_addresses`;
  4. CREATE TABLE `email_addresses` (
  5.   `id` int(11) NOT NULL AUTO_INCREMENT,
  6.   `user_id` int(11) NOT NULL,
  7.   `address` varchar(255) NOT NULL,
  8.   `is_default` tinyint(1) NOT NULL DEFAULT '0',
  9.   `notify` tinyint(1) NOT NULL DEFAULT '1',
  10.   `created_on` datetime NOT NULL,
  11.   `updated_on` datetime NOT NULL,
  12.   PRIMARY KEY (`id`),
  13.   KEY `index_email_addresses_on_user_id` (`user_id`)
  14. ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;
  17. DROP TABLE IF EXISTS `issue_statuses`;
  18. CREATE TABLE `issue_statuses` (
  19.   `id` int(11) NOT NULL AUTO_INCREMENT,
  20.   `name` varchar(30) NOT NULL DEFAULT '',
  21.   `is_closed` tinyint(1) NOT NULL DEFAULT '0',
  22.   `position` int(11) DEFAULT '1',
  23.   `default_done_ratio` int(11) DEFAULT NULL,
  24.   PRIMARY KEY (`id`),
  25.   KEY `index_issue_statuses_on_position` (`position`),
  26.   KEY `index_issue_statuses_on_is_closed` (`is_closed`)
  27. ) ENGINE=InnoDB AUTO_INCREMENT=8 DEFAULT CHARSET=utf8;
  29. LOCK TABLES `issue_statuses` WRITE;
  30. INSERT INTO `issue_statuses` VALUES ...;
  31. UNLOCK TABLES;
  34. DROP TABLE IF EXISTS `roles`;
  35. CREATE TABLE `roles` (
  36.   `id` int(11) NOT NULL AUTO_INCREMENT,
  37.   `name` varchar(30) NOT NULL DEFAULT '',
  38.   `position` int(11) DEFAULT '1',
  39.   `assignable` tinyint(1) DEFAULT '1',
  40.   `builtin` int(11) NOT NULL DEFAULT '0',
  41.   `permissions` text,
  42.   `issues_visibility` varchar(30) NOT NULL DEFAULT 'default',
  43.   `users_visibility` varchar(30) NOT NULL DEFAULT 'all',
  44.   PRIMARY KEY (`id`)
  45. ) ENGINE=InnoDB AUTO_INCREMENT=8 DEFAULT CHARSET=utf8;
  47. LOCK TABLES `roles` WRITE;
  48. INSERT INTO `roles` VALUES ...;
  49. UNLOCK TABLES;
  52. DROP TABLE IF EXISTS `trackers`;
  53. CREATE TABLE `trackers` (
  54.   `id` int(11) NOT NULL AUTO_INCREMENT,
  55.   `name` varchar(30) NOT NULL DEFAULT '',
  56.   `is_in_chlog` tinyint(1) NOT NULL DEFAULT '0',
  57.   `position` int(11) DEFAULT '1',
  58.   `is_in_roadmap` tinyint(1) NOT NULL DEFAULT '1',
  59.   `fields_bits` int(11) DEFAULT '0',
  60.   `default_status_id` int(11) DEFAULT NULL,
  61.   PRIMARY KEY (`id`)
  63. ) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8;
  65. LOCK TABLES `trackers` WRITE;
  66. INSERT INTO `trackers` VALUES ...;
  67. UNLOCK TABLES;
  70. DROP TABLE IF EXISTS `users`;
  71. CREATE TABLE `users` (
  72.   `id` int(11) NOT NULL AUTO_INCREMENT,
  73.   `login` varchar(255) NOT NULL DEFAULT '',
  74.   `hashed_password` varchar(40) NOT NULL DEFAULT '',
  75.   `firstname` varchar(30) NOT NULL DEFAULT '',
  76.   `lastname` varchar(255) NOT NULL DEFAULT '',
  77.   `admin` tinyint(1) NOT NULL DEFAULT '0',
  78.   `status` int(11) NOT NULL DEFAULT '1',
  79.   `last_login_on` datetime DEFAULT NULL,
  80.   `language` varchar(5) DEFAULT '',
  81.   `auth_source_id` int(11) DEFAULT NULL,
  82.   `created_on` datetime DEFAULT NULL,
  83.   `updated_on` datetime DEFAULT NULL,
  84.   `type` varchar(255) DEFAULT NULL,
  85.   `identity_url` varchar(255) DEFAULT NULL,
  86.   `mail_notification` varchar(255) NOT NULL DEFAULT '',
  87.   `salt` varchar(64) DEFAULT NULL,
  88.   `must_change_passwd` tinyint(1) NOT NULL DEFAULT '0',
  89.   `passwd_changed_on` datetime DEFAULT NULL,
  90.   PRIMARY KEY (`id`),
  91.   KEY `index_users_on_id_and_type` (`id`,`type`),
  92.   KEY `index_users_on_auth_source_id` (`auth_source_id`),
  93.   KEY `index_users_on_type` (`type`)
  94. ) ENGINE=InnoDB AUTO_INCREMENT=28 DEFAULT CHARSET=utf8;
  96. LOCK TABLES `users` WRITE;
  97. INSERT INTO `users` VALUES ...;
  98. UNLOCK TABLES;
  101. DROP TABLE IF EXISTS `wiki_redirects`;
  102. CREATE TABLE `wiki_redirects` (
  103.   `id` int(11) NOT NULL AUTO_INCREMENT,
  104.   `wiki_id` int(11) NOT NULL,
  105.   `title` varchar(255) DEFAULT NULL,
  106.   `redirects_to` varchar(255) DEFAULT NULL,
  107.   `created_on` datetime NOT NULL,
  108.   `redirects_to_wiki_id` int(11) NOT NULL,
  109.   PRIMARY KEY (`id`),
  110.   KEY `wiki_redirects_wiki_id_title` (`wiki_id`,`title`),
  111.   KEY `index_wiki_redirects_on_wiki_id` (`wiki_id`)
  112. ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

上传此文件到 /opt/redmine ，并执行更新操作

  1. ./mysql/bin/mysql -uroot -p'123456' < bitnami_redmine_upgrade_26_to_30.sql

（15）至此，所有数据库操作已经完成，下面开始文件附件操作

文件附件迁移（旧服务器）

（16）将 /apps/redmine/htdocs/files 下的所有文件打包，并拷贝至新服务器相同目录即可。

插件迁移（旧服务器）

（17）将 /apps/redmine/htdocs/plugins 下的所有文件打包，，并拷贝至新服务器相同目录即可。

大功告成

（18）至此，迁移工作完成，浏览器中访问新版 redmine ，确认功能是否正常。

参考资料

Bitnami Redmine Install https://bitnami.com/stack/redmine/installer

Redmine 数据迁移记录 https://ruby-china.org/topics/8340

Redmine README.txt Redmine安装目录

工具推荐

1.软件开发必备翻墙代理，低延迟(50ms)，月费10元，详询（宝哥儿QQ1066690060）请自觉遵守国家法律法规

发表评论

表情：
评论列表 （有 0 条评论，539人围观）

还没有评论，来说两句吧...

相关阅读

    相关 Gitlab备份、迁移、恢复和升级

    自建的Gitlab服务器常常会因为使用时间的增长，其空间容量等硬件需求都需要升级，或者迁移至更高配置的服务器上。备份、迁移、恢复、升级过程如下 1、gitlab备份 备份前

    悠悠悠悠/ 0 赞/ 347 阅读