installUtility 명령
installUtility 명령을 사용하여 IBM® WebSphere® Liberty Repository 또는 Liberty Asset Repository의 인스턴스, 디렉토리 기반 저장소에 있는 자산에 대한 정보를 찾고 가져오며 이를 설치할 수 있습니다.
자산 소스
- 인터넷을 통하여 액세스 가능한 공용 IBM 호스팅 저장소인 IBM WebSphere Liberty Repository. 자세한 정보는 Liberty 저장소의 내용을 참조하십시오.
- 엔터프라이즈의 방화벽 뒤에서 원격으로 액세스 가능한 사내 구축 환경 저장소를 작성하는 데 사용할 수 있는 개방형 소스 서비스인 Liberty 자산 저장소 서비스. 자세한 정보는 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
- 다운로드 중에 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- name
- 하나 이상의 다음 자산을 다운로드하기 위한 자산 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
- 조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- name
- 설치할 하나 이상의 자산을 지정하십시오. 자산은 다음 방법으로 지정할 수 있습니다.
- 자산 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
- 설치 제거 중에 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- name
- 공백으로 여러 이름을 분리하여, 설치 제거할 기능을 하나 이상 지정하십시오. 다음과 같은 옵션을 지정할 수 있습니다.
- 서브시스템 아카이브(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 ndMemberBundlelibertyCoreBundle --from=c:\download\wlp-featureRepo-16.0.0.2
installUtility install ndMemberBundlelibertyCoreBundle --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 | 사용자가 조치를 취소했습니다. |