Guide d'installation et d'exploitation

Ce guide s'adresse aux équipes informatiques qui installent Amanova sur leurs propres serveurs, dans leur propre compte cloud ou sur un réseau isolé (air gap). Le service hébergé exploité par SMH Global Services ne nécessite rien de tout cela.

1. Ce qui est installé

Composant	Rôle
Application	L'application web Amanova, l'espace de travail des collaborateurs, le portail client et les API
Serveur web	Sert l'application et les fichiers statiques au sein de l'installation
Processus d'arrière-plan et planificateur	Contrôles documentaires, analyse des relevés, scores d'alerte précoce, rapports et rappels
Service temps réel	Mises à jour en direct dans le navigateur
MariaDB 11.8	La base de données, sur un réseau interne sans aucun accès depuis l'extérieur
Redis	Cache et files de tâches
Caddy	HTTPS en frontal de l'ensemble, avec des certificats automatiques ou les vôtres
`amanova.sh`	Le script d'exploitation : installation, sauvegarde, restauration, mise à niveau, abonnement, rapport d'utilisation

Tout s'exécute dans des conteneurs sous Docker Compose. Les données résident dans des volumes Docker ; les sauvegardes sont écrites dans /opt/amanova/backups.

2. Prérequis

	Pilote	Production
CPU	4 vCPU	8 vCPU
Mémoire	8 Go	16 Go
Disque	SSD de 60 Go	SSD de 200 Go, plus l'espace de sauvegarde
Système d'exploitation	Ubuntu 22.04 ou 24.04, RHEL 9 ou compatible	Idem
Logiciels	Docker Engine 24 ou version ultérieure, avec le plugin Compose	Idem

Il vous faut également :

un nom d'hôte que les utilisateurs saisiront, par exemple lending.bank.local, pointant vers le serveur ;
les ports 80 et 443 ouverts à vos utilisateurs (le port 80 ne fait que rediriger vers le 443) ;
pour obtenir des certificats automatiques sur Internet, le nom d'hôte doit être public ; sur un réseau interne, fournissez votre propre certificat (section 6).

3. Installation standard (serveur avec accès à Internet)

sudo tar -xzf amanova-2.1.0-onprem.tar.gz -C /opt
sudo mv /opt/amanova-2.1.0-onprem /opt/amanova
cd /opt/amanova
sudo ./amanova.sh install

Le script demande :

l'adresse que les utilisateurs saisiront (nom d'hôte) ;
le nom du prêteur ;
le pays principal (PK, BD, SA, AE, NG, KE, EG, GH, SN ou MZ) ;
l'adresse e-mail du premier administrateur.

Il construit ou charge ensuite l'image de l'application, démarre les services, crée le site avec des mots de passe aléatoires pour la base de données et l'administrateur (conservés dans /opt/amanova/.env, lisible uniquement par root), puis affiche l'adresse et le premier mot de passe de l'administrateur. La première construction prend de 15 à 25 minutes.

4. Installation hors ligne (isolée, air gap)

Demandez à SMH Global l'archive d'images de votre version, amanova-2.1.0-images.tar.gz. Copiez les deux fichiers sur le serveur, puis :

sudo tar -xzf amanova-2.1.0-onprem.tar.gz -C /opt
sudo mv /opt/amanova-2.1.0-onprem /opt/amanova
cd /opt/amanova
sudo ./amanova.sh load-images /path/to/amanova-2.1.0-images.tar.gz
sudo ./amanova.sh install --offline

Rien n'est téléchargé. Le moteur d'IA intégré fonctionne sans connexion ; pour utiliser des modèles d'IA, exécutez un serveur de modèles sur site (section 10).

Connectez-vous à https://<your host>/login en tant qu'administrateur et changez le mot de passe.
Amanova Settings : nom du prêteur, marque, pays principal, langues, téléphone et e-mail du support.
Country Pack : confirmez avec votre équipe conformité les règles relatives à l'identité, aux numéros mobiles, au bureau de crédit et au crédit.
Loan Product : créez vos produits, plafonds, taux et documents requis ; cochez Show on portal pour les produits proposés en ligne.
Users : ajoutez les collaborateurs avec les rôles Loan Officer, Loan Underwriter, Loan Manager, Compliance Officer ou Auditor.
Amanova Compliance Settings : activez l'authentification à deux facteurs pour les collaborateurs, et paramétrez le filtrage, le KYC et les points de contrôle d'approbation.
Installez votre fichier d'abonnement (section 9).

6. Certificat TLS

Nom d'hôte public : Caddy obtient et renouvelle automatiquement un certificat.
Nom d'hôte interne : placez votre certificat et votre clé dans /opt/amanova/certs/ sous les noms site.crt et site.key, puis exécutez sudo ./amanova.sh cert. Utilisez la chaîne complète dans site.crt.

7. Sauvegarde et restauration

sudo ./amanova.sh backup              # database and files, with a SHA-256 checksum
sudo ./amanova.sh backups             # list backups
sudo ./amanova.sh restore <folder>    # verifies the checksum, then restores

