Migration sous Windows pour Adobe Campaign 7

Procédure générale

Les étapes de migration sous Windows sont les suivantes :

  1. Arrêter les services : voir la section Arrêt des services.
  2. Sauvegarder la base de données : voir la section Sauvegarde de la base et de l'installation existante.
  3. Effectuer la migration de la plateforme : voir la section Déploiement d'Adobe Campaign v7.
  4. Effectuer la migration du serveur de redirection (IIS) : voir la section Migration du serveur de redirection (IIS).
  5. Redémarrer les services : voir la section Redémarrage des services.
  6. Supprimer et nettoyer la version précédente d'Adobe Campaign : voir la section Suppression et nettoyage de la version précédente d'Adobe Campaign.

Arrêt des services

Arrêtez d'abord tous les processus accédant à la base de données, sur toutes les machines concernées.

  1. Les serveurs utilisant le module de redirection (service webmdl) doivent être arrêtés. Pour IIS, exécutez la commande suivante :

    iisreset /stop
    
  2. Le module mta et ses modules fils (mtachild) doivent être arrêtés correctement à l'aide des commandes :

    nlserver stop mta@<instance name>
    nlserver stop mtachild@<instance name>
    
  3. Arrêtez les services Adobe Campaign sur tous les serveurs. Connectez-vous en tant qu'administrateur et exécutez la commande :

    net stop nlserver6
    

    Si vous migrez à partir de la version v5.11, exécutez la commande suivante :

    net stop nlserver5
    
  4. Sur chaque serveur, vérifiez que les services Adobe Campaign ont bien été arrêtés. Connectez-vous en tant qu'administrateur et exécutez la commande :

    tasklist /FI "IMAGENAME eq nlserver*"
    

    La liste des processus actifs ainsi que leur identifiant (PID) correspondant apparaît.

    Image Name                     PID Session Name        Session#    Mem Usage
    ========================= ======== ================ =========== ============
    nlserver.exe                  3192 Console                    1     13,108 K
    
  5. Si un ou plusieurs processus Adobe Campaign sont encore actifs ou bloqués au bout de quelques minutes, forcez leur arrêt. Connectez-vous en tant qu'administrateur et exécutez la commande :

    taskkill /IM nlserver* /T
    
  6. Si certains processus sont toujours actifs au bout de quelques minutes, vous pouvez forcer leur fermeture à l'aide de la commande :

    taskkill /F /IM nlserver* /T
    

Sauvegarde de la base et de l'installation existante

La procédure dépend de votre version précédente d'Adobe Campaign :

Migration à partir d'Adobe Campaign v5.11

  1. Sauvegardez la base de données Adobe Campaign.

  2. Sauvegardez le répertoire Neolane v5, à l'aide de la commande suivante :

    ren "Neolane v5" "Neolane v5.back"
    
    IMPORTANT

    Par mesure de précaution, nous vous recommandons vivement de zipper le dossier Neolane v5.back, et de le conserver à un autre emplacement que le serveur, sur un support sécurisé.

  3. Dans la console de gestion des services Windows, désactivez le démarrage automatique du service Serveur Applicatif 5.11. Vous pouvez également utiliser la commande suivante :

    sc config nlserver5 start= disabled
    
  4. Éditez le fichier config-<instance name>.xml (dans le dossier Neolane v5. back) pour empêcher les services mta, wfserver, stat, etc. de démarrer automatiquement. Par exemple, remplacez autoStart par _autoStart.

    <?xml version='1.0'?>
    <serverconf>
      <shared>
        <dataStore hosts="myServer*" lang="en_US">
          <dataSource name="default">
            <dbcnx encrypted="1" login="myLogin" password="myPassword"  provider="postgresql" server="myServer"/>
          </dataSource>
        </dataStore>
      </shared>
    
      <mta _autoStart="true" statServerAddress="myStatServer"/>
      <stat _autoStart="true"/>
      <wfserver _autoStart="true"/>
      <inMail _autoStart="true"/>
      <sms _autoStart="false"/>
    </serverconf>
    

