Support Center

Bulk Conversion

Last Updated: Mar 26, 2019 09:58AM PDT
This article shows you how to Protect, Release, and Profile data in folders and/or subfolders using a single Bulk operation request.

You can encrypt and decrypt files in Explorer by selecting between one and fifteen items on which to operate. After selecting, you can right-click and choose SSProtect Activate, or Shift-Right-Click then choose SSProtect Release. This executes the requested operation on each file, in parallel. If you have two-factor authentication enabled, you are prompted for each file's operation. Future releases will combine the 2nd-factor action into a single event.
If you want to convert more than fifteen items at a time, and/or you want to have the software automatically apply the operation to a folder and all items within all subfolders, use the Bulk Conversion interface available from the notification icon's context menu.

Bulk Conversion Prerequisites
To use Bulk Conversion, you must first disable 2nd-factor authentication, at least temporarily, otherwise operation will not be practical. You can override this, but it is not recommended. See below for more.

You must also have sufficient time remaining in your Login Session, else you will reach timeout before completion. This can be a problem if subsequent dynamics preclude a follow-up Login. The general rule of thumb is to have at least 2 seconds available for each MB of data you wish to convert, and when this metric is violated, the software provides you with a warning, allowing you to cancel a request to begin so you can Refresh Login from the context menu then retry.

It's worth noting that Session Timeout will result in a prompt for you to enter Account Login credentials. If all goes as expected, conversion continues. This is only a concern if something goes wrong in this process.

Bulk Conversion UI
The interface for Bulk Conversion is shown below:

Select the appropriate Protect or Release radio control, check Include Subfolders if you wish to recursively include subcontent, Browse to the target folder, then choose Protect (or Release) to begin. As noted, you will be given a warning if your Login Session is not suitable, though you can proceed.

Conversion will start immediately after you make your selection. SSProtect will first search the folder's items and all subfolders, computing the total number of items that are candidates for the chosen operation (which can lead to a slight delay). The software will then proceed to begin the conversion, launching numerous external processes that operate in tandem.

Concurrent Operations
Concurrent Operations governs the number of processes executed in parallel. You can change this value prior to making your selection to fine-tune performance. If you have no other applications using significant amounts of CPU or disk access, you can usually select 4 Concurrent Operations for each processor in your host computer. The most typical optimum choice is to have half as many Concurrent Operations as you have target files, though this is often impractical.

Stopping Operation
Once operation begins, you will see conversion progress popups for files that pass the threshold for its' display. You can choose Cancel at any time to stop the process, though keep in mind that enqueued items must complete before the process is finished. This will result in a delay between executing Cancel and actual completion.

When the operation is complete, check your Logfile and Explorer icon overlays for results.

Check the Catalog checkbox with Protect or Release radio controls to enumerate the set of files in the given folder (and subfolders, when Include Subfolders is checked) that will be processed for the given operation. Results are stored in the Host Debug Log, though no Conversion is executed with this operation. Once satisfied with scope, you can proceed with the Protect or Release Bulk Operation as you see fit.

Use the Profile radio control to gain insight into the performance of your host. This utilizes a simple local conversion most often used with guidance from Support, specifically directed at understanding how the software is performing.

Profiling takes a target folder, enumerates all files, and encrypts each one of them individually. This process does not use KODiAC Cloud Services, and encrypted content is not part of your protected data archive - this operation is only used to baseline certain aspects of the conversion process for troubleshooting. Speak to your Support representative for more details.

Note that Profiling creates temporary results files that match the filenames of source material in the target folder, though with the extension, ".ssprof". These are removed on successful completion of a Profiling run, which is marked by the presence of a short performance summary on the Bulk operation display.

Profiling and Performance Considerations
SSProtect carries out far more than encryption and decryption when Protecting content or Releasing existing protections. Profiling very closely mirrors aspects of this process not associated with network-bound cryptographic offloading, which is useful when investigating performance concerns. Results vary, depending on host computer loading, host architecture, the use of an SSD or a spinning hard drive, and even on the amount of free space remaining.

For details, contact your DefiniSec Representative, or refer to the information at the bottom of this article for other options.

Operational Details
Note the following when performing bulk operations:

  • Bulk operation applies to all items in the target folder (and optionally subfolders)*
  • Operation proceeds in parallel, and each thread spins up a conversion process
  • If three Conversions fail in succession, you will be prompted to Continue or Cancel
  • You can navigate to the SSProtect notification icon and Exit during conversion

* - Profiling is limited to a single target folder, and does not operate on subfolder data.

For More Information
If you have questions or comments, you can search the Document Index, the set of articles in these forums, or email with your questions.

This article was updated w/ v9.1.3 of the :Foundation Client

Contact Us
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found