Commencer le processus de déploiement

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

Configurez la licence pour l'édition de votre choix, Standard ou Enterprise, ainsi que pour toutes les ressources ou compartiments utilisés dans votre déploiement.
Découvrir et promouvoir les ressources utilisées dans votre déploiement.
Utilisez l'interface de ligne de commande OCI pour détecter de nouvelles ressources, créer les associations requises entre les ressources de surveillance de pile ou actualiser la topologie complète.

Configurer les licences

Stack Monitoring propose deux éditions : Standard et Enterprise. L'édition Standard surveille les applications et les piles techniques déployées sur place et en nuage, notamment WebLogic, Tomcat, Oracle Database et les hôtes. Enterprise Edition ajoute des fonctions avancées telles que les extensions de mesure, les références de performance, la détection d'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.

Note :

Les étapes d'attribution des licences à l'un ou l'autre niveau dépassent le cadre de ce livre de jeu. 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.

Configurer les licences pour les fonctions propres au compartiment

Vous pouvez régler l'affectation automatique de licence de ressource à Enterprise ou Standard pour toutes les ressources nouvellement détectées ou promues dans un compartiment. La configuration de l'affectation automatique de licence est un moyen pratique d'affecter automatiquement une licence au lieu de l'appliquer à chaque instance de ressource. En outre, vous pouvez activer ou désactiver l'extensibilité d'entreprise pour un compartiment entier.

Les procédures de configuration de la licence pour les fonctions propres à un compartiment sont décrites dans "Affectation de licence", dans la documentation sur Oracle Cloud Infrastructure, à laquelle vous pouvez accéder à partir de "Explorer plus".

Configurer les licences pour les fonctions propres aux ressources

L'affectation de licence de ressource peut être effectuée au niveau des ressources individuelles pendant la détection ou après la détection à l'aide de l'interface utilisateur d'octroi de licences. Les modifications de licence appliquées à un composite s'appliquent à tous les enfants. En d'autres termes, lors de l'application de la licence Enterprise Edition à un domaine WebLogic, tous les serveurs WebLogic associés au domaine recevront également Enterprise Edition.

Lors de la détection, 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é détectée à l'aide de l'interface utilisateur de licence. Ces procédures sont décrites dans "Affectation de licence", dans la documentation sur Oracle Cloud Infrastructure, à laquelle vous pouvez accéder à partir de "Explorer plus".

Découvrir et promouvoir des ressources pour PeopleSoft

Pour surveiller des ressources à l'aide de la surveillance de pile, vous devez d'abord détecter et promouvoir ces ressources. La promotion préalimente les informations relatives à la ressource. Vous devez valider ces informations pour vous assurer qu'elles sont correctes. Les préalables et les paramètres d'entrée pour la promotion sont les mêmes que ceux pour la détection lancée par l'utilisateur.

La détection PeopleSoft implique trois familles de ressources obligatoires : le domaine du serveur d'applications, le domaine du programmateur de processus 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 détecter et promouvoir des ressources pour les applications PeopleSoft, vous devez effectuer les opérations suivantes :

Détectez la base de données PeopleSoft.
Établissez les privilèges d'octroi de base de données pour la surveillance PeopleSoft.
Activez PeopleSoft Performance Monitor pour Pure Internet Architecture (PIA).
Satisfaire aux préalables pour les domaines du serveur d'applications et du Répartiteur de traitements.
Identifiez les domaines à découvrir.
Ajoutez des domaines manuellement.
Activer la détection Elasticsearch.
Activer la détection du moniteur de processus.

Note :

Les étapes de la découverte et de la promotion des ressources dépassent le cadre de ce livre de jeu. 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.

Découvrez la base de données PeopleSoft

Vous devez détecter Oracle Database contenant le schéma PeopleSoft avant de détecter l'application PeopleSoft.

En détectant d'abord la base de données, elle est automatiquement associée à l'application PeopleSoft une fois la détection des ressources PeopleSoft terminée. Si vous effectuez la détection d'application PeopleSoft avant la détection de la base de données, vous devez créer l'association manuellement. Pour plus d'informations, voir Topologie des applications. Pour découvrir la base de données Oracle, consultez " Oracle Database ", à laquelle vous pouvez accéder à partir de " Explorer plus ", ailleurs dans ce livre de jeu.

Établir les 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 diffère selon le type de base de données (base de données non conteneur, base de données conteneur et base de données enfichable) utilisée comme magasin de données PeopleSoft.

Lors de la détection de la surveillance de pile PeopleSoft, vous pouvez utiliser le responsable du schéma PeopleSoft, généralement SYSADM, comme données d'identification de base de données. Vous devez créer un utilisateur de surveillance avec uniquement les 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, consultez la note MOS : 2857604.1. Pour plus d'informations, voir é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 "Explorez plus", ailleurs dans ce livre de jeu.

Activer PeopleSoft Performance Monitor pour Pure Internet Architecture (PIA)

