Manuel d'installation › Procédure de mise à niveau de CA Business Service Insight

Procédure de mise à niveau de CA Business Service Insight

En tant qu'administrateur système, il est important d'effectuer une mise à jour régulière de CA Business Service Insight. La mise à niveau permet de tirer profit de toutes les nouvelles fonctionnalités et des correctifs de bogue.

Le fichier de mise à niveau détecte le serveur exécutant le programme et met à jour les fichiers nécessaires. Mettez d'abord à niveau le serveur d'applications qui contient le service d'alertes. Le script de migration s'exécute automatiquement sur le serveur d'applications qui inclut le service d'alertes.

Pour effectuer une mise à niveau vers un environnement multiserveur, exécutez d'abord le processus de mise à niveau sur le serveur d'applications. Puis, effectuez la mise à niveau sur le serveur Web. La mise à niveau sur le serveur d'applications effectue automatiquement la migration de la base de données.

Le scénario suivant vous orientera dans le processus :

Le diagramme suivant illustre le processus de mise à niveau de CA Business Service Insight.

Vérification des conditions préalables

Pour vérifier que la mise à niveau est réalisable, vérifiez la configuration requise suivante :

CA Business Service Insight version 7.0 SP1 ou ultérieure doit être installé.
Vous devez disposer de droits d'accès SYSDBA.
La base de données doit disposer d'au moins 15 % d'espace libre pour chaque espace disque logique.
Remarque : Si autoextend est activé, la valeur de datafile maxsize (taille maximum du fichier de données) doit être définie sur une taille au moins 15 % supérieure à la taille actuelle du fichier de données.
L'espace non alloué sur chaque unité physique contenant les espaces disque logiques de la base de données doit correspondre à au moins 15 % de la taille totale de l'ensemble des espaces disque logiques de l'unité.
Le fournisseur Oracle OLEDB doit être installé sur le serveur d'applications et sur les serveurs Web.

Sauvegarde de fichiers et de dossiers

Pour veiller à ne perdre aucune information lors d'une mise à niveau, sauvegardez les fichiers et les dossiers suivants.

Remarque : Pour effectuer une annulation, vous devez désinstaller toutes les versions du produit, puis installer la dernière version et importer les données sauvegardées.

Procédez comme suit:

