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

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
is:linux:bitnami_redmine服务搭建-01-安装 [2025/03/14 00:32] – 移除 - 外部编辑 (未知日期) 127.0.0.1is:linux:bitnami_redmine服务搭建-01-安装 [2025/03/14 00:32] (当前版本) – ↷ 页面名由is:linux:bitnami_redmine服务搭建-01改为is:linux:bitnami_redmine服务搭建-01-安装 A.L
行 1: 行 1:
 +===== 安装 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>