Il s'agit d'une procédure facultative qui n'est requise que pour la détection et l'actualisation PeopleSoft. Toutefois, pour une surveillance et une collecte de mesures régulières, 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 la détection ou l'actualisation soit terminée, puis désactivez-le et redémarrez les domaines.
INSÉRER/Supprimer manuellement toutes les informations du domaine PeopleSoft. Cela élimine la nécessité d'activer l'activation de l'agent PPM.

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

Naviguez jusqu'à PeopleTools, allez à Profil Web, cliquez sur Configuration du 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.

Satisfaire aux conditions requises pour les domaines du serveur d'applications et du Répartiteur de traitements

Ensuite, vous devez respecter les conditions requises pour chaque serveur d'applications et chaque domaine du Répartiteur de traitements. La détection PeopleSoft suppose que l'ID utilisateur/mot de passe de l'administration distante pour l'accès JMX est le même pour tous les domaines du serveur d'applications, ainsi que pour tous les domaines du programmateur de processus.

Les préalables que vous devez remplir sont les suivants :

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

Les rubriques suivantes fournissent des étapes générales pour effectuer ces tâches. Pour des procédures détaillées, voir "Préalables pour les domaines du serveur d'applications et du Répartiteur de traitements" dans la documentation OCI sur le service de surveillance de pile, à laquelle vous pouvez accéder à partir de "Explorer plus", ailleurs dans ce livre de jeu.

Activer l'agent Performance Monitor PeopleSoft

Pour activer l'agent Performance Monitor PeopleSoft, procédez de la façon suivante :

Ouvrez les fichiers de configuration de domaine en mode de 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, puis Modifier le menu des 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 EnablePPM Agent.
Activez les agents PPM, réglez la valeur à 1 et enregistrez le fichier.

Activer les agents JMX

Cette condition préalable permet à la surveillance de pile de collecter des données de disponibilité et de performance pour une application PeopleSoft. Voici les étapes générales :

Ouvrez les fichiers de configuration de domaine en mode de modification à 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, Modifier le menu des 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 effectuez les opérations suivantes :
1. Assurez-vous que le port d'administration distant que vous prévoyez d'utiliser n'est utilisé par aucun autre processus sur l'hôte.
2. Définissez le code d'utilisateur dans un format texte. Utilisez le même code d'utilisateur et le même mot de passe pour tous les domaines du serveur d'applications et du Répartiteur 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é Performance Collator (comme décrit dans la rubrique suivante), redémarrez le serveur d'applications et les domaines du Répartiteur de traitements.
Définissez les valeurs de port d'administration distante et de port RMI.
- Si vous utilisez PeopleSoft version 8.59 et antérieure, vous n'avez qu'à définir le port d'administration distante. La valeur du port RMI est définie automatiquement, en incrémentant la valeur du port d'administration distante de un.
- Pour PSFT version 8.60, 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 du Répartiteur de traitements 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 livre de jeu.

Activer la propriété Performance Collator

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

Si le Collateur de performance est activé, vous verrez cette entrée :

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

Si le Collator de performance est désactivé, vous verrez cette entrée :

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

