NRE 17.x : Effacement du cache Java, activation de la console Java et débogage

Le débogage peut être activé sur le service GST de la NMC. La méthode utilisée dépend du type de problème.
Les niveaux de débogage et leurs principaux cas d’utilisation sont décrits dans : NetWorker : niveaux d’informations de débogage

Première approche : NMC n’est pas accessible, le service du serveur NMC ne parvient pas à démarrer.

Linux :

1. Sur le serveur NMC , ouvrez un shell avec élévation de privilèges.
2. Créez une copie du script de contrôle de service NMC :

cp /opt/lgtonmc/etc/gst_linux.sh /opt/lgtonmc/etc/gst_linux.sh.orig

3. Ouvrez le script d’origine dans un éditeur de texte :

vi /opt/lgtonmc/etc/gst_linux.sh

4. Recherchez le Starting GST. Ajouter -D9 après $gstd dans le bloc GST de départ, exemple :

   echo_n "Starting GST: "
      if [ -x "$gstd" ] ; then
          "$gstd" -D9
          code=$?
          echo "done."

5. Démarrez le service NMC à l’aide du script de démarrage :

/opt/lgtonmc/etc/gst_linux.sh start

6. Collectez et examinez les résultats.

Lorsque le débogage n’est plus nécessaire, revenez au fichier d’origine ou supprimez -D9 du rôle Starting GST bloquer. Gérez le service à l’aide des commandes normales systemctl ou service . Par exemple systemctl start gst

Fenêtres :

1. Sur le serveur NMC, ouvrez une invite avec élévation de privilèges. 
2. Remplacez le répertoire (cd) par le répertoire bin NMC :

cd "C:\Program Files\EMC NetWorker\Management\GST\bin"

3. Démarrez le service avec le débogage activé :

.\gstd.exe -D9

4. Collecter et vérifier les résultats

Deuxième approche : la NMC est accessible et des actions spécifiques de la NMC sont à l’étude :

1. Dans l’écran Enterprise de NMC, cliquez sur l’onglet Setup.
2. Cliquez sur le menu Configuration et sélectionnez Options système.

3. Dans les Options système , définissez le niveau de débogage selon les besoins, généralement 9.

4. Aucun redémarrage du service n’est requis. Effectuez des actions à partir de NMC nécessitant un débogage.
5. Affichez le gstd.raw à partir du serveur NMC.

Linux : /opt/lgtonmc/logs/gstd.raw
Windows (par défaut) : C:\Program Files\EMC NetWorker\Management\GST\logs\gstd.raw

Pour effectuer le rendu .raw fichiers, voir l’article NetWorker : comment utiliser nsr_render_log pour afficher .raw fichiers log

6. Récupérer le rendu gstd.raw à partir du serveur NMC.

Cette approche est utile lorsque vous souhaitez observer les événements de la console Java tout en effectuant des actions directement dans NMC. Cela peut être utilisé pour les problèmes persistants ou un problème qui peut être reproduit à la demande. Cette sortie peut également être consignée dans un fichier. 

1. Ouvrez l’Explorateur de fichiers Windows et accédez à "C:\Program Files\OpenWebStart"
2. Ouvrez itw-settings.exe (OpenWebStart Console).
3. Accédez à Journalisation.
4. Sélectionnez les options suivantes :

• Log Console : afficher
• Augmenter le niveau de commentaires du journal (débogage)
• Se connecte à la sortie standard (se connecte à la console)
• Log vers fichier (logs vers fichier log)
• Facultatif : modifiez l’emplacement du dossier de logs. Si cette option n’est pas modifiée, la sortie du journal est consignée dans C:\Users\USER-NAME\.config\icedtea-web\log.

5. Cliquez sur Appliquer, puis sur OK.

Cette approche est utile lorsque vous n’avez pas besoin d’ouvrir la console de journalisation Java, mais que vous souhaitez capturer des événements dans un fichier journal. Cela est utile pour les problèmes intermittents ou les problèmes qui ne peuvent pas être facilement reproduits à la demande.

1. Sur le serveur NetWorker Management Console (NMC), ouvrez le gconsole.jnlp dans un éditeur de texte.

