Instrukcja instalacji Esri Geoportal Server w wersji 1.2.4

Instrukcja instalacji Esri Geprtal Server w wersji 1.2.4 Wprwadzenie Dkument ten jest instrukcją pdstawwej instalacji narzędzia Esri Geprtal Server w wersji 1.2.4. P instalacji mżliwa jest także ddatkwa knfiguracja i ddanie nwych funkcjnalnści, które nie są dstępne,,prst z pudełka. Szczegółwe infrmacje na temat ddatkwej knfiguracji i mżliwści rzbudwy narzędzia znajdują się pd adresem https://github.cm/esri/geprtalserver/wiki/develpment-tpics Wymagania śrdwiska, na którym ma zstać zainstalwany Esri Geprtal Server: Śrdwisk maszyny, na której ma zstać zainstalwany Esri Geprtal Server wymaga systemu peracyjneg, bazy danych, śrdwiska niezbędneg d prgramwania w języku Java, czyli pełnej implementacji Java JDK, a także serwera aplikacji webwych. Aby umżliwić autryzację użytkwników w Geprtal Server knieczne będzie także płączenie się z istniejącym serwerem katalgwym przechwującym strukturę użytkwników i ich ról lub w przypadku jeg braku zainstalwanie g i knfiguracja. System peracyjny Wspierane są następujące systemy peracyjne: RedHat Enterprise Linux AS/ES 5 Windws XP SP2 Windws 2003 Server SP2 Windws 2008 Server Standard Windws 2003 Server 64-bit Windws 2008 Server Standard 64-bit Windws 7 Ultimate, Prfessinal Editin 32-bit, 64-bit Windws Server 2008 R2 Bazy danych: Oracle 10g Oracle 11g PstgreSQL 8.4 (32 i 64 bit) PstgreSQL 9.1 (32 i 64 bit) Micrsft SQL Server 2005 SP2 i SP3

Micrsft SQL Server 2008 MySQL 5.5 Java Kdy źródłwe aplikacji Geprtal Server zstały napisane w parciu Java 6. Na maszynie, na której będzie instalwana aplikacja, wymagana jest Java JDK 6 (32 lub 64 bit) lub Java JDK 7 (32 lub 64 bit). Java JDK 7 wymagana jest w przypadku instalacji Apache Tmcat w wersji 7.x. Serwer aplikacji webwych Aplikacja geprtal parta jest na technlgii Java Servlet, dlateg też d jej uruchmienia wymagany jest kntener aplikacji webwych. Wymienine pniżej prgramwanie wspiera technlgię Java Servlet i zstał przetestwane i sprawdzne z aplikacją Geprtal Server. Apache Tmcat 6.0.32 i wyższe wersje 6.x, Apache Tmcat 7.0.x GlassFish 3.1 i Glassfish 3.1.2 Oracle WebLgic 11g Serwer katalgwy i LDAP: D zaimplementwania pełnej funkcjnalnści związanej z uwierzytelnianiem użytkwników wymagany jest serwer katalgwy bsługujący prtkół LDAP. Istnieje mżliwść użycia istniejąceg serwera katalgweg, który wspiera LDAP w wersji 3. Prsta autryzacja: Istnieje również mżliwść sknfigurwania geprtalu dla pjedynczeg knta administratra. Metda ta nie wymaga instalacji serwera katalgweg. Mechanizm ten jest pcją pzwalająca na szybką implementację aplikacji dla celów testwych, ale nie jest zalecany na śrdwiskach prdukcyjnych. ArcGIS fr Server: Instalacja i użycie Geprtal Server nie wymaga ArcGIS fr Server. ArcGIS fr Desktp: ArcGIS fr Desktp 10 lub 10.1 jest wymagany w przypadku gdy chcemy skrzystać z dedykwanych klientów Geprtal Server dla ArcGIS fr Desktp. Więcej infrmacji znajdziesz pd adresem: http://surcefrge.net/apps/mediawiki/geprtal/index.php?title=geprtal_clients_fr_arcgis

Klejne etapy instalacji aplikacji Esri Geprtal Server Pniższe etapy pisane w instrukcji pzwlą na instalację aplikacji Geprtal Server w parciu darmwe kmpnenty prgramistyczne. Geprtal dstępny będzie na lkalnej maszynie i w sieci intranet. Aplikacja zstanie zainstalwana z użyciem bazy danych PstgreSQL i kntenera aplikacji webwych Apache Tmcat. Zstaną przedstawine także klejne krki, których wyknanie umżliwi implementację serwera katalgweg i jeg klienta, dzięki czemu mżliwa będzie autryzacja użytkwników. Infrmacje tym jak zaimplementwać Geprtal Server z użyciem innej bazy lub inneg serwera aplikacji dstępne są pd adresem http://surcefrge.net/apps/mediawiki/geprtal/index.php?title=installatin_versin_1.2.2 C ptrzebujesz żeby zacząć: Jeden z wymieninych wyżej systemów peracyjnych Uprawnienia administratra Płączenie z internetem, aby móc pbrać wymagane prgramwanie Klejne etapy instalacji: 1. Pbranie prgramów i plików. 2. Instalacja Java Develpment Kit (JDK). 3. Wybór mechanizmu autryzacji użytkwników: 3.1. Prsta autryzacja. 3.2. Autryzacja LDAP. 3.2.1. Instalacja Apache Directry Server. 3.2.2. Instalacja Apache Directry Studi. 3.2.3. Definiwanie płączenia pmiędzy klientem i serwerem. 3.2.4. Utwrzenie użytkwników przy użyciu Apache Directry Studi. 3.2.5. Utwrzenie ról użytkwników przy użyciu Apache Directry Studi. 4. Instalacja i knfiguracja Apache Tmcat. 5. Instalacja bazy danych PstgreSQL. 5.1. Utwrzenie użytkwnika i schematu w bazie danych PstgreSQL. 6. Instalacja aplikacji Esri Geprtal Server. 7. Knfiguracja aplikacji Esri Geprtal Server. 8. Knfiguracja JDBC.

