.. _configuration: ###################### Configuration initiale ###################### Une fois Waarp Manager installé, la procédure suivante doit être suivie pour initialiser la configuration et permettre son utilisation. Création de la base de données ============================== Waarp Manager utilise une base de données PostgreSQL 9.4 minimum. .. note:: Pour installer un serveur de PostgreSQL sur le même serveur que Waarp Manager, se référer à la `documentation de PostgreSQL`_. Sur le serveurs de base de données, créez une base et un utilisateur dédiée à Waarp Manager. Ceci peut se faire avec les requêtes SQL suivantes : .. todo:: mettre les commandes compactes .. code-block:: plpgsql -- Pensez à changer le mot de passe de l'utilisateur waarp ! CREATE USER waarp; ALTER USER waarp WITH ENCRYPTED PASSWORD 'password'; CREATE DATABASE "waarp_manager"; ALTER DATABASE "waarp_manager" OWNER TO waarp; Une fois la base de données créée, éditez le fichier de configuration ``waarp-manager.ini`` et renseignez les informations de connexion à la base de données. Si Waarp Manager a été installé en utilisant des packages (dépôts ou unitaires), ce fichier se trouve dans le dossier ``/etc/waarp-manager`` ; sinon, il se trouve dans le dossier ``etc`` de l'archive extraite. Les options de configuration concernées sont dans la section ``[db]`` du fichier : .. code-block:: ini [db] ; The host to connect to Host = localhost ; The port to bind to Port = 5432 ; The user to sign in as User = waarp ; The user's password Password = password ; The name of the database to use Name = waarp_manager ; Whether or not to use SSL ; Ssl = false Initialisation de la base de données ==================================== Le script de génération de la structure de la base de données et des données initiales est généré avec la commande ``waarp-manager db dump``. Vous pouvez soit le stocker dans un fichier pour l'exécuter directement : .. code-block:: bash # Avec les packages : waarp-manager db dump > waarp-manager.sql psql -W --user waarp --host localhost --port 5432 waarp_manager < waarp-manager.sql # Avec les archives portables : ./bin/waarp-manager db dump > waarp-manager.sql psql -W --user waarp --host localhost --port 5432 waarp_manager < waarp-manager.sql ou l'exécuter directement dans une base : .. code-block:: bash # Changez le serveur, le nom d'utilisateur et le port si ceux-ci # ne correspondent pas # Avec les packages : waarp-manager db dump | psql -W --user waarp --host localhost --port 5432 waarp_manager # Avec les archives portables : ./bin/waarp-manager db dump | psql -W --user waarp --host localhost --port 5432 waarp_manager .. warning:: L'utilisateur configuré dans Waarp Manager doit avoir le droit d'utiliser les tables de la base de données. Pour ça, il faut : 1. Soit initialiser la base avec l'utilisateur configuré pour Waarp Manager 2. Soit donner explicitement le droit à l'utilisateur de Waarp Manager d'utiliser la base : .. code-block:: sql GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO [USERNAME]; La dernière étape consiste à appliquer les dernières migrations à la base de données pour qu'elle soit à jour : .. code-block:: sh # Avec les packages : waarp-manager db migrate up -c /etc/waarp-manager/waarp-manager.ini # Avec les archives portables : ./bin/waarp-manager db migrate up -c etc/waarp-manager.ini Création d'un client Waarp R66 ============================== Pour déployer la configuration vers les serveurs Waarp R66, Waarp Manager utilise un client Waarp R66 dédié. Sur le même serveur que Waarp Manager, créez et configurez un client Waarp R66 et éditer la configuration de Waarp Manager en conséquence : .. code-block:: ini ; The name of the Waarp R66 client that Waarp Manager uses ClientName = wm-client Ce client est utilisé pour envoyer la configuration aux autres partenaires R66. .. todo:: Plus de détails sur le client associé à Waarp Manager, dont base partagée Les options de configurations sont dans la section `[r66]` du fichier: .. code-block:: ini [r66] ; The DES key to use when encrypting passwords DesKey = {{path/to/waarp/encryptionkey}} ; The directory where generated conf archives must be written OutDir = {{path/to/waarp/out/directory}} ; The command to use to deploy the configuration to the server R66Cmd = waarp-r66client ; The template to use to deploy the configuration to the server DiffusionRule = déploiement_config ; The name of the Waarp R66 client that Waarp Manager uses ClientName = wm-client ; The path to the file containing the key to sign REST requests RestSigningKey = {{path/to/waarp/restsigningkey}} ; The path to the file containing the certification chain of Waarp R66 Servers (PEM format) RootCA = {{path/to/waarp/certificationchain}} ; The period to wait for answers for REST requests RestTimeout = 3s ; The delay between two queries to update a server's transfer history HistoryRefresh = 5m Toutes ces options permettent de paramétrer et mettre en oeuvre les interactions entre Waarp Manager et les serveurs Waarp R66 qu'il pilote. Il y a deux types d'interactions : 1. L'envoi de la configuration (règles et authentification) aux moniteurs 2. La récupération des historiques de transfert des serveurs Dans le premier cas, Waarp Manager génère, pour chaque serveur R66, les fichiers XML contenant les règles de transfert et les doonnées d'authentification des partenaires nécessaire à la mise en oeuvre des flux définis. Ces fichiers sont ensuite transférés vers les serveurs via R66. Pour ce faire, Waarp Manager a besoin d'utiliser un client R66 configuré sur son serveur. L'identifiant (``hostid``) de ce client doit être renseigné dans l'option ``ClientName``. Les fichiers générés (ceux qui doivent être transférés) sont déposés dans le dossier indiqué dans l'option ``OutDir``. En général, il faut renseigner dans cette option le dossier d'envoi (``out``) du client R66 associé. Le programme utilisé pour lancer les transferts avec le client R66 associé doit être renseigné dans l'option ``R66Cmd``. Pour une installation faite avec les RPM, ``waarp-r66client`` suffit (le script est dans le ``PATH`` système -- ``/usr/bin``). Pour envoyer les fichiers, il utilise un flux qui doit être défini dans Waarp Manager (du client associé à Waarp Manager vers le serveur à mettre à jour) avec le modèle de flux défini dans l'option ``DiffusionRule``. Enfin, les mots de passe des partenaires R66 transmis dans les fichiers XML sont chiffrés (ils le sont aussi dans les bases des de données des partenaires R66) en utilisant la clef DES renseignée dans l'option ``DesKey`` (cette clef doit aussi être utilisée par tous les moniteurs R66). Pour le deuxième cas, la consultation des historiques, Waarp Manager utilise l'interface REST des serveurs R66. Pour plus de sécurité, les requêtes sont signées cryptographiquement (en utilisant l'algorithme HMAC-SHA256). La clef utilisée pour cette signature est indiquée dans l'option ``RestSigningKey``. Enfin, l'interface REST des serveurs est consultée en HTTPS. L'option ``RootCA`` permet de renseigner, de manière optionnelle, une chaîne de certification au format PEM pour valider la connection HTTPS. Communication avec les serveurs Waarp R66 ========================================= Pour récupérer l'historique des serveurs Waarp R66, Waarp Manager utilise l'interface REST de ceux-ci. Si, pour les serveurs, la signature des requêtes est activée, le chemin vers le fichier contenant la clef de signature doit être indiquée dans le paramètre ``RestSigningKey`` du fichier de configuration de Waarp Manager. De même, si l'interface REST des serveurs R66 est protégée par un certificat signée par un tiers dont les certificats racine ne sont pas installés sur le système, le fichier contenant la chaîne de certification doit être indiquée dans le paramètre ``RootCA`` du fichier de configuration. .. _documentation de PostgreSQL: http://www.postgresql.org/download/