SurpassLocal - Silent installation
Overview
Usage
Basic usage:
SurpassLocal.exe /s ARG1=VALUE1 ARG2=VALUE2
Command line usage to check error code:
start /wait SurpassLocal.exe /s ARG1=VALUE1 ARG2=VALUE2
echo %errorlevel%
Note: Command line arguments are case-sensitive.
Error codes
Common error codes:
Error code |
Description |
100 |
Windows Vista requires Service Pack 2 |
101 |
Windows Server 2008 requires Service Pack 2 |
102 |
Windows 7 requires Service Pack 1 |
103 |
Windows Server 2008 R2 requires Service Pack 1 |
104 |
.NET 4.6 is required |
105 |
Internet Explorer 9 or later is required |
106 |
IIS7 or later is required |
107 |
KB980368 update is required |
108 |
ASP.NET 4 or later is required |
109 |
ASP.NET 4 should be registered within IIS |
110 |
IIS Static File module is required |
111 |
IIS Custom Error module is required |
112 |
IIS Application Initialization module is required |
Installation
Usage
SurpassLocal.exe /s INSTALL_KEY=INS-CENTRE
Note: The installation key is the only mandatory argument.
Command line arguments
Argument |
Description |
Default value |
INSTALL_KEY |
CMS installation key |
|
CMS_PUBLIC_URL |
CMS Public Portal URL |
https://cmspublic.surpass.com |
TARGETDIR |
Destination path |
C:\ |
SITE_NAME |
Website name |
SurpassLocal |
SITE_HOST |
Website hostname |
|
SITE_IP |
Website IP address |
|
SITE_HTTP_ENABLED |
Website HTTP binding creation |
TRUE |
SITE_HTTP_PORT |
Website HTTP port |
80 |
SITE_HTTPS_ENABLED |
Website HTTPS binding creation |
FALSE |
SITE_HTTPS_PORT |
Website HTTPS port |
443 |
SITE_HTTPS_THUMBPRINT |
Website SSL certificate thumbprint |
|
SQL_SERVER |
SQL Server address |
(local) |
SQL_INSTANCE |
SQL Server instance |
|
SQL_WINDOWS |
Windows/SQL Server authentication mode |
TRUE |
SQL_USERNAME |
SQL Server username |
|
SQL_PASSWORD |
SQL Server password |
|
SQL_USE_DATABASE |
Use existing SQL Database |
TRUE |
SQL_DATABASE_NAME |
Existing SQL Database name |
|
SQL_FORCE |
Force the installation if unrecognised SQL Database |
TRUE |
USE_PROXY |
Enable connection through proxy |
FALSE |
PROXY_SERVER |
Proxy Server address |
|
PROXY_PORT |
Proxy Server port |
|
PROXY_AUTHENTICATION |
Proxy Server authentication mode |
FALSE |
PROXY_USERNAME |
Proxy Server username |
|
PROXY_PASSWORD |
Proxy Server password |
|
Error codes
Error code |
Description |
200 |
Could not install application when it is already installed |
201 |
Installation key is empty |
202 |
CMS Public Portal URL is empty |
203 |
Destination path is empty |
204 |
Website name is empty |
205 |
Both HTTP and HTTPS website bindings are disabled |
206 |
Website HTTP port is empty |
207 |
Website HTTPS port is empty |
208 |
Website SSL thumbprint is empty |
209 |
SQL Server address is empty |
210 |
SQL Server username is empty when SQL Server authentication is used |
211 |
SQL Server password is empty when SQL Server authentication is used |
212 |
Proxy Server address is empty when proxy is used |
213 |
Proxy Server port is empty when proxy is used |
214 |
Proxy Server username is empty when Proxy Server authentication is used |
215 |
Proxy Server password is empty when Proxy Server authentication is used |
216 |
CMS Public Portal URL has invalid format |
217 |
Destination path length must be not more than 140 characters |
218 |
Destination path should point at fixed media device |
219 |
Destination path does not exist |
220 |
Website name length must be not more than 64 characters |
221 |
Website name must not contain reserved characters (\/’”|<>:*?[]+=,;@&) |
222 |
Application pool with specified name exists |
223 |
Website with specified name exists |
224 |
Scheduled task with specified name exists |
225 |
Website host name must be a valid host name |
226 |
Website IP address must be a valid IPv4 or Ipv6 address |
227 |
Website HTTP port number must contain only digits |
228 |
Website HTTP port number must be between 1 and 65535 |
229 |
Website HTTP binding configuration is overlapped by existing website in IIS |
230 |
Website HTTPS port number must contain only digits |
231 |
Website HTTPS port number must be between 1 and 65535 |
232 |
Website HTTPS binding configuration is overlapped by existing website in IIS |
233 |
Connection to specified SQL Server instance has failed |
234 |
Specified database already exists |
235 |
Could not create application pool in IIS |
236 |
Could not copy application files |
237 |
Could not create SQL Server database |
238 |
Could not grant application pool identity access to SQL Server database |
239 |
Could not execute SQL Server database scripts |
240 |
Could not create website in IIS |
241 |
Could not create website HTTP binding in IIS |
242 |
Could not create website HTTPS binding in IIS |
243 |
Could not set website SSL certificate in IIS |
244 |
Could not create score report virtual directory in IIS |
245 |
Could not set item storage directory in Web.config |
246 |
Could not set central updates directory in Web.config |
247 |
Could not set uploaded responses directory in Web.config |
248 |
Could not set logging path in Web.config |
249 |
Could not set logging level in Web.config |
250 |
Could not set CMS Public Portal URL in Web.config |
251 |
Could not set item storage directory in Web.config |
252 |
Could not set style profile storage directory in Web.config |
253 |
Could not set score report storage directory in Web.config |
254 |
Could not set database connection string in Web.config |
255 |
Could not set encryption key container name in Web.config |
256 |
Could not import encryption key from file |
257 |
Could not grant application pool identity access to encryption key container |
258 |
Could not encrypt database connection string in Web.config |
259 |
Could not set style profile storage directory in Client.settings |
260 |
Could not set virtual directory option in Client.settings |
261 |
Could not set score report storage directory in Client.settings |
262 |
Could not set website URL in Client.settings |
263 |
Could not enable automatic application pool startup in IIS |
264 |
Could not enable automatic website preloading in IIS |
265 |
Could not create scheduled task |
266 |
Could not update registry |
267 |
Error occurred during self-diagnostic test |
268 |
Error occurred during connection test |
269 |
Error occurred during activation |
Update
Usage
SurpassLocal.exe /s UPDATE=TRUE
Note: The update switch is the only required argument.
Command line arguments
Argument |
Description |
Default value |
UPDATE |
Update application |
FALSE |
Error codes
Error code |
Description |
300 |
Could not update application when it is not installed |
301 |
Could not stop scheduled task |
302 |
Could not stop website |
303 |
Could not make backup of scheduled task files |
304 |
Could not make backup of website files |
305 |
Could not read CMS Public Portal URL from Web.config |
306 |
Could not decrypt database connection string in Web.config |
307 |
Could not read database connection string from Web.config |
308 |
Could not process database connection string |
309 |
Could not delete temporary file with database connection string |
310 |
Could not make backup of database |
311 |
Could not update files |
312 |
Could not update database |
313 |
Could not set item storage directory in Web.config |
314 |
Could not set central updates directory in Web.config |
315 |
Could not set uploaded responses directory in Web.config |
316 |
Could not set logging path in Web.config |
317 |
Could not set logging level in Web.config |
318 |
Could not set CMS Public Portal URL in Web.config |
319 |
Could not set item storage directory in Web.config |
320 |
Could not set style profile storage directory in Web.config |
321 |
Could not set score report storage directory in Web.config |
322 |
Could not set database connection string in Web.config |
323 |
Could not set encryption key container name in Web.config |
324 |
Could not import encryption key from file |
325 |
Could not grant application pool identity access to encryption key container |
326 |
Could not encrypt database connection string in Web.config |
Error codes |
Description |
327 |
Could not set style profile storage directory in Client.settings |
328 |
Could not set virtual directory option in Client.settings |
329 |
Could not set score report storage directory in Client.settings |
330 |
Could not set website URL in Client.settings |
331 |
Could not update registry |
332 |
Could not start website |
333 |
Could not start scheduled task |
334 |
Could not create scheduled task |
335 |
Error occurred during self-diagnostic test |
Uninstallation
Usage
SurpassLocal.exe /s REMOVE=TRUE
Note: The remove switch is the only required argument.
Command line arguments
Argument |
Description |
Default value |
REMOVE |
Uninstall application |
FALSE |
Error codes
Error code |
Description |
400 |
Could not uninstall application when it is not installed |
401 |
Could not decrypt database connection string in Web.config |
402 |
Could not read database connection string from Web.config |
403 |
Could not process database connection string |
404 |
Could not delete temporary file with database connection string |
405 |
Could not delete scheduled task |
406 |
Could not delete website in IIS |
407 |
Could not delete SQL Server database |
408 |
Could not delete application pool in IIS |