# INSTW32.TCL - UITcl script for Windows/UNIX Installation schemes
#
# Copyright 1996-2003 Wind River Systems, Inc.
#
# modification history
# --------------------
# 17g,07nov03,bjl  added bypass configuration variables.
# 17f,03may03,bjl  remove temp dir for exit test (spr 88192).  
# 17e,29apr03,bjl  set setupVals(toolset) to default set (spr 87803), added
#                  lmVals(succesfulDbQuery) (spr 88068).  
# 17d,04apr03,bjl  added exit test for spr 87398, fixed switches in 
#                  parseCmdLine for Unix (spr 87400).  
# 17c,28feb03,bjl  added setupVals(toolset) to globalInit.
# 17b,20feb03,bjl  added licinfo page.
# 17a,14feb03,bjl  modified for ELM licensing page sequences, added ELM and 
#                  manual licensing variables, project info page removed.
# 16z,27jan03,wmd  Modify to use licInfoGetAll2 for ALI.
# 16y,03oct02,bjl  fixed /OVERRIDE flag from being truncated (spr 80428), 
#                  made banner text independent (spr 77983).  
# 16x,25jul02,wmd  Fix isBSPcd procedure.
# 16w,15jul02,wmd  Modify Setup to add new /PATCH command line parameter.
# 16v,11jul02,wmd  Fix spr# 79358 - add space for program folder name.
# 16u,26jun02,j_w  Pointed ALI to use the production database (ALIP)
# 16t,31may02,bwd  Modified SETUP banner to display Tornado 2.2. Setup
# 16s,29may02,wmd  Preserve setupVals(WRS) as Wind River Systems, Inc.
# 16r,20may02,wmd  Fix SPR # 77610 - Change Wind River Systems, Inc to
#                  Wind River as recommend by Jim Irwin.
# 16q,13may02,j_w  Changed default program group to Tornado 2.2
# 16p,03may02,bwd  SPR 76643: added backward compatibility support for patches
#                  made by pre-veloce setupSDK
# 16o,05mar02,bwd  Source CONFIG.TCL first to define product name and version
# 16n,05mar02,bwd  Modified SETUP to be non-tornado centric
# 16m,07feb02,j_w  Workaround for cgi script problem - replace
#                  www.windriver.com to web1.windriver.com
# 16l,05feb02,j_w  Use database on powell for EAR2 testing
# 16k,05feb02,bwd  Modified default directory to Tornado2.2
# 16j,24jan02,wmd  Add variable instVals(evaluation), init to 0.
# 16i,20dec01,bwd  Modified to handle BSP CD installation
# 16h,06nov01,bwd  Added SETUP option OVERRIDE to allow user to bypass
#                  installation-over-a-tree policy
# 16g,02nov01,bjl  execute windHostTypeSet sooner so the temp directory can
#                  be created if no env temp vars exist (spr 33750).
# 16f,29oct01,bwd  Added warnings for installation on unrecognized platform on
#                  Windows
# 16e,17sep01,bwd  spr 70204 check return value from hostIdGen
# 16d,11sep01,bwd  Added page APPCONFG. SPR 70283: set destDir value if 
#                  "fileAssociation" SETUP.
# 16c,10sep01,bwd  Added warning on Solaris 2.5 and 2.6 installation
# 16b,02may01,j_w  set hostId to use ether address by default
# 16a,19mar01,j_w  Removed background if option is -L
# 15z,16mar01,j_w  Added Setup /R option for tornado registry configuration
# 15y,16mar01,wmd  Add new command line parameter to Setup for file type
#                  assocations.
# 15x,13mar01,j_w  update version 3.0 to 3.1
# 15w,12mar01,j_w  remove project page (spr 63959)
# 15v,18jan01,bwd  Removed fix for spr 63555
# 15t,10jan01,bwd  SPR 63395: additional fixes - previous fix broke solaris
#                  2.7 patch checking
# 15s,09jan01,bwd  SPR 63395 display warning if user runs SETUP on Linux with
#                  higher Kernel version
# 15r,08jan01,bwd  Initialize variable setupVals(keyString)
# 15q,15dec00,wmd  Correct grammatical and punctualtion errors in pages.
# 15p,02nov00,j_w  Name change - Tornado AE
# 15o,30oct00,j_w  set install type to be licenseSetup and added
#                  destDir page back for setup /L option
# 15n,23oct00,j_w  removed the dbQuery page for setup -C option
# 15m,17oct00,j_w  removed cdObj variable initialization
# 15l,09oct00,j_w  Added the -F option (copy FlexLM files) 
# 15k,03oct00,bwd  SPR 34877: removed checking for X-Server. Log
#                  patch-check warnings to setup.log
# 15j,19sep00,bwd  Added an argument when call hostIdGen
# 15i,18sep00,j_w  renamed page libExtract to libUpdate
# 15h,11sep00,j_w  Initialized the value of ctrlVals(screenW) and 
#                  ctrlVals(screenH) 
# 15g,07sep00,j_w  Used -nocontexthelp in dialogCreate
# 15f,22aug00,bwd  Changed X Window System checking procedure
# 15e,14aug00,bwd  Updated warning message for linux version checking
# 15d,11aug00,bwd  SPR 33076: change the linux kernel version to 2.2.12 in
#                  patchCheck procedure
# 15c,07aug00,bwd  Fixed minor TCL error
# 15b,04aug00,bwd  SPR 33076: added checks for the versions of linux and other
#                  required components in patchCheck
# 15a,10jul00,wmd  Added fix to display solaris host warning correctly for text
#                  mode.
# 14z,07jul00,j_w  Added lmVals(reloadExistingLicense)
# 14y,28jun00,bwd  Removed patch-checking messages for linux in procedure
#                  patchCheck
# 14x,22jun00,wmd  Change the severity of the warning message for solaris 2.5,
#                  2.6.
# 14w,18jun00,wmd  update for linux.
# 14v,09jun00,bwd  Added another host type (x86-linux2) and path (X86/LINUX2)
# 14u,07jun00,bwd  Use setupVals(lmError) to check to remove background
#                  screen, instead of using DISK_ID
# 14t,06jun00,bwd  SPR 31443: added a warning that T3 does not support Solaris
#                  2.5.x and 2.6
# 14s,31may00,bwd  SPR 31564: added currLicInfo page in lmInstOptions pageList
#                  for node locked licensing
# 14r,24may00,j_w  Added setupVals(lmInstType) variable and initialized it to
#                  ""
# 14q,23may00,j_w  Do not create uninstall icon if doing LM installation. This
#                  is a workaround until until uninstall for LM available
# 14p,19may00,wmd  SPR 31003 - Add lmVals(httpToken) value, and cancelDBQUERY
#                  for db tranactions.
# 14o,17may00,bwd  SPR 31030 - design change. Make dbQuery and lmInstOptions 
#                  their own page group
# 14n,15may00,bwd  SPR 31062 - change page list for node lock to go to finish
#                  page instead of lmFinish page
# 14m,11may00,bwd  SPR 31004 - removed REGDLL page
# 14l,10may00,bwd  Fix SPR 31096 - add additional SETUP page, appConfig
# 14k,09may00,bwd  Added a check in applicationExit if the main window/dialog
#                  exists before closing
# 14j,24apr00,j_w  Added dbQuery page to the page list if lmError occurs
# 14i,19apr00,j_w  Removed regTornado page. No need to register dll anymore
# 14h,10apr00,bwd  Remove background for SETUP when prompting error about
#                  License Management
# 14g,27mar00,bwd  Added/initialized additional lmVals for LM
#                  (lmFeaturesTotal)
# 14f,23mar00,bwd  Added documentation for lmVals lists used for License
#                  Management Installation/Configuration.
# 14e,07feb00,bwd  Declared ctrlVals in exitWithMessage proc
# 14d,07feb00,j_w  Include summary page on windows full installation path
# 14c,04feb00,j_w  Add SUMMARY.TCL in tcl file list
# 14b,03feb00,j_w  Add lmExit setupPageList
# 14a,01feb00,bwd  Set setupVals(cancel) to 1 for test automation when
#                  applicationExit is called
# 13z,31jan00,j_w  Added setupVals(userPhone) setupVals(userEmail)
#                  setupVals(sysAdminName)
# 13y,27jan00,j_w  Added checking for windows 2000 (NT5x)
# 13x,25jan00,j_w  Added lmVals(lastServPort)
# 13w,25jan00,j_w  Rename lmPortVal page to licServerPort page and rename
#                  CHKPORT to LICPORT
# 13v,25jan00,bwd  Corrected "startProg" to display correct start page for
#                  TEXT mode
# 13u,24jan00,j_w  Added lmPortVal page 
# 13t,21jan00,j_w  Added lmVals(defaultServPort)
# 13s,21jan00,j_w  Renamed setupVals(lmStartupOptions) to 
#                  setupVals(lmStartupOption)
# 13r,19jan00,j_w  Remove the remoteRegistryHost page - no longer needed in T3
# 13q,11jan00,j_w  Commented the line to source HELPW32.TCL
# 13p,06jan00,j_w  change lambro.wrs.com to www.wrs.com
# 13o,04jan00,bwd  Added licManual page for manual license configuration
# 13n,17dec99,clc  make return value from prompt all lower case
# 13m,16dec99,clc  add parameters call to uninstStop in prompt
# 13l,14dec99,wmd  Add option -L for system administrators to configure only
#                  license management.
# 13k,10dec99,j_w  Initialize CGI program lmVals
# 13j,09dec99,clc  aadd text mode to exitWithMessage
# 13i,08dec99,j_w  Fixed typo
# 13h,07dec99,wmd  Fix error handling.
# 13g,06dec99,wmd  Add code to handle command line options.
# 13f,06dec99,j_w  Add setupVals(licensedProdInstalled) variable
# 13e,24nov99,j_w  Removed support for NT 3.x
# 13d,23nov99,j_w  Remove lmVals(lmRegName)
# 13c,23nov99,j_w  Add lmVals(lmRegName) - Tornado LM registry name 
#                  (see LICMGNT.INF)
# 13b,23nov99,j_w  Add lmVals(lmServName) - Tornado LM service name
#                  (see LICMGNT.INF)
# 13a,17nov99,wmd  Add lmVals(lmHostOrder), lmVals(lmAvailHosts)
# 12z,17nov99,wmd  Need to add new lmVals(reload) variable and initialize it.
# 12y,16nov99,wmd  Add totalRecs init, and remove lmFeaturesTotal.
# 12x,16nov99,clc  add default value for setupVals(cmdMode)
# 12w,16nov99,clc  change text mode variable to setupVals(cmdMode)
# 12v,13nov99,wmd  Fix mispelling of lmLicensedProductNames element for lmVals.
# 12u,11nov99,wmd  Add more lmVals variables.
# 12t,11nov99,j_w  Added lmVals(lmLicenseFile)
# 12s,29oct99,bwd  Testing auto setup (Moved initialization of useInputScript 
#                  in globalInit to be before checking for auto setup)
# 12r,03nov99,j_w  added lmVals(lmPinRequired)
# 12q,31oct99,wmd  Add variable array lmVals for license management.
# 12p,30oct99,wmd  Modify the nodelock page list to add licFileConfig, but
#                  remove lmStartupOptions.
# 12o,29oct99,wmd  Add the endUser and nodeLocked license management pages.
# 12n,27oct99,bwd  Set useInputScript to 0 for manual setup
# 12m,26oct99,bwd  Moved autoSetupLog from UTILW32.TCL
# 12l,26oct99,bjl  close uninstall files in bkgndExit so tmp dir can be
#                  removed.
# 12k,25oct99,bjl  added tmp dir creation for Unix if TMP not set.
# 12j,22oct99,j_w  removed compatibility page on unix and windows
# 12i,21oct99,bjl  removed parisc-hpux support.
# 12h,20oct99,bjl  added preliminary parsing of command line arguments.
# 12g,20oct99,j_w  removed compatibility and howTo page and some comment
#                  Used hostIdGen to set setupVals(hostId)
# 12f,06oct99,clc  modified to add text mode.
# 12e,18oct99,bjl  changed location of libuitclcontrols to cd directory,
#                  changed libUpdate to libExtract.
# 12d,18oct99,j_w  removed duplicate of lmhostid
# 12c,01Oct99,j_w  Changed licGetFinish to licEmailFinish
# 12b,30sep99,j_w  remove http package debugging msg
# 12a,30Sep99,j_w  Modified for T3
# 11b,26apr99,bjl  Check for KDE in dlgFrmCreate, restoreOriginalDialog,
#                  and meterCreate.
# 11a,21apr99,wmd  Fix spr #25970 - by utilizing controlHide first, then
#                  destroying the control, we avoid the refresh problem.
# 10z,08apr99,wmd  Move the unused background window to 10000 10000.
# 10y,08apr99,wmd  Do not use windowSetSize 0 0, use windowShow xxx 0 instead.
# 10x,02apr99,wmd  More fixes for resize problem.
# 10w,31mar99,wmd  Fix resizing problem.
# 10v,31mar99,wmd  Fix spr #226197 by introducing a pause between updates of
#                  ole and com.
# 10u,24mar99,bjl  workaround UITclSh problem with resizing Unix window.
# 10t,22mar99,bjl  move back button to the left on Unix to prevent overlap.
# 10s,19mar99,wmd  Output to a file any debug messages.
# 10r,16mar99,tcy  Added compatiblity and howto pages to UNIX Setup
# 10q,16mar99,tcy  Added safeguard to prevent setup from wiping out
#                  program folders
# 10p,15mar99,tcy  minor fix: need to escape quote in message
# 10o,12mar99,bjl  restored gradient background and banner for windows.
# 10n,01mar99,wmd  Fix progStart to work for all window managers.
# 10m,23feb99,tcy  minimize system rebooting to only once (fix for SPR 22838)
# 10l,18feb99,tcy  placed remoteRegistryHost page after registry page
# 10k,17feb99,tcy  added REGDLL page to program group installation
#                  (partial fix for SPR 24897)
# 10j,11feb99,tcy  added COMPTBLE and HOWTO pages for backward compatibility
# 10i,09feb99,bjl  do not resize next button in restoreOriginalDialog to
#                  fix final oversized OK button on some Unix hosts.
# 10h,03feb99,tcy  hardcode file versions for OLE32.DLL and COMCTL32.DLL
#                  (fix for SPR 24191)
# 10g,03feb99,tcy  fixed "Overwrite one file" bug (SPR 24715, 24135)
# 10f,28jan99,tcy  create new page configSys for configuration user system
# 10e,27jan99,tcy  moved some procedures to INCLUDE.TCL
# 10d,26jan99,tcy  moved regOptionRegValueRead() to REGISTRY.TCL
# 10c,26jan99,tcy  use for loop to source wizard pages
# 10b,26jan99,tcy  added sourcing of permission page
# 10a,25jan99,tcy  reorganize INSTW32.TCL -- move procs to wizard page files
# 09f,25jan99,tcy  added fileContentGet();
#                  convert calls from cdRomRootDirGet() to cdFileNameGet();
#                  move some messages to MESSAGES.TCL
# 09e,25jan99,wmd  Fixed spr 24181, allow partial selection of Tornado product
#                  to be installed without dragging in the driver object.
# 09d,22jan99,wmd  Fix bug in proc onProjLicRecordOK, $error should be error.
# 09c,20jan99,tcy  added more comment headers
# 09b,19jan99,tcy  added comment headers to all procedures;
#                  updated file according to WRS coding convention;
#                  removed license management
# 09a,18jan99,wmd  Fix test automation stuff.
# 08z,14jan99,wmd  Need to eliminate use of FSPACE.TCL, its functions are now
#                  in GLOBAL.TCL.
# 08y,14jan99,wmd  Changename of proc fileAppreviate to fileAbbreviate.
# 08x,10dec98,tcy  corrected logic to show program group for non-administrators
# 08w,09dec98,bjl  added superceding patch messages to patchinfo.
# 08v,04dev98,bjl  allow choice to continue Setup for required patches.
# 08u,04dec98,tcy  remove extra space in first user folder (fixes SPR 23700)
# 08t,03dec98,tcy  reset uninstall link location to SETUP directory
# 08s,02dec98,bjl  convert Unix style slashes to backslashes for Windows
#                  in pageProcess(destDir).
# 08r,25nov98,tcy  use kbyteToMbyte to get available disk space for Windows
# 08q,24nov98,bjl  do not allow any directory starting with a number
#                  for destDir.
# 08p,24nov98,tcy  run htmlBook utility at end of SETUP for UNIX
# 08o,23nov98,tcy  adjusted welcome screen to incoporate new warning message
# 08n,20nov98,bjl  skip filesCopy if user chooses to exit during setupCopy.
# 08m,20nov98,tcy  made last mod applicable for Windows only
# 08l,19nov98,tcy  prevent user from choosing directory with leading numbers
#                  or directory without absolute paths
# 08n,19nov98,bjl  append web site location to patchinfo.
# 08m,18nov98,bjl  create patchinfo file during Unix patch checking to be
#                  displayed at the shell when setup exits.
# 08l,17nov98,bjl  lowered space required/available labels for Unix (fixes
#                  spr 23328).
# 08k,13nov98,wmd  fix spacing for choice button text.
# 08j,13nov98,wmd  create page for installation or program group icon
#                  installation choices for the user.
# 08i,13nov98,bjl  move torRegistry radio buttons up for Win95, changed
#                  order of radio button creation.
# 08h,12nov98,tcy  provide option for FAE to not save installation key
# 08g,12nov98,wmd  change order of choice boxes in Tornado Registry page,
#                  change shortcut key for browse to be 'r' in destDir page.
# 08f,11nov98,bjl  replaced all group boxes with labels and frames (fixes
#                  spr 23061).
# 08e,11nov98,bjl  restore window in restoreOriginalDialog before resizing
#                  (fixes spr 22841).
# 08d,10nov98,tcy  removed batch file creation for regTornado.bat;
#                  added call to backupFileQueueFlush to command queue;
#                  disallow white space in destination directory (fix for SPR
#                  22793); run htmlbook tool
# 08c,09nov98,wmd  need to make setupVals(drvIndex) and array of indices.
# 08b,30oct98,bjl  added noColorMgr check, remove setup icon from welcome page
#                  if color manager not running.
# 08a,28oct98,wmd  if the installation key is "none" remove the projInfo page.
# 07z,28oct98,bjl  allow overwrite of existing products for test automation,
#                  fixed problem with Next button after minimize on Unix.
# 07y,27oct98,bjl  do not check for tornadoInstalled in folderSelect for icon
#                  install, open explorer in iconFinish, reduce tor registry
#                  label height for win95, do not display message about
#                  exiting all programs for Unix, fixed various labels for
#                  mw build 96.
# 07x,27oct98,bjl  added patchCheck procedure and recommended patch handling.
# 07w,27oct98,tcy  added nextCallback for finish page in automated test
# 07v,26oct98,tcy  changed "Select Components" to "Select Products"
#                  added check for disk space on Windows
# 07u,25oct98,tcy  added backupFileQueueFlush call after filesCopy and
#                  fixed return values of tempDirectory
# 07t,22oct98,wmd  change title of "I accept" button, check key shortcuts.
# 07s,21oct98,tcy  set focus on OK button in finish page; create folder
#                  before creating icons if tornado is not installed
# 07r,21oct98,wmd  fix bug when compsel page is wrapped around using space key
#                  when selected/deselecting the drv/objects.
# 07q,20oct98,tcy  fixed typo in prgGrp variable ; removed newDestDir variable
# 07p,20oct98,tcy  added sourcing of REGSAVE.TCL for updating registry to T2;
#                  update comctl32.dll on Win95 if necessary
# 07o,20oct98,bjl  reduced height for tor reg description label for win95,
#                  do not display reg desc. on remote page for Windows,
#                  lower meter for billboard display.
# 07n,20oct98,wmd  fix some button coordinates.
# 07m,20oct98,wmd  same fix for tornadoSelected.
# 07l,20oct98,wmd  make sure setupVals(devIndex) is valid before using it.
# 07k,19oct98,bjl  lower license agreement button for Unix, added
#                  tornado registry description to torRegistry page, make
#                  torRegistry and remoteRegistryHost titles consistent.
# 07j,16oct98,wmd  if Tornado selected, don't allow de-selection of driver
#                  product.
# 07i,16oct98,wmd  bold the message to exit all programs.
# 07h,19oct98,bjl  added code to place billboards in dialog window. Set
#                  the env variable SETUP_REMOVEBACKGROUND=1 to activate.
# 07g,16oct98,tcy  do not write installation key to registry if user is FAE
# 07f,15oct98,tcy  do not copy atl.dll to system directory
# 07e,15oct98,tcy  enable detail button for all product with subparts
# 07d,13oct98,wmd  Reverse the order for the Registry and Project Info pages,
#                  and automatically extract the WRS license field.
# 06c,09oct98,bjl  added code to remove background and limit colors. Set
#                  the env variable SETUP_LIMITCOLORS=1 to activate.
# 06b,09oct98,wmd  fix for test automation.
# 06a,09oct98,bjl  use solid background and product label bitmap for Windows.
# 05z,09oct98,tcy  fixed patch scenario
# 05y,07oct98,bjl  do not call uninstStop unless uninstHomeDir is set.
# 05x,06oct98,bjl  added permissions page for Unix.
# 05w,06oct98,tcy  save tornado registry option in registry
# 05v,06oct98,wmd  fixed bug in installedProdGet.
# 05u,06oct98,tcy  used defGroupGet instead of Tornado for
#                  opening program folder; added CD description to
#                  welcome and registry frames
# 05t,05oct98,bjl  removed unsupported -topmost flag from proc dlgFrmCreate.
# 05s,01oct98,wmd  open explorer on the Tornado group for windows hosts.
# 05r,29sep98,wmd  fix envPathSet to respect UNIX names.
# 05q,29sep98,wmd  move display of README.TXT to right after welcome screen
# 05p,30sep98,tcy  move setupCopy ahead of filesCopy
# 05o,29sep98,wmd  added readmeDlg to ask if user wishes to read README.TXT.
# 05n,29sep98,tcy  added "yes_exit" dialog box
# 05m,29sep98,tcy  update Uninstall string from Tornado 1.0.1 to Tornado 2.0
# 05l,29sep98,wmd  fix hardcoding of SUN4/SOLARIS2 for CD_BIN
# 05k,29sep98,tcy  check for dcom95 installation at start and removed dcom page
# 05j,28sep98,bjl  display README.TXT and NEW.TXT at finish.
# 05i,26sep98,tcy  added progressmeter to DLL registration page
# 05h,25sep98,bjl  added required patch checking before setup starts, remove
#                  setup.log.abort at finish.
# 05g,25sep98,tcy  make sure ATL.DLL is run first