INSTALLATION_VERSION
====================
This installation guide is for version 02_00_13.

INSTALLATION COMPONENTS
=======================
+ VegCap II GUI
+ Business Validation Engine


INSTALLATION USER FILES
========================
On your local PC, the following files will be located in the following directory...
"C:\APPS\VEGCAP"

+ VegCap-II-for-Contractors.mxd


INSTALLATION CONFIGURATION FILE
===============================
On your local PC, the following files will be placed in the following directory...
C:\APPS\VEGCAP\ (or the <user selected installation directory>)

+ vrims_conf.resx
+ codes.xml


INSTALLATION DLL FILES
======================
 A series of IKVM*.dll's
 ret.dll
 Utils.dll
 VegAudit.dll
 VegGUI.dll
 VRIMSDB.dll
 VRIMSMenu.dll
 

INSTALLATION REQUIREMENTS
=========================
+ ArcGIS Desktop 10.3+
+ .NET Framework 3.5 SP1


PRE INSTALLATION
================

- Is ArcGIS Desktop 10.3 or higher installed? 
===================================
Check by starting ArcMap (Start > All Programs > ArcGIS > ArcMap 10.3 or higher) 
Check the version number in Help >About ArcMap.

- Is Microsoft .NET Framework 3.5 SP1 (or greater) installed? 
=============================================================
Check by going to Start > Control Panel > Programs > Programs and Features.
Look for "Microsoft .NET Framework X.Y.Z" and verify that it is 3.5 SP1 or greater.

Note: ArcGIS 10.3+ install should have required that .NET Framework 3.5 SP1 (or greater) was already installed!


UNINSTALL PREVIOUS VEGCAP
=========================
- If you have a previously installed version of VEGCAP it will be necessary to uninstall this previous version using the "Windows Uninstall or Change a Program".


INSTALL CURRENT VEGCAP
======================

- Using Windows Explorer.
- Navigate to the following directory...
[unzipped directory]
   [version number]

- Double click (or run) Install.EXE
- Follow the WISE Installation Instructions to complete the installation.

* Note : You may need to edit the path to RegAsm.exe in the install\register_dlls_02_00_13.bat file.


CREATE USER ENVIRONMENT VARIABLE [REQUIRED]
==============================================

- Create a USER Environment Variable called VRIMS_CONF_FILE

- An USER environment variable called VRIMS_CONF_FILE should have been created and should point to the following directory: 
- The variable should point to the following directory and include the required file name. For example...
  C:\Program Files\VegCap\ (or the <user selected installation directory>)


COPY VEGCAP ICON BMPS [REQUIRED]
================================

- If the *.bmp files are not in the "C:\APPS\VEGCAP\bmps" directory then the [version]\config\bmps\*.bmp files needs to placed in the following directory... C:\Program Files\VegCap\bmps
  note: C:\APPS\VEGCAP\bmps (or the <user selected installation directory>\bmps)


REMOVE ENVIRONMENT VARIABLE [OLD]
=================================
- The following environment variable may be removed at this time.
+ VRIMS_CODES_FILE


UPDATE CONFIGURATION FILE
=========================
The C:\APPS\VEGCAP\vrims_conf.resx file may have to be edited in order to update the following values, so that they will be unique for the contractors environment.


	CODE FILE LOCATION
	==================
	<data name="code_file">
		<value>C:\APPS\VEGCAP\codes.xml</value>
		<comment>Location of the Code set file</comment>
	</data>


INSTALLATION FINAL TOUCHES
==========================

+ The following file can be marked as read-only, once the installation is complete.
 * C:\APPS\VEGCAP\codes.xml
 * C:\APPS\VEGCAP\vrims_conf.resx


INVOCATION
==========
- The easiest way to invoke the VRIMS ArcMap extensions is to double-click the "%USERPROFILE%\%APPDATA%\ESRI\ArcMap\Templates\VegCap-II-for-Contractors.mxd" file. This will start ArcMap, as well as open the VRIMS template. This template will put a "VRIMS" menu on the menubar.

- Otherwise, start ArcMap by clicking Start > All Programs > ArcGIS > ArcMap 10.1
When prompted by the application, select open an existing template and browse to the "%USERPROFILE%\%APPDATA%\ESRI\ArcMap\Templates\VegCap-II-for-Contractors.mxd" file.


OPERATION AND TROUBLESHOOTING
=============================

VegCap Profiles - Depending on the system environment, it may be that you as a User, do not have Write permission into the [profiles] directory when running ArcMap 10.1. To find out if this is the case, when you try to save a Profile in the VegCap GUI, you will get an ArcMap write error message.  

To fix, there are two possible solutions:

1. Run ArcMap 10.3 (or higher) as an Administrator 
	- Right click on the ArcMap 10.3 (or higher) application icon and select [Run as administrator];

OR

2. Alter the permissions of the [profiles] sub-directory to allow normal users Write access.

	- Right click on the [profiles] directory and select [Properties], 
	- select the [security] tab, 
	- select [Edit], 
	- select [Users], 
	- Toggle the [Write] toggle to Selected under Allow, 
	- Select [Apply], 
	- Select [Ok] 
	- Select [Ok] again.









