File distribution

File distribution allows you to bulk distribute files to cloud hosts. If the user is online on a cloud host that is operating correctly, the cloud host receives files after a file distribution task is created. If the user is offline on a cloud host that is operating correctly or a cloud host is shut down, the cloud host receives the files after the user comes online and the operating system is loaded. The recipient cloud hosts automatically create directories to save the received files.

Application scenarios

Use this function to send designated files to multiple online cloud desktops in bulk.

Configuration workflow

1. Upload a file: Upload the files and folders to be distributed to users to Space Console.

2. Configure file distribution parameters: Configure the file distribution parameters, including the maximum number of concurrent distribution tasks and per-cloud host file download rate limit.

3. Distribute files to cloud desktop poos or cloud desktops: Distribute files to online cloud desktops. The recipient desktops automatically create directories to save the received files.

4. Manage files and file distribution task: Delete files and folders; view distribution task information, clear and query distribution task records.

Restrictions and guidelines

• File distribution is not available for IDV or VOI desktops connected to the network through gateways.

• ARM hosts do not support file distribution.

• A drive space of 30 GB is allocated to store files in Space Console for file distribution. The setting cannot be edited.

• Uploading the shortcut to a file or folder is equivalent to uploading the file or folder itself.

• A maximum of 500 files can be uploaded at a time. You can compress multiple files into one file and upload the compressed file to Space Console.

Upload a file

Procedure

1. From the navigation pane, select Applications > File Distribution > File Management.

2. Click Upload. The dialog box for uploading files opens.

3. To upload a single file, click File. Click Upload. In the dialog box that opens, select the target file and click Open, and then click OK. To upload a folder, click Folder. Click Upload. In the dialog box that opens, select the target folder and click Open, and then click OK.

The file list displays all uploaded files and folders.

Parameters

• Type: The value can be File or Folder.

• File Size: Size of the file or folder. The size of the file or folder that can be uploaded is not limited.

• Uploaded At: Time when the file or folder was uploaded.

Configure file distribution parameters

1. From the navigation pane, select Application > File Distribution > File Management.

2. Click Configure.

3. Configure the following parameters as needed:

• Concurrent Tasks: Specify the maximum number of concurrent file distribution tasks. Value 0 means no limit.

• Download Rate Limit: Specify the maximum file download rate per cloud host.

4. Click OK

Distribute files to cloud desktop poos or cloud desktops

Perform this task to distributed files to designated cloud desktop pools or cloud desktops.

Restrictions and guidelines

File distribution can distribute files only to a desktop that is in normal state and has an online user.

Procedure

1. From the navigation pane, select Applications > File Distribution > File Management.

2. Select the files and folders to distribute and click File Distribution.

3. In the dialog box that opens, select Desktop Pools or Desktops for Distribution Mode.

4. Select the desktop pools or desktops to which you want to distribute the selected files and folders, and set the task timeout period.

 

Within the task timeout period, cloud hosts that are operating correctly receive the task if their users are online. After the task expires, Space Console will not distribute files to the cloud hosts that have not received the task within the timeout period.

 

5. Click OK.

Manage files and file distribution tasks

You can perform the following tasks:

• Delete files and folders on the File Management page.

• View file distribution task information on the Distribution Tasks page.

• Clear and query distribution tasks on the Distribution Records page.

Delete files and folders

1. From the navigation pane, select Applications > File Distribution > File Management.

2. Perform either of the following tasks:

• To delete multiple files and folders, select the target files and folders, and then click Delete above the file list.

• To delete a single file or folder, click Delete in the Actions column for the file or folder.

3. In the dialog box that opens, click OK.

View distribution tasks

1. From the navigation pane, select Applications > File Distribution > Distribution Tasks.

2. View information for individual distribution tasks, including:

• VM Name: Name of the recipient VM.

• Files: Names of the distributed files.

• Task Started At: Time when the distribution task started.

• Task Ended At: Time when the distribution task ended.

• Task State: State of the task.

Clear distribution records

Perform this task to delete records of distribution tasks ended on and before the specified date.

1. From the navigation pane, select Applications > File Distribution > Distribution Records.

2. Click Clear.

3. In the dialog box that opens, specify a date to delete records for tasks ended on and before that date.

4. Click OK.

Configure scheduled distribution record cleanup settings

Perform this task to configure scheduled distribution record cleanup settings, including the maximum retention period per record and the action (delete or export) to take on expired records. Depending on the action specified, the system will delete or export expired distribution records at 03:00 am every day.

1. From the navigation pane, select Applications > File Distribution > Distribution Records.

2. Click Clear on Schedule.

3. In the dialog box that opens, configure the following parameters:

• Actions: Select Delete to delete expired distribution records or select Export to File to export expired distribution records to a file. The exported records will be saved to a file in the /usrexport directory on the management node and then removed from the distribution record list.

• Retention Period: Maximum number of days a distribution record can be kept before being deleted or exported. The minimum retention period is 1 day.

4. Click OK.

Query distribution records

1. From the navigation pane, select Applications > File Distribution > Distribution Records.

2. Click Advanced Query.

3. Configure the following query parameters as needed:

• Files: Enter the names of the distributed files.

• Task Started At: Specify the time when the distribution task started.

• Task Ended At: Specify the time when the distribution task ended.

• State: Select a task state. Options are Distribution Succeeded, Distributed Failed, and Unknown.

4. Click OK.

The distribution record list displays all records matching the specified query criteria.