installUtility 명령

installUtility 명령을 사용하여 Liberty Repository 또는 Liberty Asset Repository Service의 인스턴스, 디렉토리 기반 저장소에 있는 자산을 찾고 관련 정보를 가져오며 이를 설치할 수 있습니다.

자산 소스

installUtility 명령은 다음 저장소의 자산에 액세스할 수 있습니다.
  • 인터넷을 통해 액세스 가능한 공용 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]
action 변수는 다음 값 중 하나를 사용할 수 있습니다.
download
저장소에서 자산을 다운로드합니다.
find
구성에 적용할 수 있는 자산을 저장소에서 찾거나 자산에 대한 자세한 정보를 표시합니다.
install
런타임에 자산 또는 ESA(Enterprise Subsystem Archive) 파일을 설치하거나, 서버 패키지를 배치하고 이 패키지의 필수 기능을 설치합니다.
testConnection
저장소 연결을 테스트합니다.
uninstall
기능의 약칭 또는 기호 이름을 지정하여 기능을 설치 제거합니다. 공백으로 분리하여 다수의 기능을 지정할 수 있습니다.
참고: 기능을 설치 제거하기 전에 모든 서버 프로세스가 중지되었는지 확인하십시오.
viewSettings
저장소 또는 프록시를 구성하기 위한 템플리트를 보거나, 구성된 저장소 또는 프록시에 대한 설정을 보고 유효성을 검증합니다.
help
지정된 조치에 대한 도움말 정보를 표시합니다.

옵션

다음 옵션은 installUtility download 명령에 사용할 수 있습니다.
--acceptLicense
라이센스 계약에 동의합니다.
--viewLicenseAgreement
라이센스 계약을 표시합니다.
--viewLicenseInfo
라이센스 계약을 표시합니다.
--location=directoryPath
다운로드되는 자산의 대상 디렉토리를 지정합니다. 이 옵션은 필수입니다.
--overwrite
로컬 디렉토리에 다운로드할 때 기존 파일을 겹쳐쓰려면 이 옵션을 사용하십시오. 이 옵션이 없는 경우 기본 동작은 모든 기존 파일을 무시하는 것입니다.
--verbose
다운로드 중에 추가 정보를 표시하려면 이 옵션을 사용하십시오.
이름
하나 이상의 다음 자산을 다운로드하기 위한 자산 ID를 지정합니다(다수의 자산 ID는 공백으로 분리함).
  • 기능
  • 추가 기능
  • 개방형 소스 통합
  • 샘플

다음 옵션은 installUtility find 명령에 사용할 수 있습니다.
--from
installUtility 명령에 대한 자산의 소스로서 단일 디렉토리 기반 저장소를 지정합니다.

디렉토리 기반 저장소는 압축되지 않은 폴더 또는 압축된 아카이브 파일일 수 있습니다.

다중 디렉토리 기반 저장소에서 자산을 검색하려면 repositories.properties 파일에서 저장소를 구성해야 합니다. 추가 정보는 installUtility 명령에 대한 저장소와 프록시 설정 구성의 내용을 참조하십시오.

--showDescriptions
검색으로 찾은 각 기능에 대한 설명을 표시합니다.
--type=[feature|sample|opensource|addon|all*]
지정된 자산 유형을 검색합니다.
--name
지정된 searchString에 대해 자산 이름을 검색합니다.
--verbose
조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
searchString
구성에 적용할 수 있는 자산을 찾습니다.이 명령은 검색 문자열을 지정하지 않으면 해당되는 모든 자산을 검색합니다.

다음 옵션은 installUtility install 명령에 사용할 수 있습니다.
--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에서 정의된 위치로 추출됩니다.

다음 옵션은 installUtility testConnection 명령에 사용할 수 있습니다.
repoName
테스트할 저장소의 이름을 지정합니다. 이름을 지정하지 않으면 repositories.properties 파일에 지정된 모든 저장소를 테스트합니다.

