Installer SUIGEST360 sur un VPS

Ubuntu Server — préparation

Les commandes suivantes utilisent Ubuntu Server avec Nginx. Connectez-vous au VPS avec un compte disposant des droits sudo.

sudo apt update
sudo apt upgrade -y

Installer Nginx

sudo apt install nginx -y
sudo systemctl enable nginx
sudo systemctl start nginx
sudo systemctl status nginx

sudo ufw allow 'Nginx Full'

Installer PHP 8.2+

SUIGEST360 nécessite PHP 8.2 ou une version compatible supérieure ainsi que les extensions utilisées par l’application.

sudo apt install php php-fpm php-mysql php-bcmath php-curl php-gd php-mbstring php-xml php-zip php-cli -y

php -v
php -m

Installer MySQL

sudo apt install mysql-server -y
sudo systemctl enable mysql
sudo systemctl start mysql

sudo mysql_secure_installation

Créer la base de données SUIGEST360

sudo mysql

Dans MySQL :

CREATE DATABASE suigest360 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'suigest360'@'localhost'
IDENTIFIED BY 'CHANGE_THIS_STRONG_PASSWORD';

GRANT ALL PRIVILEGES ON suigest360.* TO 'suigest360'@'localhost';

FLUSH PRIVILEGES;

EXIT;

Déployer SUIGEST360

Créez le répertoire du site puis transférez le package SUIGEST360 fourni avec votre licence.

sudo mkdir -p /var/www/suigest360
sudo chown -R $USER:www-data /var/www/suigest360

Configurer les permissions Laravel

cd /var/www/suigest360

sudo chown -R $USER:www-data .
sudo find . -type f -exec chmod 644 {} \;
sudo find . -type d -exec chmod 755 {} \;

sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

Configurer Nginx

Remplacez example.com par le domaine utilisé pour votre installation SUIGEST360.

