-------- Linux EDT Install Readme -------

Linux installs are done with the program einstall found in this
same directory.  einstall is a graphical based installer that requires 
The X Window System to be running.  If your enironment does not support
the X Window System then please contact support@epitools.com, tell us
the situation and we can send you a compressed tar file.

To start einstall most users would simply double click on einstall from
their desktop file browser.  Alternatively you could open an XTerm shell
and issue the following commands (note you should probably run this 
program with root privledges): 

	> cd /mnt/cdrom/linux
	> ./einstall

--- Notes:

/mnt/cdrom might be different for your Linux environment.

einstall writes over any existing installation done using the 
same installation directory and does not warn about this.

einstall will not run on all linux installation due to shared libraries issues.
In such case, you can manually install the tools by following these steps.

  1. Paste the template below into your emailer, fill in the ? fields and email
     it to register@epitools.com.  Please set the email's subject line to:

	"Register: <SN>, <Company Name>"

     <SN> is the serial number of your MAJIC probe and <Company Name> is
     the name of your company.  If you do not have access to email then you 
     can FAX the needed data to 408-957-0307 (USA).

	--- Manual MAJIC Registration Template (Linux) ---
	Company:    ?
	First_Name: ?
	Last Name:  ?
	EMail:      ?
	Address:    ?
	State:      ?
	Zip/Prov:   ?
	Country:    ?
	Software Release:   EDT 2.2a
	Architecture Used:  ?
	MAJIC Serial #(s):  ?
	Host OS:            Linux ?
	Target OS:          ?
	Comments:
	--------------------------------

  2. A reply email or fax will be sent with an installation key. Please allow 1 
     working day. 

  3. Upon receiving your installation key you can complete the installation with
     the following commands.  Make sure your EDT installation CD is mounted. 
     Replace <key> with the installation key provided you in quotes.  The install
     directory is optional and defaults to /opt/edta or /opt/edtm based on the key. 

	> cd /mnt/cdrom/linux
	> ./einstall_cmd <key> [ install directory ]


--- Possible install problems:

If you receive the message "Gtk-WARNING **: cannot open display", then
einstall was not able to utilize the installed X Window System or 
the X Window System was not running.

The default installation directory is /opt/edtX where X is an "a" for ARM or
"m" for MIPS.  Normally, the directory /opt requires root access to create
or update files and directores.  If you must run einstall without access to
/opt you change the install directory to any directory that you have full
access permissions for.


--- Documentation:

Additional documentation for the EDT software package and MAJIC probe can 
be found in the ./manuals directory of the EDT installation, and the 
./manuals directory on the EDT software package CD. The edta_doc_index.html 
(for ARM and Xscale), or edtm_doc_index.html (for MIPS), provide easy access 
to all the on-line documentation. The manuals and appnotes listed below
are particularly useful in the Linux environment.

Using A MAJIC Probe With A Linux PC:
An application note detailing path setup and usage MAJIC in a Linux host 
environment.

MAJIC User's Manual:
Complete information on configuration and operation of the MAJIC probe, and
the MON command language.

MDI for MAJIC User's Guide:
Details on the MDI interface to the MAJIC probe, and the MDI configuration
file.

gdb-readme.txt:
Additional technical details on setting up and using GDB and MDI-Server with a
MAJIC probe.
