How to fix Event ID 455 ESENT error on Windows 10

ESENT is a built-in database search engine on your PC which helps File Explorer, Windows Search to search for parameters throughout your Windows 10 computer. If you’re encountering the Event ID 455 ESENT error on your Windows 10 device, then this post is intended to help you. In this post, we will provide the potential solutions you can try to mitigate this issue.

When this error occurs, you’ll see in the event log the following error description;

svchost (15692,R,98) TILEREPOSITORYS-1-5-18: Error -1023 (0xfffffc01) occurred while opening logfile

C:WINDOWSsystem32configsystemprofileAppDataLocalTileDataLayerDatabaseEDB.log.

Fix Event ID 455 ESENT error

If you’re faced with this Event ID 455 ESENT error on your Windows 10 PC, you can try either of our two recommended solutions presented below to resolve the issue.

  1. Create Database folder in TileDataLayer folder via File Explorer
  2. Create Database folder in TileDataLayer folder via Command Prompt

Let’s take a look at the description of the process involved concerning either of the listed solutions.

1] Create a Database folder in TileDataLayer folder via File Explorer

To create a Database folder in TileDataLayer folder via File Explorer, do the following:

  • Press Windows key + R to invoke the Run dialog.
  • In the Run dialog, copy and paste the directory path (assuming the C drive is housing your Windows 10 installation) below and hit Enter.
C:Windowssystem32configsystemprofileAppDataLocal
  • Now, right-click on the open space and then click New >Folder to create a folder in that location.
  • Next, rename the new folder as TileDataLayer.
  • Now, double-click the newly created TileDataLayer folder on it to explore it.
  • Again right-click on the space within the open folder and then click New >Folder to create a new folder.
  • Rename the new folder as Database.
  • Exit File Explorer
  • Reboot your computer.

After rebooting the Event ID 455 ESENT error should be fixed.

Alternatively, to achieve the same result using File Explorer, you can use the CMD Prompt. Continue below to see how.

2] Create a Database folder in TileDataLayer folder via Command Prompt

To create a Database folder in TileDataLayer folder via Command Prompt, do the following:

  • Press Windows key + R to invoke the Run dialog.
  • In the Run dialog box, type cmd and then press CTRL + SHIFT + ENTER to open Command Prompt in admin/elevated mode.
  • In the command prompt window, copy and paste the syntax below one by one and hit Enter after each line to execute them sequentially on your computer.
cd configsystemprofileAppDataLocalmkdir TileDataLayercd TileDataLayermkdir Database
  • Once the task completes, exit the CMD prompt.
  • Reboot your computer.

After rebooting the Event ID 455 ESENT error should be fixed.

ESENT

ESENT is an embeddable, transactional database engine. It first shipped with Microsoft Windows 2000 and has been available for developers to use since then. You can use ESENT for applications that need reliable, high-performance, low-overhead storage of structured or semi-structured data. The ESENT engine can help with data needs ranging from something as simple as a hash table that is too large to store in memory to something more complex such as an application with tables, columns, and indexes.

Active Directory, Windows Desktop Search, Windows Mail, Live Mesh, and Windows Update, currently rely on ESENT for data storage. And Microsoft Exchange stores all of its mailbox data (a large server typically has dozens of terabytes of data) using a slightly modified version of the ESENT code.

Features

Significant technical features of ESENT include:

  • ACID transactions with savepoints, lazy commits, and robust crash recovery.
  • Snapshot isolation.
  • Record-level locking (multi-versioning provides non-blocking reads).
  • Highly concurrent database access.
  • Flexible meta-data (tens of thousands of columns, tables, and indexes are possible).
  • Indexing support for integer, floating-point, ASCII, Unicode, and binary columns.
  • Sophisticated index types, including conditional, tuple, and multi-valued.
  • Columns that can be up to 2GB with a maximum database size of 16TB.

Benefits

  • No additional download needed. ManagedEsent uses the native esent.dll that already comes as part of every version of Microsoft Windows.
  • No administration required. ESENT automatically manages log files, database recovery, and even the database cache size.

