[maverick-devel] how i loaded MaVerick on Ubuntu linux

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 454-5900

greetings MaVerick users & developers!

These are step by step instructions on how to load MaVerick on Ubuntu linux.
This same basic procedure should work on most of the "windows replacement"
linux distributions, as this is almost identical to what i did to load 
MaVerick on
Xandros (tho Xandros was easier).

PLEASE MODIFY THIS DOCUMENT!

i easily could have missed something, or am just plain wrong in spots.
i hope this is helpful.

- tom h

*make sure you have java installed on your system.
*it does not come packaged with ubuntu so you
*will have to download it. there are several ways, all
*outlined in various "how-to's" on the ubuntu website
*as well as the java website. i used "apt", and settled
*on just the "run time", but i'm on dial-up....
*my comments and instructions begin with "*", the stuff
*printed by the computer, or that you are supposed to type does not...

*its April 29, 2005.. i used the latest "snapshot" - maverick04Apr05...
*the prompts reflect this, if your using a different "snapshot", the
*prompts will be different...

*open the "root terminal" by clicking
*"applications" --> "system tools" --> "root terminal"
** you MUST be root? saves typing "sudo" before all the commands anyway...

*to find out if java is loaded and ready to go, type:

   java -version

*it should return: (something to this effect)

   java version "1.4.2-01"
   Java(TM) 2 Runtime Environment, Standard Edition (build 
Blackdown-1.4.2-01)
   Java HotSpot(TM) Client VM (build Blackdown-1.4.2-01, mixed mode)
   root@ubuntu:/usr/maverick-08Apr05 #

** YOU MUST HAVE JAVA! IF THIS DOES NOT WORK, THE REST IS POINTLESS...

*download the maverick "tar.gz" file from the maverick website
*"snapshots page", and copy it to the "/tmp" directory.

*then type:

   tar xzvf /tmp/maverick-08Apr05.tar.gz

*the "maverick-08Apr05" directory is created... see below, using "ls"

*type:
   ls

*it should return something like this...

   bin  games    info  local  maverick-08Apr05  pwm-20030617  share  X11R6
   doc  include  lib   mav    ppracer-0.3       sbin          src

*to change to the maverick directory, type:

   cd maverick-08Apr05

*add the maverick/bin directory to your path, type:

  export PATH=$PATH:/usr/maverick-08Apr05/bin

*** you will have to do this path thing everytime you
*** restart your computer (perhaps everytime you open a terminal?),
*** unless its put into some kind of bash startup file...

*to make sure the maverick/bin directory got added, type:

   $PATH

*this command should return something similiar to the below.

  bash: 
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/X11R6/bin:/
  usr/maverick-08Apr05/bin: No such file or directory

*to make the "BASIC", "RUN" and "MVSH" commands executable from the bash 
prompt.
*type:

   cd bin

*at the prompt, which should look similiar to this...

   root@ubuntu:/usr/maverick-08Apr05/bin #

*type:

  chmod a+x BASIC
  chmod a+x RUN
  chmod a+x MVSH

*the above command, whatever it means, makes the files "executable".

*we must "fix" the "maverick.properties" file...
*go to the "maverick-08Apr05/etc" directory
*type:

  cd ..

*this will take you back to:

  root@ubuntu:/usr/maverick-08Apr05 #

*then type:

  cd etc

*this will take you to:

   root@ubuntu:/usr/maverick-08Apr05/etc #

*edit the "sample.maverick.properties" file in the "etc" directory

*type:

   gedit sample.maverick.properties

*this opens the "gedit" text editor, with the "sample.maverick.properties" 
file loaded.
*remove the "#" signs at the beginning of the lines:

*      this one -->      # org.maverickdbms.basic.shell=/usr/bin/sh
*  and this one -->      # org.maverickdbms.basic.shell_args= -c {0}

* theyre about half-way down...

*click on the "File" menu option. click on the "Save As" button.
*******************************************************************************
*SAVE THE FILE AS "maverick.properties" - NOT as 
"sample.maverick.properties"
*******************************************************************************
*quit the "gedit" editor.

* set up the ud resolver... kind of an emulator for unidata

* make a directory to hold your "ACCOUNT"
*type:

   mkdir tom (or whatever you may wish this directory to be named)

* go to the new directory
*type:

   cd tom

*your prompt should look like this now...

   root@ubuntu:/usr/maverick-08Apr05/tom #

*replace "tom" with whatever you named your directory ;)

* create the "ACCOUNT"
*type:

   RUN org.maverickdbms.resolver.ud.CREATE_056ACCOUNT

*alright, the "_056" is there because java changes the "." to "_056"
*i dont know why...

*check the account to see if it got created.
*type:

   ls

*this command should return something to this effect

   D_VOC.LK  D_VOC.OV  VOC.LK  VOC.OV

* start the "UD RESOLVER" and the maverick "SHELL"

   RUN org.maverickdbms.resolver.ud.Resolver SH

*you should now be at the ":" prompt.

* list the contents of the "VOC"

*type:

   LIST VOC
*it should return the following file listing...

D_VOC.....

BASIC
CAL
CLEARDATA
CLR
COPY
COPYP
COPYU
COUNT
CREATE.FIL
CREATE-FIL
CLEAR.FILE
CLEAR-FILE
CS
DATE
DELETE
DELETE.FIL
DELETE-FIL
ED
LIST
PAGE
SORT
SSELECT
TIME
SELECT
SH
VOC
26 records listed.

** create a 'BP' (basic programs) FILE
*type:

   CREATE-FILE BP DIRECTORY

*list the 'BP' file, to see if it got created...
*type:

   LIST BP

*it should return the following...

  D_BP......
  0 records listed.

*make a 'HELLO WORLD' program
*we will call it 'TEST.BAS'
*we will use the "ED" line editor, I am hoping
*you have some familiarity with it..

:ED BP TEST.BAS
New Item
Top
----:I
0001=CRT 'HELLO WORLD'
0002=
----:FI
TEST.BAS Filed in BP

* compile the TEST.BAS program

:BASIC BP TEST.BAS

* 'CATALOG' the new test item

:ED VOC TEST
New Item
Top
----:I
0001=C
0002=BP/_TEST
0003=
----:FI
TEST Filed in VOC

* run the program

:TEST
HELLO WORLD
:

*welcome to the community, the world is your oyster. -tom h