ShareFile Operations Test

One of the reasons why users opt for Content Collaboration 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 Content Collaboration 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 Content Collaboration 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 Content Collaboration, 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 Content Collaboration 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 Content Collaboration 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 Content Collaboration

Agent deploying the test : A remote agent

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

Configurable parameters for the test
Parameters Description

Test period

How often should the test be executed

Host

The host for which the test is to be configured.

Port

The port at which the Host listens. By default, this is NULL.

Email ID

Provide the email ID of the Citrix Content Collaboration user with ‘Admin’ access to Citrix Content Collaboration. The credentials of this user are necessary for connecting to the Citrix Content Collaboration REST API, running API commands, and pulling out metrics.

Password

Specify the password associated with the configured Email ID.

Confirm Password

Confirm the Password by retyping it here.

SSL

Indicate whether/not Content Collaboration is SSL-enabled. By default, this flag is set to Yes.

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 Folders (corresponding to the Content Collaboration user in the Content Collaboration portal) 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 Content Collaboration to the path specified against path to upload. Next, the eG agent will attempt to delete the file from Content Collaboration.

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

Alternately, if you wish to upload the file to a specific folder available in the Personal Folders of the Content Collaboration 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 Content Collaboration user.

You can also upload the file to a folder in the Personal Folders of the Content Collaboration 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 Content Collaboration user), then, you need to specify, eG/Substitute against the Path to Upload parameter.

Proxy Host, Proxy Port, Proxy User Name, Proxy Password and Confirm Password

These parameters are applicable only if the eG agent needs to communicate with the Citrix Content Collaboration portal via a Proxy server.

In this case, provide the IP/host name and port number of the Proxy server that the eG agent should use in the Proxy Host and Proxy Port parameters, respectively.

If the Proxy server requires authentication, then specify the credentials of a valid Proxy user against the Proxy User Name and Proxy Password text boxes. Confirm that password by retyping it in the Confirm Password text box. If the Proxy server does not require authentication, then specify none against the Proxy User Name, Proxy Password, and Confirm Password text boxes.

On the other hand, if the eG agent is not behind a Proxy server, then you need not disturb the default setting of any of the Proxy-related parameters. By default, these parameters are set to none.

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 Content Collaboration.

Secs

Ideally, the value of this measure should be low. A high value is indicative of a poor upload experience with Content Collaboration. 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 Content Collaboration.

Secs

Ideally, the value of this measure should be low. A high value is indicative of a poor download experience with Content Collaboration. 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 Content Collaboration.

Secs

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