manualshive.com logo in svg

Symantec ALTIRIS INVENTORY 7.0 SP2 - FOR NETWORK DEVICES V1.0, Installation Manual

Symantec ALTIRIS INVENTORY 7.0 SP2 - FOR NETWORK DEVICES V1.0 offers a comprehensive manual for effective network device management. Packed with valuable information, this free user manual can be easily downloaded from our website. Take control of your network devices and maximize their performance with this essential resource.

Share
Download
background image

WiseScript Package Editor Reference

159

Quick Reference

 

DLG_EVENT_TYPE

Used for custom dialog box scripts. Built-in dialog box 
events are INIT, UPDATE, VERIFY.

See 

Creating a Custom Dialog Box Script

 on page 144.

FONTS

Path to the directory where fonts should be installed.

HELPFILE

Used by custom dialog boxes to display a help context. Set 
this to the full path of the help file. We recommend that 
you do not change this variable.

INST

Path to the directory containing the installation .EXE. We 
recommend that you do not change this variable.

INST_LOG_PATH

Full path in which to place Install.log at end of installation.

INSTALL_RESULT 
(read-only)

Holds the result of the last action performed for Install 
File(s), Copy Local File(s), Edit INI, and Execute Program 
actions. (This variable is similar to PROCEXITCODE.)

Install File(s) and Copy Local File(s) return:

z

V = Version. Replacement option was set to check 
version, and the version being installed was not 
newer.

z

D = Date. Replacement option was set to check Date/
Time and the condition was not met.

z

E = Exists. Replacement option was Never, and the file 
exists.

z

I = Install on restart. The file was in use and will be 
installed on restart. (RESTART variable also set to “S”)

z

A null value signals success.

If the file specification is a wildcard, the value represents 
the last file copied or installed.

Edit INI File returns: E if the file could not be written, or 
null if the edit was successful.

Execute Program returns: the numeric exit code (return 
code) from the called application.

LANG

The language the end user selects in a multi-language 
installation. We recommend that you do not change this 
variable.

PASSWORD

Set this to the password to be used for password-
protected files. Setting this variable disables the password 
prompt. Set this for distributions that do not use 
prompting.

PROCEXITCODE (read-
only)

Holds the result of the last Execute Program action. (This 
variable is similar to INSTALL_RESULT.) After an Execute 
Program script action, this returns the exit code (return 
code) from the called application.

Variable

Description

Summary of Contents for ALTIRIS INVENTORY 7.0 SP2 - FOR NETWORK DEVICES V1.0

Page 1: ...WiseScript Package Editor Reference ...

Page 2: ...ND WARRANTIES INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT ARE DISCLAIMED EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID SYMANTEC CORPORATION SHALL NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING PERFORMANCE OR USE OF THIS DOCUMENTATION THE INFORMATION CONTAINED IN THIS DOCU...

Page 3: ...on a regional business hours or 24 hours a day 7 days a week basis z Premium service offerings that include Account Management Services For information about Symantec s support offerings you can visit our web site at the following URL www symantec com business support All support services will be delivered in accordance with your support agreement and the then current enterprise technical support ...

Page 4: ...t information about product updates and upgrades z Information about upgrade assurance and maintenance contracts z Information about the Symantec Buying Programs z Advice about Symantec s technical support options z Nontechnical presales questions z Issues that are related to CD ROMs or manuals Support agreement resources If you want to contact Symantec regarding an existing support agreement plea...

Page 5: ...threats Consulting Services Symantec Consulting Services provide on site technical expertise from Symantec and its trusted partners Symantec Consulting Services offer a variety of prepackaged and customizable options that include assessment design implementation monitoring and management capabilities Each is focused on establishing and maintaining the integrity and availability of your IT resource...

Page 6: ...on Messages 24 Setting Preferences 25 Downloading Application Runtimes 26 Chapter 3 Installation Management 28 Changing Source Directories 28 Converting to UNC Based Source File Paths 29 Converting to Relative Source File Paths 29 Using Self Repair 30 Language Support 31 Processes for Adding Language Support 32 Distributing an Installation 34 Copying an Installation to a Network Directory 34 Copyi...

Page 7: ...ce Settings 73 Shortcuts 74 Editing Shortcut Details 75 SmartPatch 76 System Requirements 77 System Search 78 Searching for Files or Directories 79 Searching for INI Values 80 Searching for Registry Values 81 Uninstall 81 Adding Additional Commands for the Uninstaller 82 WebDeploy 83 The WebDeploy Process 83 Creating a WebDeploy Installation 84 Uploading a WebDeploy Installation to the Web 86 Wise...

Page 8: ...nts 115 Chapter 7 WiseScript Actions 116 About WiseScript Actions 119 About SVS Script Actions 119 Activate SVS Layer 121 Add Directory to PATH 121 Add File to SVS Layer 121 Add Text to INSTALL LOG 122 Add to AUTOEXEC BAT 123 Add to CONFIG SYS 124 Add to SYSTEM INI 125 Browse for Directory 125 Call DLL Function 126 DLL Parameter Settings 128 Passing Complex Structures to a DLL An Example 130 Captu...

Page 9: ...xit Installation 164 Export SVS Layer 165 Find File in Path 165 Find First SVS Layer 166 Find Next SVS Layer 166 Find SVS Layer GUID 166 Get Environment Variable 167 Get Name Serial Number 167 Get Registry Key Value 168 Get SVS Layer Info 168 Get System Information 170 Get Temporary Filename 171 Get Windows Installer Property 172 Halt Compilation 172 If Statement 173 Import SVS Layer 173 Include S...

Page 10: ...vice 200 While Statement 200 Win32 System Directory 201 Wizard Loop 201 Chapter 8 Creating Custom Dialog Boxes 203 About Dialog Boxes 203 About the Custom Dialog Editor 203 Adding a Dialog Box to the Installation 204 Editing Dialog Boxes 205 Editing Dialog Box Templates 205 Setting Dialog Box Properties 206 About Dialog Box Controls 207 Adding and Editing Dialog Box Controls 208 Adding Check Box C...

Page 11: ...llboard 234 Editing Billboard Text Objects 235 Editing Billboard Line Objects 235 Editing Billboard Rectangles and Ellipses 236 Editing Billboard Polygon Objects 237 Editing Billboard Bitmap Objects 237 Resizing Moving and Aligning Billboard Objects 238 Setting Billboard Properties 239 Chapter 10 Tools 241 About WiseScript Package Editor Tools 241 ApplicationWatch 241 Import Visual Basic Project 2...

Page 12: ...f Installation Expert lets you configure a specific aspect of your installation For advanced customization you can edit the installation script in Script Editor which provides a powerful and easy to use scripting environment based on the WiseScript scripting language You create and edit lines in the script by setting options in dialog boxes which decreases the chances of syntax or other errors Wis...

Page 13: ...on the destination computer while the script is running z Built in rollback WiseScripts can be rolled back after they are executed on the destination computer z User interface WiseScripts can incorporate any type of dialog box to either inform the end user or prompt for input z WiseScript is powerful In addition to the dozens of predefined actions WiseScripts can call VBScripts and DLL functions m...

Page 14: ...ting an installation 1 Create a new installation or WiseScript See Starting the Software on page 15 2 WiseScript Package Editor only Set options on the Installation Expert pages to create basic installation functionality See About Installation Expert on page 38 3 Edit the script in Script Editor to create advanced installation functionality See About Script Editor on page 96 and About WiseScript A...

Page 15: ...allation packages based on the WiseScript scripting language 1 Select Start menu Programs Symantec Wise Installation Studio WiseScript Package Editor 2 Select File menu New The New Installation File dialog box appears 3 Select one of the following Empty Project Create an installation project file based on the Empty Project wse installation template It contains a default script in which the basic e...

Page 16: ...tion Expert lets you build an installation by pointing and clicking to fill out options See Using Installation Expert on page 38 z Script Editor Script Editor provides a powerful and easy to use scripting environment based on the WiseScript scripting language See About Script Editor on page 22 Script Editor lets you develop more complex installations Also use it to create powerful EXEs to use as c...

Page 17: ...ws Installer Installation Windows Installer Editor compiles installations into Windows Installer MSI format Therefore it can provide only those capabilities that are provided by the Windows Installer SDK environment WiseScript Package Editor provides an additional authoring environment that has a larger selection of more versatile script actions than those provided by Windows Installer products Yo...

Page 18: ...Preferences on page 25 z Test Click Test to compile and run the installation in test mode In test mode the installation performs all script actions without actually installing or modifying files However if any script lines are dependent on files being installed by previous script lines then test mode might fail Example If an Install File s line copies a ReadMe to the Temp directory and a second sc...

Page 19: ...elp using the operating system consult its user documentation Use the following sources of information to learn about this product Note This documentation covers both WiseScript Package Editor and WiseScript Editor WiseScript Editor contains the same scripting interface as WiseScript Package Editor but it does not contain the Installation Expert interface or other installation development tools Th...

Page 20: ...ion Release Notes The product release notes cover new features enhancements bug fixes and known issues for the current version of this product To access the release notes select Release Notes from the Symantec program group on the Windows Start menu ...

Page 21: ...re defined view of page groups or creating your own view See Customizing Installation Expert Page Groups on page 23 z Change prompts and error messages displayed by the installation See Editing Installation Messages on page 24 z Set preferences See Setting Preferences on page 25 z Set the actions list in Script Editor to display only those actions you use most frequently and add your own actions t...

Page 22: ...ritten during upgrades Instead save customized templates with different names or make copies of the predefined templates and edit the copies Template Location Templates are stored in the WiseScript Editor Template subdirectory of this product s installation directory To create a custom template 1 Select File menu New The New Installation File dialog box appears 2 Select Empty Project and click OK ...

Page 23: ...ate but not the predefined sets You also cannot edit page names To add a page group 1 Select Pages menu Customize The Customize Pages dialog box appears 2 From Name select new 3 On the dialog box that appears specify a name for the new set of page groups Include an before a letter to set it as a keyboard shortcut The name appears in the Name drop down list 4 To add a new page group click the Add b...

Page 24: ...t for any other language obtain translations of the message text and enter the translated strings on the Installer Messages dialog box For information on adding language support to an installation see Language Support on page 31 To edit installation messages 1 Select Edit menu Installer Messages The Installer Messages dialog box appears 2 Complete the dialog box Language Name Select the language f...

Page 25: ... on a different computer where the installation directory is C Program Files Wise then you are prompted to redefine the compiler variable _WISE_ to the new WiseScript Editor application location Compiler variables are set on the Compiler Variables page Add Associated Icons and Registry Keys If you mark this when you add a file on the Files page in Installation Expert icons and registry keys that a...

Page 26: ...ies to be used for installations example Windows System and so on whenever the installation is run from within WiseScript Package Editor Shared Directory Normally user defined actions are stored in the WiseScript Package Editor Actions directory Use this field to specify an additional directory to hold user defined actions This can be a local or shared network directory The actions stored in this ...

Page 27: ...ect Runtime page mark the check box for each runtime you want to download You can click Select All to select all the runtimes or click Clear All to clear your selections As you mark check boxes the Download Size field displays the total size of the files you selected 5 When you finish selecting runtimes click Next The Start Update Download page appears 6 Click Next to begin the download The select...

