MyWorkDrive Support

How can we help you today?

Mapped Drive Client Administrator Guide

You are here:
< Back

Overview

The Mapped Drive Client allows easy editing of files from a traditional mapped drive from within applications such as Word, Excel, PowerPoint and Adobe Acrobat remotely from anywhere. Opening and editing design files, databases, QuickBooks, programs and very large files are not supported.* The desktop client can be deployed to enterprises using scripts and started automatically at login.

Requirements

  • MyWorkDrive Server Internet Connection e.g.; https://yourserver.yourdomain.com – or our Cloud Web Connector https://yourserver.myworkdrive.net
  • Antivirus software should set to exclude the folders C:\ProgramData\Wanpath\*.* – log files C:\Users\%username%\AppData\Local\MyWorkDrive\*.* – user configuration data and network drive share letters to prevent file corruption and slowness issues. See Antivirus Settings for MyWorkDrive for additional details.
  • If you are using a direct connection with SSL (recommended), TLS 1.2 and an SSL certificate are required. Self Signed certificates are not supported. You will receive errors which will prevent logins if TLS 1.2 and a commercially issued SSL certificate are not available.
    See Steps to bind and install your own SSL Certificate to the MyWorkDrive client site in IIS for instructions on adding an SSL certificate. Certificate/SSL configuration is not required if you are using the Cloud Web Connector – it is provisioned automatically from our domain for you.

Windows Prerequisites

  • Windows 8.1-10
  • A 64 bit x86 compatible processor. The Map Drive Client does not run on ARM processors using emulation such as the Surface Pro X
  • .net 4.6 (included with Windows 10)

 

macOS Prerequisites

MyWorkDrive 6.0.2 and later Clients

  • macOS 10.13 High Sierra or newer (compatible with 10.15 Catalina and macOS 11 Big Sur with Intel)
  • Server 6.0.1 or higher strongly recommended
  • FUSE for macOS (OSXFuse): Download it here
  • Supported with M1 processor macs in version 6.1.1 and later.

MyWorkDrive 5.2 Legacy Beta client

  • MyWorkDrive Server 5.2 or newer
  • Office File Edit is only supported on files less than 10 MB for Legacy 5.2 Beta client
  • macOS 10.11 El Capitan for Legacy 5.2 Beta client.
  • Strongly not recommended for 10.12 Sierra or higher.
  • Not compatible with 10.14 Mojave or 10.15 Catalina
  • FUSE for macOS (OSXFuse): Download it here

For use with macOS 10.13 High Sierra and newer (Install FUSE for macOS framework (OSXFuse) prior to installing MyWorkDrive macOS client). Compatible with BigSur macOS11 on Intel and Apple M1 processors.
***Please Read Instructions for installing macFuse on M1 processor Macs before installing on new M1 processor Macs ***

 

For use with macOS 10.12 Sierra and newer (Install FUSE for macOS framework (OSXFuse) prior to installing MyWorkDrive macOS client).

 

For use with macOS 10.11 El Capitan, only (Install the appropriate version of FUSE for macOS framework (OSXFuse) prior to installing MyWorkDrive macOS client).

Mapped Drive Features

  • Optimized for MyWorkDrive Servers for blazing fast file transfers and listings without WebDAV
  • Directory list caching
  • Very large directory support – support for file servers with 1000’s of sub-folders
  • Microsoft Office and Open Office/Libre Office File Locking
  • Remote Access Size Limit Enforcement
  • DUO Two Factor Authentication ( Enterprise License Required )
  • Bulk File/Folder Upload (version 5.4.3 and later)

Installation

Windows:

Download and complete setup. If needed setup will install .net 4.5.1 ( Windows 7 PC’s ).

Mac:

Install the latest version of FUSE for macOS framework (OSXFuse) Download zip, extract and complete setup. Launch MyWorkDrive from applications. When you receive the notice about Network Volumes, it is imperative that you click OK. Failure to click Ok to this dialog prompt will result in MyWorkDrive crashing on launch and generating errors on login. If you are installing 5.4.2 or preview versions of MyWorkDrive on Mojave (10.14) or Catalina (10.15), you may receive a warning about Apple being unable to check for malicious software preventing the software from being run. Earlier versions of MyWorkDrive were not Notarized with Apple, and preview builds may also not be notarized. To confirm running the software you must authorize it through Security & Privacy in System Settings. You will only need to complete this process the first time you run this version of MyWorkDrive. If you receive this message. The click on the Apple Menu and choose System Preferences. Click on Security & Privacy In the bottom area with the prompt “Allow apps downloaded from”, adjacent to the note about MyWorkDrive, click the “Open Anyway” button. If the open anyway button does not appear, or MyWorkDrive is not listed there, you may need to click the Unlock button lower left prior to being able to make any changes. A final dialog box will run giving you the option to Open the software, choose Open.

