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 DIVAnet doit ê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 version ultérieure.
DIVAnet peut être installée sur des plates-formes Windows 64 bits, dans le même répertoire de base que DIVArchive ou dans son propre répertoire.
L'exécution du programme d'installation DIVAnet nécessite des privilèges d'administrateur.
Par défaut, le programme d'installation DIVAnet gère l'installation des fichiers des services DIVAnet, de DIVAnetUI ainsi que d'un environnement JRE Java 8, 64 bits compatible. DIVAnet utilise le JRE installé pour l'exécution. L'installation de la base de données DIVAnet requiert qu'Oracle Database 11g version 2 ou supérieure et qu'Oracle SQLPlus (logiciel client Oracle 11 ou supérieur) soient installés directement sur le système Windows pour DIVAnet.
Si vous réinstallez DIVAnet, assurez-vous que les composants DIVAnet ne sont pas en cours d'exécution.
Lancez l'exécutable d'installation de DIVAnet, DIVAnet_V2.0.version.exe.
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 l'installation de DIVAnet dans un répertoire qui lui est propre.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 concerne la création des 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 (reportez-vous au Chapitre 2).
Pour lancer des scripts de création SQL, SQLPlus (logiciel client Oracle 11) doit être installé sur le système sur lequel vous installez DIVAnet.
Ouvrez une fenêtre de ligne de commande. Accédez au répertoire de base DIVAnet (où DIVAnet est installé).
Passez au répertoire Program\Database\divanet\Install.
Exécutez la commande suivante :
create_divanet_user.bat 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 la base de données DIVAnet, procédez comme suit.
Attention :
Cela supprimera toutes les données de la base de données DIVAnet.Passez au répertoire Program\Database\divanet\Install.
Exécutez la commande suivante :
delete_divanet_user.bat syspassword username 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, 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 auquel 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.bat comme suit :
Accédez au répertoire de base DIVAnet, puis au sous-dossier Program\divanet\bin.
Exécutez le script addSites.bat. Ce script vous guide pour l'ajout des enregistrements de nom de site et la configuration des noms de site, des emplacements et des commentaires. Les connexions réseau aux sites sont configurées dans le fichier de configuration ClientAdapter (reportez-vous au 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 des noms de site avant d'exécuter le script addSites. Si vous faites une erreur lors de l'exécution de la commandeaddSites.bat, Oracle recommande de recréer la base de données ou de contacter le support technique Oracle. 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 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 (dans ce cas, 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 pouvez également configurer 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 ne savez pas quelles valeurs par défaut vous devez modifier, 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.
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 utilisez ClientAdapterWrapper.conf comme nom de fichier.
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.
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 : examinez tout d'abord ces journaux 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 communes dans la configuration de DIVAnet concernent des erreurs de spécification de 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 que l'une des sources/destinations 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 supposera que ces sources/destinations font référence aux mêmes emplacements.
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 d'actif 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 redémarrera 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é, elle affichera le pourcentage d'avancement de cette opération de synchronisation initiale. Si le site est à jour, DivanetAdmin indiquera que le site est In Sync.
DivanetAdmin peut également être utilisée pour resynchroniser un site. Ceci 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 dans des cas rares, notamment quand la base de données DIVA source a été restaurée à partir d'une sauvegarde de base de données périmée.