Authorizing the File share Connector

Agent FAQ

The Mover file share agent is written using .NET Core, and therefore is available across many platforms.

Click here to select your operating system and download the agent.

Windows

The Windows Agent has two installers, one for the user-context and one for the service-context. The Windows Agent requires Microsoft .NET Framework 4.6.2 or greater.

The differences between Windows installers are as follows:

User-context installer

  • Installs and is run as the currently logged in Windows user.
  • Automatically updates.
  • Has access to local drives.
  • Has access to mapped network drives.
  • Is not available if the user logs out of Windows, or your remote desktop session expires.

Service-context installer

  • Installs and is run as a Windows service.
  • Must be manually updated.
  • Has access only to local drives.
  • Is always available, even if the current user logs out, or your remote desktop session expires.

Command line agents

The following Agents operate using a command line interface versus a user interface.

macOS

  • Navigate to the download location, and unzip the Mover Agent.
  • Via the terminal, browse to the now unzipped moveragent folder, and run ./agent.
  • Copy the key from the line that reads [1] INFO ocess.BifrostService: Bifrost service initialized with connector key: <key>.
  • Open our app, and in the agent authorization box, paste the key.

Note

The minimum system requirements are macOS 10.12.

Linux

  • Navigate to the download location, and unzip the Agent.
  • Via the terminal, browse to the now unzipped moveragent folder and run ./agent.
  • Copy the key from the line that reads [1] INFO ocess.BifrostService: Bifrost service initialized with connector key: <key>.
  • Open our app in your browser, and paste the key into the agent authorization box.

Windows command line installer (beta)

  • Installs and is run as a command line executable.
  • Must be manually updated.
  • Built from the same code base as the Linux and macOS agents.

How does the agent view users?

The Agent works with files and folders. All users who are separated into their own folders can easily be mapped to their new location in Office 365.

A good example would be a large listing of home drives. Each home drive for a user could be transfered to their respective new user in Office 365.

Agent view users

Troubleshooting the agent

Checking the agent version

To check which version of the Server Client you have installed, on the menu bar, select the Help tab.

faq agent

If you are using the Mac or Linux version of our Agent, to find out the version you are using, follow these instructions: Show Agent Version.

Accessing server agent log

To access the Agent Log, navigate to the folder directory that you installed the desktop agent. A .log file appears that you can review, and send to our support team if an error should occur.

Note

The agent .log file default location is Windows\System(32/64)\config\systemprofile\AppData\Local\Mover

agent log

Commands for agent (Mac and Linux only)

Our Agent supports the following commands:

Start the agent

To start the Agent, use:
./agent start.

$ ./agent start
Mover Agent Starting
Mover Agent Key:
0000000000000000000000000000000
Ctrl-C To Stop

Start the agent in the background

To start the Agent in the background, use:
./agent start &.

$ ./agent start &[1] 8667
$ Mover Agent Starting
Mover Agent Key:
00000000000000000000000000000000
Ctrl-C To Stop

Stop the agent

If the Agent is running in the foreground of the terminal, to stop the Agent, press Ctrl-C.

^CMover Agent Stopping

If the Agent is running the background or in another terminal session, use:
./agent Stop.

$ ./agent stop
Connecting to Mover Agent
Sending stop command
Mover Agent Stopping
Mover Agent stopped
[1]+ Done ./agent start

Show agent help

To get a list of commands and options, use:
./agent -h.

$ ./agent -h
Mover Agent 1.0.6968.0
Usage: agent [options] [command]

Options:
-? | -h | --help Show help information
-v | --version Show version information

Commands:

  • connect| Connect to a running instance of the Agent and issue a connect command
  • disconnect| Connect to a running instance of the Agent and issue a disconnect command
  • monitor| Connect to a running instance of the Agent and monitor agent activity
  • start| Start the Agent
  • status| Connect to a running instance of the Agent and retrieve the current status
  • stop| Stop the Agent

