Unattended Installation
To automate the installation of KioWare, the installer has a series of command line arguments that can be executed from within a batch file that will install KioWare and optionally load an XML configuration file and automatically license KioWare over the Internet. When installed in this manner, no dialog boxes are presented and the installation proceeds without need for user input.
The command line arguments are as follows:
Parameter Descriptions
| Switch=[value] | Lic Type | Description |
| /S |
All |
Install in silent mode. MUST be capitalized! |
| /XMLURL="http://localhost/setup.xml" |
All |
http or UNC path to xml configuration file.
Note: /RUNNOW must be specified to actually download the XML file and configure KioWare. |
| /RUNNOW=1 |
All |
0=no, 1=yes, run KioWare in silent mode to download XML configuration file. KioWare will quit after XML is downloaded and installation will continue. |
| /TN=-1234567 |
Single
TimeLimited |
transaction number for licensing. |
| /AC=1234 |
Single
TimeLimited |
authorization code for licensing. |
| /REGISTER=1 |
Single
TimeLimited |
0=do not get license, 1=get license based on /TN, /AC and /PROXY. |
| /PROXY=1 |
All |
0=no proxy, 1=use proxy. |
| /PROXY_USER=authorizedProxyUser |
All |
proxy username; must set /PROXY=1. |
| /PROXY_PASS=secret |
All |
proxy password; must set /PROXY=1. |
| /PROXY_PORT=80 |
All |
proxy port; must set /PROXY=1. |
| /PROXY_SERVER=192.168.0.1 |
All |
proxy server, either IP or fully qualified domain name; must set /PROXY=1. |
| /PRIVATE_MN=1 |
Single
TimeLimited |
0=send computer name, 1=do not send computer name. |
| /LICENSE_TYPE=multi |
Single
Multi
Volume |
single, multi or volume. |
| /LICENSE_KEY="1234-1234-1234-1234" |
Multi
Volume |
license key |
| /USER_COUNT=30 |
Multi |
number of users. |
| /COMPANY="Analytical Design Solutions" |
Multi
Volume |
company name |
| /SASBLOCKING=1 |
All |
0=No Ctrl-Alt-Del blocking, 1=Keyboard Filter Ctrl-Alt-Del blocking. |
| /LICYEAR=2008 |
TimeLimited |
used with /LICMONTH and /LICDAY to define a date the license will expire. Date must be valid and no more than 6 months in the future. |
| /LICMONTH=4 |
TimeLimited |
used with /LICYEAR and /LICDAY to define a date the license will expire. Date must be valid and no more than 6 months in the future. |
| /LICDAY=22 |
TimeLimited |
used with /LICMONTH and /LICYEAR to define a date the license will expire. Date must be valid and no more than 6 months in the future. |
| /InstLog=1 |
All |
Enables a log that is written to the install directory with details about the installation. |
| /AddRmProgs=0 |
All |
Do not put KioWare installation info in the Windows Add/Remove Programs list. |
| /kn=Store2 |
All |
Set kiosk name used for KioWare Server. Passed to the config tool as /KioskName. |
| /un=1a |
All |
Set unit name used for KioWare Server. Passed to the config tool as /UnitName. |
| /ServReboot=1 |
All |
If set to 1, will automatically reboot the computer after install. Mainly used for KioWare Server content updating. It is recommended to use the KioWare_Update_Tool program that ships with server rather than using a batch file with this switch. See the Content Updating section of the server docs for more info. |
| /KioskLevel=3 |
All |
1=basic, 2=remote monitoring, 3=full. |
| /SetShell=1 |
All |
0=no, 1=yes, set shell during installation. |
| /KWShell=1 |
All |
0=set Explorer (Windows default) as shell, 1=set KioWare as shell. Only valid when SetShell=1. |
| /ShellUser=KioWareUser |
All |
Username of account to assign shell to. |
| /ShellPass=secret |
All |
Password of user account to assign shell to. |
| /ShellDom=domain1 |
All |
Domain of user account to assign shell to. Do not use if domain is local machine. |
| /D=c:\my programs\ |
All |
path to install KioWare. MUST be capitalized and if used, must ALWAYS be the last command line argument. |
Note:
-
/D must always be the last command line argument. Do not include any quotes, even if path contains spaces.
-
/D and /S must be capitalized. Probably a good idea to capitalize everything for consistency.
-
/XMLURL is used to define the XML file to download. /RUNNOW must be specified to actually download the XML file and configure KioWare.
-
If the installation isn't working properly, then check the event log for clues. Don't hesitate to contact our technical support team at support@kioware.com or 877 843-4790.
Examples
demo-KioWareSetupKiosk-63031.exe /S /TN=-1234567 /AC=1234 /REGISTER=1 /KioskLevel=3 /kn=Store2 /un=1a
demo-KioWareSetupKiosk-63031.exe /S /XMLURL="http://hostname/file.xml" /RUNNOW=1 /KioskLevel=3 /LICENSE_TYPE=volume /LICENSE_KEY="1234" /COMPANY="Company 1" /kn=Store2 /un=1a
Uninstaller Parameters
The uninst.exe program also has flags for options when uninstalling.
| Switch=[value] | Description |
| /S |
Silent mode. |
| /RemoveRegistry=1 |
Delete registry settings as well as files. |
| /RemoveDatabase=1 |
Delete the KioskStats.mdb database file along with normal files. |
| /RemoveCDROMBlock=1 | Unblock cd-rom autorun. |
| /RemoveUSBStorBlock=1 | Unblock USB removable drives (XP only). |
| /DisableAutologon=1 | Turn off Windows autologin. |
Substitution Variables
Some parameters allow certain variable names to be passed in to set settings to machine specific values, such as hostname and IP address.
See Substitution Variables in the Config Tool.
Also see: Automated Licencing
Also see: KioWare Command Line Args