Exploitation

		1. Lancement de l'application
		2. Document Task Status
		3. Mise à jour de l'application
		4. Suppression de l'application

 

1. Lancement de l'application

Back to Top

Avant de pouvoir lancer l'application ArchiveMailOnDB, celle-ci doit être correctement installée et paramétrée :

• Création de la base ArchiveOnDB.nsf sur le serveur Domino.
• Installation de l'exécutable ArchiveOnDB.exe dans le répertoire Programme du serveur Domino.
• Création d'un document de Setup dans la base ArchiveOnDB.nsf

Il existe plusieurs méthodes pour lancer l'application :

Lancement manuel depuis la base ArchiveOnDB.nsf

Depuis la vue Administration / Setup de la base ArchiveOnDB, il suffit de sélectionner le document Setup voulu et de cliquer sur le bouton  / . Pour s'assurer du bon démarrage de la Tâche, il suffit de vérifier le Statut de la Tâche via le document Task Status présent dans la vue Administration / Task Status.

Remarque : La base ArchiveOnDB.nsf doit se trouver sur le même serveur que la Tâche ArchiveOnDB.exe.

Lancement manuel depuis la console du serveur

Depuis la console du serveur, il suffit de lancer la commande suivante :

 

load archiveondb ArchiveOnDB.nsf MAIN

où :

archiveondb            est le nom de l'exécutable ArchiveOnDB.exe
ArchiveOnDB.nsf     est le chemin de la base ArchiveOnDB.nsf sur le serveur
MAIN                       est le nom du document de Setup que l'on souhaite utiliser (attention, la valeur est case-sensitive).

Si la console du serveur est active, celle-ci renverra un message proche de celui-ci :

02/05/2016 10:59:53 ArchiveMail On DB v 3.0, (c) CooperTeam, 2004-2016.

afin d'indiquer que la Tâche a correctement démarré.

Remarque : Si la base ArchiveOnDB.nsf est placée dans un sous répertoire du répertoire Data dont le nom contiendrait un espace, pensez à ajouter des guillemets ("") autour du nom de la base sur la ligne de commande :

load archiveondb "Admin Databases\ArchiveOnDB.nsf" MAIN

Lancement automatique depuis un document Program du Carnet d'Adresse

Afin de planifier un lancement automatique de la Tâche une fois par semaine, il suffit de créer dans le Carnet d'Adresse du serveur un document Program :

 

où :

ArchiveOnDB.exe            est le nom de l'exécutable ArchiveOnDB.
ArchiveOnDB.nsf MAIN    est la ligne de commande pour lancer l'application (chemin de la base ArchiveOnDB + Nom du document de Setup).

Les autres paramètres sont classiques :

• Nom du serveur hébergeant l'exécutable
• Jour / Heure de démarrage de la Tâche

Le mode de démarrage de l'application (Enabled / At Server Startup only) dans le document Program est directement lié au choix Run Type du document de Setup utilisé :

 

• Pour Run Once, on va choisir de démarrer la Tâche en mode Enabled + on choisit le/les jours de démarrage.
• Pour Run Always, on va choisir de démarrer la Tâche en mode At Server Startup only.

Remarque : Si la base ArchiveOnDB.nsf est placée dans un sous répertoire du répertoire Data dont le nom contiendrait un espace, pensez à ajouter des guillemets ("") autour du nom de la base sur la ligne de commande :

"Admin Databases\ArchiveOnDB.nsf" MAIN

Lancement automatique depuis les lignes ServerTasks= du Notes.ini

Pour faire démarrer la Tâche en même temps que le serveur (ServerTasks=) ou à une heure précise de la journée (ServerTasksAt=), il suffit de placer la ligne de commande de la Tâche ArchiveOnDB à la fin de la ligne correspondante dans le fichier Notes.ini du serveur :

ServerTasks=Update,Replica,Router,AMgr,AdminP,archiveondb ArchiveOnDB.nsf MAIN

où :

archiveondb             est le nom de l'exécutable ArchiveOnDB.exe
ArchiveOnDB.nsf      est le chemin de la base ArchiveOnDB.nsf sur le serveur
MAIN                        est le nom du document de Setup que l'on souhaite utiliser (attention, la valeur est case-sensitive).

Remarque : Si la base ArchiveOnDB.nsf est placée dans un sous répertoire du répertoire Data dont le nom contiendrait un espace, pensez à ajouter des guillemets ("") autour du nom de la base sur la ligne de commande :

archiveondb "Admin Databases\ArchiveOnDB.nsf" MAIN

 

2. Document Task Status

Back to Top

Le produit ArchiveMail on DB se présente sous la forme d'une Tâche serveur (ArchiveOnDB.exe) tournant sur un serveur Domino. La base Notes ArchiveOnDB.nsf fournit une interface de contrôle d'activité de la tâche. Dans la vue Administration / Task Status, plusieurs documents de suivi sont créés (un par Thread) pour renseigner l'administrateur sur l'état de la tâche et son activité.

 

3. Mise à jour de l'application

Back to Top

Les différentes étapes de mise à jour de l'application ArchiveOnDB avec une version plus récente sont les suivantes :