Login:

Begin Login by typing your MyWorkDrive web address, then click connect:


Once you click connect your server settings will be retrieved and you may then login using username/password or SAML depending on your server settings.

Optional: Click “Remember Me” to save your username and password and “Map at Startup” to map your MyWorkDrive on system restart.

Windows Logoff: Locate the MWD icon in the system tray, right mouse click and choose log off.

IT Administrator Settings and Windows Scripted Install Notes

The mapped drive option may be disabled in the admin panel to prevent usage (forcing users to use only the web file manager only for example).
Additional Admin panel settings include preventing password saving and blocking or allowing only certain file types. If file types are blocked in the Windows Mapped Drive client users will get a warning message if they attempt to access, upload or download blocked file extensions. On the Mac Mapped Drive client blocked file types will not be shown.

When using the Allow list option to allow only certain file type (for example office) it is required to permit .tmp files as these are needed during the Office file creation and locking processes.

Mapper Client Installation Scripting Options

-y turns on silent extraction (This item must be 1st command line option specified)

-q turns on silent installation of MWD mapper client (This must be 2nd command line option specified)

-s specify the server URL e.g. https://share.yourcompany.com and attempt to retrieve company logo (requires -y and -q to be specified)

-d Drive letter to be used (not used if drive letters are set on the server)

-r remember me option selected

-m map at startup selected

-p do not clear “show frequently used files and folders” option in file explorer quick access

-u username (Pre-enter currently logged on user’s name on first launch. Requires -r to be specified)

-u %variable% – populate username field with any built in or custom windows variable (Requires -r to be specified)

-w explorer window is not opened on login (default is for the window to be displayed). Feature introduced in 6.1.1 map drive client.

-a Optionally Redirect office file editing to Office Online (Replaces file association on local machine (not typical)). For use when Local Office is not installed, but you want to be able to double click on an office file in Windows explorer and edit it. Opens a web browser and edits in Office Online (requires office online editing to be enabled on the server and the file to be placed on a MyWorkDrive shared drive/folder)

 

Example 1: Silent install: MyWorkDrive-Client-Windows-5-1-0-.exe -y -q

Example 2: Silent Install with all options chosen and pre-entered for user except password: MyWorkDrive-Client-Windows-5-1-0-.exe -y -q -s https://yourserver.yourdomain.com -u username -d T -r -m

 

Mapper Client Command Line Launch Options

-s <yourMWDServerURL> populates the company server URL and if available downloads companies custom logo

-u %variable% – populate username field with any built in or custom windows variable for example

-u %username% for the current users username

-d Drive letter to be used (not used if drive letters are set on the server) -q Silently map the drive (when used in combination with -u current or -r)

-p Do not clear “show frequently used files and folders” option in file explorer quick access

-r Use saved settings for login (-u not required)

-x silently un-map and close the mapped drive client application

-l enable detail logging

 

Example – Specify the server address and drive letter “T” only – the user would only need to enter their username and password:

“C:\Program Files (x86)\Wanpath\MyWorkDrive-Client-Windows\MyWorkDrive.Client.Windows.Desktop\MappedDrive.Client.Windows.Desktop.exe” -s https://yourserver.yourdomain.com -d T

Example – populates all fields for user to login with current username. User only needs to enter their password.

“C:\Program Files (x86)\Wanpath\MyWorkDrive-Client-Windows\MyWorkDrive.Client.Windows.Desktop\MappedDrive.Client.Windows.Desktop.exe” -s https://yourserver.yourdomain.com -u %username% -d T

Example – batch file that checks if existing drive T is already mapped and if not proceeds with loading the mapped drive client as drive T with server address and inputs current user’s login name:

IF EXIST T:\ GOTO no
ELSE GOTO yes

:yes cd “C:\Program Files (x86)\Wanpath\MyWorkDrive-Client-Windows\MyWorkDrive.Client.Windows.Desktop”
start MappedDrive.Client.Windows.Desktop.exe -s https://yourserver.yourdomain.com -d T -u %username% -q
exit

:no exit

Scripting Upgrades

Customers may wish to query the Windows Mapped Drive version number in use to script an upgrade by auditing the details of MappedDrive.Client.Windows.Desktop.exe located in C:\Program Files (x86)\Wanpath\MyWorkDrive-Client-Windows\MyWorkDrive.Client.Windows.Desktop.

