badenh / glow-ubuntu-install-helpers

Ubuntu OS variant helper install/configure scripts for Pytorch Glow

glow-ubuntu-install-helpers

Ubuntu OS variant helper install/configure scripts for Pytorch Glow https://github.com/pytorch/glow By necessity, there's some comments / configuration with LLVM and clang as well.

Summary of what works/what doesnt

Ubuntu Version	LLVM Installed	Buildable	Upgrade Options
16.04	LLVM 6	No	To LLVM 8+
16.04	LLVM 7	No	To LLVM 8+
16.04	LLVM 8	Yes
16.04	LLVM 9	Yes
16.04	LLVM 10	Yes
18.04	LLVM 6	No	To LLVM 8+
18.04	LLVM 7	No	To LLVM 8+
18.04	LLVM 8	Yes
18.04	LLVM 9	Yes
18.04	LLVM 10	Yes
19.04	LLVM 8	Yes
19.10	LLVM 9	Yes
20.04	LLVM 10	Yes

Ubuntu 16.04 Xenial Xerius and LLVM 7

Ubuntu 16.04 Xenial Xerius ships with an outdated version of LLVM (version 6 ... ) - see https://packages.ubuntu.com/xenial/devel/llvm

Building Glow on Ubuntu 16.04 with LLVM 7 will fail because LLVM 7 distribution from Xenial uses an older C++ ABI.

On Ubuntu 16.04, the minimum you need to upgrade to is LLVM 8. To update to LLVM 8, you can run:

sudo apt-get install clang clang-8 cmake graphviz libpng-dev \
    libprotobuf-dev llvm-8 llvm-8-dev ninja-build protobuf-compiler wget \
    opencl-headers libgoogle-glog-dev

Then follow the configure/build instructions from https://github.com/pytorch/glow#configure-and-build

Ubuntu 16.04 Xenial Xerius and LLVM 8

If you have LLVM 8, you can simply follow the configure/build instructions from https://github.com/pytorch/glow#configure-and-build

Ubuntu 16.04 Xenial Xerius and LLVM 9

To update to LLVM 9, you can run:

sudo apt-get install clang clang-9 cmake graphviz libpng-dev \
    libprotobuf-dev llvm-9 llvm-9-dev ninja-build protobuf-compiler wget \
    opencl-headers libgoogle-glog-dev

Then follow the configure/build instructions from https://github.com/pytorch/glow#configure-and-build

Ubuntu 18.04 Bionic Beaver and LLVM 8

Ubuntu 18.04 Xenial Xerius ships with an outdated version of LLVM (version 6 ...) - see https://packages.ubuntu.com/bionic/llvm and must be updated in order to build Glow.

Building Glow on Ubuntu 16.04 with LLVM 7 will fail because LLVM 7 distribution from Xenial uses an older C++ ABI.

On Ubuntu 18.04, the minimum you need to upgrade to is LLVM 8. To update to LLVM 8, you can run:

sudo apt-get install clang clang-8 cmake graphviz libpng-dev \
    libprotobuf-dev llvm-8 llvm-8-dev ninja-build protobuf-compiler wget \
    opencl-headers libgoogle-glog-de

Then follow the configure/build instructions from https://github.com/pytorch/glow#configure-and-build

Ubuntu 18.04 Bionic Beaver and LLVM 9

TODO

Ubuntu 19.04 Disco Dingo and LLVM 8

Ubuntu 19.04 Disco Dingo ships with LLVM 8 by default - see https://packages.ubuntu.com/disco/llvm

If you want to build Glow against LLVM 8, you can simply install the other dependencies:

sudo apt-get install clang clang-8 cmake graphviz libpng-dev \
    libprotobuf-dev ninja-build protobuf-compiler wget \
    opencl-headers libgoogle-glog-dev

Then follow the configure/build instructions from https://github.com/pytorch/glow#configure-and-build

Ubuntu 19.04 Disco Dingo and LLVM 9

TODO

Ubuntu 19.04 Disco Dingo and LLVM 10

TODO

Ubuntu 19.10 Eoan Ermine and LLVM 9

Ubuntu 19.10 Eoan Ermine ships with LLVM 9 by default - see https://packages.ubuntu.com/eoan/llvm

Follow the configure/build instructions from https://github.com/pytorch/glow#configure-and-build to build Glow.

Ubuntu 19.10 Eoan Ermine and LLVM 10

Ubuntu 19.10 Eoan Ermine ships with LLVM 9 by default - see https://packages.ubuntu.com/eoan/llvm

[UPGRADE]

Then follow the configure/build instructions from https://github.com/pytorch/glow#configure-and-build to build Glow.

Ubuntu 20.04 Focal Fossa and LLVM 9

Ubuntu 20.04 Focal Fossa ships with LLVM 10 by default - see https://packages.ubuntu.com/focal/llvm If for some reason you wish to downgrade to LLVM <10, then you'll need to do a couple of things:

TODO

Then follow the configure/build instructions from https://github.com/pytorch/glow#configure-and-build to build Glow.

Ubuntu 20.04 Focal Fossa and LLVM 10

Ubuntu 20.04 Focal Fossa ships with LLVM 10 by default - see https://packages.ubuntu.com/focal/llvm

Follow the configure/build instructions from https://github.com/pytorch/glow#configure-and-build to build Glow.

General Notes

It may be desirable to use update-alternatives to manage the version of clang/clang++ on your system:

sudo update-alternatives --install /usr/bin/clang clang \
    /usr/lib/llvm-8/bin/clang 50
sudo update-alternatives --install /usr/bin/clang++ clang++ \
    /usr/lib/llvm-8/bin/clang++ 50

Glow uses the system default C/C++ compiler (/usr/bin/c++), and so you may also want to switch your default C/C++ compiler to clang:

sudo update-alternatives --config cc
    # Select the option corresponding to /usr/bin/clang ...
sudo update-alternatives --config c++
    # Select the option corresponding to /usr/bin/clang++ ...

Glow should build just fine with gcc (e.g. gcc 5.4), but we mostly use clang and are more attentive to compatibility with clang.

Finally, in order to support the ONNX net serialization format, Glow requires protobuf >= 2.6.1, but the above command may install older version on older Ubuntu (e.g. 14.04). If this is the case, we suggest to look at https://github.com/pytorch/glow/blob/master/utils/install_protobuf.sh to install a newer version from source.

LLVM Packaging

LLVM is packaged for various distros, see https://apt.llvm.org/

Ubuntu Packaging/Inclusion of LLVM

Ubuntu packages and includes LLVM and some related tools, see https://packages.ubuntu.com/search?suite=default&section=all&arch=any&keywords=llvm&searchon=names