Claris FileMaker Pro 19 Network Install Setup Guide
Network Install Setup Guide
About this guide
This guide explains how to configure the installation of Claris® FileMaker Pro™ 19 over a network on multiple computers. For information on installing the software on individual computers, see FileMaker Pro Installation Guide.
For additional FileMaker® product documentation, visit the Product Documentation Center.
About the license certificate file
To install FileMaker Pro software on multiple computers, you receive a license certificate (.fmcert) file. This file is available for you to download, depending on how you purchased FileMaker Pro:
- If you purchased FileMaker Pro as a download from the Claris Store website, you received an email message with a link to your Electronic Software Download page. Your license certificate file is available from that page. Don't lose your license certificate file; keep it in a safe place in case you need to reinstall the software.
- If you signed up for a Claris FileMaker Cloud® subscription or free trial, this file is available from the Subscription page in Claris Customer Console.
You must have a valid license certificate file to install the software. Otherwise, you can install the software only as a trial.
All use of this software is subject to the terms of your license agreement. Refer to the FileMaker Pro Software License you received with your purchase.
Installing FileMaker Pro in Windows
Before you install FileMaker Pro, have the license certificate file ready. See About the license certificate file.
When installing on Windows, the license certificate file must be copied to the same folder as the installer. If more than one license certificate file is present in this folder, the installer uses the first valid one it finds. To ensure the one you intend is used, put only one license certificate file in the installer folder.
Note:Users must have Windows administrator privileges to install FileMaker Pro.
Choosing an installation method (Windows)
Before you configure your installation, decide how you want to install the software. The installation method determines how personalized information is entered when users install FileMaker Pro.
For some installation methods, you can edit the file, Assisted Install.txt, to provide the personalized information before users install the product. See About the personalization file.
Installation method | How personalization information is supplied to the installer |
---|---|
Installing FileMaker Pro using a networked volume (Windows)—Recommended method | Edit Assisted Install.txt to standardize all networked FileMaker Pro installations. This method lets you customize the installation. |
Installing from the command line with msiexec (Windows) | Users or scripts provide the personalized information at the command line. |
Setting up silent assisted installations (Windows) | Edit the Assisted Install.txt file before performing a silent installation. User interaction with the FileMaker Pro installer is kept to a minimum. The installer reads personalization information from the file, and installation screens do not display. |
Saving personalization information in the .msi installer (Windows) | Embed personalization information directly in the installer .msi file. Because the changes persist in your .msi file, you can remove the Assisted Install.txt file. |
About installing the required Microsoft components (Windows)
For FileMaker Pro to run, users must have specific versions of these Microsoft software components installed on their computers:
- .NET Framework
- Visual C++ libraries and the Windows Runtime (provided in the Visual C++ Redistributable Package)
The required Windows updates must also be installed. See FileMaker Pro technical specifications.
If you use Setup.exe (in silent or full user interface mode) and the required Microsoft components aren't installed, Setup.exe runs the included Microsoft installers for these components. The FileMaker Pro installer continues after it detects that the Microsoft components are installed.
Note:The Microsoft installers for these components require internet access to download the necessary files.
However, if you use the .msi file, make sure these Microsoft components are installed before users start FileMaker Pro. The .msi file installs FileMaker Pro without checking whether the components are installed, but FileMaker Pro won't run without them.
If necessary, users can install the Microsoft components manually:
- Open the FileMaker Pro installation folder.
-
Open the Files folder, then:
To install Do this .NET Framework - Open the DotNet folder.
- Double-click the icon.
Visual C++ Redistributable Package - Open the Redist folder.
- Double-click the x64 icon.
- Follow the onscreen instructions.
- Install the required Windows updates for the Microsoft components.
About installing Bonjour (Windows)
The Bonjour service must be installed for hosts on your local network to be discovered. If Bonjour isn't installed or if the Bonjour service isn't running, users won't be able to view hosted files on your local network in the Hosts dialog box. Without Bonjour, they must manually enter the names or IP addresses for hosts on your local network.
Using Setup.exe (in silent or full user interface mode) installs Bonjour automatically; using the .msi file does not. Users can also install Bonjour manually. See Installation Guide.
Installing FileMaker Pro using a networked volume (Windows)
To make FileMaker Pro installation files available on your network:
- Create an installer folder on a networked volume for the installation files.
- In your software download, locate the installation files in the Files folder. Then, copy the files to the folder you created on your networked volume.
-
Copy the license certificate file to the installer folder you created (where the .msi file is). See About the license certificate file.
- To set up an assisted installation, edit the Assisted Install.txt file located in the installer folder you created, and save the changes as plain text. See About the personalization file.
To install FileMaker Pro, tell users to:
- Mount the volume containing the installation files.
- Double-click Setup.exe.
Installing from the command line with msiexec (Windows)
Users can install FileMaker Pro from the command line without using Assisted Install.txt. A command line installation requires you to run the Command Prompt as administrator.
- Copy the license certificate file to the same folder that the .msi file is in. See About the license certificate file.
- Choose Start menu, then search for Command Prompt. Right-click Command Prompt and choose Run as administrator.
-
In the Administrator: Command Prompt window, enter a command.
For example:
msiexec -i "ProductName.msi" AI_USERNAME="John Lee"
Property names must be in all-uppercase letters. The user name property is optional. See Setting personalization properties in Assisted Install.txt.
If the .msi file is on a mapped network drive, you may need to enter
net use * \\server\share
in the Command Prompt window first so that the command above can access the mapped network drive.Alternatively, you can create your own script that performs the command, then run your script on users' computers.
Note:For more information about msiexec, see docs.microsoft.com.
Setting up silent assisted installations (Windows)
Users can perform a silent installation, which keeps interaction with the FileMaker Pro installer to a minimum. Required installation information is read from the Assisted Install.txt file, and installation screens aren't displayed. See About the personalization file.
- Copy the license certificate file to the same folder that the .msi file is in. See About the license certificate file.
- Choose Start menu, then search for Command Prompt. Right-click Command Prompt and choose Run as administrator.
-
In the Administrator: Command Prompt window, enter a command.
To In a command window, type Install without a user interface (silent installation) "pathname\setup.exe" /qn
Uninstall without a user interface (silent uninstallation) "pathname\setup.exe" /x /qn
Install when required—advertise to current user (silent advertised installation) "pathname\setup.exe" /q /ju
Install when required—advertise to all users (silent advertised installation) "pathname\setup.exe" /q /jm
Install and display a dialog box indicating whether the software was successfully installed "pathname\setup.exe" /qn+
Install and display a progress bar and Cancel button during installation "pathname\setup.exe" /qb+
Install to a non-default location on the user's computer "pathname\setup.exe" /qb+ INSTALLDIR="installpath
"
Alternatively, you can create your own script that performs one of these commands, then run your script on users' computers.
Notes
- pathname is the location of the installer folder you created on the networked volume. If pathname is for a mapped network drive, you may need to enter
net use * \\server\share
in the Command Prompt window first so that the commands above can access the mapped network drive. -
installpath is the desired location of the FileMaker product folder on the user's computer. The path cannot contain spaces unless it is enclosed by double quotation marks. The following example path would install into the FileMaker Pro folder inside the Applications folder on drive C:
"C:\Applications\FileMaker Pro"
- The installer will reboot the computer if required.
Saving personalization information in the .msi installer (Windows)
You can embed personalization information in the .msi installer. If you choose this method, make sure that you make no other changes to the .msi file.
You use the Microsoft Orca editor for this task. See msdn.microsoft.com.
- Copy the license certificate file to the same folder that the .msi file is in. See About the license certificate file.
- Use Orca to open the .msi file.
-
In the Property table, enter values for the properties you want to set.
See Setting personalization properties in Assisted Install.txt.
- Save the .msi file.
- Tell users to run the installer by double-clicking the Setup.exe file located on the mounted volume, by using the command line, or by running a script that you create.
Installing FileMaker Pro updates (Windows)
Users can check for updates and install them within FileMaker Pro by choosing Help menu > Check for Updates, unless this feature has been disabled (see Setting personalization properties in Assisted Install.txt). Users must have an internet connection and Windows administrator privileges to update FileMaker Pro.
Alternatively, you can download the updater and install it manually, or from the command line, or using Microsoft System Center Configuration Manager (SCCM).
To install an update manually:
- Download the ProductUpdaterName.exe file from Downloads and Resources.
- Quit FileMaker Pro.
-
Double-click the ProductUpdaterName.exe file.
The files are extracted to a folder in the same location as the .exe file, then the updater starts.
- Follow the onscreen instructions.
- Quit the updater and open FileMaker Pro.
- To verify that the update was successful, choose Help menu > About FileMaker Pro and check the version number.
To install an update from the command line:
- Follow steps 1 to 3 for a manual installation, but click Cancel after the files are extracted.
- In the folder that's created, locate the Setup.exe file.
-
Follow the instructions in Setting up silent assisted installations (Windows) to run Setup.exe with the
/qn
,/qn+
, or/qb+
command-line switch.The updater doesn't support the other switches.
To install an update using Microsoft SCCM:
- Follow steps 1 to 3 for a manual installation, but click Cancel after the files are extracted.
- In the folder that's created, locate the ProductUpdaterName.msp file under Files\Files.
-
In SCCM, create an update package that includes ProductUpdaterName.msp. In the package setup, use the following command line for a silent installation:
msiexec.exe /p ProductUpdaterName.msp /qn
- Deploy the package.
Installing FileMaker Pro in macOS
To install FileMaker Pro on multiple Mac computers:
Create a customized FileMaker Pro .pkg file using a command-line script.
Deploy the customized .pkg file to your users' computers.
See Deploying your customized FileMaker Pro .pkg file (macOS).
Creating a customized FileMaker Pro .pkg file (macOS)
- Create a working folder on a local drive.
- Download the FileMaker Pro .dmg file and double-click to open it.
-
Copy these files from the open .dmg file to the working folder:
- the FileMaker Pro.app bundle
the personalization file, Assisted Install.txt
To set up an assisted installation, edit the Assisted Install.txt file and save the changes as plain text. See About the personalization file.
- the License Agreements folder
Copy the license certificate (.fmcert) file to the working folder.
- On the Product Documentation Center, download "Apple Remote Desktop Deployment script for FileMaker Pro" (fmp_osx_deployment.zip).
- Double-click the fmp_osx_deployment.zip file to extract the script (AppleRemoteDesktopDeployment.sh).
- In /Applications/Utilities, start Terminal.
- Type
cd "<path to script>"
, then press Return. - Type
sudo chmod +x ./AppleRemoteDesktopDeployment.sh
, then press Return. When prompted to provide a password, enter an administrator password. -
Type
./AppleRemoteDesktopDeployment.sh "<path to working folder>"
, then press Return.The script creates a customized .pkg file in the working folder, ready to be deployed.
Deploying your customized FileMaker Pro .pkg file (macOS)
Use one of these methods to deploy your customized .pkg file to users:
- Make the .pkg file available for your users to download. Tell users to double-click the downloaded .pkg file and follow the onscreen instructions to install FileMaker Pro.
- Use Apple Remote Desktop or another computer management system to remotely install the .pkg file silently on multiple Mac computers in an organization.
Installing FileMaker Pro updates (macOS)
Users can check for updates and install them within FileMaker Pro by choosing Help menu > Check for Updates, unless this feature has been disabled (see Setting personalization properties in Assisted Install.txt). Users must have an internet connection to update FileMaker Pro.
Alternatively, you can:
- Download the updated application from your Electronic Software Download page or from the Subscription page in Claris Customer Console. (See About the license certificate file.) To install the updated version, see Installing FileMaker Pro in macOS.
- Download the updater .zip file from Updates and release notes and make it available to your users. Tell users to double-click the .zip file, then double-click the .pkg file inside the folder and follow the onscreen instructions.
About the personalization file
An assisted installation eases installation of FileMaker Pro in a multiple-computer environment. You enter installation options into a personalization file and make the file available on your network. FileMaker Pro then installs with minimal user intervention.
The personalization file, Assisted Install.txt, is used by the FileMaker Pro installer in Windows and by the FileMaker Pro application in macOS, but the Assisted Install.txt files are platform-specific and cannot be interchanged.
Note:The ProductName.pdf file is a plain text file that conforms to the Microsoft Package Definition File format. This file is required for mass deployment of FileMaker Pro via the Microsoft System Center Configuration Manager (SCCM). Don't edit this file unless you are using SCCM for installation. In that case, after creating the installer package, open the ProductName.pdf properties. In the General tab, for Command line, type setup.exe /S/qn
, click OK, then perform the installation.
Setting personalization properties in Assisted Install.txt
Note:Property names (AI_*) must be in all-uppercase letters. Variable settings aren't case sensitive.
To | Do this |
---|---|
Accept or don't accept the End User License Agreement (EULA) | Type one of the following after AI_LICENSE_ACCEPTED=
If you keep the default of 0 (zero), the installation completes, but users will be asked to accept the EULA terms the first time they start FileMaker Pro. See Setting up silent assisted installations (Windows) and Using Apple Remote Desktop to deploy FileMaker Pro on multiple machines (macOS). |
Enter a user name | Type a name after AI_USERNAME= If you leave this variable blank, the installer defaults to the name that was used to register Windows (Windows) or the account user name (macOS). |
Enter a valid license key, if you received one | Type your license key after AI_LICENSEKEY= |
Windows: Specify the language version of FileMaker Pro | Type the name of the language after AI_LANGUAGE= Valid entries are:
This setting works only when users perform a silent assisted installation. See Setting up silent assisted installations (Windows). macOS: There is no AI_LANGUAGE property. The FileMaker Pro installer uses the current language setting from the user's operating system. |
Windows: Specify whether FileMaker Pro is available to all users or to the current user only | Type one of the following after AI_APPLICATIONUSERS=
|
Prevent or allow users to create new custom apps | Type one of the following after AI_NONEWDATABASES=
|
Windows: Create a shortcut for FileMaker Pro on the desktop and in the Quick Launch toolbar | Type one of the following after AI_SHORTCUTS=
See the note at the end of this table for more information. |
Suppress or display the personalization dialog box during installation | Type one of the following after AI_SKIPDIALOG=
See the note after this table for more information. |
Disable or enable the Software Update dialog box | Type one of the following after AI_DISABLEUPDATENOTIFY=
|
Disable or enable the New Version Notification dialog box | Type one of the following after AI_DISABLEVERSIONNOTIFY=
|
Disable or enable option for plug-ins to be installed by files | Type one of the following after AI_DISABLEPLUGINS=
Note:Some files may require plug-ins to work properly. Contact the solution developer. For more information about installing and updating plug-ins, see Help. |
Hide or show the Enable ODBC/JDBC command | Type one of the following after AI_DISABLEXDBC=
|
Hide or show the Configure for FileMaker WebDirect® command | Type one of the following after AI_DISABLEIWP=
|
Disable or enable the FileMaker Pro development and deployment features | Type one of the following after AI_DISABLEADVANCEDTOOLS=
For more information about these features, see Help. |
Open a custom app when FileMaker Pro starts | Type the path of the file after AI_LAUNCH_CUSTOMAPP= The path must be in the special FileMaker format for a full path to a local file or to a hosted file:
The Note:In FileMaker Pro, go to Preferences menu > General tab to change the custom app file path. |
Note:In Windows, the AI_SHORTCUTS and AI_SKIPDIALOG properties determine whether the installer prompts the user to create a shortcut.
AI_SHORTCUTS= | AI_SKIPDIALOG= | Result |
---|---|---|
1 | 1 | No prompt. Creates a shortcut. |
0 | 1 | No prompt. Doesn't create a shortcut. |
1 | 0 | A dialog box is displayed. The options for creating shortcuts are selected in the dialog box. |
0 | 0 | A dialog box is displayed. The options for creating shortcuts aren't selected in the dialog box. |
Preventing users from creating custom apps
You can set a property, AI_NONEWDATABASES, that prevents users from creating FileMaker Pro custom apps. If the option is set, FileMaker Pro displays an alert message when users:
- choose File menu > Create New
- create a file in the Create window
- export to a FileMaker Pro file
- choose File menu > Save a Copy As
- open the New File dialog box
- recover a FileMaker Pro file
- convert a file (like tab-delimited or FileMaker Pro .fp7) to a new FileMaker Pro file
- execute an Apple event to open a file in another format
- execute the Apple events do menu command to create a file
- perform a script that does any of the above
- choose a custom menu item that does any of the above
To create custom apps, users must reinstall FileMaker Pro with the AI_NONEWDATABASES property set to 0.