전문 관리 > 데이터 보안 확인 > 보안 레이블 및 계약 > UpdateSecurityLabels 명령줄 유틸리티 사용 > UpdateSecurityLabels 명령줄 유틸리티 실행 구성
  
UpdateSecurityLabels 명령줄 유틸리티 실행 구성
UpdateSecurityLabels 명령줄 유틸리티를 실행하기 전에 일부 등록 정보 구성을 결정해야 합니다. 유틸리티를 실행할 수 있는 사용자 지정, 실행 방법 설정, 성능 개선 등을 위해 다음 등록 정보를 설정할 수 있습니다.
* 
보안 레이블 수정 감사 이벤트를 사용 가능으로 설정하여 UpdateSecurityLabels 명령줄 유틸리티에 대한 실행 시간을 매우 증가시킵니다. 자세한 내용은 감사를 위해 보안 레이블 이벤트 활성화를 참조하십시오.
wt.properties
다음 표에는 wt.properties 파일에 포함된 등록 정보가 나와 있습니다.
등록 정보
설명
wt.access.UpdateSecurityLabels.authorizedParticipant
선택 사항이지만 액세스를 제한하기 위해 권장됩니다.
이 등록 정보를 UpdateSecurityLabels 명령줄 유틸리티를 실행하도록 승인된 LDAP의 승인된 사용자, 사용자 정의 그룹 또는 데이터베이스 내 조직의 UFID로 설정합니다.
기본적으로 이 등록 정보는 사이트 관리자 그룹으로 설정되어 있습니다.
wt.access.UpdateSecurityLabels.chunkSize
선택사항
이 등록 정보를 설정하여 다른 청크를 시작하기 전에 한 청크에서 업데이트되는 최대 객체 수를 지정합니다. 이 등록 정보를 설정하면 다수의 업데이트를 처리할 때 성능을 개선할 수 있습니다. 예를 들어, 100,000개 객체에 대해 유틸리티를 실행하는 경우 청크 크기를 5000개로 설정할 수 있으며 20개 청크가 처리됩니다. 청크 중 하나에서 오류가 발생할 경우 해당 청크만 재처리되고 다른 성공한 청크는 모두 계속할 수 있습니다.
기본적으로 이 등록 정보는 1000으로 설정되어 있습니다.
wt.access.UpdateSecurityLabels.noChangeValue
선택사항
이 등록 정보를 설정하여 지정된 값으로 설정하는 대신 일부 보안 레이블 값을 변경하지 않고 그대로 두기 위해 사용할 문자열을 지정합니다.
* 
구성된 보안 레이블에 유효한 보안 레이블 값이 아닌 값으로 문자열을 설정합니다. 사용자 정의 보안 레이블의 경우 빈 문자열이 포함됩니다. 보안 레이블 값과 일치하는 값으로 등록 정보를 설정하면 값이 변경되지 않습니다.
기본적으로 이 특성은 설정되지 않습니다.
등록 정보 설정에 대한 자세한 내용은 Using the xconfmanager Utility를 참조하십시오.
log4jMethodServer.properties
다음 표에는 log4jMethodServer.properties 파일에서 설정되는 등록 정보가 나와 있습니다.
등록 정보
설명
log4j.appender.UpdateSecurityLabelsReport
필수
이 등록 정보는 wt.access.UpdateSLsReportAppender로 설정해야 합니다. 유틸리티에서 생성되는 출력 파일의 형식을 지정합니다.
log4j.appender.UpdateSecurityLabelsReport.File
필수
UpdateSecurityLabels 명령줄 유틸리티를 실행하면 출력 파일이 TSV 파일 형식으로 생성됩니다. 이 등록 정보는 파일이 저장되는 위치와 파일에 지정되는 이름을 결정합니다. 파일 이름에 JVM(Java Virtual Machine) 식별자(%jid), 스레드 식별자(%tid) 및 시간(밀리초)(%time)을 추가할 수 있습니다. 각 출력 파일에 고유한 파일 이름이 지정되도록 이러한 값을 하나 이상 추가하는 것이 좋습니다.
log4j.appender.UpdateSecurityLabelsReport.MaximumNumberOfRecords
선택사항
이 등록 정보를 설정하여 출력 파일에 표시될 수 있는 최대 레코드 수를 지정합니다. 이 개수에 도달하면 접미사 "_x"(여기서 "x"는 파일 번호임)를 사용하여 출력 파일의 이름이 바뀌고 새 출력 파일이 작성됩니다. 예를 들어, 등록 정보가 60으로 설정되고 100개 레코드가 있는 경우 60개 레코드가 포함된 Report_1과 40개 레코드가 포함된 Report의 두 파일이 생성됩니다.
이 등록 정보를 설정하지 않을 경우 기본적으로 20000으로 설정됩니다.
log4j.appender.UpdateSecurityLabelsReport.MaximumFileSizeInBytes
선택사항
이 등록 정보를 설정하여 출력 파일의 최대 파일 크기(바이트)를 지정합니다. 이 개수에 도달하면 접미사 "_x"(여기서 "x"는 파일 번호임)를 사용하여 새 출력 파일이 생성됩니다.
이 등록 정보를 설정하지 않을 경우 기본적으로 10MB로 설정됩니다.
log4j.additivity.wt.access.UpdateSecurityLabelsReport
선택사항
이 등록 정보를 설정하여 출력 파일 외에 메소드 서버 로그에 정보를 쓸지 여부를 지정합니다.
기본적으로 이 등록 정보는 True로 설정되어 있습니다.
log4j.logger.wt.access.UpdateSecurityLabelsReport
필수
이 등록 정보를 설정하여 출력 파일에 포함된 세부내용 레벨을 결정합니다. 다음 값을 사용할 수 있습니다.
• TRACE: 입력 파일 위치, 요약 라인 및 처리된 각 객체의 상태를 표시합니다.
• INFO: 입력 파일 위치, 요약 라인, 개별 객체에 대해 발생한 실패 또는 오류를 표시합니다.
• ERROR: 입력 파일 위치, 개별 객체에 대해 발생한 실패 또는 오류를 표시합니다.
log4jMethodServer.properties 파일에서 등록 정보를 설정하려면 다음 절차를 따르십시오.
1. 다음 소스 파일로 이동합니다. <Windchill>/codebase/WEB-INF/log4jMethodServer.properties
2. log4jMethodServer.properties 파일을 다음 위치로 복사합니다.
<Windchill>/wtSafeArea/siteMod/codebase/WEB-INF
및
<Windchill>/wtSafeArea/ptcOrig/codebase/WEB-INF
3. 텍스트 편집기에서 <Windchill>/wtSafeArea/siteMod/codebase/WEB-INF/log4jMethodServer.properties 파일을 엽니다.
4. 다음 라인을 추가합니다.
log4j.appender.UpdateSecurityLabelsReport=wt.access.UpdateSLsReportAppender
log4j.logger.wt.access.UpdateSecurityLabelsReport=<output detail>,
UpdateSecurityLabelsReport
log4j.appender.UpdateSecurityLabelsReport.File=<file path>
설명:
◦ <output detail>은 출력 파일에 원하는 세부내용 레벨에 따라 TRACE, INFO 또는 ERROR입니다.
◦ <file path>는 출력 보고서 파일 이름을 비롯한 출력 보고서 파일 경로입니다. 선택적으로, 다음 변수를 파일 이름에 포함할 수 있습니다.
▪ %time - 시간(밀리초)을 나타냅니다.
▪ %jid - JVM(Java Virtual Machine) 식별자를 나타냅니다.
▪ %tid - 스레드 식별자를 나타냅니다.
5. [선택 사항] 사이트에 필요할 경우 다음 줄을 하나 이상 추가합니다.
log4j.appender.UpdateSecurityLabelsReport.MaximumNumberOfRecords=<number of records>
log4j.appender.UpdateSecurityLabelsReport.MaximumFileSizeInBytes=<number in bytes>
log4j.additivity.wt.access.UpdateSecurityLabelsReport=<log location>
설명:
◦ <number of records>는 출력 파일에 표시될 수 있는 총 레코드 수입니다.
◦ <number in bytes>는 출력 파일의 최대 파일 크기(바이트)입니다.
◦ <log location>은 메소드 서버 로그 파일에 로그를 쓰는지 여부에 따라 TRUE 또는 FALSE입니다.
예를 들어, 다음과 같이 등록 정보를 설정할 수 있습니다.
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
이 예제를 사용할 경우 <Windchill>/logs/UpdateSecurityLabels 디렉토리에 출력 파일이 작성되며 Report-1389283424223-8344-180.tsv와 유사한 이름을 갖습니다. 파일은 2000개 레코드를 초과하지 않으며, 보고서 정보가 보고서 파일에만 기록되고 메소드 서버 로그에는 기록되지 않습니다.
6. 저장하고 닫습니다.
7. windchill 셸에서 다음 명령을 실행하여 업데이트된 파일을 설치 디렉토리로 복사합니다.
ant -f bin/swmaint.xml installSiteChanges
8. Windchill 메소드 서버를 다시 시작합니다.