Note: The ESENT database file cannot be shared between multiple processes simultaneously. ESENT works best for applications with simple, predefined queries; if you have an application with complex, ad-hoc queries, a storage solution that provides a query layer will work better for you.

Related:

How to Display Files and Folders in Grid View – Citrix Files Web App

Files and Folders can be displayed in either a grid or list view.

List view has the folder names with columns displaying different properties of the item and clicking a column will switch between sorting in ascending or descending order.

Grid View has large icons with the name and upload date arranged in a grid. It can be sorted with a drop down menu.

Related:

Citrix Files for Windows Error Drive 'Location is Not Available'

Problem

After installing Citrix Files for Windows, the userreceives the following Drive error: Location is Not Available.

The application logs show that the drive mounts successfully however the S: Drive is not located in the File Explorer as intended.

Related:

ShareFile distribution group

Use Distribution Groups to consolidate users into functional groups for more efficient account management. This feature is useful for managing large groups of users with similar folder access needs.

Requirements

Managing Distribution Groups requires the create shared distribution groups and edit shared distribution groups permissions

Distribution Groups and User Permissions

  • Members added to the Distribution Group will inherit the folder access permissions of the group.
  • Members removed from the Distribution Group will lose the folder access permissions given to that group.
  • Permissions given on a folder to a distribution group will apply to every member. This includes notifications about downloads and uploads.


Create a Distribution Group

  1. People > Manage Users or Distribution Group
  2. On the Distribution page click on the Create Group button.
  3. The next page will allow you to name the group and give you the option to share the group with employees in your account.
  4. Click the Create Group button.
  5. Check the box beside Share this distribution group with all employees if you want users with the edit shared distribution group permission to be able to edit your group.
  6. On the Managing group page, you can add users with one of the following options:
  • Click Add Member to enter a user’s email, name and company manually. Click the checkbox when done entering a single user’s information.
  • Access the Add From drop down menu and choose Add from Personal Address Book or Add from Shared Address Book
  • Access the Add From drop down menu and choose Add from Employee List
  • Access the Add From drop down menu and choose Add from Excel. A template spreadsheet will be provided to you. Please fill in this spreadsheet and follow the instructions provided in the web app.
  • Access the Add From drop down menu and choose Classic Bulk Add. You may enter users via email. Each entry should be on its own line. Entries should NOT be separated by commas. Entering first and last names for each entry is not required. To associate a first and last name with an entry, place the name in parentheses after the email address.

Once you have saved our Distribution Group, you can return to the Distribution Groups menu to modify your group as needed.


Sending or Receiving Files from a Distribution Group

You can select a Distribution Group as the recipient of your message when sharing or requesting files. Distribution Groups can be accessed via the Address Book icon. When receiving an email sent to an entire Distribution Group, your recipient will only see his or her own email address in the recipient field. For security purposes, recipients cannot view other email addresses that may have been sent the file.

User-added image

Adding a Distribution Group to a Folder

A distribution group may be added to a folder in much the same way an individual user would be. Folder permissions can be customized across the distribution group. When receiving notifications sent to an entire Distribution Group, your recipient will only see his or her own email address in the recipient field. For security purposes, recipients cannot view other email addresses that may have received the notification.

User-added image


Distribution Group FAQ

How many users can I add to a Distribution Group?

A distribution group can have a maximum of 2000 users.

I added a user to a folder when they already had access through a Distribution Group. What permissions apply?

The individual user’s access will override that of his/her group. Example: John Doe has Download permissions on a folder due to his membership in the Doe Distribution Group. You add John Doe to the folder manually, and grant him Upload permissions. He will have both Download and Upload permissions, even though his Distribution Group membership does not include Upload.

Generate a Group Membership List

To generate a membership list for your review, access People > Manage Users or Distribution Groups. Click on the group name to access it. Access the Generate Report drop-down menu and choose Export Group List. Once the list is generated, a spreadsheet will be downloaded to your local computer.

Generate a Folder Access report

A Folder Access report shows which folders and permissions the Distribution Group has access to. To generate a folder access report for your review, access People > Manage Users or Distribution Groups. Click on the group name to access it. Access the Generate Report drop-down menu and choose Folder Access. You may print this list for your records.

Related:

