Setup Geoweb

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.

1. Vagrant creates a VirtualBox VM gsd-geoweband performs Sysprep  on it.

2. Vagrant runs the Ansible provisioner and then Ansible will prepare the VM for manual installation of the MSI:

   1. Open ports on the firewall for Web and Reporting.
   2. Create a certificate for the SSL / TLS.
   3. Install IIS.
   4. Create a service acount sa_geoweb.
   5. Configure ISS: create websites, bindings, application pools etc.
   6. Download MSI and license file to the node gsd-geoweb.

3. Provision will fail because a certificate hash needs to be provided. The engineer provides the correct hash and runs the Vagrant provisioner again.

4. Using RDP connection to gsd-geoweb the engineer manually runs the installers. ¹

5. 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.

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 and gsd-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

1. Navigate to https://gsd-agportal1.internal.c2platform.org/portal/home  and login as portaladmin ²

   Username	Password
   portaladmin	portaladmin123

2. 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

3. Via Settings → Application → Update add the Redirect URI shown below and click Update.
   1. https://geoweb.c2platform.org/
   2. https://geoweb.c2platform.org/ModuleViewer
   3. https://geoweb.c2platform.org/ModuleReporting/designer
4. Copy the App ID to your clipboard. For example 3a01FOjRkQJD2dCv.

Install Studio Web

1. RDP connection to gsd-geoweb
2. Rightmouse on shortcut Software on the Desktop anr Run as Administrator
3. Run VertiGIS-Studio-Web-5.28.1.msi

   Module	Destination Folder
   VertiGIS Studio Web	D:\Apps\VertiGIS\Web

4. 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

1. Run as Administrator VertiGIS-Studio-Reporting-5.22.0.msi

   Module	Destination Folder
   VertiGIS Studio Reporting	D:\Apps\VertiGIS\Reporting

2. 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

1. RDP to gsd-geoweb as user vagrant, 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

2. Review the applications:

   Application	Application Pool	Physical Path	Connect as
   ModuleViewer	DefaultAppPool	D:\inetpub\ModuleReporting	sa_geoweb
   ModuleReporting	VertiGISStudioReporting	D:\inetpub\ModuleReporting	sa_geoweb

3. Review the application pools:

   Application Pool	Identity
   DefaultAppPool	sa_geoweb
   VertiGISStudioReporting	sa_geoweb

4. 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

• VertiGIS Studio Web - On-Premises Installation 

Footnotes