Créez une image mémoire de la base de données.
Sauvegardez tous les fichiers personnalisés. Les fichiers suivants sont personnalisables :
- LoginCommon.asp
- RedirectToLogin.asp
- SilentLogin.asp
- AcceptLogin.asp
- Web.config
- Registry.xml
- Index.asp (pour l'authentification unique)
- logo.jpg
- logo.gif
- logobg.gif
- logout1.gif
- logout2.gif
- Reportlogo (et autres logos, tels quel l'exportation de rapports ou de tableaux de bord)
(Facultatif) Sauvegardez le package linguistique.

Préparation de la mise à niveau

Pour assurer une exécution correcte de la mise à niveau, effectuez les tâches suivantes avant de lancer la mise à niveau.

Procédez comme suit:

Si vous utilisez un paramètre linguistique régional autre que l'anglais, modifiez-le et appliquez la langue Anglais (Etats-Unis).
Remarque : L'utilisation d'un paramètre linguistique différent peut entraîner des erreurs lors de la mise à niveau.
Arrêtez tous les services Oblicore.
Dans le gestionnaire IIS, arrêtez le serveur Web.
Important : N'arrêtez pas le service WWW ni le service d'administration IIS.
Lancez le service Distributed Transaction Coordinator.
Important : Le service DTC (Distributed Transaction Coordinator) est requis uniquement pour les mises à niveau.
Exécutez le fichier oblicore_privs.sql. Le script est disponible sur le CD d'installation dans le dossier SetupDB\Migration.
Vérifiez que le paramètre job_queue_processes est défini sur 2 dans le fichier Init.ora.

Vérification de la présence du site Web

Pour assurer le fonctionnement correct du site Web, vérifiez sa présence sur le serveur. Choisissez l'option qui s'applique à la topologie de votre serveur.

Procédez comme suit:

Le serveur est désigné exclusivement comme serveur d'applications :

Ouvrez le registre du serveur d'applications et recherchez l'entrée : HKEY_LOCAL_MACHINE\SOFTWARE\Oblicore\Install Data.
Le cas échéant, supprimez la valeur de chaîne WWWRootFolderLocation.

Le serveur n'est pas désigné exclusivement comme serveur d'applications :

Ouvrez le registre du serveur de services Web et cherchez l'entrée : HKEY_LOCAL_MACHINE\SOFTWARE\Oblicore\Install Data.
Vérifiez que la valeur de chaîne WWWRootFolderLocation existe.
Vérifiez que les données de valeur de cette chaîne contiennent le chemin d'accès au dossier Web.

Remarque : Sur des systèmes 64 bits, l'entrée est la suivante : HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432node\Oblicore\Install Data.

Mise à niveau de CA Business Service Insight

Pour accéder aux nouvelles fonctionnalités de CA Business Service Insight, effectuez une mise à niveau vers la dernière version.

Procédez comme suit:

Double-cliquez sur le fichier Cloud_Insight_Server_8.2.5.exe dans le dossier Server et cliquez sur Suivant.
Sélectionnez la langue pour l'installation et cliquez sur OK.
Cliquez sur Installer.
Cliquez sur Suivant dans l'assistant d'installation.
Acceptez le contrat de licence et cliquez sur Suivant.
Spécifiez l'emplacement du CD tiers et cliquez sur Suivant.
(Facultatif) Sélectionnez l'option de nettoyage et cliquez sur Suivant lorsque le programme d'installation vous invite à nettoyer les composants JBoss précédents.
Remarque : Cette invite s'affiche uniquement si une version antérieure de JBoss est installée.

La fenêtre de mise à niveau s'ouvre et contient les boîtes de dialogue de mise à niveau.
Saisissez la valeur de chaque paramètre dans chacune des boîtes de dialogue qui s'ouvrent, puis cliquez sur Suivant.
Remarque : Pour plus d'informations, reportez-vous à la section Boîtes de dialogue de mise à niveau.
Vérifiez que les paramètres sont corrects, puis cliquez sur Suivant.
Le processus d'installation commence.

Si vous avez sélectionné l'option Exécuter le script de migration, suivez les instructions.
Pour confirmer la mise à niveau, cliquez sur Terminer.
Le système redémarre.

Boîtes de dialogue de mise à niveau

L'assistant d'installation inclut des boîtes de dialogue utilisées par CA Business Service Insight pour mettre à jour des informations. Seules les boîtes de dialogue associées aux fonctionnalités sélectionnées s'ouvrent.

La table suivante répertorie les boîtes de dialogue de mise à niveau et les paramètres et valeurs associés :

Important : N'utilisez pas de caractères codés sur deux octets pour les entrées marquées d'un double obèle (‡).

Remarque : L'utilisation de certains caractères n'est pas prise en charge par la convention d'attribution de noms d'Oracle. Pour plus d'informations sur la configuration requise (ASCII, par exemple) et les restrictions (telles que des caractères spéciaux et les caractères codés sur deux octets), consultez la documentation d'Oracle.

Nom de la boîte de dialogue	Paramètres	Valeurs	Notes
Création de base de données	Exécuter le script de migration	Sélectionné ou désélectionné	Sélectionné automatiquement sur le serveur d'applications exécutant le service d'alertes de CA Business Service Insight.
	Nom TNS de l'instance de base de données Oblicore	Saisissez le nom TNS tel qu'il apparaît dans le fichier TNSNAMES.ORA. ‡	Nom TNS de l'instance de base de données CA Business Service Insight
	Nom de l'utilisateur de schéma	Saisissez le nom de l'utilisateur de schéma pour la mise à niveau.
	Mot de passe de schéma	Saisissez le mot de passe de l'utilisateur de schéma pour la mise à niveau.	Valeur par défaut : Oblicore
	Mot de passe système	Saisissez le mot de passe d'utilisateur système.
Informations de connexion	Nom de l'utilisateur	Nom de l'utilisateur ‡	Valeur par défaut : compte d'utilisateur utilisé pour l'installation Remarque : Il est recommandé de modifier l'utilisateur et le mot de passe d'un compte de domaine dédié.
	Mot de passe	Mot de passe de l'utilisateur ‡
	Bouton Informations sur le nouvel utilisateur	Voir la ligne Informations sur le nouvel utilisateur
Informations sur le nouvel utilisateur	Domaine ou serveur	Nom du serveur local
	Groupe	Administrateurs
	Nom de l'utilisateur	Nom de l'utilisateur
	Mot de passe	Mot de passe de l'utilisateur	Conforme à la politique de la société.
	Confirmer le mot de passe	Confirmation du mot de passe

La table suivante décrit les fichiers de configuration et les paramètres associés.

Important : N'affectez pas de caractères codés sur deux octets aux entrées dans le tableau de configuration ci-dessous.

Remarque : Les valeurs saisies pour les paramètres suivis d'un astérisque doivent commencer par une apostrophe simple et se terminer par une barre oblique inverse et une apostrophe simple (par exemple, 'C:\Temp\').

Fichier de configuration	Paramètres	Valeurs par défaut	Remarques
Config_Ini.ini	ORGANIZATION_NAME	Nom de l'organisation	Si le nom de votre organisation contient des caractères spéciaux (par exemple, &), ajoutez le caractère ^ devant chacun d'eux (par exemple, AB&C doit être saisi comme AB^&C).
	TEMPLATE_PATH*	'<répertoire_installation>\Export Templates\'	Emplacement du dossier des modèles d'exportation.
	BOOKLET_TEMPLATE_PATH*	'<répertoire_installation>\Booklet Templates\'	Emplacement du dossier des modèles de livret.
	WEB_SERVER	Nom du serveur Web
	DB_NAME
	OBLICORE_USER
	OBLICORE_PASS	Oblicore	Mot de passe de l'utilisateur CA Business Service Insight dans la base de données.
	MPX_CONFIGURATION_DIRECTORY*	'<répertoire_installation>\Packages\Configuration\'	Emplacement du dossier de configuration des packages.
	MPX_INPUT_DIRECTORY*	'<répertoire_installation>\Packages\'	Emplacement du dossier d'entrée des packages.
	MPX_LOG_DIRECTORY*	'<répertoire_installation>\Packages\Log\'	Emplacement du dossier du journal des packages.
	MPX_OUTPUT_DIRECTORY*	'<répertoire_installation>\Packages\'	Emplacement du dossier de sortie des packages.
	MPX_TEMP_DIRECTORY*	'<répertoire_installation>\Packages\Temp\'	Emplacement du dossier temporaire des packages.

Finalisation de la mise à niveau

Pour finaliser la mise à niveau, effectuez les tâches suivantes.

Important : Connectez-vous en tant que sadmin après la mise à niveau de CA Business Service Insight. Le mot de passe par défaut est sadmin.

Procédez comme suit:

Redémarrez tous les serveurs.
Dans le gestionnaire IIS, démarrez le serveur Web.
(Facultatif) Pour remplacer un synonyme public par un synonyme privé, appelez l'une des procédures suivantes dans la base de données :
```
begin
prc_recreate_all_synonyms ('YES');
end
```
ou
```
exec prc_recreate_all_synonyms ('YES');
```
(Facultatif) Verrouillez le compte oblidbadmin dans la base de données. Une fois connecté à la base de données, exécutez la commande suivante :
```
alter user oblidbadmin account lock;
```
(Facultatif) Modifiez le mot de passe du compte oblidbadmin. Une fois connecté à la base de données, exécutez la commande suivante :
```
alter user oblidbadmin identified by ‘<nouveau_mot_passe>’;
```
Vérifiez que le décalage horaire correspond au fuseau horaire sélectionné.
Vérifiez que les dates pour l'heure d'été correspondent à votre emplacement.
La dernière version de CA Business Service Insight est désormais installée.

Mise à jour de la chaîne de proxy

Un proxy inverse envoie des demandes de support au site Web. Les demandes placent la chaîne de préfixe dans la valeur ProxyPrefix et la clé dans la section AppSettings du fichier web.config. Cette chaîne de préfixe est configurée pour acheminer la requête vers le site Web de la configuration de proxy. Pour utiliser un proxy inverse, mettez à jour la chaîne de proxy.

Procédez comme suit:

Vérifiez que le site Web est correctement routé vers le proxy inverse. Vérifiez que la valeur du proxy est correctement orthographiée et qu'elle apparaît entre deux barres obliques (/prefix/).
Par exemple, si le préfixe mappé vers le site Web est "ca", le fichier web.config est mis à jour comme suit :
```
<appSettings>
<add key="ProxyPrefix" value="/ca/" />
</appSettings>
```
Si la clé ProxyPrefix n'existe pas ou si sa valeur est une chaîne vide, le site Web fonctionne en mode normal.
Ajoutez un en-tête à la configuration de proxy. La clé d'en-tête doit se présenter comme suit : "X-Forwarded-CA-Oblicore-Proxy".
Par exemple, si l'URL d'accès du proxy d'application Web Oblicore est http://proxy/ca/ (c'est-à-dire si ca est le préfixe), le fichier web.config sera mis à jour comme suit :
```
<appSettings>
<add key="ProxyPrefix" value="/ca/" />
</appSettings>
```
Outre cette mise à jour, un nouvel en-tête est ajouté au fichier de configuration d'application Web de proxy avec le nom de clé suivant : X-Forwarded-CA-Oblicore-Proxy.

Mise à jour de l'API

Pour utiliser le code d'API de versions antérieures pour la version 8.1, mettez à jour l'interface d'API.

Remarque : Pour plus d'informations, reportez-vous à la rubrique API Backwards Compatibility (Rétrocompatibilité de l'API) du Manuel SDK de CA Business Service Insight.

Procédez comme suit:

Utilisez le langage WSDL de 8.2.5 pour créer des classes de proxy pour le service de contrat, le service de portefeuille et le service de référentiel. Utilisez le langage WSDL de la dernière installation pour des versions antérieures à 8.0.
Recompilez votre code API.
Remarque : En cas d'erreurs de compilation, recherchez le code nécessitant des modifications manuelles. Mettez à jour le code en fonction des modifications apportées au nouvel API (ordre des champs, type). Une fois ces changements appliqués, recompilez votre code API.