1. Pbranie prgramów i plików Pbierz niezbędne kmpnenty prgramistyczne i pliki, które wymienine zstały w pniższej tabeli: Kmpnent Funkcja Wersja Link Esri Geprtal Server Oprgramwanie geprtal 1.2.4 http://www.esri.cm/sftware/arcgis/geprtal http://geprtal.surcefrge.net/ PstgreSQL RDBMS 9.1 http://www.enterprisedb.cm/prducts-servicestraining/pgdwnlad#windws Apache Tmcat Apache Directry Server Serwer aplikacji webwych Serwer katalgwy 7.0.42 http://tmcat.apache.rg/dwnlad-70.cgi 2.0.0 http://directry.apache.rg/apacheds/dwnlads.html Apache Directry Studi Klient serwera katalgweg 2.0.0 http://directry.apache.rg/studi/ Java Develpment Kit Java Java SE Develpment Kit 7 http://www.racle.cm/technetwrk/java/javase/dwnlads/jdk7- dwnlads-1880260.html Plik knfiguracyjny JDBC Płączenie Tmcat z Pstgres pstgresql- 9.1-903.jdbc4.jar http://jdbc.pstgresql.rg/dwnlad.html 2. Instalacja Java Develpment Kit (JDK) Tabela 1 Wymagane prgramy i pliki Uruchm pbrany wcześniej instalatr i zaakceptuj wszystkie dmyślne ustawienia. 3. Wybór mechanizmu autryzacji użytkwników Geprtal Server wspiera dwa różne mechanizmy autryzacji prsta autryzacja lub autryzacja LDAP. Pniższa tabela zawiera krótką charakterystykę bu metd. Właściwści Prsta Autryzacja Autryzacja LDAP Pjedyncze lgwanie d innych aplikacjami Rle użytkwników Knta/prfile użytkwników Wymagane prgramwanie LDAP Autryzacja knfigurwalna w pliku knfiguracyjnym Szybka instalacja Tabela 2 Charakterystyka mechanizmów autryzacji użytkwników

3.1 Prsta autryzacja Prsta autryzacja daje mżliwść utwrzenia jedynie pjedynczeg knta użytkwnika uprawnieniach administratra. Użytkwnik ten jest kreślany w głównym pliku knfiguracyjnym geprtalu - gpt.xml. Wybranie teg spsbu autryzacji nie wymaga instalwania ddatkweg prgramwania, jakim jest serwer katalgwy. Mechanizm ten jest szybkim spsbem na implementację Geprtal Server dla celów testwych, natmiast jeg użycie nie jest zalecane na śrdwiskach prdukcyjnych. Jeżeli jesteś zdecydwany na ten spsób autryzacji, pmiń punkt 3.2 i przejdź d punktu 4. 3.2 Autryzacja LDAP D zaimplementwania pełnej funkcjnalnści autryzacji użytkwników kreślnych uprawnieniach knieczna jest instalacja i knfiguracja serwera katalgweg bsługująceg prtkół LDAP w wersji 3.0. 3.2.1 Instalacja Apache Directry Server Uruchm instalatr i pstępuj zgdnie z instrukcją, aby pmyślnie ukńczyć prces instalacji. Otwórz Panel Sterwania Narzędzia Administracyjne Usługi. Pdświetl serwis reprezentujący twją usługę katalgwą. Jeżeli stan usługi nie jest Uruchmin wybierz pcję Uruchm usługę. 3.2.2 Instalacja Apache Directry Studi Uruchm pbrany wcześniej instalatr i zaakceptuj wszystkie dmyślne ustawienia. 3.2.3 Definiwanie płączenia pmiędzy klientem a serwerem Wyknanie pniższych czynnści wymaga prawidłw zainstalwaneg Apache Directry Server i Apache Directry Studi. Uruchm Apache Directry Studi. Z menu File wybierz New, a następnie LDAP Cnnectin. W knie New LDAP Cnnectin, w części Netwrk Parameter wpisz następujące parametry: Cnnectin name: wpisz dwlną nazwę, np. lcal Hstname: Nazwa maszyny na której zstał zainstalwany serwer LDAP. W przypadku zainstalwania serwera lkalnie, mżesz wpisać lcalhst. Prt: Numer prtu, na którym uruchminy jest serwer LDAP. Dla usługi Apache Directry Server dmyślnym prtem będzie 10389. Encryptin methd: Dla teg płączenia nie ma żadnej metdy szyfrwania.