ShareFile Data Migration Tool – Data Only

Transfer Type – Data Only

Option used to migrate only data from source to ShareFile.

User-added image

  • Select directory to transfer : Use the browse button to select the source folder that you wish to migrate to ShareFile.
  • Choose destination : Select the upload destination folder within your ShareFile account.
  • Configure transfer options :
    • Schedule Transfer – Allows you to schedule the migration in specific time frame. Enable the option and select the scheduler.
    • Create a root folder to contain the transferred folders -This will create a folder on the root level and migrate all folders from this transfer inside of it
    • Don’t upload files with more recent modified time on ShareFile – Enabling this option would not upload files when most recent file is present in destination folder selected in ShareFile.

Once all option are selected and clicked on Continue button, you will be provided with Pre Migration view

User-added image

Pre-Migration View

1) Migration type – Specifies the type of transfer selected by the Admin

2) Source – Specifies the location from where the data is being migrated

3) Destination – Specifies the location to which the data is being migrated to

4) Total number of files – Count of files being migrated

5) Total Size – Total size being migrated

6) Expected Time – Approx. time that would be taken for the migration

7) File Types Excluded – Displays list of file type
s excluded. “Exclude” link provided to exclude any files from migration. Below view would be presented when clicked on same.

  • User can unselect the file types which needs to be excluded as part of migration.
  • Once un-checked the file types to be excluded , Click on Next Button.

If “Limit Transfer to certain file types” option is enabled – Below screen would be displayed.

User-added image

8) Items Unable to Transfer – Displayed files/folders which are inaccessible and would not be migrated. If there are any files /folders which are inaccessible then link to Review the same would be provided. Below view would be provided clicking on same.

User-added image

Files and Folders would be inaccessible if the user who is currently logged in does not have required permissions or if files are being currently used by other applications. Resolve the permission issue or close any application using the files and proceed with migration.

Note – Files/Folders which are inaccessible would not be migrated. You can still click on Transfer Files to proceed with the migration even when there are inaccessible files/folders.

.

Related:

Can't start a specific application which relies on Explorer.exe

By design, the TS RemoteApp session implements limited functionality. This issue occurs because you try to start an application that relies on the Explorer.exe file.

If wfshell is not loaded, the default.profile is not created correctly. This behavior occurs because when the explorer shell is not loaded with the Run registry entry, the RunOnce registry entry and the startup applications are not loaded. If you start a published application which depends on wfshell, it might fail to load because of dependencies executed in the runonce command.

Related:

ShareConnect Desktop App

As of June 30, 2020, ShareConnect will be End of Life. As of this date, the product and all its functionality will no longer be accessible, with technical support and product downloads also no longer available.

We recommend replacing ShareConnect with GoToMyPC.

Please visit the Citrix Product Matrix for more information on Citrix Product Lifecycles.

In rare cases, the tool may still be temporarily available for some users after June 30th, 2020 as deprecation can take several weeks to complete.


ShareConnect Desktop allows you to access remote computers and file servers simultaneously, without having to logging into a web browser. You can download the Desktop App from within your ShareConnect account.

This app is supported for both Windows and Mac users.

User-added image

Install the Desktop App

Log in to your ShareConnect account. You can download the desktop app from the navigation menu on the left. You are also prompted to download the desktop app when clicking on a computer to establish a remote connection.

User-added image


Follow the instructions to install the app. The desktop app is now installed, and you can launch it from your desktop or your Programs/Apps menus.



Using the Desktop App

Launch the ShareConnect Desktop app and enter your ShareConnect credentials (email and password).

Note: If you have the 2-step verification enabled on your ShareConnect account, you will need to provide a code that is sent to your mobile phone number as an extra security measure.

Select your host computer from the left navigation and enter the host computer’s credentials.

User-added image
User-added image

Remote Screensharing – Access a Remote Desktop Session

Once you have chosen a computer and verified that computer’s credentials, the remote session will be displayed within the desktop window.

User-added image
User-added image

The Toolbar contains the following options:

  • File Transfer – Load a separate window where you can upload and download files between your computer and the host.
  • Full Screen – Maximize the desktop app window to view the host computer screen at a higher resolution.
  • Zoom – Incremental zoom to view specific areas of the host computer screen.
  • Actual Size – Expand the viewer window.
  • CTRL-ALT-DEL – Send a CTRL-ALT-DEL command to the host computer.
  • Switch Monitors – Choose which monitor to display. You may also resize your the Desktop App window to fit the full monitor span.
  • Settings – The Settings icon allows the following settings:
  • Unblank Host Screen – Unblank the host computer’s screen so that it may be physically viewed, i.e., clients.
  • Audio – Choose to hear audio from the host computer.
  • Current Printer – Select the local printer you wish to use when printing files from the host computer.


File Transfer (Windows)

Clicking the File Transfer icon will open the file viewer in a separate window.

Here, you can browse the local file directory of the host computer as well as download, rename, edit and delete certain files and folders. Drag and drop files between folders for quick and easy transfers.

Right-click files to take a specific action, or select the file and use the toolbar located in the middle of the module. When using the Open and Edit option, a file will be modified on your PC and then uploaded back when you have Saved or Closed the program used to edit.

User-added image

Right-click files to take supported actions

User-added image
User-added image

File Transfer (Mac)

The File Transfer menu is slightly different than the File Transfer function for Windows users.

The File Browser will open as a separate window. Here, you can browse through the files and take various actions on them using the toolbar at the bottom of the module. Depending on your Mac and the programs installed there, opening and editing files locally may not be supported.

User-added image


Remote Screensharing and File Server – Simultaneous Remote Sessions

  • Use the menu on the left to open up your Computers list. Select another computer to connect to.
  • Once connected, you can switch between remote sessions by clicking on the appropriate tab at the top of the app window.

User-added image


File Server – View and Download Files on the Desktop App

  • After you connect to your server, you can see a list of folders.
  • To view and edit your files, navigate to a specific file and double-click on it. Choose the option to Open and Edit and save the file on your host.
  • To download your files, navigate to a folder of your choice or create a new folder by selecting the Make New Folder button and click OK.

File Server – Upload Files via the Desktop App

  • To upload a file, you must navigate to the folder of your choice and click on the Upload button at the bottom of your Viewer window.
  • You can browse within your local computer to locate the file you want and double-click on it to upload it.

Remote Printing

To print documents remotely, set your Current Printer in the Settings menu.

Once a printer has been set, any documents printed from the host computer will print to the chosen printer.

User-added image


ShareConnect for IT Admins

Client users can submit Help Tickets from their host computer. Submitted tickets can be reviewed by Admin users from the ShareConnect Desktop app, and remote troubleshooting sessions can be established with the click of a button. Click here for information on how to use this feature.



Settings and Preferences

Click the Settings icon in the upper left to adjust various preferences. The settings available to you are inherited from your account-wide settings.

User-added image
User-added image

Related:

  • No Related Posts

Unable to create Hosting connection when proxy is enabled on the DDC or cloud Connector hosted on Azure

You can remove the Proxy from the DDC and allow temporary internet access , once the Hosting is created , you can edit the Hosting Connection and add the IP:Port to the Hosting connection .

or

On the DDC or Cloud Connector

  1. Open File Explorer and navigate to C:Program FilesCommon FilesCitrixHCLPluginsCitrixMachineCreationv1.0.0.0AzureRmPlugin
  2. Open the file Citrix.AzureRmPlugin.dll.config in your favorite text editor
  3. Inside the <configuration></configuration> element, add the element defined below and save the file. ( IP and port that customer’s proxy has )
  4. Restart all services for citrix on the DDC .

<system.net>

<defaultProxy enabled=”true” useDefaultCredentials=”true”>

<proxy proxyaddress=”http://127.0.0.1:8888” usesystemdefault=”false” />

</defaultProxy>

</system.net>


please replace :http://127.0.0.1:8888 with your Proxy server and port Information .

Once the Hosting is created , you can add the details under Hosting Unit àConnections.

Related:

ShareFile Data Migration Tool Reference

Objective :

The ShareFile Data Migration Tool allows users to migrate a large amount of data along with folder ownership and permission to ShareFile from a Network Share or local file system.

OS Supported :

