Démarrer le processus de déploiement

Le déploiement de l'observabilité et de la surveillance de la pile de gestion pour les applications PeopleSoft nécessite trois étapes principales :

Configurez les licences pour l'édition Standard ou Enterprise de votre choix, ainsi que pour toutes les ressources ou tous les compartiments utilisés dans votre déploiement.
Découvrez et promouvez les ressources utilisées dans votre déploiement.
Utilisez l'interface de ligne de commande OCI pour repérer de nouvelles ressources, créer les associations requises entre les ressources Stack Monitoring ou actualiser l'ensemble de la topologie.

Configurer les licences

Stack Monitoring propose deux éditions : Standard et Enterprise. L'édition Standard surveille les applications sur site et déployées dans le cloud et les piles technologiques, y compris WebLogic, Tomcat, Oracle Database et les hôtes. Enterprise Edition ajoute des fonctionnalités avancées telles que les extensions de mesure, les lignes de base de performances, la détection des anomalies et l'intégration des ressources OCI pour une surveillance améliorée.

En plus de ces deux éditions, les licences doivent être configurées au niveau de la ressource individuelle ou au niveau du compartiment, comme décrit ci-dessous.

Remarques :

Les étapes d'attribution de licences à l'un ou l'autre niveau dépassent le cadre de ce guide. Vous pouvez accéder aux procédures pertinentes requises pour chaque niveau d'affectation, identifiées dans la section spécifique ci-dessous, à partir de "Explorer plus", ailleurs dans ce manuel.

Configuration des licences pour les fonctionnalités propres aux compartiments

Vous pouvez définir l'affectation automatique de licence de ressource sur Entreprise ou Standard pour toutes les ressources nouvellement repérées ou promues dans un compartiment. La configuration de l'affectation automatique des licences est un moyen pratique d'affecter automatiquement une licence au lieu de l'appliquer par instance de ressource. En outre, vous pouvez activer ou désactiver l'extensibilité Enterprise pour l'ensemble d'un compartiment.

Les procédures de configuration des licences pour les fonctionnalités propres aux compartiments sont décrites dans la section "Affectation de licences" de la documentation Oracle Cloud Infrastructure, à laquelle vous pouvez accéder à partir de "En savoir plus".

Configuration des licences pour les fonctionnalités propres aux ressources

L'affectation de licence de ressource peut être effectuée au niveau de chaque ressource lors du repérage ou après le repérage à l'aide de l'interface utilisateur de gestion des licences. Les modifications de licence appliquées à un composite s'appliquent à tous les enfants. Ainsi, lors de l'application de la licence Enterprise Edition à un domaine WebLogic, tous les serveurs WebLogic associés au domaine recevront également l'édition Enterprise Edition.

Lors du repérage, vous pouvez affecter une licence à la ressource en sélectionnant le bouton radio correspondant. Vous pouvez également modifier une licence de ressource après qu'une ressource a été repérée à l'aide de l'interface utilisateur Licence. Ces procédures sont décrites dans la section "Affectation de licences" de la documentation Oracle Cloud Infrastructure, accessible à partir de la section "En savoir plus".

Découvrez et promouvez des ressources pour PeopleSoft

Pour surveiller les ressources à l'aide de Stack Monitoring, vous devez d'abord repérer et promouvoir ces ressources. La promotion préremplit les informations relatives à la ressource. Vous devez valider ces informations pour vous assurer qu'elles sont correctes. Les prérequis et les paramètres d'entrée pour la promotion sont les mêmes que pour le repérage initié par l'utilisateur.

Le repérage PeopleSoft implique trois familles de ressources obligatoires : le domaine du serveur d'applications, le domaine de l'ordonnanceur de traitements et l'architecture Internet (PIA) PeopleSoft avec ses domaines Weblogic sous-jacents. Chaque famille de ressources peut inclure une ou plusieurs de ces ressources, qui peuvent s'étendre sur plusieurs serveurs.

