==================================================================================== eVA File Transfer Client 4.0 – Installation And Configuration Instructions For Unix ==================================================================================== SECTION 1 - Only for first time users of the the eVA File Transfer Client also known as DGS Java Client. SECTION 2 - Only for current/active users of the eVA File Transfer Client also known as the DGS Java Client. ----------------------------------------------------------------- SECTION 1 - First Time Users of the eVA File Transfer Client ----------------------------------------------------------------- ====================== A. Java Runtime Setup ====================== If a Java Runtime Environment (JRE) is not installed on the computer that the 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 for your execution environment. Follow the instructions of the installer and accept default options. The Unix installer for java may just involve an unzip (or gunzip) of the file. For example, you may have your jre installed at /usr/jdk/jdk1.6.0_31/jre. 2) Confirm that the directory for the java executables is in your system path. Assuming the JRE is installed in /usr/jdk/jdk1.6.0_31/jre, you should see /usr/jdk/jdk1.6.0_31/jre/bin in your system path. You can see the current "path" setting by typing the following at a command prompt: set | grep 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: set path=($path /usr/jdk/jdk1.6.0_31/jre/bin) ================================== B. eVA File Transfer Client Setup ================================== The 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 DGSClient_Unix-4.0-AIX-ppc-Install for IBM AIX installer downloaded. After the download and installation of the Unix version of the eVA File Transfer Client (FTC) create the following subdirectories in the directory where the eVA File Transfer Client was installed (/usr/local/DGSClient in our example). 1) Log - (Common) This contains logs of all transmissions from the FTC, and lets you know if any transmission failed. 2) Error - (Common) This 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 - (Uploads) This is where you will place your interface batch files to be transmitted/uploaded to eVA. 6) Requisition-Archive - (Uploads) After transmission to eVA, interface batch files are placed here. 7) Attachment - (Uploads) This is where you will place any input attachment associated with Requisitions to be uploaded to eVA. 8) Attachment-Archive - (Uploads) After transmission to eVA, input attachments are placed here. 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 Structures 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 (/usr/local/DGSClient in our example). This new configuration file will include a shared key that is exclusive to your agency or instution. =============================== D. Executing eVA File Transfer =============================== After you have received the FileManager.xml file from DGS, the eVA File Transfer Client is now installed and ready for use. Run the FTC manually or from another program in your installation by using: /usr/local/DGSClient/runFTC.bat ================== runFTC.bat content ================== #!/bin/csh -f ### assuming C-shell ... change to other shell if needed ### executable must be in base directory alongside all jar files and FileManager.xml. setenv JAVA_HOME /opt/customer/eVALabs/Shared/jdk1.6.0_11 ### change directory for your environment where Java is installed $JAVA_HOME/bin/java -classpath ./fileManager.jar:./commons-codec-1.6.jar:./xercesImpl.jar:./resolver.jar:./serializer.jar:./xml-apis.jar:./jcert.jar:./jnet.jar:./jsse.jar:./ibm_jsse.jar cova.dgs.eva.fileManager echo done with run exit 0 Please contact the support team at DGS if you have any issues installing or using the File Transfer Client. ----------------------------------------------------- SECTION 2 - Current Users of eVA File Transfer Client ----------------------------------------------------- As users of the older version of the 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 eVA File Transfer Client. ===================== A. Java Runtime Setup ===================== Please verify that you have a current version of Java installed. The 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 eVA File Transfer Client. ================================= B. eVA File Transfer Client Setup ================================= 1. Follow the instruction in Section 1 (B. eVA 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 "/usr/local/eVAFTC3/" and to the new directory as "/usr/local/DGSClient/" for the purpose of the instructions that follow. 3. Verify that the FileManager.xml file is present in the install location "/usr/local/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 "/usr/local/eVAFTC3" and in your applications/processes that use the current file transfer client with equivalents "/usr/local/DGSClient/" and "runFTC.bat" respectively. 6. The new eVA File Transfer Client is now installed and ready for use. 7. IMPORTANT - Before testing your new 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. Please contact the support team at DGS if you have any issues installing or using the eVA File Transfer Client.