Konfiguration für die Ausführung des Befehlszeilen-Dienstprogramms "UpdateSecurityLabels"
Vor der Ausführung des Befehlszeilen-Dienstprogramms UpdateSecurityLabels müssen einige Entscheidungen bezüglich der Eigenschaftenkonfiguration getroffen werden. Die folgenden Eigenschaften können festgelegt werden, um anzugeben, welche Benutzer das Dienstprogramm ausführen, die Ausführung konfigurieren, die Leistung optimieren und andere Aufgaben ausführen können.
 |
Durch die Aktivierung des Prüfereignisses "Sicherheitsbeschriftungen ändern" wird die Laufzeit für das UpdateSecurityLabels-Befehlszeilen-Dienstprogramm erheblich erhöht. Weitere Informationen finden Sie unter Sicherheitsbeschriftung-ändern-Ereignis für Prüfung aktivieren.
|
wt.properties
In der folgenden Tabelle sind die Eigenschaften in der Datei wt.properties aufgeführt:
|
Eigenschaft
|
Beschreibung
|
||
|---|---|---|---|
|
wt.access.UpdateSecurityLabels.authorizedParticipant
|
Optional, aber zum Einschränken des Zugriffs empfohlen.
Legen Sie in der Datenbank für diese Eigenschaft die UFID des autorisierten Benutzers im LDAP, der autorisierten benutzerdefinierten Gruppe oder der autorisierten Organisation fest, die zum Ausführen des Befehlszeilen-Dienstprogramms UpdateSecurityLabels berechtigt sind.
Standardmäßig ist diese Eigenschaft auf die Gruppe der Standort-Administratoren festgelegt.
|
||
|
wt.access.UpdateSecurityLabels.chunkSize
|
Optional.
Legen Sie diese Eigenschaf fest, um der höchste Anzahl von Objekte anzugeben, die in ein Segment aktualisiert werden, bevor ein anderes Segment beginnt. Durch diese Eigenschaft kann die Leistung bei der Arbeit mit einer großen Anzahl von Aktualisierungen verbessert werden. Wenn Sie beispielsweise das Dienstprogramm für 100.000 Objekte ausführen, können Sie als Segmentgröße 5000 festlegen und 20 Segmente verarbeiten. Wenn ein Fehler in einem der Segmente auftritt, muss nur dieses Segment erneut verarbeitet werden. Alle anderen, erfolgreichen Segmente können fortgesetzt werden.
Standardmäßig ist diese Eigenschaft auf 1000 eingestellt.
|
||
|
wt.access.UpdateSecurityLabels.noChangeValue
|
Optional.
Legen Sie diese Eigenschaft fest, um die Zeichenfolge anzugeben, durch die bestimmte Sicherheitsbeschriftungswerte unverändert bleiben, anstatt sie auf einen angegebenen Wert einzustellen.
Standardmäßig ist diese Eigenschaft nicht festgelegt.
|
||
|
wt.access.UpdateSecurityLabelsReport.file
|
Erforderlich.
Legen Sie diese Eigenschaft fest, um den Namen und den Speicherort der Ausgabedatei anzugeben, wenn das Befehlszeilendienstprogramm UpdateSecurityLabels ausgeführt wird. Die Ausgabedatei ist eine TSV-Datei mit per Tabulator getrennten Werten. Setzen Sie an das Ende des Dateinamens die Java Virtual Machine-ID (%jid) oder die Thread-ID (%tid) oder die Zeit in Millisekunden (%time) oder alle drei Werte, um sicherzustellen, dass jede Ausgabedatei einen eindeutigen Dateinamen hat.
Standardmäßig ist die Eigenschaft so festgelegt, dass die Ausgabedatei im Windchill Protokollverzeichnis generiert wird. Der Standardwert ist wt.access.UpdateSecurityLabelsReport.file=$(wt.logs.dir)$(dir.sep)CLT_Report-%time-%jid-%tid.tsv
|
||
|
wt.access.UpdateSecurityLabelsReport.maximumFileSize
|
Optional.
Legen Sie diese Eigenschaft fest, um die maximale Dateigröße (in Byte) für die Ausgabedatei anzugeben. Legen Sie den Eigenschaftswert in einem Zeichenfolgenformat fest, z.B. "10MB", "15KB", "1GB".
Standardmäßig ist die Eigenschaft auf "10MB" festgelegt. Wenn die Dateigröße den Schwellenwert überschreitet, wird eine neue Ausgabedatei mit dem Suffix "_x" im Dateinamen generiert, wobei "x" die Dateinummer ist.
|
||
|
wt.access.UpdateSecurityLabelsReport.maxNoOfFiles
|
Optional.
Legen Sie diese Eigenschaft fest, um die maximale Anzahl von Ausgabedateien anzugeben, die während des Rollovers beibehalten werden sollen. Wenn die Anzahl von generierten Ausgabedateien den festgelegten Grenzwert erreicht, wird eine neue Ausgabedatei mit dem Suffix "_x" im Dateinamen generiert, wobei "x" die Dateinummer ist.
Standardmäßig ist diese Eigenschaft auf 10 Dateien festgelegt.
|
Weitere Informationen zum Festlegen von Eigenschaften finden Sie unter xconfmanager-Dienstprogramm verwenden.
log4jMethodServer.properties
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die standardmäßig in der Datei log4jMethodServer.properties verfügbar sind:
|
Eigenschaft
|
Beschreibung
|
|---|---|
|
logger.UpdateSecurityLabelsReport.additivity
|
Optional.
Legen Sie diese Eigenschaf fest, um anzugeben, ob die Informationen zusätzlich zur Ausgabedatei auch in das Methodenserverprotokoll geschrieben werden sollen.
Standardmäßig ist diese Eigenschaft auf True eingestellt.
|
|
logger.UpdateSecurityLabelsReport.level
|
Erforderlich.
Legen Sie diese Eigenschaf fest, um den Detaillierungsgrad der Ausgabedatei anzugeben. Die folgenden Werte sind verfügbar:
• trace: Zeigt den Speicherort der Eingabedatei, eine Zusammenfassungszeile und einen Status für jedes verarbeitete Objekt an.
• info: Zeigt den Speicherort der Eingabedatei, eine Zusammenfassungszeile und alle Ausfälle oder Fehler an, die für einzelne Objekte aufgetreten sind.
• error: Zeigt den Speicherort der Eingabedatei und alle Ausfälle oder Fehler an, die für einzelne Objekte aufgetreten sind.
Standardmäßig ist diese Eigenschaft auf info eingestellt.
|
Führen Sie zum Festlegen der Eigenschaften in der Datei log4jMethodServer.properties die folgenden Schritte aus:
1. Navigieren Sie zu folgender Quelldatei: <Windchill>/codebase/WEB-INF/log4jMethodServer.properties.
2. Kopieren Sie die Datei log4jMethodServer.properties in die folgenden Speicherorte:
<Windchill>/wtSafeArea/siteMod/codebase/WEB-INF
und
<Windchill>/wtSafeArea/ptcOrig/codebase/WEB-INF
3. Öffnen Sie die Datei <Windchill>/wtSafeArea/siteMod/codebase/WEB-INF/log4jMethodServer.properties in einem Texteditor.
4. In der Datei log4jMethodServer.properties ist die Logger-Konfiguration für UpdateSecurityLabels im Befehlszeilendienstprogramm standardmäßig wie folgt definiert:
logger.UpdateSecurityLabelsReport.name = wt.access.UpdateSecurityLabelsReport
logger.UpdateSecurityLabelsReport.level = info
logger.UpdateSecurityLabelsReport.additivity = true
logger.UpdateSecurityLabelsReport.level = info
logger.UpdateSecurityLabelsReport.additivity = true
5. Optional: Legen Sie die Ebene nach Bedarf fest, und steuern Sie die Additivität wie in der obigen Tabelle beschrieben:
logger.UpdateSecurityLabelsReport.level = trace
logger.UpdateSecurityLabelsReport.additivity = false
logger.UpdateSecurityLabelsReport.additivity = false
6. Speichern und schließen Sie die Datei.
7. Führen Sie in einer Windchill Shell den folgenden Befehl aus, um die aktualisierten Dateien in das Installationsverzeichnis zu kopieren:
ant -f bin/swmaint.xml installSiteChanges
8. Starten Sie den Windchill Methodenserver neu.