Liberty: featureManager 명령

기능을 설치하고 설치된 모든 기능의 세부사항을 얻으려면 featureManager 명령을 사용하십시오.

설치하려는 기능은 서브시스템 아카이브(ESA 파일)로 패키징해야 합니다.

프록시 서버를 통해 featureManager 명령을 사용하여 Liberty Repository에 액세스할 수 있습니다. 자세한 정보는 Liberty에서 featureManager 명령에 대한 프록시 서버 지원 구성의 내용을 참조하십시오.

중요사항: .esa 파일을 설치하는 경우를 제외하고 featureManager, find, installuninstall 조치가 안정화되었습니다.

featureManager 명령 대신 installUtility 명령을 사용하십시오. installUtility 명령을 사용하면 추가적인 자산 유형을 관리할 수 있으며, 여러 저장소에서 자산을 설치하고 찾거나 다운로드할 수 있습니다. 자세한 정보는 installUtility 명령을 사용하여 자산 설치의 내용을 참조하십시오.

구문

명령 구문은 다음과 같습니다.

featureManager action [options]
여기서 action은 다음 값 중 하나가 될 수 있습니다.
install
안정화된 기능: 이 조치는 안정화되었습니다. .esa 파일을 설치하는 경우를 제외하고 installUtility install 명령을 사용하십시오. .esa 파일을 설치하려면 featureManager 명령을 사용하십시오.
기능 또는 엔터프라이즈 서브시스템 아카이브(ESA) 파일을 런타임 환경에 설치하십시오.
featureManager 명령을 사용하면 Liberty Repository에서 자산을 다운로드할 수 있습니다. 추가 정보는 Liberty Repository 자산 설치의 내용을 참조하십시오.
uninstall
안정화된 기능: 이 조치는 안정화되었습니다. 대신 installUtility uninstall 명령을 사용하십시오.
기능 축약 이름 또는 기능 기호 이름을 사용하여 기능을 설치 제거하십시오.
참고:
  • 기능을 설치 제거하기 전에 모든 서버 프로세스가 중지되었는지 확인하십시오.
  • uninstall 조치로 사용자 기능(예: webCacheMonitor-1.0)은 설치 제거할 수 없습니다.
featureList
설치된 모든 기능을 자세히 설명하는 보고서가 포함된 XML 파일을 생성합니다.
find
안정화된 기능: 이 조치는 안정화되었습니다. 대신 installUtility find 명령을 사용하십시오.
Liberty Repository에서 모든 자산의 목록을 생성하거나, 구성에 적용 가능한 Liberty Repository에서 자산을 찾거나, 자세한 정보를 봅니다.
classpath
기능 목록에서 API를 사용하기 위해 컴파일러 클래스 경로에 추가할 수 있는 JAR 파일을 생성합니다. 이 조치를 사용하면 특정 JAR 이름(수정팩이 적용될 때 변경될 수 있음)을 참조하지 않고 제품에 포함되는 API JAR에 대해 빌드 스크립트를 컴파일할 수 있습니다. 출력 JAR에는 제품의 API JAR에 대한 상대 경로가 포함되어 있습니다. 따라서 출력 JAR을 다른 디렉토리로 이동해서는 안 됩니다.
참고: --features 옵션은 이 조치를 사용하여 지정해야 합니다.
help
지정된 조치에 대한 도움말 정보를 표시합니다.

옵션

