NRE 17.x: Java-cache wissen, Java-console inschakelen en foutopsporing

Foutopsporing kan worden ingeschakeld op de GST-service van de NMC. De gebruikte methode is afhankelijk van het type probleem.
Foutopsporingsniveaus en hun primaire gebruiksscenario's worden beschreven in: NetWorker: Informatieniveaus voor foutopsporing

Benadering één: NMC is niet toegankelijk, de NMC serverservice kan niet worden gestart.

Linux:

1. Open op de NMC server een verhoogde shell.
2. Maak een kopie van het NMC Service Control script:

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

3. Open het originele script met een teksteditor:

vi /opt/lgtonmc/etc/gst_linux.sh

4. Zoek naar de Starting GST. Toevoegen -D9 na afloop van de $gstd in het startblok GST, voorbeeld:

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

5. Start de NMC service met behulp van het opstartscript:

/opt/lgtonmc/etc/gst_linux.sh start

6. Verzamel en controleer de uitvoer.

Wanneer foutopsporing niet langer nodig is, keert u terug naar het oorspronkelijke bestand of verwijdert u -D9 van de Starting GST blok. Beheer de service met behulp van de normale systemctl of service commando's. Bijvoorbeeld systemctl start gst

Windows:

1. Open op de NMC server een prompt met verhoogde bevoegdheden. 
2. Verander directory (cd) in de NMC bin-directory:

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

3. Start de service met foutopsporing ingeschakeld:

.\gstd.exe -D9

4. Verzamel en bekijk de output

Aanpak twee: NMC is toegankelijk en specifieke acties van NMC worden onderzocht:

1. Klik in het scherm Enterprise van NMC op het tabblad Setup.
2. Klik op het installatiemenu en selecteer Systeemopties.

3. Stel vanuit Systeemopties het vereiste foutopsporingsniveau in, meestal 9.

4. Er is geen herstart van de service vereist, acties uitvoeren vanuit NMC waarvoor foutopsporing is vereist.
5. Render de gstd.raw van de NMC server.

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

Renderen .raw bestanden, zie artikel NetWorker: nsr_render_log gebruiken om .raw logbestanden weer te geven

6. Verzamel de gerenderde gstd.raw bestand van de NMC server.

Deze aanpak is handig voor wanneer u de Java Console-gebeurtenissen wilt observeren terwijl u acties rechtstreeks in de NMC uitvoert. Dit kan worden gebruikt voor aanhoudende problemen of een probleem dat op aanvraag kan worden gereproduceerd. Deze uitvoer kan ook worden gelogd op een bestand. 

1. Open Windows Verkenner en ga naar "C:\Program Files\OpenWebStart"
2. Open itw-settings.exe (OpenWebStart console).
3. Ga naar Logboekregistratie.
4. Selecteer de volgende opties:

• Log Console: Show
• Uitgebreidheid van het logboek verhogen (debug)
• Log naar standaarduitvoer (logs naar de console)
• Logboek naar bestand (logboeken naar logboekbestand)
• Optioneel: Wijzig de locatie van de logboekmap. Als dit niet wordt gewijzigd, wordt de logboekuitvoer gelogd bij C:\Users\USER-NAME\.config\icedtea-web\log.

5. Klik op 'Pas toe' en vervolgens op 'OK'.

Deze aanpak is handig wanneer u de Java-logboekconsole niet hoeft te openen, maar gebeurtenissen wilt vastleggen in een logboekbestand. Dit is handig voor terugkerende problemen of problemen die niet gemakkelijk op aanvraag kunnen worden gereproduceerd.

1. Open op de NetWorker Management Console (NMC) server het pictogram gconsole.jnlp bestand in een teksteditor.

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

2. In de application-desc Voeg de volgende opties toe:

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

Voorbeeld:

<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. Download op de host die wordt gebruikt om toegang te krijgen tot de NMC een nieuwe gconsole.jnlp Vanuit een WE-browser: https://NMC_SERVER_ADDRESS:9000/gconsole.jnlp
4. Start de NMC met behulp van de nieuwe gconsole.jnlp bestand.
5. Het java1.log wordt gemaakt op de host die toegang heeft tot de NMC:
   

1. Schakel debug voor Java Console of Java-logboekbestand in volgens de bovenstaande secties.
2. Start de NetWorker Management Console's (NMC) gconsole.jnlp bestand.
3. Meld u aan bij de NMC.
4. Vanuit het venster Enterprise, CTRL+SHIFT+Right-Click
5. Klik op Save Debug Messages... en geef een uitvoerlocatie op.

6. In het Enterprise-venster, opnieuw
7. Selecteer in Set Debug Level het gewenste debug-niveau. Meestal, 7

8. Voer acties uit binnen NMC waarvoor debug is vereist. Kopieer de uitvoer van de Java Console-sessie en verzamel het Java-uitvoerbestand dat in stap 5 is gemaakt.
9. Als u foutopsporing wilt uitschakelen, herhaalt u het proces, maar stelt u foutopsporing uit.

Java-logboekregistratie inschakelen Optie twee

NRE-foutopsporing kan worden geconfigureerd in de NRE C:\Program Files\NRE\logs\logConfig.properties bestand. Het standaard foutopsporingsniveau voor logboeken is WAARSCHUWING.

De ondersteunde logboekniveaus van laag naar hoog zijn:

OFF
SEVERE
WARNING
INFO
CONFIG
FINE
FINER
FINEST
ALL

1. Open Windows Verkenner en ga naar "C:\Program Files\OpenWebStart"
2. Openen: itw-settings.exe (OpenWebStart-console).
3. Ga naar Cache
4. Gebruik een van de volgende opties om alle bestanden te verwijderen (opschonen) of verwijder de bestanden voor een specifieke NMC serververbinding.

Optie één: Klik op View Files. Klik op Opschonen om alle Java-cachebestanden te verwijderen:

Optie twee: Klik in CacheViewer op Opschonen per app. Selecteer de NMC gconsole.jnlp voor een specifieke NMC server klikt u op Delete Files.

De NetWorker Management Console (NMC) gebruikt een Java-runtime op de host die toegang heeft tot de console. De console gebruikt het bestand gconsole.jnlp, die het downloadt van de NMC server. Mogelijk ziet u de fout "onvoldoende geheugen" of "Java heap space" in de NMC. De NMC heap-limiet is de toegewezen geheugenlimiet; Dat gezegd hebbende, kunnen deze fouten optreden, ook al heeft de host die toegang heeft tot de NMC nog steeds voldoende geheugen beschikbaar. Dit is normaal gedrag bij het uitvoeren van bepaalde bewerkingen in de NMC, met name in grotere omgevingen of omgevingen met veel data. 

1. Open een opdrachtprompt voor beheerders of PowerShell.
2. Wijzig de directory in uw NetWorker Runtime Environment (NRE) Java bin-directory. Bijvoorbeeld:

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. Verkrijg de proces-ID (PID) van de java.exe proces geassocieerd met 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

Het bovenstaande jmcd Opdrachten moeten mogelijk met tussenpozen of naast NMC heap-fouten worden uitgevoerd om heap-condities te observeren. Het kan ook nodig zijn om de heap-condities met vaste tussenpozen te scripten en te bewaken om consistente patronen waar te nemen.