# File

The File Module contains options to configure the searches of files which have to migrate. RealMigrator searches these files and copies them to a defined destination.

![](https://128169741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJtYzSHkivOXU1eIfZOq%2Fuploads%2Fgit-blob-54f5c1c5fb1c51b7e687b20118fef50524373224%2FFiles1.PNG?alt=media)

## Upload Store

Upload stores always support basic file operations (upload file, create directory). They can support delete operations on files and directories to support proper synchronization.\
In addition, they can support blockmode uploads, which enable differential uploads based on hash maps.

![](https://128169741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJtYzSHkivOXU1eIfZOq%2Fuploads%2Fgit-blob-787628113ecaf363b44721b6b2036aa6b53e2dbc%2FFiles2.PNG?alt=media)

| Setting         | Explanation                                                                                                                                                                                                                                                                        |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type            | <p><strong>File</strong>: Writes to a file back-end, either local or on a file server<br><strong>OneDrive</strong>: Stores to the user's OneDrive via a RealMigrator server Graph API<br><strong>Blob Storage</strong>: Stores a blob storage via RealMigrator server Blob API</p> |
| Root path       | Default root path                                                                                                                                                                                                                                                                  |
| Diff file size  | Default size are 4 MB. When a file exceeding this size it will be uploaded in blocks. It is possible to define a own size                                                                                                                                                          |
| Diff block size | When a file has to uploaded in blocks the default size is 1 MB                                                                                                                                                                                                                     |
| Path blacklist  | Paths which are listed in a blacklist are excluded from all catalogs and will not be part of migrations (see \[Well-known folder] ({{< ref "modules/wellknownfolder/\_index.md" >}}) for folder (paths) list)                                                                      |

## Catalog

A catalog defines which files RealMigrator has to migrate and where to find them.

![](https://128169741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJtYzSHkivOXU1eIfZOq%2Fuploads%2Fgit-blob-60130ca093bde4dba72c42f009e3bcc73a5feff8%2FFiles3.PNG?alt=media)

| Setting              | Explanation                                                                                                                                                                                                                                                                               |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                 | Name of the catalog                                                                                                                                                                                                                                                                       |
| Path                 | Concrete path and place where RealMigrator will find the files (see \[Well-known folder] ({{< ref "modules/wellknownfolder/\_index.md" >}}) for folder (paths) list)                                                                                                                      |
| Remote path          | Defined destination for **Path**                                                                                                                                                                                                                                                          |
| Filter               | RealMigrator migrates the listed file formats                                                                                                                                                                                                                                             |
| Blacklist            | When activated RealMigrator will migrate all file formats except the formats from **Filter**                                                                                                                                                                                              |
| Synchronization Type | <p><strong>One-Move Sync</strong>: Copies remote storage and removes them if they are deleted in the source path<br><strong>Copy</strong>: Copies changes but does not remove deleted files<br><strong>Move</strong>: Removes local file after they were copied to the remote storage</p> |

### Catalog Order

Use the **up and down buttons** to change the order of catalogs

![](https://128169741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJtYzSHkivOXU1eIfZOq%2Fuploads%2Fgit-blob-aeeb341ab0b2c03857785f3df43428d3dae86131%2FFiles4.PNG?alt=media)

### Create and Delete catalogs

At the bottom of the page, there are buttons to create new catalogs or delete existing ones

![](https://128169741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJtYzSHkivOXU1eIfZOq%2Fuploads%2Fgit-blob-412e605281c2487be2f24b372ed6d9b75a08e097%2FFiles5.PNG?alt=media)

* To add further catalogs click the button **Catalog**
* To delete the last created catalog click the button **Last Catalog**
* To delete all of them, click the button **All**

## Log level and Reset code

| Setting    | Explanation                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Log level  | Available log levels are **Error**, **Info** and **Debug**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Reset Code | A client is always checking the own configurations after a defined period of time. This means that the client compares the selected client settings with the selected server settings. In addition the client connect to the server based on \[Module loop delay]\({{< ref "beginning/serverconfig/\_index.md#global-client-configuration" >}}), a defined period of time. By this time value the client is starting a Module loop and the client is checking the Reset code. If there is a Reset code change the client will takes over the new configuration. If there is no change, the client will still use the existing configuration. |
| Power mode | If this mode is activated, power down is prevented during migration.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

![](https://128169741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJtYzSHkivOXU1eIfZOq%2Fuploads%2Fgit-blob-9a37810212f534d5420cf16e5eb58f0a10819fc6%2FFiles6.PNG?alt=media)

## Script

RealMigrator offers a default script for File. But it is possible to edit the existing script or to write a new script.

![](https://128169741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJtYzSHkivOXU1eIfZOq%2Fuploads%2Fgit-blob-ca4b8ab5418b15288bdd89285f1ca03c500bc581%2FFiles7.PNG?alt=media)

## Reset Button

![](https://128169741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJtYzSHkivOXU1eIfZOq%2Fuploads%2Fgit-blob-5fa00eefa88d55e0b417960f143d5050bca9857b%2Fresetbutton.PNG?alt=media)

If you click the **Reset** button in the **Config** tab or in the **Script** tab, all your entries will be reset to the RealMigrator default values.

To accept the default values, you have to click **Save** at the top of the page.