다음 옵션은 featureManager install 명령에 사용할 수 있습니다.
--acceptLicense
라이센스 이용 약관에 자동으로 동의함을 표시합니다.
--downloadOnly=[all | required* | none]
요청된 기능을 설치하지 않고 로컬 디렉토리에 다운로드합니다. 이 옵션은 모든 종속 기능을 다운로드하거나 이 런타임에 필요한 종속 기능을 다운로드하거나 종속 기능을 다운로드하지 않도록 구성될 수 있습니다. 기본값은 필요한 종속 기능을 다운로드하는 것입니다. --location 옵션을 사용하여 디렉토리를 지정하십시오.
참고: 파일 이름 또는 URL을 사용하여 서브시스템 아카이브 위치를 지정하는 경우에는 이 옵션을 사용할 수 없습니다.
--location=directoryPath
기능을 설치할 때 이 옵션은 기능을 설치할 수 있는 로컬 소스 디렉토리를 지정합니다. --downloadOnly 옵션과 함께 사용되면 이 옵션은 다운로드된 기능의 대상 디렉토리를 지정합니다. 이 옵션은 --downloadOnly--offlineOnly 옵션을 사용하는 경우 필수입니다.
참고: 파일 이름 또는 URL을 사용하여 서브시스템 아카이브 위치를 지정하는 경우에는 이 옵션을 사용할 수 없습니다.
--offlineOnly
Liberty Repository에 연결하지 않으려면 이 옵션을 사용하십시오. 대신 이 명령은 로컬 디렉토리로부터만 기능을 설치합니다. 로컬 디렉토리는 --location 옵션을 사용하여 지정됩니다.
참고: 파일 이름 또는 URL을 사용하여 서브시스템 아카이브 위치를 지정하는 경우에는 이 옵션을 사용할 수 없습니다.
--to=install_option
여기서 install_option은 다음 값 중 하나가 될 수 있습니다.
  • usr: 기능이 사용자 기능으로 설치됩니다. 이것이 기본값입니다.
  • extension: 기능을 설치할 위치입니다. 구성된 제품 확장 위치에 기능을 설치할 수 있습니다.
--viewLicenseAgreement
라이센스 계약을 표시합니다.
--viewLicenseInfo
라이센스 정보를 표시합니다.
--when-file-exists=exist_option
설치할 파일이 이미 존재하는 경우에 수행할 조치를 지정합니다. install_option은 다음 값 중 하나를 사용할 수 있습니다.
  • fail: 설치를 취소합니다.
  • ignore: 설치를 계속하고 존재하는 파일을 무시합니다.
  • replace: 기존 파일을 대체합니다.
--verbose
조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
이름
공백 또는 쉼표로 분리하여, 설치할 하나 이상의 기능을 지정합니다. 기능은 다음 방법으로 지정할 수 있습니다.
기능 ID
  • 기능의 축약 이름을 지정하십시오(예: adminCenter-1.0).
  • 기능의 기호 이름을 지정하십시오(예: com.ibm.websphere.appserver.adminCenter-1.0).
