The following are the sequence of installation steps under tcsh, the enhanced version of the UNIX C shell. These steps apply to both Mathematica 4.1 and Mathematica 4.2 except as noted in Step 6.
Step 1. Unzip and untar the downloaded distribution. (Note: The archive has been created using the GNU version of the tar archiving utility.)
	eagle:~ % gunzip magica.1.0.tar.gz
	eagle:~ % tar -xvf magica.1.0.tar 
	

Step 2. Set the MATHEMATICA environment variable to the full path of the top directory of the local Mathematica installation. (In Mathematica, this is the string assigned to the $TopDirectory system object.) The shell command shown below assumes the existence of Mathematica on the execution path.

	eagle:~ % setenv MATHEMATICA \
	? `math -noinit -run 'Print[$TopDirectory]' \\
	? -run 'Quit[]' | sed -n '$ p'`
	

Step 3. Set the MAGICA environment variable to the full path of the top directory of the MAGICA installation.

	eagle:~ % cd MAGICA
	eagle:~/MAGICA % setenv MAGICA `pwd`
	

Step 4. Set the CC environment variable to the full path of the C++ compiler. If not set, the install script (see Step 5 below) will check to see if the gcc compiler is present on the execution path and set CC to that.

Step 5. Invoke the install shell script provided under the .Mathematica directory.

	eagle:~/MAGICA % .Mathematica/install
	Using gcc (version 2.95.3) as the C++ compiler ...
		Building syntax-extension ...
		Building wall-clock-time ...
		Building from-file-name ...
		Building normal-numbers ...
	

Step 6. MAGICA is now ready for use. It can be used from a notebook front-end by starting Mathematica with the -preferencesDirectory option set. Under MAGICA's preferences directory is an init.m file and a POSIX shell script that together "bootstrap" MAGICA. The shell command shown below sets up a shorthand that can be used to perform this invocation from anywhere in the directory hierarchy.

	eagle:~/MAGICA % alias magica "mathematica " \
	? "-preferencesDirectory " \
	? "$MAGICA/.Mathematica/4.1/ \!*"
	
The math script in .Mathematica/4.1 allows MAGICA to be used from a text-based front-end. This script can be executed from anywhere in the directory tree.
	eagle:~/MAGICA % alias magica \
	? "$MAGICA/.Mathematica/4.1/math \!*"
	

(Note: In Mathematica 4.2, the -preferencesDirectory option should be set to $MAGICA/.Mathematica.)

Testing your installation. If the installation is successful, it should be possible to pull up information on the $magica object. This is shown below using a text-based front-end.

	eagle:~/MAGICA % magica
	Mathematica 4.1 for Sun Solaris
	Copyright 1988-2000 Wolfram Research, Inc.
 	-- Motif graphics initialized -- 

	In[1]:= ??$magica
	$magica is a global object whose value is the full path of the topmost\
 
	>   directory in the MAGICA system.
	Attributes[$magica] = {Locked, Protected}
 
	$magica = /homes/pjoisha/MAGICA
	

The value shown against $magica should be the same as the value of the MAGICA environment variable. Also, the initially displayed version message will differ with the particular platform and version of Mathematica used.