• Linux : /opt/lgtonmc/web/gconsole.jnlp
• Windows (par défaut) : C :\Program Files\EMC NetWorker\Management\GST\web\gconsole.jnlp

2. Dans l' application-desc , ajoutez les options suivantes :

<argument>-f</argument>
<argument>C:\\Program Files\\NRE\\logs\\java1.log</argument>

Exemple :

<application-desc main-class="COM.legato.gwt.framework.LMainWindow">
		<argument>-g</argument>
		<argument>IPADDR_REPLACE_AT_RUNTIME(fe80::d3e7:121a:e342:3332)</argument>
		<argument>-p</argument>
		<argument>gconsole</argument>
		<argument>-i</argument>
		<argument>false</argument>
		<argument>-s</argument>
		<argument>X_NO_SERVER_X</argument>
		<argument>-P</argument>
		<argument>X_NO_SERVER_PORT_X</argument>
		<argument>-t</argument>
		<argument>X_NO_TASK_X</argument>
		<argument>-h</argument>
		<argument>9000</argument>
		<argument>-n</argument>
		<argument>9001</argument>
		<argument>-b</argument>
		<argument>5432</argument>
		<argument>-A</argument>
		<argument>9090</argument>
		<argument>-d</argument>
		<argument>0</argument>
		<argument>-a</argument>
		<argument>X_NO_AUTH_X</argument>
		<argument>-m</argument>
		<argument>X_NO_ISSUER_X</argument>
		<argument>-f</argument>
		<argument>C:\\Program Files\\NRE\\logs\\java1.log</argument>
</application-desc>

3. Sur l’hôte utilisé pour accéder à NMC, téléchargez un nouveau gconsole.jnlp À partir d’un navigateur WE : https://NMC_SERVER_ADDRESS:9000/gconsole.jnlp
4. Lancez la NMC à l’aide de la nouvelle commande gconsole.jnlp .
5. L' java1.log est créé sur l’hôte accédant à la NMC :
   

1. Activez la console Java ou le débogage du fichier journal Java conformément aux sections ci-dessus.
2. Lancez NetWorker Management Console (NMC) gconsole.jnlp .
3. Connectez-vous au NMC.
4. Dans la fenêtre Enterprise, CTRL+SHIFT+Right-Click
5. Cliquez sur Save Debug Messages... et spécifiez un emplacement de sortie.

6. Dans la fenêtre Enterprise, une fois de plus
7. Dans Définir le niveau de débogage, sélectionnez le niveau de débogage souhaité. Habituellement, 7

8. Effectuer des actions dans NMC qui nécessitent un débogage. Copiez la sortie de la session de la console Java et collectez le fichier de sortie Java créé à l’étape 5.
9. Pour désactiver le débogage, répétez le processus, mais définissez Débogage désactivé.

Activer la journalisation Java option 2

Le débogage NRE peut être configuré à l’intérieur du NRE C:\Program Files\NRE\logs\logConfig.properties . Le niveau de débogage du log par défaut est WARNING.

Les niveaux de journalisation pris en charge, du plus bas au plus élevé, sont les suivants :

OFF
SEVERE
WARNING
INFO
CONFIG
FINE
FINER
FINEST
ALL

1. Ouvrez l’Explorateur de fichiers Windows et accédez à "C:\Program Files\OpenWebStart"
2. Ouvrir itw-settings.exe (Console OpenWebStart).
3. Aller au cache
4. Utilisez l’une des options suivantes pour supprimer tous les fichiers (purge) ou supprimer les fichiers pour une connexion spécifique au serveur NMC.

Première option : Cliquez sur Afficher les fichiers. Cliquez sur Purger pour supprimer tous les fichiers de cache Java :

Deuxième option : Dans Cache Viewer, cliquez sur Clean by app. Sélectionner la NMC gconsole.jnlp pour un serveur NMC spécifique, cliquez sur Delete Files.