Si le Collateur de performance est déjà activé et que des modifications ont été mises en oeuvre aux valeurs d'agent EnablePPM ou JMX, vous pouvez redémarrer tous les domaines. Si le Collator de performance n'est pas déjà 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êtera le domaine.
Vérifiez la valeur de la propriété Performance Collator.
- Si la valeur est réglée à Oui, le Collator 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 le Répartiteur de traitements.
- Si vous réglez la valeur à Non, entrez l'option 10 pour le serveur d'applications ou l'option 3 pour le Répartiteur de traitements pour régler la valeur à Oui.
Après avoir confirmé que le Collateur de performance est réglé à Oui, sélectionnez Load config as shown (Option 14 pour le programmateur d'application ou Option 7 pour le programmateur de processus).
Enfin, sélectionnez Boot this domain Option 1 pour démarrer le domaine.

Identifier les domaines à découvrir

Le service de surveillance de pile tire parti des informations stockées dans Oracle Database pour identifier les domaines à détecter ou à actualiser.

Pour valider la liste des domaines courants, utilisez l'interrogation suivante :

SELECT * FROM PSPMAGENT;

Avant de détecter ou d'actualiser l'application PeopleSoft, vous devez supprimer tous les domaines retournés par l'interrogation qui n'existent plus.

Note :

Si vous devez ajouter un domaine qui n'est pas répertorié, voir la rubrique suivante, "Ajout manuel de domaines".

Pour supprimer les domaines périmés, connectez-vous en tant qu'utilisateur SYSADM ou équivalent et exécutez l'interrogation SQL suivante. Répétez l'interrogation jusqu'à ce que vous ayez supprimé tous les domaines périmés. Tenez compte des points suivants :

Sauvegardez la table PSPMAGENT avant d'apporter des modifications.
```
create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT; 
```
où DATE avec l'horodatage courant
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 rangées de PSPMAGENT correspond à PSPMAGENT_BKP_DATE, supprimez les domaines périmés :

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 de la table PSPMAGENT. Si aucun domaine valide ne s'affiche, utilisez les interrogations 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 du répartiteur de traitements
Domaine de serveur d'applications
Serveur PIA

Avant de continuer, effectuez les opérations suivantes pour sauvegarder la table PSPMAGENT :

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

Utilisez les commandes suivantes pour ajouter les domaines :

Domaine du répartiteur de traitements

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 la détection ElasticSearch

La détection Elasticsearch est facultative. Si Elasticsearch est déjà intégré, vous pouvez l'inclure dans la découverte initiale. Pour intégrer Elasticsearch à l'avenir, utilisez la commande refresh de l'interface de ligne de commande PeopleSoft et ajoutez les autorisations d'accès à la base de données Elasticsearch à l'utilisateur de surveillance. Pour plus d'informations sur les autorisations, voir "Établir les privilèges d'autorisation d'accès à la base de données pour la surveillance PeopleSoft", ci-dessus, et pour plus d'informations sur les commandes d'actualisation de l'interface de ligne de commande, voir "Actualiser les instances PeopleSoft", ailleurs dans ce livre de jeu.

L'achèvement de ces préalables activera l'intégration Elasticsearch dans PeopleSoft :

La surveillance de pile prend uniquement en charge la surveillance Elasticsearch configurée avec SSL. Son point d'extrémité doit être HTTPS. Pour plus d'informations sur la configuration d'Elasticsearch, voir "Configuration du protocole SSL entre PeopleSoft et Elasticsearch", auquel vous pouvez accéder à partir de "Explorez plus", ailleurs dans ce livre de jeu.
Avant de découvrir Elasticsearch, créez un magasin de certificats JKS (JKS est le seul magasin de certificats 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 magasin de certificats sont des paramètres requis dans l'interface utilisateur de détection ou dans le fichier JSON de détection lors de la tentative de détection au moyen de l'interface de ligne de commande. En outre, l'emplacement du magasin de certificats doit être accessible sur l'hôte de l'agent.
Par exemple :
```
keytool -keystore truststore.jks -alias ALIAS -import -file ELASTICSEARCH_CERTIFICATE
```

Activer la détection du moniteur de processus

Le moniteur de processus est détecté avec PeopleSoft et est activé par défaut lors de la détection d'une application PeopleSoft. La sélection de Non dans la section Discover Process Monitor exclut Process Monitor de la détection PeopleSoft.

La détection du moniteur de traitements est facultative. Si le Moniteur de traitements est déjà activé, vous pouvez l'inclure dans la détection initiale. Pour intégrer le moniteur 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 du moniteur de processus à l'utilisateur de surveillance. Pour plus d'informations sur les autorisations, voir "Établir les privilèges d'autorisation d'accès à la base de données pour la surveillance PeopleSoft", ci-dessus, et pour plus d'informations sur les commandes d'actualisation de l'interface de ligne de commande, voir "Actualiser les instances PeopleSoft", ailleurs dans ce livre de jeu.

Aucune propriété n'est requise pour la détection du moniteur de processus.

La détection du moniteur de traitements est incluse par défaut. Pour vous désabonner, sélectionnez Non dans le panneau de détection Détecter le moniteur de processus dans la ressource.

Pour plus d'informations, voir "Activer la détection du moniteur de processus pour PeopleSoft", auquel vous pouvez accéder à partir de "Explorez plus", ailleurs dans ce livre de jeu.

Mettre à jour la topologie de l'application

Vous pouvez utiliser l'interface de ligne de commande OCI pour détecter de nouvelles ressources, créer les associations requises entre les ressources de surveillance de pile ou actualiser la topologie complète. 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érer les domaines PeopleSoft.
Actualiser les instances PeopleSoft.

Gérer les domaines PeopleSoft

La surveillance de pile utilise les 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 livre de jeu.

Actualiser les instances PeopleSoft

L'application PeopleSoft actualise les types de ressource de surveillance de pile suivants :

oracle_psft
oracle_psft_appserv
oracle_psft_prcs
oracle_psft_pia
weblogic_domain (including members)

L'actualisation ne validera pas les données d'identification pour les nouveaux domaines trouvés lors du processus d'actualisation. Si, au cours du processus de détection, des domaines en échec ont été détectés, il peut s'agir de domaines périmés, 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 données d'identification communes sont valides pour chacun des nouveaux domaines que vous prévoyez d'ajouter en validant au moyen d'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 détectés précédemment 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 PeopleSoft détecte la ressource PIA nouvellement ajoutée, mais elle ne détecte pas le nouveau domaine WebLogic sous-jacent. Vous devez détecter le domaine WebLogic manuellement à l'aide de l'interface de ligne de commande pour associer ce nouveau domaine WebLogic à l'AIP nouvellement détecté.

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, dans 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 Détection des ressources dans un nouvel onglet. Vous pouvez suivre le statut de la tâche d'actualisation soumise ici.
Pour actualiser à 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 ressources lors de l'opération d'actualisation, vous devez ajouter la propriété allow_delete_resources aux données utiles, ainsi que la propriété resource_id property et l'ID agent de surveillance. resource_id est l'ID de la ressource PeopleSoft devant être actualisé.
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, voir "PeopleSoft Actualiser" dans la documentation OCI, à laquelle vous pouvez accéder à partir de "Explorer plus", ailleurs dans ce livre de jeu.