Win 7 , Win 8, Win 8.1, Win 10, Win 2008 Server, Win 2012 Server, Win 2016 Server

System Requirements :

.NET Framework 4.6.2 or later

Limitations

  • This feature cannot be used by Client users.
  • This application adheres to Microsoft File Path limits. Files that exceed the path limitation will not be migrated.
  • In the unlikely event that a file transfer causes too much traffic on the ShareFile infrastructure, ShareFile may pause the transfer. The transfer will resume automatically.
  • Files that are currently in use by another program will not be migrated.
  • This tool does not support migrating more than 50,000 folders.
  • This tool has not been tested on virtual machines, and cannot be fully supported in such an environment.
  • Recommended Internet Speeds for Citrix Files Migration Tool 15 MBPS and up.

Best Practices

  • Because files in use are not uploaded during the migration, ShareFile recommends using the Migration Tool during off hours in order to minimize interference with your users.
  • For optimum performance, ShareFile recommends using the Migration Tool outside of US EST business hours.
  • Avoid wireless connections when possible.
  • The tool has been successfully tested for up to 3TB of data. If you have additional data to migrate, we suggest you break it up to be at or below 3TBs.

Multiple Transfer Options:

Data Only

Data and Permissions Mapped to Personal Folders

Data and Permissions Mapped to Shared Folders


Other links within this article:

Permissions Mapping

Manage Transfer

Uninstall

Migration Logs

Limitations

Max Transfers Handled


Installation

Click here to download the SFMT installation file.

Once downloaded, run the installation file to begin setup. If you do not have .NET Framework 4.6.2 or later installed on your machine, it will be installed for you. Once installed, a shortcut will be added to your desktop. You may also launch the app from the Start menu. For best results, ShareFile recommends installing the migration tool on the server or computer where your data currently resides.

Note: By default, this app installs to C:Program FilesCitrixShareFile

If you want to change the install location , click on “Options” button and specify the location.


AutoUpdate

When you launch the migration tool, it will automatically check for updates and prompt you to install when one is available. ShareFile recommends updating to the latest version.

User-added image

Sign In to the Migration Tool

When launching the Migration Tool, you will be prompted to sign into your ShareFile account. Sign in to the account where you wish to upload files.

Auto Login Support – Once SignedIn the account details are encrypted and stored in app_settings.cfg file. This is done in order to avoid requesting of “Sign In” when app is launched next times. Admin can any time SignOut or delete this file to login using new sf account details. “app_settings.cfg” file is present in “USERNAMEAppDataRoamingCitrixShareFileMigration Tool”

Note : There are also unique files created containing migration details for each unique users signed in. These files are present in “USERNAMEAppDataRoamingCitrixShareFileMigration Tool”

Eg. Logged in using account “admin1@sharefile.com” and initiated migration and scheduled transfers. Now logged out and signed in using account “admin2@sharefile.com” and initiated migration. We would maintain two unique files containing the migration details. So if the user logs in back using the same account , the details are maintained. And these files are encrypted. No one can view the details.

Once Logged in , Admin would be provided with “Home Screen”

From the Home view, you can begin a new transfer, view your migration queue, and manage your scheduled migrations and provide feedback.

Users are also provided links to view

  1. Privacy Policy
  2. End User Agreement
  3. Term of Use
  4. Support Page


User would also be able to Send feedback or report problem using “Send Feedback” and “Report Issue” link.


Migration Menu

User-added image

New Transfer – Initiate a new transfer

Manage Transfer – View transfer details ( In progress / Waiting / Completed / Cancelled )

Manage Schedules – View the schedulers created for migration

New Transfer

Admin would be able to initiate transfer using this option.

Transfer Selection View :

Note: Login using SF Admin account to transfer data along with ownership and permission.

If login using SF non Admin account, only data can be migrated not the ownership / permission

User-added image

Transfer Type – ( Data Only )

Option used to migrate only data from source to ShareFile.

