featureManager 명령

featureManager 명령을 사용하여 기능을 찾거나 설치하거나 설치 제거하거나 기능에 대한 세부사항을 얻을 수 있습니다.

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

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

[8.5.5.6 이상]더 많은 자산 유형을 관리하거나, 여러 저장소의 자산을 설치하거나, 찾거나 다운로드하려면 featureManager 명령 대신 installUtility 명령을 사용하십시오. 자세한 정보는 installUtility 명령을 사용하여 자산 설치의 내용을 참조하십시오.

구문

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

featureManager action [options]
여기서 action은 다음 값 중 하나가 될 수 있습니다.
[8.5.5.4 이상]classpath
기능 목록에서 API를 사용하기 위해 컴파일러 클래스 경로에 추가할 수 있는 JAR 파일을 생성합니다. 이 조치를 사용하면 특정 JAR 이름(수정팩이 적용될 때 변경될 수 있음)을 참조하지 않고 제품에 포함되는 API JAR에 대해 빌드 스크립트를 컴파일할 수 있습니다. 출력 JAR에는 제품의 API JAR에 대한 상대 경로가 포함되어 있습니다. 따라서 출력 JAR을 다른 디렉토리로 이동해서는 안 됩니다.
참고: --features 옵션은 이 조치를 사용하여 지정해야 합니다.
install
엔터프라이즈 서브시스템 아카이브(ESA) 파일, ESA 파일에 대한 URL, 기능 축약 이름 또는 기능 기호 이름으로부터 기능을 설치합니다.

기능 축약 이름 또는 기호 이름을 지정하는 경우 해당 기능은 IBM이 호스팅하는 온라인 저장소에서 다운로드됩니다.

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

Liberty Repository[8.5.5.2 이상]featureManager 명령을 사용하면 Liberty Repository로부터 자산을 다운로드할 수 있습니다. 자세한 정보는 Liberty Repository 자산 설치의 내용을 참조하십시오.
featureList
설치된 모든 기능을 자세히 설명하는 보고서가 포함된 XML 파일을 생성합니다.
Liberty Repository[8.5.5.4 이상]find
구성에 적용 가능한 Liberty Repository에서 자산을 찾습니다.
help
지정된 조치에 대한 도움말 정보를 표시합니다.
[8.5.5.5 이상]uninstall
[8.5.5.5 이상]기능 축약 이름 또는 기능 기호 이름을 사용하여 기능을 설치 제거합니다.
참고:
  • 기능을 설치 제거하기 전에 모든 서버 프로세스가 중지되었는지 확인하십시오.
  • uninstall 명령은 사용자 기능을 설치 제거할 수 없습니다(예: webCacheMonitor-1.0).

옵션

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

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

다음 옵션은 featureManager featureList 명령에 사용할 수 있습니다.
--encoding=charset
여기서 charset는 XML 보고서 파일을 작성할 때 사용할 문자 세트입니다.
--locale=language
여기서 language는 XML 보고서 파일을 작성할 때 사용할 언어를 지정합니다. 이는 ISO-639 소문자 두 자로 된 언어 코드로 구성되며, 선택사항으로 뒤에 밑줄과 ISO-3166 대문자 두 자로 된 국가 코드가 있습니다.
--productExtension=name
여기서 name은 기능을 나열할 제품 확장 이름입니다. 기본 사용자 위치에 제품 확장기능이 설치된 경우 usr 키워드를 사용하십시오. 이 옵션이 지정되지 않으면 조치가 WebSphere Application Server Liberty 코어에 수행됩니다.
XML_report_file_name
작성할 XML 보고서 파일의 이름을 지정합니다.
featureManager find 명령에 다음과 같은 옵션을 사용할 수 있습니다.
Liberty Repository[8.5.5.4 이상]searchString
IBM WebSphere Liberty Repository에서 적용 가능한 기능을 찾으려면 searchstring 옵션을 사용하십시오.
Liberty Repository[8.5.5.4 이상]--viewInfo
자세한 정보를 봅니다.
[8.5.5.5 이상]featureManager uninstall 명령에 다음과 같은 옵션을 사용할 수 있습니다.
name
설치 제거할 기능을 지정합니다. 다음과 같은 옵션을 지정할 수 있습니다.
  • 서브시스템 아카이브(ESA 파일)의 축약 이름(예: adminCenter-1.0)
  • 서브시스템 아카이브(ESA 파일)의 기호 이름(예: com.ibm.websphere.appserver.adminCenter-1.0)
--noPrompts
사용자 상호작용 또는 확인 메시지 없이 기능을 설치 제거합니다.

사용 예제

다음 예제는 서브시스템 아카이브 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
Liberty Repository[8.5.5.4 이상]다음 예제에서는 Liberty Repository에서 적용 가능한 자산을 찾습니다.
featureManager find searchString
Liberty Repository[8.5.5.4 이상]다음 예제에서는 자세한 정보를 나열합니다.
featureManager find searchString --viewInfo
Liberty Repository[8.5.5.4 이상]다음 예제에서는 필요한 종속 항목을 Liberty Repository로부터 로컬 디렉토리로 다운로드하지만 설치하지는 않습니다.
featureManager install feature_shortName --downloadOnly --location=c:\temp\download --acceptLicense
참고: URL을 사용하여 서브시스템 아카이브 위치를 지정하는 경우에는 이 옵션을 사용할 수 없습니다.
Liberty Repository[8.5.5.4 이상]다음 예제에서는 모든 종속 항목을 Liberty Repository에서 다운로드하지만 설치하지는 않습니다.
featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense
참고: URL을 사용하여 서브시스템 아카이브 위치를 지정하는 경우에는 이 옵션을 사용할 수 없습니다.
Liberty Repository[8.5.5.4 이상]다음 예제에서는 로컬 디렉토리에 있는 기능을 설치합니다. 누락된 종속 항목이 있으면 해당 항목은 온라인 저장소로부터 설치됩니다.
featureManager install feature_shortName --location=c:\temp\download --acceptLicense
참고: URL을 사용하여 서브시스템 아카이브 위치를 지정하는 경우에는 이 옵션을 사용할 수 없습니다.
Liberty Repository[8.5.5.4 이상]다음 예제에서는 누락된 종속 항목을 Liberty Repository에서 다운로드하지 않고 로컬 디렉토리로부터 자산을 설치합니다.
featureManager install feature_shortName --location=c:\temp\download --offlineOnly
참고: URL을 사용하여 서브시스템 아카이브 위치를 지정하는 경우에는 이 옵션을 사용할 수 없습니다.
Liberty Repository[8.5.5.4 이상]다음 예제에서는 클래스 경로 JAR 파일을 작성하고 이 파일을 사용하는 애플리케이션 클래스를 컴파일합니다.
featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java
Liberty Repository[8.5.5.5 이상]다음 예제에서는 기능을 설치 제거합니다.
featureManager uninstall adminCenter-1.0
[2014년 5월 업데이트]

리턴 코드

표 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 현재 제품에 대해 기능이 올바르지 않습니다.
[2014년 5월 업데이트]

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

Information Center 이용 약관 | 피드백


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