Installing Redmine 2.5.2 under Windows is not a complete guide

I decided to introduce redmine in the project to manage the development tasks and plans, as for the advantages of Redmine, please give a mother or brain repair.

Internet to search for. It's basically the old version number. 1.2.1 The most, I want a new ah, so just good myself.

This paperMain references Redmine Wiki installation page:Http://www.redmine.org/projects/redmine/wiki/RedmineInstall , the problems encountered themselves to conquer a bit.

In short, it is not a translation, but a practice record.

Environmental descriptive narrative

The server operating system is Windows Server R2 Enterprise. 64-bit version number.

Rails 3.2.19,ruby is 1.9.3p545.

Redmine is 2.5.2 version number.

MySQL is the 5.5.40 Win32 version number.

ImageMagick for Imagemagick-6.8.9-8-q16-x86-dll.

Installation and Configuration

Redmine is based on the Ruby on Rails, I choose the latest version number 2.5.2. Please visit the installation page in the Redmine wiki site for more information.

As of the time I wrote the blog (October 17, 2014), the latest version is 2.5.2.

Dependent selection

Let's start by explaining the environment and software that Redmine relies on.

Can run Ruby operating system can run Redmine, according to the company, I found a server 2008 computer.

Redmine's reliance on Ruby and Rails. For example, with:

Redmine 2.5 version requires Rails with a version number 3.2 and above. Support for 1.8.7, 1.9.2, 1.9.3, 2.0.0, 2.1, and other versions of Ruby. Later I chose RailsInstaller-2.2.4 to install Ruby and rails, which included the rails version number 3.2.19 and the ruby version number is 1.9.3p545. Meet the requirements of Redmine.

Redmine supports MySQL as a database backend. Requires a version number of 5.0 or higher.

I chose Community Edition Server, the version number is 5.5.40.

ImageMagick is an optional dependency that exports project data such as a Gantt chart in Remine to a PNG picture. Other optional dependencies are the version number management tool. For example, SVN. Redmine can be integrated with the version number management system. Suppose you want to support the Open ID. Ruby OpenID Library is also required. 2 or higher version number.

All right. The installation process is now started.

Railsinstaller Installation

The diagram is easy. Use Railsinstaller to configure Rails and Ruby, which is easy to install with one click.

The site is here: Railsinstaller.

As you can see, select the installation package under Windows to download:

In writing, the version number of Railsinstaller is 2.2.4, and the Ruby and Rails are compiled with Mingw32, and MySQL is to be matched. It has to be 32 bits.

The installation process is a little bit crazy Next. The first is the Welcome page:

Apart Poke Next button, the License Agreement page appears:

Accept it, then poke Next button, let you choose the installation location and additional software and settings. For example, with:

The space required is not big, let's choose. Click the Install button to start the installation.

For example, with:

Wait, still able to ...

See just OK:

Click Finish, Pro. And then what. You see the command-line environment for Ruby and Rails:

So far, Ruby and Rails are ready to install.

MySQL Installation

MySQL's official website is as follows:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

You can choose a version number, greater than 5.

I use the 5.5.40 x86 32bit MSI installer. Downloaded the Mysql-5.5.40-win32.msi. The following is the installation Welcome screen:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

I'm next, just click Next, dot Bar is not sin ... Look, the Protocol page:

Only accept, the ability to enjoy the pleasure of poking Next.

Under Stamp, go to the Installation Type page:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

I chose the full installation. And not much space. Re-poke Next to the Ready interface:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

With your helpless fingers, click Install, then we can just look at the progress bar in a daze:

Why did, did you build it? It came out. Enterprise version of the interface:

Cancel and back are all grey, a little bit like the feeling of being forced to shop on a tour of the group ... Don't get it, poke Next with your breath and see what it can do.

Next, yes, the wood has a, back to the progress bar ha, the original is only a propaganda, just, not so bad ha ...

The following is the installation complete interface:

MySQL will have to do a configuration after loading. You fancy that check box. The default is selected.

Let's say that this machine has no already configured MySQL, let him go, click on your favorite Finish button!