Pour repérer et promouvoir des ressources pour les applications PeopleSoft, vous devez effectuer les opérations suivantes :

Repérez la base de données PeopleSoft.
Etablissez des privilèges d'octroi de base de données pour la surveillance PeopleSoft.
Activez PeopleSoft Performance Monitor pour Pure Internet Architecture (PIA).
Respectez les prérequis pour le serveur d'applications et les domaines de l'Ordonnanceur de traitements.
Identifiez les domaines à repérer.
Ajoutez des domaines manuellement.
Activez le repérage Elasticsearch.
Activez le repérage du moniteur de processus.

Remarques :

Les étapes de découverte et de promotion des ressources dépassent le cadre de ce guide. Vous pouvez accéder aux procédures pertinentes requises pour chaque niveau d'affectation, identifiées dans la section spécifique ci-dessous, à partir de "Explorer plus", ailleurs dans ce manuel.

Repérer la base de données PeopleSoft

Vous devez repérer l'instance Oracle Database contenant le schéma PeopleSoft avant de repérer l'application PeopleSoft.

En repérant d'abord la base de données, elle est automatiquement associée à l'application PeopleSoft une fois le repérage des ressources PeopleSoft terminé. Si vous effectuez le repérage d'application PeopleSoft avant le repérage de la base de données, vous devez créer l'association manuellement. Pour plus d'informations, reportez-vous à Topologie d'application. Pour découvrir la base de données Oracle, reportez-vous à "Oracle Database", à laquelle vous pouvez accéder à partir de "Explorer plus", ailleurs dans ce guide.

Etablir des privilèges d'octroi de base de données pour la surveillance PeopleSoft

Pour surveiller PeopleSoft, vous devez disposer de privilèges spécifiques pour accéder au schéma de base de données PeopleSoft. La configuration varie en fonction du type de base de données (base de données non Conteneur, base de données Conteneur et base de données pluggable) utilisé en tant que banque de données PeopleSoft.

Lors du repérage de la surveillance de pile PeopleSoft, vous pouvez utiliser le propriétaire du schéma PeopleSoft, généralement SYSADM, comme informations d'identification de base de données. Vous devez créer un utilisateur de surveillance disposant uniquement des privilèges nécessaires pour surveiller une application PeopleSoft. Utilisez le même utilisateur de base de données pour surveiller à la fois la base de données Oracle contenant le schéma PeopleSoft et l'application PeopleSoft.

Pour créer un utilisateur de surveillance de base de données, reportez-vous à la note MOS 2857604.1. Pour plus d'informations, reportez-vous également à "Privilèges d'octroi de base de données pour la surveillance PeopleSoft" dans la documentation OCI. Vous pouvez accéder à ces deux documents à partir de "Explorer plus", ailleurs dans ce manuel.

Activation de PeopleSoft Performance Monitor pour Pure Internet Architecture (PIA)

Cette procédure est facultative et n'est requise que pour le repérage et l'actualisation de PeopleSoft. Toutefois, pour la surveillance régulière et la collecte de mesures, l'agent Performance Monitor PeopleSoft n'est pas nécessaire. Si vous avez choisi de ne pas activer l'agent PPM pour une raison quelconque, utilisez l'une des options suivantes :

Activez l'agent PPM jusqu'à ce que le repérage ou l'actualisation soit terminé, puis désactivez-le et redémarrez les domaines.
INSERER/supprimer manuellement toutes les informations de domaine PeopleSoft. Cela élimine la nécessité d'activer l'activation de l'agent PPM.

Si vous devez activer le PPM pour PIA, procédez comme suit :

Accédez à PeopleTools, accédez à Profil Web, cliquez sur Configuration de profil Web et recherchez le profil en cours d'utilisation (par exemple, PROD).
Si cette case n'est pas déjà cochée, sélectionnez Activer l'agent PPM.
Redémarrez tous les domaines PIA.

Respect des prérequis pour les domaines Application Server et Process Scheduler

