========================================================================================== DGS eVA File Transfer Client 4.0 – Installation And Configuration Instructions For Windows ========================================================================================== SECTION 1 - Only for first time users of the the DGS eVA File Transfer Client also known as DGS Java Client. SECTION 2 - Only for current/active users of the DGS eVA File Transfer Client also known as the DGS Java Client. ----------------------------------------------------------------- SECTION 1 - First Time Users of the DGS eVA File Transfer Client ----------------------------------------------------------------- ====================== A. Java Runtime Setup ====================== The DGS eVA File Transfer requires Java Runtime Environment (JRE) 1.5 or higher versions. If a Java Runtime Environment (JRE) is not installed on the computer that the DGS eVA File Transfer Client from DGS is going to be placed in, then: 1) Go to http://java.com/en/download/index.jsp and install the current version of the Java JRE. Follow the instructions of the installer and accept default options. A Java 6 JRE may be installed in "C:\Program Files\Java\jre1.6.0_07" or "C:\Program Files (x86)\Java\jre1.6.0_07" for example. 2) Confirm that the directory for the java executables is in your system path. Assuming the JRE is installed in C:\Program Files\Java\jre1.6.0_07, you should see C:\Program Files\Java\jre1.6.0_07\bin in your system path. You can see the current "path" setting by typing the following at a command prompt: path 3) If the JRE's bin directory is not in your system path, you can update it using a command like the example below: Assuming the JRE is installed in C:\Program Files\Java\jre1.6.0_07, set path=%path%C:\Program Files\Java\jre1.6.0_07\bin ====================================== B. DGS eVA File Transfer Client Setup ====================================== The DGS eVA File Transfer can be downloaded to your computer or installed directly from the website (https://evabiz.dgs.virginia.gov/JavaClient/install.aspx) To install the application from the installer file downloaded to your computer, click on the installer file. For example DGSeVAClient-4.0-Setup.exe After the download and installation of the Windows version of the DGS eVA File Transfer Client (FTC) create the following subdirectories in the directory where the DGS eVA File Transfer Client was installed (C:\Program Files\DGSClient\ in our example). 1) Log - (Common) This location contains logs of all transmissions from the FTC, and lets you know if any transmission failed. 2) Error - (Common) This location contains logs of errors encountered by the FTC. 3) VendorReport - (Downloads) The FTC downloads Vendor output files to this location. 4) OrderExport - (Downloads) The FTC downloads Order Export files to this location. 5) Requisition - (Import Uploads) This is where you will place your interface batch files to be imported/uploaded to eVA. 6) Requisition-Archive - (Import Uploads Archive) After interface batch files are imported/uploaded to eVA, the processed interface batch files are moved to this directory. 7) Attachment - (Import Uploads) This is where you will place any input attachment associated with requisitions to be imported/uploaded to eVA. 8) Attachment-Archive - (Import Uploads) After attachments are imported/uploaded to eVA, input attachments are moved to this directory. Important Note: These are merely suggested directory names. The actual directory names and structures do not matter as long as they are set up to match those specified in the custom configuration file mentioned in step 4 that DGS will help you set up. All FTC functionality may not apply to all users. ====================================== C. Provide Directory Structure To DGS ====================================== Provide information on the directory structure from step B above including the complete path for the base directory to DGS. DGS will then send you a functional configuration file (FileManager.xml) that must be placed in the base directory (C:\Program Files\DGSClient\ in our example). This new configuration file will include a shared key that is exclusive to your agency or instution. =============================== D. Executing DGS eVA File Transfer =============================== After you have received the FileManager.xml file from DGS, the DGS eVA File Transfer Client is now installed and ready for use. Run the FTC manually or from another program in your installation by using: C:\Program Files\DGSClient\runFTC.bat Please contact the support team at DGS if you have any issues installing or using the File Transfer Client. --------------------------------------------------------- SECTION 2 - Current Users of DGS eVA File Transfer Client --------------------------------------------------------- As users of the older version of the DGS eVA File Transfer Client (eVAFTC3), it is possible that you have customized your installation in such a way that it requires you to go through the following instructions with your specific customizations in mind. Also note that the minimum JRE version required to run the new File Transfer Client is Java 1.5. Please contact the support team at DGS if you have any specific questions about the install or use of the new version of the DGS eVA File Transfer Client. ===================== A. Java Runtime Setup ===================== Please verify that you have a current version of Java installed. The DGS eVA File Transfer requires Java Runtime Environment (JRE) 1.5 or higher versions. Instructions for setting up the JRE are provided in part A of Section 1 instructions for first-time users of the DGS eVA File Transfer Client. ================================= B. DGS File Transfer Client Setup ================================= 1. Follow the instruction in Section 1 (B. DGS File Transfer Client Setup) above for creating the directories. 2. Copy the existing FileManager.xml in the old directory to the new directory. We will refer to the old directory as "C:\eVAFTC3\" and to the new directory as "C:\Program Files\DGSClient\" for the purpose of the instructions that follow. 3. Verify that the FileManager.xml file is present in the install location "C:\Program Files\DGSClient\". 4. Use a text editor and open the FileManager.xml file. Verify and edit the paths information with the new location. 5. Replace all references to "C:\eVAFTC3" in your applications/processes that use the current file transfer client with equivalents "C:\Program Files\DGSClient\" and "runFTC.bat" respectively. 6. The new DGS eVA File Transfer Client is now installed and ready for use. 7. IMPORTANT - Before testing your new DGS eVA File Transfer Client contact the DGS support staff to have your agency configured to use this version of the client. THIS IS A VERY IMPORTANT STEP. 8. Please test and validate the FTC for all of file transfers you had been doing with the older version is working with the new version. Test downloading very large vendor files that could not be downloaded before with the older version. 9. You may uninstall the older version of the client at any time after the new FTC has been proven to work for all your needs. To uninstall Please contact the support team at DGS if you have any issues installing or using the DGS eVA File Transfer Client.