![[16.0.0.3 and later]](../ng_v16003plus.gif)
pluginUtility 명령
Liberty 서버가 플러그인 구성 파일을 자동으로 생성하는 경우에는 pluginUtility 명령을 사용하여 플러그인 구성 파일을 수집하고 이를 병합할 수 있습니다. 또한 pluginUtility 명령을 사용하여 플러그인 구성 파일을 수동으로 생성할 수 있습니다.
구문
명령 구문은 다음과 같습니다.
pluginUtility action [options]
- help
- 지정된 조치에 대한 도움말 정보를 표시합니다.
pluginUtility 명령에 대한 도움말 또는 병합 조치와 같은 특정 조치에 대한 도움말을 표시할 수 있습니다.
- merge
- 다중 웹 서버 플러그인 구성 파일을 하나의 파일로 병합하십시오.
![[16.0.0.4 and later]](../ng_v16004plus.gif)
- 생성
- 이 유틸리티를 사용하여 플러그인 구성 파일을 작성하십시오.
옵션
로컬 서버의 경우 --server=serverid 또는 원격 서버의 경우 --server=user:password@host:port
생성 조치에만 적용되고 pluginUtility 명령에서 생성 조치를 코드화하는 경우 필수입니다.
- 로컬 서버의 경우 서버 옵션은 서버 이름입니다.
- 원격 서버의 경우 서버 옵션은 user:password@host:port입니다.
- 로컬 서버 또는 원격 서버인지에 따라 서버를 실행해야 합니다.
- user
- 대상 서버의 관리자입니다. 값을 제공하지 않는 경우 값에 대해 유틸리티가 프롬프트를 표시합니다. user의 파트로 콜론(:)을 사용하지 마십시오.
- 비밀번호
- 대상 서버에 대한 관리자의 비밀번호입니다. 값을 제공하지 않는 경우 값에 대해 유틸리티가 프롬프트를 두 번 표시합니다. 비밀번호 항목이 일치해야 합니다.
중요사항: 명령행에서 해당 값을 지정할 때 작동하도록 이 옵션에서 사용자 및 비밀번호를 지정합니다. 대상 서버는 사용자 및 비밀번호에 지정하는 값을 명령행에서 지정하는 값과 비교하여 확인합니다.팁: 원격 요청에 대해 대상 서버의 server.xml 파일에서 사용자 ID 및 비밀번호를 코드화할 수 있습니다.예:<quickStartSecurity userName="AdminUser" userPassword="AdminPassword" />
- host
- 대상 서버의 호스트입니다. 호스트 값에서 @ 기호를 사용하지 마십시오. 누락된 호스트 값으로 인해 실패가 발생합니다.
- 포트
- 대상 서버의 포트 번호입니다. 누락된 포트 값으로 인해 실패가 발생합니다.
주의: 지정된 서버가 원격 서버인 경우 사용자는 요청 완료를 위해 SSL 인증서를 승인하도록 요청받습니다. SSL 인증서를 자동으로 승인하려면 com.ibm.webserver.plugin.utility.autoAcceptCertificates의 JVM 특성을 true로 설정하십시오.
![[16.0.0.4 and later]](../ng_v16004plus.gif)
- --cluster=cluster_name
- 생성 조치에만 적용되고 이 유틸리티를 사용하여 클러스터 서버에 대해
플러그인 구성 파일을 생성하는 경우 필수입니다. 서버 클러스터의 이름을 지정하십시오.
--cluster 옵션을 지정하는 경우 --server 옵션에서 집합체 제어기를 지정해야 합니다.
플러그인 구성 파일에 포함할 클러스터의 서버의 경우 이를 실행해야 하며 집합체 제어기에 참여시켜야 합니다.
- --sourcePath=directory|comma-separated list
- 병합 조치에만 적용되는 필수 옵션입니다. 모든 플러그인 구성 파일이 있는 소스 디렉토리의 위치를 지정하십시오. 또는 병합할 플러그인 파일을 식별하려면 전체 파일 경로가 있는 소스 플러그인 파일 이름의 쉼표로 구분된 목록을 지정하십시오.
- --targetPath=directory|full path name
병합 조치 및 생성 조치에 적용되는 선택적 옵션입니다.
생성 조치의 경우 기본적으로 플러그인 구성 파일은 클러스터 요청에 대해 이름이 cluster_name-plugin-cfg.xml이고 비클러스터 요청에 대해 이름이 plugin-cfg.xml인 현재 디렉토리에서 생성됩니다. 파일이 있어야 하는 디렉토리 이름을 지정하거나 완전한 파일 이름을 지정할 수 있습니다. 디렉토리가 있어야 합니다. 새 파일이 기존 파일을 대체합니다.
병합 조치의 경우 기본적으로 병합된 플러그인 구성 파일은 현재 디렉토리에서 생성되며 merged-plugin-cfg.xml로 이름 지정됩니다. merged-plugin-cfg.xml 파일의 대상 디렉토리 이름 또는 완전한 파일 이름을 지정할 수 있습니다. 디렉토리가 있어야 합니다. merged-plugin-cfg.xml로 이름 지정된 파일 또는 지정된 파일 이름이 있는 경우 파일의 컨텐츠를 겹쳐씁니다.
사용법
다음 예제는 올바른 구문을 보여줍니다.
pluginUtility help
pluginUtility help merge
pluginUtility merge --sourcePath=C:/plugins
pluginUtility merge --sourcePath=C:/plugins/plugin-cfg.xml,C:/plugins/Aplugin-cfg.xml,C:/other/plugin-cfg.xml
pluginUtility merge --sourcePath=C:/plugins --targetPath=C:/targetDir
pluginUtility merge --sourcePath=C:/plugins --targetPath=C:/targetDir/myMergedPluginCfg.xml
![[16.0.0.4 and later]](../ng_v16004plus.gif)
pluginUtility help generate
pluginUtility generate --server=myController --cluster=myCluster --targetpath=./pluginFile/plugin-cfg.xml
pluginUtility generate -–server=userName:mypassword@myControllerHost:9443 --cluster=myCluster --targetpath=./pluginFiles/plugin-cfg.xml
pluginUtility generate –-server=myServer --targetpath=./pluginFiles/plugin-cfg.xml
pluginUtility generate –-server=userName:mypassword@testHost:9443 --targetpath=./pluginFiles/plugin-cfg.xml
pluginUtility generate --server=userName:@testHost:9443