Update installation authored by Alan De Smet's avatar Alan De Smet
...@@ -107,37 +107,46 @@ The resulting executable is in glance/anaconda/bin/glance ...@@ -107,37 +107,46 @@ The resulting executable is in glance/anaconda/bin/glance
Minimal Development Install for Ubuntu and other Linux distributions Minimal Development Install for Ubuntu and other Linux distributions
==================================================================== ====================================================================
***THIS IS A WORK IN PROGRESS***
This is tested on a minimal Ubuntu 22.04 docker image (`docker pull ubuntu:22.04; docker run -it ubuntu:22.04`) as of 2022-09-27 by Alan De Smet.
For non-Ubuntu systems, you'll need to adjust package installation to your system. You will need:
You need git (to get glance) and python's venv module (to at least isolate glance's install, but also any other modules you need that aren't available from the system). - git
- python3
- python3's venv support
As root: On Debian or Ubuntu, this might do the job if you have sudo access:
``` ```
apt update sudo apt install git python3 python3-venv
apt install -y git python3-venv
``` ```
**Optional**: To allow glance to use system-wide module installations, do this. This takes about 933 MiB on a _minimal_ Ubuntu install. For other distributions you'll need to adjust package installation to your system.
As root: **Optionally**, you can install other dependencies system-wide. On Debian/Ubuntu this looks like:
``` ```
DEBIAN_FRONTEND=noninteractive apt-get install -y python3-numpy python3-matplotlib python3-mako python3-mock python3-scipy python3-pillow python3-cartopy python3-pil python3-netcdf4 python3-h5py libgeos-dev sudo DEBIAN_FRONTEND=noninteractive apt-get install -y build-essential python3-numpy python3-matplotlib python3-mako python3-mock python3-scipy python3-pil python3-cartopy python3-pil python3-netcdf4 python3-h5py libgeos-dev python3-venv python3.10-venv python3-setuptools-whl python3-pip-whl
``` ```
If you don't do so, the `pip` command later will handle installing from PyPI.
**Optional**: This provide a system-wind module isntall for the GUI components. It takes about 430 MiB on a _minimal_ Ubuntu install. **Optionally**, if you want the GUI, you'll need QT5 installed. If you're on Debian or Ubuntu, this might work:
As root: ```
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y libqt5gui5
```
**Optionally**, you can install the pyqt5 dependencies system-wide as well:
``` ```
apt install -y python3-pyqt5 sudo DEBIAN_FRONTEND=noninteractive apt-get install -y python3-pyqt5
``` ```
**If** you didn't install the system-wide packages, you'll need basic build tools to install some modules (at least cartopy). In that case, you'll need this. It's about 100 MiB on a _minimal_ Ubuntu install. **If** you didn't install the system-wide packages, you'll need basic build tools to install some modules (at least cartopy). In that case, you'll need this. It's about 100 MiB on a _minimal_ Ubuntu install.
As root: As root:
... ...
......