Setup Geoweb
Categories:
Projects: c2platform/rws/ansible-gis
,
c2platform.wincore
,
c2platform.gis
Overview
Here’s an overview of the process in this how-to to setup Geoweb which currently consists of VertiGIS Studio Web and Reporting.
Vagrant creates a VirtualBox VM
gsd-geoweb
and performs Sysprep on it.Vagrant runs the Ansible provisioner and then Ansible will prepare the VM for manual installation of the MSI:
- Open ports on the firewall for Web and Reporting.
- Create a certificate for the SSL / TLS.
- Install IIS.
- Create a service acount
sa_geoweb
. - Configure ISS: create websites, bindings, application pools etc.
- Download MSI and license file to the node
gsd-geoweb
.
Provision will fail because a certificate hash needs to be provided. The engineer provides the correct hash and runs the Vagrant provisioner again.
Using RDP connection to
gsd-geoweb
the engineer manually runs the installers. 1The engineers runs the provisioner again to update the IIS configuration created by the VertiGIS installers to use for example the service account
sa_geoweb
.
Node | OS | Provider | Purpose |
---|---|---|---|
gsd-geoweb | Windows 2022 Server | VirtualBox | Web and Reporting |
Prerequisites
- Before proceeding, make sure you have completed the steps to Setup the RWS Development Environment on Ubuntu 22
- Geoweb license.
- ArcGIS Server, Portal etc. running on
gsd-agserver1
andgsd-agportal1
see Setup ArcGIS Server and Date Store using Ansible and Setup ArcGIS Portal and Web Adaptors using Ansible
Setup
Use the following command
vagrant up gsd-geoweb
Note:
Currently provision will fail on task Configures a IIS Web site binding because this thewin_iis_webbinding
modules requires the certificate_hash
.
Using certlm.msc
you will have to find the hash / thumbPrint and then update
configuration locally group_vars/geoweb/win.yml
and provision again without
errors.Create App in ArcGIS Portal
- Navigate to
https://gsd-agportal1.internal.c2platform.org/portal/home
and login as
portaladmin
2Username Password portaladmin
portaladmin123
- Choose Content → New Item → Application
Property Value Comment Application Type Other Application Title Geoweb Modules registratie
Folder Keep default portaldmin
Tags Geoweb
Vertigis Studio
Modules
Summary App for VertiGIS Studio modules registration
- Via Settings → Application → Update add the Redirect URI
shown below and click Update.
https://geoweb.c2platform.org/
https://geoweb.c2platform.org/ModuleViewer
https://geoweb.c2platform.org/ModuleReporting/designer
- Copy the App ID to your clipboard. For example
3a01FOjRkQJD2dCv
.
Install Studio Web
- RDP connection to
gsd-geoweb
- Rightmouse on shortcut Software on the Desktop anr Run as Administrator
- Run
VertiGIS-Studio-Web-5.28.1.msi
Module Destination Folder VertiGIS Studio Web D:\Apps\VertiGIS\Web
- Start post-installation configuration
Property Value IIS Website Default Web Site Virtual Directory /ModuleViewer/
Portal Type Portal for ArcGIS Portal URL https://age.c2platform.org/portal/home
App ID ( value from previous step ) Redirect URL https
geoweb.c2platform.org
Install Studio Reporting
- Run as Administrator
VertiGIS-Studio-Reporting-5.22.0.msi
Module Destination Folder VertiGIS Studio Reporting D:\Apps\VertiGIS\Reporting
- Post installation configuration
Property Value Data Directory D:\ProgramData\Geocortex\Reporting
IIS Website ModuleReporting Virtual Directory /ModuleReporting/
Portal Type Portal for ArcGIS Portal URL https://age.c2platform.org/portal/home
App ID ( value from previous step ) Redirect URL https
geoweb.c2platform.org
/ModuleReporting/designer/
Verify
RDP to
gsd-geoweb
as uservagrant
, start IIS Manager and review sites basic settings:Site name Application Pool Physical path Connect as 3 ModuleViewer DefaultAppPool D:\inetpub\StudioWeb
Pass-through authentication ModuleReporting DefaultAppPool D:\inetpub\ModuleReporting
Pass-through authentication Review the site bindings:
Site name Type IP address Port Host name SSL certificate ModuleViewer http All Unassigned 8080 (empty) ModuleViewer https All Unassigned 4443 (empty) gsd-geoweb.internal.c2platform.org ModuleReporting http All Unassigned 8081 (empty) ModuleReporting https All Unassigned 4444 (empty) gsd-geoweb.internal.c2platform.org Review the applications:
Application Application Pool Physical Path Connect as ModuleViewer DefaultAppPool D:\inetpub\ModuleReporting sa_geoweb ModuleReporting VertiGISStudioReporting D:\inetpub\ModuleReporting sa_geoweb Review the application pools:
Application Pool Identity DefaultAppPool sa_geoweb VertiGISStudioReporting sa_geoweb Navigate to https://geoweb.c2platform.org/ModuleViewer/ and https://geoweb.c2platform.org/ModuleReporting/ and login as
portaladmin
.
Review
In the inventory project
c2platform/rws/ansible-gis
:
- The Geoweb play
plays/gis/geoweb
. - The Geoweb configuration in
group_vars/geoweb
.
The cplatform.gis.vertigis_studio
Ansible role currently does not do a lot, it
is only used to download MSI installers and the license file to the gsd-geoweb
node. Most of the work is done by the c2platform.wincore.win
role.
Additional Information
Footnotes
Automating the MSI might be possible using a script similar install-vsw.ps1 but in that case it does seem to be supported to use a different virtual directory. In relation to the script, it seems that parameters
VirtualPath
is not ignored. ↩︎Reverse proxy URL
https://age.c2platform.org/portal/home/
does not work currently. But the link does work and is required when installing Web or Reporting. ↩︎The
win_iis_website
module does not allow us to configure a different “connect as” user. If this needs to be changed, this is a manual step. ↩︎
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.