diff --git a/.github/workflows/generate-html-for-pull-request.yaml b/.github/workflows/generate-html-for-pull-request.yaml index 5cfd2f68..c1061ab9 100644 --- a/.github/workflows/generate-html-for-pull-request.yaml +++ b/.github/workflows/generate-html-for-pull-request.yaml @@ -19,7 +19,7 @@ jobs: - name: Find directories with changed rmd or image files id: changed-files-dir-names - uses: tj-actions/changed-files@v41 + uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96 # v47.0.6 with: files: | src/G*/*.{rmd,Rmd} diff --git a/.github/workflows/render-deploy.yaml b/.github/workflows/render-deploy.yaml index fb5990a2..ef8c166b 100644 --- a/.github/workflows/render-deploy.yaml +++ b/.github/workflows/render-deploy.yaml @@ -19,7 +19,7 @@ jobs: - name: Find directories with changed rmd or image files id: changed-files-dir-names - uses: tj-actions/changed-files@v44 + uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96 # v47.0.6 with: files: | src/G*/*.{rmd,Rmd,html,css} diff --git a/.github/workflows/render-release-pdf.yaml b/.github/workflows/render-release-pdf.yaml index 044829cc..06bc988d 100644 --- a/.github/workflows/render-release-pdf.yaml +++ b/.github/workflows/render-release-pdf.yaml @@ -24,7 +24,7 @@ jobs: - name: Find directories with changed rmd or image files id: changed-files-dir-names - uses: tj-actions/changed-files@v45 + uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96 # v47.0.6 with: matrix: "true" # to use output as matrix files: | diff --git a/src/GS006/01_harjoitus_1.Rmd b/src/GS006/01_harjoitus_1.Rmd index 2e429399..95eccd34 100644 --- a/src/GS006/01_harjoitus_1.Rmd +++ b/src/GS006/01_harjoitus_1.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 1.1: Asennus ja käyttöönotto +# HARJOITUS 1.1: ASENNUS JA KÄYTTÖÖNOTTO **Harjoituksen sisältö** @@ -14,31 +14,35 @@ Harjoituksen jälkeen opiskelija osaa kirjautua ylläpitäjänä GeoServeriin ja ## **Valmistautuminen** -Käynnistä koneessa web-selain ja kirjaudu osoitteeseen: +Käynnistä koneessa web-selain. + +Jos käytössä on etäpalvelin, kysy oma ip-osoitteesi ja portti kurssin vetäjältä. + +Mikäli harjoittelet paikallisella GeoServer-asennuksella niin osoite on todennäköisesti ::: note-box - +http://localhost:8080/geoserver ::: -Jos käytössä on etäpalvelin, kysy oma ip-osoitteesi ja portti opettajalta. Muokkaa sitten verkko-osoitteen **localhost:8080**-osaa ohjeiden mukaan. - -Edessäsi on GeoServerin käyttöliittymä. Ennen kun kirjaudut sisään, näet muutamia yleisiä tietoja palvelimesta. +Edessäsi on GeoServerin käyttöliittymä. Ennen kuin kirjaudut sisään, näet muutamia yleisiä tietoja palvelimesta. ![](img/harjoitus_1/image1.png) +**Ylhäällä oikealla (1)** on kirjautumistiedot. -**Keskellä (1)** on yleistä tietoa palvelimesta ja sen omistajasta/ylläpitäjästä (näitä päivitetään pian). Keskellä näkyy asennetun GeoServerin versionumero, joka on kuvassa 2.9.0. Tämä on GeoServer-palvelimen aloitussivu ja siihen pääset aina painamalla **GeoServer-logoa** vasemmalta ylhäältä +**Ylhäällä keskellä (2)** on tietoja palvelimen workspaceista ja tasoista. -Lähtökohtaisesti keskellä näkyy vasemmalla puolella sijaitsevan sivupalkin (jäljempänä "päävalikko" (2)) valintojen tarkempia tietoja. +**Ylhäällä vasemmalla (3)** on GeoServer-logo ja kun sitä painaa niin pääsee tähän etusivulle. -**Päävalikon (2)** avulla hallitaan ja tarkastellaan palvelimen toimintoja. +**Vasemmalla (4)** on päävalikko jonka kautta hallitaan ja tarkastellaan palvelimen toimintoja. -**Yläpalkissa (3)** on kirjautumistiedot ja GeoServer-logo, jonka kautta pääset aina aloitussivulle. +**Keskellä (5)** on palvelimen tukemat karttapalvelut ja niiden versiot. + +**Alhaalla keskellä (6)** näkyy asennetun GeoServerin versionumero, joka on kuvassa 2.22.4. -Oikealla puolella sijaitseva **sivupalkki (4)** näyttää aloitusnäkymässä palvelimen tukemat karttapalvelut ja niiden versiot. ## **Päävalikko** -Päävalikossa on näkyvissä aloitussivulla vain muutamia toimintoja. Nämä ovat nähtävissä kaikille, jotka tietävät palvelimen osoiteen (URL). +Päävalikossa on näkyvissä aloitussivulla vain muutamia toimintoja. Nämä ovat nähtävissä kaikille, jotka tietävät palvelimen osoitteen (URL). - **About & Status** -osio tarjoaa vain **About GeoServer** -valinnan, joka kertoo tarkemmin GeoServerin asennuksen tietoja ja antaa linkkejä GeoServerin dokumentaatioon. GeoTools- ja GeoWebCache-ohjelmistojen versiotiedot voit tarkistaa myös tältä sivulta. @@ -48,23 +52,19 @@ Päävalikossa on näkyvissä aloitussivulla vain muutamia toimintoja. Nämä ov Tutustu niihin lyhyesti nyt, ja kysy kouluttajalta mitä eri elementit tarkoittavat. -### **About GeoServer** - -Avaa **About GeoServer** ja tutki, mikä GeoServer-versio sinulla on käytössä ja mitkä muiden asennettujen ohjelmistojen versiot ovat. Tämäntyyppiset tiedot ovat tärkeitä palvelimen ongelmia selvitettäessä, tapahtuipa ongelmatilanteiden ratkaiseminen omatoimisesti taikka tukipalvelun avulla. - ### **Layer Preview** Kokeile **Layer Preview -toimintoa** ja esikatsele GeoServerin oletusaineistoja. Tätä näkymää tulemme käyttämään usein kurssin aikana. Käytä nyt muutama minuutti oppiaksesi sen perustoiminnallisuudet. -### **Service Capabilities (palvelutoiminnallisuudet)** +### **Palvelutoiminnallisuudet** -Palaa palvelimen pääsivulle painamalla **GeoServer-logoa**. Oikealla puolella löydät **Service Capabilities -palkin**. +Palaa palvelimen pääsivulle painamalla **GeoServer-logoa**. Ennen kun kirjaudutaan palvelimelle voit nähdä, mitä rajapintapalveluita käytössä olevalla GeoServerin asennuksella on mahdollista julkaista. -Harjoituksen GeoServerille on asennettu oletuksena WCS, WFS, WMS, TMS, WMS-C ja WMTS. Muita rajapintapalveluita, kuten esimerkiksi WPS-palvelu, voidaan julkaista GeoServeriin laajennosten avulla. Painamalla rajapintapalvelujen versionumeroita, voit tutustua niiden toiminnallisuuksiin (capabilities). +Harjoituksen GeoServerille on asennettu oletuksena WCS, WFS, WMS, TMS, WMS-C ja WMTS. Muita rajapintapalveluita, kuten esimerkiksi WPS-palvelu, voidaan julkaista GeoServeriin laajennusten avulla. Painamalla rajapintapalvelujen versionumeroita, voit tutustua niiden toiminnallisuuksiin (capabilities). -Tämä sivupalkki on nähtävissä vain aloitussivulla. Muista, että aloitussivuun pääset aina painamalla GeoServer-logoa. +Tämä osio on nähtävissä vain aloitussivulla. Muista, että aloitussivuun pääset aina painamalla GeoServer-logoa. ### **Demos** @@ -74,25 +74,33 @@ Tämän valikon alta löytyy muutamia GeoServerin testityökaluja:\ ### **Demo requests** -Kokeile erilaisten kyselyjen (toiminnallisuuksien) tuloksia ja näe, mitä kukin kyselykomento tuottaa. Kokeile **WMS_getMap_OpenLayers.url**-kyselyn toimivuutta valitsemalla kyseinen kysely valikosta ja paina **Submit**-toimintoa. +Kokeile erilaisten kyselyjen (toiminnallisuuksien) tuloksia ja näe, mitä kukin kyselykomento tuottaa. Kokeile **WMS_getMap_OpenLayers.url**-kyselyn toimivuutta valitsemalla kyseinen kysely valikosta ja paina **Show Result** -toimintoa. -GeoServerin eri toiminnot ja operaatiot muodostuvat URL:n liittyvistä parametreistä. Parametrit ohjaavat Geoserverin rajapintapalveluita: mitä karttatasoa kysytään, miltä alueelta tietoja haetaan tai kuva muodostetaan, vastauksen koordinaattijärjestelmä jne. +GeoServerin eri toiminnot ja operaatiot muodostuvat URL:n liittyvistä parametreistä. Parametrit ohjaavat GeoServerin rajapintapalveluita: mitä karttatasoa kysytään, miltä alueelta tietoja haetaan tai kuva muodostetaan, vastauksen koordinaattijärjestelmä jne. Muokkaa kyselyn parametrejä BBOX, WIDTH ja HEIGHT. Mitä vaikutuksia muutoksilla on vastaukseen? ## **SRS List ja Reprojection console** -SRS List -toiminto listaa Geoserverin tukemat koordinaattijärjestelmät. Geoserver sisältää suurimman osan käytettävistä koordinaattijärjestelmistä eli CRS:t (Coordinate Reference System). SRS (Spatial Reference System) on synonyymi CRS:lle. +SRS List -toiminto listaa GeoServerin tukemat koordinaattijärjestelmät. GeoServer sisältää suurimman osan käytettävistä koordinaattijärjestelmistä eli CRS:t (Coordinate Reference System). SRS (Spatial Reference System) on synonyymi CRS:lle. Koordinaattijärjestelmien välisiä muunnoksia ja konversioita voit kokeilla Reprojection Console-toiminnon avulla. Koordinaatit esitetään WKT-formaatissa (Well Known Text). -Seuraavassa kuvassa on piste geometria määritelty WKT-formaatissa EPSG:3067 koordinaattijärjestelmässä **POINT (522800 7615630)**: +Seuraavassa kuvassa on pistegeometria määritelty WKT-formaatissa EPSG:3067 koordinaattijärjestelmässä **POINT (522800 7615630)**: ![](img/harjoitus_1/image3.png) -Voit myös kokeilla ETRS89 / TM35FIN -viivageometriaa. Löydät esimerkkitiedoston koulutuskansiosta nimellä **esimerkki_wkt_geometry_3067.txt**. Avaa se tekstieditorissa ja käytä sitä **Reprojection console** -työkalussa. Kokeile muuntaa se esimerkiksi WGS 84 -järjestelmään. +Voit myös kokeilla ETRS89 / TM35FIN -viivageometriaa. Löydät esimerkin seuraavassa laatikossa. + +::: file-content-box +MULTILINESTRING ((648023.291968740755692 7710356.988362550, 647623.264163991552778 7709773.493117010220885, +647025.100957126589492 7709395.217135690152645, 646919.555495914653875 7709322.892699570395052, 646428.536749321036041 +7708986.160282356664538, 646070.417665179818869 7708777.868454321287572)) +::: + +Kopioi laatikon sisältö ja käytä sitä **Reprojection console** -työkalussa. Kokeile muuntaa se esimerkiksi WGS 84 -järjestelmään. ![](img/harjoitus_1/image4.png) diff --git a/src/GS006/02_harjoitus_2.Rmd b/src/GS006/02_harjoitus_2.Rmd index 1b08975c..f55bfcc0 100644 --- a/src/GS006/02_harjoitus_2.Rmd +++ b/src/GS006/02_harjoitus_2.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 1.2: GeoServerin web-käyttöliittymä +# HARJOITUS 1.2: GEOSERVERIN WEB-KÄYTTÖLIITTYMÄ **Harjoituksen sisältö** @@ -22,9 +22,6 @@ Tähän asti käyttöliittymällä on ollut näkyvissä vain kaikille avoimet to Kirjaudu nyt palvelimeen käyttäen tunnuksena **admin** ja salasanana **gispo**. -::: hint-box -Psst! GeoServerin oletusasennuksessa salasana on 'geoserver', mutta koulutusta varten tämä on turvallisuussyistä vaihdettu. -::: Ylläpitäjän näkymä muistuttaa äsken nähtyä käyttöliittymää. Sen rakenne on sama, mutta toiminnallisuuksia ja nähtävillä olevia tietoja on huomattavasti enemmän. @@ -46,7 +43,7 @@ Päävalikosta löytyviä GeoServerin toimintoja on ryhmitelty niiden käyttöta | ##### **Tools** | Palvelimen lisätyökaluja | +--------------------------+----------------------------------------------------------------------------+ -Näiden lisäksi Geoserverin laajennokset voivat lisätä valikkoja käyttöliittymään. +Näiden lisäksi GeoServerin laajennokset voivat lisätä valikkoja käyttöliittymään. **Päävalikossa** on nyt uusia valikoita ja toiminnallisuuksia.  @@ -54,11 +51,11 @@ Näiden lisäksi Geoserverin laajennokset voivat lisätä valikkoja käyttöliit ![](img/harjoitus_2/image1.png) -::: hint-box -Psst! Huomaa, että nyt käyttöliittymän keskiosassa lukee myös "No Strong cryptography available...". Riippuen asennuksesta vahva salaus (strong cryptography) -toiminnallisuuden mahdollistaminen saattaa tarvita erillisen asennuksen (Java policy jar tiedostot). -::: +### **About GeoServer** -## **Master- ja Admin-käyttäjät** +Avaa **About GeoServer** ja tutki, mikä GeoServer-versio sinulla on käytössä ja mitkä muiden asennettujen ohjelmistojen versiot ovat. Tämäntyyppiset tiedot ovat tärkeitä palvelimen ongelmia selvitettäessä, tapahtuipa ongelmatilanteiden ratkaiseminen omatoimisesti taikka tukipalvelun avulla. + +## **Master- ja Administrator-käyttäjät** GeoServerin oletusasennuksessa on kaksi käyttäjäprofiilia, **master** ja **admin**. Salasanat on vaihdettu oletuksesta seuraavalla tavalla: @@ -67,7 +64,7 @@ GeoServerin oletusasennuksessa on kaksi käyttäjäprofiilia, **master** ja **ad **Admin** →   gispo ::: hint-box -Psst! Ero master- ja admin-käyttäjien välillä on se, että admin-käyttäjä on tarkoitettu käytettäväksi web-käyttöliittymän hallinnassa. Itse palvelimen asetusten muokkaamiseen käytetään master-käyttäjää, jolla on oikeudet päästä hallitsemaan GeoServerin root-asetuksia sekä suoraan palvelimella että web-käyttöliittymän kautta. Vältä näiden tunnusten käyttöä tuotannollisten palvelimien ylläpidossa. +Psst! Ero master ja admin-käyttäjien välillä on se, että admin-käyttäjä on tarkoitettu käytettäväksi web-käyttöliittymän hallinnassa. Itse palvelimen asetusten muokkaamiseen käytetään master-käyttäjää, jolla on oikeudet päästä hallitsemaan GeoServerin root-asetuksia sekä suoraan palvelimella että web-käyttöliittymän kautta. Vältä näiden tunnusten käyttöä tuotannollisten palvelimien ylläpidossa. ::: Näiden käyttäjien salasanat voi vaihtaa tarvittaessa pääsynhallinnan työkaluilla (**Security**-valikko). @@ -80,7 +77,7 @@ Näiden käyttäjien salasanat voi vaihtaa tarvittaessa pääsynhallinnan työka Aloitetaan päivittämällä yhteystiedot. Valitse päävalikosta **About & Status → Contact Information**. -Täytä omilla tiedoilla ainakin kentät **Contact**, **Organization** ja **Email**. +Täytä omilla tiedoilla ainakin kentät **Organization**, **Contact**, **Position** ja **Email**. ![](img/harjoitus_2/image3.png) @@ -90,7 +87,7 @@ Palataksesi **Welcome**-näkymään voit aina painaa **GeoServer-logoa** sivun v Server Status -sivulla on tietoa erilaisista GeoServerin asetuksista ja tilasta. Huomaa esimerkiksi **Data directory** -kansion sijainti. -Kirjoita omiin muistiinpanoihisi (harjoituksen viimeinen sivu) palvelimesi **Data directory**:n sijainti.\ +Kirjoita omiin muistiinpanoihisi palvelimesi **Data directory**:n sijainti.\ ![](img/harjoitus_2/image4.png) @@ -106,15 +103,15 @@ Tämä valikko sisältää GeoServerin tärkeimmät toiminnot. Aineistot lisät ![](img/harjoitus_2/image6.png) -**Styles** kohdassa määritellään tasoille (**Layers**) kuvaustekniikka, visualisointi.  +**Styles**-kohdassa määritellään tasoille (**Layers**) kuvaustekniikka, visualisointi.  -**Styles** (kuvaustekniikka) käytetään aina kun tasoja julkaistaan WMS-palveluna. Kuvaustekniikka ei ole riippuvainen tasoista: samaa kuvaustekniikkaa voidaan käyttää useilla tasoilla ja niillä voi olla useita valinnaisia kuvaustekniikoita. +**Styles**-määrittelyjä (kuvaustekniikka) käytetään aina kun tasoja julkaistaan WMS-palveluna. Kuvaustekniikka ei ole riippuvainen tasoista: samaa kuvaustekniikkaa voidaan käyttää useilla tasoilla, ja niillä voi olla useita valinnaisia kuvaustekniikoita. ### **Layer Preview** Tämän valikon avulla on mahdollista esikatsella GeoServerillä julkaistuja karttatasoja. -Geoserverin oletusasennuksessa on julkaistu muutama demotaso, joita voi heti käyttää ja esikatsella. +GeoServerin oletusasennuksessa on julkaistu muutama demotaso, joita voi heti käyttää ja esikatsella. ![](img/harjoitus_2/image7.png) @@ -128,13 +125,13 @@ Tasojen lähtöaineisto voi olla rasteri tai vektori, formaatti on kuvattu näil Tason esikatselu aukenee OpenLayers-karttaikkunana uuteen selainikkunaan. Huomaa, että aineiston **OpenLayers**-esikatselussa on käytössä kuvaustekniikka, joka on määritelty GeoServerilla oletukseksi. Kuvaustekniikka-teemaan tutustutaan myöhemmin lisää. -Käyttämällä alasvetovalikkoa (**Select one**), voit myös ladata kyseisen tason eri tiedostomuodoissa (GeoTIFF, csv, shapefile\...). +Käyttämällä alasvetovalikkoa (**Select one**), voit myös ladata kyseisen tason eri tiedostomuodoissa (GeoTIFF, CSV, Shapefile\...). ### **Workspaces** **Workspace** on GeoServerin tapa säilyttää ja järjestää viittaukset aineistoihin (**Stores**). Aineistot itse on tallennettu hakemistoon (tai tietokantaan), johon GeoServerillä on käyttöoikeudet. -Tyypillisesti samassa workspace:ssa pidetään samanlaisia ja/tai samasta lähteestä saatuja aineistoja. Esimerkiksi organisaation aineistot voidaan järjestää teemojen mukaan workspacen avulla (ymparisto, kaavoitus, vaesto, terveys, jne.) +Tyypillisesti samassa workspacessa pidetään samanlaisia ja/tai samasta lähteestä saatuja aineistoja. Esimerkiksi organisaation aineistot voidaan järjestää teemojen mukaan workspacen avulla (ymparisto, kaavoitus, vaesto, terveys, jne.). Avaa **Workspaces**-valikko, muutama workspace on valmiiksi luotu GeoServerille: @@ -152,7 +149,7 @@ Rastita vielä **Default Workspace**, niin jatkossa juuri luomasi workspace on o Psst! URI (Uniform Resource Identifier) on teksti, joka määrittelee tietyn resurssin nimen. Se voi olla nettiosoite tai vaikka suhteellinen hakemisto kovalevystä. Ainoa vaatimus on se, että URI:n arvo on yksilöivä. Voit viitata esimerkiksi osoitteeseen tai kansioon, jossa on säilytetty workspaceen liittyvää dokumentaatiota. ::: -Paina **Submit** ja olet nyt lisännyt uuden workspacen Geoserverille. +Paina **Submit** ja olet nyt lisännyt uuden workspacen GeoServerille. Avaa äsken tekemäsi workspace painamalla **helsinki**-workspace **Workspace Name** -kohdan alta ja huomaa, että lisää valintoja on nyt saatavilla. Palataan niihin myöhemmin säädettäessä workspace-kohtaisia asetuksia. @@ -164,7 +161,7 @@ Workspaceja voidaan poistaa valitsemalla yksi tai useampi workspace ja painamall ### **Stores** -Geoserverillä viitataan aineistolähteisiin **Storesien** avulla. Aineistolähteinä voivat olla yksittäiset tiedostot, tiedostoryhmät, hakemistot, tietokannat tai rajapintapalvelut. +GeoServerillä viitataan aineistolähteisiin **Storesien** avulla. Aineistolähteinä voivat olla yksittäiset tiedostot, tiedostoryhmät, hakemistot, tietokannat tai rajapintapalvelut. Oletusasennuksessa on valmiina **Store**-viittauksia esimerkkiaineistoihin: @@ -186,7 +183,7 @@ Mihin aineistoon sfdem-store viittaa? Mihin aineistoon taz_shapes-store viittaa? ::: -Huomaa, että [**file:data/**](file:data/){.uri} viittaa Geoserverin Data Directory -hakemistoon. Hakemiston sijainti levyjärjestelmässä löytyy **About & Status → Server Status** -valikon kautta. +Huomaa, että [**file:data/**](file:data/){.uri} viittaa GeoServerin Data Directory -hakemistoon. Hakemiston sijainti levyjärjestelmässä löytyy **About & Status → Server Status** -valikon kautta. Store **taz_shapes** viittaa hakemistoon, jossa on useampia vektoriaineistoja, tässä tapauksessa .shp-tiedostoja. @@ -204,15 +201,15 @@ Tasot (**Layers**) määrittelevät yhden aineistolähteen (**Store**) julkaisem Yksi taso vastaa yhtä aineistoa. Aineisto voidaan julkaista useisiin eri tasoihin, esimerkiksi eri kuvaustekniikoilla tms. -**Layers**-näkymässä on mahdollista muokata, lisätä tai poistaa tasoja. **Layers**-näkymän taulukossa on nähtävissä muutama taso ja niiden nimet (**Name**). Taulukossa lukee myös tason otsikko (**Title**) ja missä **Store**:ssa aineistot sijaitsevat. +**Layers**-näkymässä on mahdollista muokata, lisätä tai poistaa tasoja. **Layers**-näkymän taulukossa on nähtävissä muutama taso ja niiden nimet (**Name**). Taulukossa lukee myös tason otsikko (**Title**) ja missä **Store**ssa aineistot sijaitsevat. Sarake **Enabled** näyttää tiedon siitä, onko taso käytettävissä palvelimelta vai ei. Huomaa, että käytettävyyden voi määritellä koko storelle (eli aineistolähteelle) tai erikseen tasoille (aineiston näkymille). Myös tason alkuperäinen koordinaattijärjestelmä on ilmoitettu taulukossa, **Native SRS**. ![](img/harjoitus_2/image20.png) -Avaa **Manhattan (NY) landmarks** -tason asetusten näkymä painamalla tason otsikkoa **Title**- tai nimeä **Name** sarakkeesta.  +Avaa **Manhattan (NY) landmarks** -tason asetusten näkymä painamalla tason otsikkoa (**Title**) tai nimeä (**Name**) sarakkeesta.  -Tasoon liittyvät asetukset ovat laajat ja siksi ne on jaettu välilehtiin **Data**, **Publishing**, **Dimensions** ja **Tile Caching**.  +Tasoon liittyvät asetukset ovat laajat ja siksi ne on jaettu välilehtiin **Data**, **Publishing**, **Dimensions**, **Tile Caching** ja **Security**.  Tutustu nyt eri välilehtien asetuksiin saadaksesi kuvan siitä, miten tasot määritellään GeoServerillä. Keskustele niistä kouluttajan kanssa. @@ -231,14 +228,13 @@ Avaa **Styles**-valikko, saat näkyviin listan GeoServerilla olevista kuvaustekn ![](img/harjoitus_2/image22.png) Avaa **giant_polygon**-tyyli ja tutustu GeoServerin käyttämään kuvaustekniikkaformaattiin. Tasojen kuvaustekniikka määritellään käyttäen Styled Layer Descriptor (SLD) -kieltä. - ![](img/harjoitus_2/image23.png) Kuvaustekniikka on hyvin laaja aihe; siihen tutustutaan erikseen myöhemmin. Kuvaustekniikan toteuttamista voi helpottaa käyttämällä CSS-laajennosta, tätäkin käsitellään myöhemmin koulutuksessa. ## **Services** -GeoServerin rajapintapalvelujen (WFS, WMS ja WCS) yleisasetukset määritellään **Services**-valikon kautta. Näihin tutustutaan tarkemmin myöhemmin. +GeoServerin rajapintapalvelujen (WFS, WMS ja WCS) yleisasetukset määritellään **Services**-valikon kautta; näihin tutustutaan tarkemmin myöhemmin. ![](img/harjoitus_2/image24.png) @@ -249,7 +245,9 @@ Tämä valikko sisältää erilaisia asetuksia kuten: +--------------------------------------+-----------------------------------------------------------------------------+ | **Global** | Rajapintapalvelujen asetuksia ja lokitietojen asetuksia | +--------------------------------------+-----------------------------------------------------------------------------+ -| **Image Processing & Raster Access** | Asetukset kuvien ja raakakuva-aineiston (coverage) käsittelyyn palvelimessa | +| **Image Processing** | Kuvien (WMS-ja WCS-palvelujen) käsittelyyn liittyviä asetuksia | ++--------------------------------------+-----------------------------------------------------------------------------+ +| **Raster Access** | Rasteriaineiston käsittelyyn liittyviä muisti- ja CPU-asetuksia | +--------------------------------------+-----------------------------------------------------------------------------+ ## **Tile Caching** diff --git a/src/GS006/03_harjoitus_3.Rmd b/src/GS006/03_harjoitus_3.Rmd index bdab3943..faeb92b6 100644 --- a/src/GS006/03_harjoitus_3.Rmd +++ b/src/GS006/03_harjoitus_3.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 1.3: Vektoriaineistot +# Harjoitus 1.3: VEKTORIAINEISTOT **Harjoituksen sisältö** @@ -23,24 +23,13 @@ Harjoituksessa käytettävät aineistot on ladattu käytössä oleville palvelim GeoServerin aineistohakemistossa on paikkatiedon lisäksi muita aineistoja, kuten karttatyylejä ja tasoryhmien määrittelyjä. Tarkemmin, kurssin paikkatietoaineistot ovat koulutuskoneen kansiossa:  ::: note-box -/var/lib/tomcat8/webapps/geoserver/data/koulutus/ +/opt/geoserver/data_dir/koulutus/ ::: -::: hint-box -Psst! Aineistojen lisäämisen yhteydessä ilmenevät virheilmoitukset liittyvät usein tiedostojen ja hakemistojen käyttöoikeuksiin. -::: - -Varmista, että koulutuskansio ja kaikki sen sisältämät alikansiot ja tiedostot ovat tomcat8-käyttäjän omistamia suorittamalla komentorivillä seuraava komento: - -::: commandline-box -sudo chown -R tomcat8:tomcat8 /var/lib/tomcat8/webapps/geoserver/data/koulutus -::: - -Koulutuskoneen **salasana on gispo**. -## **Vektoriaineisto-storen luominen** +## **Vektoriaineiston Storen luominen** -Koulutuksen aineistosta löytyy muun muassa OpenStreetMapsin rakennukset Helsingistä shapefile-formaatissa **buildings.shp**, joka lisätään nyt GeoServeriin. +Koulutuksen aineistosta löytyy muun muassa OpenStreetMapin rakennukset Helsingistä shapefile-formaatissa **buildings.shp**, joka lisätään nyt GeoServeriin. Aineiston formaatin ollen **shapefile** täytyy sille luoda **store**, joka on shapefile-formaatin kanssa yhteensopiva. @@ -52,13 +41,13 @@ Valitse Shapefile aineiston formaatiksi **New data source** -näkymässä, **Vec ![](img/harjoitus_3/image3.png) -Seuraavassa näkymässä pääset määrittelemään juuri luomasi store:n muut asetukset, kuten nimen ja tiedoston sijainnit. Nimeä ne seuraavalla tavalla: +Seuraavassa näkymässä pääset määrittelemään juuri luomasi storen muut asetukset, kuten nimen ja tiedoston sijainnit. Nimeä ne seuraavalla tavalla: - **Valitse** workspaceksi helsinki - **Nimeä** aineisto hki_rakennukset -- **Lisää** halutessasi aineistolle kuvaus, esimerkiksi "Helsingin OpenStreetMaps rakennukset" +- **Lisää** halutessasi aineistolle kuvaus, esimerkiksi "Helsingin OpenStreetMap-rakennukset" Seuraavaksi määritellään mihin aineistoon (shape-tiedostoon) viitataan tämän store:n kautta. Muokkaa **Connection Parameters**: @@ -66,7 +55,7 @@ Seuraavaksi määritellään mihin aineistoon (shape-tiedostoon) viitataan täm Pidä **Enabled** ruksattuna ja varmista näin tekemäsi store:n (ja siitä luotujen tasojen) käytettävyys GeoServer-palvelimelta. Tätä valintaa voidaan käyttää halutessa piilottaa joitakin aineistoja käyttäjiltä ilman niiden poistamista palvelimelta (ylläpitäjät voivat vielä käyttää niitä). -Tarkista vielä, että **DBF charset** arvo on **UTF-8**. +Tarkista vielä, että **DBF charset** arvo on **ISO-8859-1**. Loput asetukset voidaan pitää oletusarvoina. @@ -82,10 +71,10 @@ Paina **Publish** tason julkaisemiseksi. ## **Vektoritason julkaiseminen** -Luodaan ja julkaistaan nyt uusi taso. Jos et vielä tehnyt niin, paina **Publish**, jotta pääset muuttamaan julkaistavan tason ominaisuuksia. +Luodaan ja julkaistaan nyt uusi taso. Jos et vielä tehnyt niin, paina **Publish** niin pääset muuttamaan julkaistavan tason ominaisuuksia. ::: hint-box -Psst! Jos ehdit poistumaan edellisestä näkymästä, samaan uuden tason luonti -näkymään pääsee päävalikosta Layers \> Add a new layer ja valitsemalla haluttu store (tässä tapauksessa helsinki:hki_rakennukset). +Psst! Jos ehdit poistumaan edellisestä näkymästä, samaan uuden tason luonti -näkymään pääsee päävalikosta Layers \> Add a new layer ja valitsemalla haluttu store (meidän tapauksessa helsinki:hki_rakennukset). ::: Tason julkistamisen ominaisuudet ovat jaettu neljään välilehteen: @@ -98,35 +87,35 @@ Tason julkistamisen ominaisuudet ovat jaettu neljään välilehteen: - **Tile Caching** -## **Data-asetukset** +## **Data asetukset** Keskitytään nyt **Data**-välilehdessä oleviin valintoihin. Määrittele yleistiedot seuraavasti: -- **Pidä** Enabled ja Advertised rastitettuna. +- **Pidä** Enabled ja Advertised rastitettuna -- **Nimeä** aineisto: "rakennukset". +- **Nimeä** aineisto rakennukset -- **Otsikoi** "Helsingin OpenStreetMap -rakennukset" +- **Otsikoi** Helsingin OpenStreetMap rakennukset -**Lisää** halutessasi selitystä tasosta ja tasoon liittyviä avainsanoja (keywords). Avainsanojen avulla sekä Geoserverin ylläpitäjien ja käyttäjien on helpompi löytää heille tarpeellisia paikkatietoaineistoja. +**Lisää** halutessasi selitystä tasosta ja tasoon liittyviä avainsanoja (keywords). Avainsanojen avulla sekä GeoServerin ylläpitäjien ja käyttäjien on helpompi löytää heille tarpeellisia paikkatietoaineistoja. ### **Coordinate Reference Systems** -Selaa alaspäin kunnes löydät **Coordinate Reference Systems** -kohdan. Tässä määritetään tasolle koordinaattijärjestelmä. +Selaa alaspäin kunnes löydät **Coordinate Reference Systems** -kohdan. Tässä määritellään tasolle koordinaattijärjestelmä. Kun uutta aineistoa tuodaan GeoServeriin, se yrittää tunnistaa alkuperäisen koordinaattijärjestelmän EPSG-koodin. Jos tunnistus ei onnistu, niin **Native SRS** -kentän arvoksi tulee **UNKNOWN** ja sen oikealta puolelta löytyy linkki, josta saa tiedot aineiston alkuperäisen koordinaattijärjestelmän selvittämistä varten. -Tässä tapauksessa projektiotiedot tulevat shapefilen aineiston .prj-tiedostosta. Paina **GCS_WGS_1984...** -linkkiä, niin saat auki projektiotiedot. +Tässä tapauksessa, projektiotiedot tulevat shapefilen aineiston .prj-tiedostosta. Paina **GCS_WGS_1984...** -linkkiä, niin saat auki projektiotiedot. ![](img/harjoitus_3/image6.png) ::: hint-box -Psst! Huomaa, että Native SRS -tiedot on tarkoitettu vaan esikatselua varten. Tiedot tulevat suoraan alkuperäisen aineiston asetuksista, esimerkiksi shapefilen tai PostGIS-tason koordinaattijärjestelmätiedoista. Siksi niitä ei voida muokata GeoServerin selaimessa käyttöliittymän kautta. +Psst! Huomaa, että Native SRS tiedot ovat tarkoitettu vaan esikatselua varten. Tiedot tulevat suoraan alkuperäisen aineiston asetuksista, esimerkiksi shapefilen tai PostGIS-tason koordinaattijärjestelmätiedoista. Siksi niitä ei voida muokata GeoServerin selaimessa käyttöliittymän kautta. ::: -Kirjoita **EPSG:4326**-koodi **Declared SRS** -kohdassa. Voit myös etsiä EPSG-koodeja **Find** -toiminnolla. +Lisää tarvittaessa **EPSG:4326**-koodi **Declared SRS** -kohtaan. Voit myös etsiä EPSG-koodeja **Find** -toiminnolla. -Pidä **SRS handling** -oletusarvo (**Force declared**) ennallaan. +Pidä **SRS handling** oletusarvo (**Force declared**) ennallaan. ![](img/harjoitus_3/image7.png) @@ -135,7 +124,7 @@ Pidä **SRS handling** -oletusarvo (**Force declared**) ennallaan. Täytä alla **Bounding Boxes** -kohdassa tiedot aineiston laajuudesta. ::: hint-box -Psst! Laajuus olisi mahdollista määritellä automaattisesti, mutta GeoServer vaatii, että tämä asetus tehdään valvotusti. Syy on se, että suurien aineistojen kanssa palvelin voisi jäädä pitkäksi ajaksi laskemaan tasojen laajuutta. Pyyntö voisi jopa epäonnistua, jos palvelimen timeout-asetus ylittyisi ja näin aineiston lisääminen olisi hankalaa. +Psst! Laajuus olisi mahdollista määritellä automaattisesti, mutta GeoServer vaatii, että tämä asetus tehdään valvotusti. Syy on se, että suurien aineistojen kanssa palvelin voisi jäädä pitkäksi ajaksi laskemaan tasojen laajuutta. Pyyntö voisi jopa epäonnistua, jos palvelimen timeout-asetus ylittyisi ja näin aineiston lisääminen olisi hankala. ::: Harjoituksen aineisto on sen verran pieni, että voimme käyttää automaattista määrittelyä. Paina ensin **Native Bounding Box → Compute from data** ja sitten **Lat/Lon Bounding Box → Compute from native bounds**. @@ -168,6 +157,6 @@ Zoomaa karttaan ja paina jonkun rakennuksen päällä niin saat sen ominaisuusti ## **Helsingin tiestön lisääminen** -Lisää nyt OpenStreetMap Helsingin tiestö GeoServeriin samalla tavalla kuin edellisessä harjoituksessa. Aineisto löytyy samasta kansiosta kuin **rakennukset-**aineisto, nimellä **roads.shp**. +Lisää nyt OpenStreetMap Helsingin tiestö GeoServeriin samalla tavalla kuin edellisessä harjoituksessa. Aineisto löytyy samasta kansiosta kuin **rakennukset-**aineisto, nimellä **gis.osm_roads_free_1.shp**. -Muista, että ennen kun tason voi lisätä GeoServeriin, sille täytyy luoda sopiva store. Nimeä uusi store nimellä **hki_tiesto** ja siitä luotu taso nimellä **tiesto**, niin tasojen nimet pysyvät samankaltaisina. Muista korjata myös koordinaattijärjestelmä (**EPSG:4326**) ja **DBF charset** (**UTF-8**). +Muista, että ennen kun tason voi lisätä GeoServeriin, sille täytyy luoda sopiva store. Nimeä uusi store **hki_tiesto** ja siitä luotu taso **tiesto** niin tasojen nimet pysyvät samankaltaisina. Muista tarkistaa myös koordinaattijärjestelmä (**EPSG:4326**) ja **DBF charset** (**ISO-8859-1**). diff --git a/src/GS006/04_harjoitus_4.Rmd b/src/GS006/04_harjoitus_4.Rmd index bd661288..70cf7630 100644 --- a/src/GS006/04_harjoitus_4.Rmd +++ b/src/GS006/04_harjoitus_4.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 1.4: Kuvaustekniikan perusteet (SLD) +# HARJOITUS 1.4: KUVAUSTEKNIIKAN PERUSTEET (SLD) **Harjoituksen sisältö** @@ -14,12 +14,6 @@ Harjoituksen jälkeen opiskelija osaa hyödyntää peruskuvaustekniikoita GeoSer ## **Valmistautuminen** -Käynnistä koneessa web-selain ja kirjaudu osoitteeseen: - -::: note-box - -::: - Aiemmissa harjoituksissa on luotu GeoServerin palvelimelle taso **rakennukset**, johon luodaan nyt kuvaustekniikka. ## **GeoServerin kuvaustekniikka** @@ -36,7 +30,7 @@ Huomaa, että **WMS Settings** -kohdasta löytyy **Default Style** -valikko, joh ## **SLD-kuvaustekniikka** -Geoserverin tyylit on määritelty **Styled Layer Descriptorilla** (SLD), joka on XML-kieli. +GeoServerin tyylit on määritelty **Styled Layer Descriptorilla** (SLD), joka on XML-kieli. Poistu tason näkymästä ja avaa **Data → Styles** näkymä päävalikon alta. Tässä näkymässä määritellään tyylit (kuvaustekniikat), joita WMS-karttatasoissa käytetään. @@ -58,7 +52,6 @@ Laaditaan nyt oma kuvaustekniikka Helsingin rakennukset -aineistolle. Anna uudelle tyylille nimeksi **oletus_polygoni**. Valitse workspace:ksi **helsinki**. -![](img/harjoitus_4/image4.png) Helpottaakseen omien tyylien kirjoittamisen aloittamista, SLD-koodikentän täyttämiseen voidaan valita malliksi GeoServerin oletustyylit tai kopioida olemassa oleva tyyli. @@ -66,11 +59,11 @@ Valitse **Generate a default style** -alasvetovalikosta **Polygon** ja paina sen ![](img/harjoitus_4/image5.png) -Voit nyt testata SLD-koodia **Validate-**toiminnolla. Testauksen onnistuminen näkyy ilmoituksena sivun yläpuolella. +Voit nyt testata SLD-koodia **Validate-**toiminnolla. Testauksen onnistuminen näkyy vihrellä palkilla. ![](img/harjoitus_4/image6.png) -Tallenna muutokset painamalla ensin **Submit**. +Tallenna muutokset väliaikaisesti painamalla ensin **Apply**. Paina tämän jälkeen **Save**, niin muutokset tallentuvat pysyvästi. ## **SLD-kuvaustekniikan käyttöönotto** @@ -82,7 +75,7 @@ Avaa **rakennukset**-tason editointinäkymä päävalikosta **Data → Layers**. Paina sitten **Save**. -**Data → Layer Preview** näkymästä voit nyt esikatsella **rakennukset**-tasoa, uusi tyyli on nyt käytössä. +**Data → Layer Preview** näkymästä voit nyt esikatsella **rakennukset**-tasoa, uusi tyyli on nyt käytössä. Huomioi, että esikatselu voi olla välillä hidasta riippuen datan määrästä. ![](img/harjoitus_4/image7.png) @@ -92,10 +85,10 @@ Kannattaa tutustua SLD-tyylien kirjoittamiseen SLD Cookbook -sivuilta. SLD Cookb Käytetään seuraavaksi pohjana uuteen tyyliimme esimerkkiä **SLD Cookbookista**.  -Avaa uudessa selainikkunassa GeoServerin SLD Cookbook alla olevasta linkistä (tai voit etsiä selaimella Googlesta "geoserver sld cookbook"). Etsi **Polygon with styled label** -kohta ja paina sitä: +Avaa uudessa selainikkunassa GeoServerin SLD Cookbook alla olevasta linkistä. Tässä harjoituksessa käytetään **[Polygon with styled label](https://docs.geoserver.org/main/en/user/styling/sld/cookbook/polygons/#sld_cookbook_polygons_polygonwithstyledlabel)** -esimerkkiä. ::: note-box - + ::: Löydät lyhyen esityksen kuvaustekniikasta ja SLD-koodin. Tutustu lyhyesti koodiin ja yritä löytää tärkeimmät elementit (tagit) kuten monikulmion viivan ja täytön värit sekä tekstien fonttimääritelmät. Voit kirjoittaa muistiinpanoja tärkeimmistä elementeistä ja määritelmistä harjoituksen viimeiselle sivulle. @@ -108,7 +101,7 @@ Tavanomaisen SLD-kielen lisäksi tämä mallikoodi sisältää kaksi GeoServerin Etsi SLD-tyylien esimerkkisivuilta **View and download the full "Polygon with styled label" SLD** -linkki, avaa se uudessa ikkunassa ja tallenna kyseinen sivu .sld-tiedostona, käyttämällä selaimen tallennus (save as / tallenna nimellä) toimintoa. Anna tiedostolle nimi, jonka muistat vielä myöhemmin (esimerkiksi polygon_polygonwithstyledlabel.sld). -Palaa nyt GeoServerin käyttöliittymään ja paina koodilaatikon alta **Browse**. Etsi äskettäin ladattu SLD-tyyli levyltä ja paina lopuksi **Upload**. +Palaa nyt GeoServerin käyttöliittymään ja paina koodilaatikon yläpuolelta **Browse**. Etsi äskettäin ladattu SLD-tyyli levyltä ja paina lopuksi **Upload**. ![](img/harjoitus_4/image8.png) @@ -134,7 +127,7 @@ Muokkaa vielä monikulmion SLD-tyyli seuraavasti: Psst! Huomaa, että GeoServerissä desimaalierottimena toimii ainoastaan piste ".". Tämä pätee kaikissa GeoServerin asetuksissa. ::: -Tallenna sitten muutokset painamalla ensin **Submit**. +Tallenna sitten muutokset painamalla ensin **Apply**. Lopuksi vaihda **rakennukset**-tasolle tyyliksi **rakennukset**-tyyli (**Data → Layers → rakennukset → Publishing**). @@ -148,7 +141,7 @@ Palaa **Styles**-näkymälle ja valitse taas **rakennukset**-tyyli. Poista SLD-k ::: code-box \\ -   \#000000\\ +   \#000000\\ \\ ::: @@ -158,7 +151,7 @@ ja korvaa sen tilalle: \\    \3\\     \\ -        \#FFFFFF\\ +        \#FFFFFF\\     \\ \ ::: @@ -169,7 +162,7 @@ SLD-koodi ikkunassa näyttää tältä: Paina sitten **Validate**. -Jos koodin käytössä tulee virheilmoituksia tai se ei toimi, pyydä kouluttajalta apua. Muuten paina **Submit**, niin tyyli tallentuu. +Jos koodin käytössä tulee virheilmoituksia tai se ei toimi, pyydä kouluttajalta apua. Muuten paina **Apply**, niin tyyli tallentuu. Päivitetty tyyli on heti käytössä palvelimella ja sitä voi esikatsella **rakennukset**-tason avulla. Selainikkunan voit päivittää painamalla **F5**-näppäintätai **CTRL+R**-näppäimiä. @@ -197,17 +190,17 @@ Etsi **\** kappaleen sisällä oleva **\** ja lisää sen alle: ![](img/harjoitus_4/image13.png) -Paina sitten **Submit**. +Paina sitten **Apply**. Aseta vielä tiesto-tason oletustyyliksi **tiesto-tyyli**. (**Data → Layers → helsinki:tiesto → Publishing**). ![](img/harjoitus_4/image14.png) -Paina **Save** ja esikatsele tasoa. Huomaa, että kun loitonnat karttaa siten että mittakaava on pienempi kuin 1:32 000, tiet eivät enää tule näkyviin. +Paina **Save** ja esikatsele tasoa. Huomaa, että kun lähennät karttaa siten että mittakaava on suurempi kuin 1:32 000, tiet eivät enää tule näkyviin. -Lisätään nyt tiet myös mittakaavaan 1:32 000 ja suuremmille. Tämä onnistuu luomalla **\**-osio, jossa maksimimittakaava (**\**) on määritelty arvolla **32000**. +Lisätään nyt tiet myös mittakaavaan 1:32 000 ja suuremmille. Tämä onnistuu luomalla **\**-osio, jossa pienin mittakaava (**\**) on määritelty **32000** arvoksi. -Voit hyödyntää edellistä sääntöosiota: kopioi koko **\** kappale. Lisää se **\** jälkeen. +Voit hyödyntää edellisen sääntö osiota: kopioi koko **\** kappale. Lisää se **\** jälkeen. ![](img/harjoitus_4/image15.png) @@ -227,7 +220,7 @@ Vaihda viivan väri harmaaksi **#666666**, otsikoksi **Paksu viiva** ja paksuude ![](img/harjoitus_4/image16.png) -Paina **Submit** ja esikatsele.Huomaa, että nyt kun lähennät karttaikkunaa (suurennat mittakaavaa), niin teiden väri ja paksuus muuttuu. +Paina **Apply** ja esikatsele. Huomaa, että nyt kun lähennät karttaikkunaa (suurennat mittakaavaa), niin teiden väri ja paksuus muuttuu. Lisätään vielä täyteväri viivoille lisäämällä uusi sääntö. Kopioi edellinen **\** -koodi kappale (jolla on \32000\) ja liitä se kopioidun kappaleen jatkoksi. @@ -235,7 +228,7 @@ Muuta taas otsikko, väri ja paksuus kuvan mukaisesti: ![](img/harjoitus_4/image17.png) -Tämä viiva tulee piirretyksi edellisen paksumman viivan päälle, mistä aiheutuu viivareunan efekti. +Tämä viiva tulee piirretyksi edellisen paksumman viivan päälle, josta aiheutuu viivareunan efekti. Esikatsele lopputulosta: diff --git a/src/GS006/05_harjoitus_5.Rmd b/src/GS006/05_harjoitus_5.Rmd index 6ee5d406..d5edddcf 100644 --- a/src/GS006/05_harjoitus_5.Rmd +++ b/src/GS006/05_harjoitus_5.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 1.5: WMS- ja WCS-palvelut +# HARJOITUS 1.5: WMS- JA WCS-PALVELUT **Harjoituksen sisältö** @@ -30,7 +30,7 @@ Eri rajapintapalvelujen yleiset asetukset löytyvät päävalikosta **Services** Käytännössä kaikki aiemmin lisätyt aineistot ovat jo valmiiksi julkaistu rajapintapalveluina, koska kaikki edellä käydyt kolme palvelua (WMS, WCS ja WFS) on aktivoitu koulutuksen GeoServerin oletusasennuksessa. -Olemme esimerkiksi käyttäneet WMS-karttapalvelua aina, kun olemme esikatselleet jotain tasoa selaimella. +Olemme esimerkiksi käyttäneet WMS-karttapalvelua aina kun olemme esikatselleet jotain tasoa selaimella. Avaa **Services → WMS-näkymä**. @@ -44,7 +44,8 @@ Kaikkien karttapalveluiden toiminnallisuutta ja palvelinasetuksia voi myös mä Psst! Nämä metadatan asetukset ovat samankaltaiset myös WFS- ja WCS-palvelujen kohdalla. ::: -Määrittele näitä tietoja WMS-palvelulle. +Määrittele näitä tietoja WMS-palvelulle. Voit kirjoittaa muistiinpanot harjoituksen viimeiselle sivulle. + ![](img/harjoitus_5/image1.png) ## **WMS** @@ -71,7 +72,7 @@ Käytä sitten **Browse\...** valitsemaan GeoServerin logo (**/koulutus/GeoServe Laita vielä läpinäkyvyyttä **30**:ksi ja sijainniksi **Bottom right**. -Paina nyt **Submit** tallentaaksesi muutokset WMS-palveluun. Kaikkien WMS-palvelukartan kautta saatujen karttojen pitäisi nyt sisältää vesileima. +Paina nyt **Apply** tallentaaksesi muutokset WMS-palveluun. Kaikkien WMS-palvelukartan kautta saatujen karttojen pitäisi nyt sisältää vesileima. Avaa **Data → Layer Preview**, ja esikatsele joitakin tasoja. Tarkista, että vesileima tulee näkyviin kaikissa WMS-pyynnöissä. @@ -109,7 +110,7 @@ Tiedot voit tarkistaa Getcapabilities-pyynnöllä seuraavasti: - Tiger-workspace: [http://xx.xx.xx.xx/geoserver/tiger/wms?REQUEST=GetCapabilities](http://xx.xx.xx.xx/geoserver/helsinki/wms?REQUEST=Getcapabilities) -- Geoserver oletus: [http://xx.xx.xx.xx/geoserver/wms?REQUEST=GetCapabilities](http://xx.xx.xx.xx/geoserver/helsinki/wms?REQUEST=Getcapabilities) +- GeoServer oletus: [http://xx.xx.xx.xx/geoserver/wms?REQUEST=GetCapabilities](http://xx.xx.xx.xx/geoserver/helsinki/wms?REQUEST=Getcapabilities) \ ![](img/harjoitus_5/image5.png) @@ -136,27 +137,26 @@ Jos suurennat kuvaa selaimessa (tai tallennat sen kovalevylle ja katselet sitä Valitse ja kopioi koko selaimessa oleva osoitteen teksti. Avaa tekstinkäsittelyohjelma ja liimaa teksti siihen. Se on http-pyyntö GeoServerin palvelimellesi ja se muistuttaa seuraavaa tekstiä: -::: code-box -http://xx.xx.xx.xx:8080/geoserver/tiger/wms?service=WMS&version=1.1.0&request=GetMap &layers=tiger:poly_landmarks&styles=&bbox=-74.047185,40.679648,-73.90782,40.882078 **&width=528&height=768**&srs=EPSG:4326**&format=image%2Fjpeg** +::: note-box +[http://xx.xx.xx.xx:8080/geoserver/tiger/wms?service=WMS&version=1.1.0&request=GetMap &layers=tiger:poly_landmarks&styles=&bbox=-74.047185,40.679648,-73.90782,40.882078 **&width=528&height=768**&srs=EPSG:4326**&format=image%2Fjpeg**](http://xx.xx.xx.xx:8080/geoserver/tiger/wms?service=WMS&version=1.1.0&request=GetMap%20&layers=tiger:poly_landmarks&styles=&bbox=-74.047185,40.679648,-73.90782,40.882078%20&width=528&height=768&srs=EPSG:4326&format=image%2Fjpeg) ::: Tekstiin on korostettu tärkeimmät parametrit koskien WMS-kuvaa. Niistä voi tulkita seuraavaa: -- **&width** ja **&height**: kuvan koko on 528\*768 pikseliä ja  +- **&width** ja **&height**:kuvan koko on 528\*768 pikseliä ja  - **&format**: formaatti on JPEG -- Kuvan resoluutiosta ei ole mainittu pyynnössä mitään, joten käytössä on oletusresoluutio. +- Kuvan resoluutiosta ei ole mitään mainittu pyynnössä, joten käytössä on oletusresoluutio. -Määrittääksesi kuvaresoluutiota voit lisätä seuraavan parametrin http-pyynnön loppuun: **&format_options=dpi:300**. Lisää se siis WMS-pyyntösi loppuun ja kopioi ja liimaa se kokonaisuudessaan uuteen selainikkunaan vertailua varten. Painamalla **enter** saat aikaiseksi uuden kuvan: +Määrittääksesi kuvaresoluutiota voit lisätä seuraavan parametrin http-pyynnön loppuun: **&format_options=dpi:300**. Lisää se siis WMS-pyyntösi loppuun, ja kopioi ja liimaa se nyt kokonaisuudessaan uuteen selainikkunaan vertailua varten. Painamalla **enter** saat aikaiseksi uuden kuvan: ![](img/harjoitus_5/image9.png) Huomataan, että tyylit eivät täsmää aikaisempaan. Se johtuu siitä, että pyynnössä pitää myös muokata kuvan kokoa, joka on laskettu oletusresoluutiolle sopivaksi. Nyt WMS-karttapalvelun tuottama JPEG-kuva on tuotettu kuitenkin jo korkeammalla resoluutiolla kuin aikaisemmin. Resoluutiot voidaan tarkistaa halutessaan tallentamalla molemmat kuvat kovalevylle ja vertaamalla niitä zoomaamalla käyttämäsi käyttöjärjestelmän kuvien esikatseluohjelman avulla. -Kuten sanottu, tyylit eivät nyt näytä oikeilta, koska oletuspyynnössä on kuvan koko laskettu 90 DPI -resoluution mukaiseksi. Nyt on siis muokattava **&width-** ja **&height**-parametrien arvot yhteensopivaksi uuteenresoluutioon eli arvolle **300 DPI**. Tämä tapahtuu käyttämällä seuraavaa yhtälöä: - +Kuten sanottu, tyylit eivät nyt näytä oikeilta, koska oletuspyynnössä on kuvan koko laskettu 90 DPI resoluution mukaiseksi. Nyt on siis muokattava **&width-** ja **&height**-parametrien arvot yhteensopivaksi uuteenresoluutioon eli arvolle **300 DPI**. Tämä tapahtuu käyttämällä seuraavaa yhtälöä: ![](img/harjoitus_5/image10.png) ![](img/harjoitus_5/image11.png) @@ -165,7 +165,7 @@ Kuten sanottu, tyylit eivät nyt näytä oikeilta, koska oletuspyynnössä on ku - uusi_pituus = kuvan_oletuspituus \* (uusi_resoluutio/90) -Eli tässä tapauksessa: +Eli meidän tapauksessamme: - uusi_leveys = 528 \* (300/90) → **&width=1760** @@ -188,4 +188,4 @@ Samalla tavalla, **Overview policy** -toiminto mahdollistaa aineiston yleiskatsa **Resource Consumption Limits** -valintaa käyttämällä ylläpitäjä voi asettaa resurssien käytölle rajoja raakarasteriaineistoja käsiteltäessä. Raaka-aineistojen koko voi olla hyvinkin suuri (lähtökohtaisesti kymmeniä tai satoja gigatavuja) ja palvelin voi ylikuormittua pyyntöjä käsiteltäessä. -![](img/harjoitus_5/image13.png) +![](img/harjoitus_5/image13.png) \ No newline at end of file diff --git a/src/GS006/06_harjoitus_6.Rmd b/src/GS006/06_harjoitus_6.Rmd index bd211de9..ee827e34 100644 --- a/src/GS006/06_harjoitus_6.Rmd +++ b/src/GS006/06_harjoitus_6.Rmd @@ -1,12 +1,12 @@ -# Harjoitus 1.6: Rasteriaineistot +# HARJOITUS 1.6: RASTERIAINEISTOT **Harjoituksen sisältö** -Harjoituksessa lisätään rasteriaineistoja GeoServer-palvelimelle ja muokataan tason asetuksia WCS-palvelun julkaisemista varten. +Harjoituksessa lisätään rasteriaineistoja GeoServer-palvelimelle ja luodaan ryhmätaso. **Harjoituksen tavoite** -Harjoituksen jälkeen opiskelija osaa lisätä rasteriaineistoja ja tehdä välttämättömät asetukset aineiston julkaisemiseksi. +Harjoituksen jälkeen opiskelija osaa lisätä rasteriaineistoja ja luoda ryhmätason. **Arvioitu kesto** @@ -36,11 +36,9 @@ Paina sitten **Save** ja sen jälkeen **Publish**. Kuten aiemmin vektoriaineistojen luomisen yhteydessä, pääset nyt tason editointinäkymään. Tarkista yleisasetukset niin, että sekä **Enabled** että **Advertised** ovat valittuna. Laita nimeksi **korkeusmalli** ja otsikoksi **Helsingin korkeusmalli** ja lisätiedoksi **Korkeusmalli 2m -- Maanmittauslaitos.** - ![](img/harjoitus_6/image2.png) -Huomaa, että **Coordinate Reference Systems** -kohdassa, koordinaattijärjestelmä on määritelty väärin. Aineiston oikea järjestelmä on **ETRS89 / ETRS-TM35FIN** (**EPSG:3067**). Korjaa sitä käsin **Declared SRS** -kentässä ja valitse **SRS handling** -kentästä **Force declared**. Käytä sen jälkeen pikalinkkejä määrittääksesi aineiston laajuuden. - +Huomaa, että **Coordinate Reference Systems** -kohdassa, koordinaattijärjestelmä on määritelty väärin. Aineiston oikea järjestelmä on **ETRS89 / ETRS-TM35FIN** (**EPSG:3067**). Korjaa sitä käsin **Declared SRS** -kentässä ja valitse **SRS handling** kentästä **Force declared**. Käytä sen jälkeen pikalinkkejä määrittääksesi aineiston laajuuden. ![](img/harjoitus_6/image3.png) Paina sitten **Save.** @@ -50,9 +48,9 @@ Tarkista, että taso on **Data → Layers**-taulussa. Voit esikatsella uutta ras ## **Ilmakuvan lisääminen** -Samalla tavalla kun lisäsit edellisessä kohdassa ArcGrid-tiedoston, voit lisätä GeoTIFF-aineistoja.  +Samalla tavalla kun lisäsit edellisessä kohdassa ArcGrid-tiedoston voit lisätä GeoTIFF-aineistoja.  -Seuraa edellisen kohdan ohjeita ja lisää samalta alueelta ilmakuva. GeoTIFF-tiedosto löytyy täältä: **/koulutus/ilmakuvat_geotiff/L4133A.tif**. +Seuraa edellisen kohdan ohjeita ja lisää samalta alueelta ilmakuva. GeoTIFF-tiedosto löytyy täältä: **/koulutus/nlsfi/Ortokuvat/L4133A.tif**. Nimeä seuraavasti: \ store: **hki_ilmakuva\ @@ -73,14 +71,14 @@ Edellisen ilmakuvan kansiossa on muutamia ilmakuvia Helsingistä. Aineisto on la Luo uusi store **helsinki** workspaceen. Valitse formaatiksi **ImageMosaic - Image mosaicking plugin**. -Selaa kansioon **/koulutus/ilmakuvat_geotiff/** ja paina **OK**. Täten, kaikki kuvat kansiossa yhdistetään yhteen ja mosaiikkia käsitellään sen jälkeen yhtenä tasona. +Selaa kansioon **/koulutus/nlsfi/Ortokuvat/** ja paina **OK**. Täten, kaikki kuvat kansiossa yhdistetään yhteen ja mosaiikkia käsitellään sen jälkeen yhtenä tasona. Anna nimi ja selitys esimerkiksi seuraavan kuvan mukaisella tavalla: ![](img/harjoitus_6/image6.png) Paina sitten **Save** ja sen jälkeen julkista taso painamalla **Publish**. -Laita tason nimeksi **ilmakuvat_keskusta** ja otsikoksi **Helsingin keskustan ilmakuvat**. Lisätiedoksi voit kirjoittaa esimerkiksi **Helsingin ilmakuvat - Maanmittauslaitos 2014**. Tarkista tason editointinäkymästä, että **Enabled** ja **Advertised** ovat rastitettuna. +Laita tason nimeksi **ilmakuvat** ja otsikoksi **Helsingin keskustan ilmakuvat**. Lisätiedoksi voit kirjoittaa esimerkiksi **Helsingin ilmakuvat - Maanmittauslaitos 2014**. Tarkista tason editointinäkymästä, että **Enabled** ja **Advertised** ovat rastitettuna. ![](img/harjoitus_6/image7.png) Huomaa, että GeoTIFF-tiedoston koordinaattijärjestelmän tiedot (EPSG:3067) ja aineiston laajuus on tässä määrittynyt oikein automaattisesti (oletusarvojen mukaisesti). @@ -93,17 +91,18 @@ Psst! Kuten aiemmin mainittiin, GeoServer pyrkii tulkitsemaan alkuperäisen aine Paina lopuksi **Save**. Tarkista, että uusi taso löytyy **Data → Layers** -näkymältä. Voit myös esikatsella sitä tuttuun tapaan käyttäen **Data → Layers Preview**. + ![](img/harjoitus_6/image9.png) ## **Layer Groups** GeoServerin tasoja ja/tai aiemmin luotuja tasoryhmiä voidaan ryhmittää. Tasoryhmissä voi yhdistää eri vektori- ja rasteriformaatteja. Yksi selkeä käyttötapaus on taustakartan julkaiseminen yhtenä WMS-tasopalveluna.  -Luodaan nyt tasoryhmä käyttäen aiemmin palvelimelle lisättyjä **ilmakuvat_keskusta-**, **rakennukset-** ja **tiesto**-tasoja. +Luodaan nyt tasoryhmä käyttäen aiemmin palvelimelle lisättyjä **ilmakuvat-**, **rakennukset-** ja **tiesto**-tasoja. Valitse päävalikosta **Data → Layer Groups** ja sitten **Add new layer group**. -Laita ryhmätason nimeksi **taustakartta** ja otsikoksi **Helsingin taustakartta**. Lisää **Abstract**-kentälle \"Helsingin keskustan taustakartta\". +Laita ryhmätason nimeksi **taustakartta** ja otsikoksi **Helsingin taustakartta**. Lisää **Abstract** kentälle \"Helsingin keskustan taustakartta\". ::: hint-box Psst! Joissain selaimissa ääkkösten käyttö ei välttämättä onnistu. Vältä ääkkösten käyttöä tasojen nimissä ja otsikoissa. @@ -111,9 +110,10 @@ Psst! Joissain selaimissa ääkkösten käyttö ei välttämättä onnistu. Väl Valitse **helsinki** workspace:ksi. -Selaa sivua alaspäin, paina **Add Layer...** ja lisää **ilmakuvat_keskusta**-taso. Taso on nyt lisätty **Layers**-listalle. +Selaa sivua alaspäin, paina **Add Layer...** ja lisää **ilmakuvat**-taso. Taso on nyt lisätty **Layers**-listalle. Paina **Generate Bounds** ja huomaa, kuinka tason alkuperäinen koordinaatistojärjestelmä ja laajuus on nyt määritettynä niille kuuluvissa kentissä. Pidetään ryhmätason järjestelmänä **ETRS89 / TM35FIN**. + ![](img/harjoitus_6/image10.png) Lisää samalla tavalla Helsingin **rakennukset**- ja **tiesto**-tasot. @@ -122,7 +122,7 @@ Huomaa, että voit järjestää tasot käyttämällä **Drawing order** -nuolia. ![](img/harjoitus_6/image11.png) -Varmista, että **Default Style** -ruudut ovat rastitetut. +Varmista, että **Default Style** ovat rastittuina. Paina lopulta uudelleen **Generate Bounds** päivittämään ryhmätason laajuustiedot, jotta myös uudet aineistot otetaan huomioon laajuustietojen määrittämisessä. Aina kun lisäät uutta aineistoa tasoryhmään tulisi painaa uudelleen **Generate Bounds** päivittääksesi ryhmätason laajuustiedot. @@ -148,7 +148,7 @@ Pidä oletus **Single** valittuna. Se asettaa WMS-tasot näkyville yhtenä tason Pidä loput asetukset oletuksina ja paina lopuksi **Save**. Ryhmätasoja voidaan esikatsella samalla tavalla kuin muita tasoja. Mene **Layer Preview** -näkymään ja avaa uuden ryhmätason esikatselutila OpenLayers-linkin avulla. Huomaa, että oletuskuvaustekniikka on käytössä. Tämän ryhmätason kuvaustekniikkaa parannetaan vielä myöhemmin. -Kun olet saanut ryhmätason valmiiksi, voit palata ryhmätason asetuksiin ja kokeilla muita **Mode**-asetuksia. Seuraavat esimerkkikuvat ovat QGISin WMS-palvelun työkalusta. . +Kun olet saanut ryhmätason valmiiksi, voit palata ryhmätason asetuksiin ja kokeilla muita **Mode**-asetuksia. Seuraavat esimerkkikuvat ovat QGISin WMS-palvelun työkalusta. **Mode → Single** näyttää tältä: ![](img/harjoitus_6/image13.png) @@ -170,7 +170,7 @@ Lisää uusi store (**Data → Stores → Add new Store**), valitse **WMS**-list Lisätään Helsingin kaupungin avoimet paikkatietopalvelut GeoServeriimme uudeksi WMS-yhteydeksi (remote WMS connection). Kyseinen Helsingin kaupungin palvelu löytyy osoitteesta:  ::: note-box - [https://kartta.hel.fi/ws/geoserver/avoindata/wms?REQUEST=Getcapabilities](https://kartta.hel.fi/ws/geoserver/avoindata/wms?REQUEST=Getcapabilities). + [**https://kartta.hel.fi/ws/geoserver/avoindata/wms?REQUEST=Getcapabilities**](https://kartta.hel.fi/ws/geoserver/avoindata/wms?REQUEST=Getcapabilities). ::: Täytä tiedot seuraavan kuvan mukaisesti, laita yllä oleva osoite **Capabilities URL** -kenttään: @@ -178,7 +178,7 @@ Täytä tiedot seuraavan kuvan mukaisesti, laita yllä oleva osoite **Capabiliti Loput asetukset voit jättää oletuksiin. Paina sitten **Save**. -Seuraavaksi voit julkaista tasoja suoraan palvelusta. Julkaise esimerkiksi **Ajantasa_asemakaava**. +Seuraavasti voit julkaista tasoja suoraan siitä palvelusta. Julkaise esimerkiksi **Ajantasa_asemakaava**. ![](img/harjoitus_6/image17.png) Uuden tason oletusasetukset ovat oikein. Selaa sivun loppuun ja paina **Save**. @@ -187,5 +187,6 @@ Voit nyt esikatsella uutta tasoa samalla tavalla kuin aiemmin: ![](img/harjoitus_6/image18.png) ::: hint-box -Psst! Huomaa, että WMS-cascade-tasojen tyyliin tai sisältöön ei voida vaikuttaa, sillä ne ovat Helsingin kaupungin omassa palvelimessa. Helsingin kaupungin paikkatietopalvelujen metatietoihin voit tutustua täällä: http://ptp.hel.fi/avoindata/aineistot/Aineistolista_wms_avoindata_ulkoverkko.html. +Psst! Huomaa, että WMS-cascade-tasojen tyyliin tai sisältöön ei voida vaikuttaa, sillä ne ovat Helsingin kaupungin omassa palvelimessa. +Helsingin kaupungin paikkatietopalvelujen metatietoihin voit tutustua tässä: http://ptp.hel.fi/avoindata/aineistot/Aineistolista_wms_avoindata_ulkoverkko.html. ::: diff --git a/src/GS006/07_harjoitus_7.Rmd b/src/GS006/07_harjoitus_7.Rmd index 1144e8a1..3df1b328 100644 --- a/src/GS006/07_harjoitus_7.Rmd +++ b/src/GS006/07_harjoitus_7.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 1.7: Paikkatietokannat +# HARJOITUS 1.7: PAIKKATIETOKANNAT **Harjoituksen sisältö** @@ -14,12 +14,6 @@ Harjoituksen jälkeen opiskelija osaa yhdistää paikkatietokannan tietoja GeoSe ## **Valmistautuminen** -Käynnistä koneessa web-selain ja kirjaudu osoitteeseen: - -::: note-box - -::: - Palvelinkoneeseen on asennettu PostgreSQL-tietokanta ja sen PostGIS-laajennos. Tietokantaan on ladattu valmiiksi erilaisia vektoriaineistoja. ## **Yhteyden muodostaminen paikkatietokantaan** @@ -41,20 +35,19 @@ Valitse **Workspaceksi** tuttu **helsinki**-workspace ja nimeä se **hki_lipas** Täytä sitten PostGIS-tietokannan **Connection Parameters** -yhteysasetukset seuraavasti: + +--------------------+---------------+ -| ##### **Dbtype** | postgis | -+--------------------+---------------+ -| ##### **Host** | localhost | +| ##### **host** | postgres | +--------------------+---------------+ -| ##### **Port** | 5432 | +| ##### **port** | 5432 | +--------------------+---------------+ -| ##### **Database** | gs_training | +| ##### **database** | gs_training | +--------------------+---------------+ -| ##### **Schema** | lipas | +| ##### **schema** | lipas | +--------------------+---------------+ -| ##### **User** | postgres | +| ##### **user** | postgres | +--------------------+---------------+ -| ##### **Passwd** | gispo | +| ##### **passwd** | gispo | +--------------------+---------------+ Jätä loput asetukset oletuksiin ja paina lopulta **Save**. @@ -78,16 +71,18 @@ Tason editoinnin näkymässä, tason nimi ja otsikko on automaattisesti täytett Tarkista, että **Enabled** ja **Advertised** ovat rastittuina. -Kuten olet varmasti jo huomannut, uuden tason asetukset ovat samanlaiset, oli kyseessä sitten shapefile-formaatti tai PostGIS-tietokanta. +Kuten olet varmasti nyt huomannut, uuden tason asetukset ovat samanlaiset, oli kyseessä sitten shapefile-formaatti tai PostGIS-tietokanta. Katso vielä **Coordinate Reference Systems** -osiosta, että GeoServer on tunnistanut koordinaattijärjestelmäksi **EPSG:3067**. PostGIS ja GeoServer käyttävät EPSG-koodeja määrittääkseen koordinaattijärjestelmän, joten useimmiten koordinaattijärjestelmä tulee oikein määritellyksi automaattisesti. ![](img/harjoitus_7/image4.png) Ennen kuin tallennetaan tason julkaisuasetukset, määritä tason **Bounding Boxes** samalla tavalla kuin aikaisemmin lisäämiesi aineistojen kanssa. + ![](img/harjoitus_7/image5.png) -Paina lopulta **Save**. Voit esikatsella uutta tasoa **Layer Preview**:n kautta.\ +Paina lopulta **Save**. Voit esikatsella uutta tasoa **Layer Preview**:n kautta. + ![](img/harjoitus_7/image6.png) ## **Monikulmio- ja viiva-tason lisääminen PostGIS-tietokannasta** @@ -109,7 +104,7 @@ Mitkä vaiheet ovat pakollisia tason julkaisemiseksi? Mitkä ovat tasojen koordi Vaihda lopuksi oletustyylit kyseisille tasoille käyttäen GeoServerin valmiita kuvaustekniikoita (default styles). Voit vaihtaa tason tyylin päävalikosta **Data → Layers** ja avaamalla haluamasi tason. Tyylit määritellään **Publish** välilehdestä. Käytä seuraavia tyylejä: +--------------------------+-----------------+ -| **Taso** | **Tyyli** | +| ##### **Taso** | ##### **Tyyli** | +==========================+=================+ | **lipas_kaikki_pisteet** | burg | +--------------------------+-----------------+ @@ -140,6 +135,7 @@ SQL-kyselyjen tekemiseksi on hyvä ensin selvittää tietokannan taulujen kentti Aineiston tarkastelemisen jälkeen voidaan päätellä, että paikkakuntatieto löytyy **kunta_nimi**-kentästä. Avaa **Data → Layers → Add new layer** ja valitse **helsinki:hki_lipas**. Painamalla **Configure new SQL view...** pääset määrittelemään SQL-kielellä, mitkä tiedot haluat julkaista kyseisestä aineistosta. + ![](img/harjoitus_7/image9.png) Määrittele näkymän nimeksi **lipas_kaikki_reitit_helsinki**. Kirjoita **SQL statement** -kenttään seuraavaa SQL-lauseke: @@ -147,12 +143,12 @@ Määrittele näkymän nimeksi **lipas_kaikki_reitit_helsinki**. Kirjoita **SQL ::: code-box SELECT \* -FROM lipas.reitit +FROM lipas.lipas_kaikki_reitit -WHERE kunta_nimi = 'Helsinki' +WHERE kunta_nimi = \'Helsinki\' ::: -Rastita **Guess geometry type and srid** -toiminto ja paina sitten **Refresh**. Huomaa, että olla olevassa kuvassa on virhe SQL-kyselyssä. Ole tarkkana! kunta_nimi_fi-tekstin sijaan siinä pitäisi lukea vain kunta_nimi. +Rastita **Guess geometry type and srid** -toiminto ja paina sitten **Refresh**. ![](img/harjoitus_7/image10.png) Tarkista sitten, että **geom**-nimisen kentän kohdalla **SRID** on määritelty oikean EPSG-tunnuksen mukaisesti (meidän tapauksessamme tunnus on **3067**). @@ -168,7 +164,7 @@ Määrittele seuraavaksi tason ulottuvuudet (Bounding Box) ja paina **Save**. Vo Voit käyttää SQL-lausekkeissa myös paikkatietofunktioita. Käytetään esimerkkinä vyöhyke-funktiota (ST_Buffer). -Avaa taso  **lipas_kaikki_reitit_helsinki** uudelleen (**Data → Layers**). +Avaa tason **lipas_kaikki_reitit_helsinki** uudelleen (**Data → Layers**). Selaa **Data** välilehdessä sivun loppuun. Sieltä löytyy **Edit sql view** -toiminto. @@ -177,9 +173,9 @@ Päivitä **SQL statement** seuraavaksi: ::: code-box SELECT ST_Union (ST_Buffer ( geom, 10 )) -FROM lipas.reitit +FROM lipas.lipas_kaikki_reitit -WHERE kunta_nimi = 'Helsinki' +WHERE kunta_nimi = \'Helsinki\' ::: Päivitä taas attribuuttien formaatti ja paina sitten **Save**. diff --git a/src/GS006/08_harjoitus_8.Rmd b/src/GS006/08_harjoitus_8.Rmd index 374d1811..3b2795fe 100644 --- a/src/GS006/08_harjoitus_8.Rmd +++ b/src/GS006/08_harjoitus_8.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 2.1: WFS-palvelut +# HARJOITUS 2.1: WFS-PALVELUT **Harjoituksen sisältö** @@ -148,7 +148,7 @@ Esimerkiksi **Lipas-alueet**-taso GML2-esikatselusta (EPSG-koodi muodossa OGC HT ## **Workspace-kohtaiset asetukset** -Samalla tavalla kun WMS-palvelujen kanssa, myös WFS-asetuksia on mahdollista määrittää workspace-kohtaisesti. Esimerkiksi WFS-T toiminnallisuus voidaan sallia vain yhden workspacen kautta ja pääsynhallinnan avulla sallia vain tunnistetut käyttäjät muokkaamaan aineistoja. +Samalla tavalla kun WMS-palvelujen kanssa, myös WFS-asetuksia on mahdollista määrittää workspace-kohtaisesti. Esimerkiksi WFS-T-toiminnallisuus voidaan sallia vain yhden workspacen kautta ja pääsynhallinnan avulla sallia vain tunnistetut käyttäjät muokkaamaan aineistoja. Avaa **Data → Workspaces** ja valitse sitten **helsinki**-workspace. Rastita sitten **Services → WFS** ja paina sen jälkeen **WFS**-linkkiä. @@ -162,11 +162,11 @@ Paina sen jälkeen **Submit** (sivun lopussa). Paina lopuksi vielä **Save** sivun alaosasta. -Workspace-kohtaisilla asetuksilla voidaan esim. rajoittaa, missä koordinaattijärjestelmissä workspacen aineistot ovat saatavilla, tai poistaa WFS-T -palvelu tietyn workspacen aineistoista. +Workspace-kohtaisilla asetuksilla voidaan esim. rajoittaa, missä koordinaattijärjestelmissä workspacen aineistot ovat saatavilla, tai poistaa WFS-T-palvelu tietyn workspacen aineistoista. ## **Editointi WFS-T-palvelun kautta** -Yksi tärkeä ominaisuus WFS-palveluissa on mahdollisuus editoida vektoriaineistoja suoraan palvelimessa. WFS-T-palvelulle voidaan myös asettaa lukitusmahdollisuus (**Complete** service -taso), joka on tarpeellinen tehdessä editointeja jaetulla aineistolla. +Yksi tärkeä ominaisuus WFS-palveluissa on mahdollisuus editoida vektoriaineistoja suoraan palvelimessa. WFS-T-palvelulle voidaan myös asettaa lukitus-mahdollisuus (**Complete** service-taso), joka on tarpeellinen tehdessä editointeja jaetulla aineistolla. Editointia voidaan tehdä eri client-ohjelmistojen avulla, esimerkiksi QGISin tai web-sovellusten kautta. @@ -177,13 +177,15 @@ Tarvitaan ensin WFS-palvelun osoite. Saat tämän esimerkiksi GeoServerin etusiv Osoite on muotoa: ::: note-box - + ::: +Huomaa, että yllä olevassa laatikossa **ip.osoite** kohdassa kuuluu olla oma ip-osoitteesi. + GeoServerin oletusasetuksilla workspace-kohtaisen osoitteen saa lisäämällä osoitteeseen workspacen URI:n. Esimerkiksi helsinki-workspacen osoite olisi: ::: note-box - + ::: Avaa QGIS työpöydän pikakuvakkeesta. Lisää uusi WFS-palvelu ja liitä URL-kenttään äsken kopioimasi osoite. Syötä myös käyttäjänimi (admin) sekä salasana (gispo). @@ -192,7 +194,7 @@ Avaa QGIS työpöydän pikakuvakkeesta. Lisää uusi WFS-palvelu ja liitä URL-k Tarvittaessa, seuraa kouluttajan ohjeita **QGISin** käytössä. Yhdistä QGIS omaan WFS-karttapalveluusi, lisää karttaprojektiin **lipas_kaikki_reitit**-taso, jonka lisäsit aiemmin toisessa harjoituksessa. Editoi joitakin paikkatietokohteita ja tallenna muutokset. -Katso jälkeenpäin GeoServerin esikatselusta editoimasi kohteet ja totea, että muutokset ovat todella tallentuneet palvelimelle. +Katso jälkeenpäin GeoServerin esikatselusta editoimasi kohteet ja totea, että muutokset ovat todella tallentuneet palvelimeen. ## **Muiden WFS-palvelujen hyödyntäminen (cascading WFS)** @@ -202,17 +204,17 @@ Lisää uusi store (**Data → Stores → Add new Store**), valitse **Web Featur ![](img/harjoitus_8/image9.png) -Lisätään Lipas-WFS palvelu. Nimeä uusi vektori-store **lipas_WFS** ja laita **WFS GetCapabilities URL** -arvoksi: +Lisätään Lipas-WFS palvelu. Nimeä uusi vektori-store **lipas_WFS** ja laittaa **WFS GetCapabilities URL** arvoksi: ::: note-box - + ::: ![](img/harjoitus_8/image10.png) Loput asetukset voit jättää oletusarvoihin. Paina sitten **Save**. -Uusi store sisältää karttatasoja, jotka on jaettu alkuperäisessä WFS-palvelimessa: +Uusi store sisältää karttatasoja, jotka on jaettu alkuperäisessä  WFS-palvelimessa: ![](img/harjoitus_8/image11.png) @@ -225,5 +227,5 @@ Voit nyt esikatsella uutta tasoa (oletusnimeksi tulee **retkikartta_reitit**). ![](img/harjoitus_8/image12.png) ::: hint-box -Psst! Jos aineisto on suuri ja maksimilatausaika on määritelty alhaiseksi, GeoServer voi tuottaa error-koodin, kun aineistoa ei saada ladattua määrättyyn aikaan mennessä. Muuta maksimilatausaikaa, mikäli aineisto on suuri. +Psst! Mikäli aineisto on suuri ja maksimilatausaika on määritelty alhaiseksi, GeoServer voi tuottaa error-koodin kun aineistoa ei saada ladattua määrättyyn aikaan mennessä. Muuta tätä aikaa, mikäli aineisto on suuri. ::: diff --git a/src/GS006/09_harjoitus_9.Rmd b/src/GS006/09_harjoitus_9.Rmd index a548107d..ed4792dd 100644 --- a/src/GS006/09_harjoitus_9.Rmd +++ b/src/GS006/09_harjoitus_9.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 2.2: Karttatiilipalvelut +# HARJOITUS 2.2: KARTTATIILIPALVELUT **Harjoituksen sisältö** @@ -24,9 +24,9 @@ Avaa **Tile Caching → Caching defaults** ja tarkista, mitkä karttatiilipalvel ![](img/harjoitus_9/image1.png) -Oletuksena aktivoituna ovat **WMS-C**- (WMS Service-Cached) ja **TMS** (Tile Map Service)-karttatiilipalvelut. +Oletuksena aktivoituna ovat **WMS-C**- (WMS Tile Caching) ja **TMS** (Tile Map Service)-karttatiilipalvelut. -Avaa vielä **Tile Caching → Tile Layers** ja huomaa myös, että kaikille tasoille on automaattisesti luotu oma karttatiilitaso.\ +Avaa vielä **Tile Caching → Tile Layers** ja huomaa myös, että listalta löytyy jo tiilitettyjä tasoja.\ ![](img/harjoitus_9/image2.png) ## **GeoWebCache-käyttöliittymä** @@ -56,7 +56,7 @@ Valitse sitten **Tile Caching**. Oletusasetukset on määritelty siten, että kaikille uusille tasoille luodaan automaattisesti karttatiilet. Myös sekä jpeg- että png-kuvatiilet ovat oletuksena aktivoituna. -Selaa vielä tämän näkymän alaosaan, josta selviää **Available gridsets** -osiosta, että kaksi eri karttatiiliruudukkoa on oletuksena käytössä: **EPSG:4326** (WGS 84) ja **EPSG:900913** (Google Mercator): ![](img/harjoitus_9/image7.png) +Selaa vielä tämän näkymän alaosaan, josta selviää **Available gridsets** -osiosta, mitkä karttatiiliruudukot ovat oletuksena käytössä: ![](img/harjoitus_9/image7.png) ::: hint-box Psst! Tasokohtaisia tiilitysasetuksia pääset myös muokkaamaan Data → Layers näkymän kautta valitsemalla tason ja sen jälkeen Tile Caching -välilehden. @@ -72,49 +72,59 @@ Palaa **Tile Caching → Tile Layers** näkymään. Tältä sivulta voit myös e Valitse nyt **Seed/Truncate** -linkki Helsingin ilmakuvien tason karttatiilien luomista varten. -**GeoWebCache**-näkymässä sivun yläosasta löytyy yleisiä toimintoja ja lista meneillään olevista tehtävistä. Karttatiilien luominen on hyvin resurssi-intensiivinen ja kohtuullisia levytiloja vaativa prosessi. On myös tyypillistä, että tehtävien eli karttatiilien luominen voi kestää hyvinkin pitkään (tunteja, jopa päiviä). Sivun tiedot päivitetään käyttämällä **Refresh list** -toimintoa. +**GeoWebCache**-näkymässä sivun yläosasta löytyy yleisiä toimintoja ja lista meneillään olevista tehtävistä. Karttatiilien luominen on hyvin resurssi-intensiivinen ja kohtuullisia levytiloja vaativa prosessi. On myös tyypillistä, että tehtävien eli karttatiilien luominen voi kestää hyvinkin pitkään (tunteja, jopa päiviä). Sivun tiedot päivitetään käyttämällä **Refresh list** -toimintoa. ![](img/harjoitus_9/image9.png) Tiilien luomista varten asetukset löytyvät sivun alapuolelta **Create a new task** -osiosta. -+----------------------------+----------------------------------------------------------------------------------------------+ -| **Number of tasks to use** | Määrittää kuinka monta prosessia käynnistetään karttatiilien luomiseksi | -+----------------------------+----------------------------------------------------------------------------------------------+ -| **Type of operation** | Tiilien luomisen toimintotapa | -| | | -| | Reseed: luodaan kaikki karttatiilet, korvataan vanhat karttatiilet | -| | | -| | Seed: luodaan vain puuttuvat karttatiilet | -| | | -| | Truncate: poistetaan karttatiilet palvelimesta | -+----------------------------+----------------------------------------------------------------------------------------------+ -| **Grid set** | Määrittää mille karttatiiliruudukolle luodaan karttatiilet | -+----------------------------+----------------------------------------------------------------------------------------------+ -| **Format** | Karttakuvan tiedostomuoto (esim. jpg, png) | -+----------------------------+----------------------------------------------------------------------------------------------+ -| **Zoom start, Zoom stop** | Mittakaavavälit luotavalle karttatiilille (mittakaavat on määritelty karttatiiliruudukoille) | -+----------------------------+----------------------------------------------------------------------------------------------+ -| **Bounding box** | Sijainnin suorakaiderajaus, jolta karttatiilet luodaan | -+----------------------------+----------------------------------------------------------------------------------------------+ ++-----------------------------------+----------------------------------------------------------------------------------------------+ +| **Number of tasks to use** | Määrittää kuinka monta prosessia käynnistetään karttatiilien luomiseksi | ++-----------------------------------+----------------------------------------------------------------------------------------------+ +| **Type of operation** | Tiilien luomisen toimintotapa | +| | | +| | Reseed: luodaan kaikki karttatiilet, korvataan vanhat karttatiilet | +| | | +| | Seed: luodaan vain puuttuvat karttatiilet | +| | | +| | Truncate: poistetaan karttatiilet palvelimesta | ++-----------------------------------+----------------------------------------------------------------------------------------------+ +| **Grid set** | Määrittää mille karttatiiliruudukolle luodaan karttatiilet | ++-----------------------------------+----------------------------------------------------------------------------------------------+ +| **Format** | Karttakuvan tiedostomuoto (esim. jpg, png) | ++-----------------------------------+----------------------------------------------------------------------------------------------+ +| **Zoom start, Zoom stop** | Mittakaavavälit luotavalle karttatiilille (mittakaavat on määritelty karttatiiliruudukoille) | ++-----------------------------------+----------------------------------------------------------------------------------------------+ +| **Modifiable Parameters** | Kertoo mitkä WMS-pyynnön muuttujat vaikuttavat tiilien ulkoasuun ja pitää siksi huomioida | ++-----------------------------------+----------------------------------------------------------------------------------------------+ +| **Bounding box** | Sijainnin suorakaiderajaus, jolta karttatiilet luodaan | ++-----------------------------------+----------------------------------------------------------------------------------------------+ +| **Tile failure retries** | Montako kertaa yritetään luoda tiiltä jos sen luonti epäonnistuu | ++-----------------------------------+----------------------------------------------------------------------------------------------+ +| **Pause before retry (ms)** | Epäonnistuneen luonnin jälkeen pidettävä tauko (millisekunneissa) | ++-----------------------------------+----------------------------------------------------------------------------------------------+ +| **Total failures before aborting**| Montako epäonnistunutta tiilenluontikertaa, kunnes lopetetaan koko prosessi | ++-----------------------------------+----------------------------------------------------------------------------------------------+ -Aseta **Number of tasks to use** -asetukseksi 1. +\ ::: hint-box -Psst! 2\*tietokoneen_suorittimien_lukumäärä on hyvä lähtökohta kokeilulle. +Psst! Jos et tiedä mitä voit laittaa kohtaan "Number of tasks to use", 2\*tietokoneen_suorittimien_lukumäärä on hyvä lähtökohta kokeilulle. ::: +Aseta **Number of tasks to use** -asetukseksi 1. + Aseta tehtävän asetukset seuraavalla tavalla, huomaa erityisesti **Zoom stop** -asetus. Laita arvoksi 15, niin lasketaan valmiiksi mittakaavatasot 0-15: Paina **Submit**. -GeoServer (GeoWebCache) muodostaa nyt karttatiilet valitusta palvelusta mittakaavatasoista 0--15. +GeoServer (GeoWebCache) muodostaa nyt karttatiilet valitusta palvelusta mittakaavatasoista 0–15. Muodostamisen ajan käyttöliittymässä voi seurata karttatiilien valmistumista: Paina **Refresh list** -linkkiä, kun haluat päivittää tiedot laskennan etenemisestä. -Karttatiiliruudukon määritelmä ja tason sijainnin rajauksen mukaan mittakaavoille 0-15 tarvitaan 1 922 karttatiiltä. Kuvien piirtäminen kestää etäpalvelimella näillä asetuksilla minuutin verran.\ +Karttatiiliruudukon määritelmän ja tason sijainnin rajauksen mukaan mittakaavoille 0–15 tarvitaan 1 090 karttatiiltä. Kuvien piirtäminen kestää etäpalvelimella näillä asetuksilla minuutin verran.\ ![](img/harjoitus_9/image10.png) Huomaa, että karttatiilet luodaan oletuksena tason sijainnin rajauksen mukaisesti (ellei sitä toisin ole määritelty). ![](img/harjoitus_9/image11.png) @@ -122,29 +132,27 @@ Huomaa, että karttatiilet luodaan oletuksena tason sijainnin rajauksen mukaises Laske vielä karttatiilet **tasolle 16** (määrittele zoomaus aloitus- ja lopputasoksi 16). Päivitä laskennan aikana sivua ja tutki karttatiilien luomisen etenemistä.\ ![](img/harjoitus_9/image12.png) -Jos erehdyt määrittelemään vääriä asetuksia, voit pysäyttää laskennan käyttämällä **Kill all Tasks...** -toimintoa painamalla **Submit**-näppäintä. - -![](img/harjoitus_9/image13.png) +Jos erehdyt määrittelemään vääriä asetuksia, voit pysäyttää laskennan käyttämällä **Kill all Tasks...** -toimintoa painamalla **Submit**-näppäintä. ![](img/harjoitus_9/image13.png) -Taso 16 vastaa mittakaavaa 1:4 262. Kaikkiaan sen tiilittämiseen tarvitaan 3 700 karttatiiliä, joiden luomiseen menee noin pari minuuttia. Laske vielä taso 17 samalla tavalla ja kirjoita muistiinpanot prosessorimäärästä, karttatiilistä sekä ajasta. +Taso 16 vastaa mittakaavaa 1:4 261. Kaikkiaan sen tiilittämiseen tarvitaan 1 936 karttatiiliä, joiden luomiseen menee noin pari minuuttia. Laske vielä taso 17 samalla tavalla ja kirjoita muistiinpanot prosessorimäärästä, karttatiilistä sekä ajasta. -Taso 17 näyttää kartalla tältä: - -![](img/harjoitus_9/image14.png) +Taso 17 näyttää kartalla tältä: ![](img/harjoitus_9/image14.png) ## **Karttatiilien kovalevyn käyttö** -Edellisessä kohdassa laskettiin karttatiiliä vain yhdelle tasolle (**ilmakuvat_keskusta**), vain yhteen karttatiiliruudukkoon (**EPSG:4326**) ja vain yhdelle kuvaformaatille (**png**). Tämän karttatason mittakaavatason 16 karttatiilet vievät noin 300 MB levytilaa. +Edellisessä kohdassa laskettiin karttatiiliä vain yhdelle tasolle (**ilmakuvat**), vain yhteen karttatiiliruudukkoon (**EPSG:4326**) ja vain yhdelle kuvaformaatille (**png**). Tämän karttatason mittakaavatason 16 karttatiilet vievät noin 240 MB levytilaa. Karttatasoilla saattaa olla useita karttatiilipalveluita riippuen siitä, kuinka monta karttatiiliruudukkoa ja kuvatyyppiä on tason tiilitysasetuksissa määritelty. Karttatiilien luominen kannattaa suunnitella etukäteen ja toteuttaa huolellisesti. Yksi tärkeä asetus karttatiilipalveluissa on karttatiilien kovalevyn käytön tarkkaileminen ja hallinnointi. Siihen on GeoWebCache:ssa erilaisia asetuksia ja osaa niistä voi säätää suoraan GeoServeristä. -Avaa **Tile Caching → Tile Layers** -näkymästä **ilmakuvat_keskusta** tason asetukset. Avaa vielä **Tile Caching** välilehti. +Avaa **Tile Caching → Tile Layers** -näkymästä **ilmakuvat** tason asetukset. Avaa vielä **Tile Caching** välilehti. + +Sivun asetuksista voit tarkistaa, että sekä **jpeg**- että **png**-kuvaformaatit ovat rastitettuina. Sen lisäksi on määritelty **neljä eri karttatiiliruudukkoa** käytettäväksi. Tämä tarkoittaa sitä, että tämä taso on saatavilla kahdeksalla eri karttatiilitasolla. Äskettäin laskettiin valmiiksi karttatiiliä vain yhdelle. -Sivun asetuksista voit tarkistaa, että sekä **jpeg**- että **png**-kuvaformaatit ovat rastitettuina. Sen lisäksi on määritelty **kaksi eri karttatiiliruudukkoa** käytettäväksi. Tämä tarkoittaa sitä, että tämä taso on saatavilla kuudella eri karttatiilitasolla. Äskettäin laskettiin valmiiksi karttatiiliä vain yhdelle. +Voit tarkistaa kovalevyn käytön tasokohtaisesti **Tile Caching → Tile Layers** -näkymästä. Huomaa kuitenkin, että oletusasetuksilla tämä tieto ei ole saatavilla (**N/A**). -Voit tarkistaa kovalevyn käytön tasokohtaisesti **Tile Caching → Tile Layers** -näkymästä. Huomaa kuitenkin, että oletusasetuksilla tämä tieto ei ole saatavilla (**N/A**). ![](img/harjoitus_9/image15.png) +![](img/harjoitus_9/image15.png) Tiedon näkymiseksi pitää ensin määrittää, kuinka paljon kovalevytilaa karttatiilipalvelulla on lupa käyttää. Oletuksena GeoWebCache voi käyttää koko palvelimen levytilan. @@ -152,7 +160,7 @@ Palataan hetkeksi takaisin näkymään **Tile Caching** → **Disk Quota**. Rast ![](img/harjoitus_9/image16.png) -Paina lopulta **Submit**, niin asetukset tulevat tallennetuksi. +Paina lopulta **Save**, niin asetukset tulevat tallennetuksi. ::: hint-box Psst! Käyttöliittymässä käytetään lyhenteitä GiB ja GB. Niiden ero tulee siitä, että GiB (Gibibyte) on binäärijärjestelmä monikerta kun GB (Gigabyte) on kymmenjärjestelmä monikerta: GiB on 1024 MiB ja tavuina 230 tavua → eli 1 073 741 824 tavua GB on 1000 MB ja tavuina 109 tavua → eli 1 000 000 000 tavua @@ -160,33 +168,32 @@ Psst! Käyttöliittymässä käytetään lyhenteitä GiB ja GB. Niiden ero tulee Huomaa vielä, että **When enforcing disk quota limits, remove tiles that are** -asetus tarkoittaa se, että GeoServer/GeoWebCache ei lopeta karttatiilien luomista, vaikka määritelty maksimi-karttatiilien levykäyttö saavutettaisiin. Sallitun levytilan täyttymisen jälkeen palvelin alkaa poistaa automaattisesti joko vähiten tai pitkän aikaan käyttämättä olleita karttatiiliä. Karttatiiliä tuotetaan siis jatkuvasti, vaikka maksimilevytilan raja tulisikin täyteen. -Paina **Submit** ja palaa **Tile Caching → Tile Layers -**näkymään. +Paina **Save** ja palaa **Tile Caching → Tile Layers -**näkymään. -Tarkista, että nyt **Disk Used** -sarakkeessa näkyy tarvittavat tiedot. Ilmakuvien karttatiilet vievät tällä hetkellä alle 500 megatavua. Muut tasot eivät käytä yhtään levytilaa. ![](img/harjoitus_9/image17.png) +Tarkista, että nyt **Disk Used** -sarakkeessa näkyy tarvittavat tiedot. Ilmakuvien karttatiilet vievät tällä hetkellä yli 700 megatavua. Muut tasot eivät käytä yhtään levytilaa. ![](img/harjoitus_9/image17.png) Karttatiilet tulevat myös tallennetuksi automaattisesti aina karttatiilipalvelun luodessa karttatiiliä. Kokeile esikatsella eri tasojen karttatiilitasoja (**Tile Caching** → **Tile Layers** → **Preview**). Esimerkiksi rakennukset- ja taustakartta-tasoja. ![](img/harjoitus_9/image18.png) Voidaan todeta, että sen jälkeen myös niiden kohdalla **Disk Used** -sarakkeessa on tietoa levytilan käytöstä. Niiden levytilan käyttö kasvaa sitä mukaan kun eri kartta-alueita ja tiilitasoja käytetään. ![](img/harjoitus_9/image19.png) -Edellisessä kohdassa laskettiin muutama karttatiilitasoja. Esimerkiksi Helsingin ilmakuvien mittakaavatason 16 karttatiilet vievät levytilaa reilut 300 megatavua. +Edellisessä kohdassa laskettiin muutamia karttatiilitasoja. Esimerkiksi Helsingin ilmakuvien mittakaavatason 16 karttatiilet vievät levytilaa yli 200 megatavua. -Tasojen käyttämää levytilaa voidaan myös vapauttaa. Voit halutessasi tyhjentää tietyn tason kaikki karttatiilet käyttäen tason **Empty**-linkkiä. Kokeile tyhjentää **hki-rakennukset**-tason karttatiilet. +Tasojen käyttämää levytilaa voidaan myös vapauttaa. Voit halutessasi tyhjentää tietyn tason kaikki karttatiilet käyttäen tason **Empty**-linkkiä. Kokeile tyhjentää **rakennukset**-tason karttatiilet. On mahdollista myös tyhjentää ainoastaan tietyn mittakaavan karttatiilet GeoWebCache-käyttöliittymällä:  -- Avaa **ilmakuvat_keskusta**-tason oikealta **Seed/Truncate** ja valitse mittakaavataso 17 alku- ja loppumittakaavaksi. +- Avaa **ilmakuvat**-tason oikealta **Seed/Truncate** ja valitse mittakaavataso 17 alku- ja loppumittakaavaksi. + +- Valitse sama **Grid Set** asetus kuin aikaisemmin, eli EPSG:4326. - Valitse toiminnoksi **Truncate** ja lopuksi **Submit**. Tällä tavalla poistat palvelimesta kaikki mittakaavatason 17 karttatiiltä. - Voit tarkistaa **Tile Layers** -näkymästä **ilmakuvat_keskusta**-tason nykyisen kovalevyn käytön. -::: hint-box -Psst! Helsingin ilmakuvien mittakaavataso 17 vaatii 1,4 GB. -::: ## **Karttatiiliruudukot** -GeoServerin oletusasennuksesta löytyy muutama valmiiksi määritelty karttatiiliruudukko. Nämä ruudukot ovat joko WGS 84 tai Web Mercator -koordinaattijärjestelmässä. +GeoServerin oletusasennuksesta löytyy valmiiksi määriteltyjä karttatiiliruudukoita. Avaa **Tile Caching → Gridsets** ja paina sitten **EPSG:4326** -nimistä ruudukkoa. ![](img/harjoitus_9/image20.png) @@ -200,14 +207,18 @@ Karttatiiliruudukon määritelmiin kuuluvat muun muassa: | **Tile Matrix Set** | Karttatiilimalli (kuvapyramidi), jolla määritellään karttatiiliruudukolle valitut mittakaavat. Tämä voidaan määritellä joko resoluution tai mittakaavan mukaan. | +---------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+ +\ Karttatiiliruudukkoja voi myös laatia omiin tarpeisiin. +## **Lisätehtäviä** +Jos jää aikaa, voit jatkaa tästä tekemällä lisätehtäviä. + ## **JHS180 mukainen karttatiiliruudukko** -JHS180 suosituksesta löytyy muun muassa suositus kansallisesta karttatiiliruudukosta, joka perustuu OGC-standardien määrittelyihin. Suosituksesta löytyy muun muassa seuraavat määritelmät: +[JHS180](https://geoforum.fi/jhs-180-paikkatiedon-sisaltopalvelut/) suosituksesta löytyy muun muassa suositus kansallisesta karttatiiliruudukosta, joka perustuu OGC-standardien määrittelyihin. Suosituksesta löytyy muun muassa seuraavat määritelmät: +------------------------------+----------------------------------------------------------------------------------------------------------------+ -| **Rajapintastandardi** | OGC:n WMS-T-standardi | +| **Rajapintastandardi** | OGC:n WMTS standardi | +------------------------------+----------------------------------------------------------------------------------------------------------------+ | **Koordinaattijärjestelmä** | ETRS89 / TM35-FIN (EPSG:3067) | +------------------------------+----------------------------------------------------------------------------------------------------------------+ @@ -220,9 +231,10 @@ JHS180 suosituksesta löytyy muun muassa suositus kansallisesta karttatiiliruudu | **Kuvaformaatti** | Image/png | +------------------------------+----------------------------------------------------------------------------------------------------------------+ +\ Näillä määritelmillä, karkeimmalla resoluutiotasolla (taso 0) on vain yksi tiilikuva kooltaan 2 097 152 m \* 2 097 152 m (8 192\*8 192 pikseliä). Tämän kuvatiilen pohjois-etelä -suuntainen keskilinja sijoittuu projektiokaistan keskimeridiaanille (27 astetta). Ja tiilen pohjoisreunan pohjoiskoordinaatti on tiilen koon monikerta päiväntasaajalta laskien (4 \* 2 097 152). -Seuraava taso (taso 1) muodostuu jakamalla 0 tason ainoa tiili neljään yhtä suureen osaan. Ja niin edelleen muodostuvat seuraavat tasot, taso 15 asti. Katso tarkemmin luentomateriaalista. +Seuraava taso (taso 1) muodostuu jakamalla 0-tason ainoa tiili neljään yhtä suureen osaan. Tämä tapa jatkuu tasolle 15 asti. ## **Uuden karttatiiliruudukon luominen** @@ -234,7 +246,7 @@ Anna nimeksi esimerkiksi **JHS180_EPSG3067** ja kirjoita lyhyt määritelmä ruu Valitse **Coordinate Reference System** -arvoksi **EPSG 3067**. -Määrittele vielä ruudukon kattavuus aiemmin mainituilla JHS180 suosituksella, eli karkeamman tason kattavuus. +Määrittele vielä ruudukon kattavuus aiemmin mainituilla JHS180-suosituksella, eli karkeamman tason kattavuus. Suosituksissa sanotaan, että vasemman yläkulman koordinaatit (origo) ovat itäkoordinaatti **-548 576** m ja pohjoiskoordinaatti **8 388 608** m. Näitä vastaavat **Min X** ja **Max Y** koordinaatit. Karkeamman tason koko metreinä on 2097152 \* 2097152 joten: @@ -242,10 +254,15 @@ Suosituksissa sanotaan, että vasemman yläkulman koordinaatit (origo) ovat itä **Min Y** on sitten: 8388608 -- 2097152 = **6 291 456** m -| | JHS180-mukaisen ruudukon kattavuus | -|--------------------|---------------------------------------| -| Min X: -548 576 m | Max X: 1 548 576 m | -| Min Y: 6 291 456 m | Max Y: 8 388 608 m | + ++------------------------------------------------------------------------------------------+ +| **  JHS180-mukaisen ruudukon kattavuus** | ++=================================================+========================================+ +| Min X: -548 576 m | Max X: 1 548 576 m | ++-------------------------------------------------+----------------------------------------+ +| Min Y: 6 291 456 m | Max Y: 8 388 608 m | ++-------------------------------------------------+----------------------------------------+ + Pidä tiilen pikselikoko oletuksena, **256** px. @@ -255,7 +272,7 @@ Samat arvot löydät suosituksen mukaisesta tiiliruudukosta. Täytä karttatiiliruudukon tiedot yllä mainituilla arvoilla, kuitenkin siten, että et käytä välilyöntejä koordinaatteja kirjoittaessasi. -Määritellään seuraavaksi resoluutiotasot. **Tile Matrix Set** -asetuksissa voit määritellä JHS180-suosituksessa mainitut **resoluutiotasot**. +Määritellään seuraavaksi resoluutiotasot. **Tile Matrix Set** -asetuksissa voit määritellä JHS180 suosituksessa mainitut **resoluutiotasot**. Pidä valittuna **Resolutions**. Aloita määrittelemällä taso 0. ![](img/harjoitus_9/image22.png) @@ -265,7 +282,7 @@ Kun painat uudelleen **Add zoom level**, uuden tason **Pixel Size** -arvo tulee Luo loput resoluutiotasot (tasolle 15 asti) samalla tavalla. -**Tiles**-kohdalta voit tarkistaa, kuinka monta tiiltä tarvitaan jokaisen tason puolelta. +**Tiles**-kohdalta voit tarkista kuinka monta tiiliä tarvitaan jokaisen tason puolelta. Paina lopulta **Save**, niin uusi JHS180-karttatiiliruudukko on käytettävissä palvelimessasi.\ ![](img/harjoitus_9/image23.png) @@ -276,7 +293,7 @@ Paina lopulta **Save**, niin uusi JHS180-karttatiiliruudukko on käytettävissä Aiemmissa harjoituksissa olet harjoitellut aineistojen käyttöönottoa GeoServerissä. Samasta jo aiemmin käytetystä **gs_training** PostGIS-tietokannasta löytyy Suomen OpenStreetMap-tiestöaineisto **EPSG 3067** -koordinaattijärjestelmässä. -Luo uusi taso tiestö-aineistosta. Suomen aineisto löytyy tietokannasta **suomi**-skeemasta nimellä **osm-tiet**. +Luo uusi taso tiestö-aineistosta. Suomen aineisto löytyy tietokannasta **suomi**-skeemasta nimellä **osm_tiet**. ::: hint-box Psst! Muista, että ensin luodaan store, josta luodaan viittaus edellä mainittuun skeemaan ja sen jälkeen voidaan lisätä tasoja GeoServer-palvelimelle. @@ -288,10 +305,11 @@ Luo workspace, anna sille nimeksi **suomi**. Luo PostGIS-store, laita se suomi-workspaceen ja nimeä se **suomi_tiesto_3067**:ksi (tietokannan nimi on **gs_training**, skeema on **suomi**, käyttäjä on **postgres** ja salasana on **gispo**). -Kyseisestä storesta löytyy ainoastaan yksi aineisto (osm-tiet). Luo siitä uusi GeoServer-taso, nimeä se **suomi_tiesto_3067**:ksi (täytä myös muuta tarvittavat tiedot). +Kyseisestä storesta löytyy aineisto nimellä **osm_tiet**. Luo siitä uusi GeoServer-taso, nimeä se **suomi_tiesto_3067**:ksi (täytä myös muut tarvittavat tiedot). Muista asettaa koordinaattijärjestelmä (EPSG:3067). -Tarpeen vaatiessa, voit katsoa mallia alla olevasta kuvakaappauksesta PostGIS-storen luomisesta:\ -![](img/harjoitus_9/image24.png) ![](img/harjoitus_9/image25.png) +Tarpeen vaatiessa, voit katsoa mallia alla olevasta kuvakaappauksesta PostGIS-storen luomisesta: + +![](img/harjoitus_9/image24.png) ## **Oman karttatiiliruudukon käyttöönotto** @@ -301,7 +319,9 @@ Valitse **Available gridsets** -osion alta **Add grid subset** -kohdasta uusi ** Tarvittaessa voit määritellä, mitkä zoomaus-tasot ovat käytettävissä tai mitkä tallentuvat välimuistiin käyttäen **Published**- ja **Cached zoom levels -asetuksia**. -Paina lopulta **Save**. ![](img/harjoitus_9/image26.png) +Paina lopulta **Save**. + +![](img/harjoitus_9/image26.png) Esikatsele nyt **suomi_tiesto_3067** uudella karttatiiliruudukolla näkymästä **Tile Caching → Tile Layers**. Valitse tiestötason kohdalla **JHS180_EPSG3067/png**.  @@ -314,7 +334,7 @@ Esikatselussa on käytössä luomasi EPSG:3067 karttatiiliruudukko (alla huomata ## **Paikallisen karttatiiliruudukon muodostaminen** -Geoserveriin voidaan muodostaa tarpeiden mukaan hyvin monenlaisia karttatiiliruudukoita. Joissakin tapauksissa voi olla tarpeen luoda oma paikallinen karttatiiliruudukko. Paikallisen karttatiiliruudukko voi olla tarpeellinen, jos karttatiilipalvelulle on runsaasti käyttöä ja aineistoihin halutaan yhdistää paikallisessa koordinaattijärjestelmässä olevia tietoaineistoja (vektori- tai rasteriaineistoja). +GeoServeriin voidaan muodostaa tarpeiden mukaan hyvin monenlaisia karttatiiliruudukoita. Joissakin tapauksissa voi olla tarpeen luoda oma paikallinen karttatiiliruudukko. Paikallisen karttatiiliruudukko voi olla tarpeellinen, jos karttatiilipalvelulle on runsaasti käyttöä ja aineistoihin halutaan yhdistää paikallisessa koordinaattijärjestelmässä olevia tietoaineistoja (vektori- tai rasteriaineistoja). Luodaan nyt Helsingin alueelle oma karttatiiliruudukko, joka käyttää **ETRS89 / GK25FIN (EPSG:3879)** -koordinaattijärjestelmää. Määritellään resoluutiotasot mittakaavan mukaan. diff --git a/src/GS006/10_harjoitus_10.Rmd b/src/GS006/10_harjoitus_10.Rmd index 72ac91f8..568c4e9f 100644 --- a/src/GS006/10_harjoitus_10.Rmd +++ b/src/GS006/10_harjoitus_10.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 2.3: Arkkitehtuuri ja käyttöönotto +# HARJOITUS 2.3: ARKKITEHTUURI JA KÄYTTÖÖNOTTO **Harjoituksen sisältö** @@ -30,7 +30,10 @@ Voit tarkistaa ja vapauttaa GeoServerin käyttämää muistia **Memory Usage** k Tarkista vielä, mitkä Java-asetukset ovat voimassa palvelimessa kuvien käsittelyä varten. Lähtökohtaisesti ei ole kovin tehokasta käsitellä kuvia kokonaisina tietokoneen muistissa. Yleisesti käytetty tapa on jakaa kuvat pienempiin osiin (tiilet/tiles) ja tehdä mahdolliset kuvaoperaattorit pienempiin kuviin. JAI-asetukset (määritelty **Image Processing** -asetuksissa) hallinnoivat näiden menetelmien toimintaa. -JAI (Java Advanced Imaging) asetuksia voit muokata **Settings → Image Processing** -näkymän kautta. ![](img/harjoitus_10/image2.png) +JAI (Java Advanced Imaging) asetuksia voit muokata **Settings → Image Processing** -näkymän kautta. + +![](img/harjoitus_10/image2.png) + Asetusten muutokset näkyvät **Server Status** -sivulla. @@ -74,7 +77,7 @@ Avaa kolmanteen selainikkunaan GeoServerin lokien esikatselu (**GeoServer Logs** ![](img/harjoitus_10/image4.png) -Tutustu asetuksiin kouluttajan ohjauksella sekä lukemalla lisää tietoa asetuksista Geoserverin manuaalista (**Web Administration Interface → Server → Global Settings**). Avaa manuaali erilliseen selainikkunaan. +Tutustu asetuksiin kouluttajan ohjauksella sekä lukemalla lisää tietoa asetuksista GeoServerin manuaalista (**Web Administration Interface → Server → Global Settings**). Avaa manuaali erilliseen selainikkunaan. Suorita nyt muutamia toimintoja (zoom in, zoom out, pan) karttaikkunassa.  @@ -84,7 +87,7 @@ GeoServerin asennuksessa on valmiina ladattuja erilaisia loki-profiileja, jotka ![](img/harjoitus_10/image5.png) -Voit nyt vaihtaa erilaisia lokitusprofiileja ja havainnoida toimintojen aiheuttamia vaikutuksia lokitiedostoihin. Kokeile asettaa profiiliksi VERBOSE_LOGGING.properties ja liikuttele karttaa. Päivitä tämän jälkeen loki (refresh) ja katso mitä rivejä lokiin on ilmestynyt. +Voit nyt vaihtaa erilaisia lokitus profiileja ja havainnoida toimintojen aiheuttamat vaikutukset lokitiedostoihin. Kokeile asettaa profiiliksi VERBOSE_LOGGING.properties ja liikuttele karttaa. Päivitä tämän jälkeen loki (refresh) ja katso mitä rivejä lokiin on ilmestynyt. ## **REST API:n toimintaa** @@ -92,8 +95,8 @@ GeoServerin palvelimen asetuksia on mahdollista hallita myös REST-rajapinnan ka Voit tarkistaa REST-rajapinnan kautta saatavilla olevat aineistot kirjoittamalla seuraavan osoitteen web-selaimeen (käytä oman palvelimesi ip-osoitetta): -::: code-box -http://%3Eoma-ip-osoite:8080/geoserver/rest/workspaces/ +::: note-box + ::: Etsi tiedot edellisissä harjoituksissa luoduista karttatasoista. @@ -110,8 +113,14 @@ Psst! Tutustu REST API:n kuvaukseen GeoServerin ohjeessa. ## **Monitor-lisäosan käyttö** -GeoServerin **Monitor**-lisäosa on valmiiksi asennettu koulutus palvelimiin ja se näkyy päävalikosta alapuolelta. +GeoServerin **Monitor**-lisäosa on valmiiksi asennettu koulutuspalvelimiin, ja se näkyy päävalikosta alapuolelta. Tällä lisäosalla voidaan tarkastella GeoServerin liikennettä. Voit vapaasti tarkastella mitä Monitor-lisäosalla voi tehdä. Pohdi myös miten se voisi olla hyödyllinen teidän organisaatiossa. Avaa **Monitor → Activity**. -Kokeile esikatsella eri tasoja ja katso sen jälkeen **Monitor → Activity → Daily**-osiosta järjestelmän aktiviteettigrafiikkaa, jonka pitäisi näyttää seuraavanlaiselta: ![](img/harjoitus_10/image7.png) ![](img/harjoitus_10/image8.png) +Kokeile esikatsella eri tasoja ja katso sen jälkeen **Monitor → Activity → Daily**-osiosta järjestelmän aktiviteettigrafiikkaa, jonka pitäisi näyttää seuraavanlaiselta: + +![](img/harjoitus_10/image7.png) + +Avaa palvelukohtainen raportti **Monitor → Reports → OWS Request Summary**. + +![](img/harjoitus_10/image8.png) diff --git a/src/GS006/11_harjoitus_11.Rmd b/src/GS006/11_harjoitus_11.Rmd index 622ece5c..7aed67a6 100644 --- a/src/GS006/11_harjoitus_11.Rmd +++ b/src/GS006/11_harjoitus_11.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 2.4: CSS-kuvaustekniikka +# HARJOITUS 2.4: CSS-KUVAUSTEKNIIKKA **Harjoituksen sisältö** @@ -28,11 +28,11 @@ Luodaan nyt uusi tyyli **tiesto**-tasolle. Avaa päävalikosta **Styles** ja paina **Add a new style**. -Määrittele uuden tyylin nimeksi **tiesto_css** ja jätä workspace-kohta tyhjäksi. +Määrittele uuden tyylin nimeksi **tiesto_css** ja jätä workspace-kohta tyhjäksi. Muista myös valita tyylin formaatiksi CSS. Valitse **Style Content** valikosta geometriatyypiksi **Line** ja paina **Generate**. -**Style Editor** -laatikossa on nyt seuraavankaltainen teksti: +**Style Editor** -laatikossa on nyt seuraavankaltainen teksti (väri vaihtelee): ::: code-box /\* \@title red line \*/\ @@ -41,11 +41,12 @@ Valitse **Style Content** valikosta geometriatyypiksi **Line** ja paina **Genera }\ ::: -Paina **Submit**. Avaa **Styles**-valikosta juuri luomasi tyyli ja valitse **Layer Preview** -välilehti. Valitse esikatseltavaksi tasoksi tiestötaso. +Paina **Save**. Avaa **Styles**-valikosta juuri luomasi tyyli ja valitse **Layer Preview** -välilehti. Valitse esikatseltavaksi tasoksi tiestötaso. Lähennä karttaa siten, että tiet alkavat näkyä kunnolla. -Pystyt muokkaamaan CSS-koodia myös **Layer Preview** -välilehdellä. Huomaa merkki "**\***". Se tarkoittaa, että sääntö koskee kaikkia kohteita (samoin kuin \*-merkki esimerkiksi tiedostojen listauksessa komentoriviltä).  +Pystyt muokkaamaan CSS-koodia myös **Layer Preview** -välilehdellä. Huomaa merkki "**\***". Se tarkoittaa, että sääntö koskee kaikkia kohteita (samoin kuin \*-merkki esimerkiksi tiedostojen listauksessa komentoriviltä). Paina "Preview on layer"-kohdan tasoa ja vaihda se tasoon helsinki:hki_tiesto, ellei se ole jo valittuna. + ![](img/harjoitus_11/image1.png) Vaihda nyt **stroke**-komennon arvoksi **blue**. @@ -55,22 +56,24 @@ Vaihda nyt **stroke**-komennon arvoksi **blue**. ::: Paina **Apply** ja esikatsele karttaa. Nyt tiet näkyvät kartassa sinisinä. + ![](img/harjoitus_11/image2.png) ## **Aineiston luokittelu** Luokitellaan nyt tiet kahteen luokkaan: **päätiet** ja **muut**. Kullekin luokalle voidaan määritellä oma tyyli. -Päätiet luokitellaan korvaamalla merkki "**\***" seuraavalla koodilla (huomaa, että rajauksessa käytetään **type**-kentän tietoja): +Päätiet luokitellaan korvaamalla merkki "**\***" seuraavalla koodilla (huomaa, että rajauksessa käytetään **fclass**-kentän tietoja): ::: code-box -[type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk']\ +[fclass = \'motorway\' or fclass = \'primary\' or fclass = \'secondary\' or fclass = \'trunk\']\ { stroke: red;} ::: Paina **Apply**. Nyt vain päätiet ovat näkyvissä. Luo nyt tyyli muille teille. + ![](img/harjoitus_11/image3.png) Muokkaa CSS-tyyliä vielä seuraavasti: @@ -88,13 +91,14 @@ Vaihda muiden teiden tyyli niin, että viivan väri on musta (black). Pääteiden ja muiden teiden tyylit näyttävät nyt tältä: ::: code-box -[type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk']\ +[fclass = \'motorway\' or fclass = \'primary\' or fclass = \'secondary\' or fclass = \'trunk\']\ { stroke: red;}\ -[type \<\> 'motorway' and type \<\> 'primary' and type \<\> 'secondary' and type \<\> 'trunk']\ +[fclass \<\> \'motorway\' and fclass \<\> \'primary\' and fclass \<\> \'secondary\' and fclass \<\> \'trunk\']\ { stroke: black;}\ ::: Esikatsele nyt tulos painamalla **Apply**. + ![](img/harjoitus_11/image4.png) ## **Tyylin virittäminen** @@ -104,10 +108,10 @@ Tiet ovat vielä vaikea erottaa toisistaan. Tehdään nyt pari parannusta tyylii Määrittele samalla tavalla muille teille viivan paksuudeksi **0.1**: ::: code-box -[type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk']\ +[fclass = \'motorway\' or fclass = \'primary\' or fclass = \'secondary\' or fclass = \'trunk\']\ { stroke: red;\ stroke-width: 0.5;}\ -[type \<\> 'motorway' and type \<\> 'primary' and type \<\> 'secondary' and type \<\> 'trunk']\ +[fclass \<\> \'motorway\' and fclass \<\> \'primary\' and fclass \<\> \'secondary\' and fclass \<\> \'trunk\']\ { stroke: black;\ stroke-width: 0.1;}\ ::: @@ -126,7 +130,8 @@ z-index: 0, 3; Huomaa, että tällä tavalla määrittelet pääteille päällekkäiset tyylit, jotka muodostavat monimutkaisempia visualisointeja. -Paina vielä **Submit** ja visualisoi lopputulos: +Paina vielä **Save** ja visualisoi lopputulos: + ![](img/harjoitus_11/image5.png) **Z-index** -komennolla määritellään, missä järjestyksessä eri tyylit piirtyvät. Indeksin arvolla 0 viitataan mustaan viivaan, jonka paksuus määritellään viiteen pikseliin. Indeksin arvo kolme viittaa keltaiseen viivaan , jonka paksuus on kolme pikseliä. Huomaa, kuinka Z-indeksin pienemmät arvot piirtyvät ensin ja suuremmat arvot myöhemmin. @@ -140,12 +145,12 @@ Kokeile vaihtaa symbolien järjestystä, värejä ja paksuuksia. Koodisi näyttäisi tässä vaiheessa tältä: ::: code-box - [type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk']\ + [fclass = \'motorway\' or fclass = \'primary\' or fclass = \'secondary\' or fclass = \'trunk\']\      { stroke: black, yellow;\      stroke-width: 5px, 3px;\      z-index: 0, 3;}\ \ - [type \<\> 'motorway' and type \<\> 'primary' and type \<\> 'secondary' and type \<\> 'trunk']\ + [fclass \<\> \'motorway\' and fclass \<\> \'primary\' and fclass \<\> \'secondary\' and fclass \<\> \'trunk\']\      { stroke: black;\      stroke-width: 0.1;}\ ::: @@ -158,7 +163,7 @@ Laita pääteiden määrittelyn eteen **/\* \@title Paatiet \*/**: ::: code-box  /\* \@title Paatiet \*/\ - [type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk']\ + [fclass = \'motorway\' or fclass = \'primary\' or fclass = \'secondary\' or fclass = \'trunk\']\      {stroke: black, yellow;\      stroke-width: 5px, 3px;\      z-index: 0, 3;}\ @@ -175,19 +180,20 @@ Lisää vielä koodin loppuun seuraava koodi:  Edellä esitetty ja viimeinen taso/koodi määrittää "**\***"-merkin toimesta kokonaisvaltaisia CSS-tyylisääntöjä, joissa tässä on määritelty "**Tiesto**"-etuliite symboliikan teksteihin ja **Helvetica**-tyyli kartan tekstityksiin. Paina nyt **Apply**, jolloin kartta päivittyy. + ![](img/harjoitus_11/image6.png) -Koodisi tässä vaiheessa pitäisi näyttää jokseenkin tältä: +Koodisi tässä vaiheessa pitäisi näyttää jotenkin tältä: ::: code-box  /\* \@title Paatiet \*/\ - [type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk']\ + [fclass = \'motorway\' or fclass = \'primary\' or fclass = \'secondary\' or fclass = \'trunk\']\      { stroke: black, yellow;\      stroke-width: 5px, 3px;\      z-index: 0, 3;}\ \  /\* \@title Sivutiet \*/\ - [type \<\> 'motorway' and type \<\> 'primary' and type \<\> 'secondary' and type \<\> 'trunk']\ + [fclass \<\> \'motorway\' and fclass \<\> \'primary\' and fclass \<\> \'secondary\' and fclass \<\> \'trunk\']\      { stroke: black;\      stroke-width: 0.1;}\ \ @@ -208,25 +214,39 @@ Laita pienempien teiden tyylin eteen: Paina **Apply**. Nyt muut tiet näkyvät vain, jos **zoom**-taso on tarkempi kuin **1:50 000**. Ja kun zoomataan kauemmaksi, niin vain päätiet näkyvät kartalla: + ![](img/harjoitus_11/image7.png) Koodisi tässä vaiheessa pitäisi näyttää jotenkin tältä: ::: code-box - /\* \@title Paatiet \*/\ - [type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk']\ -     { stroke: black, yellow;\ -     stroke-width: 5px, 3px;\ -     z-index: 0, 3;}\ + /\* \@title Paatiet \*/ + + [fclass = \'motorway\' or fclass = \'primary\' or fclass = \'secondary\' or fclass = \'trunk\'] + +     { stroke: black, yellow; + +     stroke-width: 5px, 3px; + +     z-index: 0, 3;} + \ - /\* \@title Sivutiet \*/\ - [\@scale \< 50000]\ - [type \<\> 'motorway' and type \<\> 'primary' and type \<\> 'secondary' and type \<\> 'trunk']\ -     { stroke: black;\ -    stroke-width: 0.1;}\ + + /\* \@title Sivutiet \*/ + + [\@scale \< 50000] + + [fclass \<\> \'motorway\' and fclass \<\> \'primary\' and fclass \<\> \'secondary\' and fclass \<\> \'trunk\'] + +     { stroke: black; + +     stroke-width: 0.1;} + \ - /\* \@title Roads \*/\ -   \* { font-family: Helvetica;} + + /\* \@title Tiesto \*/  + + \* { font-family: Helvetica;} ::: ## **Tekstityksen lisääminen** @@ -250,10 +270,11 @@ Esikatsele tuloksia painamalla **Apply**. Tulos ei ole vielä hyvä, tarvitaan muutama teksteihin tarkoitettu erikoiskomento: ::: code-box --gt-label-follow-line: true; -gt-label-max-angle-delta: 90; -gt-label-max-displacement: 400; -gt-label-repeat: 150; +label-follow-line: true; label-max-angle-delta: 90; label-max-displacement: 400; label-repeat: 150; ::: -**-gt-label-\*** kertoo, miten tekstit eli labelit piirretään. Kokeile muuttaa edellisten komentojen arvoja. +**label-\*** kertoo, miten tekstit eli labelit piirretään. Kokeile muuttaa edellisten komentojen arvoja. + ![](img/harjoitus_11/image8.png) Lisää vielä puskuri teksteille: @@ -263,51 +284,86 @@ halo-color: white; halo-radius: 1; ::: Voit määritellä pienemmille teille myös nimiöt samalla tavalla kun äsken tehtiin pääteille. + ![](img/harjoitus_11/image9.png) Tässä on esimerkkikoodi, jossa kaikki aiemmin mainitut tyylit ovat käytössä: ::: code-box -/\* \@title Paatiet \*/\ -[type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk']\ - { stroke: black, yellow;\ - stroke-width: 5px, 3px;\ - z-index: 0, 3;\ - label: [name];\ - font-weight: bold;\ - font-fill: black;\ - font-size: 12;\ - -gt-label-follow-line: true;\ - -gt-label-max-angle-delta: 90;\ - -gt-label-max-displacement: 400;\ - -gt-label-repeat: 150;\ - halo-color: white;\ - halo-radius: 1;}\ + +/\* \@title Paatiet \*/ + +[fclass = \'motorway\' or fclass = \'primary\' or fclass = \'secondary\' or fclass = \'trunk\'] + +{ stroke: black, yellow; + +stroke-width: 5px, 3px; + +z-index: 0, 3; + +label: [name]; + +font-weight: bold; + +font-fill: black; + +font-size: 12; + +label-follow-line: true; + +label-max-angle-delta: 90; + +label-max-displacement: 400; + +label-repeat: 150; + +halo-color: white; + +halo-radius: 1;} + \ -/\* \@title Sivutiet \*/\ -[\@scale \< 50000]\ -[type \<\> 'motorway' and type \<\> 'primary' and type \<\> 'secondary' and type \<\> 'trunk']\ - { stroke: black;\ - stroke-width: 0.1;\ - label: [name];\ - font-fill: black;\ - font-size: 9;\ - -gt-label-follow-line: true;\ - -gt-label-max-angle-delta: 90;\ - -gt-label-max-displacement: 400;\ - -gt-label-repeat: 150;\ - halo-color: white;\ - halo-radius: 1;}\ + +/\* \@title Sivutiet \*/ + +[\@scale \< 50000] + +[fclass \<\> \'motorway\' and fclass \<\> \'primary\' and fclass \<\> \'secondary\' and fclass \<\> \'trunk\'] + +{ stroke: black; + +stroke-width: 0.1; + +label: [name]; + +font-fill: black; + +font-size: 9; + +label-follow-line: true; + +label-max-angle-delta: 90; + +label-max-displacement: 400; + +label-repeat: 150; + +halo-color: white; + +halo-radius: 1;} + \ -/\* \@title Tiesto \*/\ - \* { font-family: Helvetica;} -::: +/\* \@title Tiesto \*/  + +\* { font-family: Helvetica;} + +::: Tämän tyylin esikatselu näyttää kartassa tältä: + ![](img/harjoitus_11/image10.png) -Voit vielä kokeilla erilaisia komentoja virittämään karttasi tyyliä pidemmälle. GeoServer CSS-lisäosan nettisivuilla löytyy ohjeita ja esimerkkejä: http://docs.geoserver.org/stable/en/user/extensions/css/index.html. +Voit vielä kokeilla erilaisia komentoja virittämään karttasi tyyliä pidemmälle. GeoServer CSS-lisäosan nettisivuilla löytyy ohjeita ja esimerkkejä: https://docs.geoserver.org/latest/en/user/styling/css/index.html. ## **Kuvaustekniikan soveltaminen** diff --git a/src/GS006/12_harjoitus_12.Rmd b/src/GS006/12_harjoitus_12.Rmd index affe46b0..f30415ac 100644 --- a/src/GS006/12_harjoitus_12.Rmd +++ b/src/GS006/12_harjoitus_12.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 2.5: Pääsynhallinta +# HARJOITUS 2.5: PÄÄSYNHALLINTA **Harjoituksen sisältö** @@ -22,25 +22,13 @@ Tässä näkymässä voidaan myös määrittää, mikä **Active role service** **Encryption**-kohdan alta löytyy salaukseen liittyviä asetuksia. **Encrypt web admin URL parameter** -valinta salaa käyttäjäliittymän URL-parametreja selaimella. -Esimerkiksi, **Security**-valikon selaimen URL (missä nyt ollaan)...  +Esimerkiksi, **Security**-valikon selaimen URL (missä nyt ollaan) olisi paikallisella GeoServer-asennuksella: -... ilman salausta on: +`http://localhost:8080/geoserver/web/?wicket:bookmarkablePage=:org.geoserver.security.web.SecuritySettingsPage` -::: note-box - -::: - -... salauksen kanssa se on: - -::: note-box - -::: +... ja salauksen kanssa se on: -Huomaa, että palvelimessa ei ole asennettu Java policy -tiedostoja, joten vahvaa salausta ei voida ottaa käyttöön. - -::: hint-box -Psst! Java policy -tiedostojen asennus riippuu siitä, mikä Java ohjelmisto on palvelimessa asennettu. Jos asennettu on Open JDK, niin policy-tiedostot on oletuksena asennettu ja Strong cryptography käytössä. Jos taas asennetaan Oracle Java (joka on aikaisemmin ollut GeoServerin suositus) niin täytyy ladata Oraclen JCE policy jars ja purkaa ne JRE_HOME/lib/security -kansioon, jonka jälkeen Strong cryptography on käytössä. -::: +`http://localhost:8080/geoserver/web/?x=xAiOmyK-CQmBXDhILZrWpny28bhFcImLrBRYk0INwrBDmbzQlmeLRdiaRoNSaBSx3o6elVC9JMPcy5gkRljLXMKGrvMx3Yui3*ANGkUW-hE` **Password encryption** määrittää, mikä salauksen tyyli on käytössä salasanojen varastossa: **Plain text**, **Weak PBE** ja **Strong PBE**. @@ -52,7 +40,7 @@ Pidä **Weak PBE** ja paina **Save**. Oletuksena GeoServerin asetukset sallivat palvelimen käytön (eli WMS-, WFS- ja WCS-palvelujen käytön) ilman mitään käyttäjätunnusta. Voit tarkistaa tämän seuraavasti. -Esikatsele tasoa **ilmakuvat_keskusta** samalla tavalla kuin aiemmin muita tasoja. Taso aukeaa selaimella ongelmitta, koska olet kirjautunut **admin**-tunnuksella.  Älä sulje esikatselusivua vielä. +Esikatsele tasoa **ilmakuvat** samalla tavalla kuin aiemmin muita tasoja. Taso aukeaa selaimella ongelmitta, koska olet kirjautunut **admin**-tunnuksella.  Älä sulje esikatselusivua vielä. Mene nyt takaisin GeoServerin ylläpitosivulle ja paina **Logout**. @@ -68,12 +56,12 @@ Nyt ainoastaan **basic**-tunnistautumisen tyyli on Selected-laatikossa eli käyt ![](img/harjoitus_12/image3.png) -Paina nyt **Close** ja pääset takaisin **Authentication**-valikkoon. Paina sitten **Save**, niin muutokset tulevat voimaan. +Paina nyt **Close** ja pääset takaisin **Authentication** valikkoon. Paina sitten **Save**, niin muutokset tulevat voimaan. Jos kirjaudut nyt ulos GeoServeristä ja päivität aiemmin avattua esikatselusivua uudelleen, tunnuksella ja salasanalla tunnistautuminen on pakollista. ::: hint-box -Psst! Palvelimen pääsynhallinnan asetuksia voi helpoiten testata käyttämällä eri web-selainta (Internet Explorer / FireFox / Chrome) tai selaimen yksityisyyden salaavaa toimintoa (Incognito-mode) normaalin selaimen rinnalla. Toisella selaimella ollaan kirjautuneena ylläpitäjän tunnuksilla (kuten tähän asti) ja toisella kokeillaan erilaisia kirjautumistiloja. Voit kysyä opastusta kouluttajalta tarvittaessa. Huomaa, että sinun täytyy mahdollisesti kirjautua ulos ja uudelleen sisään asetusten uudelleen lataamista varten. +Psst! Palvelimen pääsynhallinnan asetuksia voi helpoiten testata käyttämällä eri web-selainta (Internet Explorer / FireFox / Chrome) tai selaimen yksityisyyden salaavaa toimintoa (Incognito-mode) normaalin selaimen rinnalla. Toisella selaimella ollaan kirjautuneet ylläpitäjän tunnuksilla (kuten tähän asti) ja toisella kokeillaan erilaisia kirjautumistiloja. Voit kysyä opastusta kouluttajalta tarvittaessa. Huomaa, että mahdollisesti sinun täytyy kirjautua ulos ja uudelleen sisään asetusten uudelleen lataamista varten. ::: ## **Uuden roolin ja käyttäjän luominen** @@ -114,13 +102,13 @@ Laita käyttäjän nimeksi **hki_kayttaja** ja salasanaksi **hki-kayttaja**. Psst! Huomaa, että erikoismerkit ja ääkköset ovat sallittuja GeoServerissä, mutta tarkoituksenmukaisuuden ja eri selainten välisten erojen vuoksi tässä koulutuksessa vältetään niiden käyttöä. ::: -Uudelle käyttäjälle annetaan oikeuksia määrittämällä, mitä rooleja käyttäjällä on. Roolit on määritelty **Roles taken from active role service: default** -kohdassa. Valittavissa on muun muassa **hki_rooli**, lisää se **Selected Roles** -laatikkoon käyttäen laatikkojen välistä löytyviä siirtonuolia. +Uudelle käyttäjälle annetaan oikeuksia määrittämällä mitä rooleja käyttäjällä on. Roolit on määritelty **Roles taken from active role service: default** -kohdassa. Siinä on valittavissa muun muassa **hki_rooli**, lisää se **Selected Roles** -laatikkoon käyttäen laatikkojen välistä löytyviä siirtonuolia. -Paina sitten **Save**, niin uusi käyttäjä **hki_kayttaja** on luotu. Käyttäjällä on oikeudet **hki_rooli**:n mukaisesti. Koska **hki_rooli**:lle ei vielä ole määritelty oikeuksia, niin uudella käyttäjälläkään ei vastaavasti ole toistaiseksi mitään oikeuksia. +Paina sitten **Save**. Uusi käyttäjä **hki_kayttaja** on luotu, ja sillä on oikeudet **hki_rooli**nmukaisesti. Koska **hki_rooli**lle ei vielä ole määritelty oikeuksia, niin uudella käyttäjälläkään ei ole vielä määritelty mitään oikeuksia. ![](img/harjoitus_12/image6.png) -Kokeile uuden käyttäjän oikeuksia kirjautumalla sisään uudella käyttäjätunnuksella. Voit joko kirjautua uudestaan tai käyttämällä toista selainta, kuten aikaisemmin ohjeistettiin. +Kokeile uuden käyttäjän oikeudet kirjautumalla sisään uudella käyttäjätunnuksella. Voit joko kirjautua uudestaan tai käyttämällä toista selainta, kuten aikaisemmin on mainittu. ## **Aineiston käyttöoikeuksien rajoittaminen** @@ -128,9 +116,9 @@ Avaa **Security → Data.** Tässä näkymässä näkyvät GeoServer-palvelimen ![](img/harjoitus_12/image7.png) -**Rule path** -sarakkeen alla olevat säännöt ovat muodoltaan **\*.\*.r**, joka antaa lukemisoikeudet kaikille tasoille kaikissa workspace:ssa. +**Rule path** -sarakkeen alla olevat säännöt ovat muodoltaan **\*.\*.r**, joka antaa lukemisoikeudet kaikille tasoille kaikissa workspaceissa. -Huomaa vielä, että **Roles**-sarakkeen alla on määritelty, mille rooleille oikeudet on myönnetty. **\***-merkki tarkoittaa "kaikki roolit". +Huomaa vielä, että **Roles**-sarakkeen alla on määritelty, mille rooleille oikeudet on myönnetty. Tässä on määritelty **\***-merkillä, joka tarkoittaa "kaikki roolit". Seuraava kuva esittää GeoServerin aineistosääntöjen määrittelyä: @@ -144,11 +132,11 @@ Psst! Kaikissa osissa voidaan käyttää myös \*-merkkiä, jolla voidaan viitat Paina listalta **\*.\*.r**. -Tässä säännössä määritellään, että kaikkiin workspace:ihin ja kaikkiin tasoihin on lukemisoikeus. +Tässä säännössä määritellään, että kaikkiin workspaceihin ja kaikkiin tasoihin on lukemisoikeus. ![](img/harjoitus_12/image9.png) -**Roles**-osion alla on määritelty se, että tämä sääntö kuuluu kaikille rooleille (**Grant access to any role**). Huomaa, että **Grant access to any role** on rastittu, joten kaikki roolit voivat lukea kaikki tasoja kaikista workspace:sta. +**Roles**-osion alla on määritelty se, että tämä sääntö kuuluu kaikille rooleille (**Grant access to any role**). Huomaa, että **Grant access to any role** on rastittu, joten kaikki roolit voivat lukea kaikki tasoja kaikista workspaceista. Rajoitetaan nyt sääntöä vain ylläpitäjien rooleille. @@ -162,19 +150,19 @@ Tee lopuksi samat muutokset **\*.\*.w** -säännölle. ![](img/harjoitus_12/image11.png) -Näiden muutosten jälkeen vain **Admin**-tunnuksella on lukemis- ja esikatseluoikeudet. +Näiden muutosten jälkeen, vain **Admin**-tunnuksella on lukemis- ja esikatseluoikeudet. -Kokeile nyt esikatsella joitakin aineistoja **hki_kayttaja**-tunnuksella. Yhtään aineistoa ei ole tarjolla. +Kokeile nyt esikatsella jotain aineistoja **hki_kayttaja**-tunnuksella, yhtään aineistoa ei ole tarjolla. ![](img/harjoitus_12/image12.png) ## **Aineiston käyttäjäkohtaiset käyttöoikeudet** -Seuraavaksi määritellään **hki_kayttaja**-tunnukselle luku- ja kirjoitusoikeudet **helsinki**-workspace:en. Käytännössä pitää määritellä oikeudet roolille, johon käyttäjä kuuluu, eli **hki_rooli**-roolille. +Seuraavaksi määritellään **hki_kayttaja**-tunnukselle luku- ja kirjoitusoikeudet **helsinki**-workspaceen. Käytännössä pitää määritellä oikeudet roolille johon käyttäjä kuuluu, eli **hki_rooli**-roolille. -Tähän asti **hki_rooli**:lle ei ole annettu vielä mitään oikeuksia, täten **hki_kayttaja**:llä ei ole oikeuksia mihinkään aineistoon (ellei joku sääntö on määritelty kaikille rooleille käyttäen **\***-merkkiä). +Tähän asti **hki_rooli**lle ei ole annettu vielä mitään oikeuksia, täten **hki_kayttaja**llä ei ole enää oikeuksia mihinkään aineistoon (ellei joku sääntö on määritelty kaikille rooleille käyttäen **\***-merkkiä). -Lisätään nyt **hki_kayttaja**:lle **Read**- ja **Write**-käyttöoikeudet, mutta vain **helsinki-**workspace:en. Tämä tapahtuu määrittämällä lisää aineiston sääntöjä. +Lisätään nyt **hki_kayttaja**lle **Read**- ja **Write**-käyttöoikeudet, mutta vain **helsinki-**workspaceen. Tämä tapahtuu määrittämällä lisää aineiston sääntöjä. ::: hint-box Psst! Varmista, että olet kirjautunut ylläpitäjänä (tunnus: admin ja salasana: gispo). @@ -186,21 +174,21 @@ Laita **Workspace**-kohtaan **helsinki** ja jätä **Layer**-arvoksi "**\***", j Aseta **Access mode** -valikkoon arvoksi **Read**, joka antaa lukemisoikeudet edellä määrätyille aineistoihin. -Siirrä lopulta **hki_rooli** laatikosta **Available Roles** laatikkoon **Selected Roles**. +Siirrä lopulta **hki_rooli** laatikosta **Available Roles**, laatikkoon **Selected Roles**. ![](img/harjoitus_12/image13.png) Paina lopuksi **Save**.  -Nyt **hki_kayttaja**:llä on read-oikeudet kaikkiin helsinki workspace:n tasoihin. +Nyt **hki_kayttaja**llä on read-oikeudet kaikkiin helsinki workspacen tasoihin. -Lisää samalla tavalla vielä **Write**. Kirjoitusoikeudet sallivat käyttäjälle aineistojen muokkausoikeudet aina, kun se on sallittu GeoServerissa, esimerkiksi WFS-T-palvelun kautta. +Lisää samalla tavalla vielä **Write**. Kirjoitusoikeudet sallivat käyttäjälle aineistojen muokkausoikeudet aina kun se on sallittu GeoServerissa, esimerkiksi WFS-T-palvelun kautta. Kokeile uudelleen esikatsella aineistoja **hki_kayttaja**-tunnuksella. Esikatselu on mahdollista nyt kaikkien **helsinki**-workspacen tasojen kanssa, mutta muut tasot eivät näy. Huomaa, että käyttäjällä ei ole kuitenkaan oikeuksia lisätä GeoServeriin uusia aineistoja tai tasoja. Voit antaa **hki_kayttaja**-tunnukselle **Admin**-oikeudet määrittämällä vielä ylläpitäjän oikeudet. -Loppujen lopuksi on luotu kolme uutta sääntöä, jotka ovat voimassa **hki_rooli**:lla. +Loppujen lopuksi on luotu kolme uutta sääntöä, jotka ovat **hki_rooli**lla voimassa. ![](img/harjoitus_12/image14.png) @@ -210,23 +198,23 @@ Kirjaudu uudelleen palvelimelle käyttäen **hki_kayttaja**-tunnusta ja tarkista ## **Karttapalvelukohtaiset oikeudet** -Kirjaudu **admin**-tunnuksella uudelleen Geoserver-palvelimelle. +Kirjaudu **admin**-tunnuksella uudelleen GeoServer palvelimelle. -Samalla tavalla kuin äsken määriteltiin käyttäjäkohtaisesti oikeudet yhdelle workspace:lle, voidaan asettaa oikeudet palvelukohtaisesti eri käyttäjille. +Samalla tavalla kuin äsken määriteltiin käyttäjäkohtaisesti oikeudet yhdelle workspacelle, voidaan asettaa oikeudet palvelukohtaisesti eri käyttäjille. -Avaa **Security → Services**. Määriteltynä on oletuksena vain yksi sääntö **\*.\***. Samalla tavalla kuin aiemmin, tämä tarkoittaa se, että kaikki palvelujen toiminnot (säännön toinen **\***-merkki) ovat käytettävissä kaikissa palveluissa (säännön ensimmäinen **\***-merkki). +Avaa **Security → Services**. Seuraava kuva esittää GeoServerin palvelusääntöjen määrittelyä: ![](img/harjoitus_12/image16.png) -Avaa sääntö **\*.\*** ja rajoita sen käyttöä vain ylläpitäjille. +Luo uusi sääntö **\*.\*** ja rajoita sen käyttöä vain ylläpitäjille. ![](img/harjoitus_12/image17.png) -Paina **Save**. Nyt GeoServerin palvelut ovat käytettävissä ainoastaan ylläpitorooleille. +Paina **Save**. Nyt GeoServerin palvelut ovat käytettävissä ainoastaan ylläpito-rooleille. -Luo sen jälkeen sääntö, joka on käytössä vain **hki_rooli**:lle ja jolla on oikeudet käyttää kaikkia **WMS-karttapalvelujen** toimintoja. +Luo sen jälkeen sääntö, joka on käytössä vain **hki_rooli**lle ja sillä on oikeudet käyttää kaikkia **WMS-karttapalvelujen** toimintoja. ::: hint-box Psst! Huomaa, että säännöt eivät välttämättä tule voimaan kuin vasta käyttäjän seuraavalla istunnolla. @@ -236,6 +224,6 @@ Lopussa **Service access rules list** -näkymä näyttää tältä: ![](img/harjoitus_12/image18.png) -Kirjaudu taas **hki_kayttaja**:nä ja kokeile esikatsella jotain aineistoa sekä WMS- että WFS-karttapalveluna. WFS-esikatselu ei enää onnistu, koska kyseisellä käyttäjällä ei ole oikeuksia WFS-toimintoihin. WMS-toimintoihin oikeudet ovat ja ne näkyvät. +Kirjaudu taas **hki_kayttaja**nä ja kokeile esikatsella jotain aineistoa sekä WMS- että WFS-karttapalveluna. WFS-esikatselu ei enää onnistu, koska kyseisellä käyttäjällä ei ole oikeuksia WFS-toimintoihin, vain WMS-toimintoihin.  -Poista lopuksi edellisessä kuvassa näkyvä sääntö (wms.\*), jotta wms-palvelu olisi taas käytettävissä kaikilla käyttäjillä. +Poista lopuksi edellisessä kuvassa näkyvät säännöt (\*.\* ja wms.\*), jotta WMS-palvelu olisi taas käytettävissä kaikilla käyttäjillä. diff --git a/src/GS006/13_harjoitus_13.Rmd b/src/GS006/13_harjoitus_13.Rmd index 4eb302df..b976394c 100644 --- a/src/GS006/13_harjoitus_13.Rmd +++ b/src/GS006/13_harjoitus_13.Rmd @@ -1,4 +1,4 @@ -# Harjoitus 2.6: Suodattimet +# HARJOITUS 2.6: SUODATTIMET **Harjoituksen sisältö** @@ -6,7 +6,7 @@ Harjoituksessa tutustutaan CQL- (Common Query Language) ja ECQL-suodattimeen (Ex **Harjoituksen tavoite** -Harjoituksen jälkeen oppilas osaa muodostaa ominaisuus- ja geometriatietoihin perustuvia suodattimia. +Harjoituksen jälkeen opiskelija osaa muodostaa ominaisuus- ja geometriatietoihin perustuvia suodattimia. **Arvioitu kesto** @@ -50,13 +50,13 @@ Missä osavaltioissa on enemmän miespuolisia asukkaita? ::: ::: hint-box -Mitkä osavaltiot leikkaavat 100º läntistä pituuspiiriä? +Mitkä osavaltiot leikkaavat 100. asteen läntistä pituuspiiriä? Psst! Lauseke on muotoa “BBOX(geometriasarake, xmin, ymin, xmax, ymax)”. Osavaltioiden geometria on kentässä “the_geom”. ::: GeoServerin dokumentaatiosta löytyy tarkempia kuvauksia (**Tutorials → CQL and ECQL**). -Suodata **topp:states**-tason WMS-palvelua siten, että ainoastaan ne osavaltiot, joiden työttömyysprosentti on alle 5 % näkyvät palvelussa. +Suodata **topp:states**-tason WMS-palvelua siten, että ainoastaan ne osavaltiot, joiden työttömyysprosentti on alle 5% näkyvät palvelussa. Muodosta topp:states-tasolle kuvaustekniikka, jossa piirretään osavaltioiden keskipisteeseen punainen symboli. diff --git a/src/GS006/index.Rmd b/src/GS006/index.Rmd index 6e86262d..9e92551f 100644 --- a/src/GS006/index.Rmd +++ b/src/GS006/index.Rmd @@ -1,6 +1,6 @@ --- title: "Johdanto GeoServerin käyttöön" -author: "Gispo Suomi Oy." +author: "Gispo Oy" date: "`r Sys.Date()`" site: "bookdown::bookdown_site" abstract: "Johdantokurssi GeoServerin käyttöön" @@ -10,18 +10,19 @@ output: theme: null template: custom.html css: custom.css - split_by: rmd - number_sections: false + split_by: chapter+number #rmd documentclass: book --- -# Johdanto GeoServerin käyttöön + + +# JOHDANTO GEOSERVERIN KÄYTTÖÖN ## Tervetuloa GeoServer-kurssille! Tämän kurssin tarkoituksena on opastaa sinut GeoServerin käyttöön. Paikkatietojen tai muiden paikkatieto-ohjelmistojen käyttökokemus ei ole välttämätöntä koulutukseen osallistumisel­le. Toki niistä on paljon hyötyä. Kysy rohkeasti opettajalta lisätietoja, jos käytetty terminologia tai joku asia jää epäselväksi. ## GeoServerin taustaa -GeoServer on avoimen lähdekoodin palvelinohjelmisto, jossa voi jakaa, käsitellä ja hallinnoida geospatiaalista dataa. GeoServer on ollut toiminnassa vuodesta 2001 alkaen “The Open Planning Project” -hankkeen kautta. Vuonna 2014 GeoServer siirtyi OSGeo-projektin alle. GeoServeriä päivitetään puolen vuoden välein ja ohjelmiston käyttäjäkunta on varsin vilkas ja aktiivinen. +GeoServer on avoimen lähdekoodin palvelinohjelmisto, jossa voi jakaa, käsitellä ja hallinnoida geospatiaalista dataa. GeoServer on ollut toiminnassa vuodesta 2001 alkaen “The Open Planning Project”-hankkeen kautta. Vuonna 2014 GeoServer siirtyi OSGeo-projektin alle. GeoServeriä päivitetään puolen vuoden välein ja ohjelmiston käyttäjäkunta on varsin vilkas ja aktiivinen. ## Lukuohje @@ -35,9 +36,7 @@ GeoServer on avoimen lähdekoodin palvelinohjelmisto, jossa voi jakaa, käsitell **Komentorivillä** suoritettavat komennot on merkitty seuraavasti: ::: commandline-box -``` shell sudo lsb_release -a -``` ::: **Tiedostojen sisältö** on esitetty seuraavasti: @@ -49,9 +48,7 @@ sudo lsb_release -a **HTML- ja CSS-koodit, SQL-komennot sekä Python-scriptit** on esitetty seuraavasti: ::: code-box -``` sql SELECT version(); -``` ::: **Kysymykset, lisätiedot ja vihjeet** on esitetty seuraavasti: @@ -69,33 +66,29 @@ Psst! Tietoa GeoServeristä löydät internetistä. Ohessa muutamia web-sivustoja, joista saat lisätietoja: ::: note-box - + ::: ::: note-box - + ::: ::: note-box - + ::: ::: note-box - + +::: + +::: note-box + ::: ## Virheet -Jos havaitset materiaalissa virheitä, niin pyydämme ilmoittamaan niistä kouluttajalle tai sähköpostilla osoitteeseen [info\@gispo.fi](mailto:info@gispo.fi){.email}. +Jos havaitset materiaalissa virheitä, pyydämme ilmoittamaan niistä kouluttajalle tai sähköpostilla [info\@gispo.fi-osoitteeseen](mailto:info@gispo.fi-osoitteeseen){.email}. ## Lisenssi ja oikeudet -Nämä materiaalit on "Johdanto GeoServerin käyttöön" -kurssille kehittänyt Gispo Suomi Oy. Materiaalit on lisensoitu seuraavalla lisenssillä: [CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0/) - -## Materiaali PDF-muodossa - -Voit ladata harjoitukset PDF-muodossa tästä linkistä: - -::: note-box -[Harjoitukset PDF-muodossa](https://github.com/gispocoding/master-training-data/releases/download/GS006/GS006.pdf) -::: +Nämä materiaalit on "Johdanto GeoServerin käyttöön" -kurssille kehittänyt Gispo Oy (nyk. Gispo Suomi Oy). Materiaalit on lisensoitu seuraavalla lisenssillä: [CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0/) diff --git a/src/GS006_eng/01_exercise_1.Rmd b/src/GS006_eng/01_exercise_1.Rmd index 868e5e7e..34af2c80 100644 --- a/src/GS006_eng/01_exercise_1.Rmd +++ b/src/GS006_eng/01_exercise_1.Rmd @@ -1,4 +1,4 @@ -# Exercise 1.1: Installation and commissioning +# EXERCISE 1.1: INSTALLATION AND COMMISSIONING **Content of the exercise** @@ -34,7 +34,7 @@ The **Main menu (2)** is used to manage and view the server's functions. The **Top bar (3)** contains login information and the GeoServer logo, which always takes you to the home page. -The **sidebar (4)** on the right side shows the map services and their versions supported by the server in the home screen. +The **sidebar (4)** on the right side shows the map services and their versions supported by the server in the home screen. This section is in the middle of the page in the newer version of the GeoServer. ## **Main menu** @@ -58,13 +58,13 @@ Try **Layer Preview function** and preview the default GeoServer datasets. This ### **Service Capabilities** -Press **GeoServer-logo** to return to the main server page. On the right hand side you will find the **Service Capabilities bar**. +Press **GeoServer-logo** to return to the main server page. Before logging in to the server, you can see which interface services can be published by the GeoServer installation you are using. By default, WCS, WFS, WMS, TMS, WMS-C and WMTS are installed on the GeoServer of the exercise. Other interface services, such as the WPS service, can be published to GeoServer via extensions. By pressing the version numbers on the interface services, you can access their capabilities. -This sidebar is only visible on the home page. Remember that you can always access the home page by pressing the GeoServer logo. +This section is only visible on the home page. Remember that you can always access the home page by pressing the GeoServer logo. ### **Demos** diff --git a/src/GS006_eng/02_exercise_2.Rmd b/src/GS006_eng/02_exercise_2.Rmd index c4d02468..b4eea1b3 100644 --- a/src/GS006_eng/02_exercise_2.Rmd +++ b/src/GS006_eng/02_exercise_2.Rmd @@ -1,10 +1,10 @@ -# Exercise 1.2: GeoServer web interface +# EXERCISE 1.2: GEOSERVER WEB INTERFACE **Content of the exercise** The exercise will introduce you to the main functions of GeoServer through the user interface. The main options and main features of the different sections of the interface will be discussed. -**Aim of the exercise** +**The aim of the exercise** After the exercise, the student will understand how GeoServer works and the management tools of the different sections. @@ -16,7 +16,7 @@ After the exercise, the student will understand how GeoServer works and the mana In the previous exercise, we went thorugh some of the menus in the GeoServer web interface. Accessing these menus and functions did not require a login. In this exercise, we will log in to the GeoServer web interface as administrators, which will open up more menus and functions. -## **Administrator interface** +## **Administrator's interface** Until now, the interface has only displayed the functionalities and resources open to all (without authentication). These can be restricted on a per-user basis through different access control settings. The basics of access control will be introduced later in the course. @@ -26,7 +26,7 @@ Now log in to the server using **admin** as ID and **gispo** as password. Psst! The default password for GeoServer is 'geoserver', but for training purposes this has been changed for security reasons. ::: -The administrator view is similar to the interface we just saw. The structure is the same but there is much more functionality and information available. +The administrator's view is similar to the interface we just saw. The structure is the same but there is much more functionality and information available. The GeoServer functions in the main menu are grouped according to their purpose: @@ -128,7 +128,7 @@ The output of the layers can be raster or vector, the format is described by the The layer preview opens as an OpenLayers map window in a new browser window. Note that the **OpenLayers** preview of the data uses a styling technique that is defined as the default on GeoServer. More information on this topic will be provided later. -Using the drop-down menu (**Select one**), you can also download this layer in different file formats (GeoTIFF, csv, shapefile\...). +Uisng the drop-down menu (**Select one**), you can also download this layer in different file formats (GeoTIFF, csv, shapefile\...). ### **Workspaces** @@ -154,7 +154,7 @@ If you check **Isolated Workspace** choice the content of the workspace will not Psst! URI (Uniform Resource Identifier) is a text that defines the name of a particular resource. It can be a web address or even a relative directory on a hard drive. ::: -Press **Save** and you have now added a new workspace to GeoServer. +Press **Submit** and you have now added a new workspace to GeoServer. Open the workspace you just created by clicking on **helsinki** workspace under the **Workspace Name** and you will see that more choices are now available. We will return to these later when adjusting the workspace-specific settings. diff --git a/src/GS006_eng/03_exercise_3.Rmd b/src/GS006_eng/03_exercise_3.Rmd index 859571f1..1f7ba91f 100644 --- a/src/GS006_eng/03_exercise_3.Rmd +++ b/src/GS006_eng/03_exercise_3.Rmd @@ -1,4 +1,4 @@ -# Exercise 1.3: Vector data +# Exercise 1.3: VECTOR DATA **Content of the lecture** @@ -14,7 +14,7 @@ After the exercise, the student will be able to add vector data and make the nec ## **Preparation** -All training materials are in the GeoServer data directory **/data/koulutus/**. You can check its location on your server in the **Server Status** view. The location is in the **Data directory** field. New data can be added there if necessary.  +All training materials are in the GeoServer data directory **/data/koulutus/**. You can check its location on your server in the **Server Status** view. The location is in the **Data directory** field; new data can be added there if necessary.  The materials used in the exercise are uploaded to the servers in use. @@ -46,7 +46,7 @@ Since the format of the data is **shapefile**, a **store** compatible with the s From the main menu, select **Stores** and then press **Add new Store**. -Select Shapefile as the data format in the **New data source** view, under **Vector Data Sources**. +Select Shapefile as the data format in the **New data source** view, under**Vector Data Sources**. ![](img/harjoitus_3/image2.png) @@ -66,7 +66,7 @@ The next step is to define which data (shape file) is referenced by this store. Keep **Enabled** checked to ensure that the store (and the layers created from it) are available from the GeoServer server. This option can be used if you want to hide some data from users without removing it from the server (administrators can still access it). -Check again that the **DBF charset** value is **UTF-8**. +Check again that the **DBF charset** value is **ISO-8859-1**. The rest of the settings can be kept as defaults. @@ -126,7 +126,7 @@ In this case, the project data comes from the .prj file of the shapefile. Click Psst! Please note that the Native SRS data is for preview purposes only. The data comes directly from the settings of the original data, e.g. shapefile or PostGIS coordinate system data. Therefore, they cannot be edited in the GeoServer browser through the interface. ::: -Enter **EPSG:4326** code in the **Declared SRS** field. You can also search for EPSG codes using the **Find** function. +If necessary, add the *EPSG:4326* code to the *Declared SRS* field. You can also search EPSG codes using the *Find* function. Keep the default value of **SRS handling** (**Force declared**) unchanged. @@ -170,6 +170,6 @@ Zoom in on the map and press on a building to see its properties. ## **Add Helsinki road network** -Now add the OpenStreetMap Helsinki road network to GeoServer in the same way as in the previous exercise. The data can be found in the same folder as the **buildings** data, under the name **roads.shp**. +Now add the OpenStreetMap Helsinki road network to GeoServer in the same way as in the previous exercise. The data can be found in the same folder as the **buildings** data, under the name **gis.osm_roads_free_1**. -Remember that before you can add a layer to GeoServer, you need to create a store for it. Name the new store **hki_roads** and the layer created from it **roads** so the layer names remain similar. Remember to also correct the coordinate system (**EPSG:4326**) and **DBF charset** (**UTF-8**). +Remember that before you can add a layer to GeoServer, you need to create a store for it. Name the new store **hki_roads** and the layer created from it **roads** so the layer names remain similar. Remember to also check the coordinate system (**EPSG:4326**) and **DBF charset** (**ISO-8859-1**). diff --git a/src/GS006_eng/04_exercise_4.Rmd b/src/GS006_eng/04_exercise_4.Rmd index 3656d6d0..348f5a75 100644 --- a/src/GS006_eng/04_exercise_4.Rmd +++ b/src/GS006_eng/04_exercise_4.Rmd @@ -1,4 +1,4 @@ -# Exercise 1.4: Basics of styling (SLD) +# EXERCISE 1.4: BASICS OF STYLING (SLD) **Content of the exercise** @@ -16,13 +16,9 @@ After the exercise, the student will be able to use basic styling techniques on Start a web browser on your computer and log in at: -::: note-box - -::: +In the previous exercises, a layer **Buildings** has been created on the GeoServer server, where the styling technique will now be created. -In the previous exercises, a layer **Buildings** has been created on the GeoServer server. In this exercise a styling technique will be created for this layer. - -## **GeoServer styling technique** +## **GeoServerin styling technique** WMS services visualize map images in GeoServer using predefined styling techniques. Until now, we have used the default stylings whenever we added new data, for example when we previewed a layer. @@ -30,6 +26,8 @@ From the main menu, open the **Layers** view and the **Buildings** layer. Then o Note that under **WMS Settings**, you will find the **Default Style** menu with **polygon** style selected. +\ + ![](img/harjoitus_4/image2.png) ## **SLD-styling** @@ -68,7 +66,7 @@ You can now test the SLD code with the **Validate** function. Successful testing ![](img/harjoitus_4/image6.2.png) -Save the changes by pressing **Submit** first. +Save the changes by pressing **Apply** first. ## **Deployment of SLD styling technique** @@ -86,11 +84,11 @@ From the **Data → Layer Preview** view, you can now preview the **buildings** ## **SLD Cookbook** -You can find out more about writing SLD styles on the SLD Cookbook website. The SLD Cookbook is part of GeoServer online documentation and contains various examples of styling techniques. +You can find out more about writing SLD styles on the SLD Cookbook website. The SLD Cookbook is part of GeoServer's online documentation and contains various examples of styling techniques. Let's use an example from the **SLD Cookbook** as a basis for our new style. -In a new browser window, open GeoServer SLD Cookbook from the link below (or you can Google "geoserver sld cookbook" in your browser). Look for **Polygon with styled label** and click on it: +In a new browser window, open GeoServer's SLD Cookbook from the link below (or you can Google "geoserver sld cookbook" in your browser). Look for **Polygon with styled label** and click on it: ::: note-box @@ -106,7 +104,7 @@ In addition to the standard SLD language, this model code includes two GeoServer On the sample SLD styles page, find the **View and download the full "Polygon with styled label" SLD** link, open it in a new window and save the page as an .sld file, using the browser's save as function. Give the file a name that you will remember later (for example polygon_polygonwithstyledlabel.sld). -Now return to the GeoServer interface and click **Browse** under the code box. Find the newly uploaded SLD style on the disk and press **Upload** +Now return to the GeoServer interface and click **Browse** above the code box. Find the newly uploaded SLD style on the disk and press **Upload** ![](img/harjoitus_4/image8.png) @@ -132,7 +130,7 @@ Modify the SLD style of the polygon as follows: Psst! Note that in GeoServer only dot "." is used as a decimal separator. This is valid for all GeoServer settings. ::: -Then press **Submit** first to save the changes. +Then press **Apply** first to save the changes. Finally, change the **Buildings** layer to **Buildings** style (**Data → Layers → Buildings → Publishing**). @@ -167,13 +165,13 @@ The SLD code in the window looks like this: Then press **Validate**. -If you get error messages or the code does not work, ask the trainer for help. Otherwise, press **Submit** to save the style. +If you get error messages or the code does not work, ask the trainer for help. Otherwise, press **Apply** to save the style. The updated style is immediately available on the server and can be previewed using the **buildings** layer. You can update the browser window by pressing the **F5** key or **CTRL+R** keys. ![](img/harjoitus_4/image11.2.png) -Visit to learn about different visualisation styles and choose the right colours for your visualisation. +At you can learn about different visualisation styles and choose the right colours for your visualisation. ## **Create a road style** @@ -195,15 +193,15 @@ Find **\** inside the paragraph **\** and add this below it: ![](img/harjoitus_4/image13.png) -Then press **Submit**. +Then press **Apply**. Set the default style of the roads layer to **roads style** (**Data → Layers → helsinki:roads → Publishing**). ![](img/harjoitus_4/image14.2.png) -Press **Save** and preview the layer. Note that when you zoom the map to a scale smaller than 1:32 000, the roads will no longer be visible. +Press **Save** and preview the layer. Note that when you zoom the map to a scale bigger than 1:32 000, the roads will no longer be visible. -Let's add roads also at a scale of 1:32 000 and larger. This is done by creating a **\** partition with the maximum scale (**\**) set to **32000**. +Let's add roads also at a scale of 1:32 000 and larger. This is done by creating a **\** partition with the minimum scale (**\**) set to **32000**. To make use of the previous rule partition: copy the whole **\** section. Paste it after **\**. @@ -225,7 +223,7 @@ Change the line colour to grey **#666666**, the title to **Thick line** and the ![](img/harjoitus_4/image16.2.png) -Press **Submit** and preview. Note that now when you zoom in on the map window (increase the scale), the colour and thickness of the roads will change. +Press **Apply** and preview. Note that now when you zoom in on the map window (increase the scale), the colour and thickness of the roads will change. Add a new rule to add a filling colour to the lines. Copy the previous piece of **\** code (with \32000\) and paste it as a continuation of the copied piece. diff --git a/src/GS006_eng/05_exercise_5.Rmd b/src/GS006_eng/05_exercise_5.Rmd index 6849aefb..32d0b283 100644 --- a/src/GS006_eng/05_exercise_5.Rmd +++ b/src/GS006_eng/05_exercise_5.Rmd @@ -1,4 +1,4 @@ -# Exercise 1.5: WMS and WCS services +# EXERCISE 1.5: WMS AND WCS SERVICES **Content of the exercise** @@ -72,7 +72,7 @@ Then use **Browse\...** to select the GeoServer logo (**/training/GeoServer_100. Set the transparency to **30** and the position to **Bottom right**. -Now press **Submit** to save the changes to the WMS service. All maps received via the WMS service map should now contain a watermark. +Now press **Apply** to save the changes to the WMS service. All maps received via the WMS service map should now contain a watermark. Open **Data → Layer Preview**, and preview some layers. Check that the watermark appears in all WMS requests. @@ -124,7 +124,7 @@ Psst! The DPI value is set low by default to avoid overloading the server and to It is possible to specify other screen resolutions for services by modifying the parameters of WMS map requests. -Now try to preview **poly_landmarks** as a JPEG image. You can easily find the layer in the **Layer preview** view: ![](img/harjoitus_5/image6.png) +Now try to preview **poly_landmarks-** as a JPEG image. You can easily find the layer in the **Layer preview** view: ![](img/harjoitus_5/image6.png) The result is a map image in JPEG format at the default resolution of 90 DPI:\ ![](img/harjoitus_5/image7.png) @@ -135,8 +135,8 @@ If you enlarge the image in your browser (or save it to your hard drive and view Select and copy the full text of the address in the browser. Open a text editor and paste the text into it. It is an http request to your GeoServer server and resembles the following text: -::: code-box -http://xx.xx.xx.xx:8080/geoserver/tiger/wms?service=WMS&version=1.1.0&request=GetMap &layers=tiger:poly_landmarks&styles=&bbox=-74.047185,40.679648,-73.90782,40.882078 **&width=528&height=768**&srs=EPSG:4326**&format=image%2Fjpeg** +::: note-box +[http://xx.xx.xx.xx:8080/geoserver/tiger/wms?service=WMS&version=1.1.0&request=GetMap &layers=tiger:poly_landmarks&styles=&bbox=-74.047185,40.679648,-73.90782,40.882078 **&width=528&height=768**&srs=EPSG:4326**&format=image%2Fjpeg**](http://xx.xx.xx.xx:8080/geoserver/tiger/wms?service=WMS&version=1.1.0&request=GetMap%20&layers=tiger:poly_landmarks&styles=&bbox=-74.047185,40.679648,-73.90782,40.882078%20&width=528&height=768&srs=EPSG:4326&format=image%2Fjpeg) ::: The text highlights the most important parameters concerning the WMS image. They can be interpreted as follows: diff --git a/src/GS006_eng/06_exercise_6.Rmd b/src/GS006_eng/06_exercise_6.Rmd index 0e37f65e..f3a5111b 100644 --- a/src/GS006_eng/06_exercise_6.Rmd +++ b/src/GS006_eng/06_exercise_6.Rmd @@ -4,7 +4,7 @@ editor_options: wrap: sentence --- -# Exercise 1.6: Raster data +# EXERCISE 1.6: RASTER DATA **Content of the exercise** @@ -26,9 +26,12 @@ A few raster files have been uploaded to the data directory of the GeoServer ser ## **Adding raster data** -Adding raster data to GeoServer is done in much the same way as in the previous exercises with vector data. We now load a raster file into GeoServer for use, the original format of which is **ArcGrid** (ASCII-based raster format). The raster data is a height model of the Helsinki area from National Land Survey of Finland (grid size 2 m x 2 m). +Adding raster data to GeoServer is done in much the same way as in the previous exercises with vector data. +We now load a raster file into GeoServer for use, the original format of which is **ArcGrid** (ASCII-based raster format). +The raster data is a height model of the Helsinki area from National Land Survey of Finland (grid size 2 m x 2 m). -First, we need to create a reference to the data so that GeoServer knows where the data is physically located. Remember that this is done by creating stores. +First, we need to create a reference to the data so that GeoServer knows where the data is physically located. +Remember that this is done by creating stores. Create a new store by selecting **Stores → Add new Store**. Then click **ArcGrid** for the store format. @@ -51,10 +54,9 @@ Set the name to **elevation model** and the title to **Helsinki elevation model* Note that in **Coordinate Reference Systems**, the coordinate system is incorrectly defined. The correct system for the data is **ETRS89 / ETRS-TM35FIN** (**EPSG:3067**). Correct it manually in the **Declared SRS** field and select **SRS handling** in the **Force declared** field, then use the shortcuts to determine the extent of the data. - ![](img/harjoitus_6/image3.png) -Press **Save.** +Then press **Save.** Check that the layer is in the **Data → Layers** table. You can preview the new raster layer via the **Data → Layer Preview** window.\ @@ -99,7 +101,7 @@ Enter a name and an explanation, for example as shown in the following picture: ![](img/harjoitus_6/image6.2.png) -Press **Save** and then press **Publish** to publish the layer. +Then press **Save** and then press **Publish** to publish the layer. Name the layer **Aerialimages_ofthecitycentre** and title it **Aerial images of the city centre of Helsinki**. For additional information you can write for example **Aerial images of Helsinki - National Land Survey of Finland 2014**. @@ -213,7 +215,7 @@ Add the City of Helsinki's open spatial data services to our GeoServer as a new This City of Helsinki service can be found at:  ::: note-box - [https://kartta.hel.fi/ws/geoserver/avoindata/wms?REQUEST=Getcapabilities](https://kartta.hel.fi/ws/geoserver/avoindata/wms?REQUEST=Getcapabilities). + [**https://kartta.hel.fi/ws/geoserver/avoindata/wms?REQUEST=Getcapabilities**](https://kartta.hel.fi/ws/geoserver/avoindata/wms?REQUEST=Getcapabilities). ::: Fill in the information as shown in the following image, put the above address in the **Capabilities URL** field: diff --git a/src/GS006_eng/07_exercise_7.Rmd b/src/GS006_eng/07_exercise_7.Rmd index fef701c8..b5bc2a6b 100644 --- a/src/GS006_eng/07_exercise_7.Rmd +++ b/src/GS006_eng/07_exercise_7.Rmd @@ -1,4 +1,4 @@ -# Exercise 1.7: Spatial databases +# EXERCISE 1.7: SPATIAL DATABASES **Content of the exercise** @@ -115,7 +115,7 @@ GeoServer also allows SQL queries to be used to share spatial data sets. Let's add again **lipas_kaikki_reitit** data as a new layer on the server. The goal is to create a layer where only data from Helsinki is displayed. -Here it will be named **lipas_kaikki_reitit_helsinki**. +I will name it **lipas_kaikki_reitit_helsinki**. ::: hint-box Psst! An SQL view could also be created directly in the database and use that view to create a layer. @@ -147,7 +147,7 @@ Then check that **SRID** in the **geom** field is specified with the correct EPS ![](img/harjoitus_7/image11.png) -Press **Save**. +Then press **Save**. Next, define the dimensions of the layer (Bounding Box) and press **Save**. You can now preview the Helsinki liikuntareitit layer. ![](img/harjoitus_7/image12.png) @@ -169,6 +169,6 @@ FROM lipas.reitit WHERE kunta_nimi = 'Helsinki' ::: -Update the format of the attributes again and press **Save**. ![](img/harjoitus_7/image13.png) +Update the format of the attributes again and then press **Save**. ![](img/harjoitus_7/image13.png) In the preview, you will notice that the route data is now buffered by 10 metres: ![](img/harjoitus_7/image14.png) diff --git a/src/GS006_eng/08_exercise_8.Rmd b/src/GS006_eng/08_exercise_8.Rmd index 869914e1..421328ee 100644 --- a/src/GS006_eng/08_exercise_8.Rmd +++ b/src/GS006_eng/08_exercise_8.Rmd @@ -1,8 +1,8 @@ -# Exercise 2.1: WFS services +# EXERCISE 2.1: WFS SERVICES **Content of the exercise** -The exercise will introduce the student to the settings and functionality of the WFS map services. +The exercise will introduce you to the settings and functionality of the WFS map services. **Aim of the exercise** @@ -34,7 +34,7 @@ The WFS-specific settings can be found below, which define how WFS-specific serv To test this function, set the value of these features to **1**. -Press **Submit**. +Then press **Submit**. Then view the **tiesto** layer through the WFS interface via the Layer Preview GML preview or e.g. with the QGIS application. @@ -166,14 +166,14 @@ First you need the address of the WFS service. For example, you can get this fro The address will be in the format: -::: code-box -http://%3Cip.address%3E:8080/geoserver/ows?service=wfs&version=1.1.0&request=GetCapabilities +::: note-box + ::: With GeoServer's default settings, a workspace-specific address is obtained by adding the workspace URI to the address. For example, the address of a helsinki workspace would be: -::: code-box -http://%3Cip.address%3E:8080/geoserver/ows?service=wfs&version=1.1.0&request=GetCapabilities +::: note-box + ::: Open QGIS from the desktop icon. Add a new WFS service and paste the address you just copied into the URL field. Also enter your username (admin) and password (gispo). @@ -192,8 +192,8 @@ To add a new store (**Data → Stores → Add new Store**), select **Web Feature The Lipas-WFS service will be added. Name the new vector-store **lipas_WFS** and set **WFS GetCapabilities URL**: -::: code-box -http://lipas.cc.jyu.fi/geoserver/lipas/ows?service=WFS&REQUEST=Getcapabilities +::: note-box + ::: ![](img/harjoitus_8/image10.png) @@ -206,7 +206,7 @@ The new store will contain the map layers that were shared on the original WFS s You can publish layers directly from the service. For example, publish **lipas_excursion_map_routes**. Right click on **Publish** and define **Bounding Boxes** as usual. -Press **Save**. +Then press **Save**. You can now preview the new layer (the default name will be **Excursion_routes**). diff --git a/src/GS006_eng/09_exercise_9.Rmd b/src/GS006_eng/09_exercise_9.Rmd index 9eb13c84..5a37e05d 100644 --- a/src/GS006_eng/09_exercise_9.Rmd +++ b/src/GS006_eng/09_exercise_9.Rmd @@ -1,8 +1,8 @@ -# Exercise 2.2: Map tile services +# EXERCISE 2.2: MAP TILE SERVICES **Content of the exercise** -In this exercise we will use map tiles and grid creation tools available in GeoServer. +We will use map tiles and grid creation tools available in GeoServer in this exercise. **Aim of the exercise** @@ -14,7 +14,7 @@ After the exercise, the student will be able to create and configure their own m ## **Preparation** -Several raster and vector datasets have been uploaded and published on the GeoServer server. The GeoServer default installation also includes GeoWebCache, which GeoServer uses to create and manage map tiles. +Several raster and vector datasets have been uploaded and published on the GeoServer server. GeoServer's default installation also includes GeoWebCache, which GeoServer uses to create and manage map tiles. ## **Tile Caching** @@ -77,15 +77,14 @@ In the **GeoWebCache** view at the top of the page you will find general functio For creating tiles, the settings can be found at the bottom of the page in the **Create a new task** section. -| | | -|---------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| **Number of tasks to use** | Specifies how many processes to start to create map tiles | -| **Type of operation** | Type of operation for creating tiles \| Reseed: create all map tiles, replace old map tiles \| Seed: create only the missing map tiles \| Truncate: remove map tiles from the server | -| **Grid set** | Specifies which map tiles are created on which map tiles grid | -| **Format** | Map image file format (e.g. jpg, png) | -| **Zoom start, Zoom stop** | Scale intervals for the map tiles to be created (scales are defined for the map tiles) | -| **Bounding box** | The rectangular delineation of the location from which the map tiles are generated | - +| | | +|--------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **Number of tasks to use** \| Specifies how many processes to start to create map tiles \| | | +| | **Type of operation** \| Type of operation for creating tiles \| \| \| \| Reseed: create all map tiles, replace old map tiles \| \| \| \| Seed: create only the missing map tiles \| \| \| \| Truncate: remove map tiles from the server \| | +| **Grid set** | Specifies which map tiles are created on which map tiles grid \| | +| **Format** | Map image file format (e.g. jpg, png) \| | +| **Zoom start, Zoom stop** | Scale intervals for the map tiles to be created (scales are defined for the map tiles) \| | +| **Bounding box** | The rectangular delineation of the location from which the map tiles are generated | Set **Number of tasks to use** to 1. @@ -97,17 +96,13 @@ Set the task settings as follows, paying particular attention to the **Zoom stop Press **Submit**. -GeoServer (GeoWebCache) will now generate map tiles of the selected service from scale levels 0--15. +GeoServer (GeoWebCache) will now generate map tiles of the selected service from scale levels 0--15.. During the generation process, the interface allows you to monitor the completion of the map tiles: -![](img/harjoitus_9/image9.png) - Click on the **Refresh list** link to refresh information on the progress of the calculation. -The map tile grid definition and the layer position delimitation indicate that 1 922 map tiles are required for scales 0-15. With these settings, it takes about a minute to draw the images on the remote server. - -![](img/harjoitus_9/image10.png) +The map tile grid definition and the layer position delimitation indicate that 1 922 map tiles are required for scales 0-15. With these settings, it takes about a minute to draw the images on the remote server. ![](img/harjoitus_9/image10.png) Note that map tiles are created by default according to the boundary of the layer location (unless otherwise specified). ![](img/harjoitus_9/image11.2.png) @@ -137,7 +132,7 @@ To see the data, you must first specify how much hard disk space the map tile se Go back to **Tile Caching** → **Disk Quota** for a moment, check **Enable disk quota** and set **Maximum tile cache size** to **2 GiB**. ![](img/harjoitus_9/image16.2.png) -Finally, press **Submit** to save the settings. +Finally, press **Save** to save the settings. ::: hint-box Psst! The abbreviations GiB and GB are used in the interface. The difference comes from the fact that GiB (Gibibyte) is a binary system multiple while GB (Gigabyte) is a decimal system multiple: GiB is 1024 MiB and 230 bytes → 1 073 741 824 bytes GB is 1000 MB and 109 bytes → 1 000 000 000 000 bytes. @@ -145,7 +140,7 @@ Psst! The abbreviations GiB and GB are used in the interface. The difference com Note also that the **When enforcing disk quota limits, remove tiles that are** option means that GeoServer/GeoWebCache will not stop creating map tiles even if the specified maximum disk usage for map tiles is reached. After the allowed disk space has been filled, the server will automatically start removing either the least used or the longest unused map tiles. This means that map tiles are continuously generated even if the maximum disk space limit is reached. -Press **Submit** and return to **Tile Caching → Tile Layers** view. +Press **Save** and return to **Tile Caching → Tile Layers** view. Check that the **Disk Used** column now shows the necessary information. Aerial image tiles currently take up less than 500 megabytes. Other layers do not use any disk space. ![](img/harjoitus_9/image17.2.png) @@ -177,26 +172,30 @@ Open **Tile Caching → Gridsets** and then click on the grid named **EPSG:4326* Definitions of the map tile grid include: -| | | -|--------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------| -| **Coordinate Reference System** | The coordinate system used to define the grids.  | -| **Gridset bounds** | The location delimiter for the map sheet layer, which specifies the location to which the map tile grid is delimited. | -| **Tile Matrix Set** | A map tile model (image pyramid) that defines the scales selected for the map tile grid. This can be defined either by resolution or by scale. | +| | | +|---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------| +| **Coordinate Reference System** | The coordinate system used to define the grids.  \| | +| **Gridset bounds** | The location delimiter for the map sheet layer, which specifies the location to which the map tile grid is delimited. | +| **Tile Matrix Set** | A map tile model (image pyramid) that defines the scales selected for the map tile grid. This can be defined either by resolution or by scale. \| | You can also create map tiles to suit your own needs. +## ** Additional tasks** + +If there is time, you can continue from here by doing additional tasks. + ## **Map tile grid according to JHS180** The JHS180 Recommendation includes a recommendation for a national map tile grid based on the OGC standards specifications. Among others, the following definitions can be found in the recommendation: -| | | -|--------------------------------------------|-----------------------------------------------------------------------------------------------------------------| -| **Interface standard** | OGC's WMS-T standard | -| **Coordinate reference system** | ETRS89 / TM35-FIN (EPSG:3067) | -| **Usable origo** | East -548 576 m, North 8 388 608 m (anchor point of tiles is upper left corner) | -| **Resolution levels** | 0.25 m, 0.5 m, 1 m, 2 m, 4 m, 8 m, 16 m, 32 m, 64 m, 128 m, 256 m, 512 m, 1 024 m, 2 048 m, 4 096 m ja 8 192 m | -| **Size of tiles in pixels** | 256\*256 pixels | -| **Image format** | Image/png | +| | | +|--------------------------------------------------------------------------------------------------------------------------------------------|-------------------------| +| **Interface standard** | OGC's WMTS standard \| | +| **Coordinate reference system** \| ETRS89 / TM35-FIN (EPSG:3067) | | +| **Usable origo** \| East -548 576 m, North 8 388 608 m (anchor point of tiles is upper left corner) \| | | +| **Resolution levels** \| 0.25 m, 0.5 m, 1 m, 2 m, 4 m, 8 m, 16 m, 32 m, 64 m, 128 m, 256 m, 512 m, 1 024 m, 2 048 m, 4 096 m ja 8 192 m \| | | +| **Size of tiles in pixels** \| 256\*256 pixels \| | | +| **Image format** \| Image/png \| | | With these definitions, at the coarsest resolution level (level 0) there is only one tile image of size 2 097 152 m \* 2 097 152 m (8 192\*8 192 pixels). The north-south centreline of this image file lies on the centreline of the projection strip (27 degrees). And the north coordinate of the northern edge of the tile is a multiple of the size of the tile from the equator (4 \* 2 097 152). @@ -220,7 +219,7 @@ The recommendations say that the coordinates of the upper left corner (origo) ar **Max Y** is then: 8388608 -- 2097152 = **6 291 456** m -| | Coverage of the JHS180 grid | +| | **Coverage of the JHS180 grid** \| | |--------------------|------------------------------------| | Min X: -548 576 m | Max X: 1 548 576 m | | Min Y: 6 291 456 m | Max Y: 8 388 608 m | @@ -248,7 +247,7 @@ Under **Tiles** you can check how many tiles are needed on each side of each lay Finally, press **Save** to make the new JHS180 mapping grid available on your server.\ ![](img/harjoitus_9/image23.2.png) -## **Finland OpenStreetMap road network** +## **Finland's OpenStreetMap road network** Our newly created gridset is suitable for data covering the whole of Finland. @@ -287,6 +286,7 @@ In the preview, the EPSG:3067 map tile grid you created is in use (note below ho ![](img/harjoitus_9/image27.png) +\ ![](img/harjoitus_9/image28.png) ## **Create a local map tile grid** diff --git a/src/GS006_eng/10_exercise_10.Rmd b/src/GS006_eng/10_exercise_10.Rmd index 041099eb..8f562712 100644 --- a/src/GS006_eng/10_exercise_10.Rmd +++ b/src/GS006_eng/10_exercise_10.Rmd @@ -1,8 +1,8 @@ -# Exercise 2.3: Architecture and deployment +# EXERCISE 2.3: ARCHITECTURE AND DEPLOYMENT **Content of the exercise** -This exercise will introduce the student to the GeoServer logs and the different settings that affect performance. +This exercise will introduce you to the GeoServer logs and the different settings that affect performance. **Aim of the exercise** @@ -18,9 +18,7 @@ The GeoServer server has been loaded with various data and the GeoServer **Monit ## **General information about the GeoServer server** -Open **About & Status → Server Status** from the left bar of GeoServer. - -![](img/harjoitus_10/image1.png) +Open **About & Status → Server Status** from the left bar of GeoServer. ![](img/harjoitus_10/image1.png) The **Locks** function allows you to check existing locks on WFS-T data. If necessary, you can release the locks by pressing **Free locks**. @@ -28,13 +26,12 @@ The **Connections** information refers to the number of vector stores available. You can check and release the memory used by GeoServer under **Memory Usage**. -## **Image processing settings** +## **Image Processing Settings** Check again which Java settings are in use on the server for image processing. By default, it is not very efficient to process images as a whole in computer memory. A commonly used method is to split images into smaller parts (tiles) and do any image operators on the smaller images. The JAI settings (defined in the **Image Processing** settings) control the operation of these methods. -You can edit the JAI (Java Advanced Imaging) settings via **Settings → Image Processing** view. +You can edit the JAI (Java Advanced Imaging) settings via **Settings → Image Processing** view. ![](img/harjoitus_10/image2.png) -![](img/harjoitus_10/image2.png) Changes to the settings are visible in the **Server Status** page. @@ -45,9 +42,9 @@ Unlike WMS image requests, WCS requests produce potentially very large image fil The **Raster Access** settings determine the behaviour of GeoServer when image requests arrive. You can view the settings in the **Settings → Raster Access** view: +-----------------------------------------+------------------------------------------------------------------------------------------------------------------------+ -| | **Raster Access settings** | +| | #### **Raster Access settings** \| | +-----------------------------------------+------------------------------------------------------------------------------------------------------------------------+ -| **ImageIO cache memory threshold (KB)** | Image requests above this value will be handled using a temporary file cache, otherwise a cache memory will be used | +| **ImageIO cache memory threshold (KB)** | Image requests above this value will be handled using a temporary file cache, otherwise a cache memory will be used \| | +-----------------------------------------+------------------------------------------------------------------------------------------------------------------------+ | **CPU Use** | Settings for the processes used during the creation of raster images | +-----------------------------------------+------------------------------------------------------------------------------------------------------------------------+ @@ -57,16 +54,16 @@ The **Raster Access** settings determine the behaviour of GeoServer when image r At the end of the **Server Status** view, you will find settings related to the server: +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| | **Other server settings** | +| | #### **Other server settings** \| | +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | **Update Sequence** | Tells you how many times changes have been made to the server settings. | +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| **Resource cache** | GeoServer stores store connections, external images, and the configuration of object types, fonts and coordinate systems. If necessary, the cache data can be deleted. | +| **Resource cache** | GeoServer stores store connections, external images, and the configuration of object types, fonts and coordinate systems. If necessary, the cache data can be deleted. \| | +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| **Configuration and catalog** | All GeoServer configuration settings are loaded into the server memory. If necessary, they can be reloaded. | +| **Configuration and catalog** | All GeoServer configuration settings are loaded into the server memory. If necessary, they can be reloaded. \| | +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -## **GeoServer log** +## **GeoServer's log** Explore the contents of the GeoServer log and its settings by making requests to the server using the preview function. @@ -96,8 +93,8 @@ It is also possible to manage GeoServer server settings via the REST interface. You can check the data available through the REST interface by typing the following address in a web browser (use the ip address of your own server): -::: code-box -http://[your-training-instance]/geoserver/rest/workspaces/ +::: note-box +[http://[your-training-instance]/geoserver/rest/workspaces/](http://%3Eoma-ip-osoite:8080/geoserver/rest/workspaces/){.uri} ::: Find information on the map layers created in the previous exercises. @@ -114,7 +111,7 @@ Psst! See the description of the REST API in the GeoServer Help. ## **Using the Monitor plugin (tarkista nämä vielä)** -The GeoServer **Monitor** plugin is pre-installed on the training servers and can be seen in the main menu below. +GeoServer's **Monitor** plugin is pre-installed on the training servers and can be seen in the main menu below. This plugin allows you to view GeoServer traffic. Feel free to view what can be done with the Monitor plugin. Also consider how it could be useful in your organization. Open **Monitor → Activity**. diff --git a/src/GS006_eng/11_exercise_11.Rmd b/src/GS006_eng/11_exercise_11.Rmd index 3daf9598..92b18f15 100644 --- a/src/GS006_eng/11_exercise_11.Rmd +++ b/src/GS006_eng/11_exercise_11.Rmd @@ -1,4 +1,4 @@ -# Exercise 2.4: CSS styles +# EXERCISE 2.4: CSS-STYLING **Content of the exercise** @@ -16,7 +16,7 @@ After the exercise, the student will be able to use basic styling techniques on Various data are uploaded to the GeoServer server. The CSS plugin is installed on GeoServer. -## **CSS styles** +## **CSS-styles** Once the CSS plugin is installed, you can write styles in CSS, which is a more user-friendly way to customize your styles than SLD. @@ -41,7 +41,7 @@ The **Style Editor** box now contains text like the following: }\ ::: -Press **Submit**. From the **Styles** menu, open the style you just created and select the **Layer Preview** tab. Select a road layer as the layer to preview. +Press **Save**. From the **Styles** menu, open the style you just created and select the **Layer Preview** tab. Select a road layer as the layer to preview. Zoom in on the map so that the roads start to show up properly. @@ -122,7 +122,7 @@ z-index: 0, 3; Note that in this way you define overlapping styles for the main paths, which form more complex visualisations. -Press **Submit** and visualize the result: ![](img/harjoitus_11/image5.2.png) +Press **Save** and visualize the result: ![](img/harjoitus_11/image5.2.png) The **Z-index** command defines the order in which the different styles are drawn. An index value of 0 refers to a black line with a thickness of five pixels. An index value of three refers to a yellow line with a thickness of three pixels. Note how the lower values of the Z-index are drawn first and the higher values are drawn later. @@ -206,20 +206,33 @@ Now other roads will only be shown if the **zoom** level is more accurate than * Your code at this point should look something like this: ::: code-box - /\* \@title Paatiet \*/\ - [type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk']\ -     { stroke: black, yellow;\ -     stroke-width: 5px, 3px;\ -     z-index: 0, 3;}\ + /\* \@title Paatiet \*/ + + [type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk'] + +     { stroke: black, yellow; + +     stroke-width: 5px, 3px; + +     z-index: 0, 3;} + \ - /\* \@title Sivutiet \*/\ - [\@scale \< 50000]\ - [type \<\> 'motorway' and type \<\> 'primary' and type \<\> 'secondary' and type \<\> 'trunk']\ -     { stroke: black;\ -    stroke-width: 0.1;}\ + + /\* \@title Sivutiet \*/ + + [\@scale \< 50000] + + [type \<\> 'motorway' and type \<\> 'primary' and type \<\> 'secondary' and type \<\> 'trunk'] + +     { stroke: black; + +     stroke-width: 0.1;} + \ - /\* \@title Roads \*/\ -   \* { font-family: Helvetica;} + + /\* \@title Roads \*/  + + \* { font-family: Helvetica;} ::: ## **Adding subtitles** @@ -259,39 +272,71 @@ You can also define names for smaller roads in the same way as we just did for m Here is a sample code with all the previously mentioned styles in use: ::: code-box -/\* \@title Paatiet \*/\ -[type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk']\ - { stroke: black, yellow;\ - stroke-width: 5px, 3px;\ - z-index: 0, 3;\ - label: [name];\ - font-weight: bold;\ - font-fill: black;\ - font-size: 12;\ - -gt-label-follow-line: true;\ - -gt-label-max-angle-delta: 90;\ - -gt-label-max-displacement: 400;\ - -gt-label-repeat: 150;\ - halo-color: white;\ - halo-radius: 1;}\ +/\* \@title Paatiet \*/ + +[type = 'motorway' or type = 'primary' or type = 'secondary' or type = 'trunk'] + +{ stroke: black, yellow; + +stroke-width: 5px, 3px; + +z-index: 0, 3; + +label: [name]; + +font-weight: bold; + +font-fill: black; + +font-size: 12; + +-gt-label-follow-line: true; + +-gt-label-max-angle-delta: 90; + +-gt-label-max-displacement: 400; + +-gt-label-repeat: 150; + +halo-color: white; + +halo-radius: 1;} + \ -/\* \@title Sivutiet \*/\ -[\@scale \< 50000]\ -[type \<\> 'motorway' and type \<\> 'primary' and type \<\> 'secondary' and type \<\> 'trunk']\ - { stroke: black;\ - stroke-width: 0.1;\ - label: [name];\ - font-fill: black;\ - font-size: 9;\ - -gt-label-follow-line: true;\ - -gt-label-max-angle-delta: 90;\ - -gt-label-max-displacement: 400;\ - -gt-label-repeat: 150;\ - halo-color: white;\ - halo-radius: 1;}\ + +/\* \@title Sivutiet \*/ + +[\@scale \< 50000] + +[type \<\> 'motorway' and type \<\> 'primary' and type \<\> 'secondary' and type \<\> 'trunk'] + +{ stroke: black; + +stroke-width: 0.1; + +label: [name]; + +font-fill: black; + +font-size: 9; + +-gt-label-follow-line: true; + +-gt-label-max-angle-delta: 90; + +-gt-label-max-displacement: 400; + +-gt-label-repeat: 150; + +halo-color: white; + +halo-radius: 1;} + \ -/\* \@title Tiesto \*/\ - \* { font-family: Helvetica;} + +/\* \@title Tiesto \*/  + +\* { font-family: Helvetica;} ::: A preview of this style looks like this on the map: ![](img/harjoitus_11/image10.2.png) diff --git a/src/GS006_eng/12_exercise_12.Rmd b/src/GS006_eng/12_exercise_12.Rmd index 8546978f..3854ebbe 100644 --- a/src/GS006_eng/12_exercise_12.Rmd +++ b/src/GS006_eng/12_exercise_12.Rmd @@ -1,8 +1,8 @@ -# Exercise 2.5: Access control +# EXERCISE 2.5: ACCESS CONTROL **Content of the exercise** -The exercise will introduce the student to different security settings and create users and roles. Set permissions for services, datas and users. +The exercise will introduce you to different security settings and create users and roles. Set permissions for services, datas and users. **Aim of the exercise** @@ -36,9 +36,6 @@ For example, the URL of the browser in the **Security** menu (where we are now). [http://[your-training-instance]/geoserver/web/?x=xAiOmyK-CQmBXDhILZrWpny28bhFcImLrBRYk0INwrBDmbzQlmeLRdiaRoNSaBSx3o6elVC9JMPcy5gkRljLXMKGrvMx3Yui3\*ANGkUW-hE](http://localhost:8080/geoserver/web/?x=xAiOmyK-CQmBXDhILZrWpny28bhFcImLrBRYk0INwrBDmbzQlmeLRdiaRoNSaBSx3o6elVC9JMPcy5gkRljLXMKGrvMx3Yui3*ANGkUW-hE){.uri} ::: -::: hint-box -Psst! The installation of Java policy files depends on the Java Software installed on your server. If Open JDK is installed, then the policy files are installed by default and Strong cryptography is enabled. If, on the other hand, Oracle Java is installed (which has been GeoServer's recommendation in the past) then you need to download Oracle's JCE policy jars and extract them to the JRE_HOME/lib/security folder, after which Strong cryptography is enabled. -::: **Password encryption** specifies which encryption style is used for password storage: **Plain text**, **Weak PBE** and **Strong PBE**. @@ -206,9 +203,10 @@ Log in to the server again using the **hki_user** ID and check that the layers o ![](img/harjoitus_12/image15.2.png) -## **Map service-specific rights** +\## **Map service-specific rights** + -Geoserver documentation says that “The default service security configuration in GeoServer contains no rules and allows any anonymous user to access any operation of any service. The following are some examples of desired security restrictions and the corresponding rules.” So, this means that there are no rules to be defined. The security page should look like this: +Geoserver's documentation says that “The default service security configuration in GeoServer contains no rules and allows any anonymous user to access any operation of any service. The following are some examples of desired security restrictions and the corresponding rules.” So, this means that there are no rules to be defined. The security page should look like this: ![](img/harjoitus_12/image19.png) diff --git a/src/GS006_eng/13_exercise_13.Rmd b/src/GS006_eng/13_exercise_13.Rmd index 882afcc2..e2a5d863 100644 --- a/src/GS006_eng/13_exercise_13.Rmd +++ b/src/GS006_eng/13_exercise_13.Rmd @@ -1,8 +1,8 @@ -# Ecercise 2.6: Filtering +# EXERCISE 2.6: FILTERING **Content of the exercise** -The exercise will introduce the student to CQL (Common Query Language) and ECQL (Extended CQL). +The exercise will introduce you to CQL (Common Query Language) and ECQL (Extended CQL). **Aim of the exercise** diff --git a/src/GS006_eng/index.Rmd b/src/GS006_eng/index.Rmd index e75c28d4..fd2be524 100644 --- a/src/GS006_eng/index.Rmd +++ b/src/GS006_eng/index.Rmd @@ -1,21 +1,20 @@ --- title: "Introduction to GeoServer" -author: "Gispo Finland Ltd." +author: "Gispo Oy" date: "`r Sys.Date()`" site: "bookdown::bookdown_site" -abstract: "A course covering basic GeoServer topics" +abstract: "A course covering basic GeoServer topics." output: bookdown::html_book: toc: true theme: null template: custom.html css: custom.css - split_by: rmd - number_sections: false + split_by: chapter+number #rmd documentclass: book --- -# Introduction to GeoServer +# INTRODUCTION TO GEOSERVER ## Welcome to this GeoServer Course! @@ -36,9 +35,7 @@ Commands to execute in a **web browser** are displayed as follows: Commands to execute in a **command prompt/terminal** are displayed as follows: ::: commandline-box -``` shell sudo lsb_release -a -``` ::: **File content** is displayed as follows: @@ -50,9 +47,7 @@ sudo lsb_release -a **HTML and CSS code, SQL- queries and Python-scripts** are displayed as follows: ::: code-box -``` sql SELECT version(); -``` ::: **Questions, notes and hints** are displayed as follows: @@ -90,13 +85,5 @@ If you notice mistakes in these course materials, we ask you to report either di ## License and permissions -These materials are developed for the "Introduction to GeoServer" course by Gispo Finland Ltd. -The materials are licensed under [CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0/) license. - -## Download a PDF version of the material - -You can download a PDF version of the material from this link: - -::: note-box -[PDF version of the material](https://github.com/gispocoding/master-training-data/releases/download/GS006_eng/GS006_eng.pdf) -::: +These materials are developed for the "Introduction to GeoServer" course by Gispo Ltd. +The materials are licensed under [CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0/) license. \ No newline at end of file