============================================================================ Installationsanleitung MultiBase/LINUX/UNIX - Testversion Version 2.0 Release 05 ============================================================================ ST&C Software Tools & Consulting GmbH, Burgdorf/Hannover Telefon 05136-5799, Telefax 05136-5795 GS&H Gesellschaft fr Soft- und Hardwarel”sungen bR, Bad Oeynhausen Telefon 05731-28741, Telefax 05751-44958 TransTOOLs, S.A., Madrid Telefon +34-1-3026138, Telefax +34-1-7668710 ---------------------------------------------------------------------------- MultiBase/LINUX/UNIX Januar 1995 I. MultiBase/LINUX/UNIX auf dem Server -------------------------------------- MultiBase liegt auf den verschiedenen Servern als Datei MultiBase.tar vor. Nach dem Dearchivieren dieser Datei erh„lt man im betreffenden Verzeichnis die z.T. gepackten Installationsdateien: total 4048 -rw-rw-rw- 1 root other 7689 Jan 28 11:21 INST_ENG.TXT -rw-rw-rw- 1 root other 7014 Jan 28 11:23 INST_GER.TXT -rw-rw-rw- 1 root other 1357147 Jan 26 23:41 MB2005.tgz -rw-rw-rw- 1 root other 98528 Jan 26 23:41 MBDemo.tgz -rw-rw-rw- 1 root other 19745 Jan 27 00:06 MBFiles -rwxrwxrwx 1 root other 654 Jan 27 14:14 MBInst -rw-rw-rw- 1 root other 295107 Jan 26 23:41 MBLinux.tgz -rw-rw-rw- 1 root other 465 Jan 27 00:01 MBMess -rw-rw-rw- 1 root other 1154011 Jan 26 23:41 MBqref.tgz -rw-rw-rw- 1 root other 724924 Jan 26 23:41 MBrefm.tgz -rw-rw-rw- 1 root other 429466 Jan 26 23:42 MBuserm.tgz -rw-rw-rw- 1 root other 9817 Jan 28 01:52 README.ENG -rw-rw-rw- 1 root other 8309 Jan 28 11:16 README.GER Erl„uterung der Dateiinhalte: MB2005.tgz : 4GL, Datenbankserver, Lower Case Tools etc. MBDemo.tgz : Demoanwendung (Lager) MBLinux.tgz: Linux Konfigurationsdateien MBqref.tgz : Quick Reference Guide (Postscript Format) MBrefm.tgz : Reference Manual (Postscript Format) MBuserm.tgz: User's Manual (Postscript Format) MBInst, MBMess, MBFiles : Installationsdateien README.ENG, README.GER : šber MultiBase II. INSTALLATION VON MULTIBASE ------------------------------- II.1 Besonderheiten fr die Linux Installation ---------------------------------------------- Fr den Betrieb von MultiBase/Linux ist der Linuxkernel ab Version 1.0.9 und der iBCS Emulator fr die entsprechende Version erforderlich. Ab der Kernelversion 1.1.x sind fr die šbersetzung des beiliegenden iBCS Quell- codes keine Patches erforderlich. Die Quellen befinden sich nach der Installation im relativen Pfad . Fr die šbersetzung des Moduls muá der Linuxkernel konfiguriert auf der Zielmaschine vorliegen. Das iBCS Modul wurde bis einschlieálich der Linuxversion 1.1.52 getestet. Zudem ist ein Tastatur- und Screenmapping notwendig. Alle erforderlichen Konfigurationsdateien und -programme sind unter dem relativen Pfad vorhanden. ! Das compilierte iBCS Modul wird von dem Shellscript im ! Verzeichnis erwartet. ! Sollte ein anderes Installationsverzeichnis gew„hlt werden, ist die ! Pfadangabe im Shellscript entsprechend zu „ndern. Nach erfolgreicher Installation muá das System fr den MultiBase/Linux Betrieb mit dem Befehl /.../ctl/mblinux/mblinuxstart konfiguriert werden. Die hierfr erforderlichen Programme und Einstelltabellen befinden sich im Konfigurationsverzeichnis /.../ctl/mblinux. In der Regel wird "..." "usr" sein. Es kann jedoch ein beliebiges Verzeichnis gew„hlt werden. Hierbei ist auf die Einstellung der entsprechenden Umgebungs- variablen zu achten! Soll das System bereits beim Start auf MultiBase/Linux Erfordernisse ange- paát werden, muá die Befehlszeile /.../ctl/mblinux/mblinuxstart in Abh„ngigkeit von der Linuxdistribution eingetragen werden in: /etc/rc.d/rc.local (DLD Distribution) oder /etc/brc (unifix Distribution). Im Konfigurationsverzeichnis /.../ctl/mblinux/mblinuxstart befindet sich auáerdem die auf deutsche Sonderzeichen eingestellte "bash". II.2 Installationsschritte -------------------------- ! Auf dem Zielrechner muá sich der GNU Komprimierer/Dekomprimierer ! befinden. 1. Der user "ctl" mit der Gruppenzugeh”rigkeit "other" muá erstellt werden. 2. Einloggen als user "ctl". 3. Als "ctl" user in den Superuser Mode ($su) wechseln. 4. Die oben aufgefhrten Installationsdateien mssen sich im Verzeichnis befinden. 5. Das Installationsscript aufrufen. 6. Fr jeden Systembenutzer, der auf MultiBase/Linux zugreifen m”chte, mssen in der Profile folgende Umgebungsvariablen gesetzt werden: PATH="$PATH:/.../ctl/bin" (... absoluter Pfadanteil) TRANSDIR="/.../ctl" (s. o.) MBLANG="german" (oder english oder spanish) TERM=con80x25 (abh. vom Betriebssystem: LINUX: con80x25 UNIX : AT386 ...) Weiter Umgebungsvariablen (DBMONEY,...) k”nnen dem Handbuch entnommen werden. 7. Zur Installation der Demoanwendung muá ein entsprechender user angelegt werden. Ferner sind die Umgebungsvariablen (s.o.) zu setzen. Anschlieáend muá man sich als entsprechender user einloggen. Nach Aus- fhrung des Programms wird die Demoanwendung automatisch installiert und gestartet. Sie enth„lt eine Anzahl an 4GL Quellpro- grammen, die einen ersten šberblick ber die Leistungsf„higkeit der 4GL (CTL) geben. 8. Fr Benutzer mit Linux Maschinen und HP Laserdruckern: Fr einen funktionierenden Ausdruck auf HP-Laserdruckern ist folgende Umgebungsvariable zus„tzlich zu setzen: DBPRINT="/.../ctl/mblinux/lptrans" III. Beschr„nkungen der Testversion ----------------------------------- 1. Der CTL (4GL) Compiler verarbeitet maximal 1800 Statements (4GL-Statements) pro Modul. 2. Die CTSQL beschr„nkt den Tabellenzugriff auf maximal 250 Zeilen pro Tabelle. IV. Auswahl der Portierungsliste von MultiBase/UNIX & MultiBase/UNIX-MOTIF -------------------------------------------------------------------------- PC 80386, 80486 ALTOS 386 Series xx 486 Series xx BULL DPX 2000 DPX 2/ xxx CONTROL DATA 4340 4360 4380 4680 DATA GENERAL AVIION xxxx DEC DECSTATION 2100, 3100, 5000/1xx, 5000, 5000-200 DECSYSTEM 3100, 5100, 5400, 5500, 58xx FUJITSU S-1400-1600 DS-90 xxx M-730 Mod. xx M-760 Mod. xx HEWLETT-PACKARD 9000/3xx 9000/4xx 9000 SERIES 500 9000 SERIES 600 9000/8xx IBM RS/6000 SNI RM-xx MX-xx Targon/31 ../32 ../35 Targon 3300, 4400 UNISYS 5000/xxx 6000/xxx 7000/xxx ============================================================================ Installation notes for MultiBase/LINUX/UNIX - evaluation copy Version 2.0 Release 05 ============================================================================ ST&C Software Tools & Consulting GmbH, Burgdorf/Hannover (GERMANY) Phone +49-5136-5799, Fax +49-5136-5795 GS&H Gesellschaft fr Soft- und Hardwarel”sungen bR, Bad Oeynhausen (GERMANY) Phone +49-5731-28741, Fax +49-5751-44958 TransTOOLs, S.A., Madrid (SPAIN) Phone +34-1-3026138, Fax +34-1-7668710 ---------------------------------------------------------------------------- MultiBase/LINUX/UNIX January 1995 ============================================================================ I. Getting MultiBase/LINUX/UNIX from the Server On the different servers the MultiBase package is stored in the file MultiBase.tar. After running the TAR program, there are the following packed files in the current directory: total 4048 -rw-rw-rw- 1 root other 7689 Jan 28 11:21 INST_ENG.TXT -rw-rw-rw- 1 root other 7014 Jan 28 11:23 INST_GER.TXT -rw-rw-rw- 1 root other 1357147 Jan 26 23:41 MB2005.tgz -rw-rw-rw- 1 root other 98528 Jan 26 23:41 MBDemo.tgz -rw-rw-rw- 1 root other 19745 Jan 27 00:06 MBFiles -rwxrwxrwx 1 root other 654 Jan 27 14:14 MBInst -rw-rw-rw- 1 root other 295107 Jan 26 23:41 MBLinux.tgz -rw-rw-rw- 1 root other 465 Jan 27 00:01 MBMess -rw-rw-rw- 1 root other 1154011 Jan 26 23:41 MBqref.tgz -rw-rw-rw- 1 root other 724924 Jan 26 23:41 MBrefm.tgz -rw-rw-rw- 1 root other 429466 Jan 26 23:42 MBuserm.tgz -rw-rw-rw- 1 root other 9817 Jan 28 01:52 README.ENG -rw-rw-rw- 1 root other 8309 Jan 28 11:16 README.GER Description of these files: MB2005.tgz : 4GL, Database server, Lower Case Tools and so on. MBDemo.tgz : Demo application (stock) MBLinux.tgz : Linux configuration files MBqref.tgz : Quick Reference Guide (in postscript format) MBrefm.tgz : Reference Manual (in postscript format) MBuserm.tgz : User's Manual (in postscript format) MBInst, MBMess, MBFiles : Files for installation README.ENG, README.GER : About MultiBase INST_GER.txt, INST_ENG.txt : Installation notes II. INSTALLATION OF MULTIBASE ------------------------------ II.1 Special procedures for Linux installation ---------------------------------------------- Before running MultiBase/Linux you have to do: - install the Linux Kernel ver. 1.0.9 or newer - compile the iBCS modul for the actual Linux kernel. The kernel must configured before compiling the iBCS modul! ********************** NOTE! *********************** * * * The iBCS sources you find in .../ctl/mblinux/iBCS. * * For Linux kernels 1.1.x no patches are necessary. * * * ****************************************************** MultiBase/Linux was tested including Linux kernel 1.1.52. After this release the iBCS modul was not running. In additional you have to map the screen and the keyboard. The necessary files are saved in .../ctl/mblinux. ********************* NOTE! ***************************** * * * The program to configure Linux for MultiBase will expect * * the configuration files in the absolute directory * * /usr/ctl/mblinux. If you have chose another directory * * like this, you must change the entries in this script * * (see the next lines!). * * * ************************************************************* Configuration script "mblinuxstart" in "/.../ctl/mblinux": echo "MultiBase/Linux Anpassung ..." /usr/ctl/mblinux/loadkeys /usr/ctl/mblinux/mblgr.tmap > ... # |---| |---| # depending of directory of installation you must change this! /usr/ctl/mblinux/mapscrn /usr/ctl/mblinux/mblct.smap # |---| |---| # depending of directory of installation you must change this! for t in 1 2 3 4 5 6 7 8 do echo -n -e "\\033(K" >/dev/tty$t done insmod /usr/ctl/mblinux/iBCS # |---| see above! After installation MultiBase/Linux enter /.../ctl/mblinux/mblinuxstart. Normally "..." will be "usr". If "..." is another partial path you set this in the environments variables. If the system should be configured while booting, you must insert the next line /.../ctl/mblinux/mblinuxstart into the file /etc/rc.d/rc.local (DLD Distribution) or in the file /etc/brc (unifix Distribution). II.2 Steps of Installation -------------------------- 1. You need the "gzip" programm from GNU to uncompress the MultiBase Files. 2. Create a user "ctl" belonging to the group "other". This user must exist within the system. 3. Login as user "ctl". 4. Invoke superuser "$su". 5. You must copy the files of installation into the directory "ctl". 6. Enter "MBInst". 6. Define the respective environment variables in the ".profile"-file of each user to access MultiBase and take care of exporting these variables. TRANSDIR="/.../ctl" ... the directory part where MultiBase is installed. PATH="$TRANSDIR/bin:$PATH" add TRANSDIR to your path MBLANG="english" or german or spanish MBTERM=con80x25 according to the terminal included in the $TRANSDIR/etc/termcap of your copy. Interactive: MBTERM=VGA (color), MBTERM=AT386 (mono) SCO: MBTERM=VGAansi (color), MBTERM=ansi (mono) Linux: MBTERM=console or MBTERM=con80x25 NOTE: To assign the right values to these variables consult Appendix D of the Reference Manual of MultiBase. II.3 Installation of MultiBase demo application ----------------------------------------------- 1. Create a user (mbdemo - for example) belonging to the group "other". 2. Login as user (mbdemo - for example). 3. To have the demo installed as a user type: $installdemo II.4 Special printer handling ----------------------------- Linux machines and HP laserprinters: Define the invironment variable DBPRINT="/.../ctl/mblinux/lptrans" III. Limitation of the evaluation copy -------------------------------------- 1. The CTL (4GL) Compiler compiled only 1800 statements (4GL-statements) for one modul. 2. The maximum of rows per table is 250. IV. Ports of MultiBase/UNIX & MultiBase/UNIX-MOTIF -------------------------------------------------- PC 80386, 80486 ALTOS 386 Series xx 486 Series xx BULL DPX 2000 DPX 2/ xxx CONTROL DATA 4340 4360 4380 4680 DATA GENERAL AVIION xxxx DEC DECSTATION 2100, 3100, 5000/1xx, 5000, 5000-200 DECSYSTEM 3100, 5100, 5400, 5500, 58xx FUJITSU S-1400-1600 DS-90 xxx M-730 Mod. xx M-760 Mod. xx HEWLETT-PACKARD 9000/3xx 9000/4xx 9000 SERIES 500 9000 SERIES 600 9000/8xx IBM RS/6000 SNI RM-xx MX-xx Targon/31 ../32 ../35 Targon 3300, 4400 UNISYS 5000/xxx 6000/xxx 7000/xxx