diff --git a/README.md b/README.md index b7d45ab0a..4474c5d1d 100644 --- a/README.md +++ b/README.md @@ -50,6 +50,17 @@ sudo apt install wget xfonts-75dpi cd /tmp ``` +To successfully install `wkhtmltopdf` you need `libssl1.1.1` +(You may need to install it manually because in newer versions of Ubuntu (e.g. 22.04 LTS) is used newer version of libssl, +which is not compatible with wkhtmltopdf). + +``` +wget http://nz2.archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl-dev_1.1.1f-1ubuntu2.16_amd64.deb +wget http://nz2.archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2.16_amd64.deb +sudo dpkg -i libssl-dev_1.1.1f-1ubuntu2.16_amd64.deb +sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2.16_amd64.deb +``` + `wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6-1/wkhtmltox_0.12.6-1.focal_amd64.deb` (choose your version) `sudo dpkg -i wkhtmltox_0.12.6-1.focal_amd64.deb` (of the correct version that you want to install) diff --git a/txmatching/web/frontend/README.md b/txmatching/web/frontend/README.md index 6153dd9a3..1bd2368f3 100644 --- a/txmatching/web/frontend/README.md +++ b/txmatching/web/frontend/README.md @@ -33,6 +33,8 @@ and then: npm -v ``` +Make sure Node.js is of the latest versions (preferably 18.0+). + ### Angular In Terminal or Command line run: @@ -40,6 +42,7 @@ In Terminal or Command line run: ``` npm install -g @angular/cli ``` +(In Ubuntu based system you may need to run it with superuser rights) It will globally install Angular on your machine. @@ -50,6 +53,17 @@ We use _openapi-generator_ to automatically generate TS files from swagger. Plea ``` npm install -g @openapitools/openapi-generator-cli ``` +(In Ubuntu based system you may need to run it with superuser rights) + +Here comes very interesting part: openapi generator from npm comes in quite old version +(at the time it is written) that is not very suitable us. Which shouldn't be a problem, +because it is updated during the first run of `make generate-swagger-all`, +but at least in Ubuntu it cannot be updated without superuser rights, so `make` commands will not work +(by some reason it is not possible to run `make` commands with superuser rights). +So the part of the installation is to run any openapi-generator command with superuser rights. +For example: `sudo openapi-generator-cli validate -i txmatching/web/swagger/swagger.yaml ` - this should +update openapi-generator as well as validate swagger.yaml. Further runs of commands from Makefile related +to swagger should not have any problems. ---