CyberInstaller - 3. Script Installation
Package CyberInstaller requires an installation script to be used. This script is simply a text file with a. Dat, duly completed (with any editor such as Notepad), which tells the engine installation (CyberInstaller) the steps to be taken during installation, what files to install and record, the interface to display, create links, and everything you need to make the installation as desired.A package, as well as by the script, is also defined by the folder structure.
Note:
To
avoid having to manually perform these tedious, it is highly
recommended (though not essential) to use CyberInstaller
Studio, which through an easy interface cards, will
create the installation package and all the technical details in our
place , in a completely automatic, transparent, and above all without
possibility of error. The use of CyberInstaller
Studio is also essential for the
creation of the
self-extracting executable package.
CyberInstaller - 3. Syntax and description sections
The installation script is the file INSTALL.DAT and should be compulsory in the same folder (same level) is located in Setup.exe (the main file CyberInstaller).
To compile the script properly, it should follow the instructions contained in the same file in the form of comments (lines preceded by ";"). The script is divided into sections, usually corresponding to the steps of package creation of CyberInstaller Studio, and everyone deals with a very specific aspect of the installation process. Changing a section is necessary to follow carefully the notes at the start of each, which lists the possible parameters to use any special commands, and sample code.
Do
not change the lines that indicate the sections, ie those
preceded by ">". The
lines preceded by ";"
comments,
and may be modified/removed/added at will at any point in the script,
outside and inside sections. The only
limitation is to reside in rows reserved for them, that is not next to
commands. The character
"<"
indicates the end
section and must be inserted.
The order of
the sections is not fixed: it can be defined as desired.
Files and
commands can be added to taste after the line of section, with due care
and respecting the syntax (see the comment that precedes it).
The
commands enclosed in "|"
are reserved words and should not be changed. Their meanings are very
precise and explained below.
Use
the following commands to refer to special system paths:
General
(recommended):
|$AppPath$| |
target application to be installed (one confirmed by the user) |
|$AppsToRunPath$| |
folder containing applications to run before/after installation |
|$CommonPath$| |
Common Files folder (usually C:\Program Files\Common Files or Common Files) |
|$FontsPath$| |
folder fonts |
|$ProgramsPath$| |
Programs folder (usually C:\Program Files or C:\Program Files) |
|$SystemPath$| |
System (usually C:\WINDOWS\SYSTEM or C:\WINNT\SYSTEM32) |
|$WinPath$| |
Windows (usually C:\WINDOWS or C:\ WINNT) |
Note: attention to the difference between users for the following commands! If you use the commands related to the current user or all users the value of the section ChooseUserSpecialPath not be taken into account (not recommended).
Related to the selected user at installation (recommended). Itineraries SPA pursuant to section ChooseUserSpecialPath or the user's choice (we recommend you use these commands in order to give the user more control over 'installation):
|$AppDataPath$| |
Application Data |
|$AutoExecPath$| |
Startup group in the Start Menu |
|$DesktopPath$| |
Desktop |
|$DocumentsPath$| |
Documents |
|$ModelsPath$| |
Document Template |
|$StartMenuPath$| |
start menu |
|$StartProgPath$| |
Group Programs in the Start Menu |
|$UserMenuFolder$| |
group in the Start Menu folder selected by the user |
|$UserPatternPath_001$| | extra destination folder, the location specified by the user or read from the register during the installation |
Current user (whatever the user selected at installation) (not recommended):
|$CU_AppDataPath$| |
Application Data |
|$CU_AutoExecPath$| |
Startup group in the Start Menu |
|$CU_CookiesPath$|
|
Cookies |
|$CU_DesktopPath$| |
Desktop |
|$CU_DocumentsPath$| |
Documents |
|$CU_FavoritesPath$| |
Favorites |
|$CU_ModelsPath$| |
Document Template |
|$CU_PrintersPath$| |
print resources |
|$CU_SendToPath$| |
sends |
|$CU_StartMenuPath$| |
start menu |
|$CU_StartProgPath$| |
Group Programs in the Start Menu |
|$CU_UserMenuFolder$| |
group folder in the Start menu selected by the user |
|$U_WebCachePath$| |
Internet cache |
All users (whatever the user selected at installation) (not recommended):
|$All_AppDataPath$| |
Application Data |
|$All_AutoExecPath$| |
Startup group in the Start Menu |
|$All_DesktopPath$|
|
Desktop
|
|$All_DocumentsPath$| |
Documents |
|$All_ModelsPath$| |
Document Template |
|$All_StartMenuPath$|
|
start
menu |
|$All_StartProgPath$| |
Group Programs in the Start Menu |
|$All_UserMenuFolder$| |
group folder in the Start menu selected by the user |
Other special commands:
|%CreateRemovalLink%| |
to use on the LinksToCreate to automatically create a shortcut on the Start Menu (in the group indicated dal'utente) to launch the application removal |
|%CurrentUser%%| |
to use on ChooseUserSpecialPath to select special courses about the user currently logged |
|%AllUsers%| |
be used in the section ChooseUserSpecialPath to select special courses relating to all authorized users in the system |
|%Locked%| |
to use on the ChooseUserSpecialPath to prevent the user changes the settings during installation |
|%AutoConfirmation%| |
be used in
the Components section to specify that prompting the user before
overwriting a component already installed on your system, but the
decision will be made automatically based on file versions (the
component will be installed |
|%AlwaysOverwrite%| | be used in the Components section to specify that any file with the same name in the path destination should be overwritten |
|%NeverOverwrite%| | be
used in the Components section to specify that any file with the same
name in the path destination must never be overwritten, in no case
|
|%Default_value%| | REGKEYS like
to use on the name of a value to indicate that the value specified is
the default for the current key |
|%BLOCKING%| | to use on the MinimumRequirements to mark as blocker and not a requirement, so to enable the installation proceeded |
|%AskConfirm%| | be used in sections LinksToCreate and ExtensionsToAssociate for prompting the user before |
Commands to identify the operating system (for use only in sections that allow them):
|%OS_Win3%| |
Windows 3.1 + extensions Win32s |
|%OS_Win95%| |
Windows 95 |
|%OS_Win95_OSR2%| |
Windows 95 OSR2 |
|%OS_Win98%| |
Windows 98 |
|%OS_Win98_SE%| |
Windows 98 SE |
|%OS_WinME%| |
Windows ME |
|%OS_WinNT3%| |
Windows NT3 |
|%OS_WinNT31%| |
Windows NT31 |
|%OS_WinNT35%| |
Windows NT35 |
|%OS_WinNT4%| |
Windows NT4 |
|%OS_Win2000%| |
Windows 2000 |
|%OS_WinXP%| |
Windows XP |
|%OS_WinXP_SP2%| | Windows XP with Service Pack 2 |
|%OS_Win2003Server%| | Windows Server 2003 |
|%OS_WinVista%| | Windows Vista |
|%OS_Unknown%| |
operating system is not recognized/not detectable |
All controls, as well as the section names, are case-sensitive. So they must be scripted respecting the exact sequence of upper/lower case, because they are recognized correctly.
Section: Look & Feel - Customization CyberInstaller
(Corresponds to step CyberInstaller Studio: 2)
Separate
the names of the parameters from the command with an equal [=] with no spaces.
Parameter
List:
Section: MinimumRequirements - Minimum Regulatory Requirements
(Corresponds to step CyberInstaller Studio: 14)
Separate
the names of the parameters from the command with an equal [=] with no
spaces.
Parameter
List:
Section: ReadOnlyInstall - Perform a read-only, ie without the user being able to change anything? <TRUE|FALSE>
(Corresponds to step CyberInstaller Studio: 1)
Section: SilentInstall - Perform a silent installation, ie without requiring user information? <TRUE|FALSE> <TRUE|FALSE>
(Corresponds to step CyberInstaller Studio: 1)
Section:
MinimumInteractionInstall
-
Perform a minimum of interaction, ie minimizing requests to the user? <TRUE|FALSE>
(Corresponds to step CyberInstaller Studio: 1)
Section:
UpdateInstall
-
Perform an upgrade rather than opens a full installation of the
package? <TRUE|FALSE>
(Corresponds to step CyberInstaller Studio: 1)
Section: Rollback - Activate the system roll-back? <TRUE|FALSE>
(Corresponds to step CyberInstaller Studio: 1)
Section: hidedetails - Hiding the details of installation? <TRUE|FALSE>
(Corresponds to step CyberInstaller Studio: 1)
Section: AppToInstallTitle - Name of application to be installed
(Corresponds to step CyberInstaller Studio: 1)
Section: CompanyName - manufacturer or author
(Corresponds to step CyberInstaller Studio: 1)
Section: Credits - Credits author package (will be displayed in a separate window by clicking on "?")
(Corresponds to step CyberInstaller Studio: 3)
Will be considered only if there is the pattern "[*]" at the end of the manufacturer in the "CompanyName".
Section: Logo - File containing the application logo
(Corresponds to step CyberInstaller Studio: 2)
Section: License - A file containing the license to appear before installation
(Corresponds to step CyberInstaller Studio: 3)
Section: ReadmeFileBefore - File containing notes Preinstallation to appear before installation
(Corresponds to step CyberInstaller Studio: 3)
Eg:
Note.txt
Section:
DefaultDestinationFolder - Destination Folder default
<path>
/ [<path read registro: key\value name>]
(Corresponds to step CyberInstaller Studio: 5)
Eg:
|ProgramsPath|\CyberInstaller
Suite /HKEY_CURRENT_USER\Software\Corel\Paint
Shop Pro\10\Browser\Browsed
Section:
ExtraDestinationFolder
-
Destination folder extra to give the custom pattern
"|$UserPatternPath_001$|"
<description>/<Windows
(percorso absolute or pattern)>/[<registry key\value
name>]/<visibile TRUE|FALSE>/[<Only
reading TRUE|FALSE>]
(Corresponds to step CyberInstaller Studio: 5)
Eg:
Folder
on
the server: /G:\USER_FOLDER\Test / / TRUE
Folder
on
the server: //HKEY_LOCAL_MACHINE\Software\SilverCyberTech\dbpath / TRUE
/ FALSE
Folder
on
the server:
/G:\USER_FOLDER\Test/HKEY_LOCAL_MACHINE\Software\SilverCyberTech\dbpath
/ TRUE / FALSE
Folder
on
the server: //HKEY_CURRENT_USER\Software\Corel\Paint Shop
Pro\10\Browser\Browsed / TRUE / FALSE
Section:
FoldersToCreate - Files/directories to be created
(if not already exist)
<complete
path>
(Corresponds to step CyberInstaller Studio: 5)
Example
If
the data folder contains a subfolder AddIns which in turn contains only
folders
(and
no files), or is completely empty, you must create it:
|AppPath|\AddIns
to
make sure that the folder "Dao" exists in its usual position and
If
not create it, put these four lines:
|ProgramsPath|
|CommonPath|
|CommonPath|\Microsoft
Shared
|CommonPath|\Microsoft
Shared\Dao
to
create the folder "Tools" in the Start Menu enter:
|StartMenuPath|\Tools
to
create the folder "Tools" folder in the Start Menu Programs include:
|StartProgPath|\Tools
to
create the folder "Tools" folder of the Start Menu group chosen by the
user (wherever it is) to include:
|UserMenuFolder|\Tools
Section:
AppsToRunBefore - Applications to be executed before
the installation itself
<description
estesa>/<blank of comando: executable
|{parametri}|>/<sincrona
TRUE|FALSE>/<conferma execution
TRUE|FALSE>/|<condition>|
(Corresponds to step CyberInstaller Studio 8)
Eg:
EasyBudget
1.7/|$AppsToRunPath$|\EasyBudget\EasyBudget.exe/FALSE/TRUE
Microsoft MDAC
3.5/|$AppsToRunPath$|\MDAC.exe/TRUE/FALSE/HKEY_LOCAL_MACHINE\SOFTWARE\Classes\MDACVer.Version\CurVer
Notepad/|$WinPath$|\Notepad.exe/TRUE/TRUE
Setup
DirectX/|$AppsToRunPath$|\DX\Setup.exe/TRUE/FALSE/|SystemPath$|\DirectX
Driver
XP/|$AppsToRunPath$|\Drivers\WinXP\Setup.exe/TRUE/TRUE/|%OS_WinXP%|
Setup DirectX/|$AppsToRunPath$|\DX\Setup.exe {/silent /c -copy
|$AppPath$|}/TRUE/FALSE/|SystemPath$|\DirectX
Notepad/|$WinPath$|\Notepad.exe/TRUE/FALSE/|%OS_WinXP%|
Notepad/|$WinPath$|\Notepad.exe
{|$WinPath$|\dasetup.log}/TRUE/FALSE
Notepad/|$WinPath$|\Notepad.exe
{|$WinPath$|\dasetup.log}/TRUE/FALSE/|%OS_WinXP%|
Section:
Components - List data package (components) to be
copied to the specified folder
<filename>
/ <path destinazione> / <to register: (one line)
<filename> / <path destinazione> /
<da registrare: TRUE|FALSE> / <copy mode: [|%%
AutoConfirmation |] [|% AlwaysOverwrite %|][|% NeverOverwrite
%|]>/
<Side-by-Side:
TRUE|FALSE> / <eseguibile associated with
Side-by-Side> / <categoria> / removal: TRUE |
FALSE>
(Corresponds to step CyberInstaller Studio: 6)
Section:
Fonts
-
List fonts to be installed
<name
font> / <filename>
Section:
REGKEYS - keys / values to be created in the Windows
registry
<key>
/ [<value name>] / [<value>]
(Corresponds to step CyberInstaller Studio: 10)
Section:
ExtensionsToAssociate - Extensions to associate
<extends>
/ <Fully executable file that will trigger l'estensione>
/ [<conferma>]
(Corresponds
to step CyberInstaller Studio: 11)
Eg:
associate
the. EBB application "EasyBudget"
EBB
/ |$AppPath$|\ EasyBudget.exe
associate
the. CSP application "CyberInstaller Studio":
CSP
/ |$AppPath$| \ CyberInstaller Studio.eXe
associate
the. BMP application "NewPaint" Prompt the user:
BMP
/ |$AppPath$| \ NewPaint.exe / |%AskConfirm%|
Section:
AttribsToSet - Attributes to be set
<Fully
file/cartella> /
<N(normale)|H(nascosto)|S(sistema)|R(sola
lettura)|A(archivio)>
(Corresponds to step CyberInstaller Studio: 12)
Eg:
|AppPath|
\ EasyBudget.exe / N
|AppPath|
\ Init.ini / HRSA
|AppPath|
/ HR
Section:
ChooseUserSpecialPath - Select users to whom you
refer special routes:
<How
selection username>/[|Locked |]
(Corresponds to step CyberInstaller Studio: 1)
Allowable
values are two:
- |%CurrentUser%| to
select the path of the user currently logged
- |%AllUsers%| to
select the path of all authorized users in the system
If not enter
a command |%Locked%|
the user can not change this value during installation.
The default,
if none has been specified, is: |%CurrentUser%
|.
In the case of installation on systems configured as a single-user setting will be bypassed, using always only the current user's Start menu.
Section:
LinksToCreate - Links to create:
<destination>
/ name> collegamento> / <Fully file
puntato> / [<(command line confirming creation
}>]/[<>]
(Corresponds to step CyberInstaller Studio: 11)
Eg:
$DesktopPath$|/CyberInstaller
Studio/|$AppPath$|\Studio\CyberInstallerStudio.exe//|%AskConfirm%|
|$UserMenuFolder$|/Aggiornamenti
on-line/|$AppPath$|\Updater\CISUpdater.exe
|$UserMenuFolder$|/CyberInstaller
Studio/|$AppPath$|\Studio\CyberInstallerStudio.exe
|$UserMenuFolder$|\Documentazione/Edizioni -
Licenze/|$AppPath$|\Documentazione\Edizioni - Licenze.txt
|$UserMenuFolder$|\Documentazione/Licenza/|$AppPath$|\Documentazione\CyberInstaller
Suite - Licenza.txt
|$UserMenuFolder$|\Documentazione/Manuale in
linea/|$AppPath$|\Help\0001.htm
|$UserMenuFolder$|\Documentazione/Manuale sintetico
(aggiornato)/|$AppPath$|\Documentazione\CyberInstaller Suite - Manuale
sintetico.txt
|$UserMenuFolder$|\Documentazione/Note di
rilascio/|$AppPath$|\Documentazione\CyberInstaller Suite - Note di
rilascio.txt
|$UserMenuFolder$|\Documentazione/Leggimi/|$AppPath$|\Documentazione\CyberInstaller
Suite - Leggimi.txt
|$UserMenuFolder$|\Risorse
Web/CyberBlog/|$AppPath$|\Documentazione\Risorse Web\CyberBlog.url
|$UserMenuFolder$|\Risorse Web/CyberInstaller su
VB-T&T/|$AppPath$|\Documentazione\Risorse Web\CyberInstaller su
VisualBasicT&T.it.url
|$UserMenuFolder$|\Risorse Web/Forum
ufficiale/|$AppPath$|\Documentazione\Risorse Web\Forum ufficiale.url
|$UserMenuFolder$|\Risorse Web/SilverCyberTech (sito
ufficiale)/|$AppPath$|\Documentazione\Risorse Web\SilverCyberTech (sito
ufficiale).url
|%CreateRemovalLink%|
Section: ReadmeFileAfter - File containing the release notes to be displayed after the installation
(Corresponds
to step CyberInstaller Studio: 3)
Must be
contained in the data folder (you can refer to any)
Eg
Readme.txt
Section:
AppsToRunAfter - Applications to be executed after
the installation itself:
<description
estesa> / <blank of comando: executable
|{parametri}|>/<sincrona TRUE|FALSE> /
<conferma execution TRUE|FALSE>
/|<condition>|
(Corresponds to step CyberInstaller Studio 8)
Eg:
asyBudget
1.7/|$AppsToRunPath$|\EasyBudget\EasyBudget.exe/FALSE/TRUE
Microsoft MDAC
3.5/|$AppsToRunPath$|\MDAC.exe/TRUE/FALSE/HKEY_LOCAL_MACHINE\SOFTWARE\Classes\MDACVer.Version\CurVer
Notepad/|$WinPath$|\Notepad.exe/TRUE/TRUE
Setup
DirectX/|$AppsToRunPath$|\DX\Setup.exe/TRUE/FALSE/|SystemPath$|\DirectX
Driver
XP/|$AppsToRunPath$|\Drivers\WinXP\Setup.exe/TRUE/TRUE/|%OS_WinXP%|
Setup DirectX/|$AppsToRunPath$|\DX\Setup.exe {/silent /c -copy
|$AppPath$|}/TRUE/FALSE/|SystemPath$|\DirectX
Notepad/|$WinPath$|\Notepad.exe/TRUE/FALSE/|%OS_WinXP%|
Notepad/|$WinPath$|\Notepad.exe
{|$WinPath$|\dasetup.log}/TRUE/FALSE
Notepad/|$WinPath$|\Notepad.exe
{|$WinPath$|\dasetup.log}/TRUE/FALSE/|%OS_WinXP%|
Section: RebootWindows - Restart the computer after installing? <TRUE|FALSE>
(Corresponds
to step CyberInstaller Studio: 1)
The default,
if no command is specified (TRUE
| FALSE) is FALSE.
See also ...
Integrated
editor
CyberInstaller
- core files and folder structure
Step
1: General Parameters
Step
2: Interface CyberInstaller
Step 10: Keys and values of log
Step 11: Association extensions