Skip to content

Latest commit

 

History

History
96 lines (65 loc) · 3.39 KB

fedora.md

File metadata and controls

96 lines (65 loc) · 3.39 KB

Installing the OpenQuake Engine on Fedora

The OpenQuake Engine is available in the form of rpm binary packages for Fedora.

For RHEL/CentOS please check "Installing the OpenQuake Engine nightly builds on RHEL/CentOS".

Install packages from the OpenQuake repository

The following command adds the official stable builds package repository:

sudo dnf copr enable gem/openquake-stable

Then to install the OpenQuake Engine and its libraries run

sudo dnf install python3-oq-engine

If you want to install a nightly build please read the guide about installing the nightly build packages on Fedora.

Upgrade from a previous release

As soon as a new version of the OpenQuake Engine and libraries are released you can upgrade it using dnf or a graphical package manager:

sudo dnf upgrade python3-oq-engine

If a full upgrade is performed on the system, the OpenQuake software is upgraded to the latest version too:

sudo dnf upgrade

The software and its libraries will be installed under /opt/openquake. Data will be stored under /var/lib/openquake.

Configure the system services

The package installs three systemd services:

  • openquake-dbserver.service: provides the database for the OpenQuake Engine and must be started before running any oq engine command
  • openquake-webui.service: provides the WebUI and is optional
  • openquake-celery.service: used only on a multi-node setup, not used in a default setup

To enable any service at boot run

sudo systemctl enable openquake-dbserver.service

To manually start, stop or restart a service run

sudo systemctl <start|stop|restart> openquake-dbserver.service

To check the status of a service run

sudo systemctl status openquake-dbserver.service

(openquake-dbserver.service can be replaced by openquake-webui.service or openquake-celery.service)

Run the OpenQuake Engine

Continue on How to run the OpenQuake Engine

Test the installation

To run the OpenQuake Engine tests see the testing page.

Uninstall the OpenQuake Engine

To uninstall the OpenQuake Engine and all its components run

sudo dnf erase python3-oq-*

Data cleanup

To reset the database oq reset command can be used:

sudo systemctl stop openquake-dbserver.service
sudo -u openquake oq reset
sudo systemctl start openquake-dbserver.service

To remove all the data produced by the OpenQuake Engine (including datastores) you must also remove ~/oqdata in each users' home. The reset-db bash script is provided, as a reference, in /usr/share/openquake/engine/utils.

If the packages have been already uninstalled, it's safe to remove /var/lib/openquake.

Getting help

If you need help or have questions/comments/feedback for us, you can: