Amministrazione avanzata > Protezione dei dati > Etichette di sicurezza e accordi > Utilizzo dell'utilità della riga di comando UpdateSecurityLabels > Configurazione per l'esecuzione dell'utilità della riga di comando UpdateSecurityLabels
  
Configurazione per l'esecuzione dell'utilità della riga di comando UpdateSecurityLabels
Prima di eseguire l'utilità della riga di comando UpdateSecurityLabels, è necessario intraprendere alcune decisioni di configurazione delle proprietà. Le proprietà riportate di seguito possono essere impostate per stabilire gli utenti che possono eseguire l'utilità, la modalità di esecuzione, per migliorare le prestazioni e così via.
* 
L'attivazione dell'evento di verifica Modifica etichette di sicurezza determina un aumento significativo del runtime dell'utilità da riga di comando UpdateSecurityLabels. Per ulteriori informazioni, vedere Attivare gli eventi delle etichette di sicurezza per la verifica.
wt.properties
Nella tabella riportata di seguito vengono elencate le proprietà disponibili nel file wt.properties:
Proprietà
Descrizione
wt.access.UpdateSecurityLabels.authorizedParticipant
Facoltativa, ma consigliata per limitare l'accesso
Impostare questa proprietà nell'UFID utente, nel gruppo o nell'organizzazione definita dall'utente autorizzata a eseguire l'utilità.
Per default, questa proprietà è impostata sul gruppo Amministratori sito.
wt.access.UpdateSecurityLabels.chunkSize
Facoltativo
Impostare questa proprietà per indicare il numero massimo di oggetti che viene aggiornato in un blocco prima di iniziare un nuovo blocco. L'impostazione di questa proprietà può migliorare le prestazioni nel caso di un numero elevato di aggiornamenti. Ad esempio, se si esegue l'utilità per 100.000 oggetti, è possibile impostare la dimensione del blocco su 5000 per l'elaborazione di 20 blocchi. In caso di errore in uno dei blocchi, sarà necessario elaborare nuovamente solo il blocco in questione, mentre tutti gli altri potranno procedere.
Per default, questa proprietà è impostata su 1000.
wt.access.UpdateSecurityLabels.noChangeValue
Facoltativo
Impostare questa proprietà per indicare la stringa da utilizzare per lasciare invariati alcuni valori delle etichette di sicurezza, anziché impostare un valore specifico.
* 
Impostare la stringa su un valore che non corrisponde a un valore di etichetta di sicurezza valido per le etichette di sicurezza configurate. Ad esempio, per le etichette di sicurezza personalizzate una stringa vuota. Se si imposta la proprietà su un valore che corrisponde a qualsiasi valore di etichetta di sicurezza, il valore non viene modificato.
Per default, questa proprietà non è impostata.
Per ulteriori informazioni sull'impostazione delle proprietà, vedere Utilizzo dell'utilità xconfmanager.
log4jMethodServer.properties
Nella tabella riportata di seguito vengono elencate le proprietà da impostare nel file log4jMethodServer.properties:
Proprietà
Descrizione
log4j.appender.UpdateSecurityLabelsReport
Obbligatorio
Questa proprietà deve essere impostata su wt.access.UpdateSLsReportAppender. La proprietà definisce il formato del file di output generato dall'utilità.
log4j.appender.UpdateSecurityLabelsReport.File
Obbligatorio
Dopo aver eseguito l'utilità della riga di comando UpdateSecurityLabels, viene generato un file di output con un tipo di file TSV. Questa proprietà determina la posizione in cui il file viene salvato e il nome file. Il nome file può essere aggiunto con identificatore Java Virtual Machine (%jid), identificatore di thread (%tid) e tempo in millisecondi (%time). PTC consiglia di aggiungere almeno uno di questi valori affinché ciascun file di output disponga di un nome file univoco.
log4j.appender.UpdateSecurityLabelsReport.MaximumNumberOfRecords
Facoltativo
Impostare questa proprietà per indicare il numero massimo di record che è possibile visualizzare nel file di output. Al raggiungimento di tale numero, il file di output viene rinominato con un suffisso "_x", dove "x" rappresenta il numero di file, e viene creato un nuovo file di output. Ad esempio, se la proprietà è impostata su 60 e sono disponibili 100 record, vengono generati due file, Report_1 con 60 record e Report con 40.
Se questa proprietà non è impostata, il valore di default sarà 20000.
log4j.appender.UpdateSecurityLabelsReport.MaximumFileSizeInBytes
Facoltativo
Impostare questa proprietà per indicare la dimensione file massima in byte per il file di output. Al raggiungimento di tale valore, viene generato un nuovo file di output con un suffisso "_x", dove "x" rappresenta il numero di file.
Se questa proprietà non è impostata, il valore di default sarà 10 MB.
log4j.additivity.wt.access.UpdateSecurityLabelsReport
Facoltativo
Impostare questa proprietà per stabilire se le informazioni vengono scritte nel log del method server oltre che nel file di output.
Per default, questa proprietà è impostata su True.
log4j.logger.wt.access.UpdateSecurityLabelsReport
Obbligatorio
Impostare questa proprietà per determinare il livello di dettaglio incluso nel file di output. Sono disponibili i valori riportati di seguito.
• TRACE: visualizza la posizione del file di input, una riga di sintesi e uno stato per ciascun oggetto elaborato
• INFO: visualizza la posizione del file di input, una riga di sintesi e gli eventuali errori che si verificano per i singoli oggetti
• ERROR: visualizza la posizione del file di input e gli eventuali errori che si verificano per i singoli oggetti
Per impostare le proprietà nel file log4jMethodServer.properties, attenersi alla procedura descritta di seguito.
1. Passare al seguente file di origine: <Windchill>/codebase/WEB-INF/log4jMethodServer.properties
2. Copiare il file log4jMethodServer.properties nelle posizioni riportate di seguito:
<Windchill>/wtSafeArea/siteMod/codebase/WEB-INF
e
<Windchill>/wtSafeArea/ptcOrig/codebase/WEB-INF
3. Aprire il file <Windchill>/wtSafeArea/siteMod/codebase/WEB-INF/log4jMethodServer.properties in un editor di testo.
4. Aggiungere le seguenti righe:
log4j.appender.UpdateSecurityLabelsReport=wt.access.UpdateSLsReportAppender
log4j.logger.wt.access.UpdateSecurityLabelsReport=<dettaglio output>,
UpdateSecurityLabelsReport
log4j.appender.UpdateSecurityLabelsReport.File=<percorso file>
dove
◦ <dettaglio output> sarà TRACE, INFO o ERROR a seconda del livello di dettaglio desiderato nel file di output
◦ <percorso file> è il percorso del file di report e include il nome del file del report di output. Facoltativamente, è possibile includere le seguenti variabili nel nome file:
▪ %time per indicare il tempo in millisecondi
▪ %jid per indicare l'identificatore Java Virtual Machine
▪ %tid per indicare l'identificatore di thread
5. [Facoltativo] Aggiungere una o più righe riportate di seguito, in base a quanto previsto dal sito:
log4j.appender.UpdateSecurityLabelsReport.MaximumNumberOfRecords=<numero di record>
log4j.appender.UpdateSecurityLabelsReport.MaximumFileSizeInBytes=<numero in byte>
log4j.additivity.wt.access.UpdateSecurityLabelsReport=<posizione log>
dove:
◦ <numero di record> è il numero totale di record che è possibile visualizzare nel file di output
◦ <numero in byte> è la dimensione file massima in byte per il file di output
◦ <posizione log> è TRUE o FALSE, a seconda che i log vengano scritti o meno nel file di log del method server
Ad esempio, le proprietà possono essere impostate come segue:
log4j.appender.UpdateSecurityLabelsReport=wt.access.UpdateSLsReportAppender
log4j.logger.wt.access.UpdateSecurityLabelsReport=TRACE,UpdateSecurityLabelsReport
log4j.appender.UpdateSecurityLabelsReport.File=${wt.logs.dir}/UpdateSecurityLabels/
Report-%time-%jid-%tid
log4j.appender.UpdateSecurityLabelsReport.MaximumNumberOfRecords=2000
log4j.additivity.wt.access.UpdateSecurityLabelsReport=false
log4j.logger.wt.access.UpdateSecurityLabelsReport=ERROR,UpdateSecurityLabelsReport
Utilizzando questo esempio, il file di output viene creato nella directory <Windchill>/logs/UpdateSecurityLabels e dispone di un nome simile a Report-1389283424223-8344-180.tsv. Il file non supererebbe i 2000 record e le informazioni del report verrebbero scritte solo nel file di report e non nei log del method server.
6. Salvare e chiudere.
7. Da una shell di Windchill, eseguire il seguente comando per copiare i file aggiornati nella directory di installazione:
ant -f bin/swmaint.xml installSiteChanges
8. Riavviare il method server Windchill.