OpenProject : Installation

OpenProject : Installation

Table of Contents

Contexte

  • OpenProject sera installé sur Debian 10.
  • La base de données recommandée est PostgreSQL.
  • Le serveur web recommandé est Apache.

Installation

  • Installer gnupg2 :

    sudo apt install gnupg2
  • Importer la clef PGP utilisées pour signer les paquets openproject :

    wget -qO- https://dl.packager.io/srv/opf/openproject/key | sudo apt-key add -
  • Ajouter le repo adéquat :

    sudo wget -O /etc/apt/sources.list.d/openproject.list \
    https://dl.packager.io/srv/opf/openproject/stable/11/installer/debian/10.repo
  • Télécharger et installer openproject :

    sudo apt-get update
    sudo apt-get install openproject

Configuration

Pré-requis

  • Si une base de données PostgreSQL externe veut être utilisée en lieu et place d'une base de données locale, s'assurer d'avoir les informations suivantes :
    • database hostname
    • port
    • username
    • password

L'utilisateur utilisé pour la connexion à la base de données doit avoir le privilège CREATE DATABASE.

  • Si le HTTPS est utilisé, prévoir le chemin d'accès vers le :
    • certificate file
    • private key file
    • CA bundle file

Lancer le wizard

  • Exécuter le wizard :

    sudo openproject configure
  • Si une erreur se produit et/ou une reconfiguration est nécessaire, annuler le wizard avec CTRL+C et relancer le wizard avec sudo openproject reconfigure.
  • Les choix fait durant le wizard sont persistent dans le fichier /etc/openproject/installer.datet l'exécution de sudo openproject configureréutilise ces valeurs. Seul les options non présentes dans le fichier installer.datseront alors demandées.
  • Pour relancer la demande de tous les paramètres : sudo openproject reconfigure.

Choisir l'édition

  • OpenProject est fournit avec 2 éditions :

    • L'édition par défaut : Pour une gestion de projet générale.
    • L'édition BIM : Pour une gestion de projet axée dans l'industrie du bâtiment/construction.

    openproject_edition

  • Plus d'information sur la BIM Edition ici.

    La slection de l'édition est uniquement disponible sur les distributions suivantes :

    • RHEL/CentOS 8
    • Ubuntu 20.04
    • Ubuntu 18.04
    • Debian 10
    • Debian 11

Configuration base de données

  • OpenProject requiert une base de données PostgreSQL pour stocker les données.

  • Cette étape va permettre de sélectionner la méthode de connexion à cette base de données.

    postgres_autoinstall

  • 3 options :

    • Skip : Pas de connexion à une base de données. Il sera nécessaire de spécifier une base de données manuellement à l'aide de la variable DATABASE_URL :
    sudo openproject config:set DATABASE_URL="postgresql://[user[:password]@][host][:port][/dbname][?param1=value1&...]"
    • Install : Le wizard installe et configure une base de données PostgreSQL locale. C'est cette option qui sera retenu dans cette documentation.

    • Reuse : Pour utiliser une base de données PostgreSQL existante. Des paramètres de connexion supplémentaire sont demandés lors de ce choix.

Apache2

  • OpenProject comprend un serveur d'application en ruby interne. Seulement le serveur écoute uniquement sur une interface locale.

  • Pour pouvoir y accéder d'Internet, il est nécessaire d'avoir un serveur web comme proxy transférer les connexions entrantes vers le serveur applicatif OpenProject.

  • Le wizard propose d'installer automatiquement un serveur web Apache2 pour agir comme un proxy.

    server_autoinstall

  • 2 options :

    • Install : Option recommandée. Installe et configure un serveur web Apache2 avec un virtual host du nom de domaine fournit. C'est ce serveur qui fournira du SSL/TLS. Plusieurs options sont demandées par la suite.

    • Le nom de domaine pleinement qualifié. Correspond à la valeur ServerNamedu virtual host d'apache.

      server_hostname

    • Pour spécifier un prefix afin d'accéder à l'applicatif (exemple : mondomaine.example.com/openproject) : /openproject. Laisser vide si l'accès désiré à l'application est http(s)://mondomaine.example.com.

      server_path_prefix

    • Pour utiliser des certificats SSL/TLS, 3 choix supplémentaires sont à faire pour spécifier l'accès aux certificats.

      server_ssl

    • Skip : Non recommandé. Un serveur web Apache ou Nginx doit être installé et configuré manuellement pour rediriger les requêtes entrantes vers localhost:6000.

    Attention avec un serveur Nginx, toutes les fonctionnalités ne sont pas disponible pour OpenProject.

