Tworzenie geoportali w oprogramowaniu Open Source.
Część I – instrukcja instalacji
Michał Mućko
michal.m.mucko@gmail.com
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).
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/.