Installation Guide & Checklist


      This installation can easily be completed by someone with basic Windows familiarity.
      Installation should take about 30 minutes.

Current Version - 1.1.5

released September 13, 2005.
Please be sure you have the latest version downloaded from our Client Portal (portal.getproof.com).

Pre-Requisites

Web Server
  Tomcat 3.3.1 (some other versions of Tomcat work but if you are having problems, try 3.3.1.)
  JDK 1.3.1_08
  Connectivity between web server and DB server. *
 
Database Server
  Microsoft Windows 2000 Server with SP3 or higher
  Microsoft SQL Server 2000 with latest SP
  Vision Professional Database
 
Client Software
  Microsoft Windows 98, ME, NT, 2000, or XP
  Microsoft Internet Explorer 5.5 or higher
 
* IMPORTANT!  Network Security is your responsibility. If you are concerned about securing your web applications, we strongly recommend you use the GetProofWeb Application Framework to safely expose data to authenticated users via secured and encrypted connections and sessions.

IMPORTANT!  The following steps are based on a Windows 2000 installation. If your OS differs, please select applicable equivalent options, where necessary.

Assumptions

The following instructions assume that all pre-requisite software has been installed and configured correctly. This includes Microsoft’s IIS 5.0, Microsoft SQL Server 2000 and GetProof’s VisionPro application. It further assumes that the person using this document has a working knowledge of the IIS Management Console and SQL Server Enterprise Manager.

1. Prior to Installation

  Download (from SSH) and install JDK 1.3.1x series (only), (J2SE SDK) and Tomcat 3.3 on the server where you will host VisionPrivileges.
  Make a note of the directories where JDK and Tomcat have been installed. These will be needed later to define system variables.
  Unzip the VisionPrivileges.zip file to the the webapps folder in the tomcat file structure. For example, if Tomcat is installed at c:\tomcat then extract the PhysicianPrivileges folder to c:\tomcat\webapps\).

2. System Configuration

* NOTE!  If you have previously completed a VisionDirectory Installation, this step is redundant and need not be completed.
 
  From the Control Panel, open System.
  Select the Advanced tab.
  Click on the Environment Variables button.
  Under System Variables, click the New button. A New System Variable prompt appears.
  Enter JAVA_HOME as the Variable Name.
  Enter the path of your JDK installation as the Variable Value. e.g. "c:\jdk1.3"
  Click OK
 

 
  Under System Variables, click the New button again. A New System Variable prompt appears.
  Enter TOMCAT_HOME as the Variable Name.
  Enter the path of your Tomcat installation as the Variable Value. e.g. "c:\tomcat"
  Click OK
 

3. Add Data Source

  From the Control Panel, open Administrative Tools.
  Open Data Sources (ODBC), then select the System DSN tab.
  Click the Add... button.
  Select the SQL Server driver.
 

 
  Enter "V2KMSSQL" in the Name box.
  Enter 'Used by VisionPrivileges' in the Description box.
  Enter the name of the VisionPro DB server in the Server box.
  Click Next.
  Select the With SQL Server authentication... radio button.
  Check the Connect to SQL Server to obtain... checkbox.
  Enter appropriate credentials to connect to the DB in the Login ID: and the Password: boxes.
  Click Next.
  Check Change the default database to: and select your Vision Database.
  Check Use ANSI quoted identifiers and Use ANSI nulls, padding and warnings if not already checked.
  Click Next, click Finish
  Click the Test Data Source... button.
  The message, "TESTS COMPLETED SUCCESSFULLY!" should appear if you have configured your data source correctly.
  Click OK.

4. Final Configuration (required steps)

  To set the default entity for your product, modify the config.properties to include the ENTITY code that you want as your default.
      NOTE!   This value must match an ENTITY column value from your ENTITY table.
      The config.properties file is located at <tomcat>\webapps\VisionPrivileges\WEB-INF\classes\config.properties
          The resulting value should look like the following: DefaultEntity=ABC
          (replace 'ABC' with your Entity Code)

  Use a text editor to modify the filePathv parameter in the web.xml file located at <tomcat>\webapps\VisionPrivileges\WEB-INF\... to include the actual path to the images directory. By default, the images directory is located at <tomcat>\webapps\VisionPrivileges\images\pracimages.

* NOTE!  You do not need image files in the images directory. These will be added on-the-fly by the program.

  VisionPrivileges is now installed. Access VisionPrivileges with your browser at http://<WebServerName>:8080/VisionPrivileges

* NOTE!  The URL is case-sensitive, be sure to capitalize the V and P of ...:8080/VisionPrivileges
* NOTE!  If you would like to run Tomcat as a Windows Service, click here.