Rys. 1. Ustawienia parametrów w części Netwrk Parameter, w knie New LDAP Cnnectin. Wybierz przycisk Check Netwrk Parameter. Pwinieneś trzymać wiadmść pmyślnie ustawinym płączeniu. W przeciwnym wypadku zweryfikuj wpisane wartści. Wybierz przycisk Next. W części Authenticatin ustaw następujące parametry: Authenticatin Methd: Wybierz Simple Authenticatin. Bind DN r user: Wpisz wyróżniającą nazwę (DN) dla dmyślneg knta administratra. Dla Apache Directry Server dmyślnym DN będzie uid=admin,u=system. Bind passwrd: Hasł d serwera LDAP użytkwnika administratr. Dla Apache Directry Server dmyślnym hasłem będzie secret.

Rys. 2. Ustawienia parametrów w części Authenticatin, w knie New LDAP Cnnectin. Wybierz przycisk Check Authenticatin. Pwinieneś trzymać wiadmść pmyślnie zakńcznej autryzacji. Wybierz Finish. W lewej części kna zbaczysz strukturę drzewa infrmacyjneg katalgu z elementem DIT (Directry Infrmatin Tree), będącym najwyższym węzłem. Oznacza t, że jesteś płączny z serwerem LDAP. Pczątkwa struktura wpisów zstała utwrzna zaraz p zainstalwaniu Apache Directry Server. P rzwinięciu węzła DIT, a następnie węzła u=system, zbaczysz węzły grup i użytkwników (u=grups i u=users).

Rys. 3. Struktura węzła DIT. 3.2.4 Utwrzenie użytkwników przy użyciu Apache Directry Studi Na tym etapie utwrzysz pierwszeg użytkwnika, któremu w dalszej części nadasz uprawnienia administratra. W knie LDAP Brwser narzędzia Apache Directry Studi, wybierz prawym klawiszem myszy węzeł users, a następnie wybierz New i New Entry. Z kna dialgweg Entry Creatin Methd wybierz Create entry frm scratch. Wybierz Next. W knie dialgwym Object Classes z listy Available bject classes wybierz klasy biektów. Wybrane muszą zstać następujące cztery klasy biektów: inetorgpersn rganizatinalpersn persn tp Jeżeli zstały wybrane więcej niż cztery klasy należy usunąć je pprzez ich wybór z panelu Selected bject classes znajdująceg się p prawej strnie i wybranie przycisku Remve. Wybierz Next. W drugim plu tekstwym zatytułwanym RDN, wybierz z rzwijalnej listy cn, a w plu znajdującym się p znaku równści wpisz gptadmin, uzyskasz cn=gptadmin. Dknane ustawienia pzwlą na utwrzenie użytkwnika nazwie gptadmin. Wybierz Next.

W nw twartym knie zbaczysz atrybuty nw utwrzneg użytkwnika. Kliknij pdwójnie na klumnę Value bk atrybutu sn. Będzie t nazwisk utwrzneg użytkwnika. Na ptrzeby teg przykładu wpisz gptadmin. Następnie ddasz ddatkwe infrmacje użytkwniku. Użyjesz w tym celu funkcjnalnści New Attribute. Ddasz atrybutu takie jak: email, passwrd i userid. Email: Umieść kursr w pustym plu klumny Attribute Descriptin, pniżej atrybutu sn, a następnie kliknij prawym klawiszem myszy i wybierz z twarteg menu New Attribute. Wybierz mail z rzwijalnej listy w plu Attribute type, a następnie wybierz Next. Zaakceptuj dmyślne ustawienia ddatkwych pcji i wybierz Finish. Rys. 4. Wybór nweg atrybutu z kna New Attribute. Kliknij pdwójnie na nw utwrzny atrybut mail znajdujący się w klumnie Attribute Descriptin i wpisz adres email użytkwnika gptadmin. P wpisaniu adresu email kliknij w klumnę Value w celu zatwierdzenia wpisanych zmian. Passwrd: Umieść kursr w pustym plu klumny Attribute Descriptin, pniżej atrybutu mail, a następnie kliknij prawym klawiszem myszy i wybierz z twarteg menu New Attribute.

Wybierz userpasswrd z rzwijalnej listy w plu Attribute type, a następnie wybierz Next. W wynikwym knie Optins zaakceptuj dmyślne ustawienia i wybierz Finish. P wybraniu przycisku Finish pjawi się kn Passwrd Editr. Wpisz hasł swjeg użytkwnika i pzstaw resztę ustawień dmyślnie. Wybierz OK. Atrybut uid pwinien mieć taką samą wartść c nazwa użytkwnika i atrybut cn znajdujący się w tabeli. Używany jest n jak nazwa użytkwnika w prcesie lgwania d interfejsu Geprtal Server. Umieść kursr w pustym plu klumny Attribute Descriptin, pniżej atrybutu userpasswrd, a następnie kliknij prawym klawiszem myszy i wybierz z twarteg menu New Attribute. Wybierz uid z rzwijalnej listy w plu Attribute type, a następnie wybierz Next. W wynikwym knie Optins zaakceptuj dmyślne ustawienia i wybierz Finish. Kliknij pdwójnie atrybut uid znajdujący się w klumnie Attribute Descriptin i wpisz taką samą nazwę jak pdczas twrzenia użytkwnika (gptadmin). P wpisaniu adresu email kliknij w klumnę Value w celu zatwierdzenia wpisanych zmian. P ddaniu nwych atrybutów wybierz przycisk Finish w celu zamknięcia kna New Entry. Utwrzny nwy użytkwnik gptadmin pwinien być widczny jak nwy węzeł, pniżej węzła users struktury katalgu. Pwtórz pwyższe krki w celu utwrzenia użytkwników, którym zstaną przypisane inne rle w Geprtal Server. Prpnwane nazwy nwych użytkwników: gptpublisher gptuser Twój serwer katalgwy jest teraz gtwy d uzupełnienia ddatkwymi wpisami charakterystycznymi dla Geprtal Server. Wyknaj krki z punktu 3.2.5 w celu zakńczenia knfiguracji serwera katalgweg na ptrzeby Geprtal Server. 3.2.5 Utwrzenie ról użytkwników przy użyciu Apache Directry Studi Geprtal Server piera się na rlach użytkwników. Są ne twrzne w celu przyznania różnych przywilejów użytkwnikm i funkcjnalnści. Wyróżnić mżemy trzy predefiniwane rle geprtalu: Administratr Publisher Registered User

