Full text guide for redmine Installation

ArticleDirectory

• Installation preparation
• Installation and configuration

I chose redmine because the Organization needed a set of project management software, mainly focusing on its open source, rich plug-ins, and Chinese support. I have not had much contact with ror and MySQL before. I have referenced a large number of articles on the Internet and encountered many twists and turns during installation. Therefore, I will refine the installation process to every step to form a graphic Installation Guide, hoping to be useful to you.

This blog post mainly references the following articles:

Http://www.redmine.org/projects/redmine/wiki/RedmineInstall

Http://xinlanzero.iteye.com/blog/857494

For troubleshooting of bugs, refer:

Http://www.redmine.org/boards/2/topics/22358

Http://www.redmine.org/issues/7516

Http://www.redmine.org/boards/2/topics/6423? R = 6447.

Http://rordiary.com/blog/2010/03/192/

Installation preparation

Download the software that will be used during the following installation process, as shown in:

1. Ruby 1.8.7: http://rubyforge.org/frs/download.php/74293/rubyinstaller-1.8.7-p334.exe

2. MySQL: http://www.mysql.com/downloads/mysql/5.5.html#downloads

3. redmine masterProgram: Http://www.redmine.org/projects/redmine/wiki/Download

4. Win32 OpenSSL light:
Http://www.slproweb.com/download/Win32OpenSSL_Light-1_0_0d.exe

5. Visual C ++ 2008 redistributables:
Http://www.microsoft.com/downloads/details.aspx? Familyid = 9b2da534-3e03-4391-8a4d-074b9f2bc1bf & displaylang = en ." Error)

6. zlib 1.2.5: http://www.zlib.net/zlib125-dll.zip (this address seems to be invalid ...... Where does my version come from ...... Khan ...... Then try this: http://ishare.iask.sina.com.cn/f/9662774.html)

7. libiconv 1.9.2: http://sourceforge.net/projects/gnuwin32/files/libiconv/ (used when running rake)

Install and configure Ruby

1. Install the rubyruntime environment (rubyinstaller-1.8.7-p334.exe), as shown in figure

2. Check the above two items during installation.

3. Start installation until installation is complete.

4. Run "Start command prompt with Ruby" in the Start menu to open the ruby command line.

5. Run the following command to install the rails framework:

Gem install rails-V = 2.3.5

Ruby downloads the rails framework files and documents over a network and automatically starts installation. This process takes about 10 minutes. As shown in. If no error message is reported, continue to the next installation.

6. Run the following command to install RAKE:

Gem install rack-V = 1.0.1

7. Run the following command to install MySQL C bindings:

Gem install MySQL

This command will install MySQL C bindings online, which can significantly improve the performance of accessing the database

Install MySQL

1. Run the mysql-5.5.9-win32.msi to start installation, as shown in

2. After the installation is complete, use "MySQL instance Configuration Wizard" to start configuring MySQL, as shown in

Select detailed configuration to adjust parameters, as shown in figure

If you select the server environment, MySQL will make reasonable use of the existing memory. If you install it on your own machine, you can select the developer machine environment to avoid occupying too much resources.

Enable the TCP/IP network and set reasonable database ports, as shown in.

Here you need to manually set the default Character Set: utf8, as shown in.

Select "Install as a Windows Service" and "add the bin directory in the Windows PATH environment variable", as shown in.

Set the default administrator password for the server. For example.

After the configuration is complete, the system starts to configure. If the configuration is successful, the result page is displayed.

