Silent Install Switches (v7.0 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.0 or newer versions.

Parameter Groups

Tricerat supports several parameter groups.  The following table shows which parameter groups apply to each product installer.


Parameter GroupScrewDrivers ClientScrewDrivers EssentialsScrewDrivers DatabaseScrewDrivers Pro or Enterprise
Basic--Yes

Yes

MsiexecYesYes--
FeaturesYesYesYesYes
Licensing-Yes-Yes
Database---Yes
Optional---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,B3D618FCD640C1BB6D035D907A7F98,MicrosoftVisualC_1,C49_E141_464F_BA06_579198CB3688,CA62D813A4E74FA2AAE86A7D7B7B1493,D564007E3BBE4F85950A09B470A7CA65,MicrosoftVisualC

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
    • TCPClient - Extends the virtual channel Endpoint Client to support connections to the ScrewDrivers Gateway for remote sessions where a virtual channel plugin cannot be used. You must specify EndpointClient as well.  Note: Requires a Pro or Enterprise license on the Session Agent
  • ScanningClient - Client functionality to redirect local scanners into a remote session and handle upload of scan data to session applications


Features for the ScrewDrivers Essentials installer:

Required

  • MainFeature,VisualC2008x86,VisualCRedistrib,MicrosoftVisualC,VisualC2008x64,MicrosoftVisualC_1,VisualCRedistrib_1

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
  • LegacyConsole - Installs the legacy v6 console for those that want to have access to a more familiar look and feel

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 

Optional Parameters

These optional parameters allow you to customize some Windows Registry values.

Below is a table of optional parameters:


Command Line SpecificationTricerat Windows Registry BranchRegistry ValueValues
OPTION_HANDLE_LOCK_NOTIFICATIONSSOFTWARE\Tricerat\ScrewDriversHandleLockNotifications0 (disabled, default) or 1 (enabled)
OPTION_MAX_OWNER_GENERATIONSSOFTWARE\Tricerat\ScrewDriversMaxOwnerGenerations0 (parents) through 4,294,967,295 (all parents, default)
OPTION_PROCESS_GROUPSSOFTWARE\Tricerat\ScrewDriversProcessGroups0 (disabled) or 1 (enabled, default)
OPTION_PROCESS_GROUPS_AS_SIDSOFTWARE\Tricerat\ScrewDriversProcessGroupsAsSID0 (disabled, default) or 1 (enabled)
OPTION_PROCESS_SERVER_ASSIGNMENTSSOFTWARE\Tricerat\ScrewDriversProcessServerAssignments0 (disabled) or 1 (enabled, default)
OPTION_PROCESS_USER_ASSIGNMENTSSOFTWARE\Tricerat\ScrewDriversProcessUserAssignments0 (disabled) or 1 (enabled, default)
OPTION_SUPPRESS_LICENSE_ERROR_DIALOGSOFTWARE\Tricerat\ScrewDrivers\LicensingSuppressLicenseErrorDialog0 (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.0.0.18118_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.0.0.18118_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,VisualC2008x86,VisualCRedistrib,MicrosoftVisualC,VisualC2008x64,MicrosoftVisualC_1,VisualCRedistrib_1,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.0.0.18118_x64.msi /qn APPDIR="C:\Program Files\Tricerat" ADDLOCAL=MainFeature,B3D618FCD640C1BB6D035D907A7F98,MicrosoftVisualC_1,C49_E141_464F_BA06_579198CB3688,CA62D813A4E74FA2AAE86A7D7B7B1493,D564007E3BBE4F85950A09B470A7CA65,MicrosoftVisualC,EndpointClient
or
msiexec.exe /i ScrewDriversClient_7.0.0.18118_x64.msi /qn /l*vx "CustomLogFilename" APPDIR="C:\Program Files\Tricerat" ADDLOCAL=MainFeature,B3D618FCD640C1BB6D035D907A7F98,MicrosoftVisualC_1,C49_E141_464F_BA06_579198CB3688,CA62D813A4E74FA2AAE86A7D7B7B1493,D564007E3BBE4F85950A09B470A7CA65,MicrosoftVisualC,EndpointClient