Redmine 常见问题

怎么安装

Redmine 安装的很坑，建议 Docker 或 bitnami 一键安装包。

max key length is 767 bytes

Mysql2::Error: Specified key was too long; max key length is 767 bytes: CREATE INDEX

这主要是因为字符集设置了 utf8mb4 导致的，降级为 utf8 即可。

没有新建问题标签

在第一次登录时，进入 Administration 功能后会提示语言选择，然后后面有个 Load Default Configuration 按钮，点击一下就好了。如果没有点击那么很大概率没有新建问题标签。

上面的提示只在第一次时有，以后就没有了。如果错过了，那么就用下面的方法解决

http://www.redmine.org/projects/redmine/wiki/redmineinstall

# 登录你的服务器或docker容器执行
RAILS_ENV=production bundle exec rake redmine:load_default_data

# 选择 zh

时间不对

这是时区问题造成到，登录后：我的账号->首选项->时区，选择 “(GMT+8:00) Beijing”。

Redmine 主题

官方推荐主题：http://www.redmine.org/projects/redmine/wiki/Theme_List

有钱任性就直接买商业主题，没钱就用免费开源的主题，下面是一些GitHub上比较好的免费主题，亲测兼容4.x

• PurpleMine 2 我自己现在用的
• Flatly light redmine theme
• minimalflat2
• Flat theme for Redmine
• yh redmine theme
• Minelab 一个比较有质感的主题，但4.0.4版右上角的搜索有点小问题，需要自己修改一下css。

下载主题放到 public/themes 中

响应速度慢时不时的就卡十几秒

configuration.yml

查找 delivery_method属性，把值 smtp 改为 async_smtp 即可，记得重启服务。

http://www.redmine.org/projects/redmine/wiki/EmailConfiguration

不能保存中文

启动登录后发现不能保存中文字符串，原因是创建数据库的字符集不对，默认为：latin1，改为：utf8。

使用存储过程修改：https://blog.csdn.net/banche163/article/details/79746843

存储过程

DELIMITER $

CREATE PROCEDURE `redmine`.`update_char_set`()

    BEGIN
     DECLARE done INT DEFAULT 0;
     DECLARE t_sql VARCHAR(256);
     DECLARE tableName VARCHAR(128);
     DECLARE lists CURSOR FOR SELECT table_name FROM `information_schema`.`TABLES` WHERE table_schema = redmine;
     DECLARE CONTINUE HANDLER FOR SQLSTATE 02000 SET done = 1;
     OPEN lists;
     FETCH lists INTO tableName;
     REPEAT
        SET @t_sql = CONCAT(ALTER TABLE , tableName,  CONVERT TO CHARACTER SET utf8 COLLATE utf8_general_ci);
        PREPARE stmt FROM @t_sql;
        EXECUTE stmt;
        DEALLOCATE PREPARE stmt;
     FETCH lists INTO tableName;
     UNTIL done END REPEAT;
     CLOSE lists;
    END$

DELIMITER ;

调用

ALTER DATABASE redmine DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
CALL redmine.update_char_set();

升级后报错 default_assigned_to_id

ActionView::Template::Error (undefined method `default_assigned_to_id for #<Project:0x000055e1caabc230>

原因是升级后数据库有变化，需要执行一个脚本对数据库修正。下面是在官网找到的一些解决办法：

http://www.redmine.org/boards/2/topics/53364

http://www.redmine.org/issues/26485

http://www.redmine.org/projects/redmine/repository/entry/tags/3.4.2/db/migrate/20170309214320_add_project_default_assigned_to_id.rb

执行这个脚本升级数据库就行了

sh /opt/redmine-3.4.5-0/apps/redmine/scripts/redmineini.sh

脚本里的内容：

. /opt/redmine-3.4.5-0/scripts/setenv.sh
cd /opt/redmine-3.4.5-0/apps/redmine/htdocs
bin/rake generate_secret_token
bin/rake db:migrate RAILS_ENV=production

bin/rake redmine:load_default_data RAILS_ENV=production REDMINE_LANG=zh