Page 28: ...ation in this document does not apply to WiseScript Editor WiseScript Package Editor only As you work on an installation paths to files in the installation can become note valid if you z Move files that are part of the installation to a new directory on your computer or network z Move the installation file itself from your computer to another computer z Use relative paths and then move the install...

Page 29: ...twork can open and compile the script without encountering errors Instead of a path such as Y Application ini a file has a fully qualified path such as Server Development Application Application ini 1 Select Edit menu Source Directories The Change Source Directories dialog box appears and lists all the directories referenced in the script 2 From Type select Change source paths to UNC paths 3 Click...

Page 30: ...absent and the application is started by means of its shortcut a self repair process is started Self repair can only be run under the same user account under which the application was originally installed During self repair the installation re edits the registry re edits or recreates INI files reinstalls all files and re self registers files Self repair works only if the destination computer is ru...

Page 31: ... the end user clicks the shortcut that runs the application the shortcut runs unwise exe the uninstall program with special command line options Unwise exe checks that the required items are present If they are unwise exe opens the application The end user does not see this and if the number of required items is few the extra time to start is negligible If the required items are not present unwise...

Page 32: ...r Adding Language Support WiseScript Package Editor only You can add language support to an installation which provides the text in the installation s user interface elements in a different language Adding Language Support for a Pre Translated Language 1 In Installation Expert Languages page add the language and mark its check box See Languages on page 60 2 If you have added custom dialog boxes to...

Page 33: ...g the Uninstall Dialog Boxes Text for the uninstall dialog boxes is stored in text files in the WiseScript Editor Language subdirectory of this product s installation directory The three letter language codes are used as the file extensions Note Changes that you make to dialog boxes and script action text are added to the current installation only To make the dialog box translations available to f...

Page 34: ...hanged to the new paths during this process These paths are not relative however you can use relative paths in a project file See Changing Source Directories on page 28 When you run Package Distribution from a WSE it is compiled and the resulting EXE is distributed To copy a WSE with its ZAP PDF or SMS file select the Compiled package option on the Distribution Method page To copy a package to a n...

Page 35: ...buted To copy an installation to an FTP server 1 Select File menu Distribute The Distribution Method page appears 2 Mark FTP Server 3 Click Next If necessary the installation file is saved and compiled The FTP Server page appears 4 Complete the page FTP Server Address The address of the FTP server to transfer the package files to Example ftp server com FTP Logon Name A valid logon name for this FT...

Page 36: ...WiseScript Package Editor Reference 36 Installation Management ...

Page 37: ... on page 48 z Dialogs on page 48 z Digital Signature on page 20 z File Associations on page 51 z Files on page 52 z Fonts on page 57 z General Information on page 21 z INI Files on page 58 z Installation Log on page 60 z Languages on page 60 z Media on page 62 z Microsoft SMS on page 62 z ODBC on page 63 z Online Registration on page 63 z Password on page 64 z Product Details on page 65 z Progress...

Page 38: ... Using Installation Expert on page 38 Installation Expert does not appear in the embedded WiseScript Editor interface However several Installation Expert pages are needed to provide support for certain WiseScript actions z Compiler Variables z Digital Signature z General Information These pages are provided in the Project Settings view See About the Project Settings View on page 40 Note This docum...

Page 39: ...efine a specific aspect of the installation Examples On the Files page you define what files are included in the installation On the Registry page you define what registry keys and values are created on the destination computer Complete only the pages that are pertinent to your particular installation in any order If required information is missing an error message appears during compile z Use on ...

Page 40: ... Directory page to create a ZAP file You need a ZAP file to distribute EXEs through Microsoft Active Directory The ZAP file is created in the same directory as the installation EXE Microsoft Active Directory uses the information in the ZAP file to distribute the EXE Before you complete the Active Directory page complete the Product Details and Add Remove pages Some of the fields on the Active Dire...

Page 41: ...e icons To see the icons in a file go to Windows Explorer right click any shortcut file and select Properties Click the Shortcut tab then click Change Icon The Change Icon dialog box appears It contains a graphical list of icons for the file The icon number of the first icon is 0 the icon number for the second is 1 and so on z Hide Change Remove button Mark this to disable the Change and Remove bu...

Page 42: ...rt Billboards page 2 Click Add at the right of the page and specify the billboard graphic file The billboard is added to the list on the Billboards page 3 Double click the billboard The Billboard Settings dialog box appears 4 Complete the dialog box Pathname Specify the full path to the image file on your computer To use variables in this field you must mark the Local Graphic option below X Positi...

Page 43: ...ter With this option you can use variables in the Pathname field above Example INST to indicate the directory from which the installation EXE is running Use this to change graphics without rebuilding the EXE 5 Click OK The end user sees the billboards in the order in which they appear on the Billboards page To rearrange billboards click Move Up and Move Down at the right of the page See also Displ...

Page 44: ...allation EXE so the installation can be placed on floppy disk s You can exclude individual Copy Local Files script actions from conversion by marking their Don t Convert To Floppy check box See Copy Local File s on page 139 z Beep on New Disk Prompt Mark this to cause the compiled installation to beep when requesting a new disk z ZIP Compatible Mark this to make the compiled installation compatibl...

Page 45: ...s a blank script which is typically a custom action this defaults to asInvoker When you start a new WiseScript as an empty project which is typically an installation this defaults to requireAdministrator asInvoker Select this option for a WiseScript that runs as a custom action in an MSI The WiseScript runs with the level of the user who runs the MSI This prevents failure of the MSI due to UAC pro...

Page 46: ...t in the directory structure z Optional SETUP INF Contents Optional Enter or paste additional INF file instructions for running the application Compiler Variables Use the Compiler Variables page to set compiler variables that change the WiseScript during compile You can use compiler variables to include or exclude portions of script from the compiled EXE or to build a debug version of the WiseScri...

Page 47: ...for Compiler Variables is marked on the Compiler Variables page Mark this for variables that you do not expect to change frequently 4 Click OK 5 On the Compiler Variables page mark one of the following Compiling from Command Line Mark this to be prompted for the value of compiler variables when you compile from the command line Use this for automated build processes You can specify compiler variab...

Page 48: ...ting the first component places an A in the variable the second adds a B and so on You can add up to 26 components this way You can edit the installation script and use conditional statements to determine which files are installed when each component is selected To add a component Select Installation Expert Components page click Add at the right of the page and complete the Component Details dialo...

Page 49: ...ails and attributes 1 Mark the check box next to the name of the dialog box and click Edit 2 In the Custom Dialog Editor edit the dialog See About Dialog Boxes on page 203 The changes you make affect only the dialog boxes in this WiseScript To add a dialog box Click the Add button and complete the Dialog Box Properties dialog See Setting Dialog Box Properties on page 206 Digital Signature Use the ...

Page 50: ...nstallation This is useful if the installation must be digitally signed under a higher security environment by a different individual Extra space is reserved to allow for the digital signature information If an installation does not have extra space approximately 5 K and a digital signature is added errors occur when CRC checks are performed because of the resulting size increase This option elimi...

Page 51: ...g box enter the three character extension that is associated with the program 4 Navigate to and select the EXE to associate with this file type 5 Click OK The new file association appears on the File Associations page To edit an existing file association double click it See Editing File Association Details If you chose an EXE file that is part of an optional installation component the association ...

Page 52: ...ions and icons This information is added to corresponding Installation Expert pages Note If you inadvertently add multiple instances of the same file with the same path only one copy is compiled into the installation EXE Use Script Editor Edit menu Duplicate Files Report to find duplicate files Working With the Files Page The upper two list boxes display the directories and files available to your...

Page 53: ...taining the file or files to add The files in this directory are listed in the upper right list box 5 From the upper right list box select the files to added to the destination directory To add a single file to the destination directory double click the file To add multiple files select them and click Add File 6 To add the contents of an entire directory or to use wildcard filters to add only spec...

Page 54: ... Wildcard To include or exclude files based on specific criteria enter a semicolon delimited list of wildcards Example Enter EXE for all EXE files or DLL for DLL files If you leave the wildcard fields blank all files in the directory are added Include Subdirectories Mark this to add all the subdirectories within the directory you re adding The wildcard settings apply to the subdirectories also Add...

Page 55: ...r installation the prompt does not appear Include Sub Directories If you specify a directory in Source Pathname mark this to include all subdirectories and their contents Shared DLL Counter If this is marked and the file is a DLL or VBX Windows tracks the file to prevent its removal if an installed application is still using it No Progress Bar To hide the progress bar mark this for every file in t...

Page 56: ...e this replaces the existing file if its modification date and time are the same or older than the new file Older For File Version this replaces the existing file if it has a version resource that is older than the new file If the existing file lacks a version resource it is not replaced For File Date Time this replaces the existing file if its modification date and time are older than the new fil...

Page 57: ...neral Information page to set the summary information for the compiled EXE file End users can see the summary information by right clicking the compiled EXE in Windows Explorer and selecting Properties If you plan to use an automated build system and want to set these values at compile time create compiler variables to set these values and enter the compiler variable name surrounded by percent sig...

Page 58: ... and one command line If you create an INI file to update a system file on the destination computer your settings are merged into the existing system file during the installation Any duplicate settings are overwritten with the values you enter here 7 Click OK To remove an INI file from the installation select it in the list on the right and click Delete To edit an existing INI file select it in th...

Page 59: ...le on the Destination Computer Edit INI File on page 152 Updating an Existing INI File on the Destination Computer WiseScript Package Editor only You can make changes to one or more of the existing system files on the destination system such as the Win INI and System INI file 1 Select Installation Expert INI Files page 2 Select the folder where the existing system file is located 3 Click New File ...

Page 60: ...appears before any of your Install File lines This option is included for backward compatibility z Create installation log in custom directory Mark this to save the installation log in a directory you specify This enables the options for selecting the directory Select a directory and enter a name for the installation log in Install Log File Name Example Install log To create a new directory for th...

Page 61: ...ion of the Display Message action z Always Prompt Mark this to have the installation always prompt the end user to select a language unless there is only one language in the installation To add a language to the installation If the language you need is not listed on the Languages page 1 Click Add on the Languages page The Select Languages dialog box appears which lists the languages that are avail...

Page 62: ... media you are using in this field Microsoft SMS WiseScript Package Editor only If an installation runs in a Microsoft Systems Management Server SMS environment you can have the installation create a status MIF file and a definition file PDF or SMS in the Windows directory during compile Use the Microsoft SMS page to specify the information for the MIF file and package definition file For informat...

Page 63: ...a source from your computer and populates the fields z Driver Name Enter the name of the ODBC driver used by this data source The driver along with its support files must already have been installed on the destination computer z Install Data Source for Select Win16 or Win32 APIs z Data Source Attributes Either enter attributes or use the Import button to import them from an ODBC data source instal...

Page 64: ...y The end user can still change the fields before registering Password WiseScript Package Editor only Use the Password page to specify a required password or serial number for an installation End users must enter the correct password or serial number to begin the installation Select Installation Expert Password page and complete the page z Single password used for all installations Mark this to re...

Page 65: ...which your application is installed by default The end user can override this default z Place default directory under Program Files Mark this to place the default directory in the Program Files directory instead of in the hard disk s root directory The end user can change the location Progress Bar WiseScript Package Editor only Use the Progress Bar page to set options for the progress bar that dis...

