Difference between revisions of "OSCAR Installation: Linux"

Latest revision as of 16:15, 3 June 2020

This article is part of the official OSCAR software project. (OSCAR Help)

Back to OSCAR Installation

Linux version

Linux Installation Notes

For version 1.1.0 and later the locations of the files used by OSCAR have changed to match the recommendations of the freedesktop.org. To accommodate this, it is recommended that any older versions of OSCAR, including -beta and -test versions, should be removed – more exactly, purged - before installation of version 1.1.0.

Note that removing the OSCAR package will not affect the OSCAR_Data that has already been imported.

To install OSCAR on Ubuntu or Debian, download the appropriate file from the official OSCAR web site for your platform.

Debian-based systems

First, purging is done in two steps:

<prompt>$ dpkg -l | grep -i oscar

will display long lines starting with two letters, followed by the package-name and then the version and more stuff.

The next step is to purge each package listed above, using:

<prompt>$ sudo apt purge <package-name>

If your long line started with three letters, especially if the third was an R, you will need to use the following:

<prompt>$ sudo dpkg --force-remove-reinstreq remove <package name>

Then, installation:

<prompt>:$ sudo apt install ./<deb file>

assuming you are in the folder where you downloaded it.

On Ubuntu 18.04 systems, this may result in a greyed-out square for the OSCAR desktop icon, and an incomplete installation.

The fix is to 'sudo apt remove oscar' and then repeat the installation step above.

RaspberryPi OS

This package has been tested on a Raspberry Pi 4B with 4 GB memory and a USB attached SSD, and it should work on a 3B or 3B+ with a USB attached hard drive. A separate SD card reader is also required.

The installation uses a terminal window, and is the same as the Debian systems above:

<prompt>$ sudo apt install ./<deb file>

RPM-based systems (not yet available from the official site, see below),

Purging has two steps:

<prompt>$ dnf list installed “oscar*”

Don’t forget the quotes around oscar*. The first column is the package-name followed by the architecture.

Then remove the package with:

<prompt>$ sudo dnf remove <package-name>

Then Installation You may need to pre-install some libraries (the example below is for Fedora 31):

<prompt>$ sudo dnf install mesa-libGLU-9.0.1-1.fc31

<prompt>$ sudo dnf install qt5-qtserialport-5.12.5-1.fc31

before you install OSCAR:

<prompt>$ sudo dnf localinstall <rpm files>

Be careful: you have to specify a path for localinstall. If the file is in the current directory, put ./ before it.

_________________________________________________________________________________________________

NEW Folder structure

The folder structure is supposed to suit the FHS (Filesystem Hierarchy Standard)

• /usr/bin/OSCAR (executable)
• /usr/share/OSCAR/ (Html & Translation files)
• /usr/share/doc (miscellaneous files need for package )
• /usr/share/icons (icon files in some subdirectory)
• /usr/share/applications (.desktop file is the shortcut).

Fedora, CentOS and Redhat

There is an unofficial repository with Fedora and CentOS/RHEL packages of OSCAR at Fedora Copr, maintained by a forum member.

To install in Fedora:

sudo dnf copr enable johanh/oscar
sudo dnf install oscar

To install in CentOS:

sudo yum install epel-release
sudo yum-config-manager --add-repo https://copr.fedorainfracloud.org/coprs/johanh/oscar/repo/epel-7/johanh-oscar-epel-7.repo
sudo yum install oscar

To uninstall, use Gnome Software or on command line "sudo dnf erase oscar" (Fedora) or "sudo yum erase oscar" (CentOS/RHEL). For further details, visit the referenced Fedora Copr page.

Source package is taken directly from the OSCAR project and compiled and packaged for the different Linux distributions (for security and integrity, source rpm package can be compared and verified with original source package if necessary). If there are any problems with the installation, contact johanh on the apneaboard forum.

Arch Linux

There is an OSCAR package in the Arch Linux user repository or AUR.

If you are using yay, you can install the oscar package with the following command:

sudo yay oscar-git

Similarly, with yaourt:

sudo yaourt -S oscar-git

The OSCAR package in AUR is available here: https://aur.archlinux.org/packages/oscar-git/

If you want to manually install packages from AUR, read the following short blog post: https://arashmilani.com/post?id=85

Donate to Apnea Board