3. Open the windows command line and switch to the bin directory under the MySQL installation directory (I am a little white, but I don't need to talk about this switch any more ?), Then run the following command to enter the MySQL command line:

Mysql-u root-P

Enter the server password and log on to MySQL. Then, the command line prompt will be switched to "mysql>", indicating that the logon is successful.

4. Run the following command in MySQL command line mode to create a redmine database:

Create Database redmine Character Set utf8;

Press enter to create a database for redmine.

PS: the command line of the MySQL database must end with ";" before execution. If you have never touched MySQL, the key is P (because I am stuck here)

5. Create a redmine database user and password, and grant permissions: (you must change the user name, server name, and password between the quotation marks)

Create user 'redmine '@ 'localhost' identified by 'my _ password ';

If no error message is displayed, the creation is successful.

Perform the following authorization operations:

Grant all privileges on redmine. * To 'redmine '@ 'localhost ';

PS: if an error occurs when creating a user, run the following command to delete the user:

Drop user 'redmine '@ 'localhost ';

Install OpenSSL and configure Ruby

1. Install visual c ++ 2008 redistributables

2. Install Win32 OpenSSL light. For example

3. Select copy OpenSSL DLLs to the Windows System directory on this page"

Otherwise, you must manually copy the DLL file under the OpenSSL installation directory to the Windows System directory (for example, c: \ windows \ system32) or Ruby bin directory (for example: c: \ ruby-1.8.7 \ bin)

4. Complete the installation according to the wizard. As shown in (haha, you don't need to choose to donate: P)

5. Decompress zlib1.dll in the installation package of zlib 1.2.3 to the Windows System directory or Ruby bin directory and change it to zlib. dll.

6. Decompress bin \ iconv. dll in the installation package of libiconv 1.9.1 To the Windows System directory or Ruby bin directory (this step can be skipped)

Install the redmine main program

1. decompress the redmine installation package to a directory (for example, c: \ redmine-0.9.1) and set config \ database. yml. copy example to config \ database. yml, and modify the database configuration of the "production" segment in this file. For example:

Production: Adapter: MySQL Database: redmine HOST: localhost Username: Root (enter the username you want to use to log on to MySQL) Password: Password (enter the user password here)

2. run libmysql In the MySQL installation directory. copy the DLL file to the ruby installation directory (for example, c: \ ruby-1.8.7 \ bin), and switch to the redmine installation directory (for example, C: \ redmine-1.1.1 \), run the following command:

Rake config/initializers/session_store.rb

If an error occurs, run the following statement to install an international component:

Gem install-V = 0.4.2 i18n

3. Use the following command to create a database structure:

Rake DB: migrate rails_env = "production"

This command creates a database structure for production. This is a key step. I have installed redmine only after several attempts, and there may be many problems in this step. If you encounter other problems, you can search for the Problem description on redmine. Generally, there are satisfactory answers.

PS1: if the error "MYSQL: Error: The 'innodb' feature is disabled" occurs, you must enable MySQL database support for InnoDB and open my in your MySQL installation folder. in the INI file, locate skip-InnoDB, change it to # Skip-InnoDB, and restart MySQL (Note: run the MySQL Command show variables like "have _ %"; to check whether InnoDB is enabled)

PS2: if the error is shown, You need to modify the redmine installation directory \ config \ environment. RB script.

After the environment. RB script is opened, add the following statement between Bootstrap and initialization:

# Add the statement -- espie between Bootstrap and initialization If Gem: version> = "1.3.6" Module rails Class gemdependency Def Requirement R = super (R = GEM: requirement. Default )? Nil: R End End End End

As shown in, save and exit.

PS3:

If the error is shown, it is caused by incompatibility between rails and MySQL for win. Replace the libmysql. dll file of MySQL with the old version.

Download the old version from here:
Http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll

Http://rordiary.com/blog/wp-content/uploads/2010/03/libmySQL.zip

Then, replace it with the ruby installation directory \ bin.

4. continue to run the following command:

Rake redmine: load_default_data rails_env = "production"

This command will fill in the default configuration data. Select a language when running the command. Enter ZH (Simplified Chinese), as shown in. If it fails, it may be caused by the previous failure.

Start the redmine main program

5. In Ruby command line mode, switch to the redmine main directory and run the following command:

Ruby script/Server webrick-e Production

This command will use webrick to publish and run redmine! As shown in.

6. Open your browser and visit the following url: http: // localhost: 3000/. Use the user admin (password admin) to log on!