Geoweb Instellen

Gids voor het installeren van VertiGIS Studio Web en Studio Reporting.

Projecten: c2platform/rws/ansible-gis, c2platform.wincore, c2platform.gis


Overzicht

Deze gids biedt een stapsgewijs proces om Geoweb in te stellen, inclusief VertiGIS Studio Web en Reporting.

  1. Vagrant maakt een VirtualBox VM genaamd gsd-geoweb en voert Sysprep daarop uit.

  2. Vagrant voert de Ansible provisioner uit om de VM voor te bereiden voor handmatige installatie van de MSI:

    1. Open firewall-poorten voor Web en Reporting.
    2. Maak een SSL/TLS-certificaat aan.
    3. Installeer IIS.
    4. Creëer een service account sa_geoweb.
    5. Configureer IIS: maak websites, bindings, applicatiepools, enz.
    6. Download de MSI en licentie bestand naar de node gsd-geoweb.
  3. Maak verbinding met gsd-geoweb via RDP en voer de installateurs handmatig uit1.

  4. Voer de provisioner opnieuw uit om de IIS-configuratie gecreëerd door de VertiGIS-installateurs bij te werken om het service account sa_geoweb te gebruiken.

NodeOSProviderDoel
gsd-geowebWindows 2022 ServerVirtualBoxWeb en Reporting

Vereisten

Installatie

Voer het volgende commando uit:

vagrant up gsd-geoweb

App maken in ArcGIS Portal

  1. Navigeer naar https://gsd-agportal1.internal.c2platform.org/portal/home  en log in als portaladmin2.
    GebruikersnaamWachtwoord
    portaladminportaladmin123
  2. Kies ContentNieuw itemApplicatie
    EigenschapWaardeOpmerking
    ApplicatietypeAndere applicatie
    TitelGeoweb Modules registratie
    MapHoud standaard portaldmin
    TagsGeoweb Vertigis Studio Modules
    SamenvattingApp voor VertiGIS Studio modules registratie
  3. Via InstellingenApplicatieBijwerken:
    1. voeg de URL toe https://geoweb.c2platform.org/  ;
    2. voeg de Redirect URI toe
      • https://geoweb.c2platform.org/
      • https://geoweb.c2platform.org/ModuleViewer
      • https://geoweb.c2platform.org/ModuleReporting/designer
    3. Klik Opslaan.
  4. Kopieer de App ID / Client ID naar je klembord (bv., 3a01FOjRkQJD2dCv).

Installeren van Studio Web

  1. Verbind met gsd-geoweb via RDP.
  2. Rechtsklik op de Software snelkoppeling op het Bureaublad en selecteer Uitvoeren als Administrator.
  3. Voer VertiGIS-Studio-Web-5.31.0.msi uit.
    ModuleBestemmingsmap
    VertiGIS Studio WebD:\Apps\VertiGIS\Web
  4. Start post-installatie configuratie:
    EigenschapWaarde
    IIS WebsiteModuleViewer
    Virtuele Map/ModuleViewer/
    Portal TypePortal for ArcGIS
    Portal URLhttps://gsd-agportal1.internal.c2platform.org/portal/home2
    App ID( waarde van vorige stap )
    Redirect URLhttps geoweb.c2platform.org

Installeren van Studio Reporting

  1. Voer als Administrator VertiGIS-Studio-Reporting-5.22.0.msi uit.
    ModuleBestemmingsmap
    VertiGIS Studio ReportingD:\Apps\VertiGIS\Reporting
  2. Post-installatie configuratie:
    EigenschapWaarde
    GegevensmapD:\ProgramData\Geocortex\Reporting
    IIS WebsiteModuleReporting
    Virtuele Map/ModuleReporting/
    Portal TypePortal for ArcGIS
    Portal URLhttps://gsd-agportal1.internal.c2platform.org/portal/home2
    App ID( waarde van vorige stap )
    Redirect URLhttps geoweb.c2platform.org /ModuleReporting/designer/