(If you have installed and set up MySQL root account password, there may be a problem, you do not choose this "Launch the MySQL Instance Configuration Wizard" option, run to the Start menu or the bin file under the installation folder Clip. Find the Mysqlinstanceconfig point now. The wizard will give you a chance to change the root of the password. ）

My computer was originally installed by a colleague MySQL, I thought deleted ... As a result, the bunker thing is in the back, let's not mention it, see MySQL Configuration Wizard:

Next Party, poke it happily. Next, let's choose your configuration type:

I chose the standard Configuration. Continue Next and arrive at the Service configuration:

As you can see. I chose to install the Windows service and boot, and also added the MySQL Bin folder to the system environment variable PATH, so that you can access the question anytime and anywhere.

Poke Next. Then you should set up your account:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

I chose Modify Security Settings and didn't want to bury the mines without creating anonymous users. A cheerful poke down next, I arrived at the ready page:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

can see it. So happy! Still waiting. Embrace Execute now. Note that you start to run your previous configuration:

I hum a ditty in my heart. Just waiting for it to go out of the jump Finish interface, who knows, was frightened. Please see:

Wow, the security settings failed! Either because the firewall settings caused the connection not on the 3306 port, or the previous installation of MySQL, uninstall did not clear the Data folder, resulting in root password is still there.

What kind of me is it?

I think it might be a firewall. Because the colleague said that MySQL has been deleted. So I put mysqld, MySQL and so on to the exception, and then to the inbound rule there set up a 3306-port rule, a half-day effort. Finally came back to Retry. Hey, play this again.

I just called my colleague and asked about the previous MySQL password ... And then, Skip.

Go back to the Bin folder, find Mysqlinstanceconfig to run, and keep that laborious configuration just now. There are changes to the account here, for example with:

Look. Look, it's different.

This episode tells us. The foreplay must be full, otherwise ...

This time to get down, smoothly saw the long-awaited Finish AH:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

Database configuration OK, Kiss!

ImageMagick installation

Go here to download:

Choose imagemagick-6.8.9-8-q16-x86-dll.exe that download.

then run it.

I decided not to install this thing, first run the Redmine to see. Need to be reconfigured later.

Redmine Installation and Configuration

Redmine here to download: Http://www.redmine.org/projects/redmine/wiki/Download.

Remember the version number 2.5.2 Oh.

After the ZIP package has been downloaded, unzip it to the C:\Sites folder below. This will be installed!

The following is the configuration, the moment of the torsion is so come, do not know whether to be happy or sad ...

Copy Libmysql

For Redmine to be able to connect to MySQL normally. Need MySQL's C API library. That is Libmysql.dll. Over here:

Copy to the Ruby's Bin folder. What you see:

Installing MYSQL2

Redmine need MYSQL2 (MySQL C binding for Ruby) is said to improve performance and you can install it in the command-line environment of Ruby and Rails by running the following command:

Gem Install MYSQL2

I just made a mistake here.

Darling, lack of thread.h. Checked the next. This header file is not really in Ruby.

Network A blind search, time flies ah. I'm angry, I'm going to find a thread.h. I want to change the Ruby version number!

Search and find, thread.h, the trail of ... Later, I came here:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

Ah, aha. Yes, rubyinstaller.org, that's it. I picked up the Ruby 2.0.0-p576 download, found the Ruby/thread.h file in the 7z package, and copied it to the C:\RailsInstaller\Ruby1.9.3\include\ruby-1.9.1\ruby folder below.

Is everything all right?

Run the gem install MYSQL2 again. Wrong again ...

Rattling. I can't find mysqlclient this library!

Depending on the error message, you need to specify the location of MySQL C connector.

Use--with-mysql-dir to specify the location of MySQL. The gem installation then relies on MySQL header files and library files at the specified location. It is necessary to note that there are no spaces in the path, such as program Files (x86), the path will be wrong, so I copied the include and Lib folders, placed in the C:\mysql_sdk folder. So I run the following command:

Gem install mysql2----with-mysql-dir= "C:/MYSQL_SDK"

Will you pass the customs this time? The heart is disturbed unceasingly ... The ups and downs of life come too fast. Be careful with the liver can't bear it ... You see. That's how it all goes:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

Build Library

Take a picture of my build library. It includes commands. For example, the following:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

The basic steps are Jiangzi: Run MySQL 5.5 Comand line Client from the Start menu and enter password. Log on successfully, create a library redmine, create a user redmine, and authorize access to the Redmine library.

Configure Database connections

The C:\Sites\redmine-2.5.2\config folder under the Database.yml.example in situ copy a copy, the name changed to DATABASE.YML. Then open it with a text editor, and the database connection is configured in Database.yml.

How happy Ah, Redmine the default configuration is for MySQL. You see:

See, we just need to change production this configuration. In general you just have to change password (in fact you can change the username to redmine,password corresponding).

For example, my configuration:

Production:  adapter:mysql2  database:redmine  host:localhost  username:root  Password: "Zc_ Redmine "  Encoding:utf8

Installation dependencies

First install bundler, Redmine use it to maintain gems dependencies.

Command:

Gem Install Bundler

Then to confirm that you are below the C:\Sites\redmine-2.5.2 folder, do not use the CD command to go in, and then run the following command to resolve the redmine need to rely on:

Bundle Install--without Development test

This will try to install MYSQL2 again. Since we specified using MYSQL2 as the database adapter in production.

Suppose the discovery has been installed. Directly with the Local. You will see information such as using XXX, such as:


The installation process is long ... Hope to succeed, but! It's a premature death!

See:


The original is Rmagick Ah, first skip count, run this command:

Bundle install--without Development test Rmagick

My heart is waiting. Always waiting ... Bingo! There is a picture of the truth:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

And finally we can move on. What a nose drops a tear ...

I'd like to say two words. Suppose you have failed the bundle install and can be based on the failure prompt. See which GEM has a problem. Then run the installation operation separately to find out where the problem is ... It's just a loop, and it's always done.

Life needs positive energy, it will be fixed.

Generate session Store secret key

Since our Redmine version number is 2.x, run this command:

Rake Generate_secret_token

The above command generates a random Key, which Rails uses to encrypt the cookie ...

So simple a command, also can be wrong ... Look at the picture:

The issue of version number Ah, listen to people advised, so do:

Bundle EXEC Rake Generate_secret_token

The dawn is quiet here ... Run this command, even if the wood has no matter what output, is it successful? And walking ...

Create a database structure

To create the database structure, use the following command:

Set Rails_env=productionbundle exec Rake db:migrate

Note is a run Ah, the back does not remind ... Also, because of my rake version number, it was only good to add the bundle exec in front of each call to rake.

It creates a series of tables. Set the permissions of the table, but also create an administrator account, is no one in the sky unknown admin . Password is also admin.

See this figure below. Description OK la la la:

Database default data settings

Use the following command to insert the default configuration data into the database:

Set Rails_env=productionbundle exec Rake Redmine:load_default_data

Run one line at a line.

The second run time. Will let us set the language. What you see:

I chose zh, then enter. Very fast is OK:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

It's another pass. We still have to go, because. Anta, never stopping.

Test installation

Unconsciously, unexpectedly to this step! Is this the rhythm to end?

Talk less, hurry up, run the following command:

Ruby Script/rails Server WEBRICK-E production

You are my eyes, take me to the transformation of the Four Seasons ... Just tell me, did you see this picture:

Watermark/2/text/ahr0cdovl2jsb2cuy3nkbi5uzxqvzm9ydw9r/font/5a6l5l2t/fontsize/400/fill/i0jbqkfcma==/dissolve/70 /gravity/southeast "/>

Congratulations to you. Redmine has been successfully started!

From the output information, it listens to 0.0.0.0:3000, so you can visit http://localhost:3000 to see the effect. You can also access the actual IP address, for example http://192.168.1.30:3000. Effects such as those seen in:

Click Sign in at the top right corner to see the following pages:

Do you remember our admin account? Enter, click the Login button, go in, casually point, you may see this interface:

All right. End You can enjoy the pleasure of being under the authority of the administrator. You can define roles, define workflows, create members ... Oh, whoa. It's really good.

Just, Long March just started, the environment is ready, how to put the project management process in Redmine, but the road long its repair far ...

??

Installing Redmine 2.5.2 under Windows is not a complete guide