Installing Progress on Linux
----------------------------

This documentation contains the following sections:

        1. Installing iBCS
                a. Extract iBCS Software and read the README file
                b. Copy CONFIG.i386 To CONFIG
                c. Edit the CONFIG file
                d. Compile iBCS 
        2. Setting Up Progress
                a. Install Library Files
                b. Install Progress
                c. Fire Up Progress!


1. Installing iBCS
------------------

        a. Extract iBCS Software and read the README file
        -------------------------------------------------

        First, you need to install iBCS. iBCS is a SCO emulator for Linux. 
I used ibcs-2_0-971113_tar which extracts into an ibcs directory. This
directory is only an install directory so it doesn't matter where you put
it to start with.

        If you can't find a version of iBCS, you can download a version from 
my home page at www.bjl.com.au.

        When the software is extracted, read the README file for full
documentation. I'm sure the following 3 points are covered in that file.

        b. Copy CONFIG.i386 To CONFIG
        -----------------------------

        Most of the install is fairly straight-forward but there are a couple
things to note. Make sure you copy the CONFIG.i386 to CONFIG. This is
actually explained in the documentation.

        c. Edit the CONFIG file
        -----------------------

        Have a look at the Makefile and make any necessary changes. You should
not HAVE to change anything but the following would be useful:
        
        - find the section that deals with the
          different emulators. Obviously EMU_SCO should be "yes".
          Maybe leave EMU_SVR4 as "yes". The others are probably
          not necessary. Oh yeah, in any case turn EMU_X286 off!
          It doesn't actually hurt having it on, but it is confusing 
          when it barfs with loads of errors for that particular
          emulator. 

        - find the section that deals with trace flags. I suggest
          turning all _TRACE flags off. They waste space in the
          executable, and whenever I ran the iBCS tracer/debugger 
          it fell over with a core dump anyway.

        d. Compile iBCS 
        ---------------

        Compile iBCS. For those of you who aren't 'c' aware, at the prompt
type the following:

                        $ make

After it has compiled type:

                        $ make install

which will install the iBCS into /usr/..... where it will live with other
system packages. If you are having problems with make, it may be that an
incorrect 'c' compiler has been set up in the Makefile.

iBCS will be automatically available to the system. There are ways to load and
unload a module which is in the documentation (the README file).

That's it!


2. Setting Up Progress
----------------------

        a. Install Library Files
        ------------------------

        The Progress executables use specific library files from SCO UNIX.

        Copy the following SCO library files from your registered SCO UNIX
operating system into a directory (/scolib for example):

                ld.so.1
                libc.so.1
                libcrypt.so
                libsocket.so.1

        Make links to these files from /usr/lib. i.e. issue the following
commands from the /usr/lib directory (assuming you have put the files 
in /scolib):

                ln -s /scolib/ld.so.1 ld.so.1
                ln -s /scolib/libc.so.1 libc.so.1
                ln -s /scolib/libcrypt.so libcrypt.so
                ln -s /scolib/libsocket.so.1 libsocket.so.1

        There is a program called readelf (which you can download from
www.bjl.com.au) which will tell you what library files a particular ELF
executable needs. It is not mandatory to have this program since the files you 
need are listed above, but you may find it useful.

        b. Install Progress
        -------------------

        Install Progress V8.2 from the CD as per usual. All should be straight-
forward here.

        c. Fire Up Progress!
        --------------------

        Try starting Progress (make sure you've got DLC etc. setup). If it works
straight up - you're lucky! I have to run a COFF executable (once, when I login)
before Progress will start. So what I do is run 'showcfg' (or 'prodb' then 
control-C out) then start Progress and it works beautifully (server and all!).

        Have fun Progress-ing!

        Hope I helped!

        Brad.