Mediator ver. 4.3 Podrcznik uytkownika OTC S.A.,2009Dokument opisuje czynnoci, jakie naley wykona, aby uruchomi aplikacj CA-Clipper lub (x)Harbourze sterownikiem Mediator. Zawiera rwnie wskazwki, jak efektywnie korzysta z moliwoci Mediatora oraz opis dodatkowych funkcji pakietu. MEDIATOR 4.3. Dokumentacja uytkownikaiSpis treci I. WSTP ................................................................................................. I-11. MEDIATOR ....................................................................................................................... I-22. Sterownik MEDNTX ..................................................................................................... I-43. Sterownik MEDCDX ..................................................................................................... I-44. Migracja aplikacji sterowniki MEDNTX i MEDCDX............................................. I-45. Rozszerzenia jzyka ........................................................................................................ I-56. Praca w sieci WAN .......................................................................................................... I-57. Podsumowanie ................................................................................................................ I-5II. ABY ROZPOCZ PRAC... ............................................................. II-12. Przygotowanie serwera Windows NT/2000/XP ............................................................ II-23. Przygotowanie serwera bazy danych ........................................................................... II-2a) Przygotowanie serwera Oracle .................................................................................. II-2b) Przygotowanie serwera Microsoft SQL Server .......................................................... II-3c) Przygotowanie serwera Sybase Adaptive Server Anywhere ..................................... II-4d) Przygotowanie serwera PostgreSQL ......................................................................... II-5e) Przygotowanie innych serwerw baz danych ............................................................ II-64. Przygotowanie serwera MEDIATOR ............................................................................. II-65. Przygotowanie klienta CA-Clipper ................................................................................ II-66. Przygotowanie klienta (x)Harbour ................................................................................ II-87. Zgodno wersji klienta i serwera Mediator ................................................................ II-9III. OBSUGA SERWERA MEDIATOR .................................................. III-11. Mediator dla Windows NT (wersja desktop) ............................................................... III-1a) Uruchamianie serwera .............................................................................................. III-1b) Konfiguracja .............................................................................................................. III-1c) Gwny panel serwera Mediator dla Windows NT .................................................... III-22. Mediator dla Windows NT/2000 (wersja pracujca jako usuga/serwis) .................. III-4a) Uruchamianie serwera .............................................................................................. III-4b) Konfiguracja .............................................................................................................. III-43. Mediator dla NetWare ................................................................................................... III-4a) Uruchamianie serwera .............................................................................................. III-4b) Konfiguracja serwera Mediator dla NetWare ............................................................ III-4c) Gwny panel serwera Mediator dla NetWare .......................................................... III-54. Zewntrzny program konfiguracyjny z monitorem dla serwerw Mediator ............ III-7a) Konsola programu MMT ........................................................................................... III-7b) Opis serwera (okno: Description of...) .................................................................... III-10c) Zmiana parametrw serwera Mediator (formatka: Configure Server...).................. III-12d) Definiowanie, modyfikacja i usuwanie uytkownikw serwera Mediator oraz MMT III-16e) Monitor systemu ..................................................................................................... III-20IV. DOSTOSOWANIE APLIKACJI DO PRACY Z SYSTEMEM ZARZDZANIA BAZ DANYCH ...................................................... IV-11. Sterowniki RDD MEDNTX i MEDCDX ................................................................ IV-12. Planowanie przeniesienia aplikacji ............................................................................. IV-13. Etapy dostosowania aplikacji ...................................................................................... IV-14. Podstawowe przeniesienie aplikacji etap I .............................................................. IV-2 MEDIATOR 4.3. Dokumentacja uytkownikaiia) Przeniesienie danych ................................................................................................ IV-2b) Modyfikacja kodu aplikacji ........................................................................................ IV-5c) Korzyci osignite po I etapie dostosowania aplikacji ............................................ IV-95. Interfejs do systemu transakcyjnego RDBMS Etap II ........................................... IV-10a) Wprowadzenie transakcji ........................................................................................ IV-10b) Korzyci osignite po II etapie dostosowania aplikacji ......................................... IV-116. Wykorzystanie rozszerze SQL Etap III .................................................................. IV-11a) Wprowadzenie jzyka SQL ..................................................................................... IV-12b) Korzyci osignite po III etapie dostosowania aplikacji ........................................ IV-137. Integracja aplikacji z innymi aplikacjami SQL Etap IV .......................................... IV-138. Przenono ................................................................................................................ IV-149. Wskazwki dla uytkownikw pakietu Clip-4-Win ................................................... IV-1410. Optymalizacja efektywnoci aplikacji (statystyki pracy aplikacji) .......................... IV-15V. ROZSZERZENIA PAKIETU MEDIATOR ............................................ V-11. Moliwo uywania obiektw innych uytkownikw ................................................ V-12. Moliwo uywania niestandardowych rozszerze w nazwach baz i indeksw .... V-23. Wsppraca sterownikw MEDNTX i MEDCDX .................................................... V-24. Wykorzystanie zakresw (SCOPE) ............................................................................... V-25. Usuwanie obiektw z bazy danych ............................................................................... V-36. Filtrowanie ...................................................................................................................... V-37. Ustawianie strony kodowej ........................................................................................... V-58. Uycie jzyka SQL .......................................................................................................... V-69. Obsuga bdw SQL ..................................................................................................... V-710. Transakcje ....................................................................................................................... V-711. Podsystem zaznaczania rekordw w RDBMS ............................................................. V-812. Specyfikacja parametrw przestrzeni dla tablic i indeksw w Oracle ...................... V-913. Blokowanie tablic i rekordw ...................................................................................... V-10VI. FUNKCJE I PROCEDURY STEROWNIKW MEDNTX I MEDCDXVI-11. BEGIN TRANSACTION .................................................................................................... VI-12. COMMIT TRANSACTION ............................................................................................... VI-23. DROP INDEX ..................................................................................................................... VI-24. DROP TABLE ..................................................................................................................... VI-25. MedAdir ............................................................................................................................... VI-36. MedChgPwd ........................................................................................................................ VI-47. MedChrIdxT ........................................................................................................................ VI-48. MedClntId ............................................................................................................................ VI-59. MedClrScpe ......................................................................................................................... VI-510. MedClrTbCa ........................................................................................................................ VI-511. MedCltVBFx ....................................................................................................................... VI-612. MedCltVMaj ........................................................................................................................ VI-613. MedCltVMin ....................................................................................................................... VI-614. MedCltVPth ......................................................................................................................... VI-615. MedCltVSub ........................................................................................................................ VI-716. MedCmdRes ........................................................................................................................ VI-717. MedColAdd ......................................................................................................................... VI-718. MedColDel .......................................................................................................................... VI-819. MedColRes .......................................................................................................................... VI-820. MedDate .............................................................................................................................. VI-921. MedDateTm ....................................................................................................................... VI-10 MEDIATOR 4.3. Dokumentacja uytkownikaiii22. MedDbCode ....................................................................................................................... VI-1023. MedDbConn ....................................................................................................................... VI-1124. MedDbName ...................................................................................................................... VI-1125. MedDbsUser ...................................................................................................................... VI-1126. MedDbVer .......................................................................................................................... VI-1127. MedDelNow ....................................................................................................................... VI-1228. MedDiscTm ........................................................................................................................ VI-1229. MedDropIdx ....................................................................................................................... VI-1230. MedDropTab ...................................................................................................................... VI-1331. MedErrText ........................................................................................................................ VI-1332. MedExecSQL ..................................................................................................................... VI-1433. MedExitFun........................................................................................................................ VI-1434. MedExRecc ........................................................................................................................ VI-1535. MedFErase ......................................................................................................................... VI-1636. MedFile .............................................................................................................................. VI-1637. MedFlckInf ......................................................................................................................... VI-1738. MedFlocked........................................................................................................................ VI-1839. MedFltRes .......................................................................................................................... VI-1840. MedFTName ...................................................................................................................... VI-1941. MedGetFile ........................................................................................................................ VI-1942. MedGetIdxs ........................................................................................................................ VI-2043. MedGetInfo ........................................................................................................................ VI-2144. MedGetLLst ....................................................................................................................... VI-2145. MedGetTabs ....................................................................................................................... VI-2246. MedHdSqlFl ....................................................................................................................... VI-2347. MedIdxDesc ....................................................................................................................... VI-2348. MedIdxKey ........................................................................................................................ VI-2349. MedIdxLen ......................................................................................................................... VI-2450. MedIdxLmt......................................................................................................................... VI-2451. MedIdxSQL ........................................................................................................................ VI-2552. MedIdxUniq ....................................................................................................................... VI-2553. MedIgnDbN ....................................................................................................................... VI-2554. MedIgnPath ........................................................................................................................ VI-2655. MedIsBag ........................................................................................................................... VI-2656. MedIsFlds ........................................................................................................................... VI-2757. MedIsFltr ............................................................................................................................ VI-2758. MedIsIdx ............................................................................................................................ VI-2759. MedIsTable ........................................................................................................................ VI-2860. MedIsTr .............................................................................................................................. VI-2861. MedKeyCnt ........................................................................................................................ VI-2962. MedKeyCtCa ...................................................................................................................... VI-2963. MedKeyGoto ...................................................................................................................... VI-2964. MedKeyNo ......................................................................................................................... VI-3065. MedKeyNoCa .................................................................................................................... VI-3166. MedLibErr .......................................................................................................................... VI-3167. MedLibExec ....................................................................................................................... VI-3168. MedLibExe2 ....................................................................................................................... VI-3269. MedLgMsg ......................................................................................................................... VI-3370. MedLibFree ........................................................................................................................ VI-3371. MedLibLoad ....................................................................................................................... VI-3472. MedLMCnAct .................................................................................................................... VI-3573. MedLMCnSet ..................................................................................................................... VI-3574. MedLMGRecc .................................................................................................................... VI-3575. MedLMMode ..................................................................................................................... VI-36 MEDIATOR 4.3. Dokumentacja uytkownikaiv76. MedLMRecc ...................................................................................................................... VI-3677. MedLMTGlob ................................................................................................................... VI-3778. MedLogAsN2 .................................................................................................................... VI-3779. MedLogErr ........................................................................................................................ VI-3880. MedLogged ........................................................................................................................ VI-3881. MedLogin .......................................................................................................................... VI-3882. MedLogout ........................................................................................................................ VI-4183. MedLogTVal ..................................................................................................................... VI-4184. MedMaxLic ....................................................................................................................... VI-4185. MedMedId ......................................................................................................................... VI-4286. MedMedVBFx ................................................................................................................... VI-4287. MedMedVMaj ................................................................................................................... VI-4288. MedMedVMin ................................................................................................................... VI-4289. MedMedVPth .................................................................................................................... VI-4390. MedMedVSub ................................................................................................................... VI-4391. MedMemType ................................................................................................................... VI-4392. MedMrkAdd ...................................................................................................................... VI-4493. MedMrkAll ........................................................................................................................ VI-4494. MedMrkClose .................................................................................................................... VI-4595. MedMrkDel ....................................................................................................................... VI-4596. MedMrkFlush .................................................................................................................... VI-4697. MedMrkNew ..................................................................................................................... VI-4698. MedMrkNum ..................................................................................................................... VI-4799. MedMrkOpen .................................................................................................................... VI-47100. MedMrkRemv ................................................................................................................... VI-48101. MedMrkTemp .................................................................................................................... VI-48102. MedNulChar ...................................................................................................................... VI-49103. MedNulDate ...................................................................................................................... VI-49104. MedOci8 ............................................................................................................................ VI-49105. MedOpSpeed ..................................................................................................................... VI-50106. MedPdbFree ....................................................................................................................... VI-50107. MedPdbGet ........................................................................................................................ VI-51108. MedPdbLd ......................................................................................................................... VI-51109. MedPdbSet ......................................................................................................................... VI-52110. MedPerfMod ...................................................................................................................... VI-53111. MedPerfRC ........................................................................................................................ VI-53112. MedRddUser ...................................................................................................................... VI-53113. MedRegLogin .................................................................................................................... VI-54114. MedRenTab ....................................................................................................................... VI-54115. MedRfsRecA ..................................................................................................................... VI-55116. MedRfsRecc ...................................................................................................................... VI-56117. MedRfsRecT ...................................................................................................................... VI-56118. MedRlckInf ........................................................................................................................ VI-57119. MedSelVal ......................................................................................................................... VI-58120. MedSessId ......................................................................................................................... VI-59121. MedSetInfo ........................................................................................................................ VI-59122. MedSetPerf ........................................................................................................................ VI-60123. MedSetScpe ....................................................................................................................... VI-61124. MedShared ......................................................................................................................... VI-62125. MedSqlPar ......................................................................................................................... VI-63126. MedSqlParA ...................................................................................................................... VI-64127. MedSqlPTrm...................................................................................................................... VI-64128. MedSrv64 .......................................................................................................................... VI-65129. MedSrvDate ....................................................................................................................... VI-65 MEDIATOR 4.3. Dokumentacja uytkownikav130. MedSrvDay ........................................................................................................................ VI-65131. MedSrvFltr ......................................................................................................................... VI-65132. MedSrvMnth ...................................................................................................................... VI-66133. MedSrvSys ......................................................................................................................... VI-66134. MedSrvVMaj ...................................................................................................................... VI-66135. MedSrvVMin ..................................................................................................................... VI-66136. MedSrvYear ....................................................................................................................... VI-67137. MedStReset ........................................................................................................................ VI-67138. MedStStart .......................................................................................................................... VI-67139. MedStStop .......................................................................................................................... VI-68140. MedTabOwnr ..................................................................................................................... VI-68141. MedTime ............................................................................................................................ VI-68142. MedTName ......................................................................................................................... VI-69143. MedTrMode ....................................................................................................................... VI-69144. MedTrRes ........................................................................................................................... VI-69145. MedUMrkAll ...................................................................................................................... VI-70146. MySQLDbTyp ................................................................................................................... VI-71147. MySQLMaxRc ................................................................................................................... VI-71148. OraDefTbsp ........................................................................................................................ VI-72149. OraIdxDBMS ..................................................................................................................... VI-72150. OraRcnDBMS .................................................................................................................... VI-73151. OraStDeflt .......................................................................................................................... VI-74152. OraStEIntl .......................................................................................................................... VI-74153. OraStEMax ......................................................................................................................... VI-75154. OraStEMin ......................................................................................................................... VI-75155. OraStENext ........................................................................................................................ VI-75156. OraStPctFr .......................................................................................................................... VI-76157. OraStPctIc .......................................................................................................................... VI-76158. OraStPctUd ........................................................................................................................ VI-77159. OraStTbsp .......................................................................................................................... VI-77160. ROLLBACK TRANSACTION ......................................................................................... VI-77161. SET APPEND TIMEOUT ................................................................................................. VI-78162. SET CLIENT CODE PAGE .............................................................................................. VI-78163. SET FILTERING ON ........................................................................................................ VI-79164. SET LOCK INTERVAL .................................................................................................... VI-79165. SET LOCK TRY ................................................................................................................ VI-80166. SET PERFORATED NUMBERING ................................................................................ VI-80167. SET QUERY PRECISION ................................................................................................ VI-80168. SET SERVER CODE PAGE ............................................................................................. VI-81169. SET SQL ERROR .............................................................................................................. VI-81170. SET SQL FILTER .............................................................................................................. VI-82171. SET TRANSACTION MODE........................................................................................... VI-82172. USE AS .......................................................................... VI-83173. USE AS PROC .............................................................. VI-86174. USE AS FUN .................................................................. VI-87VII. DODATKOWE WSKAZWKI DOTYCZCE PROJEKTOWANIA APLIKACJI ........................................................................................ VII-11. Zalecenia oglne .......................................................................................................... VII-12. Zabezpieczenie danych przed niepowoanym dostpem ......................................... VII-13. Uwagi o pracy w sieci rozlegej .................................................................................. VII-24. Ograniczenia MEDIATORa ........................................................................................... VII-2 MEDIATOR 4.3. Dokumentacja uytkownikaviDODATEK A .............................................................................................. A-1DODATEK B .............................................................................................. B-1Polecenia (skrypty) SQL suce do manipulacji obiektami XBASEw bazie Oracle. .......B-1DODATEK C .............................................................................................. C-1Przywileje Oracle .....................................................................................................................C-1Przywileje Adaptive Server Anywhere ...................................................................................C-4DODATEK D .............................................................................................. D-1Korzystanie z procedur PL/SQL zapamitanych w serwerze Oracle z programu XBASE/Mediator .............................................................................................................D-1DODATEK E ................................................................................................ E-1Przenoszenie aplikacji korzystajcej z baz o tych samych nazwach w rnych katalogachE-1DODATEK F ................................................................................................ F-1Narzdzia do migracji danych i administracji ....................................................................... F-1DODATEK G .............................................................................................. G-1Kody bdw generowanych przez biblioteki Mediator....................................................... G-1 MEDIATOR 4.3. Dokumentacja uytkownikaI-1ROZDZIA 1 I.Wstp Oprogramowanie Mediator umoliwia dostosowanie aplikacji CA-Clipper i (x)Harbour do pracy z zaawansowanym systemem zarzdzania baz danych (RDBMS Relational Data Base Management System). Aplikacje CA-Clipper i (x)Harbour czy wsplny interfejs dostpu do danych RDD. Aplikacje te bd w dalszej czci dokumentacji nazywane aplikacjami XBASE. Sposb przechowywania i udostpniania danych stosowany w tradycyjnych aplikacjach XBASE posiada wady uniemoliwiajce uzyskanie wystarczajcego bezpieczestwa, niezawodnoci i efektywnoci systemu. Praca na relacyjnej bazie danych zarzdzanej przez jeden z nowoczesnych, bezpiecznych i niezawodnych systemw zarzdzania pozwala wyeliminowa praktycznie wszystkie niedogodnoci zwizane z dostpem do plikw .dbf,pozostawiajc aplikacji jedynie funkcje zwizane z manipulacj i prezentacj danych. Aplikacje XBASE posiadaj architektur umoliwiajc wymian sterownika odpowiedzialnego za dostp do danych (RDD Replaceable Data Driver). Taka architektura pozwolia na stworzenie pakietu Mediator, ktry z punktu widzenia aplikacji peni funkcj RDD i pozwala jej odwoywa si do nowoczesnej bazy danych w sposb identyczny jak do zbiorw *.dbf (Rysunek 1).Kod aplikacji XBASEBiblioteki RDD APIDBFNTX RDD MEDNTX RDDDBF DBT NTXRDBMS: Oracle, MS SQL Server,SQL Anywhere, PostgreSQLRysunek 1. Architektura aplikacji XBASE/MediatorMEDCDX RDD MEDIATOR 4.3. Dokumentacja uytkownikaI-21.MEDIATOR Mediator stanowi warstw poredni midzy aplikacj XBASE a serwerem bazy danych i skada si z czterech podstawowych moduw (Rysunek 2): 1.Modu RDD - sterownik zgodny ze specyfikacj RDD, dziki czemu aplikacja korzystajca z niego praktycznie nie wymaga modyfikacji. 2.Klient sieciowy - modu umoliwiajcy poczenie z agentem na serwerze, korzystajcy z jednego z popularnych standardw teletransmisyjnych (TCP/IP lub SPX/IPX). Aby zminimalizowa ruch sieciowy, wymiana informacji odbywa si zgodnie ze specjalnie zaprojektowanym protokoem okrelajcym zasady fragmentacji i kodowania przesyanych danych. 3.Serwer komunikacyjny - wielowtkowy serwer odbierajcy zapytania i wysyajcy odpowiedzi do aplikacji klienta wedug tego samego protokou, co klient sieciowy. 4.Serwer polece - modu analizujcy polecenia otrzymane od stacji klienta. Jeeli polecenie wymaga odwoania si do bazy danych, formuje zapytanie zrozumiae dla RDBMS i wysya je korzystajc z API odpowiedniego dla wykorzystywanego serwera. Wyniki s odsyane poprzez serwer komunikacyjny do klienta. Serwer dziaa w sposb cigy. Jest on przygotowany na przyjcie kolejnego polecenia od stacji roboczej. Jeeli zgasza si nowa stacja, serwer uruchamia kolejny wtek dedykowany do obsugi nowego klienta. Wtek dziaa do momentu otrzymania rozkazu rozczenia lub stwierdzenia, e stacja robocza przestaa dziaa. W obu tych przypadkach zwalniane s zasoby zajmowane przez klienta, w tym wszystkie blokady baz i rekordw oraz wycofywane s nie zakoczone transakcje. Sie LAN/WANSie LAN/WANAplikacjaXBASESerwerkomunikacyjnyMediatorKlientsieciowyMediatorMediatorRDDSerwerpoleceMediatorRDBMSRDD APIServer APIRysunek 2. Architektura oprogramowania MediatorKomputerklientaSerwerbazy danych W skad pakietu Mediator wchodz biblioteki doczane do aplikacji XBASE oraz agent instalowany na platformie Windows NT/2000/XP, Linux lubSUN SPARC MEDIATOR 4.3. Dokumentacja uytkownikaI-3Solaris (zalenie od wersji),Agent odpowiedzialny jest za komunikacj z RDBMS. RDBMS moe znajdowa si na tym samym komputerze, co agent Mediator, moe te pracowa na innej maszynie (Rysunek 3). Komunikacja Mediatora z serwerem bazy danych odbywa si przy pomocy mechanizmw zwizanych z serwerem. Aplikacje CA-Clipper z doczonymi bibliotekami Mediator mog pracowa na komputerach PC z systemem operacyjnym DOS, lub w oknie DOS Windows 95/98/ME/NT/2000/XP. Korzystajce z bibliotek Mediator aplikacje (x)Harbour mog pracowa na komputerach PC z systemem Windows 95/98/ME/NT/2000/XP. Do komunikacji aplikacji z agentem wykorzystywany jest protok TCP/IP lub SPX/IPX. Biblioteka zawiera dwasterowniki RDD: MEDNTX i MEDCDX. Sterowniki te zgodne s odpowiednio ze sterownikami DBFNTX i DBFCDX i s przeznaczone do szybkiego przeniesienia aplikacji do rodowiska RDBMS Ponadto biblioteki Mediator zawieraj funkcje umoliwiajce prac z bezporednim wykorzystaniem polece SQL.Wszystkie sterowniki mog by uywane jednoczenie i nie wykluczaj stosowania oryginalnych sterownikw (DBFNTX i DBFCDX). Oznacza to, e w ramach jednej aplikacji cz tablic dedykowanych dla aplikacji XBASE moe by otwarta w trybie zgodnoci z Clipperem, a cz obejmujca np. dane tymczasowe czy konfiguracyjne moe pozosta w plikach .dbf. Jest to przydatna cecha, szczeglnie w przypadku, gdy stacja robocza tworzy du ilo tymczasowych tablic, z ktrych nie korzystaj pozostali uytkownicy. Lokalne pliki tymczasowe zwykle nie stanowi zagroenia dla bezpieczestwa danych, a mog skutecznie ograniczy ruch w sieci (o ile s tworzone na dyskach lokalnych) i nie powoduj nadmiernej fragmentacji w RDBMS. serwer bazy danychserwer Mediatorstacje z aplikacjamiXBASE/Mediatorserwer Mediatorserwer bazy danychSQL*NetRysunek 3. Architektury sprztowe dla oprogramowania Mediator/baza danychSerwer bazy danych i serwer Mediatordziaaj na jednym komputerzeSerwer bazy danych i serwer Mediatordziaaj na rnych komputerachARCHITEKTURA I ARCHITEKTURA IIstacje z aplikacjamiXBASE/Mediator MEDIATOR 4.3. Dokumentacja uytkownikaI-42.Sterownik MEDNTX Sterownik MEDNTX jest zgodny ze standardem DBFNTX. Zaprojektowany zosta tak, aby zminimalizowa ilo zmian w przenoszonej aplikacji. Sterownik emuluje zachowanie aplikacji XBASE w zakresie numerw rekordw RECNO(), zaznaczania rekordw do skasowania DELETED(), blokowania rekordw i tablic oraz obsugi zoonych wyrae indeksowych. Przy pierwszym poczeniu z RDBMS sterownik zakada na koncie uytkownika repozytorium, z ktrego korzysta przez cay czas pracy aplikacji. W repozytorium przechowywane s informacje o wszystkich uywanych tablicach wraz z opisem ich struktur oraz informacje dodatkowe niezbdne do zachowania maksymalnej zgodnoci z aplikacjami XBASE i DBFNTX. Kosztem osignicia tej zgodnoci jest nieco utrudniona wsppraca z innymi aplikacjami, napisanymi w narzdziach klient-serwer, korzystajcymi ze wsplnych danych. Sterownik MEDNTX posiada wbudowany interfejs do mechanizmw transakcyjnych bazy danych oraz wiele rozszerze umoliwiajcych uycie jzyka SQL w kodzie rdowym aplikacji. 3.Sterownik MEDCDX Sterownik MEDCDX jest zgodny ze standardem DBFCDX. Sterownik posiada wszelkie cechy sterownika MEDNTX. Dodatkowo, implementuje sposb obsugi indeksw zgodny z koncepcj sterownika DBFCDX. Oba sterowniki (MEDNTX i MEDCDX) mog korzysta z mechanizmu zakresw (SCOPE). Funkcje sterownika MEDCDX zawarte s w tej samej bibliotece, co sterownik MEDNTX (MEDNTXnn.LIB). W przypadku CA-VO funkcje te implementuje biblioteka MEDCDX.RDD 4.Migracja aplikacji sterowniki MEDNTX i MEDCDX Dostosowanie aplikacji do pracy z Mediatorem jest bardzo proste. Wystarczy doczy plik nagwkowy Mediatora do aplikacji i jedn instrukcj zmieni domylny sterownik z DBFNTX (DBFCDX) na MEDNTX (MEDCDX). W przypadku aplikacji CA-Clipper lub (x)Harbour po kompilacji naley poczy kod poredni z dostarczon bibliotek. Otrzymany zbir .exejest aplikacj gotow do pracy z RDBMS. W przypadku CA-VO czenie nie jest konieczne gdy sterowniki dostarczane s w postaci dynamicznie doczanych bibliotek. Teraz wystarczy tylko przenie przy pomocy narzdzi dostarczonych z pakietem istniejce dane i indeksy z plikw .dbf,.ntx i .cdx do serwera bazy danych. Naley tu pamita, e stosowanie w programie funkcji operujcych bezporednio na systemie plikw traci sens w przypadku struktur przechowywanych w RDBMS. Dlatego konieczne staje si ich zastpienie wywoaniami rwnowanych funkcji dziaajcych na tablicach. MEDIATOR 4.3. Dokumentacja uytkownikaI-55.Rozszerzenia jzyka Proces dostosowania aplikacji do wsppracy z RDBMS jest nieco bardziej skomplikowany, jeli programista chce skorzysta z dostpnych rozszerze jzyka. Mediator oferuje kilka grup rozszerze: Interfejs do systemu transakcyjnego (instrukcje BEGI NTRANSACTI ON,COMMI TTRANSACTI ON, ROLLBACKTRANSACTI ON) ,zapytania SQL wysyane z poziomu jzyka XBASE (instrukcja USEV_TAB AS SELECT... ) - tablica V_TAB jest wirtualn tablic, ktrej wierszami s rekordy otrzymane w wyniku zapytania - mona j przeglda standardowymi instrukcjami XBASE. wywoywanie procedur zapamitanych w serwerze bazy danych (stored procedures), filtry zakadane na serwerze definiowane przy pomocy SQL, okoo 140 dodatkowych funkcji uatwiajcych wykorzystanie moliwoci RDBMS. Korzystanie z rozszerze wymaga od programisty podstawowej wiedzy na temat dziaania RDBMS oraz podstaw jzyka SQL. W zamian otrzymuje on szeroki wachlarz moliwoci poprawy efektywnoci dziaania aplikacji. Wprowadzenie transakcyjnoci zapewnia zachowanie spjnoci logicznej danych i sprawia, e awaria pojedynczej stacji roboczej nie powoduje przestoju caego systemu. Bezporednie zastosowanie zapyta SQL i procedur wbudowanych w serwer bazy danych umoliwia przeniesienie wikszoci skomplikowanych oblicze do serwera. Pozwala to zminimalizowa inwestycje w rozbudow stacji roboczych, znacznie ogranicza ruch sieciowy i zwiksza ogln efektywno systemu. 6.Praca w sieci WAN Mediator, dziki znacznemu ograniczeniu ruchu sieciowego, uatwia aplikacjom XBASE prac w sieci rozlegej. Specjalny sposb kodowania danych ogranicza do minimum ruch sieciowy. Jest on kilkunastokrotnie mniejszy ni w tradycyjnym systemie. Aby jeszcze bardziej usprawni prac w sieci WAN mona zastosowa oprogramowanie Terminal opracowane w OTC, pozwalajce na prac terminalow aplikacji CA-Clipper. Serwerem aplikacji jest Windows NT/2000/XP, a terminalami dowolne komputery PC. Zastosowanie terminala pozwala na uruchomienie wielu stacji na czach o niewielkiej przepustowoci. 7.Podsumowanie Pakiet Mediator oferuje prosty sposb migracji aplikacji XBASE do rodowiska RDBMS. Po przeniesieniu, aplikacje korzystajce z Mediatora mog pracowa na MEDIATOR 4.3. Dokumentacja uytkownikaI-6wsplnych danych z graficznymi moduami klient-serwer. Dziki temu istniejce systemy mona przepisywa modu po module uywajc dowolnych narzdzi do tworzenia aplikacji klient-serwer, a systemy tworzone od podstaw w takich narzdziach zyskuj znakowy interfejs uytkownika niedostpny w wielu nowoczesnych systemach zarzdzania baz danych. Nowe moduy mog wsppracowa ze starymi on-line, mog te wsadowo pobiera i przetwarza dane ze starej aplikacji. Proces taki mona cakowicie zautomatyzowa, a stare i nowe dane mona przetwarza i prezentowa przy uyciu dostpnych narzdzi SQL (np. OLAP lub hurtownie danych). Poza tym, uytkownik moe wykorzysta wszystkie narzdzia i moliwoci, jakie daje serwer bazy danych. Chodzi tu gwnie o zabezpieczenie danych przed utrat i niepowoanym dostpem. W przypadku uszkodzenia sprztu, mechanizmy archiwizacji oraz rejestrowania transakcji w dziennikach tworzonych przez serwer pozwalaj na szybkie podjcie pracy po awarii bez utraty wprowadzonych informacji. MEDIATOR 4.3. Dokumentacja uytkownikaII-1ROZDZIA 2 II.Aby rozpocz prac... Niezbdne s: Serwer: System operacyjny Serwer Windows NT/2000/XP Na serwerze Windowspowinien by zainstalowany i skonfigurowany protok sieciowy NWLINK IPX/SPX Compatible Transport lubTCP/IP.albo Serwer Sun Solaris w wersji odpowiedniej do zainstalowania bazy danych Oracle albo Serwer Linux w wersji odpowiedniej do zainstalowania bazy danych Oracle lub bazy danych PostgreSQL (od wersji 7.2) Serwer bazy danych. W zalenoci od posiadanej wersji Mediatora moe to by serwer Oracle, Microsoft SQL Server (od wersji 7.0), Sybase Adaptive Server Anywhere (od wersji 6.0) lub PostgreSQL (od wersji 7.2). Serwer Oracle Serwer Oracle powinien by uruchomiony (patrz: procedura startowania). W przestrzeniach tablicowych naley przewidzie odpowiedni ilo wolnego miejsca do zaadowania danych oraz do pracy. Rozmiar SGA powinien by dostosowany do liczby uytkownikw i zamierzonej aktywnoci. Inne zalecane parametry: OPEN_CURSORS = 300 NLS_LANG = AMERICAN_AMERICA.EE8MSWIN1250 (lub inny zestaw znakw odpowiedni do planowanego zastosowania)) Powinien istnie uytkownik Oracle, ktry bdzie wacicielem obiektw (tablic i indeksw) z prawami do poczenia z baz i tworzenia obiektw. Microsoft SQL Server (wersja 7.0 lub nowsza) Serwer powinien by zainstalowany. W trakcie instalacji naley wybra odpowiedni stron kodow oraz sposb sortowania. Powinna by zaoona baza (database), w ktrej bd przechowywane dane z wystarczajc iloci miejsca. Naley zaoy uytkownika, ktry bdzie wacicielem obiektw z uprawnieniami do czenia si z serwerem oraz do zapisu w tej bazie (utworzona baza powinna by domyln baz dla tego uytkownika). Naley skonfigurowa systemowe rdo danych ODBC dla zainstalowanego serwera. Sybase Adative Server Anywhere (wersja 6.0 lub nowsza) Serwer powinien by zainstalowany. Naley utworzy baz danych z odpowiednim zestawem znakw i iloci miejsca na dane. W bazie naley zaoy uytkownika, ktry bdzie wacicielem obiektw z uprawnieniami do czenia si z serwerem i tworzenia obiektw. Naley zwikszy parametry Max_cursor_count i Max_statement_count dla tej bazy. Zalenie od aplikacji mona je ustawi np. na warto 300 albo na 0 (brak ogranicze). Naley skonfigurowa systemowe rdo danych ODBC dla utworzonej bazy. PostgreSQL (wersja 7.2 lub nowsza) Serwer powinien by zainstalowany z odpowiednim zestawem znakw. Naley umoliwi poczenie do bazy z komputera, na ktrym jest zaisntalowany serwer Mediator (wpis w pg_hba.cfg). Naley zaoy baz, w ktrej bd przechowywane dane oraz doda uytkownika, ktry bdzie wacicielem tworzonych obiektw. Koniecznie naley wyczy moliwo korzystania przez serwer z cakowitego odczytu tablicy (w pliku postgresql.conf doloy wpis: enable_seqscan=false). Naley zainstalowa i skonfigurowa ODBC dla utworzonej bazy. SerwerMEDIATOR Serwer MEDIATOR powinien by zainstalowany i uruchomiony. Klient: Klient CA-Clipper MEDIATOR 4.3. Dokumentacja uytkownikaII-2Zainstalowany i uruchomiony protok IPX/SPX lub TCP/IP. Jeli klient ma komunikowa si za pomoc IPX/SPX to naley skonfigurowa:dla DOS: NETX, VLM lub 32-bitowy klient NetWare dla Windows 95/98/ME: Microsoft IPX/SPX Compatible Transportdla Windows NT/2000/XP: NWLINK IPX/SPX Compatible Transport (naley pamita o zainstalowaniu zbioru omvdd.dll w katalogu winnt\system32) Przy IPX naley zwrci uwag na zgodno ramki na kliencie i serwerze.Jeli klient bdzie korzysta z protokou TCP/IP to naley zainstalowa i uruchomi jeden z nastpujcych protokow:dla DOS :32-bitowy klient NetWare z TCP/IP dla Windows 95: Microsoft TCP/IP (jeli zainstalowany jest Winsock 2 to naley pamita o zainstalowaniu zbioru omvsx.vxd w katalogu windows\system) dla Windows 98/ME: Microsoft TCP/IP (naley pamita o zainstalowaniu zbioru omvsx.vxd w katalogu windows\system) Windows NT/2000/XP:.TCP/IP (naley pamita o zainstalowaniu zbioru omvdd.dll w katalogu winnt\system32) rodowisko CA-Clipper 5.2e lub 5.3 Blinker 4.0 lub nowszy Biblioteka MEDNTX52.LIB dla Clippera 5.2e lub MEDNTX53.LIB dla Clippera 5.3 Biblioteka MEDQB.LIB Zbir SPXENV.BAT lub TCPENV.BAT zawierajcy definicje parametrw sieciowych generowany przez serwer MEDIATOR dla Windows NT (zmienne rodowiskowe DOS) Przed uruchomieniem dowolnej aplikacji naley uruchomi odpowiedni XXXENV.BAT w celu ustawienia odpowiednich zmiennych rodowiskowych (nie naley wywoywa skryptu z Norton Commandera). Klient (x)Harbour Zainstalowany i uruchomiony protok IPX/SPX lub TCP/IP na Windows 95/98/ME/NT/2000/XP. Jeli klient ma komunikowa si za pomoc IPX/SPX to naley skonfigurowa:dla Windows 95/98: Microsoft IPX/SPX Compatible Transportdla Windows NT/2000/XP: NWLINK IPX/SPX Compatible Transport Naley zwrci uwag na zgodno ramki na kliencie i serwerze.Jeli klient bdzie korzysta z protokou TCP/IP to naley zainstalowa i uruchomi jeden z nastpujcych protokow:dla Windows 95/98: Microsoft TCP/IP Windows NT/2000/XP:.TCP/IProdowisko (x)Harbour w odpowiedniej wersji (patrz ....\Harbour\hbreadme.txt lub ....\xHarbour\xhbreadme.txt) Dostosowane do lokalnego rodowiska skrypty kompilacji i czenia znajdujce si w katalogu ...\Harbour\bin i ....\xHarbour\bin 2.Przygotowanie serwera Windows NT/2000/XP Serwer Windows NT/2000/XP powinien mie zainstalowany i skonfigurowany protok sieciowy NWLINK IPX/SPX Compatible Transport. Jeli protok nie jest zainstalowany, to naley go doinstalowa z dystrybucyjnego CD-ROMu Windows. Konfiguracja polega na ustawieniu numeru wewntrznego sieci (Control Panel/ Network/ Protocols/ Properties) oraz na wyborze odpowiedniego typu ramki (najczciej Auto Frame Type Detection). Z reguy naley zainstalowa najnowszy dostpny Service Pack. 3.Przygotowanie serwera bazy danych a)Przygotowanie serwera Oracle Serwer Oracle powinien by zainstalowany z dystrybucyjnego CD-ROM zgodnie z instrukcj instalacji. W bazie powinna by moliwo przechowywania polskich znakw, dlatego te obowizujcy zestaw znakw powinien by rwny EE8MSWIN1250, EE8ISO8859P2 lub EE8PC852. MEDIATOR 4.3. Dokumentacja uytkownikaII-3Zapewnienie odpowiedniego miejsca na dane Najpierw naley oszacowa ile miejsca bdzie potrzebne do przechowywania danych. Szacunkowo mona przyj, e naley zarezerwowa w Oracle tyle miejsca ile zajmuj pliki .DBF wraz z indeksami. W celu zapewnienia odpowiedniej iloci miejsca na dane mona rozszerzy przestrze tablicow, w ktrej maj by przechowywane. Mona to wykona na wiele sposobw - patrz: podrcznik Oracle Server Administrators Guide. Przykadowo za pomoc SQL*Plus mona wykona polecenie SQL suce do dodania dodatkowego pliku do przestrzeni, w ktrej przechowywane s dane: ALTER TABLESPACE ADD DATAFILE SIZE ; Nazwy i zastpujemy odpowiednimi nazwami, a rozmiar odpowiednim rozmiarem pliku, np.: ALTER TABLESPACE dane ADD DATAFILE D:\ORANT\DATABASE\DANE02.ORA SIZE 100M; Instrukcja powikszy przestrze tablicow dane o dodatkowy plik D:\ORANT\DATABASE\DANE02.ORA o rozmiarze 100 MB.Zmiana parametrw bazy danych Najlepiej aby parametr OPEN_CURSORS nie by mniejszy ni 300. Proponowane ustawienie pozwala na otwarcie i intensywn prac na 50 bazach. Mona obliczy potrzebn liczb w zalenoci od aplikacji liczc 6 na jedn otwart baz. Parametr OPEN_CURSORS jest ustawiany w pliku inicjalizacyjnym bazy: INITORCL.ORA. Po kadorazowej zmianie pliku inicjalizacyjnego naley ponownie uruchomi baz. Aby zapewni prawidow obsug znakw narodowych naley ustawi parametr NLS_CHARACTERSET na serwerze z Mediatorem na zgodny z tym zainstalowanym w bazie danych. Odbywa si to poprzez edycj parametru NLS_LANG i zmian jego trzeciej skadowej. Np. wpis: AMERICAN_AMERICA.WE8ISO8859P1 zamienimy na POLISH_POLAND.EE8MSWIN1250. Na Windows NT wykorzystujemy do tego celu program regedit i edytujemy klucz HKEY_LOCAL_MACHINE/SOFTWARE/ORACLE/HOMExx /NLS_LANG.Na NetWare, Linux czy Solaris naley posuy si zwykym edytorem tekstw: zmieniona linia w pliku CONFIG.ORA moe mie posta: NLS_LANG = AMERICAN_AMERICA.EE8MSWIN1250 Po zmianie naley ponownie uruchomi baz. Zakadanie uytkownikw Oracle Wacicielami obiektw bazy danych takich jak tablice i indeksy s uytkownicy Oracle (Oracle users), dlatego naley zaoy co najmniej jednego takiego uytkownika. Przykadowo podany zostanie sposb tworzenia uytkownikw za pomoc programu SQL*Plus i komend SQL. Po poczeniu si z baz jako uytkownik z uprawnieniami administratora (np. system) wykonujemy komend: CREATE USER IDENTIFIED BY DEFAULT TABLESPACE TEMPORARY TABLESPACE ; Przykadowo tworzymy uytkownika test z hasem test z prawem do tworzenia obiektw w przestrzeni dane oraz wykonywania operacji pomocniczych (takich jak np. sortowanie danych) w przestrzeni temp: CREATE USER test IDENTIFIED BY test DEFAULT TABLESPACE dane TEMPORARY TABLESPACE temp; Po utworzeniu naley nada uytkownikowi uprawnienia do poczenia z baz i tworzenia obiektw: GRANT connect, resource to ; np. GRANT connect, resource to test; b)Przygotowanie serwera Microsoft SQL Server Mediator wsppracuje z Microstoft SQL Server w wersji 7.0 lub nowszej. Serwer powinien by zainstalowany z dystrybucyjnego CD-ROM zgodnie z instrukcj instalacji. W bazie powinna by moliwo przechowywania polskich znakw, dlatego te podczas instalacji naley wybra stron kodow Microsoft Windows 1250. Aby mc wprowadza polskie znaki przez serwer Mediator naley na serwerze, na ktrym jest zainstalowany Mediator MEDIATOR 4.3. Dokumentacja uytkownikaII-4wybra polskie ustawienia regionalne (Control Panel/Regional Settings). Naley pamita, e z punktu widzenia serwera bazy danych jego klientem jest serwer Mediator. Uruchamianie serwera MS SQL Server moe by uruchamiany automatycznie po uruchomieniu serwera. Jeli wybrano inna moliwo, to naley uruchomi serwer korzystajc z graficznego narzdzia Service Manager. Wszystkie czynnoci administracyjne zwizane z serwerem mona wykonywa za pomoc narzdzia Enterprise Manager.Zapewnienie odpowiedniego miejsca na dane Najpierw naley oszacowa ile miejsca bdzie potrzebne do przechowywania danych. Szacunkowo mona przyj, e naley zarezerwowa w bazie tyle miejsca ile zajmuj pliki .DBF wraz z indeksami. Nastpnie naley utworzy baz danych (database), w ktrej bd przechowywane tablice i indeksy (po poczeniu do serwera w Enterprise Manager wybra opcj Action/New database).W celu zapewnienia odpowiedniej iloci miejsca na dane mona: -Zapewni automatyczn alokacj przestrzeni dyskowej w miar potrzeb (zachowanie domylne). -Zaalokowa odpowiednio duo miejsca w plikach stanowicych baz - zmiana parametrw poprzez edycj wasnoci bazy. Jeli baza jest uywana do celw testowych to naley ustawi opcj "Truncate log on checkpoint" (Wasnoci bazy danych / Zakadka Options), co pozwoli unikn nadmiernego przyrostu dziennikw (opcja waciwa dla wersji 7).Zakadanie uytkownikw bazy danych Naley zaoy co najmniej jednego uytkownika, ktry bdzie wacicielem tablic i indeksw. Zaoony uytkownik powinien mie prawo dostpu do zaoonej bazy (najlepiej eby by to dla niego baza domylna). Po utworzeniu uytkownika (Security/Logins/New login) naley doda go do uytkownikw bazy oraz nada mu prawo do tworzenia tablic, widokw, procedur itd. w wybranej bazie (baza/Properties/Zakadka Permissions). Tworzenie rda danych ODBC Naley utworzy systemowe rdo danych ODBC, przez ktre serwer Mediator bdzie si czy do serwera bazy danych. rdo danych zakada si za pomoc narzdzia Administrator ODBC (Control Panel/ODBC Data Sources). Naley wybra zakadk System DSN i nacisn guzik Add. Nastpnie naley wybra sterownik SQL Server, wpisa nazw roda, opis, sposb identyfikacji (zalenie od rodzaju zaoonego uytkownika wybra autentykacj przez Windows NT lub przez serwer bazy danych). Pozostae parametry mog pozosta bez zmian.c)Przygotowanie serwera Sybase Adaptive Server Anywhere Mediator wsppracuje z serwerem Sybase Adaptive Server Anywhere w wersji 6.0 lub nowszej. Serwer powinien by zainstalowany z dystrybucyjnego CD-ROM zgodnie z instrukcj instalacji. Tworzenie bazy danych Najpierw naley utworzy baz danych (database), w ktrej bd przechowywane tablice i indeksy. W tym celu naley posuy si narzdziem Sybase Central/Utilities/Create Database. Naley wybra miejsce, w ktrym przechowywane bd dane, nastpnie miejsce w ktrym bd przechowywane dzienniki. Z punktu widzenia Mediatora instalacja Javy nie jest konieczna, wic mona j pomin (opcje "Install base Java classes" i "Install jConnect meta-information support"). Naley wybra rozmiar strony (np. 2048 B) oraz zestaw znakw - z predefiniowanych najlepiej 852. Po utworzeniu bazy naley si do niej poczy.W bazie powinno by wystarczajco duo przestrzeni na dane. Szacunkowo mona przyj, e naley zarezerwowa w bazie tyle miejsca ile zajmuj pliki .DBF wraz z indeksami. Po poczeniu si do bazy naley otworzy folder "DB Spaces" i wyedytowa wasnoci przestrzeni SYSTEM, po czym doda odpowiedni liczb stron. Naley rwnie zmieni opcje bazy danych dotyczce maksymalnej iloci kursorw i wyrae (baza/Set Options). Wartoci parametrw Max_cursor_count i Max_statement_count mona ustawi na 0 (bez ogranicze) albo oszacowa potrzebn liczb zalenie od aplikacji XBASE.Naley przyj ok. 6 kursorw i wyrae SQL na kad otwart tablic. Zakadanie uytkownikw bazy danych W utworzonej bazie naley zaoy co najmniej jednego uytkownika, ktry bdzie wacicielem tablic i indeksw (Folder Users&Groups/Add User). Zaoony uytkownik powinien mie prawo dostpu do bazy (opcja "User is allowed to connect") oraz prawo do tworzenia obiektw (opcja "Resource"). Nie jest wymagany przywilej Remote DBA. MEDIATOR 4.3. Dokumentacja uytkownikaII-5Uruchamianie serwera Zalenie od potrzeb serwer SQL Anywhere moe by uruchamiany jako serwer sieciowy (przez DBSRV6) lub jako lokalny (przez DBENG6). Naley pamita e przydzielenie wikszej pamici dobrze wpywa na jako pracy bazy (opcja -c, np. -c 20M daje 20 MB cache na odczyt z bazy). Tworzenie rda danych ODBC Naley utworzy systemowe rdo danych ODBC, przez ktre serwer Mediator bdzie si czy do serwera bazy danych. rdo danych zakada si za pomoc narzdzia Administrator ODBC (Control Panel/ODBC Data Sources). Naley wybra zakadk System DSN i nacisn guzik Add. Nastpnie naley wybra sterownik "Adaptive Server Anywhere 6.0", wpisa nazw rda i opis. Zalenie od konfiguracji uzupeni parametry bazy danych z zakadki "Database". Na zakadce "Advanced" naley wyczy opcj "Allow multiple record fetching". d)Przygotowanie serwera PostgreSQL Mediator wsppracuje z serwerem PostgreSQL w wersji 7.2 lub nowszej. Serwer powinien by zainstalowany zgodnie z instrukcj instalacji. Tworzenie bazy danych Najpierw naley utworzy baz danych (database), w ktrej bd przechowywane tablice i indeksy. W tym celu najlepiej posuy si programem narzdziowym createdb.Na dysku, na ktrym zostaa zaoona baza powinno by wystarczajco duo miejsca na dane i ich rozrost. Parametry serwera domylnie znajduj si w pliku postgresql.conf. Mona go edytowa za pomoc dowolnego edytora plikw tekstowych. Konieczn zmian jest wyczenie moliwoci odczytywania caych tablic poprzez wstawienie linii: enable_seqscan=false. Pozostae wartoci mona zmienia w zalenoci od potrzeb, np. zwikszy iloc pamici na bufory (shared_buffers). Naley jednak uwaa aby nie przekroczy dostpnej pamici operacyjnej, poniewa korzystanie z pamici wirtualnej bardzo spowalnia prac. Zakadanie uytkownikw bazy danych W utworzonej bazie naley zaoy uytkownika, ktry bdzie wacicielem tablic i indeksw. Uytkownik moe zosta zaoony poleceniem SQL (CREATE USER) albo programem narzdziowym (skryptem) createuser. Najatwiej mona to zrobi narzdziem graficznym PGAdmin.Tworzenie rda danych ODBC Na komputerze, na ktrym zosta zainstalowany serwer Mediator naley utworzy rdo danych ODBC, przez ktre serwer Mediator bdzie si czy do serwera bazy danych. Na Windows NT/2000/XP rdo danych zakada si za pomoc narzdzia Administrator ODBC (Control Panel/ODBC Data Sources). Naley wybra zakadk System DSN i nacisn guzik Add. Nastpnie naley wybra sterownik "PostgreSQL+(Beta)", wpisa nazw rda i opis. W konfiguracji rda danych (Datasource/Advanced Otions/Page 2) naley wyczy konwersj LF do CR+LF. W celu korzystania z ODBC w systemie linuxowym naley zainstalowa managera iODBC oraz postgresowy driver odbc (psqlodbc), a nastpnie skonfigurowa rdo danych (biblioteki managera iODBC wymagane s prze Mediatora dla PostgreSQL). Parametry rda danych s zapisane w pliku .odbc.ini w katalogu domowym uytkownika (o ile nie zostao to zmienione podczas instalacji managera). Przykadowy plik .odbc.ini: [ODBC Data Sources] test= PostgreSQL Test [test] Description= Postgres SQL Test Driver= /usr/local/lib/psqlodbc.so Trace= No Database = testdb Servername= localhost UserName = postgres Port= 5432 Protocol = 6.4 ReadOnly = No RowVersioning= No ShowSystemTables= No ShowOidColumn= No MEDIATOR 4.3. Dokumentacja uytkownikaII-6FakeOidIndex= No Powyszy plik moemy edytowa za pomoc edytora systemowego (np. vi) lub te narzdzi graficznych doczonych do managera iODBC: iodbcadm-gtk. Naley sprecyzowa nazw rda danych, sterownik, nazw serwera, baz danych, port oraz protokl. Ponadto w pliku .odbcinst.ini sprecyzowane sa dostpne sterowniki odbc zainstalowane w systemie (plik ten nie jest wymagany) Przykadowy plik .odbcinst.ini: [ODBC Drivers] Postgres = Installed [Postgres] Driver = /usr/lib/psqlodbc.so Zalecenia administracyjne Koniecznie co jaki czas (najlepiej codziennie w nocy) naley wykonywa porzdkowanie baz instrukcj VACUUM (vacuumdb d nazwa_bazy albo: vacuumdb a). e)Przygotowanie innych serwerw baz danych Serwer bazy danych (MySQL, DB2, czy inne, dla ktrych dostpny jest serwer Mediator) powinien by zainstalowany zgodnie z instrukcj instalacji. Naley utworzy uytkownika, ktry bdzie mia prawo do poczenia do bazy danych oraz tworzenia w niej obiektw. Naley zapewni odpowiedni przestrze do przechowywania danych oraz utworzy rdo danych ODBC , przez ktre serwer Mediator bdzie si czy do serwera bazy danych. Na Windows NT/2000/XP rdo danych zakada si za pomoc narzdzia Administrator ODBC (Control Panel/ODBC Data Sources). Naley wybra zakadk System DSN i nacisn guzik Add. Nastpnie naley wybra odpowiedni sterownik, wpisa nazw rda i opis. 4.Przygotowanie serwera MEDIATOR Po zainstalowaniu serwera zgodnie z instrukcj naley go uruchomi. Sposb uruchamiania i obsuga serwera opisane zostay w rozdziale Obsuga serwera Mediator na stronie III-1. 5.Przygotowanie klienta CA-Clipper Stacja robocza programisty nie wymaga wielu przygotowa. Powinien by zainstalowany DOS, klient sieci Netware, CA-Clipper 5.2e lub 5.3, Blinker 4.0+ oraz klient MEDIATOR. Przed przystpieniem do pracy naley ustawi zmienne rodowiskowe DOS: MEDNETADDR, MEDNODEADDR i MEDSOCKET (plik SPXENV.BAT lub TCPENV.BAT zalenie od uywanego protokou sieciowego). Jeeli korzysta si ze zbioru TCPENV.BAT generowanego przez serwer Mediator konieczne jest uzupenienie wartoci parametru MEDNODEADDR (zbir SPXENV.BAT nie wymaga uzupenienia). Przykadowe programy oraz skrypt do kompilacji i czenia znajduj si w katalogu SOURCE\UTIL. Zmienne rodowiskowe DOS W celu poczenia z serwerem MEDIATOR aplikacja CA-Clipper powinna zidentyfikowa adres serwera. Adres serwera ma trzy skadniki, ktre aplikacja odczytuje z odpowiednich zmiennych rodowiska DOS lub pliku MEDAPP.INI.S to: MEDNETADDR - adres sieci MEDNODEADDR - adres wza MEDSOCKET - port sieciowy Na serwerze Windows NT/2000/XP powysze parametry mog by odczytane automatycznie przez serwer MEDIATOR po jego uruchomieniu i zapisane w pliku o podanej przez uytkownika nazwie.Dla komunikacji przez SPX: MEDNETADDR - heksadecymalny adres sieci wewntrznej serwera Na Windows NT/2000/XP odczyta monaprzy pomocy opcji Settings/ControlPanel/Network/Protocols/NWLink IPX/SPX Compatible Transport/Properties/General/Internal Network Number. Jeeli sie wewntrzna na serwerze Windows nie jest zdefiniowana (ma warto 0) naley wpisa numer unikalny w danym rodowisku sieciowym. Przykadowo jeli na serwerze ustawiona jest sie wewntrzna o numerze 123, : MEDIATOR 4.3. Dokumentacja uytkownikaII-7to parametr MEDNETADDR powinien by ustawiony na: SET MEDNETADDR = 00000123 (konieczne uzupenienie zerami do 8 cyfr) MEDNODEADDR - jeli MEDNETADDR ustawiony jest na adres sieci wewntrznej serwera to adres wza naley ustawi na 1: SET MEDNODEADDR = 000000000001 (konieczne uzupenienie zerami do 12 cyfr) MEDSOCKET - domylnym portem SPX dla serwera MEDIATOR jest 4546: SET MEDSOCKET = 4546 Zawarto zbioru SPXENV.BAT dla sieci wewntrznej 123 moe wyglda nastpujco: SET MEDNETADDR = 00000123 SET MEDNODEADDR = 000000000001 SET MEDSOCKET = 4546 Dla komunikacji przez TCP: MEDNETADDR - warto jest nieistotna - moe zosta pominita MEDNODEADDR - naley wpisa adres IP serwera (dla serwera Windows NT/2000/XP moe zosta odczytany z konfiguracji protokou TCP/IP Settings/Control Panel/Network/Protocols/TCP IP. Przykadowo:SET MEDNODEADDR = 10.19.1.1 MEDSOCKET - domylnym portem TCP dla serwera MEDIATOR jest 19C8 SET MEDSOCKET = 19C8 Zawarto zbioru TCPENV.BAT dla adresu serwera 10.19.1.1 moe wyglda nastpujco: SET MEDNETADDR =SET MEDNODEADDR = 10.19.1.1 SET MEDSOCKET = 19C8 Parametry logowania do bazy danych (automatyczne logowanie) Jeeli podczas czenia programu doczony zostanie plik noautlog.objwwczas aplikacja sama jest odpowiedzialna za nawizanie poczenia z serwerem Mediator przez wywoanie funkcji MedLogin. W przeciwnym przypadku zaraz po uruchomieniu programu podjta zostanie prba automatycznego poczenia z serwerem Mediator.Aplikacja sprbuje ustali wartoci nastpujcych parametrw: MEDNETADDR MEDNODEADDR MEDCS MEDSOCKET MEDUSER MEDPASSWD W tym celu wykonywane s nastpujce kroki: 1. Odczytywana jest warto zmiennej rodowiskowej MEDINIFILE, ktra moe zawiera nazw pliku z parametrami konfiguracyjnymi. Jeeli odczytanie zmiennej MEDINIFILE nie powiodo si, aplikacja zakada e parametry znajduj si w plikuMEDAPP.INI w biecym katalogu aplikacji. 2. Odczytywana jest warto zmiennej rodowiskowej MEDCONN, ktra moe zawiera nazw sekcji pliku konfiguracyjnego z ktrej maj by odczytane parametry poczenia. Jeeli MEDCONN nie jest zdefiniowana, aplikacja przyjmuje, e parametry s zdefiniowane w sekcji gwnej (czyli bez podanej sekcji). 3. Dla kadego parametru niezalenie wykonywane s nastpujce czynnoci: aplikacja prbuje odczyta warto parametru ze rodowiska funkcj GETENV() jeeli nie udao si odczyta wartoci parametru ze rodowiska, aplikacja prbuje odczyta jego warto z pliku konfiguracyjnego z sekcji ustalonej w kroku 2. Jeeli wykonanie opisanych krokw umoliwi okrelenie wartoci parametrw MEDNODEADDR, MEDUSER i MEDPASSWD, aplikacja wykonuje prb poczenia z serwerem Mediator korzystajc z ustalonych wartoci MEDIATOR 4.3. Dokumentacja uytkownikaII-8parametrw. Jeeli wartoci MEDSOCKET i MEDCS nie udao si odczyta, s one przekazywane jako odpowiednio 19C8 i (string pusty). W przypadku, jeeli nie uda si ustali wartoci trzech wymienionych parametrw, aplikacja wywietli pytanie o parametry logowania do RDBMS (nazwa uytkownika, haso, baza, adres serwera i port serwera). Przykadowy plik MEDAPP.INI z parametrami znajduje si w podkatalogu BIN klienta Mediator. Uwaga! MEDCS - baza - dla Oracle jest to nazwa serwisu rozpoznawana przez SQL*Net na serwerze (jeli nie jest podawana to poczenie jest domylnie kierowane poprzez parametr LOCAL ustawiony na serwerze) Dla pozostaych baz jest to nazwa rda ODBC na komputerze, na ktrym jest zainstalowany serwer Mediator.Przykad: SET MEDUSER = test SET MEDPASSWD = test SET MEDCS = test_ipc UWAGA! Uruchamiajc aplikacj CA-Clipper/MEDIATOR w rodowisku Windows 95/98/ME/2000/XP lub Windows NT naley zwrci uwag, aby dla programu wyczona bya opcja wstrzymywania pracy w tle (Waciwoci/Inne/To: Zawsze wstrzymuj albo Properties/Misc/Background: Always suspend).6.Przygotowanie klienta (x)Harbour Klient Mediator dla (x)Harbour moe by instalowany na Windows 95/98/ME/2000/NT/XP. Klienta Mediator najlepiej zainstalowa programem instalacyjnym. Klient (x)Harbour moe by instalowany w tym samym katalogu w ktrym jest zainstalowany klient dla Clippera lub/i CA-VO. Po zainstalowaniu wskazane jest rczne dopisanie katalogu z binariami (...\Harbour\Bin;...\xHarbour\bin) do cieki systemowej. Naley rwnie pamita o dostosowaniu skryptw z katalogw ...\Harbour\Bin i ...\xHarbour\Bin do lokalnej instalacji przez wpisanie odpowiednich katalogw w definicji zmiennych. UWAGA! Obecnie dostpne s nastpujce wersje klienta Mediator dla (x)Harbourdla rodowiska Windows: \b32 kompilowana kompilatorem Borland C++ 5.5 zgodna z oficjaln dystrybucj (x)Harbour kompilowan Borlandem \vc kompilowana kompilatorem VC++ 6.0 SP5 firmy Microsoft z opcj /TP zgodna z oficjaln dystrybucj (x)Harbour kompilowan kompilatorem MSVC\xcc kompilowana kompilatorem VC++ 6.0 SP5 firmy Microsoft bez opcji /TP zgodna z komercyjn wersj xHarbour dystrybuowan przez xHarbour.com Inc. (www.xharbour.com) Naley rwnie pamita e wersja (x)Harbour musi by zgodna w wersj bibliotek Mediator. Wicej informacji na temat kompilacji srodowiska Harbour oraz xHarbour dla potrzeb Mediatora oraz wersja (x)Harbour z ktr mog by czone dane biblioteki znajduje si w plikach ....\Harbour\hbreadme.txt oraz ....\xHarbour\hbreadme.txt Poczenie aplikacji (x)Harbour z serwerem MediatorAby aplikacja (x)Harbour mogawsppracowa z Mediatorem konieczne jest nawizanie poczenia midzy aplikacj i serwerem Mediator. Poczenie jest nawizywane identycznie jak w przypadku aplikacji CA-Clipper. W trybie poczenia automatycznego, parametry poczenia odczytywane s ze rodowiska i, w drugiej kolejnoci, z pliku konfiguracyjnego MEDAPP.INI. Tworzc aplikacj (x)Harbour korzystajc z Mediatora naley doczy do biecego projektu bibliotek MEDNTX.LIB. Biblioteka ta zawiera zarwno sterownik MEDNTX jak i MEDCDX. Niezalenie od tego z ktrego sterownika chcemy korzysta, w jednym z plikw aplikacji powinnimy umieci polecenie REQUEST MEDNTX Przykadowe skrypty do kompilacji i czenia aplikacji doczaj bibliotek MEDNTX.LIB. Jeeli aplikacja korzysta z rozszerze Mediatora, czasem konieczne jest doczenie do aplikacji pliku nadgwkowego Mediator.ch poleceniem: #include mediator.ch MEDIATOR 4.3. Dokumentacja uytkownikaII-9na pocztku kadego pliku PRG korzystajcego z rozszerze. ledzenie (debugging) w rodowisku (x)Harbour Aplikacje (x)Harbour ze sterownikiem Mediator mog by wykonywane w trybie ledzenia. Aby podczas ledzienia aplikacja (x)Harbour nie zostaa rozczona przez serwer Mediator, co typowo nastpuje po ok. 1 min. bezczynnoci, naley na samym pocztku programu, po nawizaniu poczenia z serwerem Mediator wstawi wywoanie funkcji: MedDiscTm(65535) Wykonanie funkcji zablokuje standardow procedur rozczania i umoliwi wygodne ledzenie programu. Naley pamita o usuniciu lub wykomentowaniu powyszego wywoania po zakoczeniu ledzienia programu. 7.Zgodno wersji klienta i serwera Mediator Podczas nawizywania poczenia pomidzy aplikacj i serwerem Mediator nastpuje weryfikacja zgodnoci wersji oprogramowania. Wersje s oznaczone czterema liczbami np.: 1.4.0.2, gdzie kolejne liczby oznaczaj: gwny numer wersji (1), szczegowy numer wersji (4), numer poprawki (0) oraz numer drobnej poprawki (2). Klient poczy si z serwerem jeli rnice w numerze wersji wystpuj na ostatnim miejscu (tj. w numerze drobnej poprawki). Jeli rnice wystpi w innym miejscu, wwczas klient odmwi poczenia np. Nr klienta 1.4.0.2 Nr serwera 1.4.0.5 - poczenie zostanie nawizane Nr klienta 1.4.1.5 Nr serwera 1.4.0.5 - poczenie nie zostanie nawizane (niezgodno w numerze poprawki). MEDIATOR 4.3. Dokumentacja uytkownikaIII-1ROZDZIA 3 III.Obsuga serwera Mediator Serwer Mediator, w zalenoci od platformy, na ktrej jest uywany moe by wyposaony w ograniczony interfejs uytkownika pozwalajcy na uruchomienie i zastopowanie usugi oraz podgld iloci zalogowanych uytkownikw oraz informacji licencyjnych. Serwery Mediator pracujce w tle jako serwis (wszystkie serwery na platformy UNIXowe i wersja Mediatora dla Windows NT/2000 pracujca jako usuga/serwis), nie powizane z konsol danego systemu operacyjnego, nie posiadaj adnego interfejsu uytkownika. Wszystkie serwery niezalenie od platformy mog by konfigurowane i monitorowane wycznie poprzez sie komputerow przy uyciu zewntrznej aplikacji o nazwie MMT (Mediator Management Tool), uruchamianej na MS Windows 95/98/ME/NT/2000/XP i dostarczanej wraz z Mediatorem. Aplikacja ta jest opisana w rozdziale Zewntrzny program konfiguracyjny z monitorem dla serwerw Mediator na stronie III-7. 1.Mediator dla Windows NT (wersja desktop) a)Uruchamianie serwera Serwer Mediator dla Windows NT uruchamiany jest tak samo jak kada aplikacja Windows bezporednio poprzez ikon aplikacji, przez skrt do aplikacji lub z linii komend. Bezporednio po uruchomieniu serwer nie jest jeszcze aktywny i nie oczekuje na poczenia od stacji klienckich. Aby go zaktywizowa naley uy przycisku Start na gwnym panelu. Istnieje moliwo uruchomienia serwera bezporednio w trybie oczekiwania na poczenie. Naley wtedy do wywoania programu doda parametr /s lub s. Jest to moliwe tylko przy uruchamianiu z linii komend lub poprzez skrt, w ktrego waciwociach (Properties) mona do linii wywoania programu (Target) doda parametr /s lub s.mediator /s lub mediator s b)Konfiguracja Zmiana opcji programu i dodawanie uytkownikw moe odbywa si tylko poprzez sie przy uyciu aplikacji MMT, ktra jest opisana w rozdziale Zewntrzny program konfiguracyjny z monitorem dla serwerw Mediator na stronie III-7. MEDIATOR 4.3. Dokumentacja uytkownikaIII-2c)Gwny panel serwera Mediator dla Windows NT Po uruchomieniu serwera Mediator dla Windows NT pojawia si panel sucy do sterowania gwnymi funkcjami serwera i wywietlania podstawowych informacji na temat stanu serwera. W nagwku okna wywietlana jest nazwa wraz z wersj programu (dwie pierwsze cyfry wersji). Dokadny numer wersji (cztery cyfry) podany jest w okienku dialogowym About dostpnym z gwnego panelu. Poniej opisano znaczenie poszczeglnych elementw panelu. Rysunek 4. Gwny panel serwera Mediator dla Windows NT w stanie nieaktywnym Graficznie przedstawiony semafor obrazuje biecy stan serwera (w zalenoci od ustawionych opcji wywietlany jest w trybie monochromatycznym lub kolorowym): wiato czerwone i napis Resting... serwer w spoczynku - nie pracuj procesy oczekujce na zgoszenia klientw; wiato te i napis Starting... serwer w fazie uruchamiania i konfiguracji procesw oczekujcych na zgoszenia; wiato te i napis Stopping... serwer w fazie rozczania ewentualnych sesji i wygaszania pracujcych wtkw; wiato zielone i napis Running... serwer w trakcie pracy - obsuguje doczonych klientw i oczekuje na zgoszenia nowych. Przycisk Start powoduje uruchomienie serwera tzn. przejcie ze stanu spoczynku do fazy oczekiwania na zgoszenia klientw. W trakcie pracy serwera przycisk Start jest nieaktywny. MEDIATOR 4.3. Dokumentacja uytkownikaIII-3Przycisk Stop powoduje przejcie serwera do stanu spoczynku jeeli do serwera s doczeni uytkownicy, wwczas po potwierdzeniu zamiaru wyczenia serwera ich sesje s zamykane. Przycisk nie powoduje wyjcia z aplikacji serwera. W stanie spoczynku przycisk Stop jest nieaktywny. Ramka Users okrela maksymaln moliw ilo poczonych rwnoczesnych aplikacji lub urzdze(okienko License limit) oraz ilo aktualnie doczonych klientw (okienko Connected). Ramka protokow sieciowych gdy serwer jest w spoczynku, w okienkach nie ma adnej informacji. Podczas pracy okienko Active SPX Socket wywietla numer socketa SPX, na ktrym serwer oczekuje na zgoszenia klientw wykorzystujcych protok IPX/SPX, natomiast okienko Active TCP Port wywietla numer portu TCP, na ktrym serwer oczekuje na zgoszenia stacji roboczych wykorzystujcych protok TCP/IP. W przypadku konfliktw z innymi aplikacjami sieciowymi pracujcymi na serwerze, domylne wartoci portu TCP lub socketa SPX mona zmieni w konfiguratorze Mediatora. Okienko Licensed to zawiera nazw i adres uytkownika kocowego serwera Mediator. Nazwa ta jest wprowadzana bezporednio przez producenta (OTC). Ramka License number zawiera numer licencji serwera Mediator udzielonej uytkownikowi, ktrego nazwa widnieje w okienku Licensed to lub sowo TEMPORARY dla serwerw demo i ewaluacyjnych. Ramka License type okrela rodzaj licencji udzielonej uytkownikowi: FULL USE pena licencja do komercyjnego wykorzystania serwera, DEVELOPMENT licencja wycznie dla celw rozwijania, testowania i demonstracji oprogramowania aplikacyjnego pracujcego w oparciu o pakiet Mediator FOR NO COMMERCIAL USE licencja wycznie do uytkowania w celach pokazowych, edukacyjnych lub testowych nie do wykorzystania komercyjnego EVALUATION licencja czasowa do testowania oprogramowania aplikacyjnego u klienta w ramce te pojawia si rwnie data okrelajca koniec okresu ewaluacyjnego. Ramka AIO model okrela stan pracy serwera (tylko w wersji dla Windows NT/2k/XP) pracujcego w trybie asynchronicznego przydziau wtkw roboczych (jeeli serwer nie pracuje w trybio AIO, ramka z zawartoci jest nieaktywna). Ramka Lock Manager przedstawia ilo pocze do Lock Managera oraz maksymaln ilo rwnoczenie zajtych i biec ilo wolnych pocze (w przypadku wyczonej opcji pracy z LM ramka jest nieaktywna). Przycisk Exit umoliwia zamknicie aplikacji serwera. Jest on aktywny tylko w stanie spoczynku serwera Mediator. MEDIATOR 4.3. Dokumentacja uytkownikaIII-42.Mediator dla Windows NT/2000 (wersja pracujca jako usuga/serwis) a)Uruchamianie serwera Po zainstalowaniu serwera Mediator (medsvc.exe) uruchamia si on automatycznie w momencie startu systemu operacyjnego. Mediator w tej wersji nie wymaga logowania si do systemu Windows NT/2000 ani wykonywania adnych dodatkowych operacji. Mona go zatrzyma i ponownie uruchomi przy pomocy aplikacji Services/Usugi z systemowego panelu sterowania (zob. dokumentacja Windows NT/2000). b)Konfiguracja Zmiana opcji programu i dodawanie uytkownikw moe odbywa si tylko poprzez sie przy uyciu aplikacji MMT, ktra jest opisana w rozdziale Zewntrzny program konfiguracyjny z monitorem dla serwerw Mediator na stronie III-7. 3.Mediator dla NetWare a)Uruchamianie serwera Serwer Mediator dla NetWare uruchamiany jest komend serwera NetWare: load mediator Bezporednio po uruchomieniu serwer nie jest jeszcze aktywny i nie oczekuje na poczenia od stacji klienckich. Aby go zaktywizowa naley uy klawiszy Alt+F2 na gwnym panelu. Istnieje moliwo uruchomienia serwera bezporednio w trybie oczekiwania na poczenia. Naley wtedy do wywoania programu doda parametr /s lub s. load mediator /s lub load mediator s b)Konfiguracja serwera Mediator dla NetWare Zmiana opcji programu i dodawanie uytkownikw moe odbywa si tylko poprzez sie przy uyciu aplikacji MMT, ktra jest opisana w rozdziale Zewntrzny program konfiguracyjny z monitorem dla serwerw Mediator na stronie III-7. Z konsoli programu mog by zmieniane wycznie numery socketa SPX i portu TCP w sposb opisany w poprzednim punkcie. MEDIATOR 4.3. Dokumentacja uytkownikaIII-5c)Gwny panel serwera Mediator dla NetWare Po uruchomieniu serwera Mediator dla NetWare pojawia si panel sucy do sterowania gwnymi funkcjami serwera i wywietlania podstawowych informacji na temat stanu serwera. W nagwku okna wywietlana jest nazwa wraz z penym numerem wersji programu. Poniej opisano znaczenie poszczeglnych elementw panelu. Ramka Licensed to zawiera nazw i adres uytkownika kocowego serwera Mediator. Nazwa ta jest wprowadzana bezporednio przez producenta (OTC). Ramka License number zawiera numer licencji serwera Mediator udzielonej uytkownikowi, ktrego nazwa widnieje w okienku Licensed to lub sowo TEMPORARY dla serwerw demo i ewaluacyjnych. Ramka License type okrela rodzaj licencji udzielonej uytkownikowi: FULL USE pena licencja do komercyjnego wykorzystania serwera, DEVELOPMENT licencja wycznie dla celw rozwijania, testowania i demonstracji oprogramowania aplikacyjnego pracujcego w oparciu o pakiet Mediator EVALUATION licencja czasowa do testowania oprogramowania aplikacyjnego u klienta w ramce te pojawia si rwnie data okrelajca koniec okresu ewaluacyjnego. Rysunek 5. Gwny panel serwera Mediator dla NetWare w stanie nieaktywnym Ramka Distributed by zawiera nazw dystrybutora serwera Mediator. Nazwa ta jest wprowadzana bezporednio przez producenta (OTC). Ramka Sockets gdy serwer jest w spoczynku, w okienkach nie ma adnej informacji. Podczas pracy w polu SPXwywietlany jest numer socketa SPX, na ktrym serwer oczekuje na zgoszenia klientw wykorzystujcych protok MEDIATOR 4.3. Dokumentacja uytkownikaIII-6IPX/SPX, natomiast w polu TCP wywietlany jest numer portu TCP, na ktrym serwer oczekuje na zgoszenia stacji roboczych wykorzystujcych protok TCP/IP. W przypadku konfliktw z innymi aplikacjami sieciowymi pracujcymi na serwerze, domylne wartoci portu TCP lub socketa SPX mona zmieni uywajc klawiszy Alt+F6 Ramka Users okrela maksymaln moliw ilo rwnoczesnych sesji(okienko Licensed) oraz ilo aktualnie doczonych klientw (okienko Connected). Biae pole poniej ramek Users i Sockets obrazuje biecy stan serwera: napis ...RESTING... serwer w spoczynku - nie dziaaj procesy oczekujce na zgoszenia klientw; napis ...STARTING... serwer w fazie uruchamiania i konfiguracji procesw oczekujcych na zgoszenia; napis ...STOPPING... serwer w fazie rozczania ewentualnych sesji i wygaszania pracujcych wtkw; napis ...RUNNING... serwer w trakcie pracy - obsuguje doczonych klientw i oczekuje na zgoszenia nowych. Biae pole zawierajce informacje na temat producenta (OTC). Rysunek 6. Gwny panel serwera Mediator dla NetWare w stanie aktywnym Nacinicie klawiszy Alt+F2 powoduje uruchomienie serwera tzn. przejcie ze stanu spoczynku do fazy oczekiwania na zgoszenia klientw. Nacinicie klawiszy Alt+F4 powoduje przejcie serwera do stanu spoczynku jeeli do serwera s doczeni uytkownicy, wwczas po potwierdzeniu zamiaru wyczenia serwera ich sesje s zamykane. Przycisk nie powoduje cakowitego zamknicia serwera. MEDIATOR 4.3. Dokumentacja uytkownikaIII-7Nacinicie klawiszy Alt+F6 powoduje uruchomienie edycji numerw socketa SPX i portu TCP. Zmiana powoduje automatyczne zapisanie nowych wartoci do pliku konfiguracyjnego. Nacinicie klawiszy Alt+F10 powoduje cakowite zamknicie serwera. Jeeli jest on w stanie aktywnym, to najpierw nastpuje przejcie serwera do stanu spoczynku. Jeeli do serwera s doczeni uytkownicy, wwczas po potwierdzeniu zamiaru wyczenia serwera ich sesje s zamykane. 4.Zewntrzny program konfiguracyjny z monitorem dla serwerw Mediator Do konfiguracji serwerw Mediator nie posiadajcych interfejsu uytkownika lub posiadajcych go w ograniczonej postaci zostaa opracowana aplikacja o nazwie Mediator Management Tool (mmt.exe) pracujca pod kontrol MS Windows 95/98/ME/NT/2000/XP. Aplikacja zwizana jest z serwerem, ktrym ma zarzdza i posiada ten sam numer wersji. Program MMT komunikuje si z Mediatorem za porednictwem sieci komputerowej wykorzystujc protok IP lub IPX, przy czym do komunikacji z serwerami UNIXowymi suy wycznie protok IP. MMT umoliwia zarzdzanie wieloma serwerami Mediator, ktre jednak musz by w tej samej wersji. Konsola programu pozwala na zdefiniowanie do omiu serwerw i utrzymywanie z nimi rwnoczesnych pocze. a)Konsola programu MMT Na rysunku przedstawiono gwne okno aplikacji MMT skadajce si z listy serwerw oraz szeregu przyciskw umoliwiajcych rne operacje zwizane z wywietlan list i z prac aplikacji. Rysunek 7. Gwny panel programu MMT MEDIATOR 4.3. Dokumentacja uytkownikaIII-8Definiowanie, usuwanie i modyfikacja pocze Po pierwszym uruchomieniu aplikacji MMT lista pocze do zarzdzanych serwerw jest pusta. Do tworzenia, modyfikacji i usuwania pocze suy zestaw przyciskw na konsoli programu. Poniej przedstawiono krtki opis ich dziaania. Przycisk Add New Connection uruchamia formatk ekranow suc do definiowania nowych pocze. Rysunek 8. Formatka Add New Connection Aby doda poczenie naley wypeni w formatce nastpujce pola: oProtocol Family - protok komunikacyjny (domylnie UDP/IP), oServer Nickname - nazw poczenia (alias), ktra bdzie identyfikowaa dany serwer we wszystkich oknach dialogowych MMT, oServer Protocol Address - adres serwera, na ktrym zainstalowany jest Mediator jeeli poczenie wykorzystuje protok IP, adres mona poda w postaci numerycznej w formacie xxx.xxx.xxx.xxx (np. 100.110.120.130) lub w postaci symbolicznej (np. alfa.acme.com) w przypadku protokou IPX adres naley poda w postaci net_number:node_number (np. 01234567:0123456789AB), oPort/Socket - numer portu UDP/IP lub socketa IPX (w postaci heksadecymalnej np. 19C7) domylnym portem UDP/IP, na ktrym Mediator sucha polece od MMT jest 19C7hex, domylnym numerem socketa IPX do komunikacji z MMT jest 4545hex. Po naciniciu przycisku OK zostanie sprawdzona poprawno wprowadzonych danych i, o ile adres serwera zosta podany w postaci symbolicznej, zostanie dokonana prba rozwizania adresu tzn. zamiany go na posta numeryczn. Jeeli wszystkie dane zostay wprowadzone poprawnie, nazwa poczenia pojawi si na licie w gwnym oknie dialogowym. Jeeli ktrekolwiek z pl formatki Add New Connection zostao bdnie wypenione, program wywietli stosowny komunikat. Po zdefiniowaniu maksymalnej liczby pocze przycisk Add New Connection staje si nieaktywny. Mona go uy znowu dopiero po usuniciu z listy co najmniej jednego poczenia. MEDIATOR 4.3. Dokumentacja uytkownikaIII-9Przycisk Remove Connection suy do usuwania z pocze z listy. Aby usun poczenie naley zaznaczy myszk nazw serwera na licie pocze i nacisn przycisk Remove Connection. Po potwierdzeniu zamiaru usunicia poczenia, zostanie ono wykasowane z listy. Jeeli na licie nie ma adnych zdefiniowanych pocze, przycisk Remove Connection jest nieaktywny. Przycisk Edit Connection suy do zmiany parametrw zdefiniowanego poczenia. Po naciniciu tego przycisku uruchamia si formatka podobna do uywanej przy dodawaniu nowego poczenia. Rysunek 9. Formatka Edit Connection Przy jej pomocy mona zmodyfikowa wszystkie parametry poczenia za wyjtkiem nazwy serwera (Server Nickname). Znaczenie poszczeglnych pl jest takie samo jak w przypadku dodawania nowego poczenia. Po naciniciu przycisku OK zostanie sprawdzona poprawno wprowadzonych danych i, o ile adres serwera zosta podany w postaci symbolicznej, zostanie dokonana prba rozwizania adresu tzn. zamiany go na posta numeryczn. Jeeli wszystkie dane zostay wprowadzone poprawnie, nazwa poczenia pojawi si na licie w gwnym oknie dialogowym. Jeeli ktrekolwiek z pl formatki Edit Connection zostao bdnie wypenione, zostanie wywietlony stosowny komunikat. Jeeli na licie nie ma adnych zdefiniowanych pocze, przycisk Edit Connection jest nieaktywny. Przycisk Save Connection List zapisuje do rejestru systemowego parametry zdefiniowanych pocze, aby zostay zachowane po zamkniciu aplikacji MMT. czenie z serwerem Mediator Aby poczy si z wybranym serwerem, naley zaznaczy jego nazw myszk na licie pocze i uy przycisku Connect. Jeeli serwer jest dostpny, zostanie nawizane poczenie, serwer odele podstawowe informacje na swj temat i zostanie wywietlone nowe okno zatytuowane Description of NAZWA, ktre bdzie opisane w rozdziale Opis serwera (okno: Description of...) na stronie III-10. Jednoczenie MEDIATOR 4.3. Dokumentacja uytkownikaIII-10mona poczy si z kilkoma serwerami. Jeeli dany serwer jest niedostpny zostanie wywietlony stosowny komunikat. Pomoc Po naciniciu przycisku Help znajdujcego si na konsoli, zostanie wywietlony dokument opisujcy w skrcie dziaanie podstawowych funkcji aplikacji MMT. Wyjcie z programu Do zakoczenia pracy z programem MMT suy przycisk Exit. Po jego naciniciu zostan zamknite wszystkie okna aplikacji. Jeeli na licie pocze zostay dokonane jakiekolwiek zmiany, program zaproponuje ich zapisanie chyba, e uytkownik zrobi to wczeniej przyciskiem Save Connection List. b)Opis serwera (okno: Description of...) Po poczeniu si z zarzdzanym serwerem zostaje wywietlone okno zatytuowane Description of NAZWA_POCZENIA. W oknie tym wywietlone s nastpujce informacje: OS system operacyjny, pod kontrol ktrego pracuje zarzdzany Mediator. Database baza danych, z ktr komunikuje si Mediator (Oracle, MS Sql Server, Sybase Adaptive Server Anywhere, PostgreSQL). SPX socket numer socketa IPX/SPX, na ktrym Mediator czeka na zgoszenia od urzdze klienckich. TCP port numer portu TCP/IP, na ktrym Mediator czeka na zgoszenia od urzdze klienckich. Active from ... czas od ostatniego uruchomienia serwera w formacie dni/godziny/minuty/sekundy. Licensed for maksymalna moliwa ilo rwnoczenie doczonych do serwera sesji (apps)/urzdze (devs) zgodnie z licencj na dany serwer, Connected apps ilo aplikacji doczonych w danym momencie do serwera, Connected devices ilo urzdze (komputerw) doczonych w danym momencie do serwera, Licensed to nazwa waciciela licencji na uytkowanie oprogramowania Mediator, Lic. number numer licencji na uytkowanie serwera (lub TEMPORARY dla serwerw ewaluacyjnych i demonstracyjnych), Lic. type