Page 66: ...u select for your custom splash screen doesn t appear correctly you probably haven t selected a valid BMP file Non valid bitmap files do not appear and no error message is displayed to inform you of the problem Registry WiseScript Package Editor only Use the Registry page to specify the registry entries to be installed or edited on the destination computer You can either add registry entries manua...

Page 67: ...3 Click New and select Key The Registry Key Settings dialog box appears 4 From Operation select Create empty key 5 In Key click at the end of the existing text and add a backslash and the name of the new key Example Append Preferences to the end of the existing key name 6 Click OK To add a registry value 1 Select Installation Expert Registry page 2 In the lower left list box select the key to cont...

Page 68: ...amed values associated with the key and its subkeys on the destination computer Remove key and value only Removes the named value from the key on the destination computer If the key has other named values they are preserved Preserve existing key and value Adds a new key or value if the specified item does not exist but leaves the existing value in place if one already exists Root Select the parent...

Page 69: ...REG_BINARY Identifies the value as a binary in hexadecimal notation Separate each byte by at least one space like the following example AD 30 C0 A9 40 20 A8 FC 4C 00 08 None This option is provided for compatibility with SMS Installer installations It behaves the same as the binary data type Repair application if this registry value is missing Self repair prevents an application from failing if th...

Page 70: ...gs to edit A description section at the bottom of the Runtimes page provides information on the currently selected runtime Microsoft Data Access Components The MDAC section of the Runtimes page lists the different versions of Microsoft Data Access Components MDAC that are available to distribute with your application Database Runtime The Database Runtime section of the Runtimes page lists connecti...

Page 71: ...computer after it is installed Design your WiseScript so that it resumes properly after the reboot For a good example of how to handle a reboot when installing the SVS Driver see the VsaWrapper wse WiseScript that is in the Virtual Package Editor Templates directory The SVS Driver runtime does not appear in Add Remove Programs on the end user s computer The end user can remove the SVS Driver runti...

Page 72: ... Gothic in the Message Box Font field Services WiseScript Package Editor only The Services page lets you define applications to be installed as a Windows NT service The EXE file you define as a service must already be a part of the installation Consult Microsoft developer documentation for information on creating services This page only helps you install services not develop them To add a new serv...

Page 73: ...at happens if an error occurs while the service starts Ignore Error Logs the error and continues Normal Error Displays a message to the end user logs the error and continues Severe Error Logs the error If the computer is starting the last known good configuration startup continues Otherwise it restarts with the last known good configuration Critical Error Logs the error if possible If the computer...

Page 74: ...rtcuts page shows shortcuts that have been added so far To add a shortcut to an installation 1 Select Installation Expert Shortcuts page 2 In Default Folder Name enter the default folder name for Start menu shortcuts The end user can change this during installation You must specify a folder name before you can add any shortcuts 3 Click Add The Select File from Installation dialog box opens 4 Navig...

Page 75: ...e the target file s icon is used Icon Number Enter the number of the icon to use from the file specified in Icon Pathname above Default Directory Enter the default directory that should be set when running the target file if different from the target file s location In Windows Explorer this field is referred to as the Start in directory Shortcut Pathname Displays the path of the file that is opene...

Page 76: ... Create SmartPatch Updates Mark this to enable SmartPatch and the following fields Error Checking By default SmartPatch expects the same file names to exist in both the old and new copies of the software and displays errors when they don t match You can change the default level of error checking Do not display errors Select this option if you expect a significantly different file set in the new in...

Page 77: ... applies to any system requirement that you set on the System Requirements page Notes on specific system requirements follow the procedure 1 Select Installation Expert System Requirements page 2 Double click a requirement The Minimum System Requirements dialog box appears 3 From the drop down list at the top of the dialog box select a requirement Requirements that begin with All or Do not check in...

Page 78: ...r the Windows NT version apply only if the destination computer is running one of the following operating systems Windows NT 4 0 Windows 2000 Windows XP Windows Server 2003 Windows Vista Windows Server 2008 Windows 7 Windows Server 2008 R2 If the destination computer is running Windows 95 98 Me the minimum system requirements specified under the Windows Version item are checked instead Screen Reso...

Page 79: ...e display the search methods for finding the old version of the application The installation performs the searches in the order listed until one is successful It then makes the directory of the previous installation the default directory for the installation If none are successful the directory you enter in Default Directory on the Product Details page is the default directory To rearrange the ord...

Page 80: ...Terminology z An INI file consists of sections with the following syntax DirectoriesAndFiles SrcDir E Application SrcFiles E Application Application exe E Sample sample dll z In the section above DirectoriesAndFiles is an INI Section Name and SrcDir is an INI Item Name z Item Field refers to the number of the item in a comma delimited list Example The Item Field for E Sample sample dll in the sect...

Page 81: ...e dialog box appears 3 Complete the dialog box Root Choose the root key that contains the named value to be read Key Value Name Enter the name of the key and the value to be read from that key Remove File Name Mark this to return only the directory name if it ends with a file name 4 Click OK To edit an entry double click its name To rearrange the entry in the list click the Move Up and Move Down b...

Page 82: ...ich is the default unless the uninstall is in Japanese For a Japanese uninstall enter 128 and make sure you have specified MS Gothic in the Uninstaller Font field The uninstaller reads commands from the Install log file created during installation On the Uninstall page you can add additional commands for the uninstaller See Adding Additional Commands for the Uninstaller Adding Additional Commands ...

Page 83: ...ations for your application It creates a small stub installation that downloads the compressed files from a Web server as needed When you compile a WebDeploy installation stub files and data files are created The stub files are designed to be distributed over the Internet that is they contain all the server connection information When an end user clicks the stub file WebDeploy connects to the appr...

Page 84: ...stallation z Upload the installation files to the Web server z Notify end users of the Web link to the EXE Your Computer Your Internet Host FTP HTTP Server z Contains the installation The installation is copied to the host but is not used yet The installation and its pieces are stored in an EXE file plus files named 001 002 and so on Phase 1 Upload files through FTP HTTP Protocol Destination Compu...

Page 85: ...er File Transfer Via Select how to transfer the files HTTP Protocol This option is more universal because it can be used both outside and behind a firewall The HTTP protocol tries to read the information from the Web browser which makes your files more widely available to your clients It also allows for faster file transfers than the FTP protocol Because of its flexibility and proxy server support...

Page 86: ...upload the installation files 3 Distribute the installation media or notify your end users of the Web link to the EXE To test the installation After the files are uploaded to the server you can test your application by connecting to the FTP server through an FTP client and downloading and running the installation EXE WebDeploy downloads and installs only the files that a particular end user requir...

Page 87: ...e destination computer is started or an end user logs on to Windows WiseUpdate Client checks for newer versions of your application at the Web location you specified If it finds a new installation it downloads and runs it WiseUpdate by itself does not deploy the current version of your application it simply adds a Web based update mechanism to your end users computers The first time you configure ...

Page 88: ...pplication directory A shortcut to WiseUpdate client is placed on the destination computer Destination Computer 3 Upload to the Web server WiseUpdate update file Installation files and Readme Your Web Server FTP HTTP z Contains the WiseUpdate update file that stores The new version number URLs to the new installation files z Contains the new installation files and Readme Phase 3 When you update yo...

Page 89: ...te Page on page 89 4 When the installation is tested and ready for distribution upload the installation files the Readme file and the update file to a Web server See Uploading WiseUpdate Files With an FTP Client on page 92 Warning If you do not upload the files before deploying your application to end users an error occurs when they check for upgrades 5 Test the WiseUpdate process See Testing Wise...

Page 90: ... basic HTTP authentication Host Password If necessary enter the password that s required to connect to the host address Enter this only if the Host Username is entered above Host Directory Enter the directory on the Web server where you plan to store updated installation files including the WiseUpdate update file To put the files in the root directory of the host leave this blank If you are workin...

Page 91: ...d or the end user logs on to Windows the shortcut runs WiseUpdate Client according to the Check Interval days setting described above If you do not mark this check box then WiseUpdate Client will never run on the end user s computer unless you code your application to run it See Options for Running WiseUpdate Client on page 93 About the WiseUpdate Update File WiseScript Package Editor only On the ...

Page 92: ...eUpdate process To test how WiseUpdate works when an update is not needed In this test the end user s version of your application matches the version on the Web server 1 Install the first version of your application on a testing computer not your development computer 2 On the testing computer open your application s installation directory and double click the file WiseUpdt exe Normally this file i...

Page 93: ...successful try to determine the problem See WiseUpdate Tips on page 94 and Troubleshooting WiseUpdate on page 95 If you see the Web page you entered in the Alternate Web Page field on the WiseUpdate page then there was a problem connecting to the host through HTTP or the necessary files were not found on the host Options for Running WiseUpdate Client WiseScript Package Editor only Options on the W...

Page 94: ... runtimes examples Windows Installer or NET runtimes WiseUpdate always tries to open the EXE not the MSI Follow these guidelines z The EXE of the MSI EXE pair must be located somewhere on the Web and must be accessible to WiseUpdate users It cannot be distributed through email or other mechanisms z On the WiseUpdate page the connection information you enter must point to the location of the WiseUp...

Page 95: ...es HTTP to connect to the Web server specified on the WiseUpdate page You typically use the FTP protocol to upload the installation EXE an optional Readme file and a WiseUpdate update file Both operations access the same location on the same server Therefore both protocols must have access to the directory and the host must be able to process both HTTP and FTP requests Also the Host Directory the ...

Page 96: ...h like statements You compile the script along with files and other resources into an EXE When the EXE is run the script runs executing the actions that are specified in the script In WiseScript Package Editor every installation is driven by a script that specifies how to display dialog boxes edit the INI files add registry entries and so on The script provides another way of looking at the instal...

Page 97: ... Installation Title field on the Product Details page followed by Installation If you change the title of the script here it does not change on the Product Details page When you run the installation this name appears at the top of the splash dialog box the Initializing Wise Installation wizard dialog box and in the title bar of the installation screen Event From this drop down list you select the ...

Page 98: ...ctions the Favorites group displays some of the most commonly used actions while the Custom group is by default empty You can also create your own action groups See Customizing the List of Actions on page 24 Script List This list contains the script that is executed when an end user runs the EXE For information on working with scripts see Adding an Action to a Script on page 26 and Editing Scripts...

Page 99: ...clude in the group and click OK The new action group appears with the actions you selected To edit an action group 1 Click the title bar of the action group You cannot edit or remove the All Items group 2 Right click below the action group title bar and select Add Remove Items The Select Items for Group dialog box appears 3 Add delete or move group items and click OK You can customize the Actions ...

Page 100: ...n develop a library of WiseScripts that perform very specific functions You can re use these specialized scripts in future installations and easily share them with colleagues WiseScript Package Editor only By default all scripts based on the Empty Project template on the New Installation File dialog box contain two include scripts rollback wse and uninstal wse The rollback wse script is in the Can...

Page 101: ...meters When you add a Custom Dialog or Custom Billboard action the appropriate editing environment opens Some actions come in pairs Example When you add an If action you must also add an End action at the end of the condition block Script Editor indents actions inside these pairs Use the same methods to add an action to a VBScript See VBScript Actions on page 80 Editing Scripts To edit a WiseScrip...