W autryzacji LDAP rle użytkwników geprtalu nadawane są pprzez twrzenie grup (węzeł grups). Grupa definiwana jest jak wpis, który zawiera klasę biektów grupofuniquenames, pzwalającą na ddawanie użytkwników. Struktura grup w serwerze katalgwym nie musi mieć żadneg knkretneg schematu. Jednakże rekmendwane jest utwrzenie struktury grup, która dpwiada bezpśredni predefiniwanym rlm w Geprtal Server. Jeśli pracujesz z nw zainstalwanym serwerem katalgwym jest t prste, a instrukcje znajdziesz pniżej. Jeśli natmiast pracujesz z już istniejącym serwerem katalgwym, mżesz stwrzyć nwe grupy, specyficzne dla Geprtal Server lub zdecydwać się na płączenie istniejących grup z nwymi rlami w geprtalu. Otwórz Apache Directry Studi jeżeli zstał wcześniej zamknięte i płącz się ze swim serwerem katalgwym. Kliknij prawym klawiszem myszy węzeł grups, a następnie New i New Entry Z kna Entry Creatin Methd wybierz Create entry frm scratch, a następnie kliknij Next. W knie dialgwym Object Classes wybierz klasy biektów z rzwijalnej listy Available bject classes. Następujące dwie klasy muszą zstać wybrane dla teg węzła: grupofuniquenames tp Jeżeli zstały ddane więcej niż dwie klasy, usuń je pprzez ich wybór z części Selected bject classes i wybranie przycisku Remve. Wybierz Next. W następnym knie, przejdź d drugieg pla tekstweg, zatytułwaneg RDN. Z rzwijalnej listy wybierz cn i wpisz nazwę grupy gpt_administratrs. Dknane ustawienia pzwlą na utwrzenie nwej grupy użytkwników nazwie gpt_administratrs. Jest t grupa, której w dalszym etapie zstaną przypisane uprawnienia administratra. Wybierz Next. W widcznym knie Attribute wpisz tymczaswą wartść dla atrybutu uniquemember, którą będzie cn=abc. Wybierz Finish aby utwrzyć nwą grupę. Nwa grupa gpt_administratrs pwinna pjawić się w strukturze katalgu jak nwa pzycja pniżej węzła grups. Utwórz dwie nwe grupy używając tych samych krków c pwyżej. Użyj wymieninych pniżej nazw grup użytkwników i pamiętaj wpisaniu wartści tymczaswej dla atrybutu uniquemember: Dla użytkwników publikujących utwórz grupę gpt_publishers Dla użytkwników zarejestrwanych utwórz grupę gpt_registeredusers Ddaj użytkwnika gptadmin d grupy gpt_administratrs. Przejdź d węzła users i kliknij prawym klawiszem na użytkwnika gptadmin. Wybierz z menu Cpy Entry/DN. Wróć d węzła grups i wybierz grupę gpt_administratrs.

W części gdzie znajdują się atrybuty, kliknij pdwójnie na klumnę Value atrybutu uniquemember i skpiuj unikalną nazwę (DN) użytkwnika gptadmin w celu ddania g d grupy. Rys. 5. Wypełnine wartści atrybutów dla grupy gpt_administratrs. Pwtórz pwyższe krki w celu skjarzenia użytkwników gptpublisher i gptuser z grupami gpt_publishers i gpt_registeredusers. 4. Instalacja Apache Tmcat. Apache Tmcat jest kntenerem aplikacji webwych. Jak kntener aplikacji jest serwerem, który umżliwia uruchamianie aplikacji internetwych w technlgiach Java Servlets i Java Server Pages (JSP). Ptrzebujesz g d uruchmienia aplikacji Geprtal Server. Uruchm instalatr i zaakceptuj wszystkie dmyślne ustawienia. Zweryfikuj czy jak numer prtu Tmcata ustawiny jest 8080. Nie wpisuj nazwy i hasła dla użytkwnika administratr. Knfiguracja usługi Apache Tmcat 7.0 Wybierz prawym klawiszem myszy Mój Kmputer, a następnie Zarządzaj. Rzwiń z prawej części kna Usługi i aplikacje i wybierz Usługi. Znajdź na liście usług, usługę Apache Tmcat 7.0 i upewnij się, że jest uruchmina (jeśli nie, kliknij na nią prawym klawiszem myszy i wybierz Start). Kliknij prawym klawiszem usługę i wybierz jej Właściwści. Zmień typ uruchmienia na Autmatyczny. Wybierz OK w celu zapisania zmian i zamknięcia kna właściwści usługi.

