PIA Back & Front Installation Runbook

[ylachgar]

Hi All,
Please review and correct if needed the below runbook for full installation of PIA back and Front on a ubuntu 17.10 server.

Thanks for helping me and the community 👍
PIA Installation Runbook V1.2.docx

Updated version 1.6.0 (01/03/2018)

[iouss]

Hi Ylachgar,
Thank you for your documentation
:) I hope that will help other users of this application
Thnaks

[CdIndre36]

Bonjour,
merci pour la doc. Après des jours de galère l'application est enfin opérationnelle.
Dans le point 7 (Configure PIA Tool), il est indiqué de saisir l'Url du serveur Back-end.
Or cette saisie n'est valable que pour 1 utilisateur. Est-il possible de l configurer pour tous les utilisateurs?

Dans un autre post vous demandiez s'il était possible des créer des groupes/utilisateurs.
Avez-vous une réponse?
Cordialement

[iouss]

Bonjour,

Oui effectivement il n'y a pas de notion utilisateur et groupe, j'aimerai aussi qu'on intègre l'authentification dans ce projet.
je vais essayer de voir de mon coté cette fonctionnalité.

cdt,

[CdIndre36]

Bonjour,
et pour le paramétrage de l'URL, y-a-t-il une solution?
Merci

[ylachgar]

Bonjour @CdIndre36

Il doit forcement avoir une variable a indiquer pour appliquer la conf par default mais il faut que nos amis les dev nous aide un peu la dessus.

[brunto]

Bonjour,
Concernant l'URL à spécifier, pour pouvoir utiliser l'API, elle est à spécifier pour chaque utilisateur.
Cette URL est stockée dans la "base de données" du navigateur (ou de l'application standalone) de l'utilisateur.
Il n'est pour le moment pas possible de faire autrement.
J'en profite pour vous remercier pour le Runbook, nous allons prendre un moment pour le relire.

[CdIndre36]

Bonjour,
merci pour la réponse de l'Url.
Concernant la documentation, il serait bien aussi quelle existe pour l'installation des mises à jour.
Je ne pense pas que les MAJ nécessitent une réinstallation complète.
Merci

[ylachgar]

Bonjour,

Je suis complètement d'accord surtout qu'après le test de la nouvelle version j'ai quelques erreur que je n'arrive pas a expliquer :) je vais ouvrir un ticket sur ce point

[Logicsystem360]

Bonjour,

J'ai lu ton docx. Il faut faire attention car tu lances PIA front toujours en mode developpeur, pour lancer véritablement en mode prod il faut générer le dossier dist avec ng build --prod et le copier coller dans le dossier www d'apache (ou équivalent)

Et pour le pia-back, suffit de rajouter l'option -d pour le lancer en daemon, plus pratique pour du mode production (sans oublier le -e production)

[ylachgar]

Bonjour @Logicsystem360

Merci pour les infos, en effet j'ai oublié d'indiquer dans la doc l'étape ng build --prod (@brunto il faudra le rajouter si on utilise ce Run Book comme référence), pour la partie Daemon, en effet beaucoup plus simple :)

[danilodelfio]

Thank you for the documentation. I would like to suggest a simple modification ... at the beginning, we talk about angular js, while the client application uses angular (without JS referring to version 1 of the framework). Regards

[ylachgar]

Thanks for the info, i will update the Doc :)

[CdIndre36]

Bonjour,
Un petit résumé svp, des commandes complètes à lancer après un reboot du serveur, pour etre dans environnement de production sur.
merci

[ylachgar]

Bonjour,

Je vais rajouter ça, je suis en ce moment en train de tester les nouvelles versions sur un server vierge pour update le Run Book.

[CdIndre36]

Bonjour,
avez-vous pu avancer sur la doc d'installation et/ou de mise à jour?
Merci

[Winny97]

Bonjour,

1. Merci pour cette doc très utile. Quelques points à changer :
   La commande de l'Etape 4.1 ne fonctionne pas. j'ai du faire la commande :
   command curl -sSL https://rvm.io/mpapis.asc | gpg --import -

2. Aussi, je souhaite savoir comment dois je lancer le back end et le front end en mode Prod sans bloquer l'interface console sur la commande ???
   Merci

[Winny97]

Bonjour,
Finalement j'ai pu résoudre ma problématique.

J'apporte mon aide pour ceux qui souhaitent sécuriser la solution en Https.
Il faut le faire pour le FRONTEND et BACKEND (dans mon cas ils utilisent la meme IP tous les deux)

