Support Apnea Board & OSCAR  

Difference between revisions of "OSCAR Installation: Linux"

From Apnea Board Wiki
Jump to: navigation, search

m (Linux version)
(Folder structure)
Line 6: Line 6:
  
 
==Linux version==
 
==Linux version==
 +
===Linux Installation Notes===
 +
 +
For version 1.1.0 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.
 +
 +
For '''Debian-based systems''', this is done in two steps:<br />
 +
 +
<prompt>$ dpkg -l | grep -i oscar<br />
 +
 +
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:<br />
 +
 +
<prompt>$ sudo dpkg --purge <package-name><br />
 +
 +
 +
For '''RPM-based systems''' (from v1.1.1), the procedure has two steps:<br />
 +
 +
<prompt>$ dnf list installed “oscar*”<br />
 +
 +
Don’t forget the quotes around oscar*. The first column has the package-name followed by the architecture. Then remove the package with:<br />
 +
 +
<prompt>$ sudo dnf remove <package-name><br />
 +
 +
 +
Once the old versions are removed, installation is straight-forward:
 +
 +
For '''Debian-based systems''':<br />
 +
 +
<prompt>:$ sudo dpkg -i <deb file><br />
 +
 +
assuming you are in the folder where you downloaded it.
 +
 +
For '''RPM-based systems''' (from v1.1.1), you may need to pre-install some libraries (the example below is for Fedora 31):<br />
 +
 +
<prompt>$ sudo dnf install mesa-libGLU-9.0.1-1.fc31<br />
 +
 +
<prompt>$ sudo dnf install qt5-qtserialport-5.12.5-1.fc31<br />
 +
 +
before you install OSCAR:<br />
 +
 +
<prompt>$ sudo dnf localinstall <rpm files><br />
 +
 +
Careful : you have to specify a path for localinstall. If the file is in the current
 +
directory, put ./ before it.
 +
 +
 
===Folder structure===
 
===Folder structure===
 
The folder structure is supposed to suit the FHS (Filesystem Hierarchy Standard)
 
The folder structure is supposed to suit the FHS (Filesystem Hierarchy Standard)
Line 14: Line 58:
 
* /usr/share/icons (icon files in some subdirectory)
 
* /usr/share/icons (icon files in some subdirectory)
 
* /usr/share/applications (.desktop file is the shortcut).
 
* /usr/share/applications (.desktop file is the shortcut).
 
  
 
===Ubuntu and Debian===
 
===Ubuntu and Debian===

Revision as of 17:51, 18 April 2020

Full-48.png

Afrikaans / في الصفحة / български / 中国 / 臺灣 / čeština/ Dansk / Deutsch / Ελληνικά / Español / Filipino / Français / עברית / Magyar / Italiano / 日本語 / 한국어 / Nederlands / Norsk / Polskie / Português / Română / Pусский / Suomalainen / Svenska / ภาษาไทย / Türkçe
--> Do not use these buttons when you are on a translated page. Just close this tab to go back. <--



Back to OSCAR Installation

Linux version

Linux Installation Notes

For version 1.1.0 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.

For Debian-based systems, this 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 dpkg --purge <package-name>


For RPM-based systems (from v1.1.1), the procedure has two steps:

<prompt>$ dnf list installed “oscar*”

Don’t forget the quotes around oscar*. The first column has the package-name followed by the architecture. Then remove the package with:

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


Once the old versions are removed, installation is straight-forward:

For Debian-based systems:

<prompt>:$ sudo dpkg -i <deb file>

assuming you are in the folder where you downloaded it.

For RPM-based systems (from v1.1.1), 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>

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


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).

Ubuntu and Debian

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

sudo dpkg -i [OSCAR package filename.deb]

Substitute the name of the package you downloaded. It is important to use sudo rather than install as root, so that the package will install the .desktop file in your account.

To remove OSCAR:

sudo dpkg -r oscar

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