Unix

To install MINERVA, do:

1. Read MINERVA from web server or CD-ROM
   • make a new empty directory, e.g.

             /usr/local/minerva
     

   • define an environment variable MINERVA_HOME to point to this directory
   • untar the distribution file there,
   • add $MINERVA_HOME/bin/unix at the front of your command search path
   • then (if needed) adapt the script files that invoke java and javac

             $MINERVA_HOME/bin/unix/mjava 
             $MINERVA_HOME/bin/unix/mjavac
             $MINERVA_HOME/bin/unix/mjar
     

     as required by your particular installation. Please refer to the template files in

     	$MINERVA_HOME/bin/OS/mj*.sh
     

   Note that no other files should need any modification.

   DONE!

   The specific command sequence for csh users and looks e.g. like:

   mkdir /usr/local/minerva
   setenv MINERVA_HOME /minerva
   setenv PATH $MINERVA_HOME/bin/unix:$PATH
   cd $MINERVA_HOME
   gzip -d < minerva_UNIX.tar.gz > minerva_UNIX.tar
   tar xvf minerva_UNIX.tar
   

2. Add Your License Key

   Follow the instructions that came with your key.

   Now please have a first look at your MINERVA:

3. Invoke a simple applet.

   Invoke your Java enabled internet browser, e.g. netscape Specify the following address in the browser.

   	/usr/local/minerva/home.html
   

   Select ExamplePrograms, MinervaFeatures, then HelloWorld.

   Enter some words in the lower entry window. HelloWorld should echo these in the upper window.

   This confirms that your Internet browser operates correctly and that the MINERVA files were read correctly.

   If you installed MINERVA at the default location and your Web server set up to show /minerva at the top level, then you should be able to invoke your MINERVA applets via both "file:/..." and "http://..." URLs.

4. Confirm environment setting and correct installation of your Java

   Now let us invoke the HelloWorld Program, which you have used as an Applet before, as a standalone Java application.

   Open the command prompt and enter the following commands.

   	> cd $MINERVA_HOME
   	> ls
   

   If you find the following message, MINERVA_HOME is correctly set. If not, please check/correct the setting of $MINERVA_HOME.

   
   	bin bin_template com compiler ExamplePrograms..etc...
   

   Now confirm the proper setting of PATH. Enter the following command:

   	> minerva
   

   'minerva' is the MINERVA command line executive, invoked without parameters it will present a '?-' prompt. Leave MINERVA with 'halt.'.

   	MINERVA 2.4 Development Server (C) 1996,2003 IF Computer
   		:
   		:
   

   Now we are ready to invoke HelloWorld:

   	> cd $MINERVA_HOME/ExamplePrograms/MinervaFeatures/HelloWorld
   	> minervagui -l helloworld You and Me
   

   HelloWorld should echo your parameters "You and Me"

   	MINERVA 2.4 Development Server (C) 1996,2003 IF Computer
   		:
   		:
   	['You','and','Me']
   

   Showing that the MINERVA command line executive works fine. Then at the end, confirm the operation of MINERVA compiler:

   	>  minervac helloworld
   

   Will produce messages like:

   	compile: helloworld.min ->  helloworld.ass
   	generate interface: helloworld -> helloworld.mpk
   
   

   You just compiled on your machine a (simple) MINERVA program! This completes the confidence checks: applet operation, standalone operation, compilation. We suggest now that you have a look at the MINERVA documentation and play with the example programs provided. Some are very simple, others assume some knowledge of your operating system and Java.