During a project check or build, Tarma QuickInstall performs extensive preflight checks to detect situations that might lead to errors or unintended results when your application is installed by the customer. Any questionable situations are flagged with a message in the Diagnostic messages area; they are also copied to the build log file. The Diagnostic messages section contains descriptions for all diagnostic messages that Tarma QuickInstall produces, along with suggested remedies.
Tip - To view the explanation of a message, click on the
next to the message.
Warning - Although Tarma QuickInstall detects many common problems, it cannot possibly cover all potentially problematic situations. Therefore, be sure to test your Setup package thoroughly before distributing it to your customers.
Messages in the Diagnostic messages area have the following format:
icon Name: Message
Click this icon to get help for the associated message. See below for a full list of messages.
The icon indicates the severity of the message. The following icons and severity levels are defined.
Informational - The
message is for information only and does not denote a problem.
Warning - The
message refers to a situation that is questionable or may have a different result
than you intend, although Setup will probably be able to complete the installation
process. You should double-check the situation, and either correct it or test
the resulting Setup package very carefully.
Error - The
messages describes a problem that will cause Setup almost certainly to fail
during the installation process. You must correct the problem before Tarma QuickInstall
will produce a Setup package.
Redirected
output - The message consists of output produced by an external program
during the build process (for example, SignCode.exe). Tarma QuickInstall does
not try to interpret this output (although it will use the exit code from the
external program), so you should double-check the message text to convince
yourself that there is no hidden problem.
The Name portion displays the name of the installation item or page to which the message applies. Diagnostic messages are linked to that item or page, and left-clicking on the message displays the relevant page and item.
This is the actual message text; see below for the full list.
The following is a complete list of Tarma QuickInstall's diagnostic messages in alphabetical order. Note that many messages contain "name" or similar pieces of text; they are placeholders for names that are filled in when Tarma QuickInstall generates the message.
(Default) values must be REG_SZ on Windows 95
Absolute application folder specified - consider using <ProgramFiles>\<AppTitle>
Added "name" ("n" bytes) to TIZ archive
Administrator rights strongly recommended for Uninstall previous
App Paths executable "name" should be MZ EXE file
App Paths registration requested, but no executable path specified
App Paths registration requested, but no path list specified
App Paths registration requires Administrator rights on NT4/2000/XP
Application folder is undefined
Application run path is undefined
Application title is undefined
Application version is undefined
Building distribution package "language" ("code")
Building distribution tree in "name"
Building TIZ archive "name" failed
Building TIZ archive "name"
Cannot copy installation file "name"
Cannot create Extension DLL file "name"
Cannot create INI file "name"
Cannot create INI file division "name"
Cannot create INI file header
Cannot create INI file section "name"
Cannot create language DLL file "name"
Cannot create memory image for "name"
Cannot flush TIZ archive buffer
Cannot generate password
Cannot generate ZAP file
Cannot load icon file "name"
Cannot load image file "name"
Cannot load REGEDIT4 file "name"
Cannot map file "name" for TIZ archive
Cannot obtain file info "name" for TIZ archive
Cannot save ZAP file "name" - check R/O status and access rights
Cannot write TIZ header
Code signing completed - "name"
Company name is undefined
Copying installation file "name"...
Copyright notice is undefined
Custom shortcut folder selected, but no folder specified
Customer registration has no effect without registry key or Extension DLL
Customer registration registry key path is empty
Customer registration registry key path is invalid
Customer registration requested, but no fields specified
Customer registration validation requires Extension DLL
Distribution tree "name" successfully created
Duplicate installation name - use "Install as", or specify non-overlapping target platforms or languages
Duplicate key name - change name, section, file, or target platforms
Duplicate name for same target platform(s) - change name or target platforms
Duplicate shortcut title - change title or platforms of target file
Email address is undefined
Environment variable has no name
Environment variable has no value
Environment variable should probably be appended, not overwritten
Error "n" while copying "name" to "name"
Error "n" while creating distribution folder "name"
Error "n" while creating TIZ archive "name"
Error "n" while opening TIZ archive "name"
Error "n" while seeking to end of TIZ archive "name"
Error mapping stub file "name"
Error while adding "name" to TIZ archive
Error while loading extension DLL "name
Error while saving information to INI file
Expression "text" contains path separator(s) (not allowed here)
Expression "text" does not match indicated value type
Expression "text" exceeds maximum recursion level (self-recursive?)
Expression "text" refers to Setup source folder - might not be available after installation
Expression "text" resolves to file path (not allowed here)
Expression "text" resolves to registry path (not allowed here)
Expression "text" should resolve to file path
Expression "text" should resolve to registry path
Expression "text" starts with a non-root variable
Extension DLL "name" does not handle INIT
Extension DLL "name" does not handle TERM
Extension DLL "name" INIT failed with result "code"
Extension DLL "name" INIT succeeded with result "code"
Extension DLL "name" returned incorrect version "ver"
Extension DLL "name" returned version "ver"
Extension DLL "name" TERM failed with result "code"
Extension DLL "name" TERM succeeded with result "code"
Extension DLL requested, but no path specified
File "name" is not an icon file
File contains debug information - do you really want to distribute this?
File contains DllRegisterServer() - should it be registered with it?
File contains font(s) - should they be registered?
File contains TYPELIB - should it be registered with /RegServer?
File does not contain self-registration info - cannot be registered or unregistered
File does not support this self-registration mode - select different one
File is a program - can only be registered with /RegServer
File size is 0 - is this intentional?
Files with wildcard specifications cannot be (un)registered
Folder "name" does not exist on 95/98/Me
Folder "name" does not exist on NT4/2000/XP
Font name not found - are you sure this is a Windows font?
Header image requested, but no image path specified
Icon file "name" does not contain 16x16x16 icon image
Icon file "name" does not contain 32x32x16 icon image
Icon file "name" does not contain 48x48x256 icon image
Image file "name" is not a supported BMP format
Image file "name" uses advanced compression (JPEG, PNG) - not supported on 95/NT4
Image file "name" uses more than 16 colors - result depends on video mode
Incomplete variable(s) in "name"
INI file key has no data
INI file key has no INI file path
INI file key has no key name
INI file key has no section name
Installation action has no target path
Installation action has no title
Installation action prompt is empty
Installation action uses installed file - must run after file installation and before removal
Installation folder "name" contains no files or subfolders
Installation folder has absolute path - consider using <AppFolder> instead
Installation folder has no path
Installation into a system folder might cause problems
Installs to personal folder "name" - does not require sharing count
Installs to shared folder "name" - should use sharing count
Invalid object
Invalid registration mode
License text "number" not found
Marked for non-target platform "name"
Multilingual capabilities requested, but no languages selected
No Administrator rights requested on NT4/2000/XP - this may cause installation problems
No associated REGEDIT4 file specified
No error - you should not see this
No file actions specified - is this intentional?
No installation files specified for target platform "name"
No installation files specified
No installation languages specified
No installation platforms specified
No output folder specified
No output path specified
No registry value actions specified
No source file specified
No target platforms specified
No text variants provided
No VERSIONINFO - "Newer" installation will depend on date/time stamp
Not an installation file - cannot check self-registration
Not marked for any target platform
One or more customer registration "Store as" names are empty
One or more customer registration field labels are empty
One or more files marked for registration on NT4/2000/XP - Administrator rights strongly recommended
One or more of the variable(s) in "name" are not allowed here
Opened build log file "name"
OpenType, TrueType collections, Type 1 fonts are not supported on 95/98/Me/NT4
Out of memory
Password key length must be > 0 for automatic generation
Password string is empty
Password used for encryption is "name"
Path "name" contains invalid file name characters
Path "name" contains invalid file path characters
Performing preflight check...
Preflight check completed; building distribution "name"
Primary and alternate values resolve to different types
Program group installation for All Users requires Administrator rights on Windows NT4
Program group requested, but contains no shortcuts
Program group requested, but no program group title specified
Program group shortcuts requested, but no program group specified
Project build was cancelled by the user
Readme path is undefined
Readme text "number" not found
Recommended location for registered fonts is <FontsDir>
REGEDIT4 file "name" not found
Registry key has no name
Registry value installed in system hive - Administrator rights strongly recommended on NT4/2000/XP
Registry value size is 0 - is this intentional?
Registry value type is REG_NONE - may cause installation problems
Removing previous distribution tree from "name"
Required variable(s) missing in "name"
Root variable used internally in "name"
Running SignCode.exe to sign distribution file...
See previous message - this is the duplicate
Setup icon requested, but no icon path specified
Setup.ini script saved to "name" for diagnostic purposes
Shortcut has no locations specified - it will not be installed
Shortcut has no target path
Shortcut has no title
Shortcut installation for All Users requires Administrator rights on Windows NT4
SignCode wizard was started - code signing result unknown
Skipped "name" - not marked for installation
Source file "name" included more than once - is this intentional?
Source file "name" not accessible
Source file "name" not found
Expression "text" exceeds maximum recursion level (self-recursive?)
Stub file "name" does not have VERSIONINFO - did you install Tarma QuickInstall properly?
Stub file "name" has incorrect version "v1" (expected "v2")
Stub file "name" is invalid or damaged
Support telephone number is undefined
Symbol is required by installer and should not be private
Synchronous installation action has very short time-out
System folder - Administrator rights strongly recommended on NT4/2000/XP
Text variant is empty
This file type will only run on 95/98/Me
This file type will only run on NT4/2000/XP
This is the DEBUG version - do not distribute!
TIZ archive "name" successfully created
TIZ compression "n" => "n" bytes (p%)
Treat warnings as errors set and warnings detected - stopping build
TRIAL license - Setup package will only run on your own system
TYPELIB - should it be registered with RegisterTypeLib()?
Unconditional Reboot requested - per-file/action Reboot flag recommended instead
Undefined variable "name"
Uninstall previous requested, but no key specified
Uninstaller key is undefined - no uninstaller will be registered
Uninstaller registration is suppressed - application cannot be removed easily
Uninstaller requested, but title is undefined
Unknown error in variable "name"
Using "name" as installer stub
Variable expansion may behave differently on 95/98/Me than on NT4/2000/XP
Web site URL is undefined
Welcome image requested, but no image path specified
WinHelp file - should it be registered?
ZAP file saved as "name"