is:linux:bitnami_redmine服务搭建-01-安装 [DeerLin wiki]

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。
===== 安装 Redmine Bitnami 4.1.1.4 =====
  * 运行 `bitnami_redmine_4.1.1-4*.run` 安装包：<code>
    chmod +x bitnami_redmine_4.1.1-4*.run  # 赋予 run 文件完全权限
    ./bitnami_redmine_4.1.1-4*.run         # 完整路径运行 run 文件
</code>
===== Linux 系统重启后 Bitnami Redmine 的重启（manager-linux-x64.run） =====
  * 进入安装目录并运行管理器：<code>
    cd /opt/redmine4.1.1-4/
    ./manager-linux-x64.run
</code>
===== Redmine 升级数据库 =====
  * **注意**：如果升级数据库失败（如“Internal ERROR”），可能是由于先安装了插件。需要删除所有插件后再升级数据库！
  * 导入原有 Redmine 数据到 Bitnami Redmine：<code>
    /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;
</code>
  * 升级导入的原数据库结构到新数据库版本：<code>
    cd apps/redmine/htdocs
</code>
  * 执行 `use_redmine` 进入终端模式。
  * **（重要：数据库结构升级）** 执行：<code>
    bundle exec rake db:migrate RAILS_ENV=production
</code>
  * 或参考以下命令：<code>
    cd /opt/redmine-xxxx/apps/redmine/htdocs
    sh /opt/redmine-xxxx/ruby/bin/ruby bin/rake db:migrate RAILS_ENV=production
</code>
  * 迁移 `files` 目录下文件：<code>
    scp -r 原Redmine服务器IP地址:/opt/redmine/files/* /opt/redmine-xxxx/apps/redmine/htdocs/files/
</code>
  * 给文件赋予读写权限：
<code>
    cd /opt/redmine-3.4.4-2/apps/redmine/htdocs/files/
    chown -R daemon:daemon *
</code>
  * 重新启动 Bitnami Redmine 服务（未试验过）：<code>
    cd /opt/redmine-3.4.4-2
    ./ctlscript.sh restart
</code>
=== Bundle Install 报错的处理 ===
  * 如果提示需要 `bundle install`，运行：<code>
    bundle config mirror.https://rubygems.org https://gems.ruby-china.com
</code>
  * 如果提示 `nokogiri` 报错，例如：<code>
    ```plaintext
    Make sure that `gem install nokogiri -v '1.10.9' --source 'https://gems.ruby-china.com/'` succeeds before bundling.
</code>
  * 可以执行以下操作：<code>
    gem list --remote --all nokogiri  # 查看远程所有版本
    gem install nokogiri
</code>
  * 也可以尝试安装 `nokogiri` 环境：<code>
    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'
</code>
  * 也可以尝试升级 `gem`：<code>
    gem update
</code>
  * 出现 `gemfile sources` 问题（如 `fetching gem metadata from https://rubygems.org`），可以使用 Bundler 的 Gem 源代码镜像命令：<code>
    bundle config mirror.https://rubygems.org https://ruby.taobao.org
</code>
  * 如果问题依旧，尝试修改 `Gemfile`：<code>
    vim Gemfile
    source 'https://gems.ruby-china.com/'  # 或 https://ruby.taobao.org/
</code>
  * 出现 `rake aborted` 错误，尝试：<code>
    gem install rake
</code>
  * 出现 `rails` 问题，尝试：<code>
</code>
  * 推荐更新 `gem`：<code>
    gem update
</code>
===== 使用 use_redmine 安装 Plugins（基于 Bundle） =====
  * 切换 `gem` 源：<code>
    gem sources -l
    gem sources --remove https://rubygems.org/ -a http://gems.ruby-china.com
    gem sources -l  # 确认当前源
</code>
  * 或者：<code>
    bundle config mirror.https://rubygems.org http://gems.ruby-china.org
</code>
  * 插件安装命令：
    - 将插件解压复制到 `\Bitnami\redmine-3.0.2-0\apps\redmine\htdocs\plugins` 目录下。
    - 启动 `use_redmine`：<code>
      - Windows：`\Bitnami\redmine-3.4.2-0\use_redmine.bat`
      - Linux：`/（路径）/redmine-2.5.2-2/use_redmine`
      - </code>
    - 进入 `plugins` 目录，输入：<code>
      bundle install --without development test
</code>
    - 输入以下命令之一：<code>
      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
</code>
    - 如果安装错误，尝试：<code>
      gem sources --remove https://rubygems.org/ -a https://ruby.taobao.org/
      gem install rails
</code>
=== 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 卸载 =====
  * 进入插件目录：<code>
    cd /opt/redmine-3.3.0-1/apps/redmine/htdocs/plugins
</code>
  * 执行卸载命令：<code>
    bundle exec rake redmine:plugins:migrate NAME=xxxxxxxxxx VERSION=0 RAILS_ENV=production
</code>
  * 将对应插件文件移走。
  * 重新启动 Bitnami Redmine Stack 服务。

===== Redmine 备份数据库 =====
  * 停掉其他服务，仅保留 `redminesql` 服务。
  * 进入 `use_redmine`：<code>
    sudo ./use_redmine
    mysqldump -u root -p bitnami_redmine > backup.sql
</code>
  * 备份文件 `backup.sql` 会保存在 Redmine 根目录下。

===== Gem 常用命令 =====
  * 查看 RubyGems 版本：<code>
    gem -v
</code>
  * 显示 RubyGem 使用帮助：<code>
    gem help
</code>
  * 列出 RubyGem 命令使用范例：<code>
    gem help example
</code>
  * 安装指定 gem 包：<code>
    gem install [gemname]
</code>
  * 仅从本机安装 gem 包：<code>
    gem install -l [gemname]
</code>
  * 仅从远程安装 gem 包：<code>
    gem install -r [gemname]
</code>
  * 安装指定版本的 gem 包：<code>
    gem install [gemname] --version=[ver]
</code>
  * 删除指定 gem 包：<code>
    gem uninstall [gemname]
</code>
  * 删除指定版本的 gem 包：<code>
    gem uninstall [gemname] --version=[ver]
</code>
  * 更新 RubyGems 软件自身：<code>
    gem update --system
</code>
  * 更新所有或指定已安装的 gem 包：<code>
    gem update [gemname]
</code>
  * 查看本机已安装的所有 gem 包：<code>
    gem list
</code>

===== Redmine 插件安装及卸载 =====
  * 插件名称：`redmine_wktime`
  * 安装：<code>
    bundle install
    rake redmine:plugins:migrate NAME=redmine_wktime RAILS_ENV=production
</code>
  * 卸载：<code>
    rake redmine:plugins:migrate NAME=redmine_wktime VERSION=0 RAILS_ENV=production
</code>