• Arrêter la Tâche ArchiveOnDB si elle est en cours d'exécution. Depuis la vue Administration / Setup, utiliser le bouton d'action  afin d'arrêter toutes les occurrences de la Tâche. Vérifier que les documents Setup ne soient pas lockés. Vérifier qu'il n'existe pas de documents Program dans le Carnet d'Adresse qui vont démarrer la Tâche dans les prochaines minutes.
  
  
• Vérifier les éléments de Design de la base ArchiveOnDB.nsf actuelle afin de s'assurer que les éléments de Design ne soit pas protégés contre le remplacement de Design.
  
  
• Créer un fichier ArchiveOnDB.ntf à partir de la nouvelle base ArchiveOnDB.nsf et remplacer le Design de la base actuelle ArchiveOnDB.nsf avec ce fichier.
  
  
• Signer la base AchiveOnDB.nsf avec l'ID Notes dédié.
  
  
• Supprimer dans la base ArchiveOnDB actuelle les documents présents dans les vues Installation / Documentation et Installation / Install Files. Remplacer ces documents par ceux venant de la nouvelle base ArchiveOnDB.
  
  
• Depuis la vue Administration / Setup, utiliser le bouton d'action  pour lancer les traitements suivants :
  - : Mise à jour du modèle de données de tous les documents Setup de la base.
  - : Mise à jour du modèle de données de tous les documents Profile de la base.
  - : Mise à jour du modèle de données de tous les documents Database de la base.
  
  
• Dans les documents Profile, vérifiez les @Formula des champs Creation Date @Formula et Last Modification Date @Formula dans l'onglet Archivable Documents / Document Selection. Créez un nouveau Profile et allez copier / coller les @Formula et remplacez les dans vos documents de Profile existants (si les @Formula ont changé). Si vous aviez adapté ces @Formula à votre usage en particulier, adaptez les nouvelles @Formula avec vos contraintes.
  
  
• Sélectionner dans la vue Installation / Install Files le document contenant le fichier exécutable de la Tâche ArchiveOnDB correspondant à votre configuration (version OS) et remplacer le fichier exécutable présent sur le serveur Domino par la nouvelle version.
  
  
• Si la version du composant CTSearchLib a changé, il conviendra de le mettre à jour sur les serveurs de Mail. Pour cela, il faut récupérer la version correspondant à votre configuration (version OS) dans la vue Install Files et remplacer le composant installé sur les serveurs de Mail par le nouveau. Comme ce composant est monté en mémoire par le serveur de Mail, il faudra arrêter le serveur Domino le temps de la mise à jour du composant et le relancer immédiatement après. Si le composant est également déployé manuellement en local sur les postes des utilisateurs, il conviendra également de le mettre à jour (fermeture du client Notes, remplacement de la DLL, redémarrage du client Notes). Si le composant a été déployé automatiquement (via l'option dans le document Profile), il n'y a rien à faire, les composants (CTSearchLib.dll et CTSearchTask.exe) seront mis à jour automatiquement par l'application.
  
  
• Si la recherche multi-bases est utilisée depuis iNotes, il conviendra au chapitre de la documentation relatif à l'installation des composants iNotes pour vérifier s'il y a quelque chose à faire.
  
  
• Depuis la vue Administration / Setup, utiliser le bouton d'action  afin de lancer la Tâche. Vérifier les Log afin de vous assurer que tout fonctionne bien.
  
  

 

4. Suppression de l'application

Back to Top

Les différentes étapes de suppression de l'application ArchiveOnDB des serveurs où elle a été installée sont les suivantes :

• Si vous voulez retirer des bases Mails l'ensemble des ajouts apportés par ArchiveOnDB (liens vers les bases Archives, module de recherche...), vous devez passer les documents Database en statut Out of Scope, leur appliquer la requête d'administration Remove all Archive Mail components from Mail database et faire tourner la Tâche Archive Mail une dernière fois.
  
  
• Arrêter la Tâche ArchiveOnDB si elle est en cours d'exécution. Depuis la vue Administration / Setup, utiliser le bouton d'action  afin d'arrêter toutes les occurrences de la Tâche. Vérifier que les documents Setup ne soient pas lockés. Vérifier qu'il n'existe pas de documents Program dans le Carnet d'Adresse qui vont démarrer la Tâche dans les prochaines minutes.
  
  
• Supprimer les documents Program du Carnet d'Adresse utilisés pour démarrer la Tâche. Si celle-ci démarre car sa ligne de commande est présente dans le fichier Notes.ini du serveur (ServerTasks=), supprimer la ligne de commande du fichier Notes.ini.
  
  
• Effacer l'exécutable ArchiveOnDB.exe du/des serveurs où il est installé (répertoire Programme Domino).
  
  
• Supprimer la base ArchiveOnDB.nsf présente dans le répertoire Data de Domino.
  
  
• Si vous voulez également supprimer le composant autorisant la recherche multi-bases, il conviendra d'arrêter les serveurs de Mail où il a été installé et de supprimer le fichier CTSearchLib du répertoire Programme Domino. Il conviendra également du supprimer son nom de la ligne EXTMGR_ADDINS= du fichier Notes.ini du serveur et des postes clients Notes (si le module a été installé en local). Vous pourrez ensuite redémarrer votre serveur Domino.

 

Back to Top