전문 관리 > 데이터 보안 확인 > 보안 레이블 및 계약 > 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
선택 사항.
이 등록 정보를 설정하여 지정된 값으로 설정하는 대신 일부 보안 레이블 값을 변경하지 않고 그대로 두기 위해 사용할 문자열을 지정합니다.
* 
구성된 보안 레이블에 유효한 보안 레이블 값이 아닌 값으로 문자열을 설정합니다. 사용자 정의 보안 레이블의 경우 빈 문자열이 포함됩니다. 보안 레이블 값과 일치하는 값으로 등록 정보를 설정하면 값이 변경되지 않습니다.
기본적으로 이 특성은 설정되지 않습니다.
wt.access.UpdateSecurityLabelsReport.file
필수 사항입니다.
UpdateSecurityLabels 명령줄 유틸리티를 실행할 때 이 등록 정보를 설정하여 출력 파일의 이름과 위치를 지정합니다. 출력 파일은 탭으로 구분된 값(TSV) 파일입니다. 각 출력 파일이 고유한 파일 이름을 갖도록 하려면 Java 가상 시스템 식별자 (%jid), 스레드 식별자 (%tid) 또는 시간(밀리초) (%time), 또는 3개 값 모두를 파일 이름에 추가합니다.
기본적으로 이 등록 정보는 Windchill 로그 디렉터리에 출력 파일을 생성하도록 설정되어 있습니다. 기본값은 wt.access.UpdateSecurityLabelsReport.file=$(wt.logs.dir)$(dir.sep)CLT_Report-%time-%jid-%tid.tsv입니다.
wt.access.UpdateSecurityLabelsReport.maximumFileSize
선택 사항.
이 등록 정보를 설정하여 출력 파일의 최대 파일 크기(바이트)를 확인합니다. 등록 정보 값을 문자열 형식으로 지정합니다(예: 10MB, 15KB, 1GB).
기본적으로 이 등록 정보는 10MB로 설정됩니다. 파일 크기가 분계점 값을 초과하면 파일 이름에 '_x' 접미사가 추가된 새 출력 파일이 생성됩니다. 여기서 'x'는 파일 번호입니다.
wt.access.UpdateSecurityLabelsReport.maxNoOfFiles
선택 사항.
이 등록 정보를 설정하여 롤오버 중 유지할 출력 파일의 최대 수를 지정합니다. 생성된 출력 파일의 수가 지정된 제한에 도달하면 파일 이름에 '_x' 접미사가 추가된 새 출력 파일이 생성됩니다. 여기서 'x'는 파일 번호입니다.
기본적으로 이 등록 정보는 파일 10개로 설정되어 있습니다.
등록 정보 설정에 대한 자세한 내용은 Using the xconfmanager Utility를 참조하십시오.
log4jMethodServer.properties
다음 표에는 log4jMethodServer.properties 파일에서 기본으로 사용할 수 있는 등록 정보가 나와 있습니다.
등록 정보
설명
logger.UpdateSecurityLabelsReport.additivity
선택 사항.
이 등록 정보를 설정하여 출력 파일 외에 메소드 서버 로그에 정보를 쓸지 여부를 지정합니다.
기본적으로 이 등록 정보는 True로 설정되어 있습니다.
logger.UpdateSecurityLabelsReport.level
필수 사항입니다.
이 등록 정보를 설정하여 출력 파일에 포함된 세부내용 레벨을 결정합니다. 다음 값을 사용할 수 있습니다.
trace: 입력 파일 위치, 요약 라인 및 처리된 각 객체의 상태를 표시합니다.
info: 입력 파일 위치, 요약 라인, 개별 객체에 대해 발생한 실패 또는 오류를 표시합니다.
error: 입력 파일 위치, 개별 객체에 대해 발생한 실패 또는 오류를 표시합니다.
기본적으로 이 등록 정보는 info로 설정되어 있습니다.
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. log4jMethodServer.properties 파일에서 UpdateSecurityLabels에 대한 로거 구성은 기본적으로 명령줄 유틸리티에 다음과 같이 정의되어 있습니다.
logger.UpdateSecurityLabelsReport.name = wt.access.UpdateSecurityLabelsReport
logger.UpdateSecurityLabelsReport.level = info
logger.UpdateSecurityLabelsReport.additivity = true
5. [선택 사항] 원하는 대로 수준을 설정하고 위 표에 설명된 대로 부가성을 제어합니다.
logger.UpdateSecurityLabelsReport.level = trace
logger.UpdateSecurityLabelsReport.additivity = false
6. 저장하고 닫습니다.
7. windchill 셸에서 다음 명령을 실행하여 업데이트된 파일을 설치 디렉토리로 복사합니다.
ant -f bin/swmaint.xml installSiteChanges
8. Windchill 메소드 서버를 다시 시작합니다.