Notes on installing OCS/OASYS

This is a binary distribution of the OPAL Compilation System which should run `out-of-the-box' on Linux 2/Intel and Solaris 2.5/Sparc. (On solaris, the GNU C compiler and GNU make program must be available).

Move the root directory of the distribution to a place of your choice (e.g. /usr/ocs or /usr/local/ocs). Do not use cp for this purpose; if you need to move across file-system boundaries, use tar (or unpack the distribution again in the other file system).

Note: on Solaris, it is currently necessary to use either /usr/local/ocs or /usr/ocs as the installation place (at least, a symbolic link from there to the installation place must exist). Otherwise, it will become necessary to define LD_LIBRARY_PATH to point to ocs/lib/sol2-sparc for running applications which are linked against Opal libraries which do indirectly base on other ones in the distribution (currently only OPAL_WIN and OPAL_READLINE).
Extend the search path to include the directory /usr/ocs/bin. Afterwards, the command ocs info should yield
```
    $ ocs info
->  You are using `ocs-2.3a'
->  located at `/usr/ocs'.
->  The project ($OCSPROJECT) is not specified.
```
Note that it's not possible to call ocs with an explicite absolute path; it must be found via the search path.
Try to compile and run some of the examples. The mini-tutorial gives guidance for doing so. On troubles, read the further notes below. If the troubles can't be fixed, don't hesitate to contact us.
If you want to use the Emacs/XEmacs mode, look at the instructions in /usr/ocs/lib/emacs/README.emacs.

Troubleshooting

There are two likely sources of troubles on the way of getting this distribution to work:

Unix commands are not found
OCS depends on a large amount of Unix commands, which are listed together with their absolute locations in /usr/ocs/lib/om/specs/Specs.basic. We have tried to use canonical pathes - whatever canonical means under Unix systems. The reference installation for the Linux version was Redhat 4.2 and for the Sparc version Solaris 2.5 (SunOS 5.5).
Typically, on Solaris the GNU tools (gcc and gmake) may be installed at different places as defined in Specs.basic.
If Specs.basic is changed, you need to make the changes manually also to ShSpecs.basic, or to run
```
  /usr/ocs/lib/om/etc/gmake2h < Specs.basic > ShSpecs.basic # sh
```
Shared libraries are not found
This should not happen on Solaris systems, since the code of non-standard features (such as Tcl/Tk and Readline) is included in the distribution. On Linux, it is expected that -lreadline, -ltcl, and -ltk are available as shared objects in the standard run path. Use ldd (ldd -s on Solaris) to analyze, and perhaps LD_LIBRARY_PATH or ldconfig to fix problems with shared libraries.

Notes on installing OCS/OASYS

Troubleshooting

The Opal Group Last modified: Sun Nov 30 01:11:47 MET 1997

The Opal Group
Last modified: Sun Nov 30 01:11:47 MET 1997