Page 102: ...nt The commented out lines appear in green and begin with To reactivate commented out lines select the lines and select Edit menu Comment Saving a Script to a Text File This text file is for viewing and printing only You cannot make changes in the text file and import it back into Script Editor 1 Select File menu Save Script Text to File 2 Specify the location and name of the file Finding and Repl...

Page 103: ...inInstall wse script See also Include Script on page 176 The Script Editor Window on page 97 About Script Editor on page 96 About User Defined Actions You can streamline your development process by creating your own script actions for tasks that you perform frequently Example You have written a section of script that opens a Web page on your company s Web site Some of the script lines search the r...

Page 104: ...n page 26 Creating a User Defined Action This procedure describes the general steps for creating a user defined action It does not contain details on what kind of action to create or what to enter for the parts of the user defined action For an example of how to complete these details see Creating a User Defined Action Tutorial on page 30 To create a user defined action 1 Select File menu New 2 Se...

Page 105: ...s in the Actions list in Script Editor until you close and re open WiseScript Package Editor 8 Test the new user defined action a Close WiseScript Package Editor b Open WiseScript Package Editor and select File menu New Empty Project c In Script Editor double click your user defined action in the Actions list If it includes a dialog box the dialog box opens Complete the dialog box and click OK d S...

Page 106: ...4 Click on the toolbar The Text Control Settings dialog box appears 5 In Text enter Milliseconds to Wait and click OK 6 Click on the toolbar The Edit Text Control Settings dialog box appears 7 Enter the following on the dialog box and click OK In Default enter WAIT_TIME In Variable enter WAIT_TIME 8 Click on the toolbar The Push Button Control Settings dialog box appears 9 Enter the following on t...

Page 107: ... the DLL Parameter Settings dialog box that appears and click OK From Parameter Type select dword From Value Source select Constant In Constant Value enter WAIT_TIME 4 Click OK on the DLL Parameter Settings dialog box 5 Click OK on the Call DLL Function dialog box 6 In Title located above the Actions list enter Wait WAIT_TIME Milliseconds This determines how the script line looks in the script 7 S...

Page 108: ...ation bar or by using the more flexible capabilities of the Script Editor debug commands The Debug menu in Script Editor has a set of debug commands that let you step through your script to make sure it functions properly or run to a breakpoint to view the script and the values of variables When you use Debug menu in the VBScript window it tests only the VBScript not the entire script See Debuggin...

Page 109: ...version with Display Message actions You add the Display Message script lines to your script to check the value of a variable or display other relevant information You then put this script inside a Compiler Variable If block that lets you customize your installation EXE at compile time Each time you compile the installation you are asked whether to create a debug version If you choose not to creat...

Page 110: ... Value enter YES Display Message In Message Title enter Main Directory In Message Text enter The Main Directory is MAINDIR Compiler Variable End The following lines should appear in your script Set Variable MAINDIR to Application If Compiler Variable _DEBUG_ Equals YES then Display Message Main Directory Compiler Variable End 7 Click Test to test your debug version A message asks if you want to co...

Page 111: ...mpt until the data entered is appropriate If While and End Actions Because a condition or loop can apply to more than one script action they are defined using at least two statements one to mark the beginning of the block of script and the other to mark its end The standard action for beginning a condition is the If action and the standard action for beginning a loop is the While action The end of...

Page 112: ...etter z Must be 28 characters or less z Cannot begin with an underscore character only compiler variables can start with an underscore character z Cannot contain characters except when using substitution as described below Variables and Substitution By using variables the installation EXE can adapt to each destination computer Once information is stored in a variable it can be used in most script ...

Page 113: ...settings file an INI file or the registry The difference between compiler variables and run time variables is similar to the difference in C programming between preprocessor variables and C language variables Preprocessor ifdef statements determine which code is compiled C language If statements determine which code is executed at run time In Conditions and Expressions You can use both types of va...

Page 114: ...riable z When a script action places a value into a variable use a run time variable Compiler variables can t be changed by scripts but only by the person who builds the installation EXE z In most other instances the type of variable to use is implicit example the Compiler If script action requires a compiler variable or is noted explicitly Anatomy of an Installation Script An installation script ...

Page 115: ...log boxes that are created by Installation Expert place the correct values in the COMPONENTS variable You also can use the Select Components script action or a custom dialog box to accomplish the same result In the installation script use condition statements of the form If COMPONENTS contains A to determine which files are installed when each component is selected Script Editor scans the script l...

Page 116: ...nction on page 47 z Capture Application to SVS Layer on page 51 z Change SVS Layer GUID on page 52 z Check Configuration on page 52 z Check Disk Space on page 53 z Check HTTP Connection on page 55 z Check If File Dir Exists on page 56 z Check In use File on page 57 z Check Service on page 57 z Compiler Variable Actions on page 58 z Config ODBC Data Source on page 59 z Copy Local File s on page 59 ...

Page 117: ...t on page 77 z Evaluate Windows Installer Condition on page 77 z Execute Program on page 78 z Execute VBScript on page 78 z Exit Installation on page 82 z Export SVS Layer on page 83 z Find File in Path on page 83 z Find First SVS Layer on page 84 z Find Next SVS Layer on page 84 z Find SVS Layer GUID on page 85 z Get Environment Variable on page 85 z Get Name Serial Number on page 86 z Get Regist...

Page 118: ...ue on page 105 z Read Update Text File on page 105 z Read Write Binary File on page 106 z Reboot System on page 107 z Register Font on page 107 z Remark on page 107 z Remove SVS Exclude Entry on page 108 z Rename File or Directory in SVS Layer on page 109 z Rename File Directory on page 108 z Rename SVS Layer on page 109 z Search for File on page 110 z Self Register OCXs DLLs on page 111 z Set Act...

Page 119: ... Editor contains the same scripting interface as WiseScript Package Editor but it does not contain the Installation Expert interface or other installation development tools Therefore some of the information in this document does not apply to WiseScript Editor About SVS Script Actions Script Editor has a set of script actions that you can use to manage edit find and create virtual software layers E...

Page 120: ...ation to SVS Layer z Change SVS Layer GUID z Create Directory in SVS Layer z Create Shortcut in SVS Layer z Delete File from SVS Layer z Edit Registry in SVS Layer z Remove SVS Exclude Entry z Rename File or Directory in SVS Layer z Rename SVS Layer z Set SVS Exclude Entry Script Actions for Finding a Layer Use these script actions to find a layer s GUID You then store the value of the GUID in a v...

Page 121: ...ate SVS Layer on page 66 and Find SVS Layer GUID on page 85 See also About SVS Script Actions on page 40 Add Directory to PATH This action adds a directory to the PATH environment variable as set in Autoexec bat The directory is appended to every occurrence of the SET PATH statement that does not already contain it A SET PATH statement is added if none exists The system restarts at the end of inst...

Page 122: ...age Editor only Use the Installation Log page to control the creation and location of the installation log By default it is created in the application directory MAINDIR See Installation Log on page 60 WiseScript Editor Use the Open Close Install log action to create the installation log See Open Close Install log on page 100 As the installation runs on the destination computer each action it perfo...

Page 123: ...in a specified directory Use this option with caution because end users might have stored their own files in the directory You can use Windows standard wildcard notation example for all files Type the following as Log Text substituting your own directory path case sensitive File Tree MAINDIR Data Temp If you want the uninstall to remove not only the registry keys that were installed but also keys ...

Page 124: ...d in place but inactive If this is the case set Insert Action to insert before the existing line so that a subsequent installation finds and edits the active command not the commented line z Insert Action Select where to insert the new line in relation to the found line z Match Criteria Select how the found line matches the Search for Text z Ignore White Space Mark this to ignore spaces and tab ch...

Page 125: ...s z Case Sensitive Mark this to match case z Make Backup File Mark this to make a copy of Config sys before editing it Add to SYSTEM INI Windows 3 1x or Windows 9x only This action adds a device entry to the 386Enh section of the System ini file The destination computer is restarted automatically to force the new device driver to be loaded Do not use this action to modify the display driver displa...

Page 126: ... Start Block if Return Value True or Start While Loop When a WiseScript is called by a Windows Installer installation you can also call a DLL by using one of the Call Custom DLL or Call DLL actions in MSI Script in Windows Installer Editor To complete the dialog box z DLL Pathname Specify the path of the DLL file example MAINDIR Jso32 dll For non system DLLs the installation script must install th...

Page 127: ...DLL call are executed repeatedly until the DLL function returns zero z Perform while loop at least once If you select Loop while function returns true mark this to force the loop to execute once before the test is performed If the check box is cleared the loop is executed if the condition is true but is not executed if the condition is false z Call a function with variable parameter list Enables t...

Page 128: ...ype To complete the dialog box z Parameter Type Check the table below for alternate names for data types WiseScript Corresponds to Win32 SDK type Corresponds to Visual Basic type Description short SHORT Integer 16 bit signed integer data type word WORD Integer 16 bit unsigned integer data type long LONG LRESULT BOOL Long Boolean 32 bit signed integer data type dword DWORD Use this for any paramete...

Page 129: ...rce is set to Constant enter a constant here You can enter a variable here example NUMUSERS Note WiseScript Package Editor maintains backward compatibility with DLLs written specifically for the API available in previous versions so that you can continue to use older scripts with the new WiseScript Package Editor Because future versions of WiseScript Package Editor might not support this API it is...

Page 130: ... function is a simple integer indicating success or failure The function accepts three parameters a structure that contains three elements an integer and another structure that contains two elements The calling statement for the DLL is int NewEmployee EMPLOYEE int DEPARTMENT where EMPLOYEE is a pointer to a structure int is a simple integer and DEPARTMENT is a pointer to a structure In this exampl...

Page 131: ...s For information on creating a variable for a layer s GUID see Create SVS Layer on page 66 and Find SVS Layer GUID on page 85 z Program path Specify the path and file name of the EXE When the WiseScript runs it executes the EXE and captures whatever it installs To capture an MSI enter the path to msiexec exe You can use WiseScript variables z Parameters Optional Enter parameters for running the E...

Page 132: ...s z Return variable Optional Enter a name for the return variable When this script action runs successfully either 0 or 1 is placed in this variable See also About SVS Script Actions on page 40 Check Configuration This action tests the hardware configuration operating system and other characteristics of the destination computer As a result of this check the action can display a message halt the in...

Page 133: ...user selects to install You would use this action only if the WiseScript contains Install File s actions that install files permanently on the destination computer If you add components on the Components page the Files page shows an Always Installed folder and other component folders Note When a WiseScript is used in a Windows Installer installation an alternative to using the Check Disk Space act...

Page 134: ...alled by a Windows Installer installation the Check Disk Space action only checks disk space for files installed by this WiseScript In other words the WiseScript EXE and the Windows Installer installation are unaware of each other s disk space requirements To avoid erroneous disk space estimates by either the WiseScript EXE or the Windows Installer installation place the Run WiseScript custom acti...

Page 135: ...TML page If the installation is not true 32 bit specify both Win16 and Win32 error variables Then the Win32 WinSock dll is used followed by the Win16 WinSock dll Otherwise only the 32 bit version is used If the download is successful the Win32 Error Number Variable or Win16 Error Number Variable is set to 0 which indicates success If an error occurs the number variable is set to another error code...