1. Tout d'abord créer un dossier pour déposer votre certificat autosigné et sa clé privée.

2. BACKEND : La nouvelle commande de lancement est
   bin/rails s -e production -b 'ssl://VotreIP:votrePort?key=/Votre_che min/pia.key&cert=/Votre_chemin/pia.crt'

3. FRONTEND :
   sudo ng serve -ssl --sslKey /Votre chemin/pia.key --sslCert /Votrechemin/pia.crt --publicHost VotrenomDNS -e prod -host VotreIP -port 443

ps : (pia.key & pia.crt sont à remplacer par vos certficats)

[ghost]

Bonjour,
ou trouver la dernière version du runbook ?

au lieu de faire un runbook, n'est il pas mieux de faire un article dans le wiki github ?

merci

[ylachgar]

Bonjour à tous,

La version update du Runbook vera le jour fin de semaine avec les tips accumulés :)
Je suis assez d'accord pour le Wiki je vais checker ça !

[rajeshdorai]

Hi All,
I am about to install PIA tool, can you please recommend whether i should install front end or back end version, i cannot find a document which explains the functional difference between these two though backend install seems lot more heavy weight. Please help.

Thanks

[iSpeeX]

Bonjour,
J'ai essayer de suivre votre documentation, mais elle n'est pas très claire.
Je pensais avoir réussi toutes les étapes jusqu'à la partie 5, mais je commence à penser que les problèmes que j'ai maintenant proviennent des étapes précédentes.

Pourrais-je vous contacter pour avoir plus de détails sur certaines étapes ?

En tout cas, bonne initiative, bravo.

@Logicsystem360 Quand vous parlez du "dossier dist", ou se trouve-t-il ?
J'ai tout fait, mais je me retrouve avec un site fonctionnel en localhost et pas en distant, j'ai utiliser un seul serveur et sa propre IP pour le front et le back.

Merci d'avance,
Cordialement.

[FanchTheSystem]

Quand vous parlez du "dossier dist", ou se trouve-t-il ?

@iSpeeX C'est le répertoire créé par la commande 'ng build', avant cette commande il n'existe pas.
Il est dans le répertoire où tu as cloné pia

[iSpeeX]

@FanchTheSystem
J'ai utilisé la commande : ng build --prod --build-optimizer -sourcemaps
Toutefois, je n'ai pas de dossier "dist" sous /pia. Est-ce normal ?

Si je comprends bien, pour rendre l'application accessible en réseau, il faut installer un service de serveur web pour y mettre l'arborescence du website de l'app générée par la commande "ng build" ?
Pourtant, lors de mes essais du PIA-BACK, je n'ai pas eu besoin d'un service web, la page était accessible en réseau directement.

Merci pour votre réponse.

[FanchTheSystem]

Attention quand tu lance une autre commande "ng", alors ça supprime ton répertoire dist

Tu peux utiliser soit "ng serve" sans serveur web, soit "ng build" pour copier coller le répertoire dist sur ton serveur web.

[iSpeeX]

@FanchTheSystem Je vois, mais lorsque je lance uniquement ma commande "ng serve" avec l'IP de la machine et un port particulier, j'ai bien la favicon PIA, mais sinon il ne trouve pas de page.

Pourrais-je vous contacter directement ?

Si cela ne vous dérange pas bien sûr,
Merci.

[FanchTheSystem]

Désolé je ne fais pas de support privé.

A priori si tu as la favicon mais pas le site, c'est effectivement et probablement un problème à une des étapes de l'installation.
Je te conseil de recommencer du début et bien lire les éventuels messages d'erreur.

C'est peut-être aussi un souci de version de nodejs, perso j'utilise la 8.11.1

[iSpeeX]

@FanchTheSystem Je comprends. Merci quand même.
Le fait est que la page s'affiche bien en localhost.

En copiant le dossier "dist" sous "var/www/html" j'accède bien à la page, mais je suis bloqué sur l'icone de chargement, est-ce que quelqu'un a déjà rencontré ce problème ?
EDIT : Ne fonctionne pas sur IE, mais sur Firefox OK

[BernieC61]

Ok pour session team viewer ou autre demain matin si vous pouvez

[brunto]

Je vais essayer de reproduire l'erreur avec les mêmes versions, je vous tiens au courant.
Sachez que vous pouvez utiliser la version standalone de l'application en attendant : https://github.com/LINCnil/pia-app/releases/tag/2.1.0

[BernieC61]

PIA est sur un serveur et l'utilisateur n'a pas d'accès à celui ci.
je vais quand même regarder cette appli standalone.

