Prüfsummenfehler auflösen
Die Prüfsummenverifikation gewährleistet die Datenintegrität zwischen dem PTC RV&S Server und dem Client. Prüfsummen werden berechnet und verifiziert, wenn eine neue Mitgliedsrevision im Repository festgeschrieben wird. PTC RV&S verifiziert automatisch die Prüfsumme bei den Operationen "Mitglied hinzufügen" und "Einchecken". Wenn während der Verifizierung keine Fehler gefunden werden, wird die Operation "Mitglied hinzufügen" bzw. "Einchecken" abgeschlossen.
 |
Die Prüfsummenverifikation ist in PTC RV&S Server standardmäßig aktiviert.
|
Werden bei der Verifizierung Prüfsummenfehler gefunden, dann werden die Revisionen nicht in das Repository abgerufen, und es wird eine Warnmeldung angezeigt:
In solchen Fällen versucht die Richtlinie MaxRetriesOnCheckinChecksumMismatch, die Fehler zu beheben und checkt das Mitglied nach der Problemlösung erneut ein. Diese Richtlinie ist standardmäßig aktiviert und auf 0 festgelegt. Wenn es sich bei den Werten um nicht positive Ganzzahlen oder Gleitkommawerte handelt, wird der Standardwert wiederhergestellt. Es wird empfohlen, die Richtlinie auf einen Wert zwischen 1 und 10 festzulegen. Der Wert der Richtlinie bestimmt, wie oft die Richtlinie die Auflösung einer Prüfsummen-Nichtübereinstimmung wiederholt.
Falls die Prüfsummenvalidierung auch nach der angegebenen Zahl an Versuchen fehlschlägt, werden die fehlgeschlagenen Prüfsummen-Mitgliedsdateien an folgendem Ort im PTC RV&S Server Installationsverzeichnis gespeichert:
server/data/failed_checksum
Die Details der Prüfsummenfehler werden in den Dateien server.log und IntegrityClient.log protokolliert.
|
|
Der PTC RV&S Administrator muss regelmäßig alle unerwünschten Dateien aus dem Verzeichnis failed_checksum löschen, um sicherzustellen, dass darin genügend Speicherplatz vorhanden ist.
|
Protokollmeldungen für Prüfsummen-Nichtübereinstimmungen verstehen
Wenn die Prüfsummenanalyse eine Abweichung erkennt, werden in der Datei server.log die folgenden Informationen aufgezeichnet:
• Name des beschädigten Mitglieds
• Projekt mit dem Mitglied sowie den Konfigurationspfad, sofern verfügbar
• Name des Benutzers, der das Mitglied hinzufügt oder eincheckt
• Hostname des PTC RV&S Clients.
Beispiel:
• Client: MKS969178_ChecksumsDoNotMatch=Beim Abrufen der neuen Revision für das Mitglied {1} in Projekt {0} ist eine nicht übereinstimmende Prüfsumme aufgetreten. Wenden Sie sich an Ihren PTC RV&S Administrator. Die Anzahl der Wiederholungsversuche beim Einchecken von Prüfsummen-Nichtübereinstimmungen ist <>. Diese Meldung wird so lange ausgegeben, bis die Anzahl der Wiederholungsversuche den vom Administrator festgelegten Grenzwert erreicht hat.
• Server: MKS970388_CHECKSUM_MISMATCH=Für Benutzer {0} ist ein Prüfsummen-Nichtübereinstimmungsfehler auf dem Client-Host {1} für die neue Revision des Mitglieds {2} in Projekt {3} aufgetreten. Die berechnete Prüfsumme von {4} entspricht nicht der gespeicherten Prüfsumme von {5}. Wenden Sie sich an PTC RV&S Support. Der Speicherort und der Name der Datei lautet {Richtlinienpfad\Mitgliedsdatei}.
So legen Sie die Richtlinie MaxRetriesOnCheckinChecksumMismatch fest
Führen Sie die nachfolgenden Schritte aus, um den Wert für die Richtlinie MaxRetriesOnCheckinChecksumMismatch festzulegen:
1. Starten Sie PTC RV&S Administration Client, erweitern Sie den Knoten Konfigurationsverwaltung, und wählen Sie Richtlinien aus.
2. Wählen Sie Globale Richtlinien aus, klicken Sie mit der rechten Maustaste, und wählen Sie Bearbeiten aus. Das Dialogfeld Globale Richtlinien wird angezeigt.
3. Klicken Sie zum Anzeigen anderer Richtlinien auf die Registerkarte Andere.
4. Geben Sie die gewünschte aufzunehmende Richtlinienoption ein und fügen Sie nur eine Option pro Zeile hinzu. Zum Beispiel MaxRetriesOnCheckinChecksumMismatch=value.
Weitere Informationen zu Optionen für Formatierungsrichtlinien finden Sie unter Formatting Configuration Management Policy Options.
5. Klicken Sie auf OK, um die Änderungen zu übernehmen und den Vorgang zu beenden.