Liberty: featureManager 명령
기능을 설치하고 설치된 모든 기능의 세부사항을 얻으려면 featureManager 명령을 사용하십시오.
설치하려는 기능은 서브시스템 아카이브(ESA 파일)로 패키징해야 합니다.
프록시 서버를 통해 featureManager 명령을 사용하여 Liberty Repository에 액세스할 수 있습니다. 자세한 정보는 Liberty에서 featureManager 명령에 대한 프록시 서버 지원 구성의 내용을 참조하십시오.
featureManager 명령 대신 installUtility 명령을 사용하십시오. installUtility 명령을 사용하면 추가적인 자산 유형을 관리할 수 있으며, 여러 저장소에서 자산을 설치하고 찾거나 다운로드할 수 있습니다. 자세한 정보는 installUtility 명령을 사용하여 자산 설치의 내용을 참조하십시오.
구문
명령 구문은 다음과 같습니다.
featureManager action [options]
- 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
- 지정된 조치에 대한 도움말 정보를 표시합니다.
옵션
- --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의 다운로드 페이지를 참조하십시오.
- --noPrompts
- 사용자 상호작용 또는 확인 메시지 없이 기능을 설치 제거합니다.
- --verbose
- 조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- 이름
- 공백 또는 쉼표로 여러 이름을 분리하여, 설치 제거할 기능을 하나 이상 지정하십시오. 다음과 같은 옵션을 지정할 수 있습니다.
- 서브시스템 아카이브(ESA 파일)의 축약 이름(예: adminCenter-1.0)
- 서브시스템 아카이브(ESA 파일)의 기호 이름(예: com.ibm.websphere.appserver.adminCenter-1.0)
- --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
- 조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- --viewInfo
- 자세한 정보를 표시합니다.
- --verbose
- 조치 실행 중에 사용 가능한 추가 정보를 표시하려면 이 옵션을 사용하십시오.
- searchString
- 구성에 적용 가능한 Liberty Repository 자산의 목록을 생성합니다.
- --features=feature1,feature2,...
- API JAR 파일의 목록이 포함된 기능의 목록입니다. 이 옵션은 classpath 조치의 경우 필수입니다.
- fileName
- 생성된 JAR 파일의 이름입니다.
사용 예제
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
featureManager install extendedPackage-1.0 --verbose
featureManager find searchString
featureManager find searchstring --viewInfo
다음 예제는 기능을 찾고 추가 정보를 포함합니다. featureManager find "adminCenter-1.0" --verbose
featureManager install feature_shortName --downloadOnly --location=c:\temp\download --acceptLicense
featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense
featureManager install feature_shortName --location=c:\temp\download --acceptLicense
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
리턴 코드
리턴 코드 | 설명 |
---|---|
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 | 현재 제품에 대해 기능이 올바르지 않습니다. |
![]() |
![]() |