CONTENTS

From the CD-ROM

Tips for the User

Note to Educators

Online Registration

Order Information

Other Related Sites

Technical Support

Return Home

Excavating Occaneechi Town

Archaeology of an Eighteenth-Century Indian Village in North Carolina

Edited by R. P. Stephen Davis Jr., Patrick C. Livingood, H. Trawick Ward, and Vincas P. Steponaitis

Copyright © 1998 by the University of North Carolina Press. All rights reserved. ISBN 0-8078-6503-6 (cd-rom & booklet).


NOTE TO EDUCATORS / Advanced Installation Guide


Advanced Installation Guide for Librarians and Educators


These instructions will help a librarian, educator, or systems administrator to install Excavating Occaneechi Town on a variety of system configurations. They are intended only for the technically competent reader. With them, you may be required to:
  • Understand drive and path designations.
  • Edit a Windows .INI file.
  • Move files between directories.
  • Understand and evaluate your current system configuration.

For those who feel comfortable executing these instructions, this guide has been divided into the following major sections for your convenience.
Single-User License Arrangements
Description of a Typical Installation
Description of the AHOMULT.INI File
Common Errors


The directions under "Single-User License Arrangements" offer simple instructions to cover most major system configurations. However, since it is impossible to anticipate all the ways in which users have arranged their systems and their networks and all the ways in which they may need to install this software, we have included a more extensive technical description of the configuration possibilities of Excavating Occaneechi Town. It is suggested that system administrators briefly review the information in this technical description section before beginning major software installation to note any possible pitfalls. Finally, for those who are experiencing trouble configuring their system properly, the last section of this guide lists some possible common errors to avoid.

Single-User License Arrangements


There are three possible installation options:

1. Installation of software on a local hard drive, with data access from a local CD-ROM. The first installation option for the single-user license agreement is to install the software on a single machine and access the data from a locally available CD-ROM drive. In this case, you install the software normally using the setup program provided. It is then important to make sure that the CD-ROM is available in that drive any time that a user wants to access the software.

2. Installation of software on a local hard drive, with data access from a networked CD-ROM or CD jukebox. This is also a simple installation procedure. Simply place the Excavating Occaneechi Town CD-ROM in the CD drive from which it normally will be accessed. Then go to the machine that the software will be installed on and run the setup program. The necessary software will be installed on the local machine's hard drive and program icons will be created. It is important under these circumstances to install the software only on a single machine to remain in accordance with the Single-User software licensing agreement.

3. Installation of software on a network hard drive, with data access from a local CD-ROM. This option will require more work on the part of the system administrator. In many systems, the easiest method for this installation will be to use a local machine to run the setup program off the CD-ROM. In the setup program, designate the installation directory for the software as a directory on a network hard drive. Then you must edit the AHOMULT.INI file and change the path for the IndexDirectory to refer to a directory on the local machine's hard disk. It may be necessary to place the artifact data files on the local hard disk.


Description of a Typical Installation


During a typical installation from a local CD-ROM to a local hard drive with data access from a local CD, there are four sets of software that can be copied. The files that are installed are listed below.


Main Program Files

These files typically are copied to the user's hard drive under the Ahomult directory. It is not possible for these files to be accessed from the CD-ROM.

AHOMULT.EXE
AHOMULT.INI
README.WRI
EOTHELP.HLP
AHOUTIL.SBK
EOTTABS.TBK
EOTARTUT.TBK
EOTEDTUT.TBK
OPENBK01.ICO


Main Data Files

These files typically are copied to the hard drive under the Ahomult\Data directory. It is possible for these files to be accessed from the CD, but it is not recommended.

MASTERLS.DBF
MASTSLID.DBF


Artifact Data Files

These files typically are copied to the hard drive under the Ahomult\Data directory. If these files are not copied permanently to the hard drive, then they are copied to the hard drive at runtime as required and then removed when they are no longer needed. It is recommended that these be placed on the hard drive. Also, these files must have read and write permissions.

AABEADS.DB
AACERAM.DB
AAFAUN.DB
AAHC.DB
AAHIST.DB
AALITHIC.DB
AAPIP.DB


Runtime Executable Files for Toolbook II (or Toolbook 6.0)

These files typically are copied to the hard drive under the Ahomult directory. It is necessary that they be accessed from a hard drive. Some network administrators with multiple copies of software using these runtime files may opt to move them to a common shared directory for all Toolbook applications. This directory is commonly Windows\Asym\Runtime. However, because of possible incompatibilities between different versions of Toolbook runtime files (especially the TBLOAD.EXE file), it is recommended that you keep these files together only for use by Excavating Occaneechi Town for maximum reliability.

