Installing Synergy products from the command line

To install Synergy products from the command line, pass the necessary options as arguments to the installation file (e.g., 104SDE1101.exe).

For  most installations, use this syntax:

filename [ui_level] [/log filename] [LICENSETYPE=Client|NonClient 
         SERVERNAME=name[:port]|LICENSEENAME=name]

For Synergy/DE Client installations, use this syntax:

filename [ui_level] [/log filename] [LICENSE_SERVER=name[:port] SFWINIPATH=path]

For uninstallations, use this syntax:

filename /uninstall [ui_level] [/log filename]

For repairs, use this syntax: 

filename /repair [ui_level] [/log filename]

Options

ui_level

(optional) The level of UI for the installation:

/qr = Display a reduced UI, with a full-sized progress dialog box.
/qb = Display a basic UI, with a small progress dialog box.
/qn = Display no dialog boxes (a quiet or silent installation). You can optionally use /quiet, /q, /silent, or /s.

If ui_level isn’t passed, a full UI is displayed, with all dialog boxes.

/log filename

(optional) Specify a name and location for the log file. Include the full path if desired; if only a filename is specified, the file will be placed in the current directory. If there is a space in the path or file name, enclose it in double quotes. By default, the log file has a generated filename that includes a time stamp and is placed in the %TEMP% directory. You can optionally use /l.

LICENSETYPE=Client|NonClient

(optional) Synergy/DE installations only. Specify either Client (if the target machine is a license client) or NonClient (if the target machine is a license server or stand-alone). These values are case sensitive. LICENSETYPE defaults to Client if not passed.

SERVERNAME=name[:port]

(optional) Synergy/DE installations only. The name of the license server machine. Required when LICENSETYPE is Client or is not passed. If the license server is running on a non-default port (the default is 2380), append a colon followed by the port number to the end of the server name.

LICENSEENAME=name

(optional) Synergy/DE installations only. The licensee name. Required when LICENSETYPE is NonClient. If the name has spaces in it, enclose it in double quotes. See Examples below.

LICENSE_SERVER=name[:port]

(optional) Synergy/DE Client installations only. The name of the license server machine for the clients. If the name has spaces in it, enclose it in double quotes. If the license server is running on a non-default port (the default is 2380), append a colon followed by the port number to the end of the server name.

SFWINIPATH=path

(optional) Synergy/DE Client installations only. The UNC or path of the synergy.ini file on the shared machine to be used by the clients. If path contains a space, put it in double quotes. If you omit this option, clients will use the synergy.ini file located in DBLDIR on the shared machine. We recommend that you always specify the location of synergy.ini with SFWINIPATH because the synergy.ini file located in DBLDIR is a sample file.

/uninstall

Uninstall the product.

/repair

Repair the product installation. This option fixes missing or corrupt files, shortcuts, and registry keys.

/help

Display a list of options. You can optionally use /h or /?.

Discussion

All operating system requirements (such as service packs and minimum versions) apply and can halt an installation if they are not met.

Important

Synergy products must be installed from an elevated command prompt.

When using /qr or /qb, errors will display to the screen. But when using /qn, if an error is encountered, the process will likely abort without displaying the error to the screen. If this happens, it may be helpful to look at the log file. Or, you can display the error to the screen by using the start command and then echoing the error back to the command line. The syntax varies depending on your scripting language. For example, 

C:\>start /wait 104SDE1101.exe /qn LICENSETYPE=Client SERVERNAME=Tiger
C:\>echo %ERRORLEVEL%

The properties LICENSETYPE, SERVERNAME, and LICENSEENAME are used to specify license information for new Synergy/DE installations. Properties are case-sensitive, as are the values Client and NonClient. If properties are passed when the target system already has license information from a previous installation of Synergy (such as on an upgrade), the passed properties are ignored and the existing license information is used instead. License properties apply only to Synergy/DE installations and are valid only on reduced, basic, and no UI installations. If these properties are passed on a full UI installation, they are ignored.

When 32-bit Synergy/DE is installed on a 64-bit machine on which 64-bit Synergy/DE is already installed and is designated as a license server, you do not have to pass LICENSETYPE and SERVERNAME because the former will default to Client and the latter to the name of the 64-bit machine. You can override the default license server by passing SERVERNAME with the desired license server name. (In this configuration, 32-bit Synergy/DE must be a license client, so you cannot override the default LICENSETYPE property.)

Important

If you do not pass license properties (or if you specify incomplete information) to a basic, reduced, or no UI installation on a machine that does not already have licensing, Synergy/DE will install, but licensing will be in an uninitialized state. To initialize licensing, run the Synergy Configuration Program and follow the prompts, or run lmu -d from the command line.

The properties LICENSE_SERVER and SFWINIPATH are used only for Synergy/DE Client installations. Properties are case-sensitive. These properties can be defined in the setup.ini file on the shared machine or passed on the command line. If they are defined in both places, the values on the command line take precedence. The license server may be the shared machine or a different machine. When the clients are installed, they will become license clients to the license server specified with LICENSE_SERVER regardless of the type of licensing they had previously. For more information on Synergy/DE Client installations, see the Synergy/DE installation instructions, available in the Downloads area of the Synergex Resource Center.

Examples

104SDE1101.exe /qn LICENSETYPE=Client SERVERNAME=Tiger /log c:\myfiles\sdeInstall.log 

104SDE1101.exe /qr LICENSETYPE=NonClient LICENSEENAME="Acme Computers store 23"

SDEC64.exe /qn LICENSE_SERVER=Tiger:5555 SFWINIPATH=\\elgar\apps\config 
104NN1101.exe /uninstall 

104SDE1101.exe /repair /qb