.esa 파일
  • 파일 이름을 지정하십시오(예: my_feature.esa).
  • URL을 지정하십시오(예: http://myhost.ibm.com/liberty/assets/my_feature.esa).

이 조치는 ESA 파일의 OSGI-INF/SUBSYTEM.MF 파일을 서브시스템의 기호 이름에 따라 이름이 바뀌는 ${wlp.user.dir}/extensions/lib/features 디렉토리(또는 --to 특성에 대한 값이 지정되는 경우 제품 확장 디렉토리)에 복사될 수 있는 새 기능 Manifest로서 사용합니다. 서브시스템에 대한 모든 번들이 ${wlp.user.dir}/extensions/lib 디렉토리에 추출되고 {bundle symbolic name}_{bundle version}.jar로 이름이 바뀝니다. 라이센스 파일, 체크섬 파일, 자국어 파일 및 기타 서브시스템 컨텐츠도 서브시스템 Manifest에 정의된 위치에 추출됩니다.

자세한 정보는 WASdev.net의 다운로드 페이지를 참조하십시오.

featureManager uninstall 명령에 다음과 같은 옵션을 사용할 수 있습니다.
--noPrompts
사용자 상호작용 또는 확인 메시지 없이 기능을 설치 제거합니다.
--verbose
조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
이름
공백 또는 쉼표로 여러 이름을 분리하여, 설치 제거할 기능을 하나 이상 지정하십시오. 다음과 같은 옵션을 지정할 수 있습니다.
  • 서브시스템 아카이브(ESA 파일)의 축약 이름(예: adminCenter-1.0)
  • 서브시스템 아카이브(ESA 파일)의 기호 이름(예: com.ibm.websphere.appserver.adminCenter-1.0)
다음 옵션은 featureManager featureList 명령에 사용할 수 있습니다.
--encoding=charset
여기서 charset는 XML 보고서 파일을 작성할 때 사용할 문자 세트입니다.
--locale=language
여기서 language는 XML 보고서 파일을 작성할 때 사용할 언어를 지정합니다. 이는 ISO-639 소문자 두 자로 된 언어 코드로 구성되며, 선택사항으로 뒤에 밑줄과 ISO-3166 대문자 두 자로 된 국가 코드가 있습니다.
--productExtension=name
여기서 name은 기능을 나열할 제품 확장 이름입니다. 기본 사용자 위치에 제품 확장기능이 설치된 경우 usr 키워드를 사용하십시오. 이 옵션을 지정하지 않을 경우 WebSphere® Application Server Liberty Core에서 해당 조치가 수행됩니다.
XML_report_file_name
작성할 XML 보고서 파일의 이름을 지정합니다.
--verbose
조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
featureManager find 명령에 다음과 같은 옵션을 사용할 수 있습니다.
--viewInfo
자세한 정보를 표시합니다.
--verbose
조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
searchString
구성에 적용 가능한 Liberty Repository 자산의 목록을 생성합니다.
featureManager classpath 명령에 다음과 같은 옵션을 사용할 수 있습니다.
--features=feature1,feature2,...
API JAR 파일의 목록이 포함된 기능의 목록입니다. 이 옵션은 classpath 조치의 경우 필수입니다.
fileName
생성된 JAR 파일의 이름입니다.

사용 예제

다음 예제는 서브시스템 아카이브 my_feature.esa를 사용자 기능으로 설치합니다.
featureManager install my_feature.esa --to=usr
다음 예제는 서비스 시스템 아카이브 my_feature.esamy_extension 제품 확장 위치에 설치합니다.
featureManager install my_feature.esa --to=my_extension
다음 예제는 설치된 모든 기능에 대한 보고서를 생성합니다. 이 보고서는 my_feature_report.xml 파일에 포르투갈어(브라질)를 사용하여 작성됩니다.
featureManager featureList my_feature_report.xml --locale=pt_BR
다음 예제는 기본 사용자 위치(wlp/usr/extension)에 설치된 제품 확장기능에 정의되어 있는 설치된 기능을 모두 포함하는 보고서를 생성합니다. 이 제품 확장기능은 런타임 환경에서 usr 제품 확장기능이라고 합니다. 보고서는 my_feature_report.xml 파일에 작성됩니다.
featureManager featureList --productExtension=usr my_feature_report.xml
다음 예제는 제품이 설치된 etc/extensions 디렉토리에 있는 productExtensionName.properties 파일의 컨텐츠가 가리키는 위치에 설치된 제품 확장기능에 정의되어 있는 모든 기능에 대한 보고서를 생성합니다. 보고서는 my_feature_report.xml 파일에 작성됩니다.
featureManager featureList --productExtension=productExtensionName my_feature_report.xml
다음 예제는 설치 조치에 대한 도움말 정보를 표시합니다.
featureManager help install
다음 예제는 기능을 설치하고 추가 정보를 포함합니다.
featureManager install extendedPackage-1.0 --verbose
다음 예제는 구성에 적용 가능한 자산을 찾습니다.
featureManager find searchString
다음 예제는 자세한 정보를 나열합니다.
featureManager find searchstring --viewInfo
다음 예제는 기능을 찾고 추가 정보를 포함합니다.
featureManager find "adminCenter-1.0" --verbose
다음 예제는 Liberty Repository의 필수 종속 항목을 로컬 디렉토리에 다운로드하지만 이를 설치하지는 않습니다.
featureManager install feature_shortName --downloadOnly --location=c:\temp\download --acceptLicense
다음 예제는 Liberty Repository에서 모든 종속 항목을 다운로드합니다.
featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense
다음 예제는 로컬 디렉토리에 있는 기능을 설치합니다. 누락된 종속 항목이 있으면 이는 Liberty Repository에서 설치됩니다.
featureManager install feature_shortName --location=c:\temp\download --acceptLicense
다음 예제는 Liberty Repository에서 누락된 종속 항목을 다운로드하지 않고 로컬 디렉토리에서 자산을 설치합니다.
featureManager install feature_shortName --location=c:\temp\download --offlineOnly

다음 예제는 클래스 경로 JAR 파일을 작성하고 이 파일을 사용하는 애플리케이션 클래스를 컴파일합니다.

featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java
다음 예제는 기능을 설치 제거합니다.
featureManager uninstall adminCenter-1.0

리턴 코드

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

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

파일 이름: rwlp_command_featuremanager.html