Audience

Any user of the Migration App that needs to migrate data from a network share.

This product is currently in Beta. We invite any Customers interested in joining the Beta program to engage Egnyte Professional Services for consideration.

Context

CMM Agent service cannot migrate data from network shares in its default configuration. This is because the CMM Agent service logs on initially as the Local System account.

Screen_Shot_2021-03-31_at_7.29.03_PM.png

By design, the Local System account has access only to local drives and cannot access any network shares. Therefore, when logged on as a Local System account, any attempt by Migration App to create a migration job that refers to a UNC path or a mapped drive as a source fails with an error. 

Network shares are accessible to privileged local users only. To access a network share, the CMM Agent service needs to be reconfigured to log on as a designated user account with access to a given resource.

Invoke the whoami and dir commands in Windows PowerShell to confirm access. If you need assistance with that, view Using whoami and dir Commands to Confirm Access to Network Share Resources.

We recommend operating the CMM Agent Service under the local user account from the very beginning if any of the network shares may be used in the future for data migration.

Once you have changed the Logon to Local User, any previously created migration jobs will no longer be operational.

Changing the CMM Agent Logon from Local System to Local User with Network Share Access

  1. First, you need to stop the CMM Agent service. Go to the system tray for Cloud Migration Manager Agent

    Screen_Shot_2021-03-31_at_7.33.53_PM.png

    Select the meatball menu on the upper right corner (the triple dots) and select Stop service.

    stop-service.png

    Then click Stop to confirm you wish to stop the service.

    confirm.png

    Now you can see the Agent is no longer connected to the cloud.

    Screen_Shot_2021-03-31_at_7.36.06_PM.png

  2. Return to Windows Explorer, type Services in the search field, and open the application.

    services.png

  3. Look for a service called CMM-Agent Service from the alphabetical listing. Note that it indicates it has logged on as the Local System.

    Screen_Shot_2021-03-31_at_7.38.44_PM.png

    Right-click on that item to display the context menu and select Properties.

    cmm-props.png

  4. From the Properties dialog, select the Log On tab. Then select the radio button for This account. Enter the machine name and local user, and then provide the password. Then click Apply. If you don’t know the machine name and local user, this article will walk you through the steps of using the PowerShell to determine them.

    Screen_Shot_2021-03-31_at_7.41.49_PM.png

    A pop-up window will appear. Click OK.

    Screen_Shot_2021-03-31_at_7.43.39_PM.png

    Then click OK to close out of the Properties window.

  5. Now return to the System Tray for Cloud Migration Manager Agent, go to the meatball menu, and select Start service. This should only take a few moments.

    Screen_Shot_2021-03-31_at_7.45.08_PM.png

    Once the service has successfully started, it will indicate that it is Connected to cloud.

    connected.png

  6. Now return to the Services window and look for the CMM-Agent Service. You can see that it is no longer running as the Local System but is logged on as the user account with access to the network share. So you are ready to create a new Migration Job.

    Screen_Shot_2021-03-31_at_7.47.02_PM.png

  7. Go to the Egnyte Migration Dashboard. Click on Create New Migration.
    Screen_Shot_2021-03-31_at_7.53.33_PM.png

    In the resulting dialog window,
    • Specify a Migration Name of your choice.
    • Select a Source from the list of available Sources.
    • For Source Folder Path, enter \\server\matt\client files.
    • For Destination Folder Path, enter /Shared/Client Files or whatever you want the folder to be named on the destination.
    • Click Create Migration.

    Screen_Shot_2021-03-31_at_7.59.59_PM.png

  8. The Migration Job interface will now display. Wait just a few moments until Migration Status changes from Initialized to Created. You may now initiate the Migration Job by clicking Scan.

    Screen_Shot_2021-03-31_at_8.01.37_PM.png