![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
manageprofiles 명령
manageprofiles 명령을 사용하여 런타임 환경을 정의하는 프로파일을 작성, 삭제, 기능 보강, 백업, 복원하십시오. 여러 제품 설치 대신 프로파일을 사용하면 한 세트의 코어 제품 파일이 유지보수되므로 디스크 공간이 절약되고 제품 업데이트가 단순해집니다.
manageprofiles 명령과
그래픽 사용자 인터페이스, 프로파일 관리 도구는 런타임 환경을
작성하는 유일한 방법입니다.
명령 파일은 app_server_root/bin 디렉토리에 있습니다. 명령 파일은 manageprofiles로 이름 지정된 스크립트입니다.
구문
app_server_root\bin\manageprofiles.bat -augment -help
app_server_root/bin/manageprofiles.sh -create
-profileName profile_name
-profilePath profile_root
-templatePath template_path
매개변수
다음 옵션은 manageprofiles 명령에 대해 사용 가능합니다.
- -adminUserName 매개변수에 지정되는 관리 보안 사용자 ID의 비밀번호를 지정합니다.
- 관리 보안에 사용되는 사용자 ID를 지정합니다.
- 애플리케이션 서버가 실행되는 환경 유형과 가장 일치하는
성능 조정 설정을 지정합니다.
이 매개변수는 기본 프로파일 템플리트에만 유효합니다.
- 표준 설정은 일반 사용을 위해 최적화된, 바로 사용 가능한 표준 기본 구성 설정입니다.
- 최대 성능 설정은 애플리케이션이 거의 변경되지 않고 최적의 런타임 성능이 중요한 프로덕션 환경에 맞게 최적화됩니다.
- 개발 설정은 애플리케이션이 자주 업데이트되며 최소의 시스템 자원이 있는
개발 환경에 맞게 최적화됩니다. 중요사항: 프로덕션 서버에서는 개발 설정을 사용하지 마십시오.
-applyPerfTuningSetting 매개변수를 가진 옵션을 지정하지 않는 경우 기본값은 standard입니다.
-isDeveloperServer 및 -applyPerfTuningSetting 매개변수를 모두 지정하는 경우 -applyPerfTuningSetting에 대해 선택한 옵션에 따라 -applyPerfTuningSetting이 -isDeveloperServer를 대체할 수 있습니다.
- 기능 보강 템플리트를 사용하여 기존의 프로파일을 변경하려면
기능 보강 매개변수를 사용하십시오. 기능 보강 매개변수를 사용하면
manageprofiles 명령은
-templatePath 매개변수의 템플리트를 사용하여 -profileName 매개변수에
식별된 프로파일을 업데이트하거나 기능을 보강합니다. 사용 가능한
기능 보강 템플리트는 환경에 설치된 IBM®
제품 및 버전으로 판별됩니다. 중요사항: WebSphere® Application Server base 제품에 포함된 템플리트는 프로파일 작성에만 사용할 수 있으며 기존 프로파일 보강에는 사용할 수 없습니다. 작성 템플리트만 제품과 함께 제공되기 때문입니다.
또한 install_dir/ profileTemplates 디렉토리에 있는 파일은 수동으로 수정하지 마십시오. 프로파일 작성 중에 포트를 변경하는 경우, 프로파일 템플리트 디렉토리에서 파일을 수정하는 대신 예를 들어 manageprofiles 명령에서 -startingPort 또는 -portsFile 인수를 사용하십시오.
-templatePath에 대해 완전한 파일 경로를
지정합니다. 예를 들면, 다음과 같습니다. manageprofiles(.bat)(.sh) -augment -profileName profile_name -templatePath template_path프로파일 템플리트가 app_server_root/profileTemplates 디렉토리에 대해 상대적인 경우 -templatePath 매개변수에 대한 상대 경로를 지정할 수 있습니다. 그렇지 않으면 완전한 템플리트 경로를 지정하십시오. 예를 들면, 다음과 같습니다.manageprofiles -augment -profileName profile_name -templatePath template_path-unaugment 매개변수도 참조하십시오.
- 프로파일 레지스트리 파일을 지정된 파일로 백업합니다. backupFile_name에 완전한 파일 경로를 제공해야 합니다.
- 프로파일 레지스트리 파일에서 프로파일 폴더 및 프로파일 메타데이터의 파일 시스템 백업을
수행합니다. 백업할 프로파일을 사용하는 모든 서버는
중지한 다음 -backupProfile 옵션을 사용하여 manageprofiles 명령을
호출해야 합니다. -backupProfile 매개변수는
-backupFile 및 -profileName 매개변수와 함께
사용해야 합니다. 예를 들면 다음과 같습니다.
manageprofiles(.bat)(.sh) -backupProfile -profileName profile_name -backupFile backupFile_name-backupProfile 옵션을 사용하여 프로파일을 백업하는 경우, 먼저 복원하려는 프로파일에 대하여 실행 중인 프로세스와 서버를 중지해야 합니다.
- 프로파일의 셀 이름을 지정합니다. 프로파일마다 고유한 셀 이름을 사용하십시오.
문제점 방지: 셀 이름은 고유해야 합니다. 중복 이름을 가진 여러 셀이 있는 경우에는
원격 Enterprise JavaBeans 호출과 같은 셀 간의 원격 통신에 문제점이 발생할 수 있습니다.gotcha선택적 매개변수입니다. 매개변수를 생략하는 경우, 기본 셀 이름이 지정됩니다.
이 매개변수의
기본값은 축약형 호스트 이름, 상수 셀, 뒤에 오는 숫자 조합을 기반으로 합니다.
기본 셀 이름은 다음과 같습니다. 이 매개변수 값은 공백이나 유효하지 않은 문자를 포함할 수 없습니다(예: *, ?, ", <, >, ,, /, \, | 등).
- 프로파일을 작성합니다. 프로파일 작성에 대한 특정 정보를 보려면 manageprofiles -create -templatePath fully_qualified_file_path_to_template -help를 지정합니다. 사용 가능한 템플리트는 다음과 같습니다.
- manageprofiles 명령이 사용하는 Ant 유틸리티의 디버그 기능을 켭니다.
- 기본 개인 인증서가 유효한 기간(년)을 지정하는 선택적 매개변수입니다. 이 매개변수를 -personalCertDN 매개변수와 함께 지정하지 않으면 기본 개인 인증서는 1년 동안 유효합니다.
- 프로파일에 기본값 또는 기본 포트 값을 지정합니다.
-startingPort 또는 -portsFile 매개변수를 사용할 때 이 매개변수를 사용하지 마십시오.
-startingPort 매개변수, -defaultPorts 매개변수 또는 -portsFile 매개변수를 지정하지 않는 경우 프로파일 작성 중에 manageprofiles 명령은 자동으로 생성된 권장 포트 세트를 사용합니다. 권장 포트 값은 기본 포트의 가용성에 따라 기본 포트 값과 다를 수 있습니다.
알아두기: 관리 프로파일 템플리트를 사용하는 경우에는 이 매개변수를 사용하지 마십시오. - 프로파일을 삭제합니다.
프로파일을 삭제해도 프로파일 디렉토리는
삭제되지 않습니다. 예를 들어, /usr/WebSphere/AppServer/profiles/managedProfile 디렉토리에
프로파일을 작성한다고 가정하십시오. 프로파일을 삭제해도 디렉토리는 그대로 유지됩니다.
디렉토리를
삭제하거나 남겨둘 수 있습니다. 그러나
profile_root/logs 디렉토리에는
프로파일 설치 제거 방법에 대한 정보가 포함되어 있습니다. 예를 들어 설치 제거
프로시저 동안 모든 문제점의 원인을 판별하기 위해 _nodeuninst.log
파일을 보존할 수 있습니다.
프로파일을 삭제하는 경우 디렉토리를 수동으로 삭제하지 않고도 프로파일을 다시 작성할
수 있도록 프로파일 디렉토리가 삭제됩니다. 프로파일 레지스트리에서 기능 보강 템플리트를 등록한 프로파일을 삭제하면 보강된 기능 해제 조치가 자동으로 수행됩니다.
- 모든 등록된 프로파일을 삭제합니다.
프로파일을 삭제해도 프로파일 디렉토리는
삭제되지 않습니다. 예를 들어, /usr/WebSphere/AppServer/profiles/managedProfile 디렉토리에
프로파일을 작성한다고 가정하십시오. 프로파일을 삭제해도 디렉토리는 그대로 유지됩니다.
디렉토리를
삭제하거나 남겨둘 수 있습니다. 그러나
profile_root/logs 디렉토리에는
프로파일 설치 제거 방법에 대한 정보가 포함되어 있습니다. 예를 들어 설치 제거
프로시저 동안 모든 문제점의 원인을 판별하기 위해 _nodeuninst.log
파일을 보존할 수 있습니다.
프로파일을 삭제하는 경우 프로파일을 다시 작성할 때 오래된 정보를 관리하지 않아도 되도록
프로파일 디렉토리가 삭제됩니다. 프로파일 레지스트리에서 기능 보강 템플리트를 등록한 프로파일을 삭제하면 보강된 기능 해제 조치가 자동으로 수행됩니다.
- 관리 보안을 사용 가능하게 합니다. 올바른 값은 true 또는 false입니다. 기본값은 false입니다.
- enableAdminSecurity를 true로 설정한 경우에는 -adminUserName 및 -adminPassword 매개변수와 이러한 매개변수 값도 지정해야 합니다.
Linux
서비스의 작성을 사용 가능하게 합니다. 올바른 값은
true 또는 false입니다.
이 매개변수의 기본값은 false입니다. manageprofiles 명령이 true로 설정된 -enableService 옵션과 함께 실행되면, Linux 서비스는 루트 사용자가 명령을 실행할 때 프로파일을 사용하여 작성됩니다. 루트가 아닌 사용자가 manageprofiles 명령을 실행하면 프로파일은 작성되지만 Linux 서비스는 작성되지 않습니다. 루트가 아닌 사용자에게는 서비스를 설정할 충분한 권한이 없으므로 Linux 서비스는 작성되지 않습니다. INSTCONPARTIALSUCCESS 결과는 프로파일 작성이 종료되면 표시되고, 프로파일 작성 로그 app_server_root/logs/manageprofiles_create_profilename.log 에는 현재 사용자에게 Linux 서비스를 설정할 충분한 권한이 없음을 알리는 메시지가 포함됩니다.
- 기본 프로파일의 이름을 리턴합니다.
- 지정된 이름의 프로파일에 대한 파일 시스템 위치를 가져옵니다. –profileName 매개변수가 필요합니다.
- 지정된 -profilePath 매개변수에서 등록된 프로파일의 이름을 가져옵니다.
- 명령 구문을 표시합니다.
- 프로파일을 작성 중인 호스트 이름을 지정합니다. 이 이름은 초기 제품 설치 중 지정한 호스트 이름과 일치해야 합니다. 이 매개변수의 기본값은 도메인 이름 시스템의 긴 양식입니다. 이 매개변수 값은 올바른 IPv6 호스트 이름이어야 하며, 공백이나 유효하지 않은 문자를 포함할 수 없습니다(예: *, ?, ", <, >, ,, /, \, | 등).
- 기능이 보강된 특정 프로파일의 보강된 기능을 해제하도록 -templatePath 매개변수와 함께 사용되는 선택적 매개변수입니다. -unaugment 매개변수를 참조하십시오.
- 프로파일을 작성할 때 개인 인증서를 가져오는 데 사용할 키 저장소 파일에
대한 경로를 지정합니다. 이 개인 인증서는 서버의 기본 개인
인증서입니다. -importPersonalCertKS 매개변수와 -personalCertDN 매개변수는 상호 배타적입니다. 사용자가 특별히 개인 인증서를 작성하거나 가져오지 않는 경우에는 기본적으로 하나가 작성됩니다.
우수 사례: 개인 인증서를 기본 개인 인증서로 가져오는 경우에는
개인 인증서에 서명한 루트 인증서를 가져오십시오. 그렇지 않으면
manageprofiles 명령은 trust.p12 파일에 개인 인증서의
공개 키를 추가하고 루트 서명 인증서를 작성합니다. bprac-importPersonal로 시작하는 매개변수를 지정하는 경우 모두 지정해야 합니다.
- -importPersonalCertKS 매개변수에 지정하는 키 저장소 파일에 있는
인증서 별명을 지정합니다.
이 인증서는 서버 기본 키 저장소 파일에 추가되고 서버 기본 개인 인증서로
사용됩니다.
-importPersonal로 시작하는 매개변수를 지정하는 경우 모두 지정해야 합니다.
- -importPersonalCertKS 매개변수에 지정하는 키 저장소
파일의 비밀번호를 지정합니다.
-importPersonal로 시작하는 매개변수를 지정하는 경우 모두 지정해야 합니다.
- -importPersonalCertKS 매개변수에 지정하는 키 저장소 파일의 유형을 지정합니다.
값은 JCEKS, CMSKS, PKCS12, PKCS11, JKS입니다. 그러나 이 목록은 java.security
파일의 제공자에 따라 변경할 수 있습니다.
-importPersonal로 시작하는 매개변수를 지정하는 경우 모두 지정해야 합니다.
- 프로파일을 작성할 때 루트 인증서를 가져오기 위해 사용하는
키 저장소 파일의 경로를 지정합니다. 루트 인증서는 서버 기본 루트 인증서로
사용되는 인증서입니다.
-importSigningCertKS 매개변수는
-signingCertDN 매개변수와 상호 배타적입니다. 사용자가
특별히 루트 서명 인증서를 작성하거나 가져오지 않는 경우에는 기본적으로 하나가 작성됩니다.
-importSigning으로 시작되는 매개변수를 지정할 때에는 모두 지정해야 합니다.
- -importSigningCertKS 매개변수에 지정하는 키 저장소
파일에 있는 인증서 별명을 지정합니다.
이 인증서는 서버 기본 루트 키 저장소 파일에 추가되고 서버 기본 루트 인증서로 사용됩니다.
-importSigning으로 시작되는 매개변수를 지정할 때에는 모두 지정해야 합니다.
- -importSigningCertKS 매개변수에 지정한 키 저장소 파일의 비밀번호를 지정하십시오.
-importSigning으로 시작되는 매개변수를 지정할 때에는 모두 지정해야 합니다.
- importSigningCertKS 매개변수에 지정하는 키 저장소 파일의 유형을
지정합니다. 올바른 값은 JCEKS, CMSKS, PKCS12, PKCS11,
JKS입니다. 그러나 이 목록은 java.security
파일의 제공자에 따라 변경할 수 있습니다.
-importSigning으로 시작되는 매개변수를 지정할 때에는 모두 지정해야 합니다.
- 함께 사용된 -profileName 매개변수로 식별된 프로파일이 등록된 이후 기본 프로파일이 되도록 지정합니다. 기본 프로파일을 지정하는 명령을 실행할 때 명령의 -profileName 속성을 사용하지 않아도 됩니다.
- 서버가 개발용으로만 사용되도록 지정합니다. 이 매개변수는 프로덕션 애플리케이션 서버에 애플리케이션을
배치하기 전에 프로덕션이 아닌 서버에서 애플리케이션을 테스트하기 위해
프로파일을 작성하는 경우에 사용할 수 있습니다.
이 매개변수는 기본 프로파일 템플리트에만 유효합니다.
-isDeveloperServer 및 -applyPerfTuningSetting 매개변수를 모두 지정하는 경우 -applyPerfTuningSetting에 대해 선택한 옵션에 따라 -applyPerfTuningSetting이 -isDeveloperServer를 대체할 수 있습니다.
- 프로파일 작성 중에 작성된 모든 키 저장소 파일에 사용할 비밀번호를 지정합니다. 키 저장소 파일은 기본 개인 인증서 및 루트 서명 인증서용으로 작성됩니다.
- 프로파일 레지스트리에 있는 프로파일에 등록된 인수를 표시합니다. -profileName 매개변수를 -listAugments 매개변수와 함께 지정해야 합니다.
- 프로파일 레지스트리에 있는 프로파일을 나열합니다.
- 새 프로파일에 대해 작성되는 노드의 노드 이름을
지정합니다. 시스템에서 고유한 값을 사용하십시오.
동일한 제품 2진 세트를
공유하는 각 프로파일에서 노드 이름은 고유해야 합니다.
이
매개변수의 기본값은 축약형 호스트 이름, 프로파일 유형,
뒤에 오는 숫자를 기반으로 합니다.
다음과 같은 기본 노드 이름이 있습니다. 이 매개변수 값은 공백이나 유효하지 않은 문자를 포함할 수 없습니다(예: *, ?, ", <, >, ,, /, \, | 등).
- 프로파일 기능을 제외하는 선택적 매개변수입니다. 각 프로파일 템플리트는 특정한 선택적 기능으로 사전 정의되어 제공됩니다. 다음 선택적 기능은 다음 프로파일 템플리트에 대해 -omitAction 매개변수와 같이 사용할 수 있습니다.
- 프로파일을 작성할 때 작성하는 개인 인증서의 식별 이름을 지정합니다. 식별 이름은 따옴표로 묶어 지정하십시오. 이 기본 개인 인증서는 서버 키 저장소 파일에 있습니다. -importPersonalCertKSType 매개변수와 -personalCertDN 매개변수는 상호 배타적입니다. -personalCertValidityPeriod 매개변수 및 -keyStorePassword 매개변수를 참조하십시오.
- 새 프로파일에 대한 포트 설정을 정의하는 파일 경로를 지정하는 선택적 매개변수입니다.
-startingPort 또는 -defaultPorts 매개변수를 사용하는 경우에는 이 매개변수를 사용하지 마십시오.
-startingPort 매개변수, -defaultPorts 매개변수 또는 -portsFile 매개변수를 지정하지 않는 경우 프로파일 작성 중에 manageprofiles 명령은 자동으로 생성된 권장 포트 세트를 사용합니다. 권장 포트 값은 기본 포트의 가용성에 따라 기본 포트 값과 다를 수 있습니다.
- 프로파일 이름을 지정합니다. 프로파일을 작성할 때 고유한 값을
사용하십시오. 동일한 제품 2진 세트를 공유하는 각 프로파일의 이름은 고유해야
합니다. 기본 프로파일 이름은 프로파일 유형 및 뒤에 오는 번호에 기반합니다.
예를 들어 다음과 같습니다.
여기서<profile_type><profile_number>이 매개변수 값은 공백이나 유효하지 않은 문자를 포함할 수 없습니다(예: *, ?, ", <, >, ,, /, \, | 등).
사용 중인 프로파일 이름을 선택할 수 없습니다.
- profile_root로 참조되는 프로파일에 대한 완전한 경로를 지정합니다.
완전한 경로에
공백이 있는 경우 값을 따옴표로 묶으십시오.
기본값은
app_server_root 디렉토리, 프로파일 서브디렉토리,
프로파일 이름을 기반으로 합니다.
기본값은 user_data_root 디렉토리,
프로파일 서브디렉토리, 프로파일 이름을 기반으로 합니다. 예를 들어, 기본값은 다음과 같습니다.
WS_WSPROFILE_DEFAULT_PROFILE_HOME 요소는 app_server_root/properties 디렉토리의 wasprofile.properties 파일에 정의됩니다.WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName참고: wasprofile.properties 파일은 다음과 같은 특성을 포함합니다.- WS_CMT_PI_MODPERMS
- 이 특성에서는
사후 설치 프로그램이 작성하는 파일에 대한 권한 수정의 필요 여부를 지정합니다.
올바른 값은 true 또는 false입니다.
기타 기본값은 false입니다. 파일에서
이 특성을 제거하는 경우의 기본값도 false입니다.
값이 false로 설정되면 사후 설치 프로그램에서
작성된 모든 파일은 시스템의 umask 설정에 따라 권한이 부여됩니다.
이 매개변수 값은 대상 시스템의 올바른 경로여야 하며 현재 사용 중이면 안됩니다.
해당 디렉토리에 대한
쓰기 권한이 있어야 합니다.
QEJBSVR 프로파일은
디렉토리 쓰기 권한이 있어야 합니다. - WS_CMT_PI_LOGS
- 이 특성은 설치 후 프로그램에서 PROFILE_HOME/logs/service/productDir
디렉토리에 있는 각 제품에 대한 로그를 정리하는지 여부와 시점을 지정합니다.
이 특성에 대한 설정은 다음 로그 정리 기준을 지정하는 데
사용할 수 있습니다.
- PROFILE_HOME/logs/service/productDir 디렉토리에서 각 제품에 대해 보관할 로그 수를 지정할 수 있습니다. 지정된 값은 1에서 999 사이의 정수일 수 있습니다. 예를 들어, WS_CMT_PI_LOGS=5를 지정하면 사후 설치 프로그램은 각 제품에 대해 가장 최근의 로그 다섯 개를 보관합니다.
- 로그가 차지할 수 있는 최대 스토리지 크기를 지정할 수 있습니다.
지정된 값은 다음 단위를 따르는 1에서 999 사이의 정수 일 수 있습니다.
- KB(킬로바이트 단위로 값을 지정하는 경우)
- MB(메가바이트 단위로 값을 지정하는 경우)
- GB(기가바이트 단위로 값을 지정하는 경우)
문제점 방지: 지정된 값이 대소문자를 구분하기 때문에
지정된 값에 포함된 문자는 대문자여야 합니다. gotcha - 사후 설치 프로그램이 로그를 보관하고자 하는 시간을
지정할 수 있습니다. 지정된 값은 다음 단위를 따르는 1에서 999 사이의 정수 일 수 있습니다.
- D(일 단위로 값을 지정하는 경우)
- W(주 단위로 값을 지정하는 경우)
- M(월 단위로 값을 지정하는 경우)
- Y(년 단위로 값을 지정하는 경우)
문제점 방지: 지정된 값이 대소문자를 구분하기 때문에
지정된 값에 포함된 문자는 대문자여야 합니다. gotcha - 로그가 삭제는 특정 날짜 이후를 지정할 수 있습니다.
값은 DD-MM-YYYY 형식의 대시로 구분되는 숫자 값이어야 합니다. 예를 들어,
WS_CMT_PI_LOGS=12-31-2013을 지정하면
모든 로그가 2013년 12월 31에 삭제됩니다.
문제점 방지: 표시된 형식(대시로 구분되는 숫자)으로 값이 지정되지 않은 경우,
이 특성 설정은 무시됩니다. gotcha
- manageprofiles 명령을 사용하여 명령행에서 모든 API 함수에
액세스합니다.
명령 인터페이스는 특성 파일에서 지정된 명령에 대한 입력 인수를 키 및 값 형식으로 포함하는 응답 파일에 의해 구동될 수 있습니다. 다양한 유형의 프로파일 템플리트 및 조치에 필요한 입력 인수를 판별하려면 -help 매개변수와 함께 manageprofiles 명령을 사용합니다.
다음 예제 응답 파일을 사용하여 작성 조작을 실행하십시오.create profileName=testResponseFileCreate profilePath=profile_root templatePath=app_server_root/profileTemplates/default nodeName=myNodeName cellName=myCellName hostName=myHostName omitAction=myOptionalAction1,myOptionalAction2응답 파일을 작성할 때 다음과 같은 일련의 가이드라인을 고려하십시오.- 값을 지정할 때 값이 공백을 포함해도 값의 시작이나 끝에
큰따옴표(") 문자를 지정하지 마십시오. 참고: 명령행에서 값을 지정할 때와는 다른 규칙입니다.
- 쉼표 문자를 포함하는 단일 값(예: personalCertDN 및 signingCertDN
매개변수에 대한 식별 이름)을 지정하는 경우 쉼표 앞에 백슬래시 2개를 사용하십시오.
예를 들어 다음은 signingCertDN 값을 식별 이름으로 지정하는 방법입니다.
signingCertDN=cn=testserver.ibm.com\\,ou=Root Certificate\\, ou=testCell\\,ou=testNode01\\,o=IBM\\,c=US - 여러 값을 지정하는 경우 쉼표로 구분하고 백슬래시 2개를 사용하지
마십시오. 예를 들어 다음은
omitAction 매개변수에 대한 여러 값을 지정하는 방법입니다.
omitAction=deployAdminConsole,defaultAppDeployAndConfig - 응답 파일에서 빈 행은 지정하지 마십시오. 오류가 발생할 수 있습니다.
Windows 운영 체제의 경로문에서
슬래시(/) 또는 백슬래시(\)를 사용할 수 있습니다. 경로 명령문이 백슬래시를 사용하는 경우 응답 파일은
경로를 올바르게 이해하기 위해 이중 백슬래시가
필요합니다. 다음은 이중 백슬래시를 사용하는 작성 조작의 응답 파일 예제입니다. create templatePath=C:\\WebSphere\\AppServer\\profileTemplates\\default
우수 사례: 플랫폼 사이를 전환할 때
오류가 발생할 가능성을 줄이도록 슬래시를 사용합니다. bprac
- 값을 지정할 때 값이 공백을 포함해도 값의 시작이나 끝에
큰따옴표(") 문자를 지정하지 마십시오.
- 중요사항: manageProfiles -restoreProfile 명령은 동일 수정팩 레벨에서 작성된 백업에만 지원됩니다.프로파일 백업을 복원합니다. -backupFile 매개변수와 함께 사용해야 합니다. 예를 들어, 다음과 같습니다.
manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name프로파일을 복원하려면 다음 단계를 수행하십시오. - 서버의 이름을 지정합니다. 기본 및 보안 프록시 템플리트에만 이 매개변수를 지정하십시오. 기본값 또는 보안 프록시 템플리트를 사용할 때 이 매개변수를 지정하지 않는 경우, 기본 서버 이름은 기본 프로파일의 경우 server1, 보안 프록시 프로파일의 경우 proxy1입니다.
- 관리 프로파일의 유형을 지정합니다. 관리 에이전트 서버의 경우 ADMIN_AGENT를 지정합니다. 이 매개변수는 관리 프로파일을 작성할 경우 필수입니다.
Linux 서비스가
이 사용자 ID로 실행되도록 Linux 서비스 작성 중에 사용되는 사용자 ID를 지정합니다. 사용자 ID로 로그온할 때마다 Linux 서비스가 실행됩니다. - 기본 프로파일을 기존 프로파일 중 하나로
설정합니다. -profileName
매개변수와 함께 사용해야 합니다. 예를 들면 다음과 같습니다.
manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name - 프로파일을 작성할 때 작성하는 루트 서명 인증서의 식별 이름을 지정합니다. 식별 이름은 따옴표로 묶어 지정하십시오. 이 기본 개인 인증서는 서버 키 저장소 파일에 있습니다. -importSigningCertKS 매개변수는 -signingCertDN 매개변수와 상호 배타적입니다. 사용자가 특별히 루트 서명 인증서를 작성하거나 가져오지 않는 경우에는 기본적으로 하나가 작성됩니다. -signingCertValidityPeriod 매개변수 및 -keyStorePassword를 참조하십시오.
- 루트 서명 인증서가 유효한 기간(년)을 지정하는 선택적 매개변수입니다. 이 매개변수를 -signingCertDN 매개변수와 함께 지정하지 않으면 루트 서명 인증서는 15년간 유효합니다.
- 프로파일에 대한 모든 포트를 생성하고 지정하는 데 사용할 시작 포트 번호를
지정합니다.
포트 값은 이미 사용 중인 해당 포트를 생략하여
-startingPort 값부터 순차적으로 지정됩니다. 시스템은
현재 사용 중인 포트를 인식하여 분석하고
포트 충돌을 피할 수 있도록 포트 지정을 결정합니다.
포트 값은 -startingPort 값부터 순차적으로 지정됩니다.이 매개변수를 -defaultPorts 또는 -portsFile 매개변수와 함께 사용하지 마십시오.
-startingPort 매개변수, -defaultPorts 매개변수 또는 -portsFile 매개변수를 지정하지 않는 경우 프로파일 작성 중에 manageprofiles 명령은 자동으로 생성된 권장 포트 세트를 사용합니다. 권장 포트 값은 기본 포트의 가용성에 따라 기본 포트 값과 다를 수 있습니다.
주의: 관리 프로파일 템플리트를 사용하는 경우에는 이 매개변수를 사용하지 마십시오. - 설치 루트 디렉토리에서 템플리트 파일의 디렉토리 경로를
지정합니다. profileTemplates
디렉토리에는 다른 프로파일 유형에 해당하고 설치된 제품 유형에 따라
다른 다양한 디렉토리가 있습니다. 프로파일 디렉토리는
-templatePath 옵션을 사용하는 중에 표시하는 경로입니다.
설치 루트 외부에 있는 프로파일 템플리트를 지정할 수도
있습니다.
프로파일 템플리트가
app_server_root/profileTemplates
디렉토리에 대해 상대적인 경우 -templatePath 매개변수에 대한 상대 경로를
지정할 수 있습니다.
그렇지 않으면 완전한 템플리트 경로를 지정하십시오.
기본 템플리트 경로는
app_server_root/profileTemplates/default입니다.
-templatePath 매개변수에 대한 상대 경로를 사용할 수 있습니다.
이 경로는 해당 순서대로 현재 작업 디렉토리 또는 app_server_root/profileTemplates에 대한 상대 경로입니다. 다음 예제에서는
독립형 애플리케이션 서버의 기본값에 기반하여 프로파일을 작성합니다.
manageprofiles -create -profileName MyProfile -startingPort 10380사용 가능한 템플리트는 프로파일 개념 주제에서 설명합니다.
- 기능 보강은 기능 보강 템플리트를 사용하여 기존 프로파일을 변경하는 기능입니다.
기능이 보강된 프로파일의 보강된 기능을 해제하려면 -unaugment
매개변수 및 -profileName 매개변수를 지정해야 합니다. 일련의 manageprofiles
기능 보강이 수행되고 이 두 매개변수만 지정하여 프로파일의 보강된 기능을 해제하는 경우
보강된 기능 해제 조치에서는 먼저 마지막 기능 보강 조치를
실행 취소합니다.
기능이 보강된 특정 프로파일의 보강된 기능을 해제하려면 -ignoreStack 매개변수를 -templatePath 매개변수와 함께 추가로 지정합니다. 보통 프로파일 템플리트 종속성을 위반하지 않았는지 확인해야 하므로 특정 프로파일의 보강된 기능은 해제하지 않습니다.
-templatePath 매개변수를 사용하는 경우 이 매개변수에 대한 완전한 파일 경로를 지정합니다.
-templatePath 매개변수를 사용하는 경우 이 매개변수에 대한 상대 경로를 지정할 수 있습니다. 기능 보강 매개변수도 참조하십시오.
- 특정 기능 보강 템플리트를 사용하여 기능 보강된 모든 프로파일의 보강된
기능을 해제합니다. -templatePath 매개변수는 -unaugmentAll 매개변수에
필수인 매개변수입니다.
-templatePath 매개변수를 사용하는 경우 이 매개변수에 대한 완전한 파일 경로를 지정합니다.
-templatePath 매개변수를 사용하는 경우 이 매개변수에 대한 상대 경로를 지정할 수 있습니다. 선택적으로 -unaugmentDependents 매개변수와 -unaugmentAll 매개변수를 함께 지정하여 기능 보강을 해제하는 프로파일의 전제조건이 되는 모든 프로파일의 보강된 기능을 해제할 수도 있습니다.
참고: 프로파일 템플리트를 사용하여 기능 보강된 프로파일이 없을 때 이 매개변수를 사용하는 경우, 오류가 발생합니다.기능 보강 매개변수도 참조하십시오.
- 이를 지정한 경우 매개변수는
-unaugmentAll 매개변수로 보강된 기능을 해제하는 프로파일의 전제조건이 되는
모든 기능 보강된 프로파일의 보강된 기능을 해제합니다. 지정하지 않으면
보강된 기능을 해제할 프로파일의 전제조건이 되는 기능 보강된 프로파일의
보강된 기능을 해제하지 않습니다.
-unaugmentDependents 매개변수는 -unaugmentAll 매개변수와 함께 지정하십시오.
- 프로파일 레지스트리에 표시된 모든 프로파일을 확인하여 프로파일이 파일 시스템에 있는지 확인합니다. 레지스트리에서 누락된 프로파일은 모두 제거합니다. 레지스트리에서 삭제된, 누락된 프로파일 목록을 리턴합니다.
- 포트가 예약되어 있거나 사용 중이 아닌지 확인하십시오. 이 매개변수는 사용하지 않는 포트를 식별하는 데 도움이 됩니다. 포트가 사용 중인 것으로 판별되면 프로파일 작성이 중지되고 오류 메시지가 표시됩니다. 이 매개변수는 프로파일 작성 중에 명령행에서 언제든지 사용할 수 있습니다. 이 매개변수는 –portsFile 매개변수와 함께 사용하는 것이 좋습니다.
- 프로파일 레지스트리에 표시된 모든 프로파일을 확인하여 프로파일이 파일 시스템에 있는지 확인합니다. 누락된 프로파일 목록을 리턴합니다.
- 웹 서버 정의를 설정할지 여부를 표시합니다. 올바른 값은 true 또는 false입니다. 이 매개변수의 기본값은 false입니다.
- 서버의 호스트 이름입니다. 이 매개변수의 기본값은 로컬 시스템의 긴 호스트 이름입니다.
- 웹 서버, 로컬 또는 원격의 설치 경로입니다. 이 매개변수의 기본값은 로컬 시스템의 운영 체제 및 webServerType 매개변수 값에 따라 다릅니다. 예를 들면, 다음과 같습니다.
![[Windows]](../images/windows.gif)
webServerType=IHS: webServerInstallPath defaulted to “C:\Program Files\IBM\HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “C:\” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “C:\” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”![[Linux]](../images/linux.gif)
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”![[AIX]](../images/aixlogo.gif)
webServerType=IHS: webServerInstallPath defaulted to “/usr/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “?” webServerType=APACHE: webServerInstallPath defaulted to “?” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”![[HP-UX]](../images/hpux.gif)
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”![[Solaris]](../images/solaris.gif)
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”![[IBM i]](../images/iseries.gif)
webServerType=IHS: webServerInstallPath defaulted to “n\a” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “n\a” webServerType=DOMINO: webServerInstallPath defaulted to “n\a” webServerType=APACHE: webServerInstallPath defaulted to “n\a” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n\a”- 웹 서버의 이름입니다. 이 매개변수의 기본값은 webserver1입니다.
- 웹 서버가 상주하는 운영 체제입니다. 올바른 값은 windows, linux, solaris, aix, hpux, os390, os400입니다. webServerType 매개변수와 함께 이 매개변수를 사용하십시오.
- 웹 서버를 사용하는 플러그인의 경로입니다. 이 매개변수의 기본값은 WAS_HOMEplugins입니다.
- 웹 서버에 액세스하는 포트를 표시합니다. 이 매개변수의 기본값은 80입니다.
- 웹 서버의 유형입니다. 올바른 값은 IHS, SUNJAVASYSTEM, IIS, DOMINO, APACHE, HTTPSERVER_ZOS입니다. webServerOS 매개변수와 함께 이 매개변수를 사용하십시오.
프로파일에 대해 작성된 Windows 서비스의 소유자 계정 유형입니다.
올바른 값은 specifieduser 또는 localsystem입니다.
localsystem 값은 프로파일을 작성한 사용자의 로컬 계정으로
Windows 서비스를 실행합니다. 이 매개변수의
기본값은 localsystem입니다. 값이 specifieduser이면 winservicePassword 매개변수가 필요합니다. winserviceUserName 매개변수의 기본값은 지정되지 않은 경우 환경 사용자 이름 값입니다.
가능한 값은 true 또는 false입니다. 프로파일 내에 작성된 서버 프로세스에
대해 Windows 서비스를 작성하려면 true를 지정하십시오.
Windows
서비스를 작성하지 않으려면 false를 지정하십시오.
이 매개변수의 기본값은 false입니다. 중요사항: 사용자 정의 프로파일을 사용하는 경우 이 매개변수를 사용하여 Windows 서비스를 작성할 수 없습니다. 대신 WASService 명령을 사용하여 개별적으로 서비스를 작성하십시오.
Windows 서비스를 소유할 로컬 계정이나 지정된 사용자의
비밀번호를 지정합니다.
가능한 startup_type 값은 다음과 같습니다. Windows 서비스에 대한 자세한 정보는 WASService 명령에 대한 기사를 참조하십시오.
이 매개변수의 기본값은 automatic입니다.
Windows
운영 체제가 Windows
서비스를 작성할 수 있는 ID인지 사용자를 확인할 수 있도록
사용자 ID를 지정합니다. 사용자 ID는 관리자
그룹에 속하고 다음 고급 사용자 권한이 있어야 합니다. 중요사항: 사용자 및 비밀번호가 지정되어 있고 해당 사용자가 도메인 사용자인 Windows 서비스로 프로파일을 작성하는 경우 다음 예와 같이 이중 실선 백슬래시를 사용해야 합니다.winServiceUserName=DOMAIN\\DOMAINUSER winServicePassword=DOMAINUSERPASSWORD
사용법 시나리오
다음 예제에서는 올바른 구문을 보여줍니다. 다음 예제에 포함된 명령은 한 행으로 실행하십시오. 각 예제에서는 알아보기 쉽도록 명령을 둘 이상의 행으로 표시했습니다.
로그
예제: 시작 위치에서 기본 포트 번호 증분
manageprofiles 명령은 시작 포트 값을 기반으로 포트 번호를 지정할 수 있습니다. -startingPort 매개변수를 사용하여 명령행에서 시작 포트 값을 제공할 수 있습니다. 명령은 시작 포트 번호 값부터 순서대로 포트 번호를 지정합니다. 그러나 순서대로 지정된 포트 값이 기존 포트 할당과 충돌하는 경우 다음에 사용 가능한 포트 값이 사용됩니다.
포트는 임의적인 순서로 지정됩니다. 지정을 예측할 수는 없습니다.
예를 들어, -startingPort 20002로 작성된 포트는 다음 예제와 유사합니다.
WC_defaulthost=20002
WC_adminhost=20003
WC_defaulthost_secure=20004
WC_adminhost_secure=20005
BOOTSTRAP_ADDRESS=20006
SOAP_CONNECTOR_ADDRESS=20007
IPC_CONNECTOR_ADDRESS=20008
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20009
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20010
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20011
ORB_LISTENER_ADDRESS=20012
DCS_UNICAST_ADDRESS=20013
SIB_ENDPOINT_ADDRESS=20014
SIB_ENDPOINT_SECURE_ADDRESS=20015
SIB_MQ_ENDPOINT_ADDRESS=20016
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20017
SIP_DEFAULTHOST=20018
SIP_DEFAULTHOST_SECURE=20019
다음 예제는 manageprofiles 명령의 startingPort 매개변수를 사용하고 이전 예제에 표시된 컨텐츠로 초기값 20002에서 포트를 작성합니다.
![[Windows]](../images/windows.gif)
manageprofiles.bat -create
-profileName shasti
-profilePath G:\shasti\WebSphere
-templatePath G:\shasti\WebSphere\profileTemplates\default
-nodeName W2K03
-cellName W2K03_Cell01
-hostName planetnt
-startingPort 20002
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
app_server_root/bin/manageprofiles.sh -create
-profileName shasti
-profilePath app_server_root/profiles/shasti
-templatePath app_server_root/profileTemplates/default
-nodeName W2K03
-cellName W2K03_Cell01
-hostName planetnt
-startingPort 20002
![[IBM i]](../images/iseries.gif)
app_server_root/bin/manageprofiles -create
-profileName shasti
-profilePath user_data_root/profiles/shasti
-templatePath app_server_root/profileTemplates/default
-nodeName W2K03
-cellName W2K03_Cell01
-hostName planetnt
-startingPort 20002
예: 사전 정의된 포트 번호 사용
명시적으로 포트 값을 설정하지 않으면 manageprofiles 명령이 초기 포트 값을 권장합니다. 대신 사전 정의된 포트 값을 사용할 수도 있습니다.
| 프로파일 | 파일 경로 |
|---|---|
| 애플리케이션 서버 | app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props |
| 관리 에이전트 서버의 관리 프로파일 | app_server_root/profileTemplates/management/actions/portsUpdate/adminagent.portdef.props |
WC_defaulthost=39080
WC_adminhost=39060
WC_defaulthost_secure=39443
WC_adminhost_secure=39043
BOOTSTRAP_ADDRESS=32809
SOAP_CONNECTOR_ADDRESS=38880
IPC_CONNECTOR_ADDRESS=39633
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=39401
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=39403
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=39402
ORB_LISTENER_ADDRESS=39100
DCS_UNICAST_ADDRESS=39353
SIB_ENDPOINT_ADDRESS=37276
SIB_ENDPOINT_SECURE_ADDRESS=37286
SIB_MQ_ENDPOINT_ADDRESS=35558
SIB_MQ_ENDPOINT_SECURE_ADDRESS=35578
SIP_DEFAULTHOST=35060
SIP_DEFAULTHOST_SECURE=35061
manageprofiles 명령을 실행하여 사용자 정의 포트 값으로 프로파일을 작성하면 성공 또는 실패 결과가 표시됩니다.
참고: 프로파일을
성공적으로 작성한 후에 콘솔은 성공을 표시하는 메시지를 인쇄하고
AboutThisProfile.txt 파일을 확인할 것을 조언합니다.
그러나 IBM i에서 클라이언트 프로파일 또는 플러그인 프로파일을 작성하는 경우
AboutThisProfile.txt 파일은 생성되지 않습니다.manageprofiles 명령은 profile_root\properties 디렉토리에 있는 현재 portdefs.props 파일의 사본을 작성합니다.
manageprofiles 명령과 함께 세 개의 포트 값 매개변수 -startingPort, -defaultPorts 또는 -portsFile 중에서 하나만 사용하십시오. 이 세 매개변수는 상호 배타적입니다.
![[AIX HP-UX Solaris]](../images/unix.gif)
참조 주제