User-added image

  • Select directory to transfer : Use the browse button to select the source folder that you wish to migrate to ShareFile.
  • Choose destination : Select the upload destination folder within your ShareFile account.
  • Configure transfer options :
    • Schedule Transfer – Allows you to schedule the migration in specific time frame. Enable the option and select the scheduler.
    • Create a root folder to contain the transferred folders -This will create a folder on the root level and migrate all folders from this transfer inside of it
    • Don’t upload files with more recent modified time on ShareFile – Enabling this option would not upload files when most recent file is present in destination folder selected in ShareFile.

Once all option are selected and clicked on Continue button, you will be provided with Pre Migration view

User-added image

Pre-Migration View

1) Migration type – Specifies the type of transfer selected by the Admin

2) Source – Specifies the location from where the data is being migrated

3) Destination – Specifies the location to which the data is being migrated to

4) Total number of files – Count of files being migrated

5) Total Size – Total size being migrated

6) Expected Time – Approx. time that would be taken for the migration

7) File Types Excluded – Displays list of file type
s excluded. “Exclude” link provided to exclude any files from migration. Below view would be presented when clicked on same.

  • User can unselect the file types which needs to be excluded as part of migration.
  • Once un-checked the file types to be excluded , Click on Next Button.

If “Limit Transfer to certain file types” option is enabled – Below screen would be displayed.

User-added image

8) Items Unable to Transfer – Displayed files/folders which are inaccessible and would not be migrated. If there are any files /folders which are inaccessible then link to Review the same would be provided. Below view would be provided clicking on same.

User-added image

Files and Folders would be inaccessible if the user who is currently logged in does not have required permissions or if files are being currently used by other applications. Resolve the permission issue or close any application using the files and proceed with migration.

Note – Files/Folders which are inaccessible would not be migrated. You can still click on Transfer Files to proceed with the migration even when there are inaccessible files/folders.

.

User-added image

  1. Select a directory to transfer: Use the browse button to select the source folder that you wish to migrate to ShareFile
  2. Configure folder permission options:
    • Folder ownership only – Migrates only the folder ownership. Files and Folder would be migrated to the user’s Personal Folder who own the folders being migrated
    • Folder ownership and access permissions – Migrates folder ownership along with the permissions. Files and Folder would be migrated to the user’s Personal Folder who owns the folders being migrated. Users that have permission to this folder would see the folder in Shared Folders.
    • Create folders for users who haven’t logged in yet – If there are users whose account is created in ShareFile, but they have not logged in yet to create their Personal Folder, data cannot be migrated without this setting. Enabling this option will activate the account and migrate the data. Once the migration is complete, a password reset email will be sent to the user.
  3. Configure transfer options:
    • Schedule transfer – Allows you to schedule the migration in a specific time frame.
    • Create root folder for migration content named- Allows you to select the folder to which data+permission needs to be migrated. Unchecking the option would migrate the data to root of Personal Folders.
    • Don’t upload files with more recent modified time on ShareFile – Enabling this option would not upload files when most recent file is present in destination folder selected in ShareFile.

After all the configurations are done, click on Continue button.

User would be prompted with Connect to Active Directory

User-added image

User who has launched this application – If the current user logged in on the machine running the tool is domain user, then tool would automatically take those credentials to connect to that domain AD

Any other user – If user wants to connect to some other domain.

Note: It is recommended to run the tool on a machine which is connected to the domain from which the user’s details are being fetched for ownership and permissions migration.

Once all option are selected and clicked on Continue button, you will be provided with Pre Migration view

User-added image
  1. Migration type – Specifies the type of transfer selected by the Admin
  2. Source – Specifies the location from where the data is being migrated
  3. Total number of files – Count of files being migrated
  4. Total Size – Total size being migrated
  5. Expected Time – Approx. time that would be taken for the migration
  6. File Types Excluded – Displays list of file types excluded. “Exclude” link provided to exclude any files from migration.
  7. Items Unable to Transfer – Displayed files/folders which are inaccessible and would not be migrated. If there are any files /folders which are inaccessible then link to Review the same would be provided.



Review missing accounts and groups – If there are any accounts or groups not present in ShareFile , then user would be provided with “review missing accounts and groups” link. Clicking on same would provide view to provide alternate account or group details.

User-added image

If there are no accounts present in SF, file/folders would not be migrated. In order to avoid this, the Admin can edit the fields and proceed with migration.

