configUtility 명령
configUtility 명령을 사용하면 Liberty Repository에서 구성 스니펫을 다운로드할 수 있습니다. 이 명령을 사용하면 구성 스니펫 변수를 입력 값으로 바꿀 수도 있습니다. Liberty Repository 구성 스니펫은 특정 태스크에 대한 Liberty 서버 구성의 샘플입니다.
Liberty Repository의 액세스 및 사용에 대한 정보는 Liberty Repository의 내용을 참조하십시오.
구문
명령 구문은 다음과 같습니다.
configUtility action | configUtility configSnippet [options]
여기서 action은
다음 값 중 하나가 될 수 있습니다.
- find
- 저장소에 있는 모든 구성 스니펫의 목록을 표시합니다.
설명에 지정된 문자열이 있는 구성 스니펫으로 목록을 필터링하기 위한 문자열을 지정하십시오. 공백을 포함하는 문자열은 큰따옴표로 묶으십시오.
- help
- 지정된 조치에 대한 도움말 정보를 표시합니다.
- install
- 저장소에서 구성 스니펫을 다운로드하거나 변수 대체를 위해 로컬 구성 스니펫을 사용합니다.
configSnippet 변수는 구성 스니펫의 이름입니다. configUtility find 명령을 실행하여 저장소에 있는 구성 스니펫의 이름을 가져오십시오.
옵션
configUtility install configSnippet
명령에 대해 다음과 같은 옵션을 사용할 수 있습니다.
- --info
- 구성 스니펫의 모든 변수 옵션을 나열합니다. 구성 스니펫에 대체를 위한 변수가 없는 경우 비어 있는 목록을 리턴합니다.
- --v[variable]=value
- --info 옵션에 의해 발견된 구성 스니펫 변수를 입력 값으로 바꿉니다. 이 유틸리티는 --v[variable]을 사용하여 이 변수를 식별합니다. 대괄호([])를 명령에 포함하지 마십시오.
- --createConfigFile=path
- 선택사항입니다. 이 유틸리티는 콘솔 화면 대신 path에 의해 지정된 파일에 코드 스니펫을 작성합니다. 제공되는 코드 스니펫을 server.xml 구성에 추가하여 지정된 파일을 포함하십시오.
- --encoding=[xor|aes]
- 선택사항입니다. 키 저장소 비밀번호 인코딩을 지정합니다. 지원되는 인코딩은 xor과 aes입니다. 기본 인코딩은 xor입니다.
- --key=key
- 선택사항입니다. AES를 사용하여 인코드할 때 사용할 키를 지정합니다. 이 문자열은 비밀번호를 암호화하고 복호화하는 데 사용되는 암호화 키를 생성하기 위해 해시됩니다. 선택사항으로, 값이 해당 키인 wlp.password.encryption.key 변수를 정의하여 서버에 해당 키를 제공하십시오. 이 옵션이 제공되지 않은 경우, 기본 키가 사용됩니다.
- --useLocalFile=file
- 로컬 파일 시스템의 구성 스니펫을 사용합니다. 파일 경로를 지정해야 합니다. 이 옵션은 구성 스니펫 이름 지정을 대체합니다.
사용법
다음 예제는 올바른 구문을 보여줍니다.
configUtility find
configUtility find filter_string
configUtility find "filter string"
configUtility help
configUtility install configSnippet
configUtility install configSnippet --info
configUtility install configSnippet --vvariable=value
configUtility install configSnippet --createConfigFile=C:/wlp/usr/servers/server1/snippet-include.xml
configUtility install configSnippet --encoding=aes --key=myAESkey
configUtility install --useLocalFile=C:/wlp_temp/mySnippet.xml
팁: 옵션 값에 공백이 포함된 경우에는
큰따옴표(")로 옵션 값을 묶어야 합니다. 예를 들어, --createConfigFile
옵션의 파일 경로가 C:\Program Files\mySnipets\snippet-include.xml인 경우
명령에서 --createConfigFile="C:/Program Files/mySnipets/snippet-include.xml"을
지정하십시오.
경고:
서로 다른 운영 체제는 일부 문자를
다르게 처리합니다. Windows 환경의 경우에는
입력 문자열에 !가 포함되어 있으면 ^ 문자로
이를 이스케이프 처리해야 합니다. 예를 들면 다음과 같습니다.
D:\Liberty\images\855\Liberty855\wlp\bin>configUtility createConfigFile="a^!"