Tworzenie geoportali w oprogramowaniu Open Source. Część I instrukcja instalacji Abstrakt Pierwsza część kursu przeprowadza przez instalację w systemie Windows wszystkich elementów potrzebnych do publikacji danych przestrzennych w internecie w postaci geopoetalu (m. in. Apache, PHP, PostgreSQL, GeoServer). Michał Mućko michal.m.mucko@gmail.com
Instalacja Apache 2.2 (W przypadku posiadania zainstalowanego Apache co najmniej w wersji 2.2.21 można przejść do kolejnego kroku) 1. Wchodzimy na stronę: https://archive.apache.org/dist/httpd/binaries/win32/. 2. Szukamy wpisu httpd-2.2.25-win32-x86-openssl-0.9.8y.msi. Kliknięcie na link powoduje rozpoczęcie pobierania. 3. Klikamy dwukrotnie na pobrany plik httpd-2.2.25-win32-x86-openssl-0.9.8y.msi. (Plik musi być uruchomiony jako administrator, więc jeżeli konto, na którym jest się zalogowanym nie jest administracyjne, należy kliknąć prawym przyciskiem na plik i wybrać Uruchom jako administrator). 4. Pierwsze okno: Next. 5. Drugie okno: I accept the terms in the license agreement i Next. 6. Trzecie okno: Next. 7. Czwarte okno: a. Network domain: cokolwiek.com, b. Server name: www.cokolwiek.com, c. Administrator s e-mail address: admin@cokolwiek.com, d. For all users on Port 80, as a service e. Next 8. Piąte okno: Typical 9. Szóste okno, katalog instalacji: C:\Webserver\Apache\. (Lub inny, według uznania) 10. Siódme okno: Install. 11. Jeżeli instalator prosi o potwierdzenie uruchomienia pliku pobranego z internetu lub potwierdzenie uprawnień administratora systemu, należy je wybrać Tak. 12. Poprawność instalacji potwierdzamy przez wejście przy pomocy przeglądarki na adres http://localhost/. Na stronie powinien pojawić się napis It works. 13. Tworzymy kopię zapasową pliku C:\Webserver\Apache\conf\httpd.conf. 14. Otwieramy plik C:\Webserver\Apache\conf\httpd.conf. a. Linię DocumentRoot C:/Webserver/Apache/htdocs zamieniamy na DocumentRoot C:/Webserver/Strony b. Linię <Directory C:/Webserver/Apache/htdocs > zamieniamy na <Directory C:/Webserver/Strony > 15. Tworzymy katalog: C:\Webserver\Strony\ i przenosimy tam zawartość folderu C:\Webserver\Apache\htdocs\ 16. Restartujemy serwer Apache przez kliknięcie lewym przyciskiem na ikonce Apache w tray u (przy zegarze), wybranie Apache2.2 I Restart
17. Ikonka Apache po restarcie powinna wrócić do zielonego koloru. Jeżeli jest czerwona coś poszło nie tak i należy przywrócić wszystkie ustawienia, aby serwer zaczął znowu działać. 18. Wchodzimy na adres http://localhost/. Na stronie, tak jak przy wcześniejszym sprawdzeniu powinien się pojawić napis It works.
Instalacja PostgreSQL i PostGIS (W przypadku posiadania zainstalowanego PostgreSQL co najmniej w wersji 9.1 i PostGIS w wersji co najmniej 2.0 można przejść do kolejnego kroku) 1. Wchodzimy na stronę http://www.enterprisedb.com/products-services-training/pgdownload i szukamy sekcji z najnowszą wersją (obecnie 9.4.1). 2. Odnajdujemy link Win x86-32, który przekieruje do strony pobierania instalatora PostgreSQL i jego rozszerzeń. 3. Pierwsze okno: Next. 4. Drugie okno: a. Instalation directory: C:\Webserver\PostgreSQL\9.4 5. Trzecie okno: a. Data directory: C\Webserver\PostgreSQL\9.4\data 6. Czwarte okno, hasło do serwera baz danych: postgres (lub inne, wg uznania) 7. Piąte okno, port serwera: 5432 8. Szósta okno, lokalizacja: [Default locale] 9. Siódme okno: Next 10. Po instalacji zaznaczamy opcję Stack Builder i klikamy Finish. 11. W oknie Stack Builder wybieramy PostgreSQL 9.4 (x86) on porrt 5432 i klikamy Next. 12. W oknie rozszerzeń zaznaczamy Spatial Extensions -> PostGIS 2.1 Bundle for PostgreSQL. 13. W następnym oknie wybieramy dowolny katalog do ściągnięcia instalatora i klikamy Next. 14. Po ściągnięciu plików odznaczamy checkbox Skip instalation i klikamy Next, przechodzimy do okna instalacji PostGIS. 15. Pierwsze okno: I agree. 16. Drugie okno: zaznaczamy PostGIS i Create spatial database. 17. Trzecie okno: automatycznie powinien wybrać się katalog, w którym był zainstalowany PostgreSQL, jeżeli tak nie jest, należy go wybrać ręcznie (C:\Webserver\PostgreSQL\9.4), klikamy Next. 18. Czwarte okno: wybieramy parametry połączenia do PostgreSQL (User Name: postgres, Password: postgres (lub inne, wcześniej wybrane), Port: 5432) 19. Piąte okno: Database name: postgis_21_sample i klikamy Install. 20. Na wszystkie pytania pojawiające się w trakcie instalacji odpowiadamy Tak. 21. Po instalacji klikamy w dwóch widocznych oknach kolejno Close i Finish. 22. Włączamy program pgadmin III. 23. Klikamy dwukrotnie na serwer PostgreSQL 9.4 i wpisujemy hasło postgres (lub inne, wcześniej wybrane). 24. Użytkownik powinien połączyć się z serwerem bazy danych, na serwerze powinny istnieć dwie bazy danych: postgres i postgis_21_sample.
25. Należy jeszcze dodać katalog z plikami PostgreSQL do ścieżki systemowej: Wybieramy Mój Komputer, klikamy prawym przyciskiem myszy i wybieramy Właściwości. W oknie właściwości systemu wybieramy po lewej stronie Zaawansowane ustawienia systemu. 26. W nowym oknie klikamy Zmienne środowiskowe. 27. W kolejnym oknie w sekcji Zmienne systemowe wybieramy wiersz ze zmienną o nazwie Path i klikamy przycisk Edytuj. 28. Na końcu tekstu wartości zmiennej dodajemy wpis: C:\Webserver\PostgreSQL\9.4\bin; 29. Poszczególne zmienne powinny być oddzielone średnikami.
Instalacja PHP (W przypadku posiadania zainstalowanego PHP co najmniej w wersji 5.4.0 można przejść do kolejnego kroku) 1. Wchodzimy na stronę http://php.net/downloads.php i szukamy sekcji Old Stable PHP 5.4.x, gdzie x to numer wersji. Obecnie aktualna dla serwera Apache 2.2 jest wersja 5.4.37. Poniżej szukamy linku Windows downloads. 2. Link przenosi nas na stronę z paczkami do ściągnięcia. Szukamy sekcji PHP 5.4 VC9 x86 Thread Safe i znajdującego się poniżej linku Zip, którego kliknięcie powoduje rozpoczęcie pobierania. 3. Rozpakowujemy paczkę do katalogu C:\Webserver\PHP\. 4. W folderze C:\Webserver\PHP znajdujemy plik php.ini-development, kopiujemy go i zmieniamy nazwę i rozszerzenie na php.ini. 5. Otwieramy plik C:\Webserver\PHP\php.ini i usuwamy średniki z począrku poniższych linii (odkomentowujemy): a. Linię ;extension=php_curl.dll zamieniamy na extension=php_curl.dll, b. Linię ;extension=php_pgsql.dll zamieniamy na extension=php_pgsql.dll c. Linię ;date_timezone = zamieniamy na date_timezone = Europe/Warsaw. d. Linię ;extension_dir = "ext" zamieniamy na extension_dir = "ext". 6. Tworzymy kopię zapasową pliku C:\Webserver\Apache\conf\httpd.conf. 7. Otwieramy plik C:\Webserver\Apache\conf\httpd.conf. a. Po sekcji linii rozpoczynających się od #LoadModule dodajemy wpisy: LoadModule php5_module "C:/Webserver/PHP/php5apache2_2.dll" AddHandler application/x-httpd-php.php PHPIniDir "C:/Webserver/PHP" <FilesMatch \.php$> SetHandler application/x-httpd-php </FilesMatch> b. Linię DirectoryIndex index.html zamieniamy na DirectoryIndex index.html index.php 8. Dodajemy do ścieżki systemowej Path (tak jak przy instalacji PostgreSQL) wpis: C:\Webserver\PHP; 9. Restartujemy serwer Apache przy użyciu ikonki w menu systemowym (jak we wcześniejszym przypadku). 10. Tworzymy w katalogu C:\Webserver\Strony\ plik phpinfo.php z zawartością: <?php phpinfo();?> 10. Wchodzimy na stronę http://localhost/phpinfo.php.
11. Na stronie oprócz innych domyślnych sekcji, powinny znajdować się sekcje pgsql oraz curl.
Instalacja GeoServer (W przypadku posiadania zainstalowanego GeoServera co najmniej w wersji 2.4.0 można przejść do kolejnego kroku) 1. Wchodzimy na stronę http://geoserver.org/download/ i szukamy linku do wersji Stable (obecnie 2.6.2). 2. Link przenosi nas do strony z paczkami dla poszczególnych systemów. Szukamy linku Windows Installer i klikamy na nim. Przechodzimy do pobierania. 3. Klikamy dwukrotnie na instalator geoserver-x.x.x.exe. 4. Pierwsze okno: Next. 5. Drugie okno: I agree. 6. Trzecie okno, katalog instalacji ustawiamy na C:\Webserver\GeoServer\. 7. Czwarte okno, wybór katalogu w menu start, klikamy Next. 8. Piąte okno, wskazanie na instalację środowiska uruchomieniowego Java (JRE). Jeżeli nie jest zainstalowane, wyświetli się puste pole i zostaniemy poproszeni o jego wskazanie lub instalację. Można je ściągnąć na stronie http://www.oracle.com/technetwork/java/javase/downloads/jre8- downloads-2133155.html (Tam akceptujemy warunki licencji i wybieramy wersję Windows x86 Offline). Jeżeli jest już zainstalowany, w oknie instalacji GeoServera będzie zaznaczony i pojawi się informacja This path contains valid JRE. 9. Szóste okno: Wybieramy Default data directory. 10. Siódme okno, wybór nazwy użytkownika i hasła: zostawiamy domyślne admin:geoserver, lub zmieniamy wedle uznania. 11. Ósme okno, wybór portu serwera: domyślnie 8080. Nie może być 80, bo na takim jest zainstalowany Apache. 12. Dziewiąte okno, sposób uruchamiania: wybieramy Install as a service. 13. Dziesiąte okno, podsumowanie, klikamy Install. 14. Po instalacji wchodzimy na stronę http://localhost:8080/geoserver/ (lub inną, w zależności od wybranego portu) i logujemy się za pomocą swoich danych.
Instalacja QGIS (W przypadku posiadania zainstalowanego QGIS co najmniej w wersji 2.4.0 można przejść do kolejnego kroku) 1. Wchodzimy na stronę http://www2.qgis.org/pl/site/forusers/download.html i odszukujemy linku Szamodzielny instalator, wersja X.X (32 bit). (aktualna wersja to 2.6). 2. Przechodzimy do strony pobierania. 3. Klikamy dwukrotnie na plik instalacyjny. 4. Pierwsze okno: Next. 5. Drugie okno: I agree. 6. Trzecie okno, katalog instalacji: dowolny. 7. Czwarte okno, opcjonalne dane: odznaczone. 8. Uruchamiamy QGIS Desktop.
Pobranie bibliotek JavaScript Openlayers 1. Wchodzimy na stronę http://trac.osgeo.org/openlayers/wiki/howtodownload i znajdujemy sekcję Latest stable release. 2. Klikamy na odnośnik [.zip], który pozwala pobrać bibliotekę wraz z dodatkowymi elementami (arkusze stylów, przykłady użycia, itp.) Proj4JS 1. Wchodzimy na stronę http://proj4js.org i szukamy sekcji Proj4js 1.1.0. Poniżej znajduje się link do ściągnięcia paczki. JSTS Topology Suite 1. Wchodzimy na stronę https://github.com/bjornharrtell/jsts i odszukujemy po prawej stronie ekranu linku Download ZIP.
2. Link pozwoli pobrać pełne repozytorium na dysk. jquery i jqueryui 1. Wchodzimy na stronę http://jqueryui.com/download/ i odszukujemy na dole strony przycisku Download. 2. Generator pozwala dostosować zawartość ściąganej paczki do potrzeb (wybrać poszczególne elementy, skórkę, itp.) pozostawiamy ustawienia domyślne. Instalacja 1. Wszystkie ściągnięte paczki rozpakowujemy do folderu C:/Webserver/Strony/js/ (w przypadku instalacji katalogu stron internetowych serwera w innym miejscu do tego właśnie katalogu). 2. Instalacja odbywa się przez umieszczenie w sekcji <head> strony internetowej odpowiednich wpisów linkujących do bibliotek oraz arkuszy stylów. 3. W przypadku, gdy plik strony internetowej znajduje się w katalogu C:/Webserver/Strony/, a biblioteki zostały rozpakowane do C:/Webserver/Strony/js/, poprawny sposób użycia bibliotek wygląda następująco:
<head> <link rel="stylesheet" type="text/css" href="js/jquery-ui-1.11.2.custom/jquery-ui.min.css"/> <link rel="stylesheet" type="text/css" href="js/openlayers-2.13.1/theme/default/style.css"/> <script type="text/javascript" src="js/jquery-ui-1.11.2.custom/external/jquery.js"></script> <script type="text/javascript" src="js/jquery-ui-1.11.2.custom/jquery-ui.min.js"></script> <script type="text/javascript" src="js/openlayers-2.13.1/openlayers.js"></script> <script type="text/javascript" src="js/jsts-master/src/jsts.js"></script> <script type="text/javascript" src="js/proj4js/lib/proj4js-compressed.js"></script> </head> 3. Do edycji plików tekstowych (.html,.php I innych) może być przydatny dobry edytor, np. Notepad++, który można znaleźć na stronie http://notepad-plus-plus.org/.