SVN/Git intégration

  • Si le choix d'installer automatiquement Apache2 est fait, il est demandé si une intégration de SVN/Git doit être faites.

  • Plus d'informations ici

    repositories_svninstall

Configuration email

  • Configurer la méthode d'envoie de mail pour les diverses notifications.

    smtp_autoinstall

  • 3 options :

    • Sendmail : Utilisation d'une installation de sendmail en locale ou d'un serveur postfix local.
    • SMTP : Option recommandée en production. Autorise la connexion à un serveur SMTP à travers une authentification de type : NONE, PLAIN, LOGIN, CRAM-MD5.
    • Skip : Aucune configuration. Néanmoins, la configuration peut se faire plus tard en se rendant sur l'URL : openproject.example.com/settings?tab=notifications.

Serveur Memcached

  • OpenProject a besoin d'un serveur local memcached. L'installation de celui-ci doit "toujours" être faites.

    memcached_autoinstall

Accès OpenProject

  • L'installation est terminée.

  • L'application OpenProject est disponible à l'adresse : http(s)://openproject.example.com/server prefix.

  • Username = admin

  • Password = admin

  • Changer le mot de passe admin immédiatement

    install_end

Mise à jour PostgreSQL

  • La version actuelle d'OpenProject est la 11.4.0.

  • La prochaine version majeure sera la 12.0 (fin 2021).

  • PostgreSQL v13 sera nécessaire.

  • Installer la nouvelle version de PostgreSQL :

    sudo apt-get update
    sudo apt-get install postgresql-13
  • Arrêter les serveurs PostgreSQL :

    sudo su - postgres -c "/usr/lib/postgresql/10/bin/pg_ctl stop --wait --pgdata=/var/lib/postgresql/10/main"
    sudo su - postgres -c "/usr/lib/postgresql/13/bin/pg_ctl stop --wait --pgdata=/var/lib/postgresql/13/main"
  • Migrer les données vers PostgreSQL v13 :

    sudo su - postgres << CMD
    /usr/lib/postgresql/13/bin/pg_upgrade \
    --old-bindir=/usr/lib/postgresql/10/bin \
    --new-bindir=/usr/lib/postgresql/13/bin \
    --old-datadir=/var/lib/postgresql/10/main \
    --new-datadir=/var/lib/postgresql/13/main \
    --old-options '-c config_file=/etc/postgresql/10/main/postgresql.conf' \
    --new-options '-c config_file=/etc/postgresql/13/main/postgresql.conf'
    CMD
  • Faire de PostgreSQL v13 le serveur par défaut sur le port 45432 :

    sudo su - postgres -c "cp /etc/postgresql/{10,13}/main/conf.d/custom.conf"
    sudo su - postgres -c "sed -i 's|45432|45433|' /etc/postgresql/10/main/conf.d/custom.conf"
    sudo su - postgres -c "/usr/lib/postgresql/13/bin/pg_ctl start --wait --pgdata=/var/lib/postgresql/13/main -o '-c config_file=/etc/postgresql/13/main/postgresql.conf'"
  • Vérifier dans OpenProject la version de PostgreSQL.

    postgre_v13

  • Supprimer l'ancienne version de PostgreSQL :

    sudo rm -rf /var/lib/postgresql/10/main
    sudo apt-get purge postgresql-10

1 commentaire pour l’instant

OpenProject : Mise en place du SSO avec Keycloak Publié le14h40 - 28 octobre 2021

[…] OpenProject : Installation […]

Les commentaires sont fermés.

Les commentaires sont fermés.