===== 安装 Redmine Bitnami 4.1.1.4 =====
* 运行 `bitnami_redmine_4.1.1-4*.run` 安装包：
chmod +x bitnami_redmine_4.1.1-4*.run # 赋予 run 文件完全权限
./bitnami_redmine_4.1.1-4*.run # 完整路径运行 run 文件
===== Linux 系统重启后 Bitnami Redmine 的重启（manager-linux-x64.run） =====
* 进入安装目录并运行管理器：
cd /opt/redmine4.1.1-4/
./manager-linux-x64.run
===== Redmine 升级数据库 =====
* **注意**：如果升级数据库失败（如“Internal ERROR”），可能是由于先安装了插件。需要删除所有插件后再升级数据库！
* 导入原有 Redmine 数据到 Bitnami Redmine：
/opt/redmine-3.4.4-2/mysql/bin/mysql -u root -p
mysql> DROP DATABASE bitnami_redmine;
mysql> CREATE DATABASE bitnami_redmine character set utf8;
mysql> USE bitnami_redmine;
mysql> SOURCE /root/redmine.sql;
mysql> EXIT;
* 升级导入的原数据库结构到新数据库版本：
cd apps/redmine/htdocs
* 执行 `use_redmine` 进入终端模式。
* **（重要：数据库结构升级）** 执行：
bundle exec rake db:migrate RAILS_ENV=production
* 或参考以下命令：
cd /opt/redmine-xxxx/apps/redmine/htdocs
sh /opt/redmine-xxxx/ruby/bin/ruby bin/rake db:migrate RAILS_ENV=production
* 迁移 `files` 目录下文件：
scp -r 原Redmine服务器IP地址:/opt/redmine/files/* /opt/redmine-xxxx/apps/redmine/htdocs/files/
* 给文件赋予读写权限：
cd /opt/redmine-3.4.4-2/apps/redmine/htdocs/files/
chown -R daemon:daemon *
* 重新启动 Bitnami Redmine 服务（未试验过）：
cd /opt/redmine-3.4.4-2
./ctlscript.sh restart
=== Bundle Install 报错的处理 ===
* 如果提示需要 `bundle install`，运行：
bundle config mirror.https://rubygems.org https://gems.ruby-china.com
* 如果提示 `nokogiri` 报错，例如：
```plaintext
Make sure that `gem install nokogiri -v '1.10.9' --source 'https://gems.ruby-china.com/'` succeeds before bundling.
* 可以执行以下操作：
gem list --remote --all nokogiri # 查看远程所有版本
gem install nokogiri
* 也可以尝试安装 `nokogiri` 环境：
sudo apt-get install libxslt-dev libxml2-dev
sudo apt-get install build-essential patch ruby-dev zlib1g-dev liblzma-dev
gem install nokogiri -v 'xxxxxxxx'
* 也可以尝试升级 `gem`：
gem update
* 出现 `gemfile sources` 问题（如 `fetching gem metadata from https://rubygems.org`），可以使用 Bundler 的 Gem 源代码镜像命令：
bundle config mirror.https://rubygems.org https://ruby.taobao.org
* 如果问题依旧，尝试修改 `Gemfile`：
vim Gemfile
source 'https://gems.ruby-china.com/' # 或 https://ruby.taobao.org/
* 出现 `rake aborted` 错误，尝试：
gem install rake
* 出现 `rails` 问题，尝试：
* 推荐更新 `gem`：
gem update
===== 使用 use_redmine 安装 Plugins（基于 Bundle） =====
* 切换 `gem` 源：
gem sources -l
gem sources --remove https://rubygems.org/ -a http://gems.ruby-china.com
gem sources -l # 确认当前源
* 或者：
bundle config mirror.https://rubygems.org http://gems.ruby-china.org
* 插件安装命令：
- 将插件解压复制到 `\Bitnami\redmine-3.0.2-0\apps\redmine\htdocs\plugins` 目录下。
- 启动 `use_redmine`：
- Windows：`\Bitnami\redmine-3.4.2-0\use_redmine.bat`
- Linux：`/（路径）/redmine-2.5.2-2/use_redmine`
-
- 进入 `plugins` 目录，输入：
bundle install --without development test
- 输入以下命令之一：
bundle exec rake redmine:plugins NAME=xxxxxxxx RAILS_ENV=production
bundle exec rake redmine:plugins:migrate RAILS_ENV=production
rake redmine:plugins:migrate RAILS_ENV=production
- 如果安装错误，尝试：
gem sources --remove https://rubygems.org/ -a https://ruby.taobao.org/
gem install rails
=== Redmine 4.1.1.4 安装插件注意事项 ===
* 4.x 插件压缩包解压后文件夹名为 `xxxxxxx-master`，需删除 `-master` 后放入 `plugins` 文件夹。
* 建议使用 `NAME` 单个安装插件，`migrate` 容易出错。
* 安装完成后重启 Bitnami 服务。
* 目前安装的插件：
- `clipboard_image_paste`（Redmine 4.x 不适用）
- `redmine_issues_tree`（OK：树形结构显示问题层级）
- `redmine_whining`（OK：任务未按时更新时自动发邮件提醒指派人）
- `redmine_knowledgebase`（OK：知识管理插件，兼容 Redmine 4.*）
- `Redmine Mail From plugin`（OK：在邮件通知中增加发件人）
===== Plugins 卸载 =====
* 进入插件目录：
cd /opt/redmine-3.3.0-1/apps/redmine/htdocs/plugins
* 执行卸载命令：
bundle exec rake redmine:plugins:migrate NAME=xxxxxxxxxx VERSION=0 RAILS_ENV=production
* 将对应插件文件移走。
* 重新启动 Bitnami Redmine Stack 服务。
===== Redmine 备份数据库 =====
* 停掉其他服务，仅保留 `redminesql` 服务。
* 进入 `use_redmine`：
sudo ./use_redmine
mysqldump -u root -p bitnami_redmine > backup.sql
* 备份文件 `backup.sql` 会保存在 Redmine 根目录下。
===== Gem 常用命令 =====
* 查看 RubyGems 版本：
gem -v
* 显示 RubyGem 使用帮助：
gem help
* 列出 RubyGem 命令使用范例：
gem help example
* 安装指定 gem 包：
gem install [gemname]
* 仅从本机安装 gem 包：
gem install -l [gemname]
* 仅从远程安装 gem 包：
gem install -r [gemname]
* 安装指定版本的 gem 包：
gem install [gemname] --version=[ver]
* 删除指定 gem 包：
gem uninstall [gemname]
* 删除指定版本的 gem 包：
gem uninstall [gemname] --version=[ver]
* 更新 RubyGems 软件自身：
gem update --system
* 更新所有或指定已安装的 gem 包：
gem update [gemname]
* 查看本机已安装的所有 gem 包：
gem list
===== Redmine 插件安装及卸载 =====
* 插件名称：`redmine_wktime`
* 安装：
bundle install
rake redmine:plugins:migrate NAME=redmine_wktime RAILS_ENV=production
* 卸载：
rake redmine:plugins:migrate NAME=redmine_wktime VERSION=0 RAILS_ENV=production