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
1.
Sélectionnez un scénario de mise à niveau.
2.
Spécifiez les déploiements source et de destination.
3.
(Facultatif) Spécifiez les paramètres des objets.
4.
Effectuez la mise à niveau.
Mises à niveau incrémentielles
1.
Sélectionnez un scénario de mise à niveau.
2.
Spécifiez les déploiements source et de destination.
3.
Sélectionnez les objets à mettre à niveau.
4.
(Facultatif) Spécifiez les paramètres des objets.
5.
Spécifiez les dépendances des objets.
6.
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
28
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.
1.
Ouvrez upgradeManagementToolSystem.properties dans un éditeur de texte.
2.
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.
3.
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">
<properties>
<entry key="umt.systemVar.ssl.businessobjects.orb.oci.protocol"> ssl</entry>
<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
30
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
31
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
32
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
37
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
• 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.
2012-05-10
Exécution des mises à niveau
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.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
39
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
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.
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
Ecrase les objets du déploiement de destination par les objets du déploiement source en cas de correspondance entre leurs CUID.
•
Remplacer le niveau de sécurité de l'objet
Remplace les droits de sécurité existants sur le déploiement de destination par ceux du déploiement source en cas de correspondance entre leur CUID.
2012-05-10
