File Copy Modules
File Copy Modules provide the ability to simply copy files to your endpoints. They are also used to install drivers for your images. Modules are then assigned to policies to control how they deployed to the target computers. They can also be deployed to a single computer without the need of creating a policy by using the Instant Module runner.
Search
The search page allows you to view, delete, and archive existing modules. When a module is no longer needed, best practice is to archive the module.
Archiving a module keeps all historical data about the module and if the module is needed again at a later date, it can easily be restored.
File Copy modules can be filtered by the module name and category
Actions
| Action | Description |
|---|---|
| Archive Selected | Archives all of the selected modules |
| Delete Selected | Permanently deletes all of the selected modules |
New
The new page allows you to create a new File Copy module.
| Field | Description |
|---|---|
| Display Name | The name of the module, module names must be unique and contain only alphanumeric characters, space, underscore, or dash. |
| Description | The description field is optional for you to give a short description for what the module does. |
| Destination | The full path of the destination directory for the files, such as c:\temp. There is one special option for this field [toec-appdata] will cache the files in the toec appdata directory to be referenced by other modules. |
| Unzip After Copy | When this option is enabled, any zip files that are part of the module will be unzipped to the destination directory, otherwise the zip file itself will be copied. |
| Is Driver | When creating a universal image and you want to inject drivers during imaging, this option must be enabled to specify this module as a driver. |
| Overwrite Existing Files | If this option is enabled, any existing files with the same name in the destination directory will be overwritten. |
Archived
The archived page allows you view, restore, and permanently delete archived modules.
Archived File Copy modules can be filtered by the module name.
Actions
| Action | Description |
|---|---|
| Delete Selected | Permanently deletes all of the selected modules |
Note
The following additional pages are available after a module is added or when selecting the view button on a specific module from the search page.
General
The General page allows you to update the general options for the module. It shows the same options as the New page, with the exception of the following additional fields.
| Field | Description |
|---|---|
| GUID | Each module is automatically assigned a guid for an id. This is read only and only for reference. |
Actions
| Action | Description |
|---|---|
| Update Module | Updates the module with any changes you have made |
| Archive Module | Archives the current module |
| Delete Module | Permanently deletes the current module |
Upload Files
The upload files page is where you add or remove the files for your File Copy Module. If you are using multiple Client Communication Servers, you will be prompted to replicate the files to all servers when uploading is complete.
You must stay on the upload files page while files are uploading, navigating to a different page will stop the upload.
Files can be select from the Select Files button or by drag and drop into the file box. Click Upload when you are ready to upload all of the selected files. There is no Actions drop down button to upload the files.
Actions
| Action | Description |
|---|---|
| Archive Module | Archives the current module |
| Delete Module | Permanently deletes the current module |
Usages
The usages page allows you quickly see which Polices, Computers, or Groups currently have the module assigned to them. Use the Usage Type drop down list to switch b/w Policies, Groups, or Computers.
Actions
| Action | Description |
|---|---|
| Archive Module | Archives the current module |
| Delete Module | Permanently deletes the current module |
Categories
Categories operate like tags and allow you to organize your modules and filter by them on the search page. Categories can be defined in Global Properties->Categories
Actions
| Action | Description |
|---|---|
| Update Module | Updates the module with any of the selected categories |
| Archive Module | Archives the current module |
| Delete Module | Permanently deletes the current module |
External Files
External files provide an additional way to add files to the module. Instead of uploading an existing file from your computer, you can download directly from a URL. External files were mainly created to share policies.
Policies can be exported and imported by other users. If external files are used, once the policy is imported it will also automatically download any required files.
To download external files:
- Enter a file name
- Provide the url
- Optionally provide a sha256 checksum, if the checksum doesn't match after the file is downloaded, it will be deleted.
- Click Add
- Once all files are added, click Actions, then Download Files
File Downloads run async, you can navigate away from the page once the download starts Finally there is button to sync servers when downloads are complete, this should be enabled before starting the download if you want to replicate all Client Communication Servers when complete.
Actions
| Action | Description |
|---|---|
| Download Files | Downloads all files that have been specified in the grid |
| Archive Module | Archives the current module |
| Delete Module | Permanently deletes the current module |