is:linux:bitnami_redmine服务搭建-01-安装

安装 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 服务。
目前安装的插件：
1. `clipboard_image_paste`（Redmine 4.x 不适用）
2. `redmine_issues_tree`（OK：树形结构显示问题层级）
3. `redmine_whining`（OK：任务未按时更新时自动发邮件提醒指派人）
4. `redmine_knowledgebase`（OK：知识管理插件，兼容 Redmine 4.*）
5. `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