[BernieC61]

et merci de votre aide.

[BernieC61]

Bonjour Mr Perles, Avez vous pu regarder notre problème d'installation de PIA front-office sur Ubunto 18.04 LTS ?

[BernieC61]

Bonsoir Mr Perles,
Je suis en attente de votre réponse concernant le problème de finalisation d'installation de PIA front-office sur Ubunto 19.04 LTS

[brunto]

Bonsoir,
Pouvez-vous m'écrire par email directement ?

[BernieC61]

Ok je l'ai fait ce matin mais comme je n'avais pas eu de réponse j'ai eu le doute sur le fait que vous ayez reçu le mail.
Dorénavant je passerai par le mail.

[brunto]

Je n'ai pas eu d'email ce matin ! Vous écrivez bien à bruno@atnos.com ?

[Flo-island]

Bonjour,

Avez vous un Runbook en 2.X pour les versions Backend et Frontend ou doit-on utiliser le runbook précédent svp ?

Merci de votre aide.

[JohnMcReady]

Bonjour,

Tout d'abord MERCI à tous (dev et contributeurs) pour le travail et la résolution des bugs.

Un gros point noir actuellement est clairement la non gestion de l'authentification (AD) mais j'ai cru comprendre que cela va bientôt être implémenté ?

Je voulais savoir aussi si vous aviez un Runbook à jour ou un Wiki ? Je suis avec la version 1.2 du 12/02/2018 ...

Et pour finir j'ai fait l'installation sous centOS 7.5 (Bo et Fo) donc si vous avez besoin je peux fournir les commandes et les 2 ou 3 problèmes rencontrés.

A+

[aalexand-fr]

Bonjour,

Installation sur debian 9.9. L'application back-office fonctionne.
Problème lors de la commande ng serve voici le stderr:
:/opt/pia# ng serve
internal/modules/cjs/loader.js:638
throw err;
^

Error: Cannot find module 'debug'
at Function.Module._resolveFilename (internal/modules/cjs/loader.js:636:15)
at Function.Module._load (internal/modules/cjs/loader.js:562:25)
at Module.require (internal/modules/cjs/loader.js:690:17)
at require (internal/modules/cjs/helpers.js:25:18)
at Object. (/opt/angular-cli-master/lib/bootstrap-local.js:10:15)
at Module._compile (internal/modules/cjs/loader.js:776:30)
at Object.Module._extensions..js (internal/modules/cjs/loader.js:787:10)
at Module.load (internal/modules/cjs/loader.js:653:32)
at tryModuleLoad (internal/modules/cjs/loader.js:593:12)
at Function.Module._load (internal/modules/cjs/loader.js:585:3)

Quelqu'un aurait-il une idée ?

Cordialement
Alain

[spiritseb]

Bonjour,

Pas simple le runbook, en plus avec une version ubuntu non LTS.

Bon néanmoins merci car avec l'aide de ce de dernier et de plusieurs pages internet dont je ne cite pas les sources par manque de temps (sorry).

Voici un runbook centos7 fonctionnel.
Centos7.txt

La partie update n'a pas été testée.

Cordialement,

Seb

[nechifornicolae]

thank you for the info on CentOS 7 - I have followed the steps but I'm having a bit of a problem on
running bundle install. In my understanding this must be run as user pia.

. bundle install
bash: bundle: line 2: syntax error near unexpected token (' bash: bundle: line 2: ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', FILE)'

what am I missing?

---

probably a permission issue on my pia account, I'm able to run it fine under root

---

figured it out, I've installed ruby under root and not under the pia user.b
bundler running fine now

regards,
Nicolae

[lolosoleil]

Bonjour à tous,

Après des jours de galère, je demande de l'aide car je sens que je ne vais pas m'en sortir.

Je veux donc installer l'outil PIA sur la dernière LTS Ubuntu (18.04)

J'au réussi à installer le Back-End. Il fonctionne (Page Web OK)

Par contre, au niveau Front, je ne m'en sors pas :(

Premièrement lorssque je lance la commande sudo npm install npm@latest -g, je me fais jeter car la commande npm est introuvable. J'ai donc fait un sudo apt-get install npm, puis relancé sudo npm install npm@latest -g, puis sudo npm install -g @angular/cli (j'ai énormément de warning sur des problèmes de compatibilité de paquets ...)
Je génère ensuite le fichier environment.prod.ts (testé avec ou sans modification de la version 1.6.0)
C'est maintenant qu'arrive le point de blocage : sudo ng build --prod --build-optimizer –sourcemaps

