Uninstalling/Re-installing Keyfax

Document data

Document Date:	08 May 2007 - revision 1
Keyfax version :	3.2.0.6 (or greater)
Software required:	Internet Explorer 6.0+
User skill requirements:	NT administration rights.
Author:	Trevor Helps - trevor@touch-base.com

Un-installing & re-installing Keyfax

It is important to uninstall any previous versions of Keyfax, which may already be installed on each PC before installing a later version.

To uninstall any previous version, from the start menu, select 'Settings - Control Panel - Add/Remove Programs' and select 'Keyfax', then click 'Change/Remove'. When the uninstall dialog displays, choose 'Automatic' for the first screen, 'No' for the second, then while the files are being removed you may be asked if you want to remove a shared component; answer 'Yes to All' to continue.

Where large numbers of client machines are involved, it may be more practical to script the uninstall process. The following command will perform a silent uninstall of Keyfax software (including Admin Tools if present):

C:\Progra~1\Keyfax\UnWise.exe /S C:\Progra~1\Keyfax\INSTALL.LOG

1. Example of scripted uninstall and reinstall using Kickstart

This is an example of a scripted uninstall and reinstall using Kickstart. Although Keyfax Clients are normally installed in %SystemDrive%\Program Files\Keyfax, other paths may vary.

if $TSClient=$False and $IsServer=$False
    $wsKeyfaxInstallVersion = "1.00"
    if exist("%windir%\ituadmin\KeyfaxInstall\Version$wsKeyfaxInstallVersion.txt") = $False
      if exist("%windir%\ituadmin\KeyfaxInstall\Version*.txt") = $True
          del "%windir%\ituadmin\KeyfaxInstall\Version*.txt"
      endif
      "   Installing Keyfax..."
      ; Uninstall previous version
      if exist("%SystemDrive%\Progra~1\Keyfax\INSTALL.LOG") = $True
          shell '"%SystemDrive%\Progra~1\Keyfax\UNWISE.EXE" /S C:\Progra~1\Keyfax\INSTALL.LOG'
      endif
      ; Install new version
      shell '\\WEBSERVER\KFinstallationCD\KF32client_3-2-0-17.exe /S'
      ; Create version stamp
      if exist("%windir%\ituadmin") = $False
          md "%windir%\ituadmin"
      endif
      if exist("%windir%\ituadmin\KeyfaxInstall") = $False
          md "%windir%\ituadmin\KeyfaxInstall"
      endif
      $x = RedirectOutput("%windir%\ituadmin\KeyfaxInstall\Version$wsKeyfaxInstallVersion.txt",1)
      "Keyfax Install Version $wsKeyfaxInstallVersion"
      $x = RedirectOutput("")
      "Done.@crlf"
    endif
endif

2. Example of scripted uninstall and reinstall using BAT script

KEYFAXU.BAT (the uninstall):

echo off Title Uninstall of old Keyfax - DO NOT CLOSE THIS WINDOW!
if not exist "C:\program files\keyfax\keyfax.exe" goto end
if exist C:\keyinst.txt goto end
c:
cd\progra~1\keyfax unwise.exe /s INSTALL.LOG /z
call \\fileserver\netlogon\keyfaxi32.bat
echo. > c:\keyinst.txt
:end

KEYFAXI32.BAT (the install):

echo off
Title Install of new Keyfax client - DO NOT CLOSE THIS WINDOW!
%logonserver%\netlogon\keyfax\KF32client_3-2-0-17.exe /S

Once Keyfax is installed the control file keyinst.txt is written to the c: drive to prevent continual reinstallation. Once all client machines are upgraded, the startup script can be removed