As an alternative, Starting with version 5.4.2.27, the version number can be obtained from HKLM/Software/WOW6432NODE/WanPath/MyWorkDriveClient/ProductVersion if the OS is 64bit, or HKLM/Software/WanPath/MyWorkDriveClient/ProductVersion for 32 bit.

Mapped Drive Client version numbers in use may also be viewed in the Server Admin panel by searching for Login on the logs tab.

An example upgrade script after filtering by client version might look like:

  1. Copy exe to local PC
  2. Add silent setup to HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\RunOnce
  3. Prompt user to restart

MSI Installer

MyWorkDrive Mapped Drive Client includes an MSI as of version 5.4 Preview. The MSI is not required to be used, it is optionally included for administrators who wish to use it to push out client installs on their network or via MDM.

Extracting the MSI

The MSI is included in the downloadable installer. You’ll extract the MSI in a command window.

Run CMD as Administrator
Browse to the folder containing your download
To unpack the MSI file only please use switches: -y -q -e {Folder_Path}
for example:
MyWorkDrive-Windows-Client-Setup.exe -y -q -e c:\installer The folder you specify must exist to extract the msi.

Note that the extracted MSI will be significantly smaller than the EXE. This is normal, as it does not include the prerequisite applications included in the EXE installer. Please be sure that any clients where the map drive client is installed have C++ runtime libraries and .NET framework 4.5.1 installed prior to installing MyWorkDrive map drive client. Windows 7 and 8 with the latest Service Pack and Windows 10 have the required minimum versions of C++ runtime libraries and .NET installed by default.

Installing the MSI

Run CMD prompt as Administrator

INSTALL: msiexec /i MyWorkDrive-Windows-Client-Setup.msi /qn

UNINSTALL: msiexec /x MyWorkDrive-Windows-Client-Setup.msi /qn

/q quiet extraction
/n no UI
typically used together /qn

You may also specify the following command line switches to customize your environment, similiar to installing the .EXE.

SERVER_NAME=”https://myworkdriveurl.tld”
USERNAME=”specify_username”
DRIVE_LETTER=”T:” (Not used when using multiple map drive setting on server.)
MAP_AT_STARTUP=”True” (Default is false, no need to specify unless changing from previous default.)
REMEMBER_ME=”True” (Default is false, no need to specify unless changing from previous default. Overridden if not permitted on server.) OPEN_OFFICE_FILES=”True” (Remaps office file extensions to office 365 as default apps; this is not common.)
RECENT_FILES=”True” (Default is false. Clears “show frequently used files and folders” option in file explorer quick access.)
WINDOW=”False” (Windows explorer window is not opened on login. Default is true, window is opened.) Feature introduced in 6.1.1 map drive client
OPEN_OFFICE_FILES=”True” Default is false, use local resources. Optionally Redirect office file editing to Office Online (Replaces file association on local machine (not typical)). For use when Local Office is not installed, but you want to be able to double click on an office file in Windows explorer and edit it. Opens a web browser and edits in Office Online (requires office online editing to be enabled on the server and the file to be placed on a MyWorkDrive shared drive/folder)

Usage Example: msiexec /i MyWorkDrive-Windows-Client-Setup.msi SERVER_NAME=”https://share.myworkdrive.com” DRIVE_LETTER=”T:” REMEBER_ME=”TRUE”

There is one caveat when working with the MSI and pushing a scripted update, which is you need to manually call the existing uninstaller on the client to remove the current version before installing the new one.

This limitation only exists with the MSI. The exe, if you can use that, is able to install over the top of existing applications to do upgrades or make settings changes.

for the MSI –

First Uninstall

msiexec /x {620FCF2A-3446-42BE-9DE6-DAAD56056289} SHOW_REMOVE_ALL_FILES_OPTION=”No” /qn

That calls the built in windows installer and removes any existing MyWorkDrive clients installed, preserving the user’s settings.

Then run the new (updated) installer.

msiexec /i MyWorkDrive-Windows-Client-Setup.msi SERVER_NAME=”https://yourserver.yourdomain.tld” REMEMBER_ME=”True” MAP_AT_STARTUP=”TRUE”

After you’ve run the installer, you can launch the client from the desktop or start menu icon and verify the install.

RDS Environments

If you are installing MyWorkDrive on an RDS server where multiple users will be connecting to the same server and running MyWorkDrive in different logon sessions, you MUST configure your installation for RDS support. It is possible to configure RDS Mode from the server (so all clients are in RDS mode) or on the client (so only the RDS server is in RDS mode). This requires MyWorkdrive server 5.4.2.92 OR Map Drive client 5.4.2.32 or higher. MyWorkDrive Map drive client will crash if used by multiple user sessions on the same computer without RDS mode enabled. Please contact support for assistance enabling RDS mode.