NetWorker Management Console (NMC) utilise un runtime Java sur l’hôte accédant à la console. La console utilise le fichier gconsole.jnlp, qu’il télécharge à partir du serveur NMC. Vous pouvez observer des erreurs de type « manque de mémoire » ou « espace de tas Java » dans NMC. La limite du segment de mémoire NMC est la limite de mémoire allouée ; Cela dit, ces erreurs peuvent apparaître même si l’hôte accédant à NMC dispose toujours de suffisamment de mémoire disponible. Il s’agit d’un comportement normal lors de l’exécution de certaines opérations dans NMC, en particulier dans les environnements de grande taille ou les environnements avec un grand nombre de données. 

1. Ouvrez une invite de commandes de l’administrateur ou PowerShell.
2. Accédez à votre répertoire bin Java NetWorker Runtime Environment (NRE). Par exemple :

PS C:\Users\administrator.AMER> cd "C:\Program Files\NRE\java\"
PS C:\Program Files\NRE\java> dir


    Directory: C:\Program Files\NRE\java


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         1/19/2026   4:55 PM                jdk-17.0.17


PS C:\Program Files\NRE\java> cd .\jdk-17.0.17\bin
PS C:\Program Files\NRE\java\jdk-17.0.17\bin>

3. Obtenez l’ID de processus (PID) du java.exe processus associé à OpenWebStart :

Get-CimInstance Win32_Process | Where-Object { $_.Name -like "*java*" } | Select-Object ProcessId, Name, CommandLine

PS C:\Program Files\NRE\java\jdk-17.0.17\bin> Get-CimInstance Win32_Process | Where-Object { $_.Name -like "*java*" } | Select-Object ProcessId, Name, CommandLine

ProcessId Name       CommandLine
--------- ----       -----------
     1352 javaws.exe "C:\Program Files\OpenWebStart\javaws.exe" "C:\Users\administrator.AMER\Downloads\gconsole.jnlp"
     7644 java.exe   "C:\Program Files\NRE\java\jdk-17.0.17\bin\java.exe" "-Xbootclasspath/a:C:\Program Files\OpenWebStart\openwebstart.jar" "-Dicedtea-web.bin.location=C:\Program Files\OpenWebStart\javaws" -Xms512M -Xmx2048M -Djava.locale.providers=COMPAT -Djava.util.Arrays.useLegacyMergeSort=true --add-reads=java.base=ALL-UNNAMED,java.desktop --add-reads=java.d...

.\jcmd.exe PID VM.flags
.\jcmd.exe PID GC.heap_info

PS C:\Program Files\NRE\java\jdk-17.0.17\bin> .\jcmd.exe 7644 VM.flags
7644:
-XX:CICompilerCount=2 -XX:ConcGCThreads=1 -XX:G1ConcRefinementThreads=2 -XX:G1EagerReclaimRemSetThreshold=8 -XX:G1HeapRegionSize=1048576 -XX:GCDrainStackTargetSize=64 -XX:InitialHeapSize=536870912 -XX:MarkStackSize=4194304 -XX:MaxHeapSize=2147483648 -XX:MaxNewSize=1287651328 -XX:MinHeapDeltaBytes=1048576 -XX:MinHeapSize=536870912 -XX:NonNMethodCodeHeapSize=5826188 -XX:NonProfiledCodeHeapSize=122916026 -XX:ProfiledCodeHeapSize=122916026 -XX:ReservedCodeCacheSize=251658240 -XX:+SegmentedCodeCache -XX:SoftMaxHeapSize=2147483648 -XX:+UseCompressedClassPointers -XX:+UseCompressedOops -XX:+UseFastUnorderedTimeStamps -XX:+UseG1GC -XX:-UseLargePagesIndividualAllocation

PS C:\Program Files\NRE\java\jdk-17.0.17\bin> .\jcmd.exe 7644 GC.heap_info
7644:
 garbage-first heap   total 524288K, used 112318K [0x0000000080000000, 0x0000000100000000)
  region size 1024K, 103 young (105472K), 2 survivors (2048K)
 Metaspace       used 22772K, committed 23168K, reserved 1114112K
  class space    used 2530K, committed 2752K, reserved 1048576K

Les éléments ci-dessus jmcd Il peut être nécessaire d’exécuter les commandes par intermittence ou en même temps que les erreurs de segment de mémoire NMC pour observer les conditions de segment. Il peut également être nécessaire de scripter et de surveiller les conditions du segment de mémoire à intervalles définis afin d’observer des modèles cohérents.