Everything – Computer Guy's Blog

Instalacja Redmine w środowisku Windows 30 marca 2009

Ze względu na potrzeby projektu w tym tygodniu stanąłem przed, jak się później okazało prostym, zadaniem instalacji Redmine na maszynie z Windows XP Professional.
Redmine to webowa aplikacja wspomagająca zarządzanie projektem, komunikację zespołu, tworzenie wiki, logowanie czasu pracy, integrację z repozytorium i kilka innych pożytecznych rzeczy. Jest napisana w frameworku Rubby on Rails, w związku z tym aby ją uruchomić musimy go mieć zainstalowanego na maszynie. Jeśli jeszcze tego nie mamy polecam postąpienie według tego opisu.

Redmine do pracy potrzebuje bazę danych, może to być silnik MySQL, PostgreSQL lub Sqlite.
W przypadku użycia MySQL musimy w bazie utworzyć nową tabelę, najlepiej również nowego użytkownika, który będzie miał pełne prawa do tej tabeli.
Jeśli nie chcemy instalować silnika bazy danych możemy skorzystać z bazy Sqlite3. Jeśli nie mamy jej jeszcze zainstalowanej w systemie postępujemy zgodnie z tym opisem: http://artiko.net.pl/2009/03/28/instalacja-sqlite-do-wspolpracy-z-ruby-w-windowsie/.

Sama instalacja Redmine’a wygląda następująco:

• Ściągamy najnowszą wersję ze strony Ruby Forge i rozpakowujemy ją do utworzonego przez nas folderu, w którym chcemy trzymać aplikację (na przykład C:\redmine),
• w podfolderze config zmieniamy nazwę pliku database.yml.example na database.yml i otwieramy go do edycji
• jeśli używamy bazy MySQL wprowadzamy konfigurację wyglądającą tak (redmine, user i password należy zastąpić nazwą bazy danych, którą poprzednio utworzyliśmy, a user i password zamienić na nazwę użytkownika, któremu nadaliśmy uprawnienia do tabeli i jego hasło):
  production:
adapter: mysql
database: redmine
host: localhost
username: user
password: password

• jeśli używamy Sqlite konfiguracja ma wyglądać tak:
  production:
adapter: sqlite3
dbfile: db/redmine.db
• w wierszu poleceń w ścieżce C:\redmine wpisujemy:
  rake db:migrate RAILS_ENV="production"
  To utworzy nam schemat bazy oraz konto administratora
• teraz wpisujemy
  rake redmine:load_default_data RAILS_ENV="production"
  by załadować domyślną konfigurację
• generujemy hasło do szyfrowania danych w ciasteczkach:
  rake config/initializers/session_store.rb
• ponownie w linii poleceń wpisujemy
  ruby script/server webrick -e production
  i możemy uruchomić naszego własnego Redmine’a wpisując http://localhost:3000/. Login administratora to admin, hasło: admin.

Gotowe! Nasz Redmine już działa!

Jeśli chcemy uruchomić go jako usługę systemu Windows musimy doinstalować serwer Mongrel wpisujemy po kolei w linii komend:
gem install mongrel
gem install mongrel_service
mongrel_rails service::install -N redmine -c c:\redmine -p 4000 -e production
sc config myapp start= auto
net start redmine
Zainstaluje nam to serwer Mongrel oraz usługę systemową o nazwie redmine, która będzie uruchamiana automatycznie przy starcie systemu i będzie działać na porcie 4000. Można dodatkowo ustawić zależność naszej usługi redmine od serwera MySQL:
sc config myapp start= auto dependency= MySql

Jeśli będziemy chcieli usunąć usługę redmine możemy wpisać w linię komend:
sc delete redmine

W ten sposób otrzymaliśmy w pełni działającą znakomitą aplikację Redmine.