FAQ - macOS
Crossover is based on Wine, an open source compatibility layer used to run Windows applications on macOS and Linux. It translates calls a Windows system would recognize so a compatible application can run at a near native quality. In some cases, these take place so well, that an application can run better in Crossover than it does in Windows. MasterFile adapted for Crossover on macOS feels as fast of not faster than on Windows. You can launch MasterFile or Notes natively from the dock, and use macOS functionality like cross-platform copy and paste and share the file system with MasterFile.
A Windows application environment is a self-contained 'bottle'. The MasterFile bottle is the complete Windows environment for MasterFile. You simply archive a bottle to back up Notes and MasterFile's Windows operating environment as one file to wherever you keep your backups. Since your cases are stored in a folder off your Mac home folder, and can grow as you create more cases or add evidence, back those up as you normally would, too.
Since MasterFile is not a completely native Mac application, although it looks and functions almost exactly like one, you will need a few (free) helper applications. We cover all those, and some optional Windows applications too, in this article. Please read it before starting out.
To use MasterFile's Grab & Go reporting, its Client Intake forms, and for Evidence Cruncher to convert Office files, you need Microsoft Office. The only supported version for macOS users is Office 2010, Windows version. If your Crossover MasterFile bottle did not come preloaded with Office 2010, you must request the correct Microsoft Office 2010 standalone installer from us and follow our instructions to install. Activation can then proceed via an Office 2010 serial number or possibly via activation through your Office 365 subscription.
If you use MasterFile on your own, you do not have to change any of the settings below. But if you are connecting to MasterFile Hosted Services or your on-premise MasterFile Domino server or are downloading email via IMAP for example, then you must enable Internet access within Notes.
Click on File > Preferences.
- And then click on Ports and New.
- Type TCPIP as shown below.
- Choose TCP from the 'Driver' drop down box.
- Select 'Online' in locations.
- Click OK.
You'll see the port added. Click OK and you'll see a notification to exit and restart Notes for the settings to take effect.
Since MasterFile and Notes live in what Crossover calls a 'bottle' -- a specific Windows emulator for them -- files in the Crossover folders should not be modified nor should new programs be installed using Crossover into your MasterFile bottle as you might corrupt your installation. Contact MasterFile support if you need help.
To navigate to these folders, we use Finder. Note that generally, there is no need to access these areas unless asked to do so by MasterFile support or you are backing up the Notes > Data folder.
Here's how to get there:
Highlight the MasterFile bottle in Crossover,
and from the gear at the bottom, choose "Open C: drive" like this
and Finder will open. You can see the full path below, FYI.
- No Windows applications other than MasterFile and those explained in the macOS section of this knowledgebase should be installed in the MasterFile bottle. Please contact us if you have any questions.
- If you do install any 3rd party Windows applications into the MasterFile bottle, you may corrupt your installation; it may not be recoverable. Any support for such errors are not covered by your MasterFile maintenance and technical support subscription and will be billed as professional services.
It's easy to back up the installation files on macOS with Crossover.
Note that this does not back up your data, just the installation. Which saves you having to reinstall. Your data files should be backed up to wherever you normally do, once Notes has been shut down.
Select the MasterFile bottle.
From the menu bar's Bottle menu, choose "Export MasterFile".
Navigate to a folder of your choosing and click "Save".
Wait until the archive has been exported and then continue with your next task in MasterFile.
If you need to restore the bottle, select the old bottle Crossover as you did above and click "Delete" from the above menu. That will remove it from the system. Then click "Import" from the same menu, navigate to the folder where you kept your archive and click restore. All archives have the extension .cxarchive
You can give the archive a descriptive name at the time of export.
When restoring, give the bottle the name "MasterFile" if you given the archive file a different name. For example, in restoring the archive below, delete the portion of the name after "MasterFile" leaving the bottle to be named "MasterFile".
The MasterFile folder in your Home folder (ze below) holds MasterFile's working folders, including its Watch Folder (under Directories) and all your case databases (under MF) as shown below.
We suggest you pin your Home folder to Favourites.
In Finder, go to your Home folder by clicking ⌘h to open it, click ⌘⇧ to go up one level and then drag and drop your home folder on to the Favourites sidebar as you can see above.
If application icons have disappeared from Crossover, like this ...
then choose Configure > Clear and rebuild icons from the menu bar ...
and all the icons will be re-built.
You must exit Notes before making any backup.
The two folders to backup are:
- Your cases
- The Notes data folder
Please see the respective FAQs in this article to learn how to find them.
Sometimes, you'll see profile fields scramble the display as you scroll. Like this.
This does not affect any data but if you are working in those fields, it's irritating. We're working to try to resolve this issue but in the meantime, please click on the 'Original locations and/or file name' selector and they will fix themselves.
If a dialog box stops responding to mouse or keyboard input, MasterFile has lost focus. Usually, switching to another application and back again with ⌘Tab, will fix it.
In the rare event that MasterFile freezes, or will not respond after a long period, you can force it to shut down. This may also cause all applications running in the MasterFile bottle to close too.
Note that when you are loading hundreds or thousands of files it may look like nothing is happening, but MasterFile will still be working ... in that case check MasterFile's working directories to see files being added as they are loaded, and/or the log files being created, rather than mistakenly forcing MasterFile to close.
- Highlight the MasterFile bottle.
- Click the gear icon at the bottom of the window.
- Click 'Quit MasterFile' and MasterFile should close.
- If it does not close, repeat the last two steps but this time click 'Force Quit MasterFile' which will now be available as an option.