Utilisation de l'outil de gestion de mise à niveau. SAP 2011 Feature Pack 3

Document

Exécution des mises à niveau

Pour en savoir plus, voir le Guide de l'utilisateur de la console de gestion du cycle de vie de la plateforme

SAP BusinessObjects 4.0 de Business Intelligence.

5.1.5 Utilisation de l'outil de gestion de mise à niveau

L'outil de gestion de mise à niveau vous guide tout au long du processus d'exportation de contenu

Business Intelligence (comptes utilisateur, groupes, dossiers, rapports, univers, sécurité, et autres objets) lors de la mise à niveau de ce contenu vers la version la plus récente.

La mise à niveau implique les étapes suivantes :

Mises à niveau complètes

Sélectionnez un scénario de mise à niveau.

Spécifiez les déploiements source et de destination.

(Facultatif) Spécifiez les paramètres des objets.

Effectuez la mise à niveau.

Mises à niveau incrémentielles

Sélectionnez un scénario de mise à niveau.

Spécifiez les déploiements source et de destination.

Sélectionnez les objets à mettre à niveau.

(Facultatif) Spécifiez les paramètres des objets.

Spécifiez les dépendances des objets.

Effectuez la mise à niveau.

5.1.5.1 Avant de commencer

Avant de mettre à niveau le déploiement de la SAP Crystal Server 2011 Feature Pack 3, assurez-vous que tous les serveurs qui ne sont pas indispensables sur le déploiement source et le déploiement de destination sont éteints afin d'éviter les états d'incohérence dans votre nouveau déploiement 4.0 :

• Arrêtez tous les serveurs du déploiement source sauf le CMS (Central Management Server) et le

FRS (File Repository Server).

• Arrêtez tous les serveurs (y compris les Job Servers) du déploiement de destination sauf le CMS, le FRS et le Report Application Server (si vous avez l'intention de mettre les documents

Crystal Reports à niveau).

• (Facultatif) Configurez les paramètres SSL de l'outil de gestion de la mise à niveau.

Pour lancer l'outil de gestion de mise à niveau à partir du menu Démarrer, cliquez sur Programmes >

SAP Crystal Server 2011 > Crystal Server > Outil de gestion de mise à niveau.

27 2012-05-10

Exécution des mises à niveau

5.1.5.1.1 Configuration des paramètres SSL

Si vous utilisez la communication SSL, vous devez configurer les paramètres SSL de l'outil de gestion de mise à niveau dans <JARDIR>/upgradeManagementToolSystem.properties

Remarque :

Les propriétés SSL définies sur la machine virtuelle Java ont la priorité sur celles définies dans ce fichier.

Restriction :

Vous devez utilisez les mêmes certificats SSL sur les déploiements source et de destination, et aussi utiliser SAP Crystal Server 2011 Feature Pack 3 pour générer les certificats.

Ouvrez upgradeManagementToolSystem.properties dans un éditeur de texte.

Saisissez les valeurs de chaque paramètre.

Paramètre Valeur umt.systemVar.ssl.busi

nessobjects.orb.oci.pro

tocol

Valeur ssl

Remarque :

Le fait de saisir cette valeur active la communication SSL.

umt.systemVar.ssl.cert

Dir umt.systemVar.ssl.trus

tedCert

Emplacement des clés et des certificats

Nom du fichier de certificat approuvé

Remarque :

Si vous spécifiez plusieurs fichiers, séparez les entrées par un point virgule (par exemple, fichierA;fichierB).

umt.systemVar.ssl.ssl

Cert umt.systemVar.ssl.pass

phrase

Certificat SDK

umt.systemVar.ssl.sslKey

Clé privée du certificat SDK

Emplacement du fichier contenant la phrase de passe de la clé privée

Attention :

N'ajoutez et ne modifiez aucune autre valeur ni aucun autre paramètre.

Enregistrez upgradeManagementToolSystem.properties.

Exemple : Paramètres SSL de upgradeManagementToolSystem.properties

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">

<entry key="umt.systemVar.ssl.certDir">/usr/SSLCert</entry>

<entry key="umt.systemVar.ssl.trustedCert">cacert.der</entry>

2012-05-10

Exécution des mises à niveau

<entry key="umt.systemVar.ssl.sslCert">servercert.der</entry>

<entry key="umt.systemVar.ssl.sslKey">server.key</entry>

<entry key="umt.systemVar.ssl.passphrase">passphrase.txt</entry>

