Silent Install Switches (v7.3.1 or newer)
This page describes the command-line parameters that can be used to install ScrewDrivers products in silent mode without a user interface.
Version
This information is for version 7.3.1 or newer versions.
Parameter Groups
Tricerat supports several parameter groups. The following table shows which parameter groups apply to each product installer.
Parameter Group | ScrewDrivers Client | ScrewDrivers Essentials | ScrewDrivers Database | ScrewDrivers Pro or Enterprise |
---|---|---|---|---|
Basic | - | - | Yes | Yes |
Msiexec | Yes | Yes | - | - |
Features | Yes | Yes | Yes | Yes |
Licensing | - | Yes | - | Yes |
Database | - | - | Yes | Yes |
Optional | - | Yes | - | Yes |
Basic Parameters
/exelang 1033 English only
/exenoui tells the installer not to display any dialogs
/qn is a MSIEXEC command line switch to tell Windows Installer to run silently
APPDIR=<fully qualified path name> This parameter can be used to override the destination installation folder. We suggest always adding this parameter! Ex: APPDIR="C:\Program Files\Tricerat" for all products.
Msiexec Parameters
/qn command line switch to tell Windows Installer to run silently
APPDIR=<fully qualified path name> This parameter can be used to override the destination installation folder. We suggest always adding this parameter! Ex: APPDIR="C:\Program Files\Tricerat" for all products.
Feature Parameters
ADDLOCAL=<comma-delimited list of selected features> ADDLOCAL=ALL will install all product features. Note: It is not recommended to use ADDLOCAL=ALL for the ScrewDrivers Pro or Enterprise installer!
Features for the ScrewDrivers Client installer:
Required
MainFeature
Optional
EndpointClient - Client functionality for the redirection of local printers to a remote session and rendering of print jobs from the session to local printers
ScanningClient - Client functionality to redirect local scanners into a remote session and handle upload of scan data to session applications
TCPClient - Extends the virtual channel Endpoint or Scanning Client to support connections to the ScrewDrivers Gateway for remote sessions where a virtual channel plugin cannot be used. You must specify EndpointClient or ScanningClient as well. Note: Requires a Pro or Enterprise license on the Session Agent
Features for the ScrewDrivers Essentials installer:
Required
MainFeature
Optional
Endpoint - This feature installs the the session agent handler that virtualizes client printers and routes print jobs to the session client
Scanning - This feature installs the the session agent handler that virtualizes client scanners and routes scanning data from the client to session applications
Features for the ScrewDrivers Database installer:
Required
MainFeature - Creates and initializes the database necessary for configuration of ScrewDrivers Pro and Enterprise features
Features for the ScrewDrivers Pro or Enterprise installer:
Required
MainFeature - Installs files and registry entries shared among all features
Database - Installs the binaries required for database access for the various features
Optional Administrator Tools
Administration - Installs the ScrewDrivers Administration console for managing your printing environment
PrinterDiscovery - Installs the Printer Discovery tool for the import of native drivers and network discovery of IP printers
Bonjour - Installs the Bonjour runtime to allow for mDNS discovery of printers on the network
Reports - Installs the ScrewDrivers Reports tool to review print job data recorded by Reports services installed within the environment. NOTE: Requires an Enterprise license for operation
Optional Session Agents
SDPrinting- Installs files to support printing utilizing the ScrewDrivers virtual driver to Endpoint client and Print Server printers
Scanning - Installs support for Scanning from remote clients
Direct - Installs the files necessary to support creation of IP printers using native drivers
SessionAgents - Needed when SDPrinting or Scanning or Direct is specified
Optional Services
PrintServer - Installs the Print Server service that reports local print queues to the system and handles routing of print job data to the local printers
Gateway - Installs service to support non-Windows client access to the printing infrastructure. NOTE: Certain features require an Enterprise license.
ReportsService - Installs the service to collect print job data and store it in the ScrewDrivers database for later retrieval. NOTE: Requires an Enterprise license for operation.
Connector - Installs the service to support connections to and from remote sites for printing. NOTE: Requires an Enterprise license for operation.
SystemPrinters - Installs the service to support virtualized printing for service based applications. NOTE: Requires an Enterprise license for operation.
Licensing Parameters
LICENSE_MODE=LicenseServer
LICENSE_PATH=<port number@FQDN of license server> Unless there is a specific requirement the port number should be set to 6200.
LICENSE_SERVER_ADDR_PROP=<port number@FQDN of license server> Unless there is a specific requirement the port number should be set to 6200.
Database Parameters
SQLSERVER_SERVER_PROP=<SQL Server name>
SQLSERVER_DATABASE=<SQL Server database name>
For SQL authentication:
SQL_AUTH=UserDefined
SQLSERVER_AUTHENTICATION_USERNAME=<SQL Login ID>, e.g. “sa”
SQLSERVER_AUTHENTICATION_PASSWORD=<SQL password>
For Windows authentication (using static or fixed credentials):
SQL_AUTH=StaticWindowsAuth
SQLSERVER_AUTHENTICATION_USERNAME=<Windows user name>, e.g. “TriceratSimplify” or "myDomain\TriceratSimplify"
SQLSERVER_AUTHENTICATION_PASSWORD=<Windows password>
TRI_SQLSERVER_AUTH=Yes
For Windows authentication (using credentials of logged-on user):
SQL_AUTH=TrustedConnection SQLSERVER_AUTHENTICATION_PASSWORD=
Optional Parameters
These optional parameters allow you to customize some Windows Registry values.
Below is a table of optional parameters:
Command Line Specification | Tricerat Windows Registry Branch | Registry Value | Values |
---|---|---|---|
OPTION_HANDLE_LOCK_NOTIFICATIONS | SOFTWARE\Tricerat\Common | HandleLockNotifications | 0 (disabled, default) or 1 (enabled) |
OPTION_MAX_OWNER_GENERATIONS | SOFTWARE\Tricerat\Common | MaxOwnerGenerations | 0 (parents) through 4,294,967,295 (all parents, default) |
OPTION_PROCESS_GROUPS | SOFTWARE\Tricerat\Common | ProcessGroups | 0 (disabled) or 1 (enabled, default) |
OPTION_PROCESS_GROUPS_AS_SID | SOFTWARE\Tricerat\Common | ProcessGroupsAsSID | 0 (disabled, default) or 1 (enabled) |
OPTION_PROCESS_DOMAIN_LOCAL_GROUPS | SOFTWARE\Tricerat\Common | ProcessDomainLocalGroups | 0 (disabled) or 1 (enabled, default) |
OPTION_PROCESS_SERVER_ASSIGNMENTS | SOFTWARE\Tricerat\Common | ProcessServerAssignments | 0 (disabled) or 1 (enabled, default) |
OPTION_PROCESS_USER_ASSIGNMENTS | SOFTWARE\Tricerat\Common | ProcessUserAssignments | 0 (disabled) or 1 (enabled, default) |
OPTION_PROCESS_CLIENT_ASSIGNMENTS | SOFTWARE\Tricerat\Common | ProcessClientAssignments | 0 (disabled) or 1 (enabled, default) |
OPTION_SUPPRESS_LICENSE_ERROR_DIALOG | SOFTWARE\Tricerat\ScrewDrivers\Licensing | SuppressLicenseErrorDialog | 0 (disabled, default) or 1 (enabled) |
Optional Parameter Usage:
OPTION_HANDLE_LOCK_NOTIFICATIONS
This option affects the behavior of lock/unlock message handling in the Simplify Notification Service.
If not specified, the default value is 0 (disabled) and lock/unlock messages are ignored.
If this optional value is specified as 1 (enabled), lock/unlock messages are processed as disconnect/reconnect messages.
OPTION_MAX_OWNER_GENERATIONS
This option affects the behavior of assignment logic during Active Directory (AD) processing.
If not specified, the default value is 4,294,967,295 (0xFFFFFFFF) and all parents are processed.
If this optional value is specified, the number of parent owner objects processed during printer assignment is limited to the value specified. This can reduce the length of time needed to complete assignment processing.
OPTION_PROCESS_GROUPS
This option affects the behavior of logic during Active Directory (AD) processing.
If not specified, the default value is 1 (enabled). The default behavior in assignment logic is to interrogate Active Directory (AD) groups. This includes both local groups and normal groups.
If this optional value is specified as 0 (disabled), AD group processing is suppressed. This can reduce the length of time needed to complete assignment processing.
OPTION_PROCESS_GROUPS_AS_SID
This option affects the behavior of assignment logic.
If not specified, the default value is 0 (disabled). The default behavior in assignment logic is to interrogate Active Directory (AD) groups using a universal identifier.
If this optional value is specified as 1 (enabled), AD groups are interrogated using an internal Windows identifier (SID). This can reduce the length of time needed to complete assignment processing.
OPTION_PROCESS_SERVER_ASSIGNMENTS
This option affects the behavior of assignment logic.
If not specified, the default value is 1 (enabled). The default behavior in assignment logic is to include assignments made to the server name.
If this optional value is specified as 0 (disabled), server name processing is suppressed. This can reduce the length of time needed to complete assignment processing.
OPTION_PROCESS_USER_ASSIGNMENTS
This option affects the behavior of assignment logic.
If not specified, the default value is 1 (enabled). The default behavior in assignment logic is to include assignments made to the user.
If this optional value is specified as 0 (disable), user processing is suppressed. This can reduce the length of time needed to complete assignment processing.
OPTION_SUPPRESS_LICENSE_ERROR_DIALOG
This option affects the behavior of message dialogs presented during license processing.
If not specified, the default value is 0 (disabled). The default behavior is for a message dialog to be displayed to each end user if a valid license cannot be acquired or if a grace period license is issued.
If this optional value is specified as 1 (enabled), no message dialog is displayed to end users even if a valid license cannot be acquired although the license message is logged. Suppressing the display of license message dialogs can reduce confusion for end users not familiar with Tricerat software.
ScrewDrivers Pro Printing Example
In this example, we are installing the ScrewDrivers Printing product to the T:\Program Files\Tricerat folder. We are using a license server and connecting to the database using SQL authentication.
ScrewDriversProOrEnterprise_7.3.1.20599_x64.exe /exelang 1033 /exenoui /qn APPDIR="T:\Program Files\Tricerat" LICENSE_MODE=LicenseServer LICENSE_PATH=6200@LicenseServer.tricerat.com LICENSE_SERVER_ADDR_PROP=6200@LicenseServer.tricerat.com ADDLOCAL=MainFeature,Database,SDPrinting,SessionAgents SQLSERVER_SERVER_PROP=TriceratSqlServer SQLSERVER_DATABASE=Tricerat SQL_AUTH=UserDefined SQLSERVER_AUTHENTICATION_USERNAME=sa SQLSERVER_AUTHENTICATION_PASSWORD=saPassword
ScrewDrivers Essentials Endpoint Example
In this example, we are installing the ScrewDrivers Essentials Endpoint product and are using a license server.
msiexec.exe /i ScrewDriversEssentials_7.3.1.20599_x64.msi /qn APPDIR="C:\Program Files\Tricerat" LICENSE_MODE=LicenseServer LICENSE_PATH=6200@LicenseServer.tricerat.com LICENSE_SERVER_ADDR_PROP=6200@LicenseServer.tricerat.com ADDLOCAL=MainFeature,Endpoint
ScrewDrivers Client Endpoint Example
In this example, we are installing the ScrewDrivers endpoint client. The first example places the log file in the %TEMP% folder and the second example specifies the location and name of the log file. See Microsoft documentation for more options.
msiexec.exe /i ScrewDriversClient_7.3.1.20599_x64.msi /qn APPDIR="C:\Program Files\Tricerat" ADDLOCAL=MainFeature,EndpointClient
or
msiexec.exe /i ScrewDriversClient_7.3.1.20599_x64.msi /qn /l*vx "CustomLogFilename" APPDIR="C:\Program Files\Tricerat" ADDLOCAL=MainFeature,EndpointClient