Page 136: ...a file or directory enter its path Wildcard characters such as are not valid Use variables example WIN rather than hardcoding a path To check if a DLL is loaded enter just the DLL name not a path To check if a DLL is loaded in a specific directory include the full path Example To determine if any User32 dll is loaded just specify user32 dll To determine if c Windows System32 User32 dll is loaded s...

Page 137: ...an use variables to build the path Check Service This action checks if a particular service is running To complete the dialog box z Variable Select or enter a variable in which to put the status of the service Possible return results are Unknown Running Stopped Paused StartPending StopPending ContinuePending or PausePending Unknown means the service was not found or the current user does not have ...

Page 138: ...rst list shows compiler variables on the Compiler Variables page The second list shows available comparisons The Value Enter the value to be used in the comparison This is case sensitive Do not enter variables in this field because it checks your computer in real time not run time If you selected File Exists above the If statement checks to see if the file that you enter in The Value exists If you...

Page 139: ...File s This action copies uncompressed files from a floppy disk CD the destination computer or a network drive In WiseScript Package Editor it also can copy files from an FTP or HTTP server Note When a WiseScript is called by a Windows Installer installation the Windows Installer installation does not recognize changes that the WiseScript makes to the destination computer and will not uninstall th...

Page 140: ...r only If you entered a password on the Password page and you mark this the end user is prompted for the password before this file is installed The password prompt appears only once for the first password protected file in an installation regardless of the number of password protected files If no password protected files are slated for installation the prompt does not appear z Include Sub Director...

Page 141: ...the existing file if it has a version resource that is older than the new file If the existing file lacks a version resource it is not replaced For File Date Time this replaces the existing file if its modification date and time are older than the new file z Retain Duplicates in Path By default version checking removes existing copies of DLLs that are found in the path list To suppress this featur...

Page 142: ...directory to create You can use SVS variables or WiseScript variables that resolve to a valid SVS path See SVS Variables on page 162 z Return variable Optional Enter a name for the return variable When this script action runs successfully either 0 or 1 is placed in this variable See also About SVS Script Actions on page 40 Create Service This action installs a Windows service on operating systems ...

Page 143: ...e last known good configuration startup fails Otherwise it restarts with the last known good configuration z Group Enter the name of the load ordering group to which this service belongs Leave this empty if the service does not belong to a group z Dependencies Enter a list of semicolon separated names of services or load ordering groups that must start before this service Leave this empty if there...

Page 144: ...hich should end in LNK example GROUP Application lnk For the current user s desktop Start menu or Startup directory use DESKTOPDIR STARTMENUDIR or STARTUPDIR For the All Users equivalents use CDESKTOPDIR CSTARTMENUDIR or CSTARTUPDIR z Command Options Optional If the shortcut is for an EXE enter command line options z Default Directory Specify the default directory that should be set when running t...

Page 145: ...ayer s GUID see Create SVS Layer on page 66 and Find SVS Layer GUID on page 85 z Shortcut Name Enter the name to appear on the shortcut z Source Path Specify the path of a file that will be installed on the destination computer You can only use an SVS variable to reference a program inside the layer If you use a variable start the path with a variable example PROGRAMFILES Application EXE and do no...

Page 146: ...n to add an application to the layer or use other SVS script actions to add directories files registry keys and shortcuts to the layer This action creates a layer that runs in runtime mode You can add the SVS Driver runtime on the Runtimes page See Runtimes on page 70 This script action can create a variable for the layer s GUID You can use this variable in most of the other SVS script actions to ...

Page 147: ...121 For details on the Dialog Box Properties dialog box see Setting Dialog Box Properties on page 121 For details on sample scripts that use this action see ScriptHelp htm in the Samples subdirectory of this product s installation directory Deactivate SVS Layer This SVS script action deactivates a virtual software layer To complete the dialog box z Layer GUID Enter the layer s GUID globally unique...

Page 148: ...an use SVS variables or WiseScript variables that resolve to a valid SVS path See SVS Variables on page 162 z Return variable Optional Enter a name for the return variable When this script action runs successfully either 0 or 1 is placed in this variable See also About SVS Script Actions on page 40 Delete File s This action removes files from the destination computer You do not need to delete temp...

Page 149: ...layer s GUID do not include the brackets For information on creating a variable for a layer s GUID see Create SVS Layer on page 66 and Find SVS Layer GUID on page 85 z Return variable Optional Enter a name for the return variable When this script action runs successfully either 0 or 1 is placed in this variable See also About SVS Script Actions on page 40 Display Billboard WiseScript Package Edito...

Page 150: ...phics from the screen before displaying the new one z Timed Display Mark this to display a series of graphics at evenly spaced intervals which is calculated by the number of files to be installed Place all Display Billboard actions before the first Install File s action if you are using Timed Display z Local Graphic Normally you specify graphic files on your computer which are then compiled into t...

Page 151: ...ckDiskSpace wse and Search wse use this action For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Display Progress Message This action displays a small dialog box during installation typically to indicate the computer is still working during a long operation The dialog box cannot be closed or cancelled Also use this action to remov...

Page 152: ...tabs of Setup Editor in Windows Installer Editor Note When a WiseScript is called by a Windows Installer installation the Windows Installer installation does not recognize changes that the WiseScript makes to the destination computer and will not uninstall them Therefore you must provide a way to uninstall or repair such changes See Uninstalling Changes Made by a WiseScript in the Windows Installe...

Page 153: ... Keys This field shows root registry keys and the keys added by this action Select a root before adding or importing a key z Value Names This field shows values being added or changed that reside under the key selected on the left z New Key To add a new key select the parent key in Registry Keys click the New Key button and select Key from the drop down A dialog box appears where you enter informa...

Page 154: ...ct the operation to apply to the key or its associated value Create update key and value The value is updated if it already exists If the key or value does not exist it is created Create empty key Creates the key but does not add any values Remove key and all subkeys Deletes the key its subkeys and all named values associated with the key and its subkeys on the destination computer Remove key and ...

Page 155: ...fix Identifies a value entry as a multiple string These are multiple pieces of text separated by carriage returns Double Word REG_DWORD prefix Identifies a value entry as a 32 bit DWORD entry Binary Hex REG_BINARY prefix Identifies a value entry as binary Each byte should be separated by at least one blank space For instance AD 30 C0 A9 40 20 A8 FC 4C 00 08 None This is provided for compatibility ...

Page 156: ... destination computer If the key already exists this action might add a value to it update it or delete it and all its associated values z Delete Key Removes the selected key from the current installation This does not remove it from the destination computer To do that you must change the Operation field in the key s details dialog box z New Value To add a new value select the parent key in Regist...

Page 157: ...drop down list and a comparison method from the second drop down list Expression True means the expression in the Value field below is evaluated according to the conventions for WiseScript expressions See Variables and Expressions on page 34 The variable is ignored and can be left blank The result is considered true if it evaluates to a non zero result Valid Password and Invalid Password evaluate ...

Page 158: ...taller You can either enter the literal condition or use WiseScript variables enclosed in percent signs See also Get Windows Installer Property on page 90 Set Windows Installer Property on page 116 Execute Program This action runs another EXE The EXE can be a file that is already installed on the destination computer a file you installed as part of the installation or a file you provide on a separ...

Page 159: ...on sms Note This action uses the Windows ShellExecute call which means that you can open documents as well as applications When the script opens a document the associated application starts The sample scripts FTPCopy wse and Newdisk wse use this action For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Execute VBScript This action ...

Page 160: ...ple scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Editing a VBScript When you use the Execute VBScript action in a WiseScript a new tab appears at the bottom of the Installation Script pane When you click this tab the VBScript window appears In this window you can create and edit the VBScript The window is similar to a WiseScript window but has fun...

Page 161: ...syntax error message also appear as a pop up when a syntax error is detected z Revert to Saved Reverts the current script to the last saved version to undo any changes you made since you last saved Debugging a VBScript When you use the Execute VBScript action in a WiseScript a new tab appears at the bottom of the Installation Script pane When you click this tab the VBScript window appears When you...

Page 162: ...te properly See Calling a COM Object in a VBScript on page 81 Get WiseScript Variable Use this action to create script code that gets a WiseScript variable You must set the variable in the WiseScript or another VBScript prior to the Execute VBScript action See Set Variable on page 114 In the VBScript you put the name of the variable in the Get Variable function that appears when you double click t...

Page 163: ... of the following For an object that is registered on your computer select the TypeLib information for the object For an object that is not registered on your computer click Browse and locate the file that contains the TypeLib information TypeLib information for an unregistered object does not help you identify the object s ProgID but it does display a list of objects in the Objects field for the ...

Page 164: ...to the installation log See Run time Variables on page 160 z Install Status MIF WiseScript Package Editor only This section is available only if you have entered Status MIF information on the Microsoft SMS page MIF Text This text is added to the Status MIF file when this action is executed Success Failure A status for the installation is added to the Status MIF file Export SVS Layer This SVS scrip...

Page 165: ...e specify the file s typical location here Then if the file is found the location replaces the default value but if it is not this default value is used to install the file z Description Enter text to display if the find operation takes more than 1 5 seconds to complete This happens only if the list of directories in the PATH is very long or a directory is on a slow device example CD ROM z Search ...

Page 166: ...l Enter a name for the return variable When this script action runs successfully either 0 or 1 is placed in this variable See also About SVS Script Actions on page 40 Find SVS Layer GUID This SVS script action finds the GUID of a virtual software layer and creates a variable for this GUID You can use this variable in most of the other SVS script actions to identify the layer in the Layer GUID fiel...

Page 167: ...eld Add the c command line option to cause the command line window to close when your program finishes execution Get Name Serial Number This action displays a dialog box that requests the end user s name company name and a product serial number It provides backward compatibility with older WiseScripts In new scripts use the Branding Registration dialog box on the Dialogs page WiseScript Package Ed...

Page 168: ...ll environment variables in the registry value replaced with their actual values The sample script URL wse uses this action For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Get SVS Layer Info This action retrieves information about an SVS layer on the destination computer and puts that information into different variables To comp...

Page 169: ... These attributes include information such as the layer s name and GUID z File Redir Path Variable The file redirect path where the layer s files are stored is placed in this variable z Reg Redir Path Variable The registry redirect path where the layer s registry keys are stored is placed in this variable z Creation Activate and Reset Time Variables The time the layer was created activated or rese...

Page 170: ...tter of the first network drive followed by a colon If there are no network drives the response is blank First CD ROM Drive The letter of the first CD ROM drive followed by a colon If there is no CD ROM drive the response is blank Win32s Version The version number of the currently running Win32s system in format or blank if Win32s is not installed Full UNC Pathname The UNC path of the destination ...

Page 171: ...on on files or directories Specify the full path of the file or directory to retrieve information from You can use variables example MAINDIR Readme txt You also can enter a hardcoded path example C Program Files File exe but it is not recommended The sample script Autoplay wse uses this action For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installati...

Page 172: ...tion on other computers if they lack correct runtime files because the resulting installation could damage runtime installations on destination computers You do this by adding a Compiler Variable If Else End block You get the file version of a key runtime file using the file version option of a Compiler If statement Then if the file version is not the one the script requires use the Halt Compilati...

Page 173: ...wse and scripts that manipulate strings and perform calculations For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory See also Else Statement on page 76 ElseIf Statement on page 76 End Statement on page 77 Import SVS Layer This SVS script action imports a virtual runtime archive file VRA into an SVS layer To activate the layer after ...

