ShareFile Operations Test

One of the reasons why users opt for ShareFile is that it enables them to quickly and securely upload, download, and even delete files from anywhere through any desktop/device. However, at runtime, if ShareFile is unable to deliver the high-quality experience it promises , IT will be forced to hunt for alternatives. To avoid such an outcome, administrators should make sure that the guaranteed ShareFile service levels are delivered at all times. For this, administrators will have to periodically check the time it takes to upload, download, and delete files from ShareFile, isolate bottlenecks proactively, and plug the holes before users complain. The ShareFile Operations test helps administrators in this exercise. At configured intervals, this test emulates a file upload, download, and delete using ShareFile and reports the time it takes to perform each of these operations. This provides administrators with early indicators of problem conditions, thus enabling them to resolve the problem before any irrepairable damage is done.

This test is disabled by default. To enable the test, go to the enable / disable tests page. To access this page, follow the Tests -> Enable/Disable menu sequence in the Agents tile of the Admin tile menu. In the enable/disable tests page, pick Citrix ShareFile as the Component type, Performance as the Test type, choose this test from the disabled tests list, and click on the < button to move the test to the ENABLED TESTS list. Finally, click the Update button.

Target of the test : Citrix ShareFile

Agent deploying the test : A remote agent

Outputs of the test : One set of results for the Citrix ShareFile account that is monitored

Configurable parameters for the test
  1. Test period - How often should the test be executed
  2. Host - The host for which the test is to be configured.
  3. port – The port at which the host listens. By default, this is NULL.
  4. email id – Provide the email ID of the Sharefile user with ‘Admin’ access to Sharefile. The credentials of this user are necessary for enabling this test to connect to the Sharefile REST API, running API commands, and pulling out metrics.  
  5. password – Specify the password associated with the configured email id
  6. CONFIRM PASSWORD – Confirm the password by retyping it here.
  7. ssl – Indicate whether/not Sharefile is SSL-enabled. By default, this flag is set to Yes.
  8. path to upload– When this test runs for the very first time, it automatically creates the file to be uploaded on the eG agent host. Against path to upload, you need to specify the full path to the personal folder (corresponding to the ShareFile user) in which the file has to be uploaded. Once the file is uploaded to the specified folder, the test will try to download the same file from ShareFile to the path specified against path to upload. Next, the eG agent will attempt to delete the file from ShareFile.

    For example, if you specify allshared against this parameter, then, the file will be directly uploaded to the Personal Folders of the Sharefile user.

    Alternately, if you wish to upload the file to a specific folder available in the Personal Folders of the Sharefile user, then, you need to specify the exact name of that folder. For example, if you specify, eGfolder against the Path to Upload parameter, then, the file will be uploaded to the eGfolder available in the Personal Folders of the Sharefile user.

    You can also upload the file to nested folders in the Personal Folders of the Sharefile user. For example, if you wish to upload the file to a folder called 'Substitute' available in the eGfolder (available in the Personal Folders of the Sharefile user), then, you need to specify, eG/Substitute against the Path to Upload parameter.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Upload status

Indicates whether/not the upload was successful.

 

The values that this measure can report and their corresponding numeric values are discussed in the table below:

Measure Value

Numeric Value

Success

1

Failed

0

Note:

By default, this measure reports the Measure Values discussed in the table above. However, in the graph of this measure, the upload status is indicated using the numeric equivalents only.

Time taken for upload

Indicates the time it took for this test to upload the file to ShareFile.

Secs

Ideally, the value of this measure should be low. A high value is indicative of a poor upload experience with ShareFile. The reasons for the same should be investigated.

Download status

Indicates whether/not the download was successful.

 

The values that this measure can report and their corresponding numeric values are discussed in the table below:

Measure Value Numeric Value

Success

1

Failed

0

If upload fails, then download and delete will fail.

Note:

By default, this measure reports the Measure Values discussed in the table above. However, in the graph of this measure, the download status is indicated using the numeric equivalents only.

Time taken for download

Indicates the time it took for this test to download the file from ShareFile.

Secs

Ideally, the value of this measure should be low. A high value is indicative of a poor download experience with ShareFile. The reasons for the same should be investigated.

Delete status

Indicates whether/not the delete was successful.

 

The values that this measure can report and their corresponding numeric values are discussed in the table below:

Measure Value Numeric Value

Success

1

Failed

0

If upload fails, then download and delete will fail.

Note:

By default, this measure reports the Measure Values discussed in the table above. However, in the graph of this measure, the delete status is indicated using the numeric equivalents only.

Time taken for delete

Indicates the time it took for this test to delete the file from ShareFile.

Secs

Ideally, the value of this measure should be low. A high value is indicative of a poor file deletion experience with ShareFile. The reasons for the same should be investigated.