7.8.3. Downloading Files/Folders Using the EKM File Transfer Client

You can use the File Transfer Client to transfer any number of files or folders from Shared Data or My Data to your local computer. You will need Download permission on the files or folders that you want to download. When downloading files using the File Transfer Client, you will be prompted to specify a download location, and choose whether or not you want to overwrite files if they already exist in the target location. The File Transfer Client displays the progress of the download, as well as any errors that occurred.


Important:  Download actions are not available on a tablet device.


The File Transfer Client is a full-featured Java application that is launched by a Java Web Start application. When you choose to use the File Transfer Client for uploading files, a Java Network Launch Protocol (JNLP) file is first downloaded to your system. The JNLP file instructs the Java Web Start application to download and run the File Transfer Client application.

The File Transfer Client enables you to use a cache service for file transfers. See Using a Cache System for WAN Transfers.

To download files or folders using the File Transfer Client:

  1. Select the desired files or folders to download. You can select multiple files and folders simultaneously. To select consecutive files, hold down the Shift key while selecting files. To select non-consecutive files, hold down the Ctrl key while selecting files.

  2. Select   (Download) > Using EKM File Transfer Client. The Download From EKM dialog box will appear:


    Note:  If your browser asks you if you want to open or save the LaunchFtc.jnlp application, specify that you want to open the JNLP file with the Java(TM) Web Start Launcher, and then check the Do this automatically for files like this from now on box.


  3. Click Browse to change the download location on your local file system.

  4. Check Get exclusive control over the downloaded files if you want exclusive edit privileges on the downloaded objects. The check box will be enabled only if all of these conditions exist:

    1. You have Modify permission on all of the files/folders selected for download.

    2. None of the objects are under exclusive control by another user.

    3. None of the objects are under version control and checked out to another user.

    If any of the selected files/folders are under version control and you have Modify permissions on the objects, they will optionally (using the check box of Check out) be checked out to you. Items that are under exclusive control will be “locked” and no other users will be allowed to modify them until you release exclusive control.

  5. To calculate the total size of the download, click Transfer Details. The Transfer Details dialog box appears and begins calculating the download size. This calculation takes some time to perform, but you can still interact with the Download From EKM dialog without affecting the ongoing calculation. You can even start the download. When the calculation is finished, the total size of the files to be downloaded is displayed in the Transfer Details dialog box:

    If you are using a cache service for file transfers, the Transfer Details dialog box also displays the percentage of kilobytes that are cached and up-to-date on the cache server. This should give you a better idea of how long the overall download will take, as data downloaded directly from the cache server will be transferred much more quickly. The higher the cache percentage, the faster the overall download will be.

    The percentage cached is rounded to one decimal place. If it is very small (less than .05%), it will display as 0% even though a small amount of data is actually cached. For example, if 49 bytes are cached out of a total of 100,000, the Percentage cached will appear as 0%. 50 bytes out of 100,000 would display as 0.1%. The Percentage cached will only display 100% if all of the data is cached. It will not round up the percentage in this case.

    Note that caching will not occur if the EKM administrator has not assigned you to use the cache server, or if the File Transfer Client cannot establish a connection to the cache server. In either case the data will be downloaded directly from the EKM server, and you will not see the Percentage cached in the Transfer Details dialog box.

  6. To begin the download, click OK. If there are files in the download location that have the same name as any of the files that you are downloading, you will be notified of this, and the files will be overwritten.

  7. The File Transfer Client reports the current stage of the transfer (for example Download or Complete) in the Stage column, and displays the progress of the current stage in the Progress column. If you hover over the Transfer cell you can view the transfer type, date, and transfer start time.

    If any files fail to transfer, the progress bar will turn red, and the number of errors will be reported in the Progress column.

    The Actions column displays buttons for various actions that you can perform, such as stopping or retrying a download. These actions are described in the steps below.

  8. To stop the download, click   in the Actions column. The status changes to Cancelled in the Stage column.

  9. If the transfer was stopped, or if any files failed to download, you can retry the download by clicking   in the Actions column. A new entry will be added to the File Transfer Client window, and the transfer will start again from the beginning.

  10. To display a log of the transfer status at any time during or after the upload, click   in the Actions column. This can be particularly useful if there were any failures. In addition to the date and start/end times, the log reports the number of files transferred, the number of failed transfers, the source path of files that failed to transfer, and the reason that files failed to transfer.

    Alternatively you can send a copy of the log to the Clipboard by clicking   in the Actions column, and then pasting it into a text editing application.

  11. Transfers remain in the File Transfer Client until you delete them. To delete a transfer, select it and then click   in the Actions column.

  12. To open a downloaded file or folder, click   in the Actions column.

  13. When you are finished downloading files, close the File Transfer Client.


Note:  If the file transfer has failed, and the EKM session has timed out, follow these steps to retry the transfer:

  1. Close the File Transfer Client.

  2. Sign in to EKM to start a new session.

  3. Start an upload or download of any file using the File Transfer Client, then cancel the wizard. The File Transfer Client window is displayed.

  4. Retry the failed transfer by clicking   in the File Transfer Client.



Release 18.2 - © ANSYS, Inc. All rights reserved.