Redmine安装说明.doc

Redmine安装说明Redmine安装说明(Windows+Ruby+MySQL+Redmine方案)1. 软件软件一览表No.名称版本位置1Ruby2.0.0相关软件Rubyrubyinstaller-2.0.0-p247.exe3DevKit4.7.2相关软件DevKitDevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe (32bit)相关软件DevKitDevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe (64bit)3MySQL5.6相关软件MySQLmysql-installer-community-.msi相关软件MySQLmysql-workbench-community-6.0.6-win32.msi4Redmine2.3.2相关软件Redmineredmine-2.3.2.zip5ImageMagick相关软件ImageMagickImageMagick-6.8.6-8-Q16-x86-dll.exe软件下载地址：Ruby: (必须) /en/downloads/ （Ruby官网） /downloads/ （Windows版安装包下载地址）DevKit:(必须) /downloads (Development Kit)MySQL: (必须) /downloads/mysql/Redmine: (必须) /projects/redmine/wiki/Download （Redmine官网） /frs/?group_id=1850 （软件包下载地址）ImageMagic: (可选) /projects/redmine/wiki/HowTo_install_rmagick_gem_on_Windows2. 安装2.1. Ruby安装启动Ruby安装包。选择“English”，然后点击“OK”继续。选择“I accept the License”，然后点击“Next”继续。更改安装目录，然后点击“Install”继续。2.2. DevKit安装启动“相关软件DevKitDevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe”，开始解压。更改解压目的目录，如上所示，点“Extract”继续，进行解压。解压完成后，打开一个cmd，换到DevKit目录。（如：E:appDevKit）执行如下命令，生成config.yml文件。（生成config.yml后，可以用记事本打开看看那，里面的Ruby是否是想使用的Ruby，若不是可以手动修改Ruby路径）ruby dk.rb init执行如下命令，把DevKit扩展到相应的Ruby里去。ruby dk.rb install执行如下命令，安装json。gem install json -platform=ruby执行如下命令，测试安装好的json。ruby -rubygems -e require json; puts JSON.load(42).inspect附件：DevKit命令控制台输入例子E:appDevKitruby dk.rb initINFO found RubyInstaller v2.0.0 at e:/app/Ruby200Initialization complete! Please review and modify the auto-generatedconfig.yml file to ensure it contains the root directories to allof the installed Rubies you want enhanced by the DevKit.E:appDevKitruby dk.rb reviewBased upon the settings in the config.yml file generatedfrom running ruby dk.rb init and any of your customizations,DevKit functionality will be injected into the following Rubieswhen you run ruby dk.rb install.e:/app/Ruby200E:appDevKitruby dk.rb installINFO Updating convenience notice gem override for e:/app/Ruby200INFO Installing e:/app/Ruby200/lib/ruby/site_ruby/devkit.rbE:appDevKitgem install json -platform=rubyTemporarily enhancing PATH to include DevKit.Building native extensions. This could take a while.Successfully installed json-1.8.0Parsing documentation for json-1.8.0unable to convert x90 from ASCII-8BIT to UTF-8 for lib/json/ext/generator.so, skippingunable to convert x90 from ASCII-8BIT to UTF-8 for lib/json/ext/parser.so, skippingInstalling ri documentation for json-1.8.01 gem installedE:appDevKitruby -rubygems -e require json; puts JSON.load(42).inspect422.3. MySQL安装启动“相关软件MySQLmysql-installer-community-.msi”，开始安装。选择“Install MySQL Products”，继续。选中“I accept the license terms”，然后点击“Next”按钮，继续。选中“Skip the check for updates (not recommended)”，然后点击“Next”按钮，继续。选中“Developer Default”（如果不需要开发管理工具，则选“Server only”），更改Data Path内容为目标数据保存位置。例子为“E:appmysqldata”。然后点击“Next”按钮，继续。然后点击“Execute”按钮，继续。然后点击“Execute”按钮，继续。然后点击“Next”按钮，继续。然后点击“Next”按钮，继续。选择“Server Machine”(如果是试验部署，可以选“Development Machine”控制内存分配)。然后点击“Next”按钮，继续。设置好密码，然后点击“Next”按钮，继续。使用默认服务名，然后点击“Next”按钮，继续。（如果需要，也可更改默认服务名）点击“Next”按钮，继续。点击“Next”按钮，继续。点击“Finish”按钮结束安装。安装好之后将mysql安装目录下的bin下的libmysql.dll复制到 ruby安装目录/lib和/bin下。（/lib下面可能不需要）2.4. 数据库及用户创建用如下菜单，打开MySQL控制台。（如果数据文件不在默认位置安装，则需要更改启动快捷方式）启动的控制台如下：输入MySQL安装时候设定的密码。按回车。如上信息显示的话，表示显示登录成功。拷贝下面3条SQL语句，到控制台里执行。（my_password为redmine的密码，如果更改的话，redmine的数据库配置文件configdatabase.yml也要做相应的更改）CREATE DATABASE redmine CHARACTER SET utf8;CREATE USER redminelocalhost IDENTIFIED BY my_password;GRANT ALL PRIVILEGES ON redmine.* TO redminelocalhost;执行结果如下：ImageMagick安装启动“ImageMagick-6.8.6-8-Q16-x86-dll.exe”，进行安装。点击“Next”继续。点击“Next”继续。点击“Next”继续。点击“Next”继续。点击“Next”继续。选中“Add application directory to your system path”和“Install development headers and libraries for C and C+”，点击“Next”继续。点击“Install”开始安装。点击“Next”继续。取消选中“View index.html”，点击“Finish”结束安装。2.5. Redmine安装解压软件包把“相关软件Redmineredmine-2.3.2.zip”解压到目标目录。这里例子里，目标目录为E:app，解压后目录内容如下所示：数据库配置打开redmine安装目录（如：E:appredmine-2.3.2），然后打开config目录，复制“database.yml.example”到“database.yml”。（注意：database.yml里的默认密码为空。如果后面Redmine数据导入不成功的话，需要确认mysql是否可以空密码访问。）安装依赖的软件包安装Bundler：用如下菜单，启动“Ruby 命令行”。执行如下命令，安装bundler。gem install bundler安装mysql2 （用bundle安装会出错，所以独立安装）执行如下命令，安装mysql2gem install mysql2 -v 0.3.13 - -with-mysql-dir=C:Program FilesMySQLMySQL Server 5.6执行结果如下：E:apptgem install mysql2 -v 0.3.13 - -with-mysql-dir=%myhome%Temporarily enhancing PATH to include DevKit.Building native extensions with: -with-mysql-dir=C:Program FilesMySQLMySQL Server 5.6This could take a while.Successfully installed mysql2-0.3.13Parsing documentation for mysql2-0.3.13unable to convert x90 from ASCII-8BIT to UTF-8 for lib/mysql2/mysql2.so, skippingInstalling ri documentation for mysql2-0.3.131 gem installed安装其他Redmine依赖软件包在上步的命令行中，切换目录到redmine安装目录。（如：E:appredmine-2.3.2）执行如下命令，安装所有依赖软件包。（GemFile里使用的是“http”，安装过程可能有点慢。如果太慢或链接不上，可以打开GemFile文件，第一行改为“source /rubygems/”，使用清华镜像服务器。）bundle install -without development test备注：如果不安装rmagick的话，使用下面命令。bundle install -without development test rmagick安装过程信息如下。(多次安装的话结果有所不同)生成session密钥(Session store secret generation)执行以下命令，生成session密钥（Ruby的bin下面必须有libmysql.dll在，否则会失败）rake generate_secret_token创建数据库结构执行以下命令，创建数据库结构。set RAILS_ENV=productionrake db:migrate导入数据库初始数据执行以下命令，导入数据库初始数据。set RAILS_ENV=productionset REDMINE_LANG=zhrake redmine:load_default_data启动Web服务（WEBrick web server）执行以下命令，启动Web服务。ruby script/rails server webrick -e production显示结果如下：登录Redmine使用以下URL登录本地Redmine。:3000/显示页面如下：使用Admin/admin登录。登录成功后的页面如下。2.6. 后台运行RedmineMongrel方式（Ruby1.8,1.9好用，2.0服务登录不了）默认的webrick服务器不稳定，而且不能后台运行。这里使用mongrel代替webrick，用mongrel_service后台运行。配置环境变量把ruby的bin、DevKit的bin以及DevKit的mingw/bin加入到PATH里，如：（Path=e:appRuby200bin;C:appdevkitbin;C:appdevkitmingwbin）使用以下命令，安装mongrelgem install mongrel运行结果如下：Fetching: mongrel-1.1.5-x86-mingw32.gem (100%)Successfully installed mongrel-1.1.5-x86-mingw32Parsing documentation for mongrel-1.1.5-x86-mingw32unable to convert x90 from ASCII-8BIT to UTF-8 for lib/http11.so, skippingInstalling ri documentation for mongrel-1.1.5-x86-mingw321 gem installed使用以下命令，安装mongrel_servicegem install mongrel_service运行结果如下：Fetching: mongrel_service-0.4.0.gem (100%)Successfully installed mongrel_service-0.4.0Parsing documentation for mongrel_service-0.4.0Installing ri documentation for mongrel_service-0.4.01 gem