SurpassLocal - Silent installation

This article focuses on the silent installation, update, and uninstallation process of SurpassLocal, and will provide you with the accepted arguments, default values, and any error codes/messages. The usage section provides an example of how to construct the command line argument, all you will need to do is replace ARG and VALUE. Helpful descriptions of the accepted arguments have been provided in the tables below.

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

 

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

Feedback and Knowledge Base