Portal for ArcGIS és ArcGIS Server adminisztráció Kiss András
ArcGIS Server Adminisztráció
Adminisztráció szkriptekkel ArcGIS REST API - Web szolgáltatások, automatizálás, hibázási lehetőség csökkentése ArcGIS Server parancssoros eszközök - Batch fájlokként vagy parancssorban futtatható, egyszerűbb műveletekhez ajánlott ArcPy funkciók - Python site package, Python-ban írható feladatok, pl.: publikálás, Data Store regisztrációk
ArcGIS Server Administrator API A Server Manager vagy a Desktop műveletei + ami nincs kivezetve REST API, így programozottan lehet URL-eket összeállítani Erőforrások és műveletek Bármilyen programozási nyelvből meghívható, ami képes HTTP kéréseket indítani (Java, JavaScript, PowerShell, C#, Ruby, Scala, Perl, stb.) Nem kell Esri szoftver a szkript futtatásához
Néhány példa Site létrehozása az ArcGIS Server silent módban történő telepítése után Szolgáltatások létrehozása Szolgáltatások tulajdonságainak szerkesztése (max instance beállítása) Felhasználói jogosultságok beállítása szolgáltatásokon Szolgáltatások elindítása, leállítása Naplófájlok lekérdezése és használati riportok generálása
ArcGIS Server Administration Toolkit Az ArcGIS Server Administrator API-ra épül, Python-ban íródott Szolgáltatások elindítása, leállítása Naplózás kezelése Server Object Extensions (SOE) regisztrálás Service definition (SD) fájlok publikálása szolgáltatásként Eszközök önálló futtatása vagy a ModelBuilder-ben összefűzve is lehet futtatni őket Forráskód rendelkezésre áll a módosításhoz
Token kezelés Be kell jelentkezni a Manager vagy az Admin Directory használatához A szkriptek futtatásakor is be kell jelentkezni, tokent kell generálni a kódban A token egy karaktersorozat, ami a bejelentkezést helyettesíti Minden további kérésbe bele kell rakni a tokent A token lejárati ideje megakadályozza, hogy eltulajdonítva bármeddig használják gettoken Python példakód
REST API meghívása A kéréshez kell egy URL, amit a kódnak kell összeállítania Az URL tartalmazza a paramétereket és a tokent A válasz általában JSON-t ad vissza, amit JSON elemzővel lehet feldolgozni A HTTP válaszkód is elég lehet a sikeresség eldöntéséhez (200)
ArcGIS Server parancssoros eszközök ArcGIS Server installációs könyvtár\tools\admin könyvtár Python szkriptek Szolgáltatások elindítása, leállítása Szolgáltatás létrehozása, kezelése Gyorsítótár törlése, kezelése Site kezelése Backup/restore Kötelező paraméterek - u adminisztrátor felhasználó - p - jelszó - s site URL
Backup által eltárolt információk Szolgáltatás konfigurációk és szolgáltatás tulajdonságok Server object extentions (SOE) Server object interceptors (SOI) Regisztrált Data Store elemek Felhasználó és szerepkör információk A Site-ban részt vevő gépek listája Cluster-ek és tartalmuk Naplózási beállítások Statisztikai riportok
Információk, amiket a Backup NEM tárol el Gyorsítótár és a sémák (c:\arcgisserver\directories\arcgiscache) Térinformatikai adatok (kivéve a publikáláskor felmásoltak) Dinamikusan generált térképek képei és más ideiglenes adatok Naplófájlok (c:\arcgisserver\logs) Primary site administrator felhasználó neve és jelszava Statisztikai adatok (c:\arcgisserver\directories\arcgissystem\statistics) ArcGIS Web Adaptor konfigurációk
ArcPy Főképp a Data Store-hoz és a publikáláshoz kapcsolódó műveletek - MXD-k elemzése publikáláshoz - Publikálás service definition fájlokból
GIS Server által futtatott processzek Minden GIS Server futtatja a következő processzeket - ArcGISServer.exe - ArcSOC.exe minden futó szolgáltatás példányhoz, a GP szolgáltatáshoz kettő fut - rmid.exe - Kettő javaw.exe (alkalmazás szerver és web szolgáltatások futtatása) - conhost.exe és cmd.exe (kiegészítő processzek) A Task Manager-ben a Command Line oszlopban lehet látni, hogy az ArcSOC.exe processzek melyik szolgáltatáshoz tartoznak
GIS Server által használt portok (10.4+) HTTP port 6080 HTTPS port 6443 4000-4002 Cluster port 4004 Belsőleg használt portok (1098, 6006, 6099)
Általános adminisztrációs feladatok
Geoprocesszáló szolgáltatások A 10.4-es verziótól kezdve csak adminisztrátorok publikálhatnak GP szolgáltatásokat és Server Object Extension (SOE vagy SOI) bővítményeket Nagyobb védelem a site-nak, az egyedi kódok futtatása miatt System > Properties > Update: allowgpandextensionpublishingtopublishers
Frissítések keresése Check for Updates: futtatható program ArcGIS Server, Portal for ArcGIS és ArcGIS Data Store szoftverekhez keres frissítéseket http://support.esri.com/en/downloads/patches-servicepacks/
Automatikus adatmásolás letiltása publikálás közben Az ArcGIS Server lehetővé teszi publikáláskor, hogy a szolgáltatás GIS adatait becsomagolva felmásolja a GIS Server-re Ez megakadályozható és előre regisztrált tárhelyeket lehet felvenni, ahonnan publikálhatnak az adatgazdák Server Manager > Site > GIS Server > Data Store > Settings: Allow data to be copied to the site when publishing services
Böngésző gyorsítótár kikapcsolása az Administrator Directory-hoz A böngésző gyorsítótárazza az Administrator Directory oldalait a gyorsabb működéshez Érzékeny adatok is lehetnek közte, ezért letilthatjuk a funkciót System > properties > update: DisableAdminDirectoryCache
Séma zárolás kikapcsolása térképi szolgáltatásokon A térképszolgáltatás séma zárolást tesz a forrás adattáblákra a módosítások megakadályozására Nem lehet kicserélni a Feature class-t, így ez kikapcsolható a Server Manager-ben és ArcGIS for Desktop-ban Server Manager: Services > Manage Services > szolgáltatás > Parameters > Lock Database Schema ArcGIS for Desktop: Service Properties > Parameters > Advanced: schemalockingenabled
Szolgáltatás galéria beállítások a Manager-ben A Services > Manage Services lista tartalma testreszabható a Service Gallery Settings ikonra kattintva - Automatically refresh service gallery: 3 másodpercenként frissül a szolgáltatások listája az adatokkal (fut-e, futó példányok száma) - Number of services per page: hány szolgáltatás jelenjen meg egy oldalon, alapérték 10 - Select the service properties you want to search: a szolgáltatás kereső szövegdobozban milyen értékekre lehessen keresni (név, típus, státusz, összegzés, leírás, capabilities)
Szolgáltatás elrejtése a Services Directory-ban (REST) Egyes szolgáltatások elrejthetők a Services Directory felületen, de a háttérben továbbra is működni fognak Az Administrator Directory-ban állítható be, a Manager-ben továbbra is látszik Services > szolgáltatás > edit: deprecated
Cross-domain kérések letiltása ArcGIS Server-ben Cross-domain kérés: másik domain-ből hívják meg az ArcGIS Server szolgáltatásait Alapértelmezetten az ArcGIS Server engedélyezi a cross-domain kéréseket A JavaScript alkalmazásokhoz az Administrator Directory-ban lehet beállítani Egy listára kell felvenni az összes engedélyezett domain-t System > handlers > rest > servicesdirectory > edit: AllowedOrigins
Tanúsítvány beállítása ArcGIS Server-ben Administrator Directory > machines > gépnév > sslcertificates > importrootorintermediate Administrator Directory > machines > gépnév > sslcertificates > importexistingservercertificate Administrator Directory > machines > gépnév > edit > Web server SSL Certificate 10.4 előtti verziók esetén - Administrator Directory > security > config > update > Protocol: HTTP and HTTPS vagy HTTPS Only Ha szükséges, akkor fel kell venni az operációs rendszer Trusted Root Certificate Authorities listájába is https://gisserver.domain.com:6443/arcgis/rest
Statisztikák használata Különböző szolgáltatás statisztikák érhetőek el: kérések száma, átlagos válaszidő, maximum válaszidő, időtúllépések, stb. Vannak beépített riportok a Manager-ben, de újakat is lehet generálni Script-ekkel is használható - Riport készítése minden szolgáltatás kérésről - Statisztika exportálása fájlba
Biztonsági rések keresése A Server része a serverscan.py tool 12 szempontot figyel ArcGIS Server telepítő könyvtár\tools\admin
Portal használata az ArcGIS Server-rel Három út lehetséges 1. Szolgáltatások regisztrálása 2. Összekapcsolás Server-rel 3. Hosting Server beállítása Portal Server
Megvalósítási minták Portal for ArcGIS + ArcGIS Server Portal for ArcGIS Elem A Regisztrált web szolgáltatás ArcGIS Server site 1 Identity Store Identity Store A
Megvalósítási minták Portal for ArcGIS + ArcGIS Server Portal for ArcGIS Elem A Elem B Regisztrált web szolgáltatás Összekapcsolt Server ArcGIS Server site 1 ArcGIS Server site 2 Identity Store Identity Store A
Portal Server összekapcsolás (Federating) Lehetővé teszi az egyszeri bejelentkezést (SSO) a Portal és a Server felületre Minden jogosultságot a Portal kezel Az ArcGIS Server HTTPS engedélyezett legyen Portal for ArcGIS Identity store Mikor használjuk: - Egyszeri bejelentkezést szeretnénk ArcGIS Server Mikor NE használjuk - Ha a Portal/Server fizikailag máshol vannak telepítve - Portal és Server más verziójúak
Megvalósítási minták Portal for ArcGIS + ArcGIS Server Portal for ArcGIS Elem A Elem B Elem C Regisztrált web szolgáltatás Összekapcsolt Server Hosting Server ArcGIS Server site 1 ArcGIS Server site 2 ArcGIS Server site 3 Identity Store ArcGIS Data Store Identity Store A
Portal for ArcGIS + Hosting Server Akkor szükséges, ha hosztolt szolgáltatásokat szeretnénk a Portal-ban - Feature service - Tiled service - 3D scene service (10.3.1) Portal for ArcGIS Identity store Példák - Tartalom publikálása Portal-ba - Tartalom megosztása Esri Maps for alkalmazásból ArcGIS Server ArcGIS Server-t használ ArcGIS Data Store-ral ArcGIS Data Store
ArcGIS Data Store 10.3.x-től kezdve Hosting Server-ek támogatására lett létrehozva - Hosztolt feature service - 3D scene service (10.3.1) Portal Enterprise megoldás - Magas rendelkezésre állás támogatása - Automatikus mentés és visszaállítás Az ArcGIS for Server része - Külön kell telepíteni GIS Server ArcGIS Data Store
System Monitor Egy eszköz, rendszer mutatók és szolgáltatás használati információk gyűjtésére GIS környezetekhez. Lehetővé teszi - diagramok megjelenítését - határértékek figyelését - szűk keresztmetszetek felderítését - figyelmeztetések küldését, ha egy mutató átlépi a határértéket
Portal for ArcGIS Adminisztráció
Adminisztráció szkriptekkel ArcGIS REST API - Web szolgáltatások, automatizálás, hibázási lehetőség csökkentése Portal for ArcGIS parancssoros eszközök - Batch fájlokként vagy parancssorban futtatható, egyszerűbb műveletekhez ajánlott Python szkript példakódok PortalPy funkciók - Python modul, Python-ban írható feladatok
ArcGIS Portal Directory Bizonyos rendszergazdai feladatokat nem lehet a Portal for ArcGIS weboldalon elvégezni Erőforrásokra és műveletekre épül, mint a Server REST alapú, URL-ekkel meghívható paraméterezve Bármilyen programozási nyelvből meghívható, ami képes HTTP kéréseket indítani (Java, JavaScript, PowerShell, C#, Ruby, Scala, Perl, stb.) Nem kell Esri szoftver a szkript futtatásához Tokenre ugyanúgy szükség lesz a hívásokhoz https://webadaptor.domain.com/arcgis/portaladmin https://webadaptor.domain.com/arcgis/sharing/rest
Portal for ArcGIS parancssoros eszközök Portal installációs könyvtár\tools könyvtárban találhatók Batch fájlokból és parancssorból futtathatók Csak a Portal-t futtató gépen lehet használni őket Felhasználók felvétele, kilistázása, törlése Portal elemek tulajdonosának módosítása
Python szkript példakódok A REST API-ra épülő Python példaalkalmazások Forráskód elérhető, módosítható Csak Python környezet kell a gépre, bárhonnan futtatható Felhasználók felvétele Portal elemek másolása másik Portal-ba Csoportok jogosultságkezelése Portal elemek tulajdonosának módosítása Web map-ben lévő szolgáltatások URL-jeinek szerkesztése
PortalPy Python modul, fejleszthető tetszőleges rendszergazdai funkció Csak Python környezet kell a gépre, bárhonnan futtatható Fejlesztői tudást igényel Portal installációs könyvtár\tools\portalpy könyvtárban található + GitHub
config.js Egyes Portal weboldal funkciók elrejtése, bekapcsolása Portal installációs könyvtár\customizations\<verziószám>\webapps\arcgis#home\js\arcgisonline\config.js A fájl módosítása után újra kell indítani a Portal szolgáltatást és a böngésző gyorsítótárat törölni kell
config.js bitlyurl, bitlyurlssl: rövidített URL-ek Facebook, Twitter, stb. weboldalakhoz az elemek részletes oldalain classificationbanner: a weboldal minden oldalán egy biztonsági üzenet jeleníthető meg alul és felül extentservice: a web map elemek kiterjedés beállításához használt szolgáltatás footerlinks: a láblécen definiálható linkek restrictorganizationpagetoadmin: a My Organization oldal elrejtése publikáló és normál felhasználók elől, alapértelmezetten hamis showsocialmedialinks: megjelenjenek-e Facebook és Twitter linkek az oldalakon, alapértelmezetten hamis websearchenabled: indexelhetik-e a Portal tartalmat keresőmotorok (Google), alapértelmezetten igaz
Activity Dashboard Felhasználói aktivitás megjelenítése 3 részre osztott felület - Items: a felhasználók milyen módon kezelik a tartalmat (létrehozás, megosztás, használat) - Members: felhasználói aktivitás - Groups: együttműködés a felhasználók között
Kizártuk magunkat a Portal-ból? Portal installációs könyvtár\tools\accountmanagement\ könyvtár Adminisztrátorként futtassuk CreateAdminAccount programot CreateAdminAccount list CreateAdminAccount create -u <felhasználónév> -p <jelszó>
Portal biztonsági beállítások My Organization > Edit Settings > Security Allow access to the organization through HTTPS only: a weboldal csak HTTPS-en keresztül érhető el Allow anonymous access to your organization: letiltható a névtelen elérés Password Policy: jelszó hossz, komplexitás és figyelés az előző jelszavak hasonlóságára
Biztonsági rések keresése A Portal része a portalscan.py tool 6 szempontot figyel Portal for ArcGIS telepítő könyvtár\tools\security
Biztonsági mentés és helyreállítás Portal elemek, beállítások Hosztolt web rétegek, adatok Federated és hosting server beállítások ArcGIS Data Store adatok webgisdr eszközzel lehet menteni és visszaállítani Portal installációs könyvtár\tools\ könyvtár A cache nem lesz a része
Portal for ArcGIS által futtatott processzek ArcGISPortal.exe javaw.exe (alkalmazás szerver és web szolgáltatások futtatása) conhost.exe és cmd.exe (kiegészítő processzek) postgres.exe
Portal for ArcGIS által használt portok HTTP port 7080 HTTPS port 7443 Belsőleg használt portok (7005, 7099, 7199, 7654)
Portal for ArcGIS Admin wiki Linkgyűjtemény az ArcGIS Online és Portal for ArcGIS adminisztrátorok számára Eszközök, praktikák és erőforrások https://github.com/esri/ago-admin-wiki
ArcGIS Online Assistant Jól, könnyen használható, hiányzó funkciók Web Map-ekben lévő szolgáltatások URL-jének szerkesztése Elemek másolása, szerkesztése Portal for ArcGIS-hez is használható! Letölthető a GDi Esri Magyarország Letöltések weboldaláról (Egyéb fül)
ArcGIS Online Assistant: Portal elem JSON-jének szerkesztése
ArcGIS Online Assistant: Web Map szolgáltatásainak szerkesztése