다음 옵션은 installUtility uninstall 명령에 사용할 수 있습니다.
--force
기타 설치된 기능이 이에 종속되는지 여부와 무관하게 지정된 기능을 설치 제거합니다.
참고: 기타 설치된 기능에서 요구하는 기능을 설치 제거하면 해당 기능의 작동이 중지될 수 있으며 서버가 올바르게 실행되지 못하도록 할 수 있습니다.
--noPrompts
프롬프트 없이 기능을 설치 제거합니다. 기본값은 false입니다.
--verbose
설치 제거 중에 추가 정보를 표시하려면 이 옵션을 사용하십시오.
이름
공백으로 여러 이름을 분리하여, 설치 제거할 하나 이상의 기능을 지정하십시오. 다음과 같은 옵션을 지정할 수 있습니다.
  • 서브시스템 아카이브(ESA 파일)의 축약 이름(예: adminCenter-1.0)
  • 서브시스템 아카이브(ESA 파일)의 기호 이름(예: com.ibm.websphere.appserver.adminCenter-1.0)

콜론이 뒤에 붙는 확장자로 기능 이름의 접두부를 지정함으로써(예: usr:webCacheMonitor-1.0), 사용자 기능 및 제품 확장기능을 설치 제거할 수 있습니다.


다음 옵션을 installUtility viewSettings 명령에 사용할 수 있습니다.
--viewValidationMessages
이 옵션을 사용하여 구성된 repositories.properties 파일의 유효성 검증으로부터 세부사항 메시지를 표시할 수 있습니다. 각 메시지에는 오류 코드, 오류가 발견된 행 번호 및 오류의 원인이 포함되어 있습니다.

사용 예제

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 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
서버 패키지 .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 usr:webCacheMonitor-1.0
여러 기능을 설치 제거하려면 다음 예를 사용하십시오.
installUtility uninstall feature1 feature2 feature3
프롬프트 없이 여러 기능을 설치 제거하려면 다음 예를 사용하십시오.
installUtility uninstall --noPrompts feature1 feature2 feature3

리턴 코드

표 1. 리턴 코드 및 설명
리턴 코드 설명
0 명령이 요청된 조작을 완료했습니다.
20 하나 이상의 인수가 올바르지 않습니다.
21 다음 조건 중 하나 이상의 조건 때문에 런타임 예외가 발생했습니다.
  • .esa 서브시스템 아카이브 파일을 설치하는 중에 런타임 예외가 발생했습니다.
  • 라이센스에 동의하지 않았거나 라이센스가 수신확인되지 않았습니다.
  • .esa 서브시스템 아카이브 파일이 올바르게 추출되지 않았습니다.
22 설치하려고 한 기능이 이미 있습니다.
23 다음 이유 중 하나 이상의 이유로 인해 기능 정의가 올바르지 않습니다.
  • 기능에 올바른 Manifest 파일이 없습니다.
  • 기능의 버전이 이 Liberty 환경에서 지원되지 않습니다.
  • 기능 파일이 포함된 .zip 또는 .jar 파일이 없습니다.
24 .esa 서브시스템 아카이브 파일에 컨텐츠가 누락되었습니다.
25 설치하려고 한 파일이 이미 있습니다.
26 제품이 코어 제품이 아니며 제품 확장 파일을 찾을 수 없습니다.
27 제품이 코어 제품이 아니며 제품 확장이 ${wlp.install.dir}/etc/extensions/extension_name.properties 파일에 정의되어 있지 않습니다.
28 제품 확장에서 기능에 대한 Manifest 파일을 찾을 수 없습니다.
29 현재 제품에 대해 기능이 올바르지 않습니다.
30 repositories.properties 파일이 유효성 검증에 실패했습니다.
33 저장소 연결에 실패했습니다.
34 저장소 이름을 찾을 수 없습니다. 제공된 저장소 이름이 구성 파일에 없습니다.
35 사용자가 조치를 취소했습니다.
[17.0.0.3 and later]36 [17.0.0.3 and later]지정된 확장에 대한 사용자 기능 설치가 올바르지 않습니다. --to=core

주제의 유형을 표시하는 아이콘 참조 주제

파일 이름: rwlp_command_installutility.html