IT Administrator Mac settings deployment

The Mac Mapped Drive client supports placing a config.xml file in the user’s documents folder to specify default settings on first launch. Once the user saves their settings it is no longer used.

The config.xml file should be creating using the following format:

<?xml version=”1.0″ encoding=”UTF-8″?>

-<loginConfig>
<url>https://yourserver.yourdomain.com</url>
<rememberMe>1</rememberMe>
<mapAtStartup>1</mapAtStartup>
<username>john</username>
</loginConfig>

URL = your company MyWorkDrive Web Address
rememberMe = 0 for disable, 1 for enable
mapAtStartup = 0 for disable, 1 for enable
username = User’s Active Directory domain user login username.

Single Sign-On

The -u current option provides the ability to map the drive using the currently logged on users credentials for domain joined PC on an internal network. The user’s PC must be able to connect to a domain controller to authenticate the user. The mapped drive client supports SSO SAML providers as well – e.g. Azure AD/Office 365.

  • The command line option -u current option will not function when MyWorkDrive is installed on a Windows Domain Controller (this is due to how Windows handles impersonation and authentication).
  • To use the command line option “-u current” when shares are not located directly on the MyWorkDrive (MWD) server, delegation must be setup in Active directory on the MyWorkDrive server: See our delegation article here.
  • The command line option -u current should only be used internally since it requires connectivity to a domain controller to authenticate users.

Troubleshooting

Most issues can be resolved by ensuring that the user has the proper permission to their C:\Users\%username%\AppData\Local\MyWorkDrive\*.* folders and Antivirus Exclusions are in place. If the Mapped Drive will not launch due to a corrupt user profile, delete any files/folders under the C:\Users\%username%\AppData\Local\MyWorkDrive\*.* and re-launch the mapped drive client.

*Known Issues & Pending Enhancements

  • Adobe, AutoCad graphics design type products – InDesign, Creative Suite, and other large file types for direct edit are not supported when using our mapped drive client or any network drives – See Adobe Article.
  • Adobe Acrobat Reader may be unable to open more than one file at a time. This is a known issue with Adobe Reader and Network Drives and not specific to MyWorkDrive map drive clients. See discussion on Adobe, Eight Forums, Spiceworks, Reddit. We recommend updating to the latest Map Drive Client as re-installing the Map Drive Client or Adobe Reader may resolve the issue.
  • Opening file types such as Databases, PST’s, Quickbooks, Accounting systems, etc are not supported over the mapped drive client. These types of files typically run over SMB only, require a fast Local Area Network (LAN) connection and are not supported by software vendors over slower remote network connections.
  • MyWorkDrive does not support Alternative Data Streams (ADS) and they are removed when files are copied or accessed through MyWorkDrive. Users may receive a warning message about them when they are accessed. This is normal and will not impact users using or accessing the files.
  • Like any remote access solution, when remotely editing files through the mapped drive use caution and ensure there is adequate bandwidth. System administrators can limit file size on the admin panel.
  • Shortcut in File Explorer menu is optional under settings as on slow networks Windows PC’s attempt to display contents of mapped drive directories any time explorer is launched.
  • Show recently used files and folders in Quick Access is disabled to prevent Windows File Explorer from attempting to access mapped drive locations on initial load. This can be disabled in settings.
  • Opening OneNote Files using the MWD mapped drive client is not supported. Some customers have had success by disabling automatic syncing in OneNote prior to opening any files – Any OneNote files opened over a MWD mapped drive will be recognized a being opened from a network drive and will attempt to sync using SMB creating a corrupt file error message.
  • When using the Mac Mapped Drive client, if you get drive mounting errors even after restarting, check the System Preferences->Security & Privacy on your Mac. Ensure that OSX Fuse and MyWorkDrive are allowed to run without restrictions.
  • Antivirus software should set to exclude the “C:\Program Files (x86)\Wanpath\MyWorkDrive-Client-Windows”, C:\ProgramData\Wanpath\*.* – log files C:\Users\%username%\AppData\Local\MyWorkDrive\*.* – user configuration data folders and network drives to prevent file corruption and slowness issues.
  • Be aware that if users configure office on macOS to “Always Create Backup Copy”, backup folders and files will be stored on the map drive shares where the original file exists. Disable this feature in office on macOS to avoid those files/folders being created.
  • Use of the “Open in Office Online” feature with local office installed is unsupported due to file association conflicts.

Release Notes are located here