Note: Group permissions would be done only if groups in SF are created using UMT. If groups are manually created in ShareFile, then permissions would not be migrated.

Permission migration files would be present in “USERNAMEAppDataRoamingCitrixShareFileMigration ToolPermission Data” folder.

If there are no conflicts then user would be provided with below view.

User-added image


Click on Transfer Files to start the Migration.

Transfer Type – (Data + Permissions – Mapped to Shared Folders):

  1. Select a directory to transfer: Use the browse button to select the source folder that you wish to migrate to ShareFile
  2. Configure folder permission options:
    • Folder ownership only – Migrates only the folder ownership. Files and Folder would be migrated to the admin’s Shared Folder and would be shared with the users who own a specific file/folder.
    • Folder ownership and access permissions – Migrates folder ownership along with the permissions. Files and Folder would be migrated to the admin’s Shared Folder and will be shared with the users who own specific files/folders and with users who have certain permissions on the folder.
  3. Configure transfer options:
    • Schedule transfer – Allows you to schedule the migration in a specific time frame.
    • Don’t upload files with more recent modified time on ShareFile – Enabling this option would not upload files when most recent file is present in destination folder selected in ShareFile.

After all the configurations are done, click on Continue button.

User would be prompted with Connect to Active Directory

User-added image

User who has launched this application – If the current user logged in on the machine running the tool is domain user, then tool would automatically take those credentials to connect to that domain AD

Any other user – If user wants to connect to some other domain.

Note: It is recommended to run the tool on a machine which is connected to the domain from which the user’s details are being fetched for ownership and permissions migration.

Once all option are selected and clicked on Continue button, you will be provided with Pre Migration view

  1. Migration type – Specifies the type of transfer selected by the Admin
  2. Source – Specifies the location from where the data is being migrated
  3. Total number of files – Count of files being migrated
  4. Total Size – Total size being migrated
  5. Expected Time – Approx. time that would be taken for the migration
  6. File Types Excluded – Displays list of file types excluded. “Exclude” link provided to exclude any files from migration.
  7. Items Unable to Transfer – Displayed files/folders which are inaccessible and would not be migrated. If there are any files /folders which are inaccessible then link to Review the same would be provided.

Permissions Mapping:

NTFS Permissions ShareFile Permissions
Download Upload Delete Admin
Full Control Yes Yes Yes Yes
Modify Yes Yes Yes No
Read and Execute Yes No No No
List folder contents Yes No No No
Read Yes No No No
Write Yes Yes No No
Special Permission
Traverse folder/ Execute Files Yes No No No
List folder / Read data Yes No No No
Read Attributes Yes No No No
Read extended attributes Yes No No No
Create files / Write data Yes Yes No No
Create folders / Append data Yes Yes No No
Write Attributes Yes No No No
Write extended attributes Yes No No No
Delete Subfolders and files Yes No Yes No
Delete Yes No Yes No
Read permissions Yes No No No
Change permissions Yes Yes Yes Yes
Take Ownership Yes Yes Yes Yes


Manage Transfer:

Admin would be able to view transfer details (Transfer which are “In Progress”,”Completed”, “Pending” and “Cancelled”)

User-added image

Transfer Status:

  1. Running: When clicked on “View” link across the job, below screen would be displayed.

User-added image


Admin would be provided with transfer progress view. Admin can pause or cancel the transfer from this view.

  1. Pending – when clicked on “View” link across the job, below screen would be displayed.

User-added image

Admin would be provided with transfer details. If the transfer is scheduled, then scheduler details will also be displayed.

Admin can Cancel the transfer as well.

  1. Cancelled – When clicked on “View” link across the job, below screen would be displayed

User-added image

Admin would be provided with “Post Migration” View.

Admin would be provided with transfer details which includes – Migration type, Source , Destination , Total no. of files transferred, Successful Uploads, Link to open log file which contains successfully uploaded file list, Failed uploads , Link to open log file which contains failed uploads and reason for the same, Cancelled Uploads, Link to open log file which contains cancelled file list, Total transfer size and Total time taken.

  1. Completed – When clicked on “View” link across the job, below screen would be displayed.