You are running version v8.10.0 of Node.js, which is not supported by Angular CLI 8.0+.
The official Node.js version that is supported is 10.9 or greater.

Please visit https://nodejs.org/en/ to find instructions on how to update Node.js.

Avez vous eu ce genre de problématique ? Comment vosu en êtes vous sorti ?

Merci !

[snelhard]

Bonjour,

@lolosoleil https://www.hostingadvice.com/how-to/update-node-js-latest-version/ le point 2 fonctionne

Sinon j'ai un problème aussi et j'aurais besoin d'aide s'il vous plait, lorsque je lance la commande "sudo ng build --prod --build-optimizer –sourcemaps" j'ai cette erreur :

Unknown option: '-d'
Unknown option: '-r'
Unknown option: '–sourcemaps'

Lorsque je fait "ng build" j'ai cette erreur :

ERROR in ./src/styles.scss (./node_modules/@angular-devkit/build-angular/src/angular-cli-files/plugins/raw-css-loader.js!./node_modules/postcss-loader/src??embedded!./node_modules/sass-loader/lib/loader.js??ref--14-3!./src/styles.scss)
Module build failed (from ./node_modules/sass-loader/lib/loader.js):
Error: Cannot find module 'node-sass'
Require stack:

• /home/rootdom/pia/node_modules/sass-loader/lib/loader.js
• /home/rootdom/pia/node_modules/loader-runner/lib/loadLoader.js
• /home/rootdom/pia/node_modules/loader-runner/lib/LoaderRunner.js
• /home/rootdom/pia/node_modules/webpack/lib/NormalModule.js
• /home/rootdom/pia/node_modules/webpack/lib/NormalModuleFactory.js
• /home/rootdom/pia/node_modules/webpack/lib/Compiler.js
• /home/rootdom/pia/node_modules/webpack/lib/webpack.js
• /home/rootdom/pia/node_modules/@angular-devkit/build-webpack/src/webpack/index.js
• /home/rootdom/pia/node_modules/@angular-devkit/build-webpack/src/index.js
  ...... (La liste est longue)

Merci !

[brunto]

Bonjour @snelhard,
Il faut enlever --sourcemaps : sudo ng build --prod --build-optimizer
ou plus simplement utiliser yarn prod
Je vais mettre à jour le README.

[brunto]

Bonjour @lolosoleil,
Vous utilisez la version 8 de Angular CLI il vous faut installer la version 7.
Voir le fichier package.json : https://github.com/LINCnil/pia/blob/master/package.json#L48

[snelhard]

Tout fonctionne à merveille !
Merci pour l'aide ! :)

[antoinep30]

Bonjour;
Je viens de terminer l'installation sur un Ubuntu Server 20.04.
Tout fonctionne correctement.
Je vous joins mon runbook (avec des morceaux piochés à droite et à gauche sur ce fil).
Bon courage.
RUNBOOK_UBUNTU_20.04.txt

[brunto]

Bonjour @antoinep30,
Merci beaucoup pour cette contribution.

[contributorx]

Bonjour à tous,
Tout d'abord merci pour vos posts qui m'ont permit de m'en sortir assez facilement avec une installation faîte sur Ubuntu Server 20.04 et oui LTS....
J'ai pris le Book d'antoinep30 pour m'en inspirer
Cependant j'ai rencontré quelques problèmes lors de son exécution que j'ai réussi à à résoudre...
Je partage tout naturellement le fichier modifié avec les commandes qui m'ont permit de ne pas avoir d'erreur après plusieurs installations...
Je me suis concentré sur l'installation en production....

RUNBOOK_UBUNTU_20.04 V2.txt

[pierroo]

Merci @contributorx et @antoinep30 pour vos runbook qui m'ont grandement aidé.

Néanmoins, je reste bloqué sur la toute fin : lorsque je tape la commande ng build --prod, je n'ai aucun répertoire dist généré !
Ainsi je ne peux pas le copier dans /var/www/html/ pour relancer apache.

Je n'ai pourtant loupé aucune étape, et jusqu'à présent tout allait bien.

Autre détail important : la commande ng build créé bien un répertoire dist. C'est seulement avec le flag --prod qu'aucun dist n'est généré.

Merci infiniment pour votre aide !

[smarsani]