Verifiëren

  1. Verbind met gsd-geoweb als gebruiker vagrant, start IIS Manager, en bekijk sitesinstellingen:

    Site naamApplicatiepoolFysiek padVerbinden als3
    ModuleViewerDefaultAppPoolD:\inetpub\StudioWebPass-through-verificatie
    ModuleReportingDefaultAppPoolD:\inetpub\ModuleReportingPass-through-verificatie

    Bekijk sitesbindings:

    Site naamTypeIP-adresPoortHostnaamSSL certificaat
    ModuleViewerhttpAlles Niet-Toegewezen8080(leeg)
    ModuleViewerhttpsAlles Niet-Toegewezen4443(leeg)gsd-geoweb.internal.c2platform.org
    ModuleReportinghttpAlles Niet-Toegewezen8081(leeg)
  2. Bekijk applicaties:

    ApplicatieApplicatiepoolFysiek padVerbinden als
    ModuleViewerDefaultAppPoolD:\inetpub\ModuleReportingsa_geoweb
    ModuleReportingVertiGISStudioReportingD:\inetpub\ModuleReportingsa_geoweb
  3. Bekijk applicatiepools:

    ApplicatiepoolIdentiteit
    DefaultAppPoolsa_geoweb
    VertiGISStudioReportingsa_geoweb
  4. Navigeer naar https://geoweb.c2platform.org/ModuleViewer/  en https://geoweb.c2platform.org/ModuleReporting/  en log in als portaladmin.

Herzien

In het inventarisatieproject c2platform/rws/ansible-gis:

  • De Geoweb play bevindt zich op plays/gis/geoweb.
  • De Geoweb configuratie is in group_vars/geoweb.

De Ansible rol c2platform.gis.vertigis_studio heeft momenteel minimale code. Downloads van MSI-installatieprogramma’s en het licentiebestand worden afgehandeld door de rol c2platform.wincore.download, terwijl het meeste configuratiewerk wordt gedaan door de rol c2platform.wincore.win.

Certificaten

De Ansible rol c2platform.gis.vertigis_studio, onderdeel van de Ansible GIS Collectie c2platform.gis, gebruikt de Ansible rol c2platform.core.cacerts2 om certificaten te maken en te implementeren die vertrouwd zijn op alle knooppunten (inclusief gsd-geoweb). Op gsd-geoweb wordt het geïmplementeerde certificaat gebruikt om IIS HTTPS bindings aan te maken.

  1. De vertrouwensrelatie voor certificaten gemaakt met de cacerts2 rol is geconfigureerd in het bestand group_vars/windows/main.yml, van toepassing op alle Windows hosts:
    win_resources:
       0-bootstrap:
          - name: Download c2.crt
            type: win_get_url
            url: https://gitlab.com/c2platform/rws/ansible-gis/-/raw/master/.ca/c2/c2.crt?ref_type=heads
            dest: C:\tmp\c2.crt
          - name: C2 CA Server Trust Relationship
            type: win_certificate_store
            path: C:\tmp\c2.crt
            store_name: Root
            store_location: LocalMachine
    
  2. Het bestand group_vars/geoweb/certs.yml bevat de configuratie voor het certificaat als onderdeel van de variabele vertigis_studio_cacerts2_certificates, het wordt geïmplementeerd naar C:\ProgramData\Certs\geoweb-GSD-GEOWEB.p12.
  3. Het bestand group_vars/geoweb/win.yml bevat de configuratie om het certificaat te importeren in de Windows certificaatwinkel met behulp van de variabele vertigis_studio_win_resources, waaronder:
     - name: Import Geoweb Certificaat
       type: win_certificate_store
       path: "{{ vertigis_studio_cacerts2_certificates[0]['deploy']['p12']['dest'] }}"
       key_exportable: true
       store_name: My
       key_storage: machine
       store_location: LocalMachine
       state: present
    
  4. Ten slotte, de variabele vertigis_studio_win_resources wordt gebruikt voor het beheren van IIS HTTPS bindings met een item vergelijkbaar met:
     - name: Voeg IIS HTTPS bindings toe
       type: win_iis_webbinding
       defaults:
         ssl_flags: 0  # sni uitgeschakeld
         protocol: https
         certificate_friendly_name: "{{ gs_geoweb_certificate_friendly_name }}"
         state: present
       resources:
         - name: ModuleViewer
           port: "{{ gs_vertigis_studio_web_port_ssl }}"
         - name: ModuleReporting
           port: "{{ gs_vertigis_studio_reporting_port_ssl }}"
    

Extra Informatie

Voetnoten


  1. Het automatiseren van de MSI is mogelijk met een script vergelijkbaar met install-vsw.ps1  , maar het lijkt niet ondersteund te zijn om een andere virtuele map te gebruiken. De parameter VirtualPath lijkt genegeerd te worden. ↩︎

  2. De reverse proxy-URL https://age.c2platform.org/portal/home/ werkt momenteel niet. Gebruik in plaats daarvan https://gsd-agportal1.internal.c2platform.org/portal/home↩︎ ↩︎ ↩︎

  3. De win_iis_website module staat niet toe dat je een andere “verbinden als” gebruiker instelt. Als dit moet worden gewijzigd, moet dit handmatig worden gedaan. ↩︎