Zweryfikuj pprawnść zainstalwania serwera aplikacji internetwych. Otwórz przeglądarkę internetwą i wpisz http://lcalhst:8080. Pwinna wyświetlić się dmyślna strna Apache Tmcat. 5. Instalacja bazy danych PstgreSQL 9.1. Zadaniem bazy danych PstgreSQL będzie przechwywanie zbiru metadanych i wykazu infrmacji pchdzących z harvestingu. W tym celu utwrzny zstanie użytkwnik i schemat geprtalu, który zawierać będzie dedykwaną strukturę tabel. Uruchm instalatr Windws bazy danych PstgreSQL 9.1 i zaakceptuj wszystkie dmyślne ustawienia. Utwórz hasł dla użytkwnika pstgres (przykładwe hasł: pstgres) Zweryfikuj czy numer prtu t 5432. 5.1 Knfiguracja bazy danych PstgreSQL. W celu ułatwienia instalacji i działania aplikacji Geprtal Server sknfigurujesz na tym etapie dstęp d bazy PstgreSQL. Przejdź d flderu C:\Prgram Files\PstgreSQL\9.1\data Otwórz w ntatniku plik pg_hba.cnf i przejdź d wiersza znajdująceg się pniżej wpisu # IPv4 lcal cnnectins (wiersz 80). Zmień wpis md5 na trust. Na kńcu pliku ddaj dwa nwe wiersze, zastępując wpis <IP Address> adresem IP swjeg kmputera: # My cmputer s cnnectin: hst all all <IP Address>/32 trust Zapisz i zamknij plik. Dknane ustawienia pzwlą na płączenie się z bazą danych PstgreSQL tylk z pzimu twjeg lkalneg kmputera, natmiast nie umżliwią ne płączenia się zdalnych kmputerów z bazą. Zmiana wiersza 80 ułatwi płączenie się z bazą z pzimu lkalnej maszyny (lcalhst), a dwa nw ddane wpisy pzwlą twjej maszynie na płączenie się z bazą pprzez płączenie TCP/IP. Aby mżliwe był pprawne uruchmienie pleceń niezbędnych d knfiguracji bazy pd kątem Geprtal Server, knieczna będzie aktualizacja zmiennych śrdwiskwych kmputera. Kliknij prawym klawiszem myszy na Mój Kmputer i wybierz Właściwści. Przejdź d zakładki Zaawanswane i wybierz Zmienne śrdwiskwe.

W części Zmienne systemwe wybierz pzycję PATH, a następnie Edytuj. W twartym knie Edytwanie zmiennej systemwej przejdź na kniec tekstu w plu Wartść zmiennej. Nie usuwaj, a jedynie zaktualizuj istniejący wpis wartść ;C:\Prgram Files\PstgreSQL\9.1\bin, którą umieść na kńcu istniejąceg tekstu. Upewnij się, że nie ma pusteg miejsca pmiędzy znakiem średnika (;), który rzpczyna tę linię, a C:\. Wybierz trzy razy przycisk OK, aby zapisać wszystkie zmiany. Uruchm pnwnie kmputer, aby dknane zmiany zaczęły bwiązywać. 5.2 Utwrzenie użytkwnika i schematu geprtalu w bazie danych PstgreSQL. Knfigurwanie bazy danych PstgreSQL na cele Geprtal Server składa się z dwóch etapów ustawienie uprawnień bazy danych i stwrzenie schematu bazy danych. Każdy z tych etapów przeprwadza się pprzez uruchmienie skryptu, znajdująceg się w flderze instalacyjnym Esri Geprtal Server (Database Scripts PstgreSQL): skrypt grants pzwala na ustawienie uprawnień użytkwnika d twrzenia schematu geprtalu skrypt create schema pzwala na utwrzenie struktury tabel, prcedur i spsbów wypełniania tabel w schemacie geprtalu. Ustawienie uprawnień użytkwnika: Otwórz Wiersz plecenia. Przejdź d katalgu, w którym znajdują się skrypty bazy danych PstgreSQL. W tym celu wpisz z pzimu wiersza pleceń następującą frmułę: cd <ścieżka d flderu w którym znajdują się skrypty> (przykładw: cd C:\geprtal\Database Scripts\PstgreSQL). (Skrypty bazy danych PstgreSQL znajdują się w pbranej paczce z Esri Geprtal Server, w flderze Database Scripts). Wpisz dir, aby zbaczyć zawartść teg katalgu. Rys. 6. Plecenie pzwalające na przejście d katalgu i sprawdzenie jeg zawartści.

Wpisz grants_pg, żeby zbaczyć instrukcję uruchmienia teg skryptu. W klejnym etapie wpiszesz parametry zgdnie z wyświetlną instrukcją. Rys. 7. Plecenie grants_pg i instrukcja uruchmienia skryptu. Uruchm z pzimu wiersza pleceń plik grants_pg tak jak pisan pniżej: grants_pg [hst] [prt] [database] [geprtal schema] [usertcnnect] [geprtaluser] Gdzie: [hst] jest nazwą maszyny, na której jest zainstalwany PstgreSQL. Jeżeli baza znajduje się na lkalnej maszynie wpisz lcalhst. [prt] jest numerem prtu bazy danych PstgreSQL. Dmyślny prt t 5432. [database] jest nazwą bazy danych geprtalu. Dmyślną nazwą jest pstgres. [geprtal schema] jest nazwą schematu geprtalu. Dmyślna nazwa t geprtal. [usertcnnect] jest nazwą użytkwnika bazy danych wpisaną pdczas instalacji PstgreSQL. Dmyślna nazwa t pstgres. [geprtaluser] jest nazwą dla właściciela schematu geprtal. Dmyślną nazwą jest geprtal. Przykład: grants _ pg lcalhst 5432 pstgres geprtal pstgres geprtal