Vous devez ensuite respecter les prérequis pour chaque serveur d'applications et domaine de l'Ordonnanceur de traitements. Le repérage PeopleSoft suppose que l'ID utilisateur/le mot de passe d'administration distante pour l'accès JMX sont identiques pour tous les domaines de serveur d'applications, ainsi que pour tous les domaines de l'ordonnanceur de traitements.

Les prérequis à remplir sont les suivants :

Activez l'agent Performance Monitor PeopleSoft.
Activez les agents JMX.
Activez la propriété Performance Collator.

Les rubriques suivantes présentent les principales étapes à suivre pour effectuer ces tâches. Pour obtenir des procédures détaillées, reportez-vous à Prérequis pour les domaines Application Server et Process Scheduler dans la documentation OCI de Stack Monitoring, à laquelle vous pouvez accéder à partir de "Explorer plus", ailleurs dans ce manuel.

Activation de l'agent Performance Monitor PeopleSoft

Pour activer l'agent Performance Monitor PeopleSoft, procédez comme suit :

Ouvrez les fichiers de configuration de domaine en mode modification. Dans l'interface de ligne de commande PSADMIN, sélectionnez Serveur d'applications (option 1) ou Process Scheduler (option 2), Administrer un domaine (option 1), Sélectionner un domaine, Menu Modifier les fichiers de configuration/journaux (option 6), puis Modifier le fichier de configuration du domaine (option 1).
Sous la section PSTOOLS, vérifiez la valeur de l'agent EnablePPM.
Activez les agents PPM, définissez la valeur sur 1 et enregistrez le fichier.

Activer les agents JMX

Ce prérequis permet à Stack Monitoring de collecter des données de disponibilité et de performances pour une application PeopleSoft. Voici les étapes de haut niveau à suivre :

Ouvrez les fichiers de configuration de domaine en mode édition à partir de l'interface de ligne de commande PSADMIN. Sélectionnez Serveur d'applications (option 1) ou Process Scheduler (option 2), Administrer un domaine (option 1), sélectionner un domaine, Menu Modifier les fichiers de configuration/journaux (option 6), puis Modifier le fichier de configuration du domaine (option 1).
Localisez les paramètres de la section PSTOOLS et procédez comme suit :
1. Assurez-vous que le port d'administration à distance que vous prévoyez d'utiliser n'est utilisé par aucun autre processus sur l'hôte.
2. Définissez l'ID utilisateur au format texte. Utilisez les mêmes ID utilisateur et mot de passe pour tous les domaines du serveur d'applications et les domaines de l'Ordonnanceur de traitements.
3. Chiffrez les mots de passe à l'aide de l'utilitaire PSCipher.
4. Après avoir configuré la modification de la propriété du sélecteur de performances (comme décrit dans la rubrique suivante), redémarrez le serveur d'applications et les domaines de l'Ordonnanceur de traitements.
Définissez les valeurs de port d'administration à distance et de port RMI.
- Si vous utilisez PeopleSoft version 8.59 et antérieure, vous devez uniquement définir le port d'administration à distance. La valeur du port RMI est définie automatiquement, en incrémentant la valeur du port d'administration à distance d'une unité.
- Pour PSFT version 8.60 à partir, le port RMI est contrôlé par un paramètre supplémentaire dans le fichier de configuration. Assurez-vous que la valeur est définie explicitement. Redémarrez le serveur d'applications et les domaines Process Scheduler après avoir configuré la propriété Performance Collator.
Assurez-vous que les paramètres que vous avez enregistrés apparaissent correctement dans le fichier de configuration.

Pour obtenir des instructions plus détaillées, reportez-vous à "Activer les agents JMX" dans la documentation OCI, à laquelle vous pouvez accéder à partir de "Explorer plus", ailleurs dans ce manuel.

Activer la propriété de collateur de performances

Avant d'activer la propriété Performance Collator, vérifiez la valeur actuelle de Performance Collator dans les fichiers de modèle de domaine psprcsrv.ubx (Ordonnanceur de traitements) et psappsrv.ubx (Serveur d'applications) situés sous $PS_CFG_HOME.

