Upgrading the Download Client

Owned by Patricia Donohue
Last updated: Apr 05, 2016

After the 5.4.0 release on March 31, 2016, we found that it may be necessary for some colleges to upgrade their CCCApply Download Client.with Java version 7  

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 your Download Client, complete the following steps:

  1. Backup your current transfer-client installation. 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 you are using. The quickest and easiest way to do this it to open up a command prompt and type:  

    java -version

     

    1. If the college is using Java 1.6.*, then download the 5.3.0 version of the Download Client here.
    2. If the college is using Java 1.7 or higher, then download the 5.4.0 version of the Download Client 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.   If it does not already exist, add the line:

    timeout.seconds=30

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

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


    If the Download Client is able to successfully connect, the last output for that command should be similar to: 

    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.  

    java -jar transfer-client.jar --dry-run jobs/%JOB_FILE%

    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.