Migration d’une installation existante d’AgendaX vers Microsoft 365

Beaucoup de nos clients migrent leur infrastructure Exchange existante vers le cloud. Microsoft 365 est l’option la plus couramment utilisée.

Mais que faut-il faire pour une installation AgendaX existante qui est configurée pour accéder aux serveurs Exchange sur site ?

Cela dépend en grande partie du fait que vous fassiez la transition vers Microsoft 365 en une seule étape (batch) ou en plusieurs étapes au cours des semaines/mois. Si la transition se fait en un seul lot, vous n’aurez qu’à reconfigurer votre installation existante. Si vous avez beaucoup de boîtes aux lettres à migrer et que cela prendra un certain temps, nous vous suggérons d’installer une deuxième instance d’AgendaX sur le même serveur. Cela permettra une transition en douceur et affichera à tout moment tous les calendriers des utilisateurs (boîtes aux lettres sur site et migrées) dans les vues d’AgendaX.

Migration en un seul lot

Vous devrez désinstaller MAPI/CDO (Exchange Server MAPI), s’il est installé, et installer un client Outlook 32bit (Outlook 2016 ou version ultérieure) sur le serveur AgendaX. De plus, la boîte aux lettres AgendaX doit d’abord être migrée vers Microsoft 365, avant de commencer à migrer les boîtes aux lettres des utilisateurs.

Assurez-vous également qu’un navigateur moderne est installé sur le serveur AgendaX, car il est nécessaire pour créer un profil Outlook qui se connecte à une boîte aux lettres Microsoft 365.

Puis,

• Connectez-vous au serveur AgendaX avec l’utilisateur AgendaX. Ceci est TRÈS important car les profils Outlook sont spécifiques à l’utilisateur.
• Exécutez Regedit et assurez-vous que la valeur MapiHttpDisabled n’existe pas sous HKEY_CURRENT_USER\Software\Microsoft\Exchange ou que sa valeur soit fixée à 0.
• Ajouter les clés suivantes au registre sous HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\Common\Identity
  
  EnableADAL (DWORD) 1
  DisableAADWAM (DWORD) 1
  DisableADALatopWAMOverride (DWORD) 1
  
  et sous HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Outlook\Cached Mode ajoutez une valeur appelée AllowAutoDiscoverForNonOutlook et définissez sa valeur à DWORD 1.
