TinyPM - instalacja

Możliwości instalacji

W tym wpisie pragnę przedstawić proces instalacji systemu TinyPM. Zainstalować go możemy na dwa sposoby:

• instalator (systemy operacyjne z rodziny Windows);
• deploy aplikacji webowej;

Użycie instalatora w zasadzie sprowadza się do zapisania na dysku specjalnie spreparowanego serwera Tomcat-a wraz z od razu zdeployowaną na nim aplikacją. Uruchomienie systemu TinyPM (np. z poziomu menu Start) sprowadza się wówczas do "odpalenia" serwera aplikacji Tomcat.

Instalacja z użyciem instalatora

Pobieżny opis w języku angielskim tej instalacji można znaleźć tutaj: http://www.tinypm.com/blog/?page_id=31

Aby zainstalować TinyPM przy pomocy instalatora trzeba spełnić następujące warunki:

• zainstalowane JRE (wystarczające) albo JDK w wersji przynajmniej 5.0;
• ustawienie zmiennych środowiskowych %JRE_HOME% oraz wykorzystanie tej zmiennej w dodaniu kolejnej ścieżki do zmiennej %PATH%;

Instalacja dobywa się w najprostszy sposób i zawiera domyślną konfigurację: oparta jest o serwer Tomcat oraz bazę danych HSQLDB.

Po zainstalowaniu oraz uruchomieniu (np. z menu Start) aplikacji możemy z niej skorzystać wpisując do przeglądarki adres: http://localhost:8080/ Nazwa użytkownika oraz - odpowiednio - hasło to admin/admin

Możliwości konfiguracji zainstalowanej tym sposobem aplikacji są bardzo niewielkie i ograniczają się do zmian w pliku [ścieżka do katalogu z zainstalowanym TinyPM]\db\tinypm.properties - i jest to zmiana wyłącznie parametrów działania bazy danych HSQLDB które to parametry nie mają istotnego znaczenia w typowym wykorzystaniu aplikacji TinyPM.

Instalacja aplikacji z pliku .war

Wersja angielska tej instrukcji (nieco okrojona) znajduje się w tym miejscu. Dodatkowe informacje można znaleźć także w pliku INSTALL.txt dołączonym do archiwum aplikacji TinyPM dla określonego rodzaju serwera aplikacji.

Wymagania

TinyPM instalujemy na dedykowanym do tego celu serwerze aplikacji. Wspieranym typem jest serwer Tomcat (minimalna ilość pamięci to 256 MB) w wersjach 5.x oraz 6.x. Oprócz serwera (oraz oczywiście Javy - wystarczy JRE - co najmniej wersja 5.x) potrzebujemy jeszcze bazy danych MySQL w wersji co najmniej 5.0.x. Do połącznia aplikacji z bazą danych wymagany jest konektor bazy MySQL dla języka Java - wersja co najmniej 5.1.x.

Zależności

W paczce instalacyjnej aplikacji (po rozpakowaniu wcześniej pobranego archiwum) w katalogu dependences znajduje się parę bibliotek - o ile nie są one dostępne w katalogu %CATALINA_HOME%/lib to - z pobranym wcześniej plikiem konektora MySQL-a należy je tam skopiować (o ile już się tam nie znajdują).

Instalacja bazy danych

Potrzebujemy stworzyć nową bazę danych dedykowaną dla obsługi aplikacji TinyDB:

CREATE DATABASE tinypmdb CHARACTER SET = 'utf8' COLLATE = 'utf8_general_ci';

Następnie musimy utworzyć użytkownika z uprawnieniami SELECT, UPDATE, INSERT oraz DELETE:

GRANT SELECT, UPDATE, INSERT, DELETE ON tinypmdb.* TO tinypm'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

Na koniec odpalamy skrypty które stworzą odpowiednie struktury danych w świeżo utworzonej bazie oraz wypełnia je danymi:

\u tinypmdb
\. %PATH_TO_INSTALL_FOLDER%/database/mysql/create_schema-1.3.02.sql
\. %PATH_TO_INSTALL_FOLDER%/database/mysql/create_data-1.3.02.sql

Instalacja aplikacji TinyPM

Ponieważ nie jest rekomednowana instalacja aplikacji na uruchomionym serwerze dlatego na początku musimy zatrzymać serwer. Wypakowywujemy tinypm.war do bazowego katalogu webapps:

  %CATALINA_HOME%/webapps

Modyfikujemy plik kontekstu aplikacji ustawiając użytkownika oraz hasło. Wspomniany plik znajdziemy w następującej lokalizacji:

%CATALINA_HOME%/webapps/tinypm/META-INF/context.xml

Uruchamiany serwer aplikacji Tomcat, a po jego uruchomieniu wpisujemy w pole adresu przeglądarki adres: http://localhost:8080/tinypm i do logowani używamy loginu oraz hasła które dodaliśmy we wcześniejszym akapicie.

Uzyskiwanie klucza licencji

Darmowy klucz licencji pozwala na stworzenie do pięciu projektów oraz do pięciu osób biorących udział w projekcie. Jest on potrzebny zaraz po uruchomieniu aplikacji oraz zalogowaniu się do niej jako administrator dlatego jego wykorzystanie omówię w tym wpisie.

Logujemy się na tej stronie (w przypadku gdy nie mamy na niej swojego konta, konieczne będzie jego założenie). Po zalogowaniu pobieramy dostępny nam klucz, zapisujemy na dysku, a następnie logujemy się do odpalonej zgodnie z wcześniejszą instrukcją aplikacji. Tam w menu 'Konfiguracja' odszukujemy fragment strony która odpowiada zarządzaniu licencjami. W formularzu: 'nowy plik licencji' odszukujemy na dysku wcześniej zapisany plik z licencją i klikamy przycisk/link 'zainstaluj nową licncję'.

Od tej pory możemy cieszyć się z aplikacji TinyPM którą sami zainstalowaliśmy.