Une sauvegarde s'exécute chaque nuit à 02:00 et les 14 dernières sont conservées (BACKUP_KEEP dans .env). Copiez /opt/amanova/backups vers un stockage séparé ; la clé de chiffrement de la base de données se trouve dans .env et doit être sauvegardée séparément et conservée en lieu sûr.

8. Mises à niveau

sudo tar -xzf amanova-2.2.0-onprem.tar.gz -C /tmp
sudo /tmp/amanova-2.2.0-onprem/amanova.sh upgrade /opt/amanova

La mise à niveau effectue d'abord une sauvegarde, remplace les fichiers de l'application (votre .env, les certificats, l'abonnement et les sauvegardes sont conservés), reconstruit ou charge la nouvelle image, migre la base de données et redémarre. Les sites isolés (air gap) chargent d'abord la nouvelle archive d'images. Les installations clonées depuis le dépôt de SMH Global peuvent exécuter sudo ./amanova.sh update pour récupérer et appliquer la dernière version.

9. Fichier d'abonnement et rapport d'utilisation

Le fichier d'abonnement est signé par SMH Global et vérifié hors ligne avec la clé publique fournie avec le produit ; rien ne contacte nos serveurs. Il indique le titulaire de la licence, les utilisateurs internes, la tranche de portefeuille, les modules, les pays, la durée et la date de fin de support.

sudo ./amanova.sh subscription /path/to/subscription.json   # install or replace
sudo ./amanova.sh subscription                              # show status
sudo ./amanova.sh usage-report                              # writes usage-report-<date>.json with a checksum

Les administrateurs voient également l'abonnement, l'utilisation et l'échéance sous Amanova Subscription dans l'application. Lorsque l'abonnement ou la période de support prend fin, ou que l'utilisation dépasse le volume souscrit, les administrateurs voient un avis ; l'octroi, la gestion et le recouvrement continuent de fonctionner. Envoyez à SMH Global un rapport d'utilisation chaque trimestre, ou sur demande.

10. Options d'IA

Sous Amanova Settings → Market & AI :

Fournisseur	Destination des données
Intégré	Nulle part : règles et statistiques au sein de votre installation
Sur site	Votre propre serveur de modèles avec une API compatible OpenAI (par exemple vLLM ou Ollama), défini par son URL
Cloud Anthropic Claude ou compatible OpenAI	Le fournisseur que vous approuvez, avec votre clé d'API, stockée chiffrée

Chaque résultat de l'IA est journalisé avec ses données d'entrée et la personne qui l'a accepté ou rejeté. Rien n'est décidé par l'IA seule.

11. Notes de sécurité pour la revue de sécurité de l'information

Les conteneurs exécutent l'application sous un utilisateur non root ; la base de données et Redis n'exposent aucun port.
HTTPS uniquement, TLS 1.2 et 1.3 ; HTTP redirige vers HTTPS.
Les mots de passe sont hachés ; les secrets tels que les clés d'API sont chiffrés avec la clé du site figurant dans .env.
L'authentification à deux facteurs des collaborateurs, la politique de mots de passe, le verrouillage après des tentatives échouées et l'expiration des sessions sont paramétrables.
Les documents des clients sont des fichiers privés, servis uniquement aux utilisateurs connectés autorisés à les voir.
Chaque document conserve un historique de versions ; les résultats de l'IA sont journalisés avec leur réviseur.

12. Installation sans conteneurs

Lorsque les conteneurs ne sont pas autorisés, Amanova s'installe avec la configuration de production standard de la plateforme (Python, Node.js, MariaDB, Redis, NGINX et Supervisor) à l'aide de bench. Demandez à SMH Global le guide systemd/bench pour votre système d'exploitation.

13. Dépannage

Symptôme	Vérification
Le site ne s'ouvre pas	`sudo ./amanova.sh status` et `sudo ./amanova.sh logs web`
Erreurs de certificat	Le nom d'hôte pointe vers le serveur ; les ports 80 et 443 sont ouverts ; sinon, installez votre propre certificat
Contrôles d'arrière-plan lents	`sudo ./amanova.sh logs worker` ; ajoutez de la mémoire ou du CPU
Restauration refusée	La somme de contrôle de la sauvegarde ne correspond pas ; copiez à nouveau la sauvegarde

14. Référence des commandes

Commande	Rôle
`install [--offline]`	Première installation
`status`	Services, version, abonnement et espace disque utilisé
`start`, `stop`, `restart`	Piloter tous les services
`logs [service]`	Suivre les journaux (`app`, `web`, `worker`, `scheduler`, `db`, `proxy`)
`backup`, `backups`, `restore <folder>`	Sauvegardes avec sommes de contrôle
`upgrade <folder>` / `update`	Mettre à niveau à partir d'un nouveau paquet, ou récupérer la dernière version depuis le dépôt
`load-images <archive>`	Charger les images pour une installation ou une mise à niveau hors ligne
`cert`	Utiliser votre propre certificat depuis `certs/`
`subscription [file]`	Installer ou afficher l'abonnement
`usage-report`	Générer un rapport d'utilisation pour SMH Global
`admin-password`	Définir un nouveau mot de passe pour l'administrateur
`version`	Afficher la version installée

Support : support@amanova.app · SMH Global Services, Dubaï · Karachi · Riyad

Guide d'installation et d'exploitation.