Kiedy trzymasz wiadmść Enter passwrd fr new rle:, wpisz hasł dla użytkwnika geprtalu. Kiedy trzymasz wiadmść Enter it again:, wpisz pnwnie hasł dla użytkwnika geprtalu. Gdy zakńczy się wyknywanie skryptu, zstanie wyświetlny plik tekstwy grants_pg.txt, który jest raprtem z wyknania skryptu. Sprawdź czy raprt nie zawiera błędów. Ważne: Jeżeli wyknanie skryptu nie przebiegł pmyślnie, usuń wszystkie błędy przed przystąpieniem d klejnych etapów. Utwrzenie schematu geprtalu: Z pzimu kna wiersza pleceń uruchm plik create_schema_pg, tak jak t pisan pniżej: create_schema_pg [hst] [prt] [geprtal database] [geprtal user] Gdzie: [hst] jest nazwą maszyny, na której znajduje się baza danych PstgreSQL [prt] jest prtem bazy danych PstgreSQL. Dmyślnie jest t 5432. [geprtal database] jest nazwą bazy danych. Dmyślnie jest t pstgres. [geprtal user] jest nazwą właściciela schemata geprtal. Dmyślnie jest t geprtal. Przykład: create_schema_pg machinename 5432 pstgres geprtal Kiedy trzymasz wiadmść Enter passwrd fr geprtal user:, wpisz hasł dla użytkwnika geprtalu. Gdy zakńczy się wyknywanie skryptu, zstanie wyświetlny plik tekstwy geprtal_schema.txt, który jest raprtem z wyknania skryptu. Sprawdź czy raprt nie zawiera błędów. Zweryfikuj pprawnść utwrznych tabel w PstgreSQL: Otwórz narzędzie administratra PstgreSQL. Wybierz Start Wszystkie prgramy PstgreSQL 9.1 pgadmin III. Kliknij pdwójnie na PstgreSQL 9.1 (lcalhst:5432). Wpisz hasł dla użytkwnika pstgres (pstgres).

W knie biektów przejdź d Bazy danych pstgres Schematy geprtal Tabele. Zweryfikuj czy sekcja Tabele zawiera dziewięć następujących tabel: gpt_cllectin gpt_cllectin_member gpt _ harvesting _ histry gpt _ harvesting _ jbs _ cmpleted gpt _ harvesting _ jbs _ pending gpt _ resurce gpt _ resurce _ data gpt _ search gpt _ user Rys. 8. Pdgląd utwrznych tabel w narzędziu administratra PstgresSQL. 6. Instalacja aplikacji Esri Geprtal Server Skpiuj flder geprtal.war znajdujący się w pbranej paczce z Esri Geprtal Server (przykładwa lkalizacja: C:\geprtal-1.2.4\Web Applicatins\Geprtal) d flderu webapps, znajdująceg się w katalgu Apache Tmcat (przykładwa lkalizacja: C:\Prgram Files\Apache Sftware Fundatin\Tmcat 7.0\webapps).

Apache Tmcat pwinien autmatycznie utwrzyć nwy flder geprtal. Jeżeli flder nie zstanie autmatycznie utwrzny, twórz kn Zarządzanie kmputerem (Mój kmputer Zarządzaj) i przejdź d części Usługi w celu zrestartwania usługi Apache Tmcat 7.0. Otwórz przeglądarkę internetwą i wpisz http://lcalhst:8080/geprtal. Pwinna wyświetlić się dmyślna strna aplikacji Esri Geprtal Server. Rys. 9. Dmyślna strna aplikacji Esri Geprtal Server. Ważne: Jeżeli chcesz, aby twój geprtal bsługiwał wyszukiwanie z użyciem wielbajtwych znaków, musisz sknfigurwać plik server.xml tak, aby bsługiwał spsób kdwania znaków UTF-8. Otwórz plik server.xml znajdujący się w katalgu cnf aplikacji Apache Tmcat (przykładwa lkalizacja: C:\Prgram Files\Apache Sftware Fundatin\Tmcat 7.0\cnf). Ddaj d elementu Cnnectr atrybut URIEncding="UTF 8" tak jak przedstawin t pniżej: <Cnnectr prt="8080" prtcl="http/1.1" cnnectintimeut="20000" redirectprt="8443" URIEncding="UTF-8"/> 7. Knfiguracja aplikacji Esri Geprtal Server Przejdź d: <Katalg, w którym zainstalwany jest Apache Tmcat>\webapps\geprtal\WEBINF\classes\gpt\cnfig Otwórz plik gpt.xml w edytrze tekstu. Zaktualizujesz plik gpt.xml na pzimie niezbędnym d uruchmienia aplikacji Esri Geprtal Server. Zaktualizuj w pliku wpisy, które zstały wymienine pniżej: Ustawienia lucene, zawierające infrmacje indeksach Lucene. Lucene jest lkalnym silnikiem indekswania, używanym przez Geprtal Server d indekswania publikwanych dkumentów, w celu ich szybkieg zwracania przy

