From c5c5c95fbd40e981ed4b287fc8d7f4d5a798088a Mon Sep 17 00:00:00 2001 From: Bryan Newbold Date: Thu, 29 Aug 2019 12:35:21 +0200 Subject: document openssl 1.0/1.1 problem --- rust/README.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) (limited to 'rust/README.md') diff --git a/rust/README.md b/rust/README.md index fbac3bc3..86c25d29 100644 --- a/rust/README.md +++ b/rust/README.md @@ -20,9 +20,10 @@ do development work: - rust stable, 2018 edition, 1.34+ (eg, via "rustup", includes cargo tool) - diesel (`cargo install diesel_cli`) -- postgres (compatible with 9.6+; run 11.x in production) +- postgres (compatible with 9.6+; we run 11.x in production) - postgres libs (debian/ubuntu: `libsqlite3-dev libpq-dev`) - libsodium library and development headers (debian/ubuntu: `libsodium-dev`) +- OpenSSL 1.0 (not compatible with 1.1; see "OpenSSL 1.0" section below) We need to create a new `fatcat` postgres user and database to run tests and develop with. On debian/ubuntu, a UNIX account named `postgres` is @@ -59,6 +60,22 @@ Note that most "integration" level tests are written in python and run by See `HACKING` for some more advanced tips and commands. +### OpenSSL 1.0 + +Ubuntu bionic (18.04) and later ship with OpenSSL 1.1, you can install OpenSSL +1.0 with: + + # note that libssl1.0-dev conflicts with libssl-dev + sudo apt install openssl1.0 libssl1.0-dev + +And then build with: + + cargo clean + OPENSSL_LIB_DIR="/usr/lib/x86_64-linux-gnu" OPENSSL_INCLUDE_DIR="/usr/include/openssl" cargo build --release + +There is a [github tracking issue](https://github.com/internetarchive/fatcat/issues/42) +for this dependency problem. + ## Configuration All configuration goes through environment variables, the notable ones being: -- cgit v1.2.3