Page Comparison

It may be necessary for some colleges to upgrade their download client with the 2016 Annual Update release (5.4.0, Mar 31, 2016.  While  

While we have tested the download client with the latest version and one version back, some of the colleges are running download client versions that are many versions back.  In that case, there may be library inconsistencies that prevent the client from authenticating and/or downloading correctly.  

To upgrade the download client, the college colleges will need to complete the following steps:

1. Backup your current transfer-client installation.  We We recommend zipping up the current transfer-client directory and holding on to that zip file in case you need to revert back to the older version of the transfer client.
   
   

2. Determine the version of java that they you are using.   Usually the The quickest and easiest way to do this it to open up a command prompt and type:  

   Code Block
   java -version

    

   1. If the college is using Java 1.6.*, then download the 5.3.0 version of the download client from here.
       
   2. If the college is using Java 1.7 or higher, then download the 5.4.0 version of the download client from here.
      
       
3. Pick the appropriate file from step 1 and replace the transfer-client.jar file in your existing installation with the new jar file
    
4. Download this application-context.xml file and replace the conf/application-context.xml file from your current installation with the new file.
    

5. Edit the conf/ccctransfer.properties file.   Add If it does not already exist, add the line:

   Code Block
   timeout.seconds=30

   if it does not already exist.
    

6. Test the new download client by switching to the transfer-client directory and running:

   Code Block
   java -jar transfer-client.jar -test https://admin.openccc.net:8443/ccctransfer/debug

   
   if If the download client is able to successfully connect, the last output for that command should be similar to: 

   Code Block
   Debugging Download Requester IP=192.168.1.1 Client Cert Info Cert Info=CN=xxx.edu/MIS\=XXX

7. Run a full download to ensure that downloads work correctly.  

   Code Block
   language bash
   java -jar transfer-client.jar --dry-run jobs/%JOB_FILE%

   Info
   title Note
   The --dry-run option will allow a college to download applications without actually marking them as having been downloaded.   It is intended for testing purposes only. Once the application has been confirmed to work, colleges should either use the download.bat script, download.sh script or run the above command without the --dry-run option for their day-to-day usage.