Installation#

To run an Oasis application, you must install the Oasis libraries, the kernel module driver for the Oasis File System, and the Oasis File System tools.

Installing Libraries#

Copy the Oasis library package to your installation directory (e.g., /opt/oasis/lib).

If you are using the Oasis audio component, ensure that the system directory containing libasound.so (ALSA library) takes priority.

For example, if libasound.so is located in /usr/lib and the Oasis libraries are in /opt/oasis/lib, configure the path as follows:

export LD_LIBRARY_PATH=/usr/lib:/opt/oasis/lib

to set the LD_LIBRARY_PATH environment variable, and then execute the application.

Alternatively, execute it by running:

LD_LIBRARY_PATH=/usr/lib:/opt/oasis/lib <enter application path and arguments>

Installing the Driver#

Copy the offs.ko kernel module file to your installation directory (e.g., /opt/oasis/module).

Create a file named S91Offs in the /etc/init.d directory with the following content:

#!/bin/sh

case "$1" in
  start)
    if [ -f "/opt/oasis/module/offs.ko" ]; then
      insmod /opt/oasis/module/offs.ko
    fi
  ;;
  stop)
  ;;
esac

If you do not use the /etc/init.d startup scripts, manually execute the following command before starting the Oasis application:

insmod /opt/oasis/module/offs.ko

Installing File System Tools#

Copy the three executable files built for the target device (offs.fuse, mkfs.offs, fsck.offs) to your installation directory (e.g., /opt/oasis/bin).

Modify the PATH environment variable as follows:

export PATH=/opt/oasis/bin:$PATH