|
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
|