Instrukcja instalacji
Niniejsza instrukcja obejmuje instalację krok po kroku narzędzi potrzebnych do uruchomienia aplikacji ERS pod systemem Windows. Ze względu na uniwersalność użytych rozwiązań możliwe
jest również uruchomienie pod innymi systemami operacyjnymi.
1) Instalacja JDK
JDK można pobrać z tej strony:
http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html Upewnić się, że ścieżka do katalogu (...)jdk1.7.0_17\bin\ jest w zmiennej systemowej "Path", a ścieżka do (...)jdk1.7.0_17\ jest w zmiennej "JAVA_HOME".
(Computer->Properties->Advanced System Settings->Advanced->Environment Variables) 2) Instalacja IDE IntelliJ
Można pobrać stąd: http://www.jetbrains.com/idea/download/index.html Comunity Edition (FREE)
3) Instalacja MySQL
Można pobrać ze strony: http://dev.mysql.com/downloads/mirror.php?id=412168
Podczas instalacji należy wybrać wszystko, w szczególności MySQL Server i MySQL Workbench.
W tym kroku trzeba ustawić hasło do bazy, które będzie wykorzystywane później.
4) Instalacja Mavena
Strona, z której można pobrać:
http://ftp.ps.pl/pub/apache/maven/maven-3/3.0.5/binaries/apache-maven-3.0.5-bin.zip Po pobraniu należy rozpakować.
Ustawiamy 2 zmienne systemowe:
Dodajemy do Path: (...)apache-maven-3.0.5-bin\apache-maven-3.0.5\bin\
Tworzymy zmienną "M2_HOME" i wklejamy do niej:
(...)apache-maven-3.0.5-bin\apache-maven-3.0.5\
Uwaga!
Slash na końcu ścieżek jest ważny!
5) Instalacja Tomcata
Można pobrać z: http://ftp.ps.pl/pub/apache/tomcat/tomcat-7/v7.0.37/bin/apache-tomcat-7.0.37.exe Najlepiej zostawić domyślne porty. Po tej instalacji powinno być wszystko ustawione.
Aby sprawdzić czy działa, należy uruchomić program Monitor Tomcat i kliknąć start.
Następnie poprzez przeglądarkę wchodzimy na stronę localhost:8080.
Ustawienie uprawnień do managera:
Uruchamiamy dowolny edytor tekstu (np. Notatnik) w trybie administratora.
Otwieramy plik (...)\Tomcat 7.0\conf\tomcat-users.xml Na końcu dodajemy:
<role rolename="tomcat"/>
<user username="tomcat" password="tomcat" roles="manager-gui,manager"/>
Następnie zapisujemy plik i restartujemy Tomcata,
i naszym oczom powinien ukazać się mniej więcej taki widok:
6) Instalacja klienta GITa i checkout Pobieramy klienta GITa:
https://code.google.com/p/msysgit/downloads/detail?name=Git-1.8.1.2- preview20130201.exe&can=2&q=full+installer+official+git
Po instalacji, z poziomu konsoli wywołujemy:
git clone ssh://nazwauzytkownika@git.code.sf.net/p/programowanieze/code programowanieze-code Zastępując „nazwauzytkownika” swoją nazwą użytkownika.
Zostaniemy poproszeni o podanie hasła.
Po tym kroku w katalogu powinien pojawić się projekt.
7) Import projektu do Intellij
Po uruchomieniu aplikacji wybieramy File->Import Project
Wybieramy plik pom.xml z katalogu "programowanieze-code", który jest w katalogu, który utworzyliśmy wcześniej.
Zaznaczmy opcje "Search for projects recursively" oraz "Import Maven projects automatically".
Klikamy Next i jeszcze raz Next.
Należy wybrać "+" i "JDK". Klikamy Next. Następnie wybieramy swoje JAVA_HOME, czyli miejsce, gdzie zainstalowaliśmy JDK. Klikamy OK.
Powinno pojawić się:
Klikamy Next, potem Finish i ewentualnie Yes.
8) Uruchomienie
Przed uruchomieniem w pliku: programowanieze-code\src\main\resources\datasource.xml należy podać dane do połączenia z bazą danych.
Najpierw należy upewnić się, że MySQL Server i Tomcat są uruchomione.
Jeżeli tak, możemy przystąpić do zbudowania projektu.
W środowisku IntalliJ klikamy na Maven Project znajdujące się z prawej strony.
Następnie na Lifecycle oraz po kolei na: clean, validate, compile, test, package, install.
Projekt powinien zbudować się bez błędów.
Zwracamy uwagę na to, gdzie wygenerowały się pliki, a szczególnie nasz plik war.
(np. C:\Users\Natalia\.m2\repository\org\madbit\hibernate\spring-hibernate4\1.0.0- SNAPSHOT\spring-hibernate4-1.0.0-SNAPSHOT.war)
Kopiujemy podaną ścieżkę do schowka.
W managerze (http://localhost:8080/manager/html), w sekcji Deploy wybieramy plik wklejając skopiowaną wcześniej ścieżkę, po czym klikamy na Deploy.
W tym momencie aplikacja ERS powinna być widoczna na liście.
Uruchamiamy poprzez kliknięcie w nazwę.
9) Baza danych
W katalogu z projektem znajduje się plik ers_db.sql, który zawiera schemat bazy danych wraz z przykładowymi danymi.
Aby wczytać plik poprzez MySQL Workbench należy:
Po uruchomieniu, z prawej strony, przy „Server Administration” kliknąć prawym przyciskiem myszy na „Local MySQL” i wybrać „Manage Instance”.
W nowo otwartej karcie, z menu po lewej wybrać „Data Import/Restore”.
Następnie zaznaczamy „Import from Self-Contained File”, wybieramy plik i klikamy „Start Import”.
10) Konfiguracja
Domyślnym administratorem jest użytkownik „admin” z hasłem „1234”. Można to zmienić w pliku: programowanieze-code\src\main\resources\spring-security.xml.
Skrzynkę e-mail, z której będą wysyłane powiadomienia dla studentów ustawia się w pliku:
programowanieze-code\src\main\resources\Spring-Mail.xml