[8.5.5.6 이상]

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

리턴 코드

표 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 현재 제품에 대해 기능이 올바르지 않습니다.
33 저장소 연결에 실패했습니다.
34 저장소 이름을 찾을 수 없습니다. 제공된 저장소 이름이 구성 파일에 없습니다.
35 사용자가 조치를 취소했습니다.

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

Information Center 이용 약관 | 피드백


시간소인 아이콘 마지막 업데이트 날짜: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_command_installutility
파일 이름: rwlp_command_installutility.html