wyszukiwaniu (aby uzyskać więcej infrmacji zbacz http://surcefrge.net/apps/mediawiki/geprtal/index.php?title=using_lucene_search _Text_Queries.) Ważne: Musisz utwrzyć flder, który będzie przechwywał zaindekswane dkumenty. P utwrzeniu flderu i nadaniu mu nazwy, ustaw pniższy parametr. Nazwa parametru Funkcja Wartść indexlcatin Ścieżka d flderu, w którym będą grmadzne indekswane dkumenty. Mże t być dwlna ścieżka na twjej maszynie. Przykład: C:\lucene Ciąg znaków reprezentujący ścieżkę dstępu d flderu. Tabela 3 Ustawienia parametrów lucene w pliku gpt.xml. Ustawienia autryzacji Prsta autryzacja Ustawienia simpleadapter kreślają szczegółwe infrmacje dla pjedynczeg knta użytkwnika (pjedyncze knt administratra). Jeżeli zdecydwałeś się na użycie prstej autryzacji, uaktywnij sekcję simpleadapter pprzez usunięcie znaków <! i >, a następnie zaktualizuj parametry wymienine w pniższej tabeli. P wypełnieniu parametrów dezaktywuj sekcję ldapadapter. Nazwa parametru Funkcja Wartść username Nazwa użytkwnika dla pjedynczeg knta. Dwlny ciąg znaków. passwrd Hasł dla pjedynczeg knta. Dwlny ciąg znaków. encrypted Określa czy wartść hasła ustawina w parametrze passwrd jest szyfrwana, czy też nie. Aby uzyskać więcej infrmacji przejdź d: http://surcefrge.net/apps/mediawiki/geprtal/index. php?title=security_cncepts#encryptin_cncepts True lub false. Tabela 4 Ustawienia parametrów simpleadapter w pliku gpt.xml. Ustawienia autryzacji Autryzacja LDAP Ustawienia ldapcnnectinprperties kreślają płączenie d serwera katalgweg. Jeżeli zdecydwałeś się na użycie autryzacji LDAP, ustaw parametry zgdnie z pniższą tabelą. Nazwa parametru Funkcja Wartść prviderurl Adres d serwera, na którym znajduje się serwer katalgwy wraz z prtem używany d płączenia LDAP. Dwlny, prawidłwy adres URL LDAP. Przykład: ldap://machine:prt. Numer prtu dla Apache Directry Server t securityprincipal Nazwa użytkwnika (administratra LDAP), który ma uprawnienia d płączenia się z serwerem katalgwym. 10389 lub 19389 Wpisz wyróżniającą nazwę (DN) w LDAP. Jest t ta sama wartść, która zstała użyta d

securitycredentials Encrypted Hasł, pzwalające na płączenie się z serwerem katalgwym. Określa czy hasł ustawine w parametrze securitycredentials jest szyfrwana czy też nie. Aby uzyskać więcej infrmacji przejdź d: http://surcefrge.net/apps/mediawiki/geprtal/index. php?title=security_cncepts#encryptin_cncepts płączenia się z serwerem katalgwym w punkcie 3.2.3. Przykład: uid=admin,u=system Ciąg znaków, reprezentujący hasł. Jest t ta sama wartść, która zstała użyta d płączenia się z serwerem katalgwym. Dmyślnym hasłem jest secret. True lub false Tabela 5 Ustawienia parametrów ldapcnnectinprperties w pliku gpt.xml. Rys. 10. Ustawienia sekcji ldapadapter w pliku gpt.xml. Ustawienia ról (rles) pzwalają ustawić mapwanie (płączenie) pmiędzy grupami w serwerze katalgwym, a dmyślnymi rlami użytkwników w Geprtal Server. Ustaw następujące parametry:

Nazwa parametru Funkcja Wartść authenticateduser RequiresRle grupdn Inherits grupdn Inherits grupdn Wskazuje, czy każdy użytkwnik w Geprtal Server jest przypisany przynajmniej d jednej rli. True lub False. Dmyślnie: true Dla znacznika <rle key= gptregistereduser > Nazwa grupy w serwerze katalgwym, która dpwiada rli zarejestrwaneg użytkwnika w Geprtal Server. Nazwa wyróżniająca w LDAP. Przykład: cn=gpt_registeredusers,u=grups,u=system Dla znacznika <rle key= gptpublisher > Dmyślnie: gptregistereduser Nazwa rli, której właściwści będą dziedziczne przez rlę publisher. Nazwa grupy w serwerze katalgwym, która dpwiada rli użytkwnika publikująceg w Geprtal Server. Nazwa wyróżniająca w LDAP. Przykład: cn=gpt_publishers,u=grups,u=system Dla znacznika <rle key= gptadministratr > Nazwa rli, której Dmyślnie: gptpublisher właściwści będą dziedziczne przez rlę administratr. Nazwa grupy w serwerze katalgwym, która dpwiada rli użytkwnika administratr w Geprtal Server. Nazwa wyróżniająca w LDAP. Przykład: cn=gpt_administratrs,u=grups,u=system Tabela 6 Ustawienia parametrów ról użytkwników w pliku gpt.xml.

Rys. 11. Ustawienia sekcji rles w pliku gpt.xml. Ustawienia użytkwników (users) kreślają właściwści knta użytkwnika. Ustaw parametry wymienine w tabeli pniżej: Nazwa parametru Funkcja Wartść displaynameat tribute passwrdencry ptinalgrithm newuserdnpat tern usernamesearc hpattern searchdit Atrybut użytkwnika, który używany jest d wyświetlenia nazwy użytkwnika w interfejsie Geprtal Server. Algrytm używany d szyfrwania hasła wysyłaneg z Geprtal Server d serwera katalgweg. Wzór wyróżniającej nazwy (DN) dla nweg użytkwnika. Wzór wyszukiwania dla serwera katalgweg, d użycia w prcesie przeszukiwania użytkwników. Ścieżka w drzewie infrmacyjnym katalgu d wyszukiwania użytkwników. Ciąg znaków reprezentujących nazwę atrybutu. Dmyślnie: uid. Akceptwana wartść t: MD5 lub SHA. Dmyślnie: SHA Ciąg znaków reprezentujących wzór DN. Przykład: cn={0},u=users,u=system Pzstaw dmyślnie ustawiną wartść. Nazwa wyróżniająca w LDAP (DN) reprezentująca wpis jednstki rganizacyjnej Users. Przykład: u=users,u=system Tabela 7 Ustawienia parametrów użytkwników w pliku gpt.xml. Ustawienia grup (grups) kreślają właściwści grup serwera katalgweg. Ustaw pniższe parametry, aby płączyć grupy z rlami użytkwników w Geprtal Server.

Nazwa parametru Funkcja Wartść displaynameattrib Atrybut używany d wyświetlenia Dmyślnie: cn. ute nazwy grupy. Aktualnie nie dynamicmembero fgrupsattribute dynamicmembers Attribute memberattribute membersearchpat tern searchdit używany w Geprtal Server. Atrybut, który mże zstać użyty d kreślenia wszystkich grup, d których należy użytkwnik. Atrybut, który mże zstać użyty d kreślenia wszystkich człnków grupy. Atrybut, który mże zstać użyty d kreślenia, którzy użytkwnicy należą d grupy. Wzór wyszukiwania dla serwera katalgweg, d użycia w prcesie przeszukiwania grup. Ścieżka w drzewie infrmacyjnym katalgu d wyszukiwania grup. Dmyślnie: Dmyślnie: Default: uniquemember Pzstaw dmyślnie ustawiną wartść. Nazwa wyróżniająca w LDAP (DN) reprezentująca jednstkę rganizacyjną Grups. Przykład: u=grups,u=system Tabela 8 Ustawienia parametrów grup użytkwników w pliku gpt.xml. Rys. 12. Ustawienia sekcji users i grups w pliku gpt.xml.

Zakńczyłeś pdstawwą knfigurację aplikacji Geprtal Server. Zapisz i zamknij plik gpt.xml. 8. Knfiguracja JDBC Geprtal Server wykrzystuje JNDI (Java Naming and Directry Interface) d płączenia się z bazą danych pprzez płączenie JDBC. Pzwala t kmpnentm systemu na znalezienie infrmacji płączeniu z bazą, używając JNDI zamiast grmadzić infrmacje płączenia JDBC w różnych miejscach. Na tym etapie sknfigurujesz JNDI i płączenie JDBC d Apache Tmcat. Zidentyfikuj plik jdbc.jar, który zstanie wykrzystany d płączenia z bazą. Plik.jar jest zależny d użytej bazy danych i jej wersji, a także d użytej wersji Javy. Skpiuj wcześniej pbrany plik pstgresql-9.1-903.jdbc4.jar d katalgu lib w flderze instalacyjnym Apache Tmcat (przykładwa lkalizacja: C:\Prgram Files\Apache Sftware Fundatin\Tmcat 7.0\lib). Skpiuj plik geprtal.xml, znajdujący się w pbranej paczce z Esri Geprtal Server (flder Other\JNDI Cnfiguratin) i wklej d flderu na C:\<Katalg instalacyjny Tmcat>\cnf\Catalina\lcalhst. Otwórz plik geprtal.xml w edytrze tekstwym i zmdyfikuj parametry kreślne w pniższej tabeli, a następnie zapisz zmiany i zamknij. Nazwa parametru Funkcja Wartść dcbase Nazwa aplikacji Geprtal dcbase= geprtal Server w Apache Tmcat. Path Nazwa katalgu aplikacji path= /geprtal Geprtal Server w flderze webapps Tmcata. driverclassname Nazwa klasy JDBC PstgreSQL: rg.pstgresql.driver url Adres URL płączenia JDBC. PstgreSQL: jdbc:pstgresql://servername:5432/pstgres username Użytkwnik bazy danych username= geprtal geprtal. passwrd Hasł użytkwnika bazy danych geprtal. passwrd="geprtal" Tabela 9 Ustawienia parametrów w pliku geprtal.xml. Rys. 10. Ustawienia w pliku geprtal.xml.

Zakńczyłeś właśnie pdstawwą instalację i knfigurację aplikacji Esri Geprtal Server. Infrmacje na temat użycia aplikacji d publikwania metadanych, zarządzania nimi i ich wyszukiwania znajdziesz pd adresem: http://surcefrge.net/apps/mediawiki/geprtal/index.php?title=using_a_geprtal Jeżeli pmim wyknania wszystkich etapów instalacji, twja aplikacja nie uruchamia się pprawnie i są generwane błędy, infrmacje pmcne przy ich usuwaniu mżesz znaleźć pd adresem: http://surcefrge.net/apps/mediawiki/geprtal/index.php?title=trubleshting