TBLOAD.EXE
TB50JPG.DLL
TB50UTL.DLL
TB50RUN.EXE
TB50RCR.DLL
TB50NET.EXE
TB50MM.INI
TB50MM.DLL
TB50LNL.DLL
TB50FLT.DLL
TB50CMP.DLL
TB50BMP.DLL
TB50BAS.DLL
FTS50MSG.STS
FTS50MAC.STS
FTS50HLP.STS
FTS50RDR.DLL
FTS50IQR.DLL
FTS50MTB.DLL
PXENGWIN.DLL
TB50PDX.DLL
TB50DB3.DLL
TB50WIN.DLL
TB50DOS.DLL
TB50DLG.DLL
TB50.INI


Necessary Runtime Files

In addition to the files that are copied at installation, the software dynamically creates files for use during runtime. One set of files with extensions of *.IDX, *.LCK, *.Y0, AND *.X0 are created and accessed from a local hard drive in the IndexDirectory. This means that, in a networked computing environment, it is necessary to reserve a small amount of space (2―5 MB) on each local computer's hard drive for use in dynamically storing these files. Another set of files called ASYM.INI and TB50.INI are dynamically created and maintained in the local Windows directory.


Changes That Occur during Setup

In addition to copying these files to a hard drive or network drive, the setup program makes the following changes:

To the AHOMULT.INI file under the [Archaeology of the Historic Occaneechi] group, it makes the following assignments, where <INSTALLDIR> gets replaced with the installation directory of the program, which typically is c:\Ahomult, and <SRCDIR> gets replaced with the installation source, which is typically the CD-ROM drive designation.

ProgramDirectory=<INSTALLDIR>\
IndexDirectory=<INSTALLDIR>\data\
ArtifactDataDirectory=<INSTALLDIR>\data\
MasterDataDirectory=<INSTALLDIR>\data\
InstallSource=<SRCDIR>
FirstTime=true

To the TB50.INI file under the [STSPATH] group, it makes the following assignments. These assignments are then shared at runtime with the copy of TB50.INI that is in the local Windows directory.

Help=<INSTALLDIR>\fts50help.sts
MacSys=<INSTALLDIR>\fts50mac.sts
Message=<INSTALLDIR>\fts50msg.sts
CharSet=<INSTALLDIR>\charset.sts
DfdDir=<INSTALLDIR>
UserDir=<INSTALLDIR>
SpillDir=<INSTALLDIR>
TempDir=<INSTALLDIR>

To the TB50.INI file under the [Toolbook] group, it makes the following assignment.

StartupSysBooks=,INSTALLDIR.\TB50R.SBK

A single assignment is made to the WIN.INI file under the [Excavating Occaneechi Town] group. This is not actually used by the software but is placed there for future reference and use (including possible updates or patches).

ProgramDirectory=<INSTALLDIR>\

Finally, program icons are created for the Excavating Occaneechi Town software, the README file, and the uninstall program. It is important that the command line for the Excavating Occaneechi Town program read:

<INSTALLDIR>\tb50run.exe <INSTALLDIR>\ahomult.exe

where <INSTALLDIR> is replaced by the appropriate directory. By directly specifying the TB50.EXE followed by the AHOMULT.EXE program, you avoid any problems that might be caused if multiple versions of Toolbook exist in the system.


Description of the AHOMULT.INI file

To help facilitate the installation of this software on the widest possible range of hardware platforms, the following description is provided of the function of the AHOMULT.INI file.

A typical AHOMULT.INI file may look like this:

[Archaeology of the Historic Occaneechi]
HDLetter=c
CDLetter=e
ProgramDirectory=<HD>ahomult\
IndexDirectory=<HD>ahomult\
ContextDataDirectory=<CD>data\
ArtifactDataDirectory=<HD>AHOMULT\data\
ArtifactDataTitlesDirectory=<CD>data\
MasterDataDirectory=<HD>ahomult\data\
Pics256Directory=<CD>pics\
Pics16kDirectory=<CD>16kpics\
ftsLocation=<CD>
AnimationDirectory=<CD>anim\
VersionMode=Professional
GraphicMode=256
FieldColor=white
BackgroundColor=gray
HotwordDefault=240,37.4375,100
HotwordUsed=0,25.125,100
TextSearchColor=0,50,100
FirstTime=false
InstallSource=E:\

Most of the options pertain to drive and directory information. A path statement in the AHOMULT.INI software can either contain the <HD> or <CD> metacommand or it can be a direct path statement including drive and directory information. In other words, the following combinations of .INI statements are equivalent and valid:

CDLetter=g
ContextDataDirectory=<CD>data\

ContextDataDirectory=g:\data\