Page 174: ...ins the default script which is designed to perform an installation The combined script would then have two wizard loops two of every dialog box and so on Only the script is inserted into the calling script Any configuration in Installation Expert is ignored including compiler variables that are defined on the Compiler Variables page To complete the dialog box z Pathname Specify the path of the sc...

Page 175: ... in the Search for Existing Text area overrides any line number that is specified here unless the text is not found z Search for Text Enter the text to search for If more than one line in the file matches only the first is edited z Comment Text Enter comment to insert at the beginning of the found line When replacing an existing line use this to leave the existing line in place but inactive Set In...

Page 176: ... the dialog box z Source Pathname Specify the path of the file on your computer You can use wildcards in this field to indicate that all the files in a directory that match a certain pattern should be installed example C Dev exe You can also use compiler variables but you should not use run time variables because this field is used at compile time z Destination Pathname Specify the path the file w...

Page 177: ...rate file z Repair application if this file is missing WiseScript Package Editor only Mark this to start self repair if this file is missing when the application starts This prevents your application from failing if this file is accidently deleted For information on setting up self repair see Using Self Repair on page 30 z Replace Existing File Select when to replace existing files on the destinat...

Page 178: ...Package Editor only This action installs a Virtual Software Package VSP on a destination computer You can use this action to create a WiseScript that installs any number of VSPs The computer on which this action runs must have the SVS Driver runtime or compatible version of the driver You can add the SVS Driver runtime on the Runtimes page However we recommend that you create a release for your WV...

Page 179: ...tes an application on destination computers over the Internet The Install WiseUpdate Client action reflects the settings on the WiseUpdate page and vice versa You can either complete the WiseUpdate page or add the Install WiseUpdate Client action See About WiseUpdate on page 87 To complete the dialog box z Host Address Enter the Web server address or IP address where the WiseUpdate Client looks fo...

Page 180: ...ate Client to the Windows Startup group The WiseUpdate Client runs silently every time the destination computer is restarted or the end user logs into Windows If the Check Interval time has not been reached is simply runs silently checks the time interval and quits However after the number of days in Check Interval elapse instead of running silently and quitting it runs with its normal interface a...

Page 181: ...obile device application 1 Obtain the mobile device installation file or files Windows Mobile installations consists of one or more CAB files Obtain the CAB files from a vendor or other source or use the Mobile Device Package Editor to create them 2 In WiseScript Package Editor add the Install Windows Mobile Application script action and specify the CAB files to add 3 Finish assembling the WiseScr...

Page 182: ... mobile device following the desktop installation If you mark this and the mobile device is connected during the desktop installation then the end user is prompted to perform the mobile device installation immediately following the desktop installation See also Process for Adding Mobile Device Support to a WiseScript on page 98 Modify Component Size For files within the installation EXE the amount...

Page 183: ...dialog box Select one of the following options for each Open Close Install log action that you add to the script z Resume Start writing entries into installation log z Pause writing entries into installation log This must be followed at some point by another Open Close Install log action that resumes writing or no log file is created z Open new installation log Mark this to create an installation ...

Page 184: ...ation Variable 1 2 Select or enter variables to store the two strings resulting from this operation Operation below determines how each variable is populated z Operation Select how to split the text string z Trim Spaces Mark this to remove leading and trailing spaces from both destination variables z Ignore Case Mark to make pattern matching case insensitive The sample scripts TextFile wse and URL...

Page 185: ...cepts data sent by an HTTP POST operation and deciphers encoded characters The destination computer must have a valid Internet connection If end users might not have this capability you can add a prompt on a dialog box asking the end user if they have Internet connectivity Then use the results from the prompt to run this action or not To complete the dialog box z Destination URL Enter the URL of t...

Page 186: ...th of the file or directory the end user selects z Default Extension Enter the extension to append to the file name if the end user does not enter one z Filter List Enter the file types to appear in the Files of Type drop down list in the Open or Save dialog box Use Shift Enter to enter a carriage return in this field Example to show text JPGs and bitmaps enter Text Files txt txt Pictures jpg jpg ...

Page 187: ...lete trailing backslashes from the text so you can use it as a directory path z Confirm If Exists If this check box is marked and the end user enters the path of an existing file or directory a dialog box asks whether to overwrite The sample scripts Adding wse Comcat wse Division wse Instr wse Lcase wse Left wse and Len wse use this action For details on sample scripts see ScriptHelp htm in the Sa...

Page 188: ...e value of the INI item z Remove File Name Mark this to remove a file name from the end of a returned path leaving only the directory name This operation is not performed on the Default Value Read Update Text File This action begins a loop that reads and optionally updates text in a text file Each loop puts the next line of text into a variable You can put actions in the loop that change the conte...

Page 189: ...rites from a variable to a binary file If you write to the file the existing information in the file is not moved it is overwritten This action does not support reading or writing non ASCII characters characters with codes above 127 Note When a WiseScript is called by a Windows Installer installation the Windows Installer installation does not recognize changes that the WiseScript makes to the des...

Page 190: ... copied into the Windows font directory To complete the dialog box z Font File Name Specify the file name of the TTF font file not the path to be registered The drop down list contains font files that you have added to this installation The file must already have been installed in the font directory on your computer and the font s file name must match its internal name z Font Name Enter the full n...

Page 191: ... see Create SVS Layer on page 66 and Find SVS Layer GUID on page 85 z Exclude entry text Enter the text used to set the exclude If the exclude entry type is an extension enter the file extension If the exclude entry type is a directory or a directory with its subdirectories enter the directory For a directory you can use a WiseScript variable that resolves to a valid path For example PROGRAM_FILES...

Page 192: ...ile in the virtual software layer You can use SVS variables or WiseScript variables that resolve to a valid SVS path See SVS Variables on page 162 z Destination path Enter the new path or file name or both Any new path you enter must exist in the layer You can use SVS variables or WiseScript variables that resolve to a valid SVS path See SVS Variables on page 162 z Return variable Optional Enter a...

Page 193: ...y the location where the file is normally installed If the file is found the new version could overwrite the found file If the file is not found the new version could be installed to the default location z Message Text Enter a message to display during the search operation z Return Type Select whether to return only the first match or list of all matches z Drives to Search Select to search local d...

Page 194: ...g file for self registration Mark this to queue the file listed in Pathname for later self registration Set Activate SVS Layer on Startup This SVS script action activates a virtual software layer when the computer restarts To complete the dialog box z Layer GUID Enter the layer s GUID globally unique identifier or a variable that represents the layer s GUID If you enter the layer s GUID do not inc...

Page 195: ...is product s installation directory Set Control Text This action appears only when you are in a dialog box script This action changes the text associated with a control in a dialog box Controls without names cannot be manipulated with this action To access this action 1 Double click a Custom Dialog script line The dialog box appears in the Custom Dialog Editor 2 Select View Dialog Script Editor A ...

Page 196: ...which shows the dialog box to see or change the name of controls To name a control right click the control select Control Properties and in the dialog box that appears enter a name in the Control Name field Set File Attributes This action sets the attributes of one file or a group of files To complete the dialog box z File Pathname Specify a file to change example MAINDIR Acrobat pdf You can use w...

Page 197: ...he files are saved in the base file system and are not lost To remove an SVS exclude entry use the Remove SVS Exclude Entry action See Remove SVS Exclude Entry on page 108 To complete the dialog box z Layer GUID For a global exclude leave this blank For a layer exclude enter the layer s GUID globally unique identifier or a variable that represents the layer s GUID If you enter the layer s GUID do ...

Page 198: ...nverts an existing path to its equivalent long or short path if the installation runs on Windows 95 or NT For this to work the specified directory or file must exist Convert to uppercase or lowercase All alphabetical characters are converted to the case you select Evaluate Expression The expression in New Value is evaluated according to the rules outlined in Variables and Expressions on page 34 z ...

Page 199: ...r executables are not needed for your Web site to operate we recommend that you turn these permissions off to limit the possibility of malicious code destroying your Web server Set Windows Installer Property This action sets the value of a property in the currently running Windows Installer installation You can either hard code a value or set the property to the value of a variable Use this action...

Page 200: ...on specified in the While Statement Settings dialog box is true the script lines inside the loop execute repeatedly If the condition is not true then the While loop is exited and the next script line is executed To create a While loop 1 Add a While Statement and complete the dialog box While Variable Select a variable from the first drop down list and a comparison method from the second drop down ...

Page 201: ...inues executing inside the wizard loop until the last dialog box has been completed and accepted WiseScript Package Editor only Installation Expert creates default Wizard Loop and Custom Dialog actions for you Use this script action to customize the existing structure WiseScript Editor Use this script action to create the wizard loop To complete the dialog box z Dialog Boxes Displays a list of the...

Page 202: ... in the Value field below is evaluated according to the rules outlined in Variables and Expressions on page 34 The variable is ignored and can be left blank The result is considered true if it evaluates to a non zero result The password comparisons are applicable in WiseScript Package Editor only ...

Page 203: ...vide translations for dialog boxes in the installation See Adding Language Support for a New Language on page 32 Typically dialog boxes are not used in WiseScripts that run silently or in WiseScripts that you use as custom actions in a Windows Installer installation Note This documentation covers both WiseScript Package Editor and WiseScript Editor WiseScript Editor contains the same scripting int...

Page 204: ... create a new dialog box 1 Do one of the following WiseScript Package Editor only Select Installation Expert Dialogs page select a dialog box name and click Add The new dialog box is placed before the dialog box that you selected In Script Editor double click the Custom Dialog script action in the Actions list The Dialog Box Properties dialog box appears 2 Enter a title for the dialog box in Dialo...

Page 205: ...dit In Script Editor locate and double click the Custom Dialog script line that calls the dialog box The dialog box opens in the Custom Dialog Editor 2 Make changes to the dialog box by adding editing or removing controls See Adding and Editing Dialog Box Controls on page 123 See Aligning and Spacing Dialog Box Controls on page 140 3 Select File menu Save Changes and exit See also Editing Dialog B...

Page 206: ... Title Enter the title for the dialog box Font Name Font Size Enter the exact name of a font and a point size This font type and size is applied to any text whose font attribute is set to Default Font When you add or edit a text box you can set the font to the default or override the default with a customized font Width Height Enter the dialog box size in points All dialog boxes in a wizard loop m...

Page 207: ...le bitmap graphic See Adding Graphic Controls on page 128 Group Box A boundary box drawn around related controls See Adding Group Box Controls on page 129 Hot Text Text that you can link to actions or a Web page See Adding Hot Text Controls on page 130 List Box A single column of values The end user can select one or more values from the list See Adding List Box Controls on page 132 Play AVI An an...

Page 208: ...e control to open its settings dialog box Adding Check Box Controls Like radio buttons a group of check boxes is considered a single control However unlike radio buttons the end user can select multiple check boxes Alignment and spacing between the individual check boxes is maintained by the Custom Dialog Editor Check boxes are often used to control the installation of components or sub components...

Page 209: ...log unit is 1 4 the average width of the font and a vertical dialog unit is 1 8 the average height of the font Width Height Specify the exact dimensions of the control in dialog units You can also resize controls by dragging their handles though this is not as precise Components If this is marked the sizes of the components that correspond to the variable specified are displayed to the right of th...