User-added image

Admin would be provided with “Post Migration” View.

Admin would be provided with transfer details which includes – Migration type, Source , Destination , Total no. of files transferred, Successful Uploads, Link to open log file which contains successfully uploaded file list, Failed uploads , Link to open log file which contains failed uploads and reason for the same, Cancelled Uploads, Link to open log file which contains cancelled file list, Total transfer size and Total time taken.

Manage Schedules:

Schedules allow you to choose when transfers are to be run. Admin can use this option to run migrations at times outside of peak usage hours.

Created schedules will be listed in this menu. Click Create New Schedule to make a new one.

Admin can View, Edit or Delete the schedules created using the options provided.

User-added image

NOTE: Large data migration can be handled in better ways using Scheduler. We can schedule transfers outside of peak hours for max bandwidth and speed.

After the user creates a scheduler, the schedules should reflect correctly in Task Scheduler.

Make sure correct details have been added to task scheduler. When there are multiple slots selected, multiple instances should be added in Task Scheduler. Task Scheduler on that machine triggers the event to start migration tool and any migration scheduled in that time frame gets started.

Note: It is required that task scheduler should be working seamlessly on the machine where the tool is being run. And it is required that the user who scheduled the migration should be logged in. If User is not logged in, migration would not be initiated in that specific time slot.




ShareFile-induced Transfer Pause

In the unlikely event of the transfer causing too much traffic on the ShareFile infrastructure, ShareFile may pause the transfer. The Migration Tool will continuously attempt to resume transfer during this time. A warning message will be presented at the bottom of the transferring screen. The user will be unable to manually un-pause the transfer, but can cancel the transfer if desired.

If the number of retries exceeds 48, please contact ShareFile Support.

If the user receives the warning message: “Your account is currently not available to perform transfers”, the ShareFile-induced pause may still be enabled. The user can either wait for this to be resolved or try again later by closing and relaunching the application.


Uninstall the Migration Tool

To uninstall the tool, uninstall from the Programs and Features menu in Control Panel, or re-run the installation file. Note: Warning: Migration Logs that were created during transfers will be removed during the uninstall process.


Migration Logs:


Once the transfer is complete, you can review the migration details and any errors encountered during the migration process.

Log Files generated:

  1. SFMT [TimeStamp][FolderName].log – This log contains complete details starting from launch of the tool
  2. Transfer Info [TimeStamp][FolderName].log – This log contains verbose information for the transfer
  3. Transfer [TimeStamp][FolderName].log – This log contains all the files and folders that were successfully transferred.
  4. Transfer Failure [TimeStamp][FolderName].log – This log contains a brief explanation as to why a file failed to transfer.
  5. Transfer Cancelled [TimeStamp][FolderName].log – This log contains a brief explanation as to why a transfer cancelled.

NOTE: For debugging the issue “SFMT [TimeStamp][FolderName].log” and “Transfer Info [TimeStamp][FolderName].log” are required.

Logs are stored at USERNAMEAppDataRoamingCitrixShareFileMigration ToolLogs

Important Notes:

  1. Login using SF Admin account in order to migrate folder ownership and permission. If SF personal account is used, only data can be migrated.
  2. For migrating group permission on specific folder, it is required that the Group in SF should be created using UMT (User Management Tool)
  3. For accounts which are created in SF and not activated, data would not be migrated unless “Create folders for users that haven’t logged in yet” option is selected
  4. Data would not be migrated if specific account is not present in SF. Before starting the migration review the access permission file.

If there are any instance where account is not mapped, Admin can manually provide the email details save the changes and proceed with Migration.

Make sure to enter the email details under “Primary Email Address” column in the permission file created.


Limitations:

Maximum Transfers handled:

Below are some statistics on successful migrations completed

Sno Total Size Total Files Time Taken
1 3.21 TB 314085 2d 23h 53m 11s
2 2.89 TB 14708 2d 13h 14m 51s
3 2.09 TB 13282 2d 1h 45m 44s
4 2.09 TB 254592 8d 5h 54m 13s
5 1.92 TB 9225 1d 12h 53m 33s
6 1.73 TB 6900 1d 10h 15m 53s

Related: