installUtility 명령
installUtility 명령을 사용하여 Liberty Repository 또는 Liberty Asset Repository Service의 인스턴스, 디렉토리 기반 저장소에 있는 자산을 찾고 관련 정보를 가져오며 이를 설치할 수 있습니다.
자산 소스
- 인터넷을 통해 액세스 가능한 공용 IBM® 호스팅 저장소인 Liberty Repository. 자세한 정보는 Liberty Repository의 내용을 참조하십시오.
- 엔터프라이즈의 방화벽 뒤에서 원격으로 액세스 가능한 사내 구축 환경 저장소를 작성하는 데 사용할 수 있는 개방형 소스 서비스인 Liberty Asset Repository Service. 자세한 정보는 GitHub의 WASdev/tool.lars 프로젝트를 참조하십시오.
- installUtility download 조치를 사용하거나 적용되는 모든 기능과 추가 기능이 포함된 wlp-featureRepo-<version>.zip 파일을 다운로드하여 작성되는 로컬 디렉토리 기반 저장소. 추가 정보는 installUtility 명령을 사용하여 자산 다운로드의 내용을 참조하십시오.
installUtility 명령을 사용하여 아카이브를 추출하지 않고 압축된 저장소에서 직접 디렉토리 기반 저장소 자산에 대한 작업을 수행할 수 있습니다(예: wlp-featureRepo-<version>.zip). wlp-featureRepo-<version>.zip 파일에 대한 자세한 정보는 installUtility 명령을 사용하여 자산 다운로드의 내용을 참조하십시오.
구문
명령 구문은 다음과 같습니다.
installUtility action [options]
- download
- 저장소에서 자산을 다운로드합니다.
- find
- 구성에 적용할 수 있는 자산을 저장소에서 찾거나 자산에 대한 자세한 정보를 표시합니다.
- install
- 런타임에 자산 또는 ESA(Enterprise Subsystem Archive) 파일을 설치하거나, 서버 패키지를 배치하고 이 패키지의 필수 기능을 설치합니다.
- testConnection
- 저장소 연결을 테스트합니다.
- uninstall
- 기능의 약칭 또는 기호 이름을 지정하여 기능을 설치 제거합니다. 공백으로 분리하여 다수의 기능을 지정할 수 있습니다.
- 참고: 기능을 설치 제거하기 전에 모든 서버 프로세스가 중지되었는지 확인하십시오.
- viewSettings
- 저장소 또는 프록시를 구성하기 위한 템플리트를 보거나, 구성된 저장소 또는 프록시에 대한 설정을 보고 유효성을 검증합니다.
- help
- 지정된 조치에 대한 도움말 정보를 표시합니다.
옵션
- --acceptLicense
- 라이센스 계약에 동의합니다.
- --viewLicenseAgreement
- 라이센스 계약을 표시합니다.
- --viewLicenseInfo
- 라이센스 계약을 표시합니다.
- --location=directoryPath
- 다운로드되는 자산의 대상 디렉토리를 지정합니다. 이 옵션은 필수입니다.
- --overwrite
- 로컬 디렉토리에 다운로드할 때 기존 파일을 겹쳐쓰려면 이 옵션을 사용하십시오. 이 옵션이 없는 경우 기본 동작은 모든 기존 파일을 무시하는 것입니다.
- --verbose
- 다운로드 중에 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- 이름
- 하나 이상의 다음 자산을 다운로드하기 위한 자산 ID를 지정합니다(다수의 자산 ID는 공백으로 분리함).
- 기능
- 추가 기능
- 개방형 소스 통합
- 샘플
- --from
- installUtility 명령에 대한 자산의 소스로서 단일 디렉토리 기반 저장소를 지정합니다.
디렉토리 기반 저장소는 압축되지 않은 폴더 또는 압축된 아카이브 파일일 수 있습니다.
다중 디렉토리 기반 저장소에서 자산을 검색하려면 repositories.properties 파일에서 저장소를 구성해야 합니다. 추가 정보는 installUtility 명령에 대한 저장소와 프록시 설정 구성의 내용을 참조하십시오.
- --showDescriptions
- 검색으로 찾은 각 기능에 대한 설명을 표시합니다.
- --type=[feature|sample|opensource|addon|all*]
- 지정된 자산 유형을 검색합니다.
- --name
- 지정된 searchString에 대해 자산 이름을 검색합니다.
- --verbose
- 조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- searchString
- 구성에 적용할 수 있는 자산을 찾습니다.이 명령은 검색 문자열을 지정하지 않으면 해당되는 모든 자산을 검색합니다.
- --to=install_option
- install_option 옵션은 다음 값 중 하나를 사용할 수 있습니다.
- usr: 기능이 사용자 기능으로 설치됩니다. 이 값이 기본값입니다.
- extension: 기능을 설치할 위치입니다. 구성된 제품 확장 위치에 기능을 설치할 수 있습니다.
- --from
- installUtility 명령에 대한 자산의 소스로서 단일 디렉토리 기반 저장소를 지정합니다.
디렉토리 기반 저장소는 압축되지 않은 폴더 또는 압축된 아카이브 파일일 수 있습니다.
다중 디렉토리 기반 저장소에서 자산을 설치하려면 repositories.properties 파일에서 저장소를 구성해야 합니다. 추가 정보는 installUtility 명령에 대한 저장소와 프록시 설정 구성의 내용을 참조하십시오.
- --acceptLicense
- 라이센스 이용 약관에 동의함을 표시합니다.
- --viewLicenseAgreement
- 라이센스 계약을 표시합니다.
- --viewLicenseInfo
- 라이센스 정보를 표시합니다.
- --verbose
- 조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- 이름
- 설치할 하나 이상의 자산을 지정하십시오. 자산은 다음 방법으로 지정할 수 있습니다.
- 자산 ID
- 하나 이상의 다음 자산을 설치하기 위한 자산 ID를 지정할 수 있습니다(다수의 자산 ID는 공백으로 분리함).
- 기능
- 추가 기능
- 개방형 소스 통합
- 샘플
- 서버 이름
- 서버 이름을 지정함으로써 동일한 Liberty 환경에서 기존 서버를 기반으로 기능을 설치할 수 있습니다. 이 명령은 아직 Liberty 환경에 설치되지 않은 해당 서버의 server.xml 파일에 정의된 적용 가능한 기능을 설치합니다.
- 서버 패키지
- server package --include=usr 명령을 사용하면 작성한 서버 패키지를 지정할 수 있습니다. 이 서버 패키지가 배치되며 server.xml 파일에 정의된 필수 기능이 저장소로부터 설치됩니다.
- server.xml 파일
- 서버 구성 파일을 기반으로 기능을 설치하기 위해 로컬 server.xml 파일에 대한 경로를 지정할 수 있습니다(예: C:\localDir\server.xml). 이 명령은 아직 Liberty 환경에 설치되지 않은 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에서 정의된 위치로 추출됩니다.
- repoName
- 테스트할 저장소의 이름을 지정합니다. 이름을 지정하지 않으면 repositories.properties 파일에 지정된 모든 저장소를 테스트합니다.
- --force
- 기타 설치된 기능이 이에 종속되는지 여부와 무관하게 지정된 기능을 설치 제거합니다. 참고: 기타 설치된 기능에서 요구하는 기능을 설치 제거하면 해당 기능의 작동이 중지될 수 있으며 서버가 올바르게 실행되지 못하도록 할 수 있습니다.
- --noPrompts
- 프롬프트 없이 기능을 설치 제거합니다. 기본값은 false입니다.
- --verbose
- 설치 제거 중에 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- 이름
- 공백으로 여러 이름을 분리하여, 설치 제거할 하나 이상의 기능을 지정하십시오. 다음과 같은 옵션을 지정할 수 있습니다.
- 서브시스템 아카이브(ESA 파일)의 축약 이름(예: adminCenter-1.0)
- 서브시스템 아카이브(ESA 파일)의 기호 이름(예: com.ibm.websphere.appserver.adminCenter-1.0)
콜론이 뒤에 붙는 확장자로 기능 이름의 접두부를 지정함으로써(예: usr:webCacheMonitor-1.0), 사용자 기능 및 제품 확장기능을 설치 제거할 수 있습니다.
- --viewValidationMessages
- 이 옵션을 사용하여 구성된 repositories.properties 파일의 유효성 검증으로부터 세부사항 메시지를 표시할 수 있습니다. 각 메시지에는 오류 코드, 오류가 발견된 행 번호 및 오류의 원인이 포함되어 있습니다.
사용 예제
installUtility help install
installUtility install my_feature --to=usr
installUtility install my_feature --to=my_extension
installUtility install feature1 feature2 feature3
installUtility install mongoDBSample
installUtility install ndMemberBundle --from=c:\download\wlp-featureRepo-16.0.0.2
installUtility install ndMemberBundle --from=c:\download\wlp-featureRepo-16.0.0.2.zip
installUtility install myServer
installUtility install c:\temp\myServer.jar
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
installUtility testConnection default
installUtility uninstall adminCenter-1.0
installUtility uninstall usr:webCacheMonitor-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 | 현재 제품에 대해 기능이 올바르지 않습니다. |
30 | repositories.properties 파일이 유효성 검증에 실패했습니다. |
33 | 저장소 연결에 실패했습니다. |
34 | 저장소 이름을 찾을 수 없습니다. 제공된 저장소 이름이 구성 파일에 없습니다. |
35 | 사용자가 조치를 취소했습니다. |
![]() |
![]() |