Setup instructions

From Ketarin
Revision as of 15:10, 11 October 2010 by Tomorrow (talk | contribs)

Ketarin allows users to install applications by creating predefined rules.For example user can install many applications in a row silently(no dialogs or manual input).Ketarin only informs the user of the install progress and any warings or errors during install.There are several major installer types which are described below along with their appropriate switches.You can also combine several switches to get the desired result.

Getting Started

First open Ketarin and rightclick on the application you want to modify (Context MenuEditSetup) You will see the following dialog:

MainSetupDialog.jpg

Here you can create,edit and delete setup instructions for your program.In order to create a new instruction press the Add Instuction button. Following 3 choices are presented:

  • Start Process...
  • Copy File...
  • Custom Command...

Start Process... When selecting this option you are presented with the following dialog:

StartProcessDialog.jpg

This dialog allows you to specify a program to start and any switches to forward to this program as well as overwriting system variables should you need it.

Program to start: allows you to select program to run.

Arguments: specify switches to forward.Press the Insert button to add several predefined switches(see full list of possible switches below).


Copy File... When selecting this option you are presented with the following dialog:

CopyFileDialog.jpg

This dialog allows you to copy the application file to specified location after setup is executed for this application.

Source file: This is the file being copied.Default is {file} but you can specify if you want.See Special variables for more info.

Target file: This is a copy of the original file.You can specify environment variable by pressing the Environment button.


Custom Command... When selecting this option you are presented with the following dialog:

CustomSetupInstructionDialog.jpg

This dialog allows you to specify a custom command to run.Please see Commands for examples.

Pressing the Command button allows you to select one of the following items:

  • Batch script - Custom batch script.
  • C# script - Custom C# script.
  • Validate -Validate the current script (C# scripts only).
  • Run - Run the entered command.
  • Inser snippet - Insert a custom saved snippet(select from the menu that opens when clicking this).
  • Save as - Save contents of the window as a snippet.You can create snippets for many generic commands so you won´t have to copy/write them again every time.You can save the current snippet as new or overwrite existing one.
  • Delete snippet - Delete snippet(select from the menu that opens when clicking this).

This concludes the interface part.Now that you have familiarized yourself with how to create and add setup instructions via Ketarin interface, let´s see what type of installers exist and how to use them.

Installer Types

There are several installers types that program authors on companies use.Beware that depending on the type of the installer switches may vary greatly! Since Ketarin is a Windows only program we will only look at installers that support Windows.There are many installers out there but we will cover the most widespeard ones here. It is very likely that most of your programs use one of the following installers.

Name Switches Examples File Extension
Inno Setup (INNO) /VERYSILENT Start Process "{file}" with following arguments: /VERYSILENT .EXE
InstallShield /s Start Process "{file}" with following arguments: /s .EXE
Nullsoft Scriptable Install System (NSIS) /S Start Process "{file}" with following arguments: /S .EXE
Windows Hotfix (MSU) /passive Start Process "{file}" with following arguments: /passive .MSU
Windows Installer (MSI Installer) /quiet

/passive

/q[n|b|r|f]

n - No UI

b - Basic UI

r - Reduced UI

f - Full UI (default)

Start Process "{file}" with following arguments: /qn

Custom Command msiexec.exe /i "{file}" /qn

.MSI
Self-extracting archive (SFX) /s Start Process "{file}" with following arguments: /s .EXE
Ultimate Packer for eXecutables (UPX) -d Custom Command upx.exe -d "{file}" .EXE

Application Installer Types List

So here is a very incomplete list of programs and what installer they use.If the program you want to set up is here then you won´t have to search what installer it uses. If you don´t find what you are looking for in here then use Universal Silent Switch Finder to find out.

Application Name Installer Type
7Zip MSI
AC3Filter INNO
Adobe Shockwave Player NSIS
Advanced Shortcuts Composer INNO
AMD Dual Core Optimizer Installshield
Auto Gordian Knot NSIS
BlueScreenView UPX
CCleaner NSIS
Crysis Warhead Framebuffer Benchmark MSI
CrystalDiskMark INNO
Desktop Icon Restore MSI
Driver Sweeper INNO
Duplicate Cleaner NSIS
EasyBCD NSIS
ESET NOD32 Antivirus MSI
Estonian ID Card MSI
ExplorerView NSIS
FFDShow INNO
Firefox UPX
Fraps NSIS
Gmail Backup NSIS
ImgBurn NSIS
InfranView UPX
ISO Recorder MSI
Jumplist Extender INNO
LockHunter INNO
Logitech Gamepanel Installshield
Logitech SetPoint NSIS
Mega MP3 Split INNO
Microsoft Windows Live Communications Platform Component MSI
Microsoft Windows Live Messenger Standalone MSI
Mp3Tag NSIS
Nokia Software Updater UPX
Notepad++ NSIS
Nvidia PhysX MSI
Open Expert SFX
OpenOffice NSIS
Open With Arguments INNO
Pazera FLV to AVI Converter UPX
Punkbuster Setup UPX
Resource Hacker INNO
Restorator INNO
SD Explorer INNO
SendToToys INNO
ShellExView UPX
ShellMenuView UPX
Smart Defrag INNO
SpyBot Search & Destroy INNO
SpyBot Search & Destroy Standalone Updates NSIS
Universal Extractor INNO
USB Disk Eject UPX
UxStyle Core MSI
VLC NSIS
WGET UPX
Windows 7 Filter Tweaker INNO
Windows 7 Updates Downloader NSIS
XRecode INNO

Installing Applications via Ketarin

Now that you have created setup instructions for you applications let´s take a look how the installation process looks like. In main ketarin window click the Install... button.

When selecting this option you are presented with the following dialog:

AppInstallMainDialog.jpg

Here you can create lists from applications.For example you select all security programs from the right column and select SelectionSave as new list This list is then created and you can give it a custom name on the left column. You can also create a new empty list in the left column by pressing the New button.An empty list is created and you can then start adding programs to it by clicking the Add botton below the right column.


Once you are finished with creating lists you can start installation.For installation you have 2 choices:

  • Install - Install the local copy of the application(s).
  • Update and install - First checks for update.If update is available downloads it and then installs the programs(s).If no update is available the install proceeds as with the 1st option.

If you have problems with download(s) then please refer to Troubleshooting downloads

In either case you are presented with the following dialog:

InstallApplicationsDialog.jpg

Here you can see the progress of the current install(s)and any warnings or errors that occur.


This concludes the Setup Instructions guide.