Page 210: ...oups Mark this to have the items in the Programs group of the Windows Start menu appear in the combo box Drive List Mark this to display the end user s available drives in the combo box The value returned is a letter and a colon example C Directory Mark this to remove trailing backslashes from the text before it is placed in the variable Confirm If Exists Mark this to prompt for confirmation if th...

Page 211: ...ecise Note A combo box field should be at least as wide as the longest option in the list Adding Edit Text Controls An edit text control lets the end user enter and edit text information You can also use it to display text example license agreements or ReadMe files 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 121 2 Select Add menu Edit Text The Edit Text Contr...

Page 212: ...Tab key to give focus to this field Make sure this is marked for input fields RichEdit Mark this to support rich text objects example formatted text bold italic font size variations and colors This causes rich text files to display properly Read Default Text from File Enter the path of a text file This path should be relative Use variable substitution example MAINDIR to refer to the destination di...

Page 213: ...Enter the name by which you will refer to this control in the dialog box script Leave this blank if you will not manipulate this control with a script Do not resize bitmap graphic Normally graphics are resized if the dialog box needs to be made larger example if the destination computer uses a larger font size Mark this check box to keep the graphic at the same size regardless of the system settin...

Page 214: ...cify the exact location of the control on the dialog box You can also use the alignment commands to precisely arrange controls on the dialog box See Aligning and Spacing Dialog Box Controls on page 140 Note A dialog unit is based on the size of the dialog font usually 8 point MS Sans Serif A horizontal dialog unit is 1 4 the average width of the font and a vertical dialog unit is 1 8 the average h...

Page 215: ...alog Displays the selected dialog box from the current set Abort Installation The end user is asked to confirm that the installation should be aborted Display Help Context If the HELPFILE variable points to a valid copy of a Windows help file the specified numeric help context is displayed Execute Program Starts another application or links to a Web page Click Edit to specify and configure the app...

Page 216: ...ing 4 Click OK Adding List Box Controls A list box is a list of values from which the end user can choose The control can return either the actual string the end user selected or its position in the list as a letter If it returns letters it returns A if the first item is selected B if the second item is selected and so on 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes o...

Page 217: ...he item text itself Don t Append Mark this to not append the Program Files directory name to the Destination Directory selected by the end user Confirm If Exists Mark this to prompt for confirmation if the path that the end user enters already exists on the destination computer Clear this check box to prevent the This directory already exists message from appearing Components To create named compo...

Page 218: ...is control with a script X Position Y Position Specify the exact location of the control on the dialog box You can also use the alignment commands to precisely arrange controls on the dialog box See Aligning and Spacing Dialog Box Controls on page 140 Note A dialog unit is based on the size of the dialog font usually 8 point MS Sans Serif A horizontal dialog unit is 1 4 the average width of the fo...

Page 219: ...uttons on wizard dialog boxes do not use this option They are controlled by the Wizard Loop script action If this is the first dialog box in the set it returns to the installation script Return to Script Returns to the installation script even if this dialog box was called from another dialog box in the dialog box set Display Dialog Displays the selected dialog box from the current set Abort Insta...

Page 220: ... can select only one button from the group Alignment and spacing between the individual buttons is maintained by the Custom Dialog Editor 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 121 2 Select Add menu Radio Button The Radio Button Control Settings dialog box appears 3 Complete the dialog box Radio Button Text Enter the text options for the radio buttons on...

Page 221: ...the font Width Height Specify the exact dimensions of the control in dialog units You can also resize controls by dragging their handles though this is not as precise 4 Click OK The sample script License Agreement wse uses scripting to handle radio button controls For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Adding Rectangle ...

Page 222: ...s which means that the end user cannot change them 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 121 2 Select Add menu Text Control The Text Control Settings dialog box appears 3 Complete the dialog box Text Enter the text up to a maximum of 511 characters To start a new line press Ctrl Enter Enter variable names surrounded by percent signs to display the appli...

Page 223: ... space requirements for the currently selected component set Disk This variable represents the Disk Space Remaining on the installation drive Select the MAINDIR variable as it keeps track of free space in the installation directory X Position Y Position Specify the exact location of the control on the dialog box You can also use the alignment commands to precisely arrange controls on the dialog bo...

Page 224: ...t variables that were added by the executable program using a DDE link are displayed Note This field is retained for backward compatibility only Window Size You can force the application to run in a maximized or minimized window or allow it to run in its default normal window Wait for Program to Exit Mark this to pause the installation until the executed installation has exited 4 Click OK Aligning...

Page 225: ... Top or Align Controls Bottom command to move them into a row Setting Tab Order of Dialog Box Controls Tab order refers to the sequence in which controls are selected when the end user presses the Tab key By default the tab order is the order in which the dialog box controls were created 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 121 2 Select Layout menu Set...

Page 226: ...ectory Changing the Default Graphic on Wizard Dialog Boxes By default wizard dialog boxes contain a graphic that is not part of the individual dialog boxes It is specified on the Wizard Loop Settings dialog box where you configure the Wizard Loop script action You can change this graphic and turn it off for selected dialog boxes To change the bitmap that applies to all wizard dialog boxes 1 In Scr...

Page 227: ...box control The List Box Control Settings dialog box appears 4 Mark Don t Append and click OK 5 Select File menu Save Changes and exit See also Solutions for Dialog Box Problems on page 226 Disabling the Directory Already Exists Message When an end user runs the installation and selects an existing directory as the destination directory a message warns that the directory already exists This helps ...

Page 228: ...m Dialog script action can display a set of related dialog boxes You do this by using a button on one dialog box as a gateway to another dialog box This secondary dialog box can link to another dialog box link back to the master dialog box or return to the installation script A single dialog box set can contain up to 256 separate dialog boxes In WiseScript Package Editor the Select Destination Dir...

Page 229: ...Variable The display variable determines which dialog box in the wizard loop to present to the end user the next time the wizard loop is executed When this dialog box is presented to the end user the display variable is set to this dialog box set name If this field is not blank the dialog box is only displayed if the variable holds the same value as the Dialog Set Name field Called Dialogs Float I...

Page 230: ... the introductory material in About Script Editor on page 22 Also see Conditions and Loops on page 33 and Variables and Expressions on page 34 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 121 2 Select View menu Dialog Script Editor The Dialog Script Editor opens 3 Create the script as you would in Script Editor The sample scripts Event Handler wse and License ...

Page 231: ...ons z Have the INIT event disable certain buttons if they are not valid based on previously chosen options z Have the INIT event store the current amount of free memory in a static text control then set the dialog box to display the current amount of free memory in the lower left corner z Have the UPDATE event enable the Next button on a wizard dialog box when a password field contains the correct...

Page 232: ...n the destination computer These are typically used to encourage the end user to register the product to promote related products or to provide other useful information Note This documentation covers both WiseScript Package Editor and WiseScript Editor WiseScript Editor contains the same scripting interface as WiseScript Package Editor but it does not contain the Installation Expert interface or o...

Page 233: ... drawing programs there are advantages to using the Custom Billboard Editor Example The Scale to Screen option can resize native billboard objects so they look the same regardless of the resolution of the destination computer In the Custom Billboard Editor you can move rearrange recolor or resize all objects Example Text remains editable once it has been added making it easy to translate your bill...

Page 234: ...tallation z Save As Saves a billboard to a GRF file so you can share the file with others or re use it on future projects z Exit Without Saving Returns to Script Editor without saving the changes made to the billboard z Save Changes and Exit Saves the changes made to the billboard and returns to Script Editor saving the graphic as part of the installation It is only saved as a separate file if you...

Page 235: ...Text Angle Specify the angle at which text should be displayed If a non zero text angle is used the text is centered regardless of the alignment setting This feature is available only if you selected a TrueType font Font Style Click Set Font to choose the font size and style for this object Text Color Click Pick to choose a color for the text Placement Specify the size and location of the object i...

Page 236: ...es and Ellipses The procedure for editing rectangles rounded rectangles and ellipses is the same except that rectangles also have a 3D option 1 Access the Custom Billboard Editor See Accessing the Custom Billboard Editor on page 147 2 Select Add menu Rectangle or Rounded Rectangle or Ellipse and drag the dimensions of the object in the billboard editor The Object Settings dialog box opens 3 Comple...

Page 237: ... or use the X and Y fields to move the selected point to new coordinates Line Color Fill Color Click Pick to choose a color for the line and fill 4 Click OK Editing Billboard Bitmap Objects Use the Bitmap object to import bitmaps into a custom billboard Use the text tool in the Custom Billboard Editor to add captions and content to the bitmap rather than making the text part of the bitmap so that ...

Page 238: ...tor by clicking it and dragging one of the eight handles that appear around the object Move objects in the Custom Billboard Editor by clicking and dragging them For fine placement of objects use the arrow keys on the keyboard to nudge an object one pixel at a time When two or more objects overlap you can choose which one appears in front by selecting Bring to Front or Send to Back from the Edit me...

Page 239: ... Y Position Indicate the location on a 640 x 480 screen to place images On larger screens the billboard is placed proportionately based on the 640 x 480 location Erase Num Specify how many previously displayed graphics are erased before this image is displayed To display one image at a time set to 1 To display all images simultaneously set to 0 The oldest image is removed first Build Effect Specif...

Page 240: ...155 Creating Custom Billboards WiseScript Package Editor only To slow the installation speed so that each billboard displays long enough to be read select Installation Expert Build Settings page and mark Slow Installation Speed 4 Click OK ...

Page 241: ...entation covers both WiseScript Package Editor and WiseScript Editor WiseScript Editor contains the same scripting interface as WiseScript Package Editor but it does not contain the Installation Expert interface or other installation development tools Therefore some of the information in this document does not apply to WiseScript Editor ApplicationWatch WiseScript Package Editor only ApplicationWa...

Page 242: ... through to completion Use as many of the application s features as possible to ensure that files used by rarely used features are recorded Do not use the application to print because printing accesses Windows operating system and printer specific files 6 Close the application return to the Run Application page and click Finish The files that were accessed by the source application are added to th...

Page 243: ...nformation to the current installation file This is the same as selecting File menu Import Visual Basic Project The Project File page appears 2 In VB Project File specify the path to the project file and click Next The Select Visual Basic Directory page appears Specify the directory on your computer where Visual Basic 5 or 6 is installed This directory contains the support files that must be inclu...

Page 244: ...me for the installation This overwrites the Installation Title field on the Product Details page If you don t want to overwrite the current installation title leave this blank Install Directory Enter the default installation directory where files from this import should be placed This determines the folder on the Files page in which all added files are placed Icon Name Enter the name you want to a...

Page 245: ...le that helps you debug your script The log is the most complete record of what the installation did As your script runs on the destination computer each action it performs is logged in Install log This includes failures of actions to execute the reasons for the failure and what changes on your system Installation log Lets you determine what happens during the installation including what fails See...

Page 246: ...ed on version double click its Install File s script line In WiseScript Package Editor double click the file on the Files page In the Install File Settings dialog box that appears if Check File is selected from the Replace Existing File drop down list then version checking occurs for the file To troubleshoot file replacement problems you can do one of the following z If the problem occurs because ...