Migration à partir d'Adobe Campaign v6.02

  1. Sauvegardez la base de données Adobe Campaign.

  2. Sauvegardez le répertoire Neolane v6, à l'aide de la commande suivante :

    ren "Neolane v6" "Neolane v6.back"
    
    IMPORTANT

    Par mesure de précaution, nous vous recommandons vivement de zipper le dossier Neolane v6.back, et de le conserver à un autre emplacement que le serveur, sur un support sécurisé.

  3. Dans la console de gestion des services Windows, désactivez le démarrage automatique du service Serveur Applicatif 6.02. Vous pouvez également utiliser la commande suivante :

    sc config nlserver6 start= disabled
    
  4. Éditez le fichier config-<instance name>.xml (dans le dossier Neolane v6. back) pour empêcher les services mta, wfserver, stat, etc. de démarrer automatiquement. Par exemple, remplacez autoStart par _autoStart.

    <?xml version='1.0'?>
    <serverconf>
      <shared>
        <dataStore hosts="myServer*" lang="en_US">
          <dataSource name="default">
            <dbcnx encrypted="1" login="myLogin" password="myPassword" provider="postgresql" server="myServer"/>
          </dataSource>
        </dataStore>
      </shared>
    
      <mta _autoStart="true" statServerAddress="myStatServer"/>
      <stat _autoStart="true"/>
      <wfserver _autoStart="true"/>
      <inMail _autoStart="true"/>
      <sms _autoStart="false"/>
    </serverconf>
    

Migration à partir d'Adobe Campaign v6.1

  1. Sauvegardez la base de données Adobe Campaign.

  2. Sauvegardez le répertoire Adobe Campaign v6, à l'aide de la commande suivante :

    ren "Adobe Campaign v6" "Adobe Campaign v6.back"
    
    IMPORTANT

    Par mesure de précaution, nous vous recommandons vivement de zipper le dossier Adobe Campaign v6.back, et de le conserver à un autre emplacement que le serveur, sur un support sécurisé.

  3. Dans la console de gestion des services Windows, désactivez le démarrage automatique du service Serveur Applicatif 6.11. Vous pouvez également utiliser la commande suivante :

    sc config nlserver6 start= disabled
    

Déploiement d'Adobe Campaign v7

Le déploiement d'Adobe Campaign se déroule en deux parties :

  • L'installation du build v7 : cette opération doit être effectuée sur chaque serveur.
  • Le postupgrade : cette commande doit être lancée sur chaque instance.

