Laserfiche Installer
The Laserfiche Installer provides a centralized view of available Laserfiche 12 applications. Pick which version 12 applications to download and install from a list that shows the currently installed applications on the computer and see if there is an update available for that application.
Overview of the Laserfiche Installer
Before Installing Laserfiche
The Laserfiche Installer requires an installation code. This code is used by the installer to contact Laserfiche to retrieve information on what applications you are licensed for and is different from any activation keys you may have on record for your products.
You can generate a Laserfiche installation code from the activation keys page of the Laserfiche Support Site at: https://support.laserfiche.com/activationkeys.
Under the Laserfiche Installation Codes section, generate an installation code. You may have up to two installation codes. Use the Regenerate option to replace an existing code.
Keep the code ready for use when you launch the Laserfiche Installer.
If you are installing Directory Server, make sure to also take note of the activation key for Directory Server.
Installing Laserfiche
- Use the above link to download the Installer.
- Open the Laserfiche Installer MSI (LaserficheInstaller.msi). The Laserfiche Installer is installed at C:\Program Files\Laserfiche\DistributionPortal.
-
Administrators can choose between two operation modes: Offline or Online.
-
The installer defaults to Online mode. In Online mode, provide an installation code to retrieve the list of available applications.
-
Choose how you activate your Laserfiche products.
Note: If this is your first time installing Directory Server, you should finish configuring Directory Server before continuing with the Laserfiche Installer to download, install, and activate additional applications.
-
The installer will automatically retrieve the list of available Laserfiche applications for installation.
- When possible, the installer will automatically renew your primary license. If this fails, you will need to manually update the primary license in Laserfiche Directory Server. When Laserfiche Directory Server does not have a direct internet connection, you will need to renew your license using the activation tool.
- Use the Options toolbar button to enter a different installation code and see additional configuration information.
Important: The Laserfiche Installer requires an internet connection to retrieve information on what applications are available to you and to download installation packages from Laserfiche CDNs. The Firewall/Proxy Information option in the Options toolbar button shows a list of Laserfiche endpoints used by the installer. To ensure proper functionality with the Laserfiche Installer, please verify that the following endpoints are accessible: https://d1oywsbnq10fc4.cloudfront.net, https://infrapi.laserfiche.com/api, https://laserfiche-support-site-downloads.s3.us-west-2.amazonaws.com, https://d3hop2pwjyql7m.cloudfront.net, https://laserfiche-support-site-bucket.s3.us-west-2.amazonaws.com.
- Select the product you want to install or modify on the current machine or use the Bulk Install / Uninstall option to select multiple products. The automated installation process uses default installation paths and values for the product installations. The Laserfiche Installer installs Laserfiche programs at C:\Program Files\Laserfiche.
- Optional: Use the Install from local toolbar option if you want to manually select a specific local package to install, regardless of whether the Installer is configured for Online or Offline mode.
Note: The Laserfiche Installer does not currently include an option to change the install location.
Running the Laserfiche Installer in Offline Mode
If you need to install Laserfiche on a machine that cannot access the internet, you can run the installer on a machine with internet access to first download the desired installation packages for a product, move or copy the downloaded package to the appropriate destination machine, and then run the local package from the Installer to manually install a local package. In addition, you will need to manually update the Installer itself before using it to install individual application packages.
Downloading application packages beforehand
- Install and open the installer on a machine with internet access.
- Use the Download applications toolbar button (
) to download the desired installation packages and move or copy the downloaded packages to the appropriate destination machine.
How to manually update the Laserfiche Installer on an offline machine
- Download both the base Laserfiche 12 Installer Launcher package and the latest Installer update:
- Copy the base Laserfiche 12 Installer package to a convenient location on the machine without internet access, extract the package and run "Autorun.exe" to install the Laserfiche 12 Installer Launcher.
- Copy the Latest Laserfiche 12 Installer update package to a convenient location on the machine without internet access and extract the contents of the package to the following location: %localappdata%\Laserfiche\LFInstaller\Plugins on the offline machine. By default, the %localappdata% environment variable is C:\Users\yourusername\AppData\Local.
Running the Laserfiche Installer in Offline Mode
- On the offline machine, append a command line parameter to the Laserfiche Installer windows shortcut to stop the Laserfiche Installer from attempting to automatically search for updates:
- In Windows search, search for Laserfiche Installer.
- Right-click on the app shortcut and open file location.
- View the file properties for the shortcut.
- On the Shortcut tab, in the Target field, append the following parameter after the executable path: -skip-update. The full target should look similar to the following example:
"C:\Program Files\Laserfiche\DistributionPortal\DistributionPortal.exe" -skip-update
- Launch the Installer on the offline machine.
- Click the Settings toolbar button (
) and set Operation Mode to Offline and specify the location of the pre-downloaded application packages.
- If you have an existing Directory Server instance, run the installer and provide the Directory Server host and licensing site. This will be used to retrieve application licenses for subsequent installs.
- If you plan to use Directory Server, but need to install it first, install it first with the instructions below, set up and activate your licensing site, then launch the new installer and enter the Directory Server host and licensing site info.
- If you are not using Directory Server and/or want to provide a Laserfiche license file (lf.licx), obtain those license files and save them locally on the machine. You can provide the license file as a command-line parameter.
Laserfiche Central Configuration Editor
The Laserfiche Central Configuration Editor is a utility that provides a graphical user interface for editing an optional default configuration file for managing service user settings on install and upgrade. The utility is also available for installation from the Laserfiche Installer. After configuring the desired service users, during the installation process, the Laserfiche Installer allows you to pass in a saved central configuration file.
Unattended Installation (LFGet.exe)
The Laserfiche Installer includes a command-line interface (CLI) named LFGet.exe that allows unattended installation. The CLI is automatically installed to your local appdata directory when you run the Laserfiche Installer on a machine. The default path is:
C:\Users\ <username>\AppData\Local\Laserfiche\LFInstaller\Plugins\LFGet\LFGet.exe
Running LFGet.exe will present you with basic information on using the CLI.
LFGet.exe supports the following commands.
install-local-package
Installs a local package.
| Option | Description |
| -x, --iacceptlicenseagreement | (Required) Accept the license agreement. |
| -z, --iagreetoprereqs | (Required) Install pre-requisites if they would ordinarily require user permission. |
| -g, --package | (Required) The full path to the application installation package. |
| -c, --config-file | Input central configuration file for installation. |
| -A, --license-app |
Specify an application GUID from Directory Server if multiple application license types exist.
Used when --licensing-mode is 'lfds' |
| -D, --license-database |
Directory Server licensing site.
Required when --licensing-mode is 'lfds' |
| -F, --license-file | License file path of a Laserfiche product. |
| -N, --license-no-ssl |
Disable SSL when connecting to Directory Server. (Not recommended).
Used when --licensing-mode is 'lfds' |
| -S, --license-server |
Server name for Directory Server.
Required when --licensing-mode is 'lfds' |
| -M, --licensing-mode <file|key|lfds> |
Select a mode for Laserfiche product activation.
|
| -l, --log | The directory in which the installation logs will be stored. If this parameter is not specified, log files will be saved in the default path. |
| -?, -h, --help | Show help and usage information. |
Examples:
Install a package from path {A} without activation:
install-local-package --package {A} --iacceptlicenseagreement --iagreetoprereqs
Install a package from path {A} and activate the application using a license file with path {B}:
install-local-package --package {A} --iacceptlicenseagreement --iagreetoprereqs --licensing-mode file --license-file {B}
Install a package from path {A} and activate the application via a Directory Server whose server is {C} and whose database is {D}:
install-local-package --package {A} --iacceptlicenseagreement --iagreetoprereqs --licensing-mode lfds --license-server {C} --license-database {D}
Install a package from path {A}, activate the application via a Directory Server whose server is {C} and whose database is {D} and not use SSL, and specify the application GUID as {E}:
install-local-package --package {A} --iacceptlicenseagreement --iagreetoprereqs --licensing-mode lfds --license-server {C} --license-database {D} --license-no-ssl --license-app {E}
Install a package from path {A}, activate the application via an LFDS server whose server is {C} and whose database is {D}, specify the application GUID as {E}, and set log path to {F}:
install-local-package --package {A} --iacceptlicenseagreement --iagreetoprereqs --licensing-mode lfds --license-server {C} --license-database {D} --license-app {E} --log {F}
Install a package from path {A}, activate the application using a license file with path {B}, and input central config file {G}:
install-local-package --package {A} --iacceptlicenseagreement --iagreetoprereqs --licensing-mode file --license-file {B} --config-file {G}
install-product
Install a Laserfiche application and retrieve packages from the internet.
| Option | Description |
| -x, --iacceptlicenseagreement | (Required) Accept the license agreement. |
| -z, --iagreetoprereqs | (Required) Install pre-requisites if they would ordinarily require user permission. |
| -i, --installation-code | (Required) The Installation Code for use with the Laserfiche Installer. |
| -p, --product | (Required) Keyword specifying the desired Laserfiche application (case sensitive). |
| -a, --activation-key |
Input an activation key of a Laserfiche product. Required when --licensing-mode is 'key' |
| -c, --config-file | Input central configuration file for installation. |
| -A, --license-app | Specify an application GUID from Directory Server if multiple application license types exist. Used when --licensing-mode is 'lfds' |
| -D, --license-database |
Directory Server licensing site.
Required when --licensing-mode is 'lfds' |
| -F, --license-file | License file path of a Laserfiche product. |
| -N, --license-no-ssl |
Disable SSL when connecting to Directory Server. (Not recommended).
Used when --licensing-mode is 'lfds' |
| -S, --license-server |
Server name for Directory Server.
Required when --licensing-mode is 'lfds' |
| -M, --licensing-mode <file|key|lfds> |
Select a mode for Laserfiche product activation.
|
| -l, --log | The directory in which the installation logs will be stored. If this parameter is not specified, log files will be saved in the default path. |
| -?, -h, --help | Show help and usage information. |
Supported -p or --product keywords:
- AdminHubAgentSetup: Laserfiche Administration Hub Agent
- AdminHubSetup: Laserfiche Administration Hub
- DirectoryServiceSetup: Laserfiche Directory Service
- FormsSetup: Laserfiche Forms
- FullTextSearch: Laserfiche Full Text Search
- ImportAgent: Laserfiche Import Agent
- LfInstallerConfigUtility: Laserfiche Configuration Hub
- OCR: Laserfiche OCR
- OfficePluginSetup: Laserfiche Office Integration
- RepositoryAdmin: Laserfiche Administration Console
- RepositoryServer: Laserfiche Repository Server
- RepositoryWebClientSetup: Laserfiche Repository Web Client
- ScanningSetup: Laserfiche Scanning
- Snapshot: Laserfiche Snapshot
- SnapshotSharedPrinter: Laserfiche Snapshot Shared Printer
- WebToolsAgent: Laserfiche Webtools Agent
- WindowsClient: Laserfiche Repository Desktop Client
- WorkflowDesigner: Laserfiche Workflow Designer
- WorkflowServer: Laserfiche Workflow Services
Examples:
Install an application {A} with installation code {B} without activation:
install-product --product {A} --iacceptlicenseagreement --iagreetoprereqs --installation-code {B}
Install an application {A} with installation code {B} and activate the application using a license file with path {C}:
install-product --product {A} --iacceptlicenseagreement --iagreetoprereqs --installation-code {B} --licensing-mode file --license-file {C}
Install an application {A} with installation code {B} and activate the application using an activation key {D}:
install-product --product {A} --iacceptlicenseagreement --iagreetoprereqs --installation-code {B} --licensing-mode key --activation-key {D}
Install an application {A} with installation code {B} and activate the application via a Directory Server whose server is {E} and whose database is {F}:
install-product --product {A} --iacceptlicenseagreement --iagreetoprereqs --installation-code {B} --licensing-mode lfds --license-server {E} --license-database {F}
Install an application {A} with installation code {B}, activate the application via a Directory Server whose server is {E} and whose database is {F} and not use SSL, and specify the application GUID as {G}
install-product --product {A} --iacceptlicenseagreement --iagreetoprereqs --installation-code {B} --licensing-mode lfds --license-server {E} --license-database {F} --license-no-ssl --license-app {G}
Install an application {A} with installation code {B}, activate the application via a Directory Server whose server is {E} and whose database is {F}, specify the application GUID as {G}, and set log path to {H}:
install-product --product {A} --iacceptlicenseagreement --iagreetoprereqs --installation-code {B} --licensing-mode lfds --license-server {E} --license-database {F} --license-app {G} --log {H}
Install an application {A} with installation code {B}, activate the application using an activation key {D}, and input central config file {I}:
install-product --product {A} --iacceptlicenseagreement --iagreetoprereqs --installation-code {B} --licensing-mode key --activation-key {D} --config-file {I}
download-product
Download a Laserfiche application package.
| Option | Description |
| -d, --dest | (Required) Download location. |
| -i, --installation-code | (Required) The Installation Code for use with the Laserfiche Installer. |
| -p, --product | (Required) Keyword specifying the desired Laserfiche application (case sensitive). |
| -l, --log | The directory in which the installation logs will be stored. If this parameter is not specified, log files will be saved in the default path. |
| -?, -h, --help | Show help and usage information. |
Example:
Download an application {A} with installation code {B} to download location {C}, and set log path to {D}
download-product --product {A} --installation-code {B} --dest {C} --log {D}
repair-product
Repair a Laserfiche application.
| Option | Description |
| -p, --product | (Required) Keyword specifying the desired Laserfiche application (case sensitive). |
| -l, --log | The directory in which the installation logs will be stored. If this parameter is not specified, log files will be saved in the default path. |
| -?, -h, --help | Show help and usage information. |
Example:
Repair an application {A}, and set log path to {B}
repair-product --product {A} --log {B}
setup-lfinstaller
Download and update the Laserfiche Installer.
| Option | Description |
| -d, --dest | Download location. |
| -t, --downloadtodest | Download package to destination without installing. |
| -x, --iacceptlicenseagreement | Accept the license agreement. |
| -z, --iagreetoprereqs | Install pre-requisites if they would ordinarily require user permission. |
| -l, --log | The directory in which the installation logs will be stored. If this parameter is not specified, log files will be saved in the default path. |
| -g, --package | The full path to the application installation package. |
| -?, -h, --help | Show help and usage information. |
Examples:
Download and install Laserfiche Installer:
setup-lfinstaller --iacceptlicenseagreement --iagreetoprereqs
Download and install Laserfiche Installer and keep a package in folder {A}:
setup-lfinstaller --dest {A} --iacceptlicenseagreement --iagreetoprereqs
Install Laserfiche Installer from a path {A}:
setup-lfinstaller --package {A} --iacceptlicenseagreement --iagreetoprereqs
Download Laserfiche Installer package to folder {A}:
setup-lfinstaller --dest {A} --downloadtodest
uninstall-product
Uninstall a Laserfiche application.
| Option | Description |
| -p, --product | (REQUIRED) Keyword specifying the desired Laserfiche application (case sensitive). |
| -l, --log | The directory in which the installation logs will be stored. If this parameter is not specified, log files will be saved in the default path. |
| -?, -h, --help | Show help and usage information. |
Example:
Uninstall an application {A}, and set log path to {B}:
uninstall-product --product {A} --log {B}
Windows Installer
You can manually install individual Laserfiche application packages using the msiexec.exe command line utility. See Microsoft's documentation on available command line options and Windows Installer properties
Note: Administrators that bypass the Laserfiche Installer to manually install packages with custom properties (e.g., specifying a custom installation location) will need to manually install updates to retain those custom properties.
Use the Download applications () option in the Laserfiche Installer to download specific installation packages. The packages are downloaded as self-extracting executables with the relevant .msi file.
The following examples demonstrate some common use cases.
Install a package to a specific installation location and show the basic user interface:
msiexec /i "C:\sampledownloadfolder\samplepackagename.msi" /qb TARGETDIR="C:\samplefoldername"
Install a package with no user interaction:
msiexec /i "C:\samplepackagename.msi" /qn
Install a package with no user interaction with verbose logging:
msiexec /i "C:\samplepackagename.msi" /qn /l*v "C:\installlogs\install.log"
Uninstalling a package:
msiexec /x {12345678-ABCD-1234-1234-1234ABCDEFGH} /l*v "C:\log.txt"