Le scénario fictif suivant montre comment utiliser la commande mfwkadm avec ses options et sous-commandes associées.
La sous-commande list-modules affiche les instances des composants de Java ES sur l'hôte courant avec les modules correspondants dans le Conteneur d'agents communs. L'exemple ci-dessous présente la liste de deux composants installés : Directory Server pour lequel aucune instance n'est en cours d'exécution et Web Server pour lequel une seule instance existe.
$ mfwkadm list-modules Installed products and their running instances: ============================================== Instances for installed product: com.sun.cmm.ds:collectionID=/opt/SUNWdsee/ds6, name=Sun Java(TM) System Directory Server,type=CMM_InstalledProduct ------------------------------- No instance. Instances for installed product: com.sun.cmm.ws:collectionID=/var/opt/SUNWwbsvr7, name=WebServer,type=CMM_InstalledProduct ------------------------------- /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com,type=CMM_ApplicationSystem |
La sous-commande info suivante affiche les objets contrôlables dans l'instance Web Server, avec les classes et les attributs pour chaque type de tâche.
$ mfwkadm info /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com,\\ type=CMM_ApplicationSystem Information about running instance: /wsPrefix/com.sun.cmm.ws: name=https-hostname.example.com,type=CMM_ApplicationSystem ================================== Observable objects for performance jobs: --------------------------------------- + Objects of class: com.sun.cmm.settings.CMM_ApplicationSystemSetting /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com-setting, type=CMM_ApplicationSystemSetting Observable attributes: Caption [STRING] ConfigurationDirectory [STRING] CreationClassName [STRING] Description [STRING] DirectoryName [STRING] ElementName [STRING] InstanceID [STRING] Name [STRING] URL [STRING] + Objects of class: com.sun.cmm.settings.CMM_KeepAliveSetting /wsPrefix/com.sun.cmm.ws:name=process-1-keepalive-setting, type=CMM_KeepAliveSetting Observable attributes: AllocationUnit [STRING] Caption [STRING] ConnectionsUpperBound [LONG] CreationClassName [STRING] Description [STRING] ElementName [STRING] InputUnit [STRING] InstanceID [STRING] LowerAllocationLimit [LONG] LowerInputLimit [LONG] LowerOutputLimit [LONG] Name [STRING] OtherAllocationUnit [STRING] OtherInputUnit [STRING] OtherLowerAllocationLimit [LONG] OtherLowerInputLimit [LONG] OtherLowerOutputLimit [LONG] OtherOutputUnit [STRING] OtherUpperAllocationLimit [LONG] OtherUpperInputLimit [LONG] OtherUpperOutputLimit [LONG] OutputUnit [STRING] QueuedUpperBound [LONG] SecondsTimeout [LONG] TimeoutUpperBound [LONG] UpperAllocationLimit [LONG] UpperInputLimit [LONG] UpperOutputLimit [LONG] ... |
La commande suivante affiche la liste des tâches de contrôle des performances définies. Dans cet exemple, il n'y a qu'une seule tâche de contrôle des performances appelée myPerfJob qui surveille un seul objet :
$ mfwkadm pm-job list BY_OBJECTS performance jobs: =========================== Performance job information for: myPerfJob ------------------------------- Type: BY_OBJECTS State: ACTIVE_ON_DUTY Granularity period: 30 Reporting period: 1 By event: EVENT_SINGLE By file: EVENT_SINGLE Report format: XML Schedule: Global start time: Immediately Global stop time: Forever Weekly schedule: Everyday Daily schedule: All day Observed objects: /wsPrefix/com.sun.cmm.ws:name=virtualServer-hostname.example.com- webApp-/-stats,type=CMM_VirtualServerWebModuleStats Observed attributes: All available BY_CLASSES performance jobs: =========================== No jobs found. |
La commande suivante crée une tâche de contrôle de l'état opérationnel pour deux objets contrôlables dont le nom a été obtenu à l'aide des sous-commandes opstat-job info et opstat-job observable-objects :
$ mfwkadm opstat-job create myOpStatJob granularity=60 \\ object=/wsPrefix/com.sun.cmm.ws:name=process-1,type=CMM_UnixProcess \\ object=/wsPrefix/com.sun.cmm.ws:name=process-1-DNSCache1,type=CMM_DnsCache |
La commande suivante suspend l'exécution de la tâche créée ci-dessus :
$ mfwkadm opstat-job suspend myOpStatJob |
La commande suivante affiche les classes contrôlables pour d'éventuelles tâches de contrôle des valeurs seuil :
$ mfwkadm thrsh-job observable-classes Threshold jobs observable classes: ================================= com.sun.cmm.cim.CIM_ScopedSettingData com.sun.cmm.cim.CIM_SettingData com.sun.cmm.cim.CIM_StatisticalData com.sun.cmm.cim.statistics.CIM_EthernetPortStatistics com.sun.cmm.cim.statistics.CIM_NetworkPortStatistics com.sun.cmm.cim.statistics.j2ee.CIM_J2eeJVMStats com.sun.cmm.cim.statistics.j2ee.CIM_J2eeStatistic com.sun.cmm.settings.CMM_ApplicationSystemSetting com.sun.cmm.settings.CMM_KeepAliveSetting com.sun.cmm.settings.CMM_QueueTimeoutSetting com.sun.cmm.settings.CMM_RFC2788ApplicationSystemSetting com.sun.cmm.settings.CMM_ScopedSettingData com.sun.cmm.settings.CMM_SoftwareResourceSetting com.sun.cmm.settings.CMM_SWRBufferSetting com.sun.cmm.settings.CMM_SWRLimitSetting com.sun.cmm.settings.CMM_SWRQueueSetting com.sun.cmm.settings.CMM_VirtualServerSetting com.sun.cmm.statistics.CMM_ApplicationSystemStats com.sun.cmm.statistics.CMM_ApplicationSystemWatchdogStats com.sun.cmm.statistics.CMM_ConnectionQueueStats com.sun.cmm.statistics.CMM_DnsCacheStats com.sun.cmm.statistics.CMM_EthernetPortStats com.sun.cmm.statistics.CMM_FileCacheStats com.sun.cmm.statistics.CMM_HTTPResponsesStats com.sun.cmm.statistics.CMM_JVMJSR174ExtStats com.sun.cmm.statistics.CMM_JVMJSR174Stats com.sun.cmm.statistics.CMM_JVMStats com.sun.cmm.statistics.CMM_NetworkPortStats com.sun.cmm.statistics.CMM_OperatingSystemStats com.sun.cmm.statistics.CMM_ProcessorStats com.sun.cmm.statistics.CMM_ProcessStats com.sun.cmm.statistics.CMM_QueueTimeoutStats com.sun.cmm.statistics.CMM_RFC2788ApplicationTableStats com.sun.cmm.statistics.CMM_ServiceStats com.sun.cmm.statistics.CMM_SoftwareResourceStats com.sun.cmm.statistics.CMM_SolarisEthernetPortStats com.sun.cmm.statistics.CMM_SolarisNetworkPortStats com.sun.cmm.statistics.CMM_SolarisOperatingSystemStats com.sun.cmm.statistics.CMM_SolarisProcessorStats com.sun.cmm.statistics.CMM_SolarisProcessorSysinfoStats com.sun.cmm.statistics.CMM_SolarisProcessorVmStats com.sun.cmm.statistics.CMM_Statistic com.sun.cmm.statistics.CMM_SWRBufferStats com.sun.cmm.statistics.CMM_SWRCacheStats com.sun.cmm.statistics.CMM_SWRLimitStats com.sun.cmm.statistics.CMM_SWRQueueStats com.sun.cmm.statistics.CMM_UnixOperatingSystemStats com.sun.cmm.statistics.CMM_UnixProcessStats com.sun.cmm.statistics.CMM_VirtualServerWebModuleStats com.sun.cmm.statistics.CMM_WebModuleStats |
La commande suivante affiche les attributs contrôlables pour les tâches de contrôle des valeurs seuil qui surveillent les objets de la classe com.sun.cmm.statistics.CMM_SWRQueueStats trouvée à l'exemple précédent :
$ mfwkadm thrsh-job observable-attributes \\ class=com.sun.cmm.statistics.CMM_SWRQueueStats Threshold jobs observable attributes: ==================================== Class: com.sun.cmm.statistics.CMM_SWRQueueStats Attributes: BufferSize [LONG] EntriesCount [LONG] EntriesHighWaterMark [LONG] EntriesLowWaterMark [LONG] EntriesTotal [LONG] ErrorCount [INTEGER] FailedOperations [LONG] LowerLimit [LONG] OperationsCount [LONG] OtherLowerLimit [LONG] OtherUpperLimit [LONG] OverflowsCount [LONG] QueuedCount [LONG] QueuedHighWater [LONG] SampleInterval [LONG] TotalQueuedCount [LONG] UpperLimit [LONG] |
La commande suivante est un autre exemple de création de tâche, mais cette fois pour le contrôle des valeurs seuil :
$ mfwkadm thrsh-job create myThreshJob granularity=30 \\ object=/wsPrefix/com.sun.cmm.ws:name=process-1-threadPool-NativePool-stats,\\ type=CMM_SWRQueueStats attributeName=EntriesCount attributeType=LONG \\ thresholdValue=1000 thresholdOffset=10 thresholdDirection=RISING |
L'exemple ci-dessous reproduit la sortie de la sous-commande thrsh-job info pour la tâche de contrôle des valeurs seuil créée à l'exemple précédemment :
$ mfwkadm thrsh-job info myThreshJob Threshold job information for: myThreshJob ----------------------------- Type: SIMPLE State: ACTIVE_ON_DUTY Granularity period: 30 Schedule: Global start time: Immediately Global stop time: Forever Weekly schedule: Everyday Daily schedule: All day Alarm configuration: Type: QualityOfServiceAlarm Severity: INDETERMINATE Threshold definition(s): Object: /wsPrefix/com.sun.cmm.ws:name=process-1-threadPool- NativePool-stats,type=CMM_SWRQueueStats Attribute: EntriesCount [LONG] Value: 1000 Direction: RISING Offset: 10 |