![[8.5.5.6 이상]](../ng_v8556.gif)
installUtility 명령
installUtility 명령을 사용하여 로컬 저장소, 원격 저장소 또는 IBM® WebSphere® Liberty Repository에 있는 자산에 대한 정보를 찾아서 얻고 이 자산을 설치합니다.
구문
명령 구문은 다음과 같습니다.
installUtility action [options]
action 변수는 다음 값 중 하나를
사용할 수 있습니다.
- download
- 저장소에서 자산을 다운로드합니다.
- find
- 구성에 적용할 수 있는 자산을 저장소에서 찾거나 자산에 대한 자세한 정보를 표시합니다.
- help
- 지정된 조치에 대한 도움말 정보를 표시합니다.
- install
- 런타임에 자산 또는 ESA(Enterprise Subsystem Archive) 파일을 설치하거나, 서버 패키지를 배치하고 이 패키지의 필수 기능을 설치합니다.
- testConnection
- 저장소 연결을 테스트합니다.
- uninstall
- 기능의 약칭 또는 기호 이름을 지정하여 기능을 설치 제거합니다. 공백으로 분리된 여러 개의 기능을 지정할 수 있습니다.
- 참고: 기능을 설치 제거하기 전에 모든 서버 프로세스가 중지되었는지 확인하십시오.
- viewSettings
- installUtility 명령에 대한 저장소와 프록시 설정을 표시합니다.
이러한 조치를 사용할 때 installUtility 명령은 다음 저장소에 있는 자산에 액세스할 수 있습니다.
- 인터넷을 통해 액세스 가능한 IBM이 호스팅하는 공용 저장소인 IBM WebSphere Liberty Repository자세한 정보는 Liberty Repository의 내용을 참조하십시오.
- 엔터프라이즈의 방화벽을 통과하여 원격으로 액세스 가능한 사내 구축 저장소를 작성하는 데 사용할 수 있는 개방형 소스 서비스인 Liberty Asset Repository Service. GitHub의 WASdev/tool.lars 저장소를 참조하십시오.
- installUtility download 조치를 사용하여 작성되는 로컬 디렉토리 기반 저장소. 자세한 정보는 installUtility 명령을 사용하여 자산 다운로드의 내용을 참조하십시오.
옵션
다음 옵션은 installUtility install 명령에 사용할 수 있습니다.
- --acceptLicense
- 라이센스 이용 약관에 동의함을 표시합니다.
- --to=install_option
- install_option 옵션은 다음 값 중 하나를 사용할 수 있습니다.
- user: 기능이 사용자 기능으로 설치됩니다. 이 값이 기본값입니다.
- extension: 기능을 설치할 위치입니다. 구성된 제품 확장 위치에 기능을 설치할 수 있습니다.
- --viewLicenseAgreement
- 라이센스 정보를 표시합니다.
- --viewLicenseInfo
- 라이센스 정보를 표시합니다.
- --verbose
- 조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- name
- 설치할 자산을 지정합니다. 자산은 다음 방법으로 지정할 수 있습니다.
- 자산 ID
- 자산 ID를 지정하여 하나 이상의 다음 자산을 설치할 수 있습니다.
- 기능
- 추가 기능
- 개방형 소스 통합
- 샘플
- 서버 이름
- 서버 이름을 사용하여 기존 서버의 누락된 기능을 설치할 수 있습니다. server.xml 파일에 정의된 필수 기능이 저장소로부터 설치됩니다.
- 서버 패키지
- server package --include=usr 명령을 사용하면 작성한 서버 패키지를 지정할 수 있습니다. 이 서버 패키지가 배치되며 server.xml 파일에 정의된 필수 기능이 저장소로부터 설치됩니다.
- .esa 파일
- 로컬 파일 시스템에 있는 .esa 파일로부터 기능을 설치합니다. 이 조치는 새 기능 Manifest로서 .esa 파일의 OSGI-INF/SUBSYTEM.MF Manifest 파일을 사용합니다. Manifest 파일은 기능의 이름, 컨텐츠 및 종속성을 지정합니다. --to 옵션을 지정하면 installUtility는 Manifest 파일을 ${wlp.user.dir}/extensions/lib/features 디렉토리 또는 제품 확장기능 디렉토리로 복사합니다. 서브시스템에 대한 모든 번들이 ${wlp.user.dir}/extensions/lib 디렉토리로 추출되고 {bundle symbolic name}_{bundle version}.jar로 이름이 바뀝니다. 라이센스 파일, 체크섬 파일, 현지화 파일 및 기타 서브시스템 컨텐츠는 서브시스템 Manifest에 정의된 위치로 추출됩니다.
다음 옵션은 installUtility find 명령에 사용할 수 있습니다.
- --showDescriptions
- 검색으로 찾은 각 기능에 대한 설명을 표시합니다.
- --type=[feature|sample|opensource|addon|all*]
- 지정된 자산 유형을 검색합니다.
- --name
- 지정된 searchString에 대해 자산 이름을 검색합니다.
- searchString
- 구성에 적용할 수 있는 자산을 찾습니다.이 명령은 검색 문자열을 지정하지 않으면 해당되는 모든 자산을 검색합니다.
다음 옵션은 installUtility download 명령에 사용할 수 있습니다.
- --acceptLicense
- 라이센스 계약에 동의합니다.
- --viewLicenseAgreement
- 라이센스 정보를 표시합니다.
- --viewLicenseInfo
- 라이센스 정보를 표시합니다.
- --location=directoryPath
- 다운로드되는 자산의 대상 디렉토리를 지정합니다. 이 옵션은 필수입니다.
- --overwrite
- 로컬 디렉토리로 다운로드할 때 기존 파일을 겹쳐쓰려면 이 옵션을 사용하십시오. 이 옵션이 없는 경우 기본 동작은 모든 기존 파일을 무시하는 것입니다.
- --verbose
- 다운로드 중에 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- name
- 하나 이상의 다음 자산을 다운로드하려면 자산 ID를 지정하십시오.
- 기능
- 추가 기능
- 개방형 소스 통합
- 샘플
다음 옵션은 installUtility testConnection 명령에 사용할 수 있습니다.
- repoName
- 테스트할 저장소의 이름을 지정합니다. 이름을 지정하지 않으면 repositories.properties 파일에 지정된 모든 저장소를 테스트합니다.
다음 옵션은 installUtility uninstall 명령에 사용할 수 있습니다.
- --noPrompts
- 프롬프트 없이 기능을 설치 제거합니다. 기본값은 false입니다.
- --verbose
- 설치 제거 중에 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- name
- 설치 제거할 기능을 지정합니다. 다음과 같은 옵션을 지정할 수 있습니다.
- 서브시스템 아카이브(ESA 파일)의 축약 이름(예: adminCenter-1.0)
- 서브시스템 아카이브(ESA 파일)의 기호 이름(예: com.ibm.websphere.appserver.adminCenter-1.0)
사용 예제
install 조치에 대한 도움말 정보를 표시하려면 다음 예제를 사용하십시오.
installUtility help install
사용자 기능을 설치하려면 다음 예를 사용하십시오.
installUtility install my_feature --to=usr
사용자 기능을 my_extension 제품 확장기능 위치에 설치하려면 다음 예를 사용하십시오.
installUtility install my_feature --to=my_extension
여러 기능을 설치 제거하려면 다음 예제를 사용하십시오.
installUtility install feature1 feature2 feature3
샘플을 설치하려면 다음 예제를 사용하십시오.
installUtility install mongoDBSample
서버를 설치하려면 다음 예제를 사용하십시오.
installUtility install myServer
서버 패키지 .jar 압축 파일을 설치하려면 다음 예제를 사용하십시오.
installUtility install c:\temp\myServer.jar
로컬 .esa 파일을 설치하려면 다음 예제를 사용하십시오.
installUtility install c:\temp\myFeature.esa
서버 패키지 압축 파일을 설치하려면 다음 예를 사용하십시오.
installUtility install c:\temp\myServer.zip
구성에 적용할 수 있는 자산을
찾으려면 다음 예를 사용하십시오.
installUtility find searchString
구성에 적용할
수 있는 샘플을 찾으려면 다음 예를 사용하십시오.
installUtility find searchstring --type=sample
구성에 적용할
수 있는 특정 기능을 찾으려면 다음 예를 사용하십시오.
installUtility find webCacheMonitor-1.0 --name --type=feature
자세한 정보를 나열하려면 다음 예를 사용하십시오.
installUtility find searchstring --showDescriptions
저장소에서 로컬 디렉토리로 필요한 종속 항목을 다운로드하려면 다음 예를 사용하십시오.
installUtility download feature_shortName --location=c:\temp\download --acceptLicense
Liberty Repository에 대한 연결을 테스트하려면 다음 예를 사용하십시오.
installUtility testConnection default
기능을 설치 제거하려면 다음 예를 사용하십시오.
installUtility uninstall adminCenter-1.0
여러 기능을 설치 제거하려면 다음 예를 사용하십시오.
installUtility uninstall feature1 feature2 feature3
프롬프트 없이 여러 기능을 설치 제거하려면 다음 예를 사용하십시오.
installUtility uninstall --noPrompts feature1 feature2 feature3
리턴 코드
리턴 코드 | 설명 |
---|---|
0 | 명령이 요청된 조작을 완료했습니다. |
20 | 하나 이상의 인수가 올바르지 않습니다. |
21 | 다음 조건 중 하나 이상의 조건 때문에 런타임
예외가 발생했습니다.
|
22 | 설치하려고 한 기능이 이미 있습니다. |
23 | 다음 이유 중 하나 이상의 이유로 인해 기능 정의가
올바르지 않습니다.
|
24 | .esa 서브시스템 아카이브 파일에 컨텐츠가 누락되었습니다. |
25 | 설치하려고 한 파일이 이미 있습니다. |
26 | 제품이 코어 제품이 아니며 제품 확장 파일을 찾을 수 없습니다. |
27 | 제품이 코어 제품이 아니며 제품 확장이 ${wlp.install.dir}/etc/extensions/extension_name.properties 파일에 정의되어 있지 않습니다. |
28 | 제품 확장에서 기능에 대한 Manifest 파일을 찾을 수 없습니다. |
29 | 현재 제품에 대해 기능이 올바르지 않습니다. |
33 | 저장소 연결에 실패했습니다. |
34 | 저장소 이름을 찾을 수 없습니다. 제공된 저장소 이름이 구성 파일에 없습니다. |
35 | 사용자가 조치를 취소했습니다. |