DIVAnet est une application distribuée, ce qui signifie qu'elle est souvent installée sur plusieurs systèmes. Reportez-vous au Chapitre 2 pour savoir sur quels systèmes et serveurs l'application DIVAnet peut être installée et quels services DIVAnet spécifiques doivent être installés.
Chaque site DIVArchive connecté à DIVAnet doit exécuter DIVArchive 7.3.1 ou une version supérieure.
DIVAnet peut être installé sur des plates-formes Windows 64 bits ou des plates-formes Linux 64 bits (Oracle Linux version 7 ou supérieure). DIVAnet peut être installé dans le même répertoire de base que DIVArchive ou dans un répertoire distinct.
Sur les ordinateurs exécutant Windows, le programme d'installation de DIVAnet nécessite des privilèges d'administrateur. Sur les ordinateurs exécutant Linux, le programme d'installation de DIVAnet nécessite un compte utilisateur nommé diva.
Par défaut, le programme d'installation de DIVAnet gère l'installation des services DIVAnet, de l'interface utilisateur DIVAnet et d'un environnement d'exécution Java (JRE) compatible Java 8 64 bits. DIVAnet utilise le JRE installé pour l'exécution. L'installation de la base de données DIVAnet nécessite l'installation directe sur le système DIVAnet des logiciels suivants : Oracle Database 11g version 2 (ou supérieure) et Oracle SQLPlus (à partir de la version Oracle 11).
Pour une réinstallation de DIVAnet, assurez-vous que les composants DIVAnet ne sont pas en cours d'exécution.
Le logiciel DIVAnet peut être installé sur les systèmes d'exploitation Windows et Linux (Oracle Linux 7 ou version supérieure). La procédure d'installation sur chaque plate-forme est décrite dans les sections suivantes.
Procédez de la manière suivante pour installer DIVAnet dans un environnement Windows :
Lancez l'exécutable d'installation de DIVAnet, DIVAnet_V2.1.version.exe, sous un compte disposant de privilèges d'administrateur.
Sélectionnez les composants voulus et cliquez sur Next.
Sélectionnez Java si vous ne l'avez pas précédemment installé dans le répertoire cible.
Si vous voulez uniquement installer l'interface utilisateur de DIVAnet, désélectionnez DIVAnet Services.
Indiquez un répertoire d'installation cible. Ce sera le répertoire de base de DIVAnet. Cliquez ensuite sur Install.
Remarque :
Vous pouvez utiliser le répertoire d'installation de DIVArchive comme répertoire de base pour DIVAnet. Cependant, Oracle recommande d'installer DIVAnet dans un répertoire qui lui est propre.Si vous utilisez le système d'exploitation Linux, vous devez créer un utilisateur nommé diva et un utilisateur nommé divanetsvc. L'utilisateur divanetsvc doit avoir des droits d'écriture, de lecture et d'exécution sur les fichiers appartenant à diva. L'utilisateur diva doit bénéficier des privilèges sudo pour la commande Linux systemctl. Vous devez exécuter l'installation en tant qu'utilisateur diva, admin ou root. Vous devez créer l'utilisateur diva avant d'installer le logiciel. Le programme d'installation comprend une option qui permet de créer les utilisateurs diva et divanetsvc avant de lancer l'installation.
Procédez de la manière suivante pour installer DIVAnet dans un environnement Linux :
Ouvrez une session de terminal et accédez au répertoire parent de la version souhaitée de DIVAnet.
Placez dans ce répertoire le package d'installation de DIVAnet (par exemple, DIVAnet-2.1-RELEASE.sh). Le programme d'installation permet d'installer DIVAnet dans un sous-répertoire enfant de ce répertoire parent.
Lancez l'installation de DIVAnet à l'aide de la commande suivante :
sh ./DIVAnet-2.1-RELEASE.sh
Le programme d'installation comprend une option qui permet de créer les utilisateurs Linux requis diva et divanetsvc avant d'installer le logiciel. Une fois que ces utilisateurs sont installés, avec les autorisations correctes, sélectionnez l'option qui lance l'installation du logiciel DIVAnet.
Une invite vous demandera le nom du sous-répertoire où DIVAnet doit être installé. Appuyez sur Entrée pour utiliser le sous-répertoire par défaut, nommé DIVAnet, ou bien indiquez un nom de sous-répertoire personnel. Appuyez ensuite sur Entrée pour créer le répertoire d'installation.
Le processus d'installation de DIVAnet commence alors, et tous les fichiers et dossiers concernés sont transférés vers le répertoire cible indiqué.
Les sections suivantes décrivent les éventuelles étapes à effectuer pour terminer l'installation. Pour plus d'informations, reportez-vous au Chapitre 2.
Pour créer la base de données DIVAnet, vous devez d'abord créer les tables DIVAnet puis configurer les sites DIVArchive.
Cette étape consiste à créer les tables de la base de données DIVAnet qui résideront sur un serveur Oracle en cours d'exécution. Cette étape n'est requise que pour une installation DIVAnet complète (voir le Chapitre 2).
Pour exécuter les scripts de création SQL, vous devez avoir SQLPlus (logiciel client Oracle 11g ou version ultérieure) sur le système où vous installez DIVAnet. Vérifiez que le chemin d'accès à l'utilitaire sqlplus figure dans la variable d'environnement PATH de votre système.
Ouvrez une fenêtre de ligne de commande ou un terminal d'exécution de commandes. Accédez au répertoire de base DIVAnet (où DIVAnet est installé).
Passez dans le répertoire Program/Database/divanet/Install.
Exécutez la commande suivante :
Windows :
create_divanet_user.bat {syspassword} {username} {userpassword} {oracle_tns_name}
Linux :
create_divanet_user.sh {syspassword} {username} {userpassword} {oracle_tns_name}
Dans la commande précédente, syspassword est le mot de passe du système Oracle, username est le nom d'utilisateur/de schéma Oracle qui contiendra les tables DIVAnet et oracle_tns_name est le nom TNS Oracle pour la base de données DIVAnet que vous voulez utiliser pour l'installation. S'il n'y a pas de nom TNS défini pour la base de données, vous pouvez vous reporter à la section suivante pour créer un nom TNS en temps réel.
Pour supprimer le schéma de base de données DIVAnet, procédez comme suit.
Attention :
Cette action va supprimer toutes les données de la base de données DIVAnet.Passez dans le répertoire Program/Database/divanet/Install.
Exécutez la commande suivante :
Windows :
delete_divanet_user.bat syspassword username oracle_conn_string
Linux :
delete_divanet_user.sh syspassword username oracle_conn_string
Dans la commande précédente, syspassword est le mot de passe du système Oracle, username est le nom d'utilisateur ou le nom de schéma qui contiendra les tables DIVAnet et oracle_conn_string est soit le nom TNS de la base de données DIVAnet à utiliser, soit la chaîne de connexion Oracle (voir la section suivante) pour l'installation. S'il n'y a pas de nom TNS défini pour la base de données, reportez-vous à la section suivante pour créer une chaîne de connexion Oracle à utiliser dans les scripts d'ajout et de suppression.
S'il n'y a pas de nom TNS défini pour la base de données, vous pouvez indiquer une chaîne de connexion Oracle. Le format de cette chaîne est le suivant :
netaddress:port/remote_servicename
Où :
netaddress est l'adresse réseau où s'exécute la base de données.
port est le port où les clients peuvent se connecter.
remote_servicename est le nom du service Oracle distant. Il est différent du nom de service utilisé localement. La valeur par défaut pour le package d'installation de la base de données DIVA Oracle est lib5.world. Exemple de chaîne de connexion complète : 183.34.34.67:1521/lib5.world.
Une fois les tables DIVAnet créées, vous devez configurer les sites DIVA dans la base de données DIVAnet. Pour configurer les sites de la base de données, exécutez le script addSites comme suit :
Accédez au répertoire de base DIVAnet, puis au sous-dossier Program/divanet/bin.
Exécutez le script addSites :
Windows : addSites.bat
Linux : addSites.sh
Ce script vous guide pour ajouter des enregistrements de nom de site et pour configurer des noms de site, des emplacements et des commentaires. Les connexions réseau aux sites sont configurées dans le fichier de configuration ClientAdapter (voir le Chapitre 4). Vous devez créer des noms de site faciles à lire qui reflètent l'emplacement physique ou la fonction du site.
Remarque :
Les noms de site que vous indiquez dans cette étape seront utilisés lors de la configuration des services DIVAnet locaux et distants. Assurez-vous de la cohérence et de la validité des noms de site avant d'exécuter le scriptaddSites. Si vous faites une erreur en exécutant la commande, vous pouvez supprimer le site logiquement dans le script addSites. Une fois les noms de site définis dans la base de données, vous pouvez poursuivre l'installation de DIVAnet.Reportez-vous au Chapitre 2 pour déterminer quels services DIVAnet doivent être configurés, puis au Chapitre 4 pour obtenir des détails sur la configuration de chaque service.
Sous le répertoire de base DIVAnet, dans le sous-répertoire Program/conf/divanet/templates, vous trouverez des modèles de fichier de configuration pour chaque service DIVAnet à configurer. Chaque modèle de fichier comporte une extension .ini. Vous devez copier chaque fichier dans le répertoire parent (en l'occurrence, Program/conf/divanet). Lors de la copie, veillez à supprimer l'extension .ini.
Au début de chaque fichier .ini figure la documentation des paramètres disponibles. Pour chaque site DIVAnet, configurez un fichier ManagerAdapterConfig.xml. Pour une installation DIVAnet complète, vous configurez également les fichiers ClientAdapterConfig.xml et DBSyncConfig.xml.
Vous pouvez conserver la valeur par défaut de nombreux paramètres. Vous ne devriez pas avoir à modifier les fichiers de configuration figurant dans le dossier Program/conf/divanet/wrapper. Vous pouvez éventuellement ajouter des informations au fichier divaEnv.conf (voir Ajout de variables de script à un fichier de configuration pour plus d'informations).
Remarque :
Si vous hésitez quant aux paramètres à modifier après avoir lu cette documentation, contactez le support technique Oracle.Reportez-vous au Chapitre 2 pour déterminer quels services doivent être installés et configurés.
Une fois les fichiers de configuration définis correctement, installez et démarrez les services DIVAnet. Procédez comme suit pour chaque service à installer sur chaque site DIVAnet.
Procédez de la manière suivante pour installer les services DIVAnet dans un environnement Windows :
Accédez au répertoire de base DIVAnet (où DIVAnet est installé).
Accédez au dossier Program/divanet/bin.
Exécutez le script InstallDivanetService.bat, en indiquant le fichier de configuration de wrapper pour le service à installer. Par exemple, pour installer le service ManagerAdapter (obligatoire sur tous les sites où un Manager à connecter à DIVAnet s'exécute), lancez la commande suivante :
InstallDivanetService.bat ../../conf/divanet/wrapper/ManagerAdapterWrapper.conf
Pour le service ClientAdapter, utilisez la même commande et le même chemin, mais remplacez le nom de fichier par ClientAdapterWrapper.conf.
Pour le service DbSync, utilisez le nom de fichier DBSyncWrapper.conf.
Dans la fenêtre des services Windows, vous devez voir un ou plusieurs des services DIVAnet suivants :
Divanet ManagerAdapter
Divanet ClientAdapter
Divanet DbSync
Les services peuvent être démarrés dans n'importe quel ordre, mais gardez à l'esprit qu'une fois le service DbSync et les services ManagerAdapter démarrés, le processus de synchronisation de la base de données démarrera automatiquement. Démarrez le service ClientAdapter pour permettre les nouvelles connexions DIVAnet et le traitement d'API.
Procédez de la manière suivante pour installer les services DIVAnet dans un environnement Linux :
Ouvrez une session de terminal et accédez au répertoire Program/divanet/bin.
Exécutez le script divanetservice pour installer le service désiré (DbSync, ClientAdapter ou ManagerAdapter). Par exemple, pour installer le service ClientAdapter, entrez la commande suivante :
./divanetservice install ClientAdapter
Après avoir créé les services DIVAnet sur Linux, vous pouvez les gérer à l'aide des commandes suivantes :
Tableau 3-1 Services DIVAnet sur Linux
| Opération | Commande |
|---|---|
|
Liste de tous les services |
|
|
Démarrer un service |
|
|
Arrêter un service |
|
|
Redémarrer un service |
|
|
Installer un service |
|
|
Désinstaller un service |
|
Le paramètre service_name peut être DbSync, ClientAdapter ou ManagerAdapter. Il est également possible de gérer les services DIVAnet en utilisant la syntaxe de commande systemctl standard de Linux V. Vous pouvez entrer man systemctl à l'invite de commande de Linux pour obtenir des informations plus détaillées sur la commande systemctl.
Les applications DIVAnet produisent deux types de journaux :
Journaux de suivi : situés dans le répertoire de base DIVAnet, dans le sous-dossier Program/log/divanet. Chacun des services DIVAnet (ManagerAdapter, DbSync et ClientAdapter) crée son propre sous-dossier sous le dossier Program/log/divanet et génère ses fichiers journaux dans ce sous-répertoire.
Journaux de service de wrapper : à examiner en priorité pour vérifier que les applications démarrent correctement. Ces journaux figurent dans le répertoire de base DIVAnet, dans le sous-dossier Program/log/divanet. Ils seront nommés de la même façon que le fichier Wrapper.conf mais avec une extension de nom de fichier .log (par exemple : ManagerAdapterWrapper.log).
Les erreurs les plus courantes dans la configuration de DIVAnet concernent la spécification des noms de site. Tous les sites DIVA dans le réseau DIVAnet doivent utiliser le même jeu de noms de site. Les noms de site doivent être cohérents dans tous les fichiers de configuration, ainsi que dans la base de données DIVAnet. Le paramètre LocalSitename doit être configuré correctement dans tous les fichiers de configuration.
Vous devez également vérifier la source/destination DIVArchive. Par exemple, par défaut, si le site diva1 a une source/destination qui a le même nom qu'une source/destination sur le site diva2, DIVAnet considère que les deux pointent vers la même source/destination logique. Si le même nom de source/destination est configuré sur deux sites DIVArchive différents, DIVAnet suppose que ces sources/destinations font référence au même emplacement.
Quand le service DbSync est démarré, il tente de synchroniser les informations d'objets archivés en consultant le service ManagerAdapter. A son tour, le service ManagerAdapter extrait les informations sur les actifs à partir du site DIVArchive auquel il est connecté. Par conséquent, vous devez démarrer le service DbSync et les services ManagerAdapter uniquement quand vous êtes prêt à lancer la synchronisation.
Remarque :
Si vous arrêtez le service DbSync, la synchronisation reprendra là où elle a été abandonnée au redémarrage du service.L'outil de ligne de commande DivanetAdmin surveille le statut de la synchronisation de la base de données, site par site. Si DIVAnet effectue une synchronisation initiale d'un site donné, il affiche le pourcentage d'avancement de cette opération de synchronisation initiale. Si le site est à jour, DivanetAdmin indique qu'il est en état In Sync.
DivanetAdmin peut également être utilisé pour resynchroniser un site. Cela implique la suppression de tous les enregistrements d'objets archivés préalablement synchronisés à partir du site et leur resynchronisation depuis la source. Cette opération doit être utilisée à titre exceptionnel, notamment quand la base de données DIVA source a été accidentellement restaurée à partir d'une sauvegarde périmée.
Il est recommandé de sauvegarder le répertoire de base DIVAnet existant avant de tenter une mise à niveau vers une nouvelle version de DIVAnet. Vous devez également arrêter tous les services DIVAnet ou programmes sur le serveur avant de procéder à une mise à niveau. Procédez de la manière suivante pour mettre à niveau le logiciel DIVAnet :
Suivez les instructions fournies dans la section Installation du logiciel DIVAnet. Vous installerez ainsi le dernier logiciel DIVAnet dans le répertoire de base DIVAnet.
Si vous mettez à niveau un système contenant une base de données DIVAnet, vous devez exécuter l'utilitaire de mise à niveau de la base. Pour cela, passez dans le répertoire Program/divanet/bin et entrez la commande suivante :
Windows : upgradeDB.bat
Linux : ./upgradeDB.sh
Le script vous demande de fournir des informations concernant la base de données DIVAnet (notamment le nom d'utilisateur de base de données et l'adresse réseau où la base réside). L'utilitaire ajoutera ou modifiera les objets de base de données requis. Le script renvoie simplement un message de succès si la base de données a déjà été mise à niveau vers la plus récente version.