SETUP.TXT: PVCS Tracker for Windows
===================================

Table of Contents
-------------------------------------------------------------
1. Introduction

2. General Setup Notes
2.1.  Use of DOS APPEND
2.2.  Use of TSR's
2.3.  File Access Problems

3. Upgrading from Previous Versions of Tracker
4. Changing from a Single Workstation to Network Installation
5. Changing Your Network Configuration
6. Setup Error Messages
7. Uninstalling Tracker
-------------------------------------------------------------



-----------------
1. Introduction
-----------------

This file contains information about problems that may occur while
running Tracker Setup and describes problems that can occur when using
terminate-and-stay-resident (TSR) programs or drivers with Tracker Setup.
If you are using a TSR or if you encounter problems installing Tracker,
read this document before running Setup again.

Information specific to installing PVCS Tracker on various
network operating systems is available in the NETWORKS.TXT file on
Disk 1 of the Tracker installation disks.



------------------------
2. General Setup Notes
------------------------

2.1. Use of DOS APPEND

Do not use the DOS APPEND utility with Windows.  It prevents Windows
and Windows-based applications from creating valid Well-Formed-Path
(WFP) names for the files they are using.  (A WFP is the complete name
of a file, including the drive letter and full path specification,
starting from the root directory.)

If you receive an "Unable to copy or decompress file" message while
running  Setup, this could be the cause.


2.2. Use of TSR's

As discussed in the Windows SETUP.TXT (located in your Windows
directory), many terminate-and-stay-resident (TSR) programs and
drivers can cause problems when running Windows and Windows
applications.  If you experience unexpected errors while installing or
running Tracker, try removing unnecessary TSR programs
from your CONFIG.SYS or AUTOEXEC.BAT files.


2.3. File Access Problems

The most likely cause of error messages such as "Unable to create
file", "Unable to delete file", or "Unable to write file" are a lack
of appropriate network permissions in the destination directory or
files in the destination directory being marked as read-only.  These
messages usually only happen when you are updating an existing Tracker
installation.

If you are installing to a network file server, ensure that you have
the proper permissions in the destination directory.  You need
permission to create files, create directories, write files, and
delete files.  For more information on network permissions, refer
to NETWORKS.TXT located on Disk 1 of the installation disk, or the
PVCSTRKW\SYS directory.

Also, ensure that no files in the Tracker installation directory are
marked as read-only.  Use the DOS ATTRIB command to view or change
file attributes.



--------------------------------------------
3. Upgrading from Previous Versions of Tracker
--------------------------------------------

Tracker Setup is capable of creating a new installation of Tracker, or
upgrading a previous installation to Version 2.1.  You will be prompted
with the option to update or reinstall.  Please ensure all users are
logged out of Tracker before running Setup.

If you choose update, Setup will only copy new executable files and
help files.

If you choose the reinstall option, Setup will copy the complete set of
files.  You will be prompted before your existing database project
files will be overwritten.  However, you should note that reinstall
always copies over the database files in the CLONE directory.  If you
have followed the procedure to create a template database outlined in
the Administrator's Reference, you should not use reinstall.



---------------------------------------------------------------
4. Changing from a Single Workstation to Network Installation
---------------------------------------------------------------

If you own a multi-workstation license of Tracker and would like to upgrade
an existing single workstation installation to make it network aware,
follow the procedures below.  To prevent any risk of loss of data, please
make a backup before proceeding.


  If the single workstation installation is on a local disk
  ---------------------------------------------------------

  1. With the Windows File Manager (or DOS XCOPY), move the
     entire Tracker directory (and all subdirectories) to the
     desired location on your network file server.

  2. If you have followed the "Creating a Template Database"
     procedure outlined in the Administrator's Reference,
     save the contents of the ...\PVCSTRKW\CLONE directory to
     a temporary directory.

  3. Delete the PVCSTRKW.INI file located in your Windows directory.

  4. Run Tracker Setup.  When prompted for the destination directory,
     specify the location on your network file server that you
     created in Step 1.

  5. Setup will prompt you before overwriting any project databases.
     To retain your existing databases, be sure to answer "No" to
     these questions.

  6. If Step 2 applied to you, copy the saved files back to
     the ...\PVCSTRKW\CLONE directory.


  If the single workstation installation is already on a network server
  ---------------------------------------------------------------------

  1) Run Tracker Setup.  Select "Update Existing Installation".

  2) When asked if you wish to keep your existing configuration,
     answer "No".  Setup will then let you select a network
     configuration.  Choose the server configuration that matches
     your environment.



----------------------------------------
5. Changing Your Network Configuration
----------------------------------------

You may change the network configuration which you originally specified
to Tracker Setup using the following procedure:

  1. Run Setup from the Tracker installation disks.

  2. Setup should recognize the existing installation and prompt
     you to update or reinstall.  Choose "Update Existing
     Installation".

  3. Setup will ask you if you wish to keep your existing network
     configuration.  Answer "No".

  4. Follow the instructions on the screen to specify a
     different network configuration.



-------------------------
6. Setup Error Messages
-------------------------

Tracker database drive is invalid

  Tracker found an existing reference to a database directory, but the drive
  was not mounted.  Mount the drive.


Tracker help drive is invalid

  Tracker found an existing reference to a database directory, but the drive
  was not mounted.  Mount the drive.


Directory DirectoryName missing files
Directory DirectoryName not defined in PVCSTRKW.INI
Entry EntryName not defined in PVCSTRKW.INI or PTKSYS.INI

  The PVCSTRKW.INI or PTKSYS.INI file has been edited or corrupted.  Use
  the following procedure to recover:

  1. Backup your current installation

  2. Delete PVCSTRKW.INI located in your Windows directory

  3. Reinstall specifying the existing installation directory as
     the target directory.  You will be prompted with the message:

        Setup has detected an existing project:

        "Old Project Name"

        Replacing this project with:

        "New Project Name"

        will destroy the existing project's data.
        Do you wish to replace the database?

     You should answer "No" if you wish to retain your existing
     project data.


Insufficient disk space on drive x:

  Choose another target disk or cancel the installation and remove files
  from your disk.


Target location cannot be the same as source

  Tracker cannot install on top of itself.  Choose another target directory.


Unable to copy or decompress file: filename
Unable to create directory: DirectoryName
Unable to delete file: filename
Unable to mark file attribute: filename
Unable to write PTKSYS.INI or PVCSTRKW.INI
Unable to write project name file

  Indicates that a file or directory which is part of the Tracker
  installation could not be copied, written, deleted, created, or
  marked with an attribute.  Check the following:

  1. If you are in a network environment, make sure you have the
     necessary permissions to copy and create files.
  2. Ensure you are not running the DOS APPEND command.
  3. Make sure the destination directory has no read-only files.



-------------------------
7. Uninstalling Tracker
-------------------------

Make a backup of your Tracker directory, including all subdirectories.

Use the Windows File Manager to delete the Tracker directory, including
all subdirectories.

Finally, delete the PVCSTRKW.INI file located in your Windows directory.