server {
    listen 80;
    listen [::]:80;

    server_name example.com www.example.com;

    root /var/www/suigest360/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

ls /run/php/

sudo nginx -t
sudo systemctl reload nginx

Activer HTTPS avec Let's Encrypt

Le domaine doit déjà pointer vers l'adresse IP publique du VPS.

sudo apt install certbot python3-certbot-nginx -y

sudo certbot --nginx -d example.com -d www.example.com

Vérifiez ensuite le renouvellement automatique :

sudo certbot renew --dry-run

Lancer l'installateur SUIGEST360

Ouvrez maintenant le domaine sécurisé dans votre navigateur. SUIGEST360 démarre son assistant d'installation.

L'assistant vérifie ensuite :

• la version PHP et les extensions ;
• les permissions système ;
• la licence SUIGEST360 ;
• la connexion à MySQL ;
• les informations de société ;
• le compte administrateur ;
• le choix entre installation propre et données de démonstration.

Configurer le planificateur Laravel

Après l'installation, configurez le scheduler afin que les tâches planifiées de l'application puissent être exécutées.

crontab -e

Ajoutez :

* * * * * cd /var/www/suigest360 && php artisan schedule:run >> /dev/null 2>&1

Vérification finale

cd /var/www/suigest360

php artisan about
php artisan route:list
php artisan schedule:list

• Vérifiez l'accès HTTPS.
• Connectez-vous avec le compte administrateur.
• Vérifiez les paramètres société.
• Vérifiez la devise, la langue et le fuseau horaire.
• Effectuez une première sauvegarde.

Utiliser Apache à la place de Nginx

SUIGEST360 peut également fonctionner avec Apache. N'installez pas Apache si vous utilisez déjà Nginx pour ce site.

sudo apt install apache2 libapache2-mod-php -y
sudo a2enmod rewrite

Le VirtualHost doit utiliser :

<VirtualHost *:80>

    ServerName example.com
    ServerAlias www.example.com

    DocumentRoot /var/www/suigest360/public

    <Directory /var/www/suigest360/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/suigest360-error.log
    CustomLog ${APACHE_LOG_DIR}/suigest360-access.log combined

</VirtualHost>

sudo apache2ctl configtest
sudo systemctl reload apache2

Pour HTTPS avec Apache :

sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache -d example.com -d www.example.com

Préparer un environnement serveur propre.

L’installation sur VPS est recommandée lorsque vous souhaitez conserver un contrôle complet sur PHP, la base de données, les permissions et la configuration du serveur web.

• Accès SSH au serveur
• Nom de domaine ou sous-domaine pointant vers le VPS
• Serveur web configuré
• PHP 8.2 ou supérieur
• MySQL ou MariaDB
• Licence SUIGEST360 valide

Préparer le VPS.

Avant d’installer SUIGEST360, assurez-vous que le serveur est à jour et qu’un serveur web ainsi qu’un moteur de base de données sont disponibles.

• Utiliser un compte disposant des permissions nécessaires
• Configurer le domaine vers le serveur
• Vérifier que les ports HTTP/HTTPS sont accessibles
• Préparer le certificat SSL avant la mise en production

Installer PHP et les extensions requises.

L’installateur SUIGEST360 vérifie automatiquement la version PHP et les extensions nécessaires avant d’autoriser la suite de l’installation.

• PHP 8.2 ou supérieur
• PDO
• PDO MySQL
• BCMath
• Ctype
• cURL
• DOM
• Fileinfo
• GD
• JSON
• Mbstring
• OpenSSL
• Tokenizer
• XML
• Zip

Créer une base MySQL dédiée.

Préparez une base de données et un utilisateur disposant des droits nécessaires. Ces informations seront demandées par l’assistant.

• Hôte de la base de données
• Port MySQL, généralement 3306
• Nom de la base
• Nom d’utilisateur
• Mot de passe

Déployer les fichiers SUIGEST360.

Placez les fichiers de l’application dans le répertoire prévu pour le site et configurez le serveur web afin que la racine publique pointe vers le dossier public de SUIGEST360.

• Conserver la structure complète du projet
• Ne pas exposer directement les fichiers privés de Laravel
• Utiliser le dossier public comme racine web

Autoriser l’écriture dans les dossiers nécessaires.

SUIGEST360 vérifie automatiquement que certains répertoires Laravel existent et sont accessibles en écriture.

• storage
• bootstrap/cache

Configurer le Virtual Host.

La racine du domaine doit pointer vers le dossier public de SUIGEST360. Vérifiez également que la réécriture d’URL et les requêtes PHP fonctionnent correctement.

• Document root vers le dossier public
• HTTPS recommandé
• Réécriture d’URL active
• PHP-FPM ou équivalent correctement configuré

Ouvrir l’installateur guidé.

Une fois le serveur prêt, ouvrez votre domaine dans le navigateur. L’assistant vous guidera dans l’ordre prévu.

• Choix de la langue
• Contrôle des prérequis
• Validation de la licence
• Configuration de la base de données
• Informations de la société
• Création de l’administrateur
• Choix des données initiales
• Résumé et installation

Vérifier et activer la licence.

La licence doit être validée avant de pouvoir passer à la configuration de la base de données. SUIGEST360 associe l’installation au domaine et à une empreinte technique du serveur.

• Saisir le code de licence
• Attendre la confirmation de validation
• Corriger toute erreur de licence avant de poursuivre

Configurer les paramètres principaux.

Renseignez les informations de l’entreprise qui seront utilisées par SUIGEST360.

• Nom de la société
• E-mail
• Téléphone
• Adresse
• Ville
• Pays
• Devise
• Symbole monétaire
• Fuseau horaire
• Format de date
• Langue par défaut

Créer le premier compte.

Le premier compte administrateur est créé pendant l’installation et permettra d’accéder à la plateforme.

• Nom complet
• Adresse e-mail valide
• Mot de passe d’au moins 8 caractères
• Confirmation du mot de passe

Choisir une installation propre ou avec démonstration.

Avant l’installation finale, choisissez si vous souhaitez démarrer avec un environnement vide ou avec des données préparées pour découvrir SUIGEST360.

• Installation propre pour la production
• Données de démonstration pour l’évaluation et les tests

Lancer l’installation finale.

Vérifiez le résumé présenté par l’assistant puis démarrez l’installation. SUIGEST360 crée alors l’environnement nécessaire et finalise la configuration.

• Vérifier les informations affichées
• Lancer l’installation
• Ne pas interrompre le processus
• Attendre l’écran de confirmation

Effectuer les premières vérifications.

Une fois l’installation terminée, connectez-vous avec le compte administrateur et contrôlez les paramètres principaux avant de commencer à utiliser la plateforme.

• Connexion au tableau de bord
• Informations société
• Devise et fuseau horaire
• Langue
• Permissions utilisateurs
• Sauvegarde initiale recommandée