Setup Geoweb
Categories:
4 minute read , 7 minute provision
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
.
Using RDP connection to
gsd-geoweb
the engineer “manually” runs the installers1.The 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
- You need to make Vertis Studio software and license files available see Making RWS Software and License Files Available for Ansible.
- Ensure ArcGIS Server, DataStore, Portal and Web Adaptor is 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
Create App in ArcGIS Portal
- Navigate to
https://gsd-agportal1.internal.c2platform.org/portal/home
and login as
portaladmin
2.Username 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 URL https://geoweb.c2platform.org/ ;
- add the Redirect URI
https://geoweb.c2platform.org/
https://geoweb.c2platform.org/ModuleViewer
https://geoweb.c2platform.org/ModuleReporting/designer
- click Save.
- 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.31.0.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://gsd-agportal1.internal.c2platform.org/portal/home
2App 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://gsd-agportal1.internal.c2platform.org/portal/home
2App 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 as3 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 have a lot
code. Downloads of MSI installers and the license file is performed by the
c2platform.wincore.download
role. And most of the configuration 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. Instead of that URL we usehttps://gsd-agportal1.internal.c2platform.org/portal/home
. ↩︎ ↩︎ ↩︎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.