Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

It may be necessary for some colleges to upgrade their download client with this release.  While we have tested the download client with the latest version and 1 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 will need to:

 

  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 to the older version of the transfer client.

  2. Determine the version of java that they are using.   Usually 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 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 the line:

    timeout.seconds=30

    if it does not already exist.

  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.
  • No labels