• Outlook 2016:
  • Assurez-vous que KB3115279 for Office 2016 32bit (https://www.microsoft.com/en-us/download/details.aspx?id=53200)
    est installé.
  • Ajoutez le paramètre suivant à AgentX.ini :
    [Config]
    ForceIExchangeManageStoreEx=1
• Outlook 2019 / Office 365:
  • Ajoutez le paramètre suivant à AgentX.ini :
    [Config]
    ForceIExchangeManageStoreEx=1
• Ensuite, créez le profil Outlook et assurez-vous que le mode Exchange Cache est désactivé dans le profil Outlook. Saisissez le nom du profil Outlook (soit dans AgendaX Setup si vous configurez une nouvelle instance d’AgendaX, soit dans AgendaXCfg.exe si AgendaX est déjà installé sous MSX Version / Outlook MAPI Client / Outlook Profile Name). Le nom standard du premier profil Outlook configuré est « Outlook ».
• Démarrez Outlook avec ce profil et assurez-vous que le profil fonctionne. Lorsque vous êtes invité à saisir un mot de passe, veillez à cocher la case « Mémoriser le mot de passe ».
• Enfin, fermez Outlook et redémarrez le service de mise à jour AgendaX.

Les permissions sur Microsoft 365 doivent être définies un peu différemment que dans un environnement Exchange sur site. Sur Microsoft 365, vous devrez définir les autorisations au niveau du dossier :

Veuillez donner à l’utilisateur AgendaX des droits de réviseur sur la partie supérieure de la boîte aux lettres et des droits d’éditeur sur le dossier Calendrier.

Le script Powershell suivant le fera pour vous. Remplacez « agendax » sur les 4ème et 5ème lignes du script suivant par le nom de votre compte M365 AgendaX :

Connect-ExchangeOnline
foreach ($Mailbox in (Get-EXOMailbox -OrganizationalUnit abc -ResultSize Unlimited))
{
Add-MailboxFolderPermission -identity "$($Mailbox.Name)" -AccessRights Reviewer -User agendax
Add-MailboxFolderPermission -identity "$($Mailbox.Name):\Calendrier" -AccessRights Editor -User agendax
}
Disconnect-ExchangeOnline

"-OrganizationalUnit abc" limite les utilisateurs à une OU spécifique (ici "abc").
Cela peut être omis si vous souhaitez accorder les autorisations à tous les utilisateurs de votre organisation.

Si vous souhaitez plutôt limiter les utilisateurs à ceux qui ont une adresse SMTP spécifique, vous pouvez utiliser le script suivant :

Connect-ExchangeOnline
foreach ($Mailbox in (Get-Mailbox -ResultSize Unlimited | where-Object {($_.PrimarySMTPAddress -like "*@agendax.net")}))
{
Add-MailboxFolderPermission -identity "$($Mailbox.Name)" -AccessRights Reviewer -User agendax
Add-MailboxFolderPermission -identity "$($Mailbox.Name):\Calendrier" -AccessRights Editor -User agendax
}
Disconnect-ExchangeOnline

Ou, si vous souhaitez limiter les utilisateurs aux membres d'une liste de distribution spécifique,
vous pouvez utiliser ce qui suit :

Connect-ExchangeOnline
foreach ($Mailbox in (Get-DistributionGroupMember -Identity "NameDerVerteilerliste" -ResultSize Unlimited))
{
Add-MailboxFolderPermission -identity "$($Mailbox.Name)" -AccessRights Reviewer -User agendax
Add-MailboxFolderPermission -identity "$($Mailbox.Name):\Calendrier" -AccessRights Editor -User agendax
}
Disconnect-ExchangeOnline

Veuillez également consulter le document suivant : AgendaX Installation Guide

Migration au cours de plusieurs semaines/mois

Si la migration vers Microsoft 365 prend un certain temps et que vous migrez des boîtes aux lettres en plusieurs lots, nous suggérons d’installer une deuxième instance d’AgendaX pendant la transition.

La première instance (existante) lira les boîtes aux lettres sur site et la deuxième instance (nouvelle) lira les boîtes aux lettres migrées (M365).

Pendant la transition, vous verrez toujours tous les calendriers des boîtes aux lettres sur site et migrées dans l’application web AgendaX.

Installation d’une deuxième configuration AgendaX sur le serveur AgendaX pour accéder aux boîtes aux lettres M365

• Créez un nouvel utilisateur AgendaX sur Microsoft 365 (y compris une boîte aux lettres).
• Copiez le dossier d’installation d’AgendaX dans un second emplacement, par exemple AgendaXM365.
• Installez le deuxième service à l’aide de l’outil de configuration multi-services AgendaX. Le compte de service que vous saisissez sera le compte utilisé pour exécuter le service de mise à jour AgendaX. Il devrait idéalement s’agir du nouvel utilisateur AgendaX sur Microsoft 365. Si ce n’est pas possible, sélectionnez un utilisateur local avec des privilèges administratifs sur le serveur AgendaX.
• Installez Outlook 2016 (ou version ultérieure) 32bit sur le serveur AgendaX, s’il n’est pas déjà présent.
• Assurez-vous qu’un navigateur moderne est installé sur le serveur AgendaX, car il est nécessaire pour créer un profil Outlook qui se connecte à une boîte aux lettres Microsoft 365.
• Connectez-vous au serveur AgendaX avec le nouvel utilisateur AgendaX (ou l’utilisateur local que vous avez spécifié lors de l’installation du deuxième service).
• Définissez les clés de registre appropriées pour la version d’Outlook utilisée et les paramètres d’AgentX.ini (page 6 du Guide d’installation : Guide d’installation d’AgendaX) ou voir ci-dessus (Migration en un seul lot).
• Créez un profil Outlook avec cet utilisateur, accédant à sa boîte aux lettres sur M365, et désactivez le mode cache Exchange dans le profil Outlook. Si vous êtes invité à saisir un nom d’utilisateur / mot de passe, cochez l’option « Mémoriser le mot de passe » avant de saisir les informations d’identification. Notez le nom du profil Outlook que vous avez créé (par défaut : Outlook).
• Exécutez la configuration AgendaX dans l’installation AgendaX M365 (AgendaXCfg.exe), cliquez sur MSX Version, sélectionnez Office 365 et entrez le nom du profil Outlook que vous avez créé, connecté avec l’utilisateur AgendaX M365 (ou l’utilisateur local).
• Définissez les permissions sur les dossiers de boîtes aux lettres pour les utilisateurs déjà migrés vers M365 à l’aide du script Powershell suivant. Remplacez « agendax » sur les 4ème et 5ème lignes du script suivant par le nom de votre compte M365 AgendaX :
  [text-blocks id= »4990″ slug= »exchange-permissions-2016-office-365″]
• Arrêtez le service AgendaX Update de l’ancienne installation d’AgendaX.
• Exécutez la configuration AgendaX de l’ancienne et de la nouvelle installation (AgendaXCfg.exe), cochez l’option « Multiple services write to this database » et supprimez les tables de la base de données (une seule fois) sous Config / Drop tables.
• Cliquez sur « Update “ dans les deux configurations AgendaX et sur ”Oui » pour redémarrer les services.
• Vérifiez le journal d’événements application de Windows pour d’éventuels avertissements/erreurs. Chacun des services ajoutera des avertissements au journal des événements application pour les boîtes aux lettres qui ne se trouvent pas sur leur système. C’est normal. L’installation sur site créera des avertissements pour les boîtes aux lettres M365 et l’installation M365 créera des avertissements pour les boîtes aux lettres sur site. Si vous recevez des avertissements sur l’installation M365 concernant des boîtes aux lettres introuvables dans le carnet d’adresses global et que ces boîtes aux lettres ont déjà été migrées vers M365, vous devrez les sélectionner à nouveau dans le carnet d’adresses dans les définitions de groupe AgendaX (AgendaXCfg.exe / Groups).
• Une fois que les deux services de mise à jour AgendaX ont fini de scanner les boîtes aux lettres, vous verrez les calendriers des boîtes aux lettres sur site et M365 dans l’application web AgendaX.
• Pendant que vous migrez les utilisateurs des serveurs Exchange sur site vers M365, vous devrez réexécuter le script Powershell ci-dessus pour définir les autorisations sur les boîtes aux lettres nouvellement déplacées.

Suppression de l’ancienne configuration AgendaX après le transfert de toutes les boîtes aux lettres vers M365

Lorsque toutes les boîtes aux lettres sont transférées vers M365, vous pouvez désinstaller l’ancienne installation d’AgendaX en suivant les étapes ci-dessous. Comme l’application web d’AgendaX fonctionne toujours sous l’ancienne installation d’AgendaX, vous devrez d’abord la déplacer vers l’emplacement de la nouvelle installation (M365) :

• Lancez Internet Information Services (IIS) Manager, naviguez vers Sites / Default Web Site / AgendaX, cliquez sur « Basic settings » et modifiez l’emplacement du « Physical path » pour le dossier de votre nouvelle installation d’AgendaX M365.

Si vous avez modifié la configuration sur la page Administration AgendaX (dans l’application web AgendaX) depuis l’installation de l’installation M365 d’AgendaX, ou si vous avez modifié le menu de groupe repliable dans le fichier multmenu.txt, copiez config.inc et multmenu.txt (tous deux situés dans le sous-dossier AGENDA de votre dossier d’installation d’AgendaX) de l’ancienne installation vers l’installation M365.

Pour désinstaller l’ancienne installation AgendaX, suivez les étapes ci-dessous :

• Arrêtez le service de mise à jour AgendaX de l’ancienne installation.
• Fermez toutes les instances de MMC (Microsoft Management Console), par exemple les services, l’observateur d’événements.
• Ouvrez une console de commande et accédez au dossier d’installation AgendaX de votre ancienne installation AgendaX, par ex. CD C:\Inetpub\AgendaX
• Entrez la commande suivante :
  AgendaXSrv.exe -u (cela désinstallera le service de mise à jour AgendaX)
• Supprimez l’ancien dossier d’installation AgendaX

La dernière étape consiste à indiquer au service AgendaX Update que plus aucun autre service n’utilise la même base de données. Exécutez la configuration AgendaX (AgendaXCfg.exe) dans votre nouveau dossier d’installation M365 et décochez l’option « Multiple services write to this database “ et supprimez les tables de la base de données sous Config / Drop tables, puis cliquez sur ” Update “ et ” Oui  » pour redémarrer le service.