Bonjour à tous,
Tout d'abord merci pour vos posts qui m'ont permit de m'en sortir assez facilement avec une installation faîte sur Ubuntu Server 20.04 et oui LTS....
J'ai pris le Book d'antoinep30 pour m'en inspirer
Cependant j'ai rencontré quelques problèmes lors de son exécution que j'ai réussi à à résoudre...
Je partage tout naturellement le fichier modifié avec les commandes qui m'ont permit de ne pas avoir d'erreur après plusieurs installations...
Je me suis concentré sur l'installation en production....

RUNBOOK_UBUNTU_20.04 V2.txt

hi, I'm getting an error using the command:
rvm install ruby-2.6.5

here the error, can you pls helpme

en frances n'est pas un problem biensure.
merci Stefano

admin0@admin0:~$ rvm install ruby-2.6.5
Searching for binary rubies, this might take some time.
Found remote file https://rvm_io.global.ssl.fastly.net/binaries/ubuntu/20.04/x86_64/ruby-2.6.5.tar.bz2
Checking requirements for ubuntu.
Requirements installation successful.
ruby-2.6.5 - #configure
ruby-2.6.5 - #download
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0Warning: Failed to create the file bin-ruby-2.6.5.tar.bz2.part: Permission
Warning: denied
0 20.3M 0 1371 0 0 18527 0 0:19:14 --:--:-- 0:19:14 18527
curl: (23) Failed writing body (0 != 1371)
There was an error(23).
Checking fallback: ftp://rvm_io.global.ssl.fastly.net/binaries/ubuntu/20.04/x86_64/ruby-2.6.5.tar.bz2?rvm=1.29.12
Checking fallback: https://www.mirrorservice.org/sites/rvm_io.global.ssl.fastly.net/binaries/ubuntu/20.04/x86_64/ruby-2.6.5.tar.bz2?rvm=1.29.12
No fallback URL could be found, try increasing timeout with:

echo "export rvm_max_time_flag=20" >> ~/.rvmrc

Downloading https://rvm_io.global.ssl.fastly.net/binaries/ubuntu/20.04/x86_64/ruby-2.6.5.tar.bz2 failed.
Mounting remote ruby failed with status 2, trying to compile.
Checking requirements for ubuntu.
Requirements installation successful.
Installing Ruby from source to: /usr/share/rvm/rubies/ruby-2.6.5, this may take a while depending on your cpu(s)...
ruby-2.6.5 - #downloading ruby-2.6.5, this may take a while depending on your connection...
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0Warning: Failed to create the file ruby-2.6.5.tar.bz2.part: Permission denied
0 13.4M 0 1362 0 0 17240 0 0:13:39 --:--:-- 0:13:39 17461
curl: (23) Failed writing body (0 != 1362)
There was an error(23).
Checking fallback: https://ftp.ruby-lang.org/pub/ruby/2.6/ruby-2.6.5.tar.bz2
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0Warning: Failed to create the file ruby-2.6.5.tar.bz2.part: Permission denied
0 13.4M 0 1362 0 0 16409 0 0:14:21 --:--:-- 0:14:21 16409
curl: (23) Failed writing body (0 != 1362)
There was an error(23).
Failed download
There has been an error fetching the ruby interpreter. Halting the installation.

[Smirn74]

Bonjour,

Même problématique pour moi sur l'installation RVM.

Merci de votre aide

[Smirn74]

Bonjour,

Mon collègue est parvenu a installer complètement la solution, je vous joint le Runbook modifié.

Cordialement.
RUNBOOK_UBUNTU_20.04.V4.txt

[smarsani]

Merci beaucoup Stefano Da: Smirn74 ***@***.***> Inviato: giovedì 11 marzo 2021 12:19 A: LINCnil/pia ***@***.***> Cc: smarsani ***@***.***>; Comment ***@***.***> Oggetto: Re: [LINCnil/pia] PIA Back & Front Installation Runbook (#77) Bonjour, Mon collègue est parvenu a installer complètement la solution, je vous joint le Runbook modifié. Cordialement. RUNBOOK_UBUNTU_20.04.V4.txt <https://github.com/LINCnil/pia/files/6122568/RUNBOOK_UBUNTU_20.04.V4.txt> — You are receiving this because you commented. Reply to this email directly, view it on GitHub <#77 (comment)> , or unsubscribe <https://github.com/notifications/unsubscribe-auth/ATEAK5PVXJRBAXACJ6NMQSLTDCRIVANCNFSM4EQUIRXQ> . <https://github.com/notifications/beacon/ATEAK5NQZEZMNJ6NKO7CHZLTDCRIVA5CNFSM4EQUIRX2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOF56B46Q.gif>