VetView Portal 2.0 Installation Guide

As of the 2.0 version of VetView the portal now uses web services to pull all content through the Main VetView application. This allows for the portal to be light weight and isolated for security reasons. We have also made the Portal project open source, so it can be fully customized. 


System Requirements

  - Java 8+ 

  - Tomcat 9

  - If the Portal project is running on a different server then the VetView main application, make sure the 2 servers can send and receive data via http web server calls. ( ie Firewall Exceptions ) 


Configuration File

To configure the portal web server to connect to the main vetview app, you will need to update the PortalConfig.yml file. There is an example file below or you can find an example file included in the war after being deployed on the Tomcat server. 

This file will be found at in the WEB-INF/classes folder (inside your VetView installation folder).


New Configuration Options

With VetView 2.0 the PortalConfig.yml can now be added the to the Tomcat directory. This will allow for the configuration to be maintained between versions.

All configuration is now in the single PortalConfig.yml file.  ".yml" ( recursive acronym for "YAML Ain't Markup Language" ) files use the # symbol to comment out the line and file format and spacing is important. 

The portal configuration only has 2 items that need to be set,

  1. baseURL - This the url for the main VetView application that portal will send and receive its data from. 
  2. authToken - this is security key that is passed with every data request between the portal and main application. This token is auto generated and can be found on the "Portal Setup" page in the main VetView application.   

Copy and paste the token into the YML configuration file.

  

Web Services Calls