featureManager 명령
featureManager 명령을 사용하여 기능을 찾거나 설치하거나 설치 제거하거나 기능에 대한 세부사항을 얻을 수 있습니다.
설치하려는 기능은 서브시스템 아카이브(ESA 파일)로 패키징해야 합니다.
프록시 서버를 통해
featureManager 명령을 사용하여 Liberty Repository에 액세스할 수
있습니다. 자세한 정보는 Liberty 프로파일에서 featureManager 명령을 위한 프록시 서버 지원 구성의
내용을 참조하십시오.
더 많은 자산 유형을 관리하거나, 여러 저장소의 자산을 설치하거나, 찾거나 다운로드하려면
featureManager 명령 대신 installUtility 명령을 사용하십시오.
자세한 정보는 installUtility 명령을 사용하여 자산 설치의 내용을 참조하십시오.
구문
명령 구문은 다음과 같습니다.
featureManager action [options]
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에 정의된 위치에 추출됩니다.
featureManager 명령을 사용하면 Liberty Repository로부터 자산을 다운로드할 수 있습니다. 자세한 정보는 Liberty Repository 자산 설치의 내용을 참조하십시오.
- featureList
- 설치된 모든 기능을 자세히 설명하는 보고서가 포함된 XML 파일을 생성합니다.
find
- 구성에 적용 가능한 Liberty Repository에서 자산을 찾습니다.
- help
- 지정된 조치에 대한 도움말 정보를 표시합니다.
uninstall
기능 축약 이름 또는 기능 기호 이름을 사용하여 기능을 설치 제거합니다.
참고:- 기능을 설치 제거하기 전에 모든 서버 프로세스가 중지되었는지 확인하십시오.
- uninstall 명령은 사용자 기능을 설치 제거할 수 없습니다(예: webCacheMonitor-1.0).
옵션
![[8.5.5.4 이상]](../ng_v8554.gif)
- --features=feature1,feature2,...
- API JAR 파일의 목록이 포함된 기능의 목록입니다. 이 옵션은 classpath 조치의 경우 필수입니다.
- --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: 기존 파일을 대체합니다.
- subsystem_archive
- 설치할 서브시스템 아카이브의 위치를 지정합니다. 다음과 같은 방법으로
위치를 지정할 수 있습니다.
- 파일 이름(예: my_feature.esa)
- URL(예:
)http://myhost.ibm.com/liberty/assets/my_feature.esa
서브시스템 아카이브(ESA 파일)의 축약 이름(예: adminCenter-1.0)
서브시스템 아카이브(ESA 파일)의 기호 이름(예: com.ibm.websphere.appserver.adminCenter-1.0)
자세한 정보는 WASdev.net의 다운로드 페이지를 참조하십시오.
- --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 보고서 파일의 이름을 지정합니다.
searchString
- IBM WebSphere Liberty Repository에서 적용 가능한 기능을 찾으려면 searchstring 옵션을 사용하십시오.
--viewInfo
- 자세한 정보를 봅니다.
![[8.5.5.5 이상]](../ng_v8555.gif)
- name
- 설치 제거할 기능을 지정합니다. 다음과 같은 옵션을 지정할 수 있습니다.
- 서브시스템 아카이브(ESA 파일)의 축약 이름(예: adminCenter-1.0)
- 서브시스템 아카이브(ESA 파일)의 기호 이름(예: com.ibm.websphere.appserver.adminCenter-1.0)
- --noPrompts
- 사용자 상호작용 또는 확인 메시지 없이 기능을 설치 제거합니다.
사용 예제
featureManager install my_feature.esa --to=usr
featureManager install my_feature.esa --to=my_extension
featureManager featureList my_feature_report.xml --locale=pt_BR
featureManager featureList --productExtension=usr my_feature_report.xml
featureManager featureList --productExtension=productExtensionName my_feature_report.xml
featureManager help install

![[8.5.5.4 이상]](../ng_v8554.gif)
featureManager find searchString

![[8.5.5.4 이상]](../ng_v8554.gif)
featureManager find searchString --viewInfo

![[8.5.5.4 이상]](../ng_v8554.gif)
featureManager install feature_shortName --downloadOnly --location=c:\temp\download --acceptLicense

![[8.5.5.4 이상]](../ng_v8554.gif)
featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense

![[8.5.5.4 이상]](../ng_v8554.gif)
featureManager install feature_shortName --location=c:\temp\download --acceptLicense

![[8.5.5.4 이상]](../ng_v8554.gif)
featureManager install feature_shortName --location=c:\temp\download --offlineOnly

![[8.5.5.4 이상]](../ng_v8554.gif)
featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java

![[8.5.5.5 이상]](../ng_v8555.gif)
featureManager uninstall adminCenter-1.0
![[2014년 5월 업데이트]](../delta.gif)
리턴 코드
리턴 코드 | 설명 |
---|---|
0 | 명령이 요청된 조작을 완료했습니다. |
20 | 하나 이상의 인수가 올바르지 않습니다. |
21 | 다음 조건 중 하나 이상의 조건 때문에 런타임
예외가 발생했습니다.
|
22 | 설치하려고 한 기능이 이미 있습니다. |
23 | 다음 이유 중 하나 이상의 이유로 인해 기능 정의가
올바르지 않습니다.
|
24 | .esa 서브시스템 아카이브 파일에 컨텐츠가 누락되었습니다. |
25 | 설치하려고 한 파일이 이미 있으며 when-file-exists=fail 옵션을 지정했습니다. |
26 | 제품이 코어 제품이 아니며 제품 확장 파일을 찾을 수 없습니다. |
27 | 제품이 코어 제품이 아니며 제품 확장이 ${wlp.install.dir}/etc/extensions/extension_name.properties 파일에 정의되어 있지 않습니다. |
28 | 제품 확장에서 기능에 대한 Manifest 파일을 찾을 수 없습니다. |
29 | 현재 제품에 대해 기능이 올바르지 않습니다. |
![[2014년 5월 업데이트]](../deltaend.gif)