Si le sélecteur de performances est activé, l'entrée suivante s'affiche :

{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [y]:

Si le sélecteur de performances est désactivé, l'entrée suivante s'affiche :

{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [n]:

Si le collecteur de performances est déjà activé et que des modifications ont été implémentées sur les valeurs d'agent EnablePPM ou JMX, vous pouvez redémarrer tous les domaines. Si le sélecteur de performances n'est pas encore activé, procédez comme suit :

Dans l'interface de ligne de commande PSADMIN, sélectionnez Application Server (Option 1) ou Process Scheduler (Option 2), puis Administer a domain (Option 1), puis select domain et Configure this domain (Option 4) .
Entrez y pour la question Do you want to continue (y/n). Cette option arrête le domaine.
Vérifiez la valeur de la propriété Performance Collator.
- Si la valeur est définie sur Oui, le Collateur est déjà activé et aucune action n'est requise.
```
Load config as shown
```
  Vous pouvez sélectionner l'option 14 pour le serveur d'applications ou l'option 7 pour Process Scheduler.
- Si vous définissez la valeur sur Non, entrez l'option 10 pour le serveur d'applications ou l'option 3 pour Process Scheduler pour activer/désactiver la valeur Oui.
Après avoir vérifié que le sélecteur de performances est défini sur Oui, sélectionnez Load config as shown (option 14 pour le planificateur d'applications ou option 7 pour Process Scheduler).
Enfin, sélectionnez Boot this domain Option 1 pour démarrer le domaine.

Identifier les domaines à repérer

Stack Monitoring tire parti des informations stockées dans Oracle Database pour identifier les domaines à repérer ou à actualiser.

Pour valider la liste des domaines en cours, utilisez la requête suivante :

SELECT * FROM PSPMAGENT;

Avant de repérer ou d'actualiser l'application PeopleSoft, vous devez enlever tous les domaines renvoyés par la requête qui n'existent plus.

Remarques :

Si vous devez ajouter un domaine qui n'est pas répertorié, reportez-vous à la rubrique suivante, "Ajout de domaines manuellement".

Pour supprimer les domaines obsolètes, connectez-vous en tant qu'utilisateur SYSADM ou équivalent et exécutez la requête SQL suivante. Répétez la requête jusqu'à ce que vous ayez supprimé tous les domaines obsolètes. Attention à ces considérations :

Sauvegardez la table PSPMAGENT avant d'apporter des modifications.
```
create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT; 
```
où DATE avec l'horodatage en cours
Vérifiez que la table de sauvegarde que vous avez créée a le même contenu que la table parent.
```
select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
```

Si le nombre de lignes de PSPMAGENT correspond à PSPMAGENT_BKP_DATE, continuez à enlever les domaines obsolètes :

delete from PSPMAGENT WHERE PM_AGENTID='&enter_agent_id_of_stale_domain'; 
Commit;

Ajouter des domaines manuellement

Vérifiez ensuite si tous les domaines valides sont visibles à partir du tableau PSPMAGENT. Si des domaines valides ne s'affichent pas, utilisez les requêtes des rubriques suivantes. L'hôte de l'agent doit pouvoir atteindre tous les autres hôtes à l'aide du nom d'hôte à partir de la colonne PM_HOST_PORT stockée dans la table PSPMAGENT.

Les domaines que vous devez ajouter manuellement sont les suivants :

Domaine Process Scheduler
Domaine de serveur d'applications
Serveur PIA

Avant de continuer, procédez comme suit pour sauvegarder la table PSPMAGENT :

Avant d'apporter des modifications, connectez-vous en tant qu'administrateur système ou utilisateur équivalent et sauvegardez le tableau :
```
create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT;
```
où DATE est l'horodatage en cours.
Vérifiez que la table de sauvegarde que vous avez créée a le même contenu que la table parent. Le nombre de lignes de PSPMAGENT doit correspondre au nombre de lignes de PSPMAGENT_BKP_DATE :
```
select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
```
où DATE est l'horodatage en cours.

Pour ajouter les domaines, utilisez les commandes suivantes :

Domaine Process Scheduler

INSERT INTO  PSPMAGENT values
('&AGENT_ID','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&DOMAIN_DIR','Y','&HOST_PORT:','1','1','N');

Domaine de serveur d'applications

INSERT INTO  PSPMAGENT values
('&unique_agent_id','&JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','01','&DOMAIN_DIR','Y','&host_name:&jolt_port','1','1','N');

Serveur PIA

INSERT INTO  PSPMAGENT values
('&unique_agent_id','-1','WEBRESOURCE','&DOMAIN_NAME','02','&DOMAIN_DIR','Y','&host_name:&http_port:&https_port','1','1','N');

Activer le repérage Elasticsearch

Le repérage d'Elasticsearch est facultatif. Si Elasticsearch est déjà intégré, vous pouvez l'inclure dans le repérage initial. Pour intégrer Elasticsearch à l'avenir, utilisez la commande refresh de l'interface de ligne de commande PeopleSoft et ajoutez les autorisations de base de données Elasticsearch à l'utilisateur de surveillance. Pour plus d'informations sur les autorisations, reportez-vous à la section "Etablir des privilèges d'octroi de base de données pour la surveillance PeopleSoft" ci-dessus. Pour plus d'informations sur les commandes d'actualisation de l'interface de ligne de commande, reportez-vous à la section "Actualiser les instances PeopleSoft", ailleurs dans ce manuel.

La réalisation de ces prérequis activera l'intégration Elasticsearch dans PeopleSoft :

Stack Monitoring prend uniquement en charge la surveillance d'Elasticsearch configurée avec SSL. Son point de terminaison doit être HTTPS. Pour plus d'informations sur la configuration d'Elasticsearch, voir "Configuration de SSL entre PeopleSoft et Elasticsearch", auquel vous pouvez accéder à partir de "Explorer plus", ailleurs dans ce manuel.
Avant de découvrir Elasticsearch, créez un truststore JKS (JKS est le seul truststore pris en charge) sur l'hôte de l'agent de surveillance pour stocker le certificat d'Elasticsearch. L'emplacement et le mot de passe de ce truststore sont des paramètres requis dans l'interface utilisateur de repérage ou dans le fichier JSON de repérage lors de la tentative de repérage via l'interface de ligne de commande. En outre, l'emplacement du truststore doit être accessible sur l'hôte de l'agent.
Exemple :
```
keytool -keystore truststore.jks -alias ALIAS -import -file ELASTICSEARCH_CERTIFICATE
```

Activer le repérage du contrôleur de processus

La surveillance de processus est repérée avec PeopleSoft et est activée par défaut lors du repérage d'une application PeopleSoft. Si vous sélectionnez Non dans la section Découvrir la surveillance de processus, la surveillance de processus est exclue du repérage PeopleSoft.

Le repérage du moniteur de processus est facultatif. Si la Console de traitements est déjà activée, vous pouvez l'inclure dans le repérage initial. Pour intégrer la console de processus à l'avenir, utilisez la commande refresh de l'interface de ligne de commande PeopleSoft et ajoutez les autorisations de base de données de la console de processus à l'utilisateur de surveillance. Pour plus d'informations sur les autorisations, reportez-vous à la section "Etablir des privilèges d'octroi de base de données pour la surveillance PeopleSoft" ci-dessus. Pour plus d'informations sur les commandes d'actualisation de l'interface de ligne de commande, reportez-vous à la section "Actualiser les instances PeopleSoft", ailleurs dans ce manuel.

Aucune propriété n'est requise pour le repérage de la Console de traitements.

Le repérage du contrôleur de processus est inclus par défaut. Pour vous désinscrire, sélectionnez Non dans le panneau de repérage Repérer le moniteur de processus dans la ressource.

Pour plus d'informations, reportez-vous à "Activer le repérage du moniteur de processus pour PeopleSoft", auquel vous pouvez accéder à partir de "Explorer plus", ailleurs dans ce manuel.

Mettre à jour la topologie d'application

Vous pouvez utiliser l'interface de ligne de commande OCI pour repérer de nouvelles ressources, créer les associations requises entre les ressources Stack Monitoring ou actualiser l'ensemble de la topologie. Plus précisément, vous pouvez utiliser l'interface de ligne de commande pour créer des associations entre la base de données et PeopleSoft.

Pour PeopleSoft, la mise à jour de la topologie d'application nécessite les tâches suivantes :

Gérez les domaines PeopleSoft.
Actualisez les instances PeopleSoft.

Gérer les domaines PeopleSoft

Stack Monitoring tire parti des informations de domaine contenues dans la table PSPMAGENT pour la détection. Si votre domaine PeopleSoft est manquant, vous pouvez créer les informations de domaine nécessaires manuellement en suivant les étapes décrites dans "Ajouter des domaines manuellement", ailleurs dans ce guide.

Actualisation des instances PeopleSoft

Actualisation de l'application PeopleSoft pour les types de ressource Stack Monitoring suivants :

oracle_psft
oracle_psft_appserv
oracle_psft_prcs
oracle_psft_pia
weblogic_domain (including members)

L'actualisation ne validera pas les informations d'identification des nouveaux domaines trouvés lors du processus d'actualisation. Si, au cours du processus de repérage, des domaines en échec ont été découverts, il peut s'agir de domaines obsolètes, ils peuvent ne pas être accessibles pour les connexions JMX à partir de l'agent ou pour d'autres raisons. Une fois les problèmes sous-jacents résolus, assurez-vous que les informations d'identification communes sont valides pour chacun des nouveaux domaines que vous souhaitez ajouter en validant via une connexion JMX à partir de l'hôte de l'agent, puis en effectuant une opération d'actualisation. Une fois l'actualisation réussie, les nouveaux domaines sont ajoutés. Ces domaines utilisent les mêmes informations d'identification communes avec lesquelles les domaines précédemment découverts sont configurés.

Une actualisation actualisera également les domaines WebLogic associés existants et leurs membres.

Lorsque de nouvelles instances PIA sont ajoutées, l'actualisation de PeopleSoft repère la ressource PIA nouvellement ajoutée mais ne repère pas le nouveau domaine WebLogic sous-jacent. Vous devez repérer le domaine WebLogic manuellement à l'aide de l'interface de ligne de commande pour associer ce nouveau domaine WebLogic à l'application PIA nouvellement repérée.

Vous pouvez actualiser l'instance PeopleSoft à partir de l'interface utilisateur ou à l'aide de l'interface de ligne de commande.

Pour actualiser à partir de l'interface utilisateur, sur la page d'accueil de la ressource, cliquez sur Actualiser sous le nom de la ressource. Dans le message de confirmation, cliquez sur OK pour ouvrir le panneau Repérage de ressources dans un nouvel onglet. Vous pouvez suivre le statut du travail d'actualisation soumis ici.
Pour effectuer une actualisation à l'aide de l'interface de ligne de commande, vous devez exécuter discovery-job create. Cette option implique un fichier JSON. Pour autoriser la suppression de ressource lors de l'opération d'actualisation, vous devez ajouter la propriété allow_delete_resources à la charge utile, ainsi que la propriété resource_id property et l'ID d'agent de surveillance. resource_id est l'ID de la ressource PeopleSoft à actualiser.
Pour actualiser les instances PeopleSoft à l'aide de l'interface de ligne de commande, utilisez la commande suivante :
```
oci stack-monitoring discovery-job create --compartment-id "Compartment_OCID" --discovery-type REFRESH --discovery-details file:///tmp/psft_refresh_dev.json
```

Pour plus de détails sur l'actualisation des instances PeopleSoft, reportez-vous à "PeopleSoft Refresh" dans la documentation OCI, à laquelle vous pouvez accéder à partir de "Explorer plus", ailleurs dans ce guide.