Les étapes de déploiement d'Adobe Campaign sont les suivantes :

  1. Installez le build le plus récent d'Adobe Campaign v7 en exécutant le fichier d'installation setup.exe. Pour plus d'informations sur l'installation du serveur Adobe Campaign sous Windows, voir cette section.

    Remarque

    Par défaut, Adobe Campaign v7 est installé dans le répertoire C:\Program Files\Adobe\Adobe Campaign v7.

  2. Pour mettre à disposition le programme d'installation de la console cliente, copiez le fichier setup-client-7.0.XXXX.exe dans le répertoire d'installation d'Adobe Campaign : C:\Program Files\Adobe\Adobe Campaign v7\datakit\nl\eng\jsp.

    Remarque

    Pour plus d'informations sur l'installation d'Adobe Campaign sous Windows, consultez cette section.

  3. Préparez l'instance à sa première utilisation à l'aide des commandes suivantes :

    net start nlserver6-v7
    net stop nlserver6-v7
    
    Remarque

    Ces commandes permettent de créer le système de fichiers interne d'Adobe Campaign v7 : répertoire conf (avec les fichiers config-default.xml et serverConf.xml), répertoire var, etc.

  4. Copiez et collez (écrasez) les fichiers de paramétrage et sous-dossiers de chaque instance via le fichier de sauvegarde Neolane v5.back, Neolane v6.back ou Adobe Campaign v6.back (selon la version à partir de laquelle vous migrez, voir cette section).

  5. En fonction de la version à partir de laquelle vous migrez, exécutez les commandes suivantes :

    copy "Neolane v5.back"/conf/config-<instance name>.xml "Adobe Campaign v7"/conf/
    copy "Neolane v5.back"/customers/* "Adobe Campaign v7"/customers/
    copy "Neolane v5.back"/var/* "Adobe Campaign v7"/var/
    
    copy "Neolane v6.back"/conf/config-<instance name>.xml "Adobe Campaign v7"/conf/
    copy "Neolane v6.back"/customers/* "Adobe Campaign v7"/customers/
    copy "Neolane v6.back"/var/* "Adobe Campaign v7"/var/
    
    copy "Adobe Campaign v6.back"/conf/config-<instance name>.xml "Adobe Campaign v7"/conf/
    copy "Adobe Campaign v6.back"/customers/* "Adobe Campaign v7"/customers/
    copy "Adobe Campaign v6.back"/var/* "Adobe Campaign v7"/var/
    
    IMPORTANT

    Pour la première des commandes ci-dessous, ne copiez pas le fichier config-default.xml.

  6. Dans les fichiers serverConf.xml et config-default.xml d'Adobe Campaign v7, appliquez les paramétrages spécifiques dont vous disposiez dans la version précédente d'Adobe Campaign. Pour le fichier serverConf.xml, utilisez le fichier Neolane v5/conf/serverConf.xml.diff, Neolane v6/conf/serverConf.xml.diff ou Adobe Campaign v6/conf/serverConf.xml.diff.

    Remarque

    Lors du report des paramétrages de la version précédente d'Adobe Campaign vers Adobe Campaign v7, assurez-vous que les chemins vers les répertoires physiques pointent bien vers Adobe Campaign v7 (et pas Neolane v5, Neolane v6 ni Adobe Campaign v6).

  7. Rechargez la configuration d'Adobe Campaign v7 à l'aide de la commande suivante :

    nlserver config -reload
    
  8. Démarrez le processus de postupgrade à l'aide de la commande suivante :

    nlserver config -postupgrade -instance:<instance name>
    
IMPORTANT

Ne redémarrez pas les services Adobe Campaign à ce stade. Des modifications doivent préalablement être effectuées sur IIS.

Migration du serveur de redirection (IIS)

À ce stade, le serveur IIS doit être arrêté. Voir la section Arrêt des services.

  1. Ouvrez la console Internet Information Services (IIS) Manager.

  2. Modifiez les liaisons (ports d'écoute) du site utilisé pour la version précédente d'Adobe Campaign :

    • Cliquez avec le bouton droit sur le site utilisé pour la version précédente d'Adobe Campaign et sélectionnez Modifier les liaisons.

    • Pour chaque type de port d'écoute (http et/ou https), sélectionnez la ligne correspondante et cliquez sur Modifier.

    • Saisissez un autre port que celui qui est renseigné. Par défaut, le port d'écoute est 80 pour le http et 443 pour le https. Vérifiez que le nouveau port est disponible.

      Remarque

      Si votre serveur IIS embarque plusieurs sites web pour Adobe Campaign configurés de manière avancée (port commun et adresses IP différentes), veuillez vous rapprocher de votre administrateur.

  3. Créez un nouveau site web pour Adobe Campaign v7 :

    • Cliquez avec le bouton droit sur le dossier Sites et sélectionnez Ajouter un site Web.

    • Renseignez le nom du site, par exemple Adobe Campaign v7.

    • Le chemin d'accès au répertoire de base du site Web n'est pas utilisé, mais le champ Chemin d'accès physique doit être obligatoirement renseigné. Saisissez par exemple le chemin physique par défaut de IIS : C:\inetpub\wwwroot.

    • Cliquez sur le bouton Se connecter en tant que, et vérifiez que l'option Utilisateur de l'application est sélectionnée.

    • Dans les champs Adresse IP et Port, vous pouvez laisser les valeurs par défaut. Si vous souhaitez utiliser d'autres valeurs, vérifiez que l'adresse IP et/ou le port sont disponibles.

    • Cochez la case Démarrage immédiat du site Web.

  4. Exécutez le script iis_neolane_setup.vbs permettant de configurer automatiquement le paramétrage des ressources utilisées par le serveur Adobe Campaign sur le répertoire virtuel créé précédemment.

    • Ce fichier se trouve dans le répertoire [Adobe Campaign v7]\conf, où [Adobe Campaign v7] est le chemin d'accès au répertoire d'installation d'Adobe Campaign. La commande d'exécution du script est la suivante (pour les administrateurs) :

      cd C:\Program Files (x86)\Adobe Campaign\Adobe Campaign v7\conf
      cscript iis_neolane_setup.vbs
      
    • Cliquez sur OK pour confirmer l'exécution du script.

    • Saisissez le numéro du site Web que vous avez créé précédemment pour Adobe Campaign v7 et cliquez sur OK.

    • Un message de confirmation doit s'afficher :

    • Dans l'onglet Affichage du contenu, vérifiez que la configuration du site Web est bien paramétrée avec les ressources Adobe Campaign :

      Remarque

      Si l'arborescence n'est pas affichée, redémarrez le Gestionnaire de service Internet (IIS).

      Les étapes suivantes de configuration de IIS sont décrites dans cette section.

Zones de sécurité

Si vous migrez depuis une v6.02 ou antérieure, vous devez paramétrer vos zones de sécurité avant de redémarrer les services. Voir à ce sujet la section Sécurité.

Redémarrage des services

Sur chacun des serveurs suivants, démarrez IIS puis les services Adobe Campaign :

  1. Serveur de tracking/redirection.
  2. Serveur de mid-sourcing.
  3. Serveur marketing.

Avant de passer à l'étape suivante, testez complètement la nouvelle installation, validez la non-régression et assurez-vous que tout est fonctionnel, en suivant toutes les recommandations données dans la section Paramétrages généraux.

Suppression et nettoyage de la version précédente d'Adobe Campaign

La procédure dépend de votre version précédente d'Adobe Campaign :

Adobe Campaign v5

Avant de supprimer et nettoyer l'installation d'Adobe Campaign v5, il est impératif de suivre les recommandations ci-dessous :

  • Effectuez une validation complète de la nouvelle installation par les équipes fonctionnelles.
  • Ne procédez à la désinstallation d'Adobe Campaign v5 qu'une fois que vous êtes certain qu'un retour arrière n'est pas nécessaire.
  1. Dans IIS, supprimez le site web Neolane v5 puis le pool d'applications Neolane v5.

  2. Renommez le dossier Neolane v5.back en Neolane v5.

  3. Désinstallez Adobe Campaign v5 à l'aide de l'assistant d'ajout/suppression de programme.

  4. Supprimez le service Windows nlserver5 à l'aide de la commande suivante :

    sc delete nlserver5
    
  5. Redémarrez le serveur.

Adobe Campaign v6.02

Avant de supprimer et nettoyer l'installation d'Adobe Campaign v6.02, il est impératif de suivre les recommandations ci-dessous :

  • Effectuez une validation complète de la nouvelle installation par les équipes fonctionnelles.
  • Ne procédez à la désinstallation d'Adobe Campaign v6.02 qu'une fois que vous êtes certain qu'un retour arrière n'est pas nécessaire.
  1. Dans IIS, supprimez le site web Neolane v6 puis le pool d'applications Neolane v6.

  2. Renommez le dossier Neolane v6.back en Neolane v6.

  3. Désinstallez Adobe Campaign v6.02 à l'aide de l'assistant d'ajout/suppression de programme.

  4. Redémarrez le serveur.

Adobe Campaign v6.1

Avant de supprimer et nettoyer l'installation d'Adobe Campaign v6, il est impératif de suivre les recommandations ci-dessous :

  • Effectuez une validation complète de la nouvelle installation par les équipes fonctionnelles.
  • Ne procédez à la désinstallation d'Adobe Campaign v6 qu'une fois que vous êtes certain qu'un retour arrière n'est pas nécessaire.
  1. Dans IIS, supprimez le site web Adobe Campaign v6 puis le pool d'applications Adobe Campaign v6.

  2. Renommez le dossier Adobe Campaign v6.back en Adobe Campaign v6.

  3. Désinstallez Adobe Campaign v6 à l'aide de l'assistant d'ajout/suppression de programme.

  4. Redémarrez le serveur.

Sur cette page