For more info about a command, use agent [command] --help.

Show agent version

To show the Agent version, use:
./agent -v

$ ./agent -v
Mover Agent
1.0.6968.0 (Unix 18.6.0.0)

Check agent status

To check the status of the Agent, use:
./agent status

$ ./agent status
Connecting to Mover Agent
Mover Agent Key:
00000000000000000000000000000000
Mover Agent Status: online

Disconnect the agent

To disconnect the Agent, use:
./agent disconnect

$ ./agent disconnect
Connecting to Mover Agent
Sending disconnect command
Mover Agent disconnected.

$ ./agent status
Connecting to Mover Agent
Mover Agent Key:
00000000000000000000000000000000
Mover Agent Status: offline

Connect the agent

To connect the Agent, use:
./agent connect

$ ./agent connect
Connecting to Mover Agent
Sending connect command
Mover Agent connected.

$ ./agent status
Connecting to Mover Agent
Mover Agent Key:
00000000000000000000000000000000
Mover Agent Status: online

Monitor agent activity

To monitor the Agent activity, use:
./agent Monitor. To stop monitoring Agent activity, use: Ctrl-C.

$ ./agent monitor
Connecting to Mover Agent
Mover Agent Key:
00000000000000000000000000000000
Connected to bifrost.mover.io on ports 8081 and 4002.
Ready to transfer!Browse: /
Browse: /Users
Browse: /Users/mover
Browse: /Users/mover/AgentTestData
Browse: /Users/mover/AgentTestData/TestDocuments
Upload: /Users/mover/AgentTestData/TestDocuments/TestTextDocument.txt
Upload: /Users/mover/AgentTestData/TestDocuments/file.txt
Upload: /Users/mover/AgentTestData/TestDocuments/picture.jpg
^C

Authorizing the desktop and server agent

To enable swift and painless copying of data from on-premises desktop and server hard drives, we provide a very tiny agent that any Windows operating system can install.

Compatibility

Windows XP is not supported. All other versions of Windows require the .NET Framework 4.6 for the Agent to function. Download and manually install .NET Framework 4.6 from this link.

Security

The Agent may only initiate outbound communication with our own servers. All communication is via encrypted TLS and no service other than ours is allowed to work with the agent.

Windows installation

For Mac and Linux, the Agent folder appears in your Downloads, and is run through command line operations.

  1. Download the Agent .exe, and select Run.

Download agent

Run agent

  1. Agree to the Terms of Use, and select an install destination.

Agent terms Destination agent

  1. Navigate to the installed destination, and to run the desktop Agent, select the Mover icon.

Open agent

  1. To copy the Agent Key, in the dropdown menu, select File and Copy Key.

Agent key

Authorizing the agent in our app

  1. In the Transfer Wizard, select Authorize New Connector.

Clear auth

  1. In the Connector list, find Agent (Desktop or Server).
  2. Select Authorize.

Agent connector list authentication

  1. A new window opens, and you are prompted to name your Connector .
  2. Enter your required Key that you copied from the installed agent (found via the File > Copy Key action in the Agent).
  3. Select Authorize.

Name connector agent

Additional screenshots

Additional screenshots

Troubleshooting an agent connector

What operating systems are supported by the Mover agent?

The Mover Agent supports many operating systems:

  • Windows Vista
  • Windows 7
  • Windows 8
  • Windows 8.1
  • Windows 10

Removing the Mover agent

You can stop using the Mover Agent.

To stop the Mover Agent from connecting to the Mover's servers, select Disconnect from Mover.

To completely uninstall the Mover Agent, use the Windows program manager.

Connect your source agent for Windows

If you are not already connected after you have authorized your source, select Agent for Windows, and load the connector. An icon appears showing you the folders you are migrating.

Execution select agent source

Connect your destination Office 365 account

If you are not already connected after you have authorized your destination, select Office 365, and load the connector. An icon appears and show you how many users you are migrating.

Execution select Microsoft 365 destination