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,
Przez przeglądarkę wchodzimy na adres: http://localhost:8080/manager/html/ 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.
Jeśli nie mamy ustawionego JDK w IntelliJ, to pojawi się następujący ekran: 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.
Jeżeli wszystko przebiegło pomyślnie, naszym oczom powinien ukazać się wczytany projekt. 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