</properties>

Rubriques associées

•

Variables

5.1.5.2 Mises à niveau complètes

5.1.5.2.1 Page d'accueil

La page "Bienvenue" permet de spécifier une Mise à niveau complète ou une Mise à niveau

incrémentielle. Vous pouvez également sélectionner la langue que vous désirez utiliser (si d'autres langues sont installées sur le déploiement).

Cliquez sur Suivant pour continuer.

5.1.5.2.2 Page Connexion

La page "Connexion" permet de spécifier un scénario de mise à niveau ainsi que les déploiements source et de destination.

Scénarios de mise à niveau

•

Live vers Live

Exporte le contenu d'un déploiement source vers un déploiement de destination et le met à niveau.

•

BIAR vers Live

Exporte le contenu d'un fichier BIAR vers un déploiement de destination.

L'outil de gestion de mise à niveau permet d'importer un fichier BIAR créé à l'aide de l'Assistant d'importation à partir de la version XI Release 2 ou XI 3.x.

Attention :

Pour convertir vos objets MyInfoView et InfoView antérieurs dans 4.0, n'utilisez pas le scénario de mise à niveau BIAR vers Live, mais le scénario Live vers Live.

•

Live vers BIAR

Exporte le contenu d'un déploiement source vers un fichier BIAR.

29 2012-05-10

Exécution des mises à niveau

Remarque :

Il n'est pas possible d'exporter un fichier BIAR créé à l'aide de l'outil de gestion de mise à niveau

4.0 dans un autre déploiement 4.0. Utilisez la console de gestion du cycle de vie pour promouvoir le contenu entre deux déploiements 4.0.

Attention :

L'utilisation de l'outil de gestion de mise à niveau pour importer des fichiers BIAR générés avec biarengine.jar

n'est pas recommandée. Pour en savoir plus, voir le chapitre “Gestion du cycle de vie” du

Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence et le Guide de l'utilisateur de la

Console de gestion du cycle de vie de la plateforme SAP

BusinessObjects 4.0 de Business Intelligence.

Déploiements source et de destination

• Pour le CMS (Central Management Server) sélectionné, saisissez le nom d'utilisateur et le mot de passe du compte administrateur. Si le CMS s'exécute sur un port autre que le port 6 400, saisissez le nom d'hôte suivi de deux points et d'un numéro de port (par exemple, nom d'hôte:numéro de port).

• Saisissez un chemin et un nom pour le fichier BIAR sélectionné. Vous pouvez également entrer un mot de passe pour protéger votre fichier BIAR et crypter la base de données locale créée durant le processus de mise à niveau.

Remarque :

Le cryptage d'un fichier BIAR peut accroître la durée du processus de mise à niveau et provoquer une diminution des performances.

Cliquez sur Suivant pour continuer.

Après la connexion à un CMS, il est impossible de revenir à cette page. Pour utiliser un déploiement source ou de destination différent, quittez l'outil de gestion de mise à niveau, puis relancez-le.

5.1.5.2.3 Paramètres

La page "Paramètres" permet de saisir des paramètres pour des objets..

Vous pouvez saisir une URL pour une requête du service Web (par exemple, http://localhost:8080/dsw sbobje).

Remarque :

Vous devez avoir le droit de modifier un objet d'application pour modifier ses paramètres.

Cliquez sur Suivant pour continuer.

5.1.5.2.4 Page Résumé

La page "Résumé" répertorie le contenu que l'outil de gestion de mise à niveau exportera vers le déploiement de destination.

Mises à niveau complètes

Révisez la liste, puis cliquez sur Démarrer pour poursuivre.

2012-05-10

Exécution des mises à niveau

Mises à niveau incrémentielles

La liste répertorie les dépendances de vos objets et les autres objets dont ils dépendent. Pour voir les dépendances d'un objet, cliquez deux fois sur celui-ci ou bien sélectionnez-le et cliquez sur <nombre>

objets dépendent de cet objet. La page "Dépendances" affiche le nom, le chemin, le nombre d'instances et le type d'objet de la dépendance.

Il est possible de supprimer un objet en désélectionnant la case à cocher qui se trouve à côté. Pour ajouter d'autres objets à la liste, cliquez sur Retour et sélectionnez les objets dans la page "Sélection de l'objet".

Pour spécifier les options de résolution du conflit de noms ou d'exportation incrémentielle, cliquez sur

Options de mise à niveau.

Passez la liste en revue, puis cliquez sur Démarrer pour continuer.

5.1.5.2.5 Page Exportation

L'onglet "Exportation" contient des informations sur les objets dont la mise à niveau a réussi et sur ceux dont la mise à niveau a échoué.

• L'onglet Infos générales indique le nombre d'objets.

• L'onglet Historique de l'objet contient des informations détaillées sur les objets.

L'outil de gestion de mise à niveau écrit ces informations dans un fichier journal.

5.1.5.3 Mises à niveau complète à partir de la ligne de commande

Vous pouvez effectuer une mise à niveau complète depuis la ligne de commande sous Windows ou

Unix.

Avant d'effectuer une mise à niveau complète à partir de la ligne de commande sous Unix, ajoutez

<BINDIR>

dans le chemin de recherche binaire : export <LIBDIR>=$<LIBDIR>:<BINDIR>

Pour effectuer une mise à niveau complète, exécutez le fichier upgrademanagementtool.jar du répertoire <JARDIR>.

Remarque :

En cas de déploiement sur une plateforme AIX, exécutez la Machine virtuelle Java (JVM, Java Virtual

Machine) de SAP à partir de <AIXJVMDIR>. Pour en savoir plus sur l'utilisation de Sun JVM avec des déploiements exécutés sur d'autres plateformes Unix, voir la section “Variables”.

Incluez les paramètres Java suivants pour allouer une mémoire suffisante et spécifier le chemin vers

<BINDIR>

-Xmx2g -Djava.library.path="<BINDIR>"

2012-05-10

Exécution des mises à niveau

Exemple : Exportation Live vers Live

<AIXJVMDIR>/java -Xmx2g -Djava.library.path="<BINDIR>"

-jar upgrademanagementtool.jar

-mode livetolive

-source mynode1.mycms1:6400

-sourceusername "Administrator"

-sourcepassword "Password1"

-destination mynode2.mycms2:6400

-destinationusername "Administrator"

-destinationpassword "Password2"

-logfile "/usr/logs/myLogFile.csv"

Exemple : Exportation BIAR vers Live

<AIXJVMDIR>/java -Xmx2g -Djava.library.path="<BINDIR>"

-jar upgrademanagementtool.jar

-mode biartolive

-biarfile "/usr/biarfiles/myBiarFile.biar"

-destination mynode2.mycms2:6400

-destinationusername "Administrator"

-destinationpassword "Password1"

-logfile "/usr/logs/myLogFile.csv"

Remarque :

Servez-vous de l'exportation BIAR vers Live si le déploiement source et le déploiement de destination se trouvent sur des réseaux physiques différents ou si vous ne pouvez pas vous connecter aux deux

CMS en même temps.

Rubriques associées

•

Variables

•

Paramètres de ligne de commande

5.1.5.3.1 Création d'un fichier réponse

Un fichier de réponse est un fichier de texte brut contenant les paramètres nécessaires à l'exécution d'une mise à niveau. L'utilisation d'un fichier de réponse est une façon pratique d'exécuter l'outil de gestion de mise à niveau avec plusieurs paramètres personnalisés à partir de la ligne de commande.

Pour en savoir plus, voir la section “Paramètres de ligne de commande”.

Exemple : myResponseFile.txt

mode=livetolive source=mynode1.mycms1:6400 sourceusername="Administrator" sourcepassword="Password1" destination=mynode2.mycms2:6400 destinationusername="Administrator" destinationpassword="Password2" logfile="/usr/logs/myLogFile.csv" configparam:Enter_WebServices_URL="http://myHost:8080/dswsbobje" locale=fr_FR

Pour utiliser un fichier de réponse, exécutez upgrademanagementtool.jar avec le paramètre suivant :

-responsefile "/usr/myResponseFile.txt"

2012-05-10

Exécution des mises à niveau

Rubriques associées

•

Variables

•

Paramètres de ligne de commande

5.1.5.3.2 Paramètres de ligne de commande

Tableau 5-1 : Paramètres obligatoires

Paramètre

-biarfile

-destination

Description Exemple

Nom et chemin du fichier BIAR utilisé comme source ou destination de l'importation

Remarque :

Vous ne pouvez définir ce paramètre que si vous avez indiqué un fichier BIAR comme source ou destination de la mise à niveau.

-biarfile "/usr/biarfiles/myBiar-

File.biar"

Nom d'hôte du CMS (Central Management Server) vers lequel vous exportez le contenu

Remarque :

Si le CMS s'exécute sur un port qui n'est pas celui par défaut, vous devez également spécifier le numéro de port.

-destination mynode2.mycms2:7500

-destinationpassword

Mot de passe du compte administrateur du déploiement de destination

-destinationpassword "Motdepasse1"

-destinationusername

Nom d'utilisateur du compte administrateur du déploiement de destination

-destinationusername "Administrateur"

33 2012-05-10

Exécution des mises à niveau

Paramètre

-mode

-source

-sourcepassword

-sourceusername

Description Exemple

Rappel :

Le paramètre -mode est obligatoire.

Mode d'exportation du contenu.

Valeurs acceptées :

• livetolive

Exporte le contenu d'un CMS

(Central Management Server) vers un autre CMS.

• biartolive

Exporte le contenu d'un fichier

BIAR vers un CMS.

• livetobiar

Exporte le contenu d'un CMS vers un fichier BIAR (Business

Intelligence Archive Resource).

-mode livetolive

Pour en savoir plus, consultez la section “Fichiers BIAR (Business

Intelligence Archive Resource)”.

Nom d'hôte du CMS dont vous exportez le contenu

Remarque :

Si le CMS s'exécute sur un port qui n'est pas celui par défaut, vous devez également spécifier le numéro de port.

-source mynode1.mycms1:6500

Mot de passe du compte administrateur du déploiement source

-sourcepassword "Motdepasse1"

Nom d'utilisateur du compte administrateur du déploiement source

-sourceusername "Administrateur"

34 2012-05-10

Exécution des mises à niveau

Tableau 5-2 : Paramètres facultatifs

Paramètre

-configparam

Description

Permet de saisir des paramètres pour les objets.

Remarque :

Après avoir saisi le paramètre, saisissez deux points (:), le nom d'un objet, le signe égal (=), puis le paramètre de l'objet.

Exemple

-configparam:Enter_WebSer vices_URL="http://localho st:8080/dswsbobje"

-locale

-logfile

-biarpassword

Spécifie les paramètres régionaux de langue pour l'outil de gestion de mise à niveau.

Remarque :

Si la langue souhaitée n'est pas prise en charge, l'outil de gestion de mise à niveau utilise automatiquement l'anglais ou la langue du système.

-locale fr_FR

Crée un fichier journal contenant un enregistrement du processus de mise à niveau.

Protège votre fichier BIAR avec un mot de passe.

Remarque :

Lorsque vous utilisez ce paramètre, -encrypttempstorage est également utilisé.

-logfile "/usr/logs/monFichierJournal.csv"

-biarpassword "p;4s5$W0r,d"

35 2012-05-10

Exécution des mises à niveau

Paramètre

-encrypttempstorage

-responsefile

Description Exemple

Crypte la base de données locale créée au cours du processus de mise à niveau.

Remarque :

Le cryptage d'un fichier BIAR peut accroître la durée du processus de mise à niveau et provoquer une diminution des performances.

Attention :

Ce paramètre ne protège pas votre fichier BIAR avec un mot de passe. Utilisez -biarpassword pour ajouter une protection par mot de passe.

-encrypttempstorage

Utilise un fichier de réponse contenant les paramètres nécessaires

à la réalisation d'une mise à niveau.

-responsefile "/usr/monFichierde-

Réponse.txt"

Rubriques associées

•

Variables

•

Mises à niveau complète à partir de la ligne de commande

•

Création d'un fichier réponse

•

Fichiers BIAR (Business Intelligence Archive Resource)

5.1.5.4 Mises à niveau incrémentielles

5.1.5.4.1 Page d'accueil

La page "Bienvenue" permet de spécifier une Mise à niveau complète ou une Mise à niveau

incrémentielle. Vous pouvez également sélectionner la langue que vous désirez utiliser (si d'autres langues sont installées sur le déploiement).

Cliquez sur Suivant pour continuer.

36 2012-05-10

Exécution des mises à niveau

5.1.5.4.2 Page Connexion

La page "Connexion" permet de spécifier un scénario de mise à niveau ainsi que les déploiements source et de destination.

Scénarios de mise à niveau

•

Live vers Live

Exporte le contenu d'un déploiement source vers un déploiement de destination et le met à niveau.

•

BIAR vers Live

Exporte le contenu d'un fichier BIAR vers un déploiement de destination.

L'outil de gestion de mise à niveau permet d'importer un fichier BIAR créé à l'aide de l'Assistant d'importation à partir de la version XI Release 2 ou XI 3.x.

Attention :

Pour convertir vos objets MyInfoView et InfoView antérieurs dans 4.0, n'utilisez pas le scénario de mise à niveau BIAR vers Live, mais le scénario Live vers Live.

•

Live vers BIAR

Exporte le contenu d'un déploiement source vers un fichier BIAR.

Remarque :

Il n'est pas possible d'exporter un fichier BIAR créé à l'aide de l'outil de gestion de mise à niveau

4.0 dans un autre déploiement 4.0. Utilisez la console de gestion du cycle de vie pour promouvoir le contenu entre deux déploiements 4.0.

Attention :

L'utilisation de l'outil de gestion de mise à niveau pour importer des fichiers BIAR générés avec biarengine.jar

n'est pas recommandée. Pour en savoir plus, voir le chapitre “Gestion du cycle de vie” du

Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence et le Guide de l'utilisateur de la

Console de gestion du cycle de vie de la plateforme SAP

BusinessObjects 4.0 de Business Intelligence.

Déploiements source et de destination

Remarque :

Le cryptage d'un fichier BIAR peut accroître la durée du processus de mise à niveau et provoquer une diminution des performances.

Cliquez sur Suivant pour continuer.

2012-05-10

Exécution des mises à niveau

5.1.5.4.3 Sélection de l'objet

La page "Sélection de l'objet" permet de sélectionner des paramètres d'instance d'objet, le contenu à exporter à partir du déploiement source et les dépendances des objets spécifiques.

Paramètres d'instance d'objet

Cliquez sur Options et sélectionnez une des options suivantes :

•

Exporter toutes les instances d'un objet si celui-ci est sélectionné pour l'exportation de ses dépendances.

•

Ne pas exporter les instances d'objet.

Cliquez sur OK pour fermer la boîte de dialogue "Options".

Objets et dépendances

Vous pouvez exporter un objet avec ses dépendances. Vous pouvez également exporter un objet dont dépendent d'autres objets.

Cliquez sur un objet pour sélectionner l'une des options suivantes :

•

Exporter l'objet et ses dépendances

Inclut les univers, les connexions d'univers et les instances d'objet.

•

Exporter l'objet

N'exporte pas les dépendances.

•

Exporter l'objet seulement s'il est dépendant

Pour appliquer les mêmes paramètres à plusieurs objets, sélectionnez Appliquer aux objets

sélectionnés.

Cliquez sur Suivant pour continuer.

5.1.5.4.4 Paramètres

La page "Paramètres" permet de saisir des paramètres pour des objets..

Vous pouvez saisir une URL pour une requête du service Web (par exemple, http://localhost:8080/dsw sbobje).

Remarque :

Vous devez avoir le droit de modifier un objet d'application pour modifier ses paramètres.

Cliquez sur Suivant pour continuer.

38 2012-05-10

Exécution des mises à niveau

5.1.5.4.5 Page Résumé

La page "Résumé" répertorie le contenu que l'outil de gestion de mise à niveau exportera vers le déploiement de destination.

Mises à niveau complètes

Révisez la liste, puis cliquez sur Démarrer pour poursuivre.

Mises à niveau incrémentielles

objets dépendent de cet objet. La page "Dépendances" affiche le nom, le chemin, le nombre d'instances et le type d'objet de la dépendance.

Pour spécifier les options de résolution du conflit de noms ou d'exportation incrémentielle, cliquez sur

Options de mise à niveau.

Passez la liste en revue, puis cliquez sur Démarrer pour continuer.

Options de mise à niveau

Cette boîte de dialogue permet de spécifier les options de résolution du conflit de noms et d'exportation incrémentielle pour le processus de mise à niveau.

Résolution du conflit de noms

Sélectionnez une action pour deux objets du même type ayant les mêmes nom et emplacement :

• [Par défaut] Renommer l'objet pour éviter un conflit de noms

Ajoute un numéro à la fin du nom de fichier d'un objet lors de son exportation.

•

Ne pas exporter l'objet

Remarque :

Les options de mise à niveau sélectionnées s'appliquent à tous les objets lors de la mise à niveau.

Pour exporter plusieurs objets avec des options différentes, vous devez effectuer des mises à niveau incrémentielles séparées.

Options d'exportation incrémentielle

•

Ecraser le contenu de l'objet