@device(imprint10)
@style(spacing 1, bottommargin 1 line)
@pagefooting(left="Revision B, December 1985", center="", right="L. B. Merims",
immediate)

@majorheading(Project Athena Notes on
"An Introduction to Ingres" Version 3.0)

This @i(Introduction to Ingres) is for Version 3.0 of Relational Technology's
Ingres database system.  This is the version running on Athena Unix
systems as of January 14, 1986.  Note that
Athena does not have the Ingres Graphics described in Chapter 11.

Before you can use Ingres on Project Athena, you must:

@begin(itemize)
@b(Have an Athena Account.)  See the free Athena document @i(Essential Athena)
available in all clusters, or call the Athena Account Administrator
at (25)3-1325 for information on who can get an Athena acount, and
how to go about it.

@begin(multiple)
@b(Be validated as an Ingres user.)  This is a @i(separate, additional)
step.  To use Ingres in any capacity, you must first call the
Ingres Administrator at (25)3-1325 and get him/her to add you to
the database of people that Ingres permits to use itself.  The Administrator
must also know which machine you need to use Ingres on.

@blankspace(1 line)
@begin(text, leftmargin +5, rightmargin +5, spacing 1)
Note:  Until the technical barriers that prevent wider use are resolved,
Athena may limit Ingres
use to curriculum development projects and those demonstrating a strong
need.
@end(text)
@blankspace(1 line)

Once you become a validated Ingres user, you can create and use @i(your own)
databases.
@end(multiple)

@begin(multiple)
@b(Add the @p(~rtingres/bin) directory to your search path.)  All Ingres
commands are stored in the @i(~rtingres/bin) directory.  (Note, only
one "i".)  Unix will not normally find the Ingres commands.
Instead, you will
get "Command not found" error messages.  To make Ingres commands
work, edit your @i(.login) file.
Find the line that starts "setenv PATH".  At the end of this single
long line, add @b(:~rtingres/bin) (Do put in the @b[:] separator.)

Exit the editor.  Then type:  @b(source .login)  This will make the
new PATH active immediately.
@end(multiple)
@end(Itemize)

To use somebody else's Ingres database, you must a) have an Athena
account on the machine where the database is, b)
be
a validated Ingres user, and c) the person who owns the
database must give you permission to read and/or write their
database.  The Athena Ingres Administrator is not involved in
giving this last kind of permission.

Copies of the Ingres documentation listed in this document's "Preface" are
available for reference in each Athena Unix cluster's manual racks.  You
can  also buy this Ingres documentation at the Information Services
Publications Office in 11-209.  For those who prefer the format,
there is a comprehensive Ingres
video tape instruction course.  Ask a consultant how to gain access
to the video tapes.  If the consultant doesn't know (arrangements
are still being worked out as this goes to press), they can refer the question
to someone who does.