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
logger.UpdateSecurityLabelsReport.level = info
logger.UpdateSecurityLabelsReport.additivity = true
5. [선택 사항] 원하는 대로 수준을 설정하고 위 표에 설명된 대로 부가성을 제어합니다.
logger.UpdateSecurityLabelsReport.level = trace
logger.UpdateSecurityLabelsReport.additivity = false
logger.UpdateSecurityLabelsReport.additivity = false
6. 저장하고 닫습니다.
7. windchill 셸에서 다음 명령을 실행하여 업데이트된 파일을 설치 디렉토리로 복사합니다.
ant -f bin/swmaint.xml installSiteChanges
8. Windchill 메소드 서버를 다시 시작합니다.