Command line installation - XML configuration

true

false

currently used

Yes

No

obsolete

1

0

obsolete

{%productversion%}

Kentico version number according to Semantic Versioning.

8.0.0-alpha

{%fileversion%}

Full version number of the installed Kentico version.

8.0.5191.17572

{%programfiles%}

Path to the Program Files folder on your local drive.

c:\Program Files (x86)\

{%machine%}

Name of the current machine.

PC01

{%username%}

User name of the currently used account.

Andy

{%date%}

Current date in format yyyy-mm-dd.

2014-01-21

{%time%}

Current time in format hh-mm-ss.

14-53-23

ShowProgress

Determines if the Silent Install tool displays the progress of the installation or not.

• No - the progress is not shown.
• CommandPrompt - the progress is shown in the command line.

No | CommandPrompt

Yes

Log

Enables logging of import progress to a file.

true | false

Yes

OnError

Determines the action the tool performs when an error occurs during the installation.

Stop | Continue

Yes

LogFile

File where the log is saved. The default value is <installation path>\setup.log.

full path to a file

Yes

CheckRequirements

Indicates, if the tool checks whether the correct .NET version is installed on the target machine before executing the installation. If the installed .NET version is not matching, the installation is aborted.

true | false

No

NET

.NET version installed on the target machine.

4.0 | 4.5

Yes

SetupFolder

Folder where the tool installs the Kentico setup files (not the web project).

full path to a folder

Yes

Location

Determines where will the tool install the web files:

• Local - on a local IIS server.
• VisualStudio - on a build-in server which is included in Visual Studio or Visual Web Developer Express Edition.
• Remote - copies the files into a temporary folder on your disk. You will need to copy these files to your production server.
• Modify - modifies an existing installation (adds or removes components) on a local machine.

See Installing Kentico (Q&A) for more details.

Local | VisualStudio | Remote | Modify

Yes

WebProject

Determines if the project is installed as an ASP.NET web site, ASP.NET web application, or as a Windows Azure project.

WebSite | WebApplication | WindowsAzure

No

OpenAfterInstall

Indicates, if the tool opens the newly installed website in a new browser window when the installation finishes.

true | false

No

RegisterCounters

Indicates, if performance counters for Health Monitoring should be registered.

true | false

No

InstallWinServices

Indicates, if the tool installs Kentico Windows services in Windows.

true | false

No

RegisterApplicationToEventLog

Indicates, if the tool registers the Kentico application in Windows Event Log.

true | false

No

DeleteExisting

Indicates, if the the tool deletes the existing setup files in a folder with the same name as set in the SetupFolder attribute.

true | false

No

KillRunningProcesses

If the tool deletes existing setup files, this parameter indicates, if it can also kill already running processes related to these files.

true | false

No

InstallOnlyProgramFiles

Indicates, if only the program files should be installed. This option ignores all other settings.

true | false

No

DoNotOverwriteInstallation

If set to false, then the files of the existing installation will be overwritten. The default value is true (do not overwrite).

true | false

No

WebSite

Name of the website in IIS.

string value

Yes

TargetFolder

Path to the folder where IIS websites are stored (typically C:\Inetpub\wwwroot\).

full path to a folder

Yes

DeleteExisting

Indicates, if the the tool deletes an existing website with the same name as set in the WebSite attribute.

• GetUnique - if a website with the same name exists, the tool will not delete it and it will create a new website folder with a similar name.

true | false | GetUnique

No

KillRunningProcesses

If the tool deletes existing websites, this parameter indicates, if it can also kill already running processes related to these files.

true | false

No

AllowISAPIAndCGI

Indicates, if the tool should install ISAPI and CGI restrictions in IIS, which are necessary to run a web application in the Classic application pool mode.

true | false

No

InstallDatabase

Indicates, if the tool will install the database. If you do not install the database, you will not be able to install sample sites (WebSites element).

true | false

No

Database

Name of the target database.

string value

No

SqlName

User name of the account used for access to the SQL server.

string value

No

SqlPswd

Password for the SQL server account.

string value

No

Server

Name of the target SQL server.

string value

No

Operation

Determines whether the tool creates a new database or modifies an existing one. The default value is New.

New | Modify

No

Authentication

Type of the authentication used to access the SQL server.

SQL | Windows

No

DeleteExisting

Indicates, if the tool deletes an existing database with the same name as set in the Database attribute.

• GetUnique - if a database with the same name exists, the tool will not delete it and it will create a new database with a similar name.

true | false | GetUnique

No

Schema

Our default database schema is dbo. If you have a different schema on your SQL server (e.g., db_owner), specify it here, so that the installation tool can make adjustments to the database.

string value

No

Enabled

Indicates, if the tool sends notification e-mails when an error occurs during the installation.

true | false

Yes

From

E-mail address of the sender of the notification e-mail. This value is required in the Notification element.

e-mail address

Yes

To

E-mail address of the recipient of the notification e-mail. This value is required in the Notification element.

e-mail address (or multiple addresses separated by a semicolon (;))

Yes

Server

Name of the SMTP server used to send out the notification e-mail.

string value

Yes

Subject

Subject of the notification e-mail message.

string value

Yes

UserName

User name of the SMTP server account used to send out the notification e-mail.

string value

No

Password

Password for the SMTP server account used to send out the notification e-mail.

string value

No

SSL

Indicates, if SSL is used when sending the notification e-mail.

true | false

No

AttachLogFile

Indicates, if the tool includes a compressed installation log file as an attachment.

true | false

No

type

• InstallAll - the tool adds all components of the type to the installation. However, you can limit added components in the sub-elements by specifying No or Remove in their operation attribute.
• RemoveAll - the tool removes all components of the type from the installation. However, you can limit removed components in the sub-elements by specifying No or Add in their operation attribute.
• Mix - only configuration in the operation attribute of the sub-elements will be taken into account.

Mix | InstallAll | RemoveAll

Yes

name

Name of the web template, UI culture, module or dictionary.

string value

Yes

operation

The operation that should be performed with the component:

• Add - the component is added to the installation.
• Remove - the component is removed from the installation.
• No - no action is taken.

Add | Remove | No

Yes

domain

Domain used by the website.

string value

Yes

displayname

Name of the website used in Kentico user interface.

string value

Yes

webtemplatename

Code name of the chosen web template.

available web template code name

Yes

runsite

Indicates, if the tool should run the website after it is imported to the system.

true | false

No

rebuildsearchindexes

Indicates, if the search indexes should be rebuilt after installing the website.

true | false

No