Warszawa, dn - TOP

TT MIESZKANIE 2.0
Instalacja
Poniżej
w
TT-Mieszkanie
kilku
w
krokach
wersji
2.0.
zostanie
W
przedstawione
celu
instalacji
jak
proszę
zainstalować
ściągnąć
program
archiwum
zip
„TTMieszkanieAktualizacja.zip”, w którym zawarte są wszystkie niezbędne pliki.
Wymagania:

Serwer bazy danych Firebird w wersji co najmniej 2.0.

Serwer Tomcat powinien mieć wersję co najmniej 6.0. oraz powinien mieć zainstalowaną
usługę „Manager”.

Środowisko Java w wersji min. 1.6.
Słownik:
TOMCAT_HOME – główny katalog serwera Tomcat, domyślnie:
C:\Program Files\Apache Software Foundation\Tomcat 6.0\
Instalacja środowiska:
1. Proszę zainstalować środowisko JAVA JRE w najnowszej wersji (obecnie 7). http://portal.topteam.pl/programy/tt-mieszkanie/pliki-do-pobrania
2. Proszę zainstalować serwer bazy danych w wersji co najmniej 2.0. Zalecana wersja to 2.5.1.
Plik instalacyjny jest do ściągnięcia ze strony: http://www.firebirdsql.org/en/firebird-2-5-1/
a. Instalacja serwera bazy danych nie wymaga szczególnych ustawień, proszę
postępować zgodnie z instalatorem aplikacji.
3. Proszę zainstalować serwer Tomcat w wersji co najmniej 6.0. Jest on do ściągnięcia z naszego
serwera, skąd pobraliście Państwo pliki instalacyjne programu TT-Mieszkanie.
http://portal.top-team.pl/programy/tt-mieszkanie/pliki-do-pobrania
a. Podczas instalacji serwera Tomcat należy postępować zgodnie z zaleceniami
instalatora aplikacji.
b. W jednym z kolejnych kroków zobaczą Państwo ekran, który odpowiada za
konfigurację instalowanego serwera (patrz następna strona). W miejscu czerwonej
kropki należy wpisać login do usługi „manager”, który będzie potrzebny w kolejnych
etapach instalacji. W miejscu zielonej kropki należy wpisać hasło, a w polu
oznaczonym niebieską kropką po przecinku należy dopisać frazę:
„manager-script,admin-gui”.
c. Klikamy „Next” i już standardowo kończymy instalację.
d. Jeśli serwer Tomcat został po instalacji uruchomiony, proszę go wyłączyć za pomocą
menu rozwijanego, które otworzymy po kliknięciu prawym przyciskiem myszy na
ikonę w pasku zadań Windows (prawy dolny róg).
Instalacja programu TT-Mieszkanie:
1. Upewnić się, że serwer Tomcat jest wyłączony.
2. Do wybranego katalogu na dysku (np. C:\topteam\) wklejamy katalog „mieszkanie_baza”,
który zawarty jest w archiwum ZIP aktualizacji (jest to pusta baza danych).
3. W tym samym katalogu (np. C:\topteam\), lub w innym dowolnie wybranym przez Państwo
miejscu proszę utworzyć katalog „mieszkanie_pliki”. W nim będą przechowywane wszystkie
wygenerowane pliki przez program TT-Mieszkanie.
4. Przechodzimy do katalogu TOMCAT_HOME\conf i wklejamy do niego pliki „mieszkanie.xml”,
„tt_manager.xml”, które zawarte są w archiwum ZIP aktualizacji.
5. Edytujemy plik „mieszkanie.xml”. W kluczu „db.url” zastępujemy ciąg znaków DB_SCIEZKA
właściwą ścieżką do katalogu, w którym znajduje się baza danych (patrz krok 2.).
(np. C:/topteam/mieszkanie_baza – proszę zwrócić uwagę na kierunek
ukośników!).
6. W kluczu „eksport.dir” zamiast frazy PLIKI_SCIEZKA wpisujemy ścieżkę do katalogu, w którym
będą zapisywane eksportowane pliki - przelewów oraz inne. Zwróć uwagę na kierunek
ukośników! Przykładowy cały klucz:
<entry key="eksport.dir">C:\topteam\mieszkanie_pliki</entry>.
7. Edytujemy plik „tt_manager.xml”. Dla Tomcat’a 7 klucz „menadzer.suffiks” powinien zawierać
wartość „/text”, dla Tomcat’a 6 powinien pozostać pusty.
Przykładowy cały klucz: <entry key="menadzer.suffiks">/text</entry>.
8. Nadając wartość „true” dla klucza „ustawienia.autopobieranie” pozwolimy aplikacji TTManager na automatyczne pobieranie aktualizacji, jeśli tylko pojawią się dostępne.
9. Nadając wartość „true” dla klucza „ustawienia.autoinstalacja” pozwolimy instalować
automatycznie aktualizacje, które wcześniej zostały ściągnięte. Klucze „ustawienia.godzinaOd”
oraz „ustawienia.godzinaDo” pozwalają ustawić zakres godzin, w których wykonają się
automatyczne aktualizacje.
10. Klucze „manadzer.login” oraz „manadzer.haslo” powinny zawierać login oraz hasło do
użytkownika usługi „Menager” wbudowanej w serwer Tomcat (patrz punkt 3.b. instrukcji
instalacji środowiska). Użytkownik ten powinien mieć przyznane role „manager-gui, managerscript, admin-gui”. Jeśli nie instalowano serwera jak w pkt. 3.b. proszę wykonać następujące
czynności:
Odpowiedniego wpisu należy dokonać w pliku „tomcat-users.xml” znajdującym się w katalogu
„TOMCAT_HOME\conf”. Przykładowy wpis:
<user name="manager" password="manager" roles="admin-gui,managergui,manager-script" /> - powinien znajdować się wewnątrz tag’a „<tomcat-users>”.
11. Do katalogu TOMCAT_HOME\webapps przenosimy pliki tt_manager.war oraz
mieszkanie.war. Pliki te znajdują się w archiwum zip aktualizacji.
12. Tak przygotowane środowisko jest przygotowane do poprawnego działania. Proszę uruchomić
serwer Tomcat.
Po prawidłowym uruchomieniu i zalogowaniu się do programu za pomocą loginu i hasła (start, start)
zostanie uruchomiony ekran rejestracji programu. Należy wypełnić w nim dane:

Nr licencji: jest to numer licencji na program, otrzymacie go Państwo po wykupieniu
programu.

Login: jest to login do autoryzacji Państwa jako klienta w naszym systemie licencyjnym.

Hasło: jest to hasło autoryzujące Państwa jako naszego klienta.

Dane instytucji: Prosimy o rzetelne wypełnienie możliwie jak największej ilości pól. Numer NIP
jest wymagany w celu weryfikacji licencji.
Po poprawnej rejestracji wyświetlone zostaną informacje na temat zmian wersji w programie, po
zapoznaniu się z nimi można w pełni korzystać z programu.
Powodzenia!
Zespół Top-Team