Administration av InternGIS
- Sven-Ola Svensson
Det här dokumentet visar hur och var IntenGIS är installerat samt hur vanligt förkommande uppdateringar av systemet enklast utförs. Detta är ingen manual för konfigurationen utan ett tillägg för det som är unikt för Nacka och InternGIS.
Kärnan i InternGIS är Weave Integrationsserver. Hur Weave hanteras finns beskrivit i https://cohgawiki.atlassian.net/wiki/.
Weave installationen
Weave är installerad på server NKO-P-IKART01 under katalogen D:\program\weave_2.6. Den är byggd i Java och är helt oberoende av andra programvaror. Allt finns inom katalogträdet. I princip kan systemet kopieras till någon annan server eller katalog och bara startas upp.
Konfiguration av Weave sker med XML. Weave själv vet inget om XML men det finns en kommunikatör som läser och översätter XML koden till Weave så fort något ändras. Allt utgår från filen config.xml som finns i ../weave_2.6/platform/workspace katalogen. För att systematisera konfigurationen så har katalogen config skapats direkt under workspace katalogen. Under denna finns ett träd av kataloger med xml-filer. I config.xml så inkluderas några av dessa filer. Config består av följande underkataloger.
Klient innehåller de konfigurationsfiler som hanterar webbklienten och dess funktioner
Extern är konfiguration för data som hämtas utanför Nacka
Nacka innehåller den mesta konfigurationen mota alla interna datakällor
Reports innehåller mallar för rapporter
Test server
Att göra ändringar direkt i produktion-servern är vanskligt. Med kanske 100-tals användare så kan ett fatalt fel orsaka onödig störning. Därför är det rådligt att sätta upp en parallell server. På servern finns redan en sådan uppsatt under D:\program\weave_test som är uppsatt under http portern 8080. Det enda som skiljer dem är http porten. Kör startup.cmd för att starta upp servern.
Sätta upp en testserver
Kopiera produktions-server (i Nackas fall D:\program\weave_2.6) till en katalog med ett annat namn t.ex. D:\program\weave_test2. Det är lämpligt att göra detta när produktions-servern är nere.
Ändra html porten i filen jetty_base\start.d\http.ini (se https://cohgawiki.atlassian.net/wiki/spaces/weavedocs1/pages/811925546/Upgrading+from+2.5+to+2.6 )
Från
## Connector port to listen on jetty.http.port=80Till t.ex.
## Connector port to listen on jetty.http.port=8082
Servern kan nu startas i konsolläge men startup.cmd. Ändra så att konsolfönstret har en buffert på minst 1000 rader (högerklicka överst i konsolen huvud och välj egenskaper + terminal)
När konsolen slutat rulla så är den klar för att köras
I webbläsaren anges http://localhost:8082/useradmin.html
Konfiguration
Konfigurationen kan göras i webb-miljö med http://nko-p-ikart01/weave/admin.html som innehåller en rad verktyg för att kontrollera servern. För många systematiska ändringar är redigering av XML-filen direkt i filsystemet att föredra. Därför är ofta en kombination av dessa att använda admin.html tillsamman med den lokala redigeraren mest effektiv.
Vanliga konfigurationsförändringar i Nacka
Ny plan har publicerats i Geoserver
En ny detaljplan eller liknande har tillkommit och GIS-support har publicerat den i Geoserver. För att den ska slå igenom i InternGIS så ska kopplingen till WMS tjänsten återanslutas så att det nya lagret blir synligt samt att en ny rad i lagerförteckningen skrivs in.
Börja med att starta admin-verktyget http://interngis/weave/admin.html. Klicka på ikonen “Map Engines”
Leta reda på lager “Zoning” och markera detta. Tryck sedan på “Reset”-knappen för att förnya uppkopplingen mot Geoserver. Kontrollera att det nya lagret nu finns med i lagerförteckningen.
2. Lägg in det nya lagret i TOC som ett kartlager
Starta konsolen i Admin-verktyget och skriv in kommandot “memd toc me.nacka.geoserver.zoning”
Se Weave metadata-kommandon eller Lägga till kartlager i Weave dokumentationen
Kommandot skapar konfigurationen för en kartlager-förteckning. Markera och kopiera den eller de lager som ska läggas till.
3. Lägg in det nya lagret i konfigurationen
Starta “Config” i Admin-verktyget och klicka “Map Engines /WMS Mapengins" och markera sedan “me.nacka.geoserver.zoning”. Klicka på”Open” för att öppna redigeraren.
Klicka i redigeraren och sök (ctrl F) “zoning”. Rulla ner till den plats som det nya lagret ska klistras in. (Gärna i sådan ordning att det är lätta att hitta senare). Tryck “Save” för att spara rättningen
4 Kontrollera genom att starta om InternGIS klienten och prova att lagret syns.
Lägga till ett nytt lager
Frågeställning: “Jag har lagt upp ett nytt lager i geoserver, pagaende_planarbete_pdb_vy. Kan du lägga till det till InternGIS-klienten i kategorin Stadsbyggnad och koppla det till PostGIS-tabellen plan.pagaende_planarbete_pdb?”
Anslut lager
Starta ..weave/admin.html. Starta appen ‘Mapengines’. Sök ‘me.nacka.geoserver.plan’ på vänster sida och markera denna karttjänst. Klicka på ‘reset’ på högra sidan, sortera på ‘label’ och sök ‘pagaende_planarbete_pdb_vy’. Nu är det verifierat att lagret finns och är tillgängligt.
Lägg till lagret i lager förteckningen
Starta appen ‘konsol’ i weave/admin och slå kommandot ‘memd toc me.nacka.geoserver.plan’. En innehållsförteckning med alla lager för den aktuella kartjänsten visas. Sök lagret som skall läggas till, markera raden och kopiara denna.
För att lägga till lagaret så måste vi öppna konfigurationsfilen. Starta appen ‘Config’ , markera ‘WMS Map Engine’ och markera sedan ‘me.nacka.geoserver.plan’. Klicka på ‘open’ för att öppna filen.
Sök på ‘me.nacka.geoserver.plan’ och klistra in lagret på en plats så att det blir soterat på namnet. Spara filen
Lägg till data för lagret
Använd ‘config’ appen för att leta upp rätt konfigurationsfil eligt bilden nedan.
I konfigurationsfilen är det tre delar som ska läggas till
Lägga till ett dataslag (entity)
Koppla spatialt (mapper)
Lägga till en datavy (datafinition, data)
(eventuellt lägga till ett sökformulär)
Enklast att lägga konfigurationen är att kopiera från en annan konfiguration. I konfigurationen finns redan ett dataslag ‘pagaende_planarbeten’ som kan användas.
Därefter så byts ‘pågående_planarbete’ ut mot ‘pagaende_planarbete_pdb’
För själva datafinition så behöver vi veta vilka kolumner som skall vara med. Vi kan skapa en konfiguration men konsolen genom komandot ‘dbmd conf ds.nacka.interngis pagaende_planarbete_pdb’
Konfiguration av datadefinitionen kopieras och ersätter den gamla. ‘Fix_me’ ersätts mot korrekta värden
Nu kan filen sparas
Starta om weave/nacka_interngis2.html och observera att det finns ett en ogrupperad flik längst ner i lagerförteckningen.
Den binds till kartlagret genom att ange entity i kartlagrets konfiguration
Lägga till ett sökformulär
Här visas ett exempel på konfiguration av sökformulär
<search:attribute id="sa.pagaende_planarbete_pdb">
<entity>plan.pagaende_planarbete_pdb</entity>
<displayName>Pagaende planarbeten pdb</displayName>
<description>Planer</description>
<dataSource>ds.nacka.interngis</dataSource>
<table>plan.pagaende_planarbete_pdb</table>
<key>pkid</key>
<parameter id="diarienummer">
<promptText>Diarienummer</promptText>
<controltype>textbox</controltype>
<where>
<clause>diarienummer like'%${diarienummer}%'</clause>
</where>
<dataType>string</dataType>
</parameter>
<parameter id="status">
<promptText>Status</promptText>
<controltype>listbox</controltype>
<column>status</column>
<dataType>string</dataType>
</parameter>
<cache disabled="true"/>
</search:attribute>Kryptering av lösenord
För att inte visa upp lösenorden i konfigurationsfilerna kan detta krypteras. Det görs i applikationen weave admin. Klicka på ikonen för konsol och använd kommandot encrypt <lösenord> t.ex.
På samma sätt kan ett krypterat lösenord av-krypteras med decrypt <krypterat lösenord>
´Nyckel för krypteringen följer med installationen av Weave och är unik för varje installation. Om Weave uppdateras eller kopieras så är det samma nyckel. Nyckeln finns i filen private.key under katalogen workspace. Om en ny installation görs så kan denna fil kopieras från den gamla till den nya installationen.
Lägga till ett lagerbibliotek i lagerförteckningen (TOC)
Den här dokumentation görs i samband med en förfrågan om att Bygglov önska en lgerlista med enbart de lager som de själva använder. Orsaken är att InternGIS innehåller så många lager att det är krångligt att hålla red på vilka lager som är tända eller släkta.
Konfigurationen för lagerbibliotek ligger i filen ..config/client/integration_toc.xml. Här finns konfigurationen för den huvudsakliga lagerförteckningen "toc.client.ikartan" som refereras från IntenGIS klienten.
Överst i denna är det tillagt en grupp 'Lagerbibliotek' som innehåller referens till två separata lagerlistor "toc.lagergrupp.bygglov" och "toc.lagergrupp.plan" (som är en test för att lägga till flera lagerbibliotek).
Konfiguration för "toc.lagergrupp.bygglov" är i grunden en kopia på de ursprungliga lagerlistorna från Geoserver och som finns konfigurerade i filen …\config\nacka\mapengines_nacka.xml. Skillnaden är att det bara är de lager som Bygglov önskar ha med. En annan skillnad är att varje lager och grupp måste ha ett unikt ID. Därför har det urspungliga ID modifierats med prefixet bygglov.
Behörighetskontroll
Tre ACL har definierats ‘acl.kartlager.grupp.nacka', ‘acl.kartlager.grupp.bygglov.nacka' och ‘acl.kartlager.grupp.plan.nacka'. Dessa har kopplats till rollerna ‘Grupplager för Bygglov’ respektive ‘Grupplager för Planavdelningen’ Den först rollen finns med i användargrupperna 'Bygglov’, 'GIS-Lanmäteri’ och 'InternGIS support’
Kom ihåg att skapa konfiguration för ACL defintioner. Detta görs när ACLer och roller är skapade . Det finns ett verktyg i UserAdmin under