Summary

Due to issues with the installer for adTempus 4.0.x (versions 4.0, 4.0.1, and 4.0.2), if you chose an installation location other than the default ("c:\program files\arcana development\adTempus\4.0"), data for adTempus may still be stored under the default location, and program files may not be removed when uninstalling or upgrading the software.

When upgrading to a later version of adTempus, it may be necessary to manually correct these problems.

This article does not apply if you used the default installation location.

Background on problems

Data stored under wrong folder

The adTempus installer defaults to installing adTempus under the default Program Files folder, generally "C:\Program Files\Arcana Development\adTempus". Under that folder, the installer creates two subdirectories:

  • The "4.0" folder contains the adTempus 4 software components.
  • The "Instances" folder contains a sub-folder for each instance of adTempus (the "default" instance plus any additional instances you create). These folders contains data and other files specific to each instance.

For version 4.0, 4.0.1, and 4.0.2, the installer behaved incorrectly if you chose a location other than the default: Only the software components were installed to the selected location; the "Instances" folder was still created in the default location.

For example, if you selected "D:\programs\adtempus" as the Destination during installation, the installer installed the software components to "D:\programs\adtempus". However, all data is still stored under "C:\Program Files\Arcana Development\adTempus\Instances". Further, if you installed SQL Server Express during adTempus installation, the adTempus database will be stored under this location.

Beginning with adTempus 4.1, the installer will correctly use the directory you specify for the program files and data.

Uninstall or upgrade leaves files behind

If you uninstall adTempus 4.0.x after installing it to a non-default location, the program files for adTempus may be left behind on the computer.

When you upgrade adTempus 4.0.x to adTempus 4.1 or later, the newer version will be installed in the "4.0" subdirectory under the original directory you specified, and the files from the old version may be left behind in the original directory, requiring manual removal.

Upgrading the 4.0.x installation and relocating the data

For the following discussion, we assume that you installed adTempus 4.0 to folder "D:\Programs\adTempus", resulting in the following folders:

  • D:\Programs\adTempus. Contains the adTempus program files
  • C:\Program Files\Arcana Development\adTempus\instances\default\data. Contains adTempus data.
  • C:\Program Files\Arcana Development\adTempus\instances\default\data\database. Contains the adTempus database files for SQL Server Express (if used).

New installation folder 

When you upgrade this installation to adTempus 4.1 or later and again choose "D:\Programs\adTempus" as the destination folder, the version 4.1 software will be installed to "D:\Programs\adTempus\4.0". Going forward, each future major version of adTempus will be installed to its own directory under "D:\Programs\adTempus".

Removal of old files

Due to a problem with the version 4.0.x installer, the version 4.0.x program files may be left behind in the "D:\Programs\adTempus" folder after you upgrade to version 4.1. After the upgrade completes, you can delete the following files and folders:

  • All files in D:\Programs\adTempus.
  • All folders (and their contents) under D:\Programs\adTempus, except the "4.0" and "Instances" folders.

Relocating data

The upgrade does not move your adTempus data files, but instead configures adTempus to use the current data location. If you want to move the data files to a different folder (e.g., on a different drive), follow these instructions. In this example we will move the data to be under the "D:\Programs\adTempus" folder where you installed adTempus.

This affects Captured Files, Object Snapshots, and other data that adTempus stores on disk, but does not change the location of the adTempus database (see next section for this).

1. Make sure the adTempus service is stopped.

2. Under the adTempus root folder (e.g., "D:\Programs\adTempus"), create the data folder as "D:\Programs\adTempus\Instances\default\data".

3. Move the "CapturedFiles" and "ObjectSnapshots" folders from "C:\Program Files\Arcana Development\adTempus\Instances\default\data" to "D:\Programs\adTempus\Instances\default\data". Note: Do not move the "Database" folder yet; this will be done in the "Moving the database" section below.

4. Run the Registry Editor and go to key "HKEY_LOCAL_MACHINE\Software\Arcana Development\adTempus".

5. Edit the "InstanceLocation" value and change it to "D:\Programs\adTempus\Instances".

6. Go to key "HKEY_LOCAL_MACHINE\SOFTWARE\Arcana Development\adTempus\Instances\Default".

7. Edit the "DataPath" value and change it to "D:\Programs\adTempus\Instances\Default\Data".

Moving the database

In the previous section you moved the Captured File and Object Snapshot data that adTempus stores on disk. If you are using the default SQL Server Express database, you can relocate the data files for the database as well.

1. Make sure the adTempus service is stopped.

2. Start the Database Utility tool from the adTempus Server Tools group on the Start menu.

3. Enter the following database command and press F5 to execute it:

use master
go
select name from sysdatabases

4. Locate the name of the adTempus database in the list. You will see "master," "model," "tempdb," "msdb," and the adTempus database, which will generally be named "adTempus_COMPUTERNAME", where COMPUTERNAME is the name of the computer.

In the remaining instructions, replace "adTempus_COMPUTERNAME" with the name of your adTempus database.

5. Enter the following command and press F5 to execute it:

sp_detach_db 'adTempus_COMPUTERNAME'

6. Move the "database" folder from "C:\Program Files\Arcana Development\adTempus\instances\default\data" to "D:\Programs\adTempus\instances\default\data".

7. In the database utility, enter the following command and press F5 to execute it:

create database adtempus_COMPUTERNAME on 
(filename='D:\programs\adtempus\instances\default\data\database\adtempus_COMPUTERNAME.mdf'),
(filename='D:\programs\adtempus\instances\default\data\database\adtempus_COMPUTERNAME_log.ldf') 
for attach

8. Start the adTempus service.

Data migration is now complete.