When the software reads a direct path statement without metacommands, it tries the path to see if it is correct. If not, it will warn the user and exit the software. If the software detects the <CD> metacommand, it will first try to see if replacing <CD> with the contents of the CDLetter command will work. If this is not correct, the software will autodetect all other CD drives attached to the computer and try each one in turn. This allows a computer to have multiple CD drives (or a CD jukebox) attached and for the Excavating Occaneechi Town CD to be placed in a CD drive at runtime that is different from the drive used during installation. It also allows for situations in which the CD drive letter may change after installation time, such as with the installation of an additional local drive.

The meaning of the .INI statements are as follows:

HDLetter=c
This is the hard drive on which the program software resides.

CDLetter=e
This is the CD drive on which the data files and Excavating Occaneechi Town CD-ROM may reside. If multiple CD drives are attached to a machine, the program will search all of them for the correct location of the Excavating Occaneechi Town CD.

ProgramDirectory=<HD>ahomult\
This is the directory where the main program files, including AHOMULT.EXE, can be found. This must be a hard disk drive on the local or networked machine.

IndexDirectory=<HD>ahomult\
This is the directory where temporary files are created during program execution. This must be a hard disk drive on the local machine.

ContextDataDirectory=<CD>data\
This is the data directory where the FEA*.DBF, ST*.DBF, SQ1*.DBF, SQ2*.DBF, and SQ3*.DBF files are found. These typically are stored on the CD-ROM.

ArtifactDataDirectory=<HD>AHOMULT\data\
This is the directory where the AA*.DB files are found. These files can be stored either on the hard drive or the CD. If the files are stored on the CD, when they are required at runtime they will first be copied to the IndexDirectory and then accessed. When the user exits the program, the files will be removed.

ArtifactDataTitlesDirectory=<CD>data\
This is the directory where the AH*.DBF, AT*.DBF, and AZ*.DBF files can be found. These files typically are stored on the CD-ROM.

MasterDataDirectory=<HD>ahomult\data\
This is the directory where the MASTSLID.DBF and the MASTERLS.DBF files can be found. These files can be stored on either a local or network hard disk or on the CD-ROM. However, because of the great frequency with which these files are accessed, it is highly recommended that they be stored on the hard drive.

Pics256Directory=<CD>pics\
This is where the directory tree of Pics\ can be found. This typically is found on the CD-ROM.

Pics16kDirectory=<CD>16kpics\
This is where the directory tree of 16kpics\ can be found. This typically is found on the CD-ROM.

ftsLocation=<CD>
This is where the AHOMULT.CNC, AHOMULT.CWD, AHOMULT.KEY, AHOMULT.MAC and other files can be found. This typically is found on the CD-ROM.

AnimationDirectory=<CD>anim\
This is where the *.AVI files can be found. This typically is found on the CD-ROM.

VersionMode=Instructional
This can have the value of either "Professional" or "Instructional." It is recommended that in a public context this be switched to Instructional, because that version blocks access to photographs of human burials, which may be offensive to some people.

GraphicMode=256
This can have the value of either "256," "High," or "Choice." The 256 and High options designate whether the software is running under a 256 color graphics mode or a High color graphics mode. If you are not sure, choose 256. The Choice option will enable the user to choose the mode every time the program loads.

FieldColor=white
This can have the value of "white" or "gray" and designates the color of the text fields. This can also be changed from File | Display Options from the menu bar in the program.

BackgroundColor=gray
This can have the value of "white" or "gray" and designates the color of the background pages. This can also be changed from File | Display Options from the menu bar in the program.

HotwordDefault=240,37.4375,100
This designates a color for unused hotwords. This can also be changed from File | Display Options from the menu bar in the program.

HotwordUsed=0,25.125,100
This designates a color for used hotwords. This can also be changed from File | Display Options from the menu bar in the program.

TextSearchColor=0,50,100
This designates a color for words found in a full-text search. This can also be changed from File | Display Options from the menu bar in the program.

FirstTime=false
This can have the value of "true" or "false" and designates whether the program has been run for the first time or not and whether the supplementary setup program has been run.

InstallSource=E:\
This designates the directory from which the software was first installed.



Common Errors



  • Make sure IndexDirectory points to a valid directory on a local hard disk with at least 5 MB of free space available.

  • If you are having difficulties with the full-text search feature, make sure that the [STSPATH] group of the TB50.INI reflects correct path names as listed above under "Changes That Occur during Setup."

  • Make sure all of the paths in AHOMULT.INI are valid and point to the proper files.

  • If you have files stored on a network, make sure that the directories containing main program data files are designated as read-only and sharable.

  • If the Specialty Artifact Database is not working, make sure the AA*.DB files are not read-only.


From Excavating Occaneechi Town, a CD-ROM for Windows / ISBN 0-8078-6503-6 / $45.00 / Published for the Research Laboratories of Archaeology by the University of North Carolina Press

Top | http://uncpress.unc.edu/ | Toll-free (800) 848-6224

News | Books & more | Features | Information | Join e-mail list
Advanced search | Site guide


hosted by ibiblio