Page 247: ...pment tools Therefore some of the information in this document does not apply to WiseScript Editor Compiler variables are set before the installation is built and cannot be changed by an installation script Paths are relative to the build computer not the destination computer You can create and initialize compiler variables by adding an entry to the Compiler Variables page See Compiler Variables o...

Page 248: ...s _WIN_ Windows directory on the build computer _WISE_ The directory containing WiseScript Package Editor Variable Description BACKUPDIR If this is set to a path any files that are replaced during installation are backed up This variable is set by the end user on the Backup Replaced Files dialog box BDE_CONFIGDIR Directory where the BDE configuration file is stored on the destination computer This...

Page 249: ...stalled was not newer z D Date Replacement option was set to check Date Time and the condition was not met z E Exists Replacement option was Never and the file exists z I Install on restart The file was in use and will be installed on restart RESTART variable also set to S z A null value signals success If the file specification is a wildcard the value represents the last file copied or installed ...

Page 250: ...k it turns off the RESTART function SYS Windows System directory path We recommend that you do not change this variable SYS32 Path to the system directory for Win32 files We recommend that you do not change this variable TEMP Windows temporary directory path We recommend that you do not change this variable UNINSTALL_LANG Language information to make the UNWISE EXE language match the installation ...

Page 251: ...ing shortcuts to the desktop DIRECTION Used by the Wizard Loop action to control direction of motion through dialog boxes DISPLAY Holds the name of the current wizard dialog box read only DOBACKUP Holds the end user s choice as to whether to back up replaced files DOBRAND If this is set to 1 this is the first time the installation has been branded and user information is written to CUSTDATA INI EX...

Page 252: ...box for the Execute Program action WiseScript Package Editor only Also select True Win32 from the Destination Platforms drop down list on the Build Settings page This variable is the same as WISE_ERROR_RTN PROGRAM_FILES Windows Program Files directory STARTMENUDIR Directory of the Start menu for adding shortcuts STARTUPDIR Directory of the StartUp group for adding shortcuts VER_CHECK_TYPE Set this...

Page 253: ...ocuments and Settings All Users Application Data COMMONDESKTOP C Documents and Settings All Users Desktop COMMONDOCUMENTS C Documents and Settings All Users Documents COMMONFAVORITES C Documents and Settings All Users Favorites COMMONPROGRAMS Folder that contains common items that appear under Start Menu All Programs C Documents and Settings All Users Start Menu Programs COMMONSTARTMENU C Document...

Page 254: ...Settings User Local Settings MYMUSIC C Documents and Settings User My Documents My Music MYPICTURES C Documents and Settings User My Documents My Pictures MYVIDEO C Documents and Settings User My Documents My Videos NETHOOD C Documents and Settings User NetHood PERSONAL C Documents and Settings User My Documents PRINTHOOD C Documents and Settings User PrintHood PROGRAMS Folder that contains user s...

Page 255: ...m in the Samples subdirectory of this product s installation directory Symbols Functions USERPROFILE Location of the current user s profile C Documents and Settings User Addition Subtraction Multiplication Division Left str position Returns the left portion of a string where str is the string and position is the number of characters from the left to return Example Left windows 3 returns win Right ...

Page 256: ...haracters in a string to lowercase Ucase str Converts all characters in a string to uppercase Ltrim str Deletes all leading spaces Rtrim str Deletes all trailing spaces Logical Operator Example Description And A And B True only if expression A and B are both true Or A Or B True if either expression A or B is true or if both A and B are true Not A Not B True only if one expression is true Example A...

Page 257: ... FRS Latin 1 German Austrian DEA Latin 1 German Standard DEU Latin 1 German Swiss DES Latin 1 Greek ELL Other Hungarian HUN Latin 2 Icelandic ISL Latin 1 Italian Standard ITA Latin 1 Italian Swiss ITS Latin 1 Japanese JPN Hira Kana Hani Norwegian Bokmal NOR Latin 1 Norwegian Nynorsk NON Latin 1 Polish PLK Latin 2 Portuguese Brazilian PTB Latin 1 Portuguese Standard PTG Latin 1 Russian RUS Cyrillic...

Page 258: ...SE file while setting compiler variables defined in a text file named Compile txt product_installation_directory Wise32 exe c d C Development Compile txt C Development Application wse Automated build process You can use command line options in conjunction with other processes to create an automated build process 1 Enter the following command line statement into a batch file or program that has the...

Page 259: ...ecified path Z path Extracts files to the specified path then restarts M Runs the installation in manual mode prompting for system directories examples Windows System M file name Specifies a values file for installation For information on reading variables see Set Variable on page 114 M1 Displays the name of each self registering OCX or DLL as it is registered M2 Reserved for internal use by WiseS...

Page 260: ...log box that appears Type the title at the end of the command line after all other options In the example above the title would be Application Uninstall S Silent mode The uninstall proceeds silently with no splash screen no dialog boxes and no end user choices R Rollback mode U Removes the Select Uninstall Method dialog box which means the end user does not see options for a custom automatic or re...

Page 261: ...utoexec bat backing up 124 editing 123 PATH variable 121 automated build process 47 258 automatic run time variable 248 automatic self repair 30 55 177 AVI control 218 playing 185 B back up replaced file on destination computer 49 background of installer displaying images in 149 setting 71 background processing 26 BACKUP 250 backup copy during save 25 BACKUPDIR 248 248 batch file scheduling 258 BD...

Page 262: ...iler Variable End 137 Compiler Variable If 137 Compiler Variables page 46 complex structure 130 component about 115 adding 48 conditional statement with 48 disk space for 223 installed by default 48 list box for 217 optional 49 program file for 48 selecting for installation 49 size modify 182 component based installation sample 48 COMPONENTS 115 133 182 251 Components page 48 Concat 255 conditiona...

Page 263: ... editing 229 floating dialog box 229 master dialog box 228 naming 229 properties 229 Dialogs page 48 digital signature adding 49 Digital Signature page 49 DIRECTION 251 directory adding contents 54 changing 28 checking existence 136 creating empty 141 creating in layer 142 default setting 65 filtering with wildcard 54 in installation 28 renaming 191 renaming in layer 192 searching for 79 DirectX 7...

Page 264: ...nsions See the first letter file name converting short to long 198 long 198 prompting for 186 short 198 file CAB mobile device about 180 adding 181 Files page 52 adding directory 54 adding file 53 filter directories with wildcards 54 Find File in Path 165 Find First SVS Layer 166 Find Next SVS Layer 166 Find SVS Layer GUID 166 Finished dialog box 49 First element of structure 130 floppy disk confi...

Page 265: ...5 script See script self repairing 30 55 177 serial number 64 shortcut 74 single file 18 temp directory 45 testing 18 title 65 troubleshooting 245 upgrade 76 version 57 watching 241 wizard dialog box 48 Zip format compatible 44 Installation Expert about 38 help 39 page groups 23 39 page navigation 39 pages resetting 39 undo changes 39 installation log adding text 122 creating 60 default location 6...

Page 266: ...83 operating system check 132 operators 255 optional installation item See component options for command line 258 OSD 145 owner name getting 170 P Package Definition File PDF 62 Package Distribution about 34 and relative paths 34 distributing to FTP server 35 distributing to network 34 page See Installation Expert page groups about 39 customizing 23 properties 23 Pages menu adding groups 23 proper...

Page 267: ...cript completion 190 250 message turning off 44 return code 258 Right 255 rollback from command line 260 rollback wse 100 100 Rtrim 256 run application from ApplicationWatch 242 run installation 18 run level Vista 45 run program from installation 158 run time variable about 113 automatic 248 with script actions 250 runtimes Apollo 70 Crystal Reports 70 DAO 70 database 70 70 downloading 26 MDAC 70 ...

Page 268: ... Editor 15 WiseScript Package Editor 15 Start menu 74 144 216 Start Stop Service 200 STARTMENUDIR 252 STARTUPDIR 252 static control 213 222 status MIF file 62 string buffer 129 parsing 183 pointer 128 structure passing structure example 130 passing to DLL 129 substitution 112 SVS data protection 197 exclude entry removing 191 exclude entry setting 197 initialize 175 Items 119 script actions 119 va...

Page 269: ...runtime archive 165 virtual software layer activating 121 194 adding file 121 capturing application to 131 creating 146 creating directory in 142 creating shortcut in 145 deactivating 147 deleting 149 deleting file 148 exporting 165 finding first 166 finding GUID 166 finding next 166 GUID 146 importing 173 registry editing 156 renaming 192 renaming file directory 192 virtual software package insta...

Page 270: ...g from application 93 running silently 93 testing 92 tips 94 troubleshooting 95 update file about 91 updating file 90 uploading FTP client 92 using 89 using with SmartPatch 94 using with WebDeploy 94 WiseUpdate page 87 WiseUpdt exe 93 wizard See tools wizard dialog box changing image 226 disabling check box 228 disabling radio button 228 for installation 48 Wizard Loop action 201 adding dialog box...

Reviews:

No comments

Related manuals for ALTIRIS INVENTORY 7.0 SP2 - FOR NETWORK DEVICES V1.0

Eaton Network Shutdown Module V3 User Manual preview
Network Shutdown Module V3
Brand: Eaton Pages: 65
Snom Configuring snom phones for Mass Deployment Frequently Asked Questions Manual preview
Configuring snom phones for Mass Deployment
Brand: Snom Pages: 22
NETGEAR GS110TP - ProSafe Gigabit Smart Switch Installation Manual preview
GS110TP - ProSafe Gigabit Smart Switch
Brand: NETGEAR Pages: 2
Alpha Moisture Systems SADPmini Logger Instruction Manual preview
SADPmini Logger
Brand: Alpha Moisture Systems Pages: 14
ACRONIS SNAP DEPLOY 2.0 - User Manual preview
SNAP DEPLOY 2.0 -
Brand: ACRONIS Pages: 68
Arturia Minimoog V Quick Start Manual preview
Minimoog V
Brand: Arturia Pages: 10
Billion English CO1 User Manual preview
English CO1
Brand: Billion Pages: 42
AVG 9 INTERNET SECURITY - REVISED 6-2010 User Manual preview
9 INTERNET SECURITY - REVISED 6-2010
Brand: AVG Pages: 209
ZyXEL Communications Auto Configuration Server Vantage Access Quick Start Manual preview
Auto Configuration Server Vantage Access
Brand: ZyXEL Communications Pages: 113
Altigen ACM 6.5 Administration Manual preview
ACM 6.5
Brand: Altigen Pages: 502
da Vinci Technologies EE Pro User Manual preview
EE Pro
Brand: da Vinci Technologies Pages: 249
FieldServer FS-8700-80 Driver Manual preview
FS-8700-80
Brand: FieldServer Pages: 43
Baby Lock Ellisimo Gold II Instruction And Reference Manual preview
Ellisimo Gold II
Brand: Baby Lock Pages: 50
Campbell CSIOPC Instruction Manual preview
CSIOPC
Brand: Campbell Pages: 24
Brocade Communications Systems Brocade 8/12c Command Reference Manual preview
Brocade 8/12c
Brand: Brocade Communications Systems Pages: 1132
Asus M6N User Manual preview
M6N
Brand: Asus Pages: 114
Asus P8B-E/4L User Manual preview
P8B-E/4L
Brand: Asus Pages: 154
Asus M9A Hardware User Manual preview
M9A
Brand: Asus Pages: 72

Brands by name

Popular brands

Load more brands