bpeconfig.jacl 스크립트 파일을 사용하여 Business Process Choreographer 구성

이 스크립트 파일은 Business Process Choreographer에서 필요한 모든 자원을 구성합니다.

용도

이 스크립트를 대화식 또는 일괄처리 모드로 실행할 수 있습니다. 이 스크립트는 설치 마법사 또는 관리 콘솔을 사용하지 않고 작동 중인 비즈니스 프로세스 컨테이너 및 휴먼 타스크 컨테이너를 구성합니다. 또한 로컬 데이터베이스 및 필수 메시징 자원을 작성하고 Business Process Choreographer 탐색기도 구성합니다. 클러스터에 있는 Application Server에 스크립트를 적용하는 경우, Business Process Choreographer를 사용하도록 클러스터의 모든 서버가 구성됩니다.

위치

bpeconfig.jacl 스크립트 파일은 Business Process Choreographer config 디렉토리에 있습니다.

제한사항

이 스크립트에는 다음 제한사항이 있습니다.
ND 환경 또는 클러스터
ND 환경 또는 클러스터에서 여러 Application Server를 구성하려면 bpeconfig.jacl 스크립트를 대화식으로 실행해야 합니다. 비대화식으로 실행하는 경우에는 해당 스크립트를 사용하여 이 유형의 구성을 수행할 수 없습니다.
z/OS용 DB2 데이터베이스 사용
bpeconfig.jacl 스크립트로는 z/OS용 DB2 데이터베이스를 작성할 수 없습니다. 해당 데이터베이스를 수동으로 작성해야 합니다.
Oracle 데이터베이스 사용
bpeconfig.jacl 스크립트로는 로컬 Oracle 데이터베이스를 작성할 수 없습니다. Business Process Choreographer에 로컬 Oracle 데이터베이스를 사용하려는 경우 데이터베이스를 수동으로 작성해야 합니다.

독립형 서버 환경에서 스크립트 실행

독립형 서버 환경에서 다음을 수행하십시오.
  • Application Server가 실행 중이 아닌 경우에만 -conntype NONE 옵션을 포함시키십시오.
  • 서버가 실행 중이고 글로벌 보안이 사용 가능한 경우, -user-password 옵션을 포함시키십시오.
  • 기본 프로파일을 구성하고 있지 않은 경우, -profileName 옵션을 추가하십시오.

ND 환경에서 스크립트 실행

Network Deployment 환경에서 다음을 수행하십시오.
  • Deployment Manager 노드에서 스크립트를 실행하십시오.
  • Deployment Manager가 실행 중이 아닌 경우에만 -conntype NONE 옵션을 포함시키십시오.
  • 글로벌 보안이 사용 가능한 경우, -user-password 옵션을 포함하십시오.
  • 기본 프로파일을 구성하고 있지 않은 경우, -profileName 옵션을 추가하십시오.

비대화식으로 비즈니스 프로세스 컨테이너, Business Process Choreographer 탐색기 및 Business Process Choreographer 옵저버 구성

명령행에 필수 매개변수를 제공하는 경우, 매개변수를 입력하도록 프롬프트가 표시되지 않습니다. Business Process Choreographer를 구성하려면 다음 명령 중 하나를 입력하십시오.

UNIX 및 Linux 시스템에서는 현재 디렉토리가 install_root이면 다음 명령을 입력하십시오.

bin/wsadmin.sh -f ProcessChoreographer/config/bpeconfig.jacl parameters

Windows 시스템에서는 현재 디렉토리가 install_root이면 다음 명령을 입력하십시오.

bin\wsadmin -f ProcessChoreographer/config/bpeconfig.jacl parameters
여기서 parameters는 다음과 같습니다.
       -conntype NONE
       -user  userName
       -password  userPassword
       -profileName profileName
      {-node nodeName -server serverName}
      {-adminBFMUsers userList   | -adminBFMGroups groupList}
      {-monitorBFMUsers userList | -monitorBFMGroups groupList}
       -jmsBFMRunAsUser userID
       -jmsBFMRunAsPwd password
      {-adminHTMUsers userList   | -adminHTMGroups groupList}
      {-monitorHTMUsers userList | -monitorHTMGroups groupList}
       -jmsHTMRunAsUser userID
       -jmsHTMRunAsPwd password
       -contextRootBFM contextRootBFM
       -contextRootHTM contextRootHTM
       -mailServerName mailServerName
       -mailUser mailUserID
       -mailPwd mailPassword
       -hostName explorerVirtualHostname
       -explorerHost explorerURL
       -remoteNodeName nodeName
       -remoteServerName serverName
       -remoteClusterName clusterName
       -contextRootExplorer explorerContextRoot
       -createDB { yes | no }
       -dbType databaseType
       -dbVersion version
       -dbHome databaseInstallPath
       -dbJava JDBCDriverPath
       -dbName databaseName
       -dbUser databaseUser
       -dbPwd databasePassword
       -dbAdmin databaseAdministratorUserID
       -driverType JDBCDriverType
       -dbTablespaceDir databaseTablespacePath
       -dbServerName databaseServerName
       -dbServerPort databaseServerPort
       -dbStorageGroup DB2zOSStorageGroup
       -dbSubSystem DB2zOSSubSystem
       -dbSQLID DB2zOSSchemaQualifier
       -dbInstance InformixInstance
       -mqType JMSProviderType
       -createQM { yes | no }
       -qmNameGet getQueueManagerName
       -mqClusterName appServerClusterName
       -qmNamePut putQueueManagerName
       -mqHome MQInstallationDirectory
       -mqUser JMSProviderUserID
       -mqPwd JMSProviderPassword
       -mqSchemaName mqSchemaName
       -mqCreateTables  { true | false }
       -mqDataSource datasourceName
       -shell shell
       -createEventCollector { yes | no } 
       -createObserver { yes | no }
주: 위 매개변수 중 일부는 기타 매개변수에 대해 제공된 값에 따라 선택적입니다. 각 매개변수에 대한 매개변수 간의 종속성 및 매개변수가 선택 또는 필수인지 판별하는 조건이 아래에 설명되어 있습니다. 명령행에 지정되지 않은 필수 매개변수에 대해 프롬프트가 대화식으로 표시됩니다.

매개변수

wsadmin을 사용하여 스크립트를 호출할 때 다음 매개변수를 사용할 수 있습니다.
conntype NONE
이는 관리 연결이 사용 불가능함을 지정합니다. Application Server(독립형) 또는 Deployment Manager(ND용)가 실행되고 있지 않은 경우에만 이 옵션을 포함합니다.
user userName
글로벌 보안이 사용 가능한 경우 인증을 위한 사용자 ID를 제공해야 합니다.
password userPassword
글로벌 보안이 사용 가능한 경우 사용자 ID userName에 대해 암호를 제공해야 합니다.
profileName profileName
여기서 profileName은 사용자 정의 프로파일의 이름입니다. 기본 프로파일을 구성 중이 아닌 경우 이 옵션을 지정하십시오.
node nodeName
여기서 nodeName은 Business Process Choreographer가 구성되는 노드의 이름입니다. 노드가 하나뿐이고 서버도 정확히 하나인 경우 이 매개변수는 선택적입니다.
server serverName
여기서 serverName은 Business Process Choreographer가 구성되는 서버의 이름입니다. 노드가 하나뿐이고 서버도 정확히 하나인 경우 이 매개변수는 선택적입니다.
adminBFMUsers userList
여기서, userList는 사용자 레지스트리의 사용자 이름 목록이며 BPESystemAdministrator J2EE(Java 2 Enterprise Edition) 역할이 맵핑됩니다. 분리 문자는 수직선(|)입니다. 이 특성은 비즈니스 프로세스 컨테이너를 설치하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. adminBFMUsers 또는 adminBFMGroups 옵션 중 하나 또는 모두를 설정해야 합니다.
adminBFMGroups groupList
여기서 groupList는 사용자 레지스트리의 그룹 이름 목록으로, 여기에 BPESystemAdministrator J2EE 역할을 맵핑합니다. 분리 문자는 수직선(|)입니다. 이 특성은 비즈니스 프로세스 컨테이너를 설치하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. adminBFMUsers 또는 adminBFMGroups 옵션 중 하나 또는 모두를 설정해야 합니다.
monitorBFMUsers userList
여기서 userList는 사용자 레지스트리의 사용자 이름 목록으로, 여기에 BPESystemMonitor J2EE 역할을 맵핑합니다. 분리 문자는 수직선(|)입니다. 이 특성은 비즈니스 프로세스 컨테이너를 설치하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. monitorBFMUsers 또는 monitorBFMGroups 중 하나 또는 둘 다를 설정해야 합니다.
monitorBFMGroups groupList
여기서 groupList는 사용자 레지스트리의 그룹 이름 목록으로, 여기에 BPESystemMonitor J2EE 역할을 맵핑합니다. 분리 문자는 수직선(|)입니다. 이 특성은 비즈니스 프로세스 컨테이너를 설치하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. monitorBFMUsers 또는 monitorBFMGroups 중 하나 또는 둘 다를 설정해야 합니다.
jmsBFMRunAsUser userID
여기서, userID는 J2EE 역할 JMSAPIUser에 대한 사용자 레지스트리의 run-as 사용자 ID입니다. 이 특성은 비즈니스 프로세스 컨테이너를 구성하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. 반드시 설정해야 합니다.
jmsBFMRunAsPwd password
여기서, passwordjmsBFMRunAsUser 사용자 ID의 암호입니다. 이 특성은 비즈니스 프로세스 컨테이너를 구성하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. 반드시 설정해야 합니다.
adminHTMUsers userList
여기서 userList는 사용자 레지스트리의 사용자 이름 목록으로, 여기에 TaskSystemAdministrator J2EE(Java 2 Enterprise Edition) 역할을 맵핑합니다. 분리 문자는 수직선(|)입니다. 이 특성은 휴먼 타스크 컨테이너를 설치하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. adminHTMUsers 또는 adminHTMGroups 옵션 중 하나나 모두를 설정해야 합니다.
adminHTMGroups groupList
여기서 groupList는 사용자 레지스트리의 그룹 이름 목록으로, 여기에 TaskSystemAdministrator J2EE 역할을 맵핑합니다. 분리 문자는 수직선(|)입니다. 이 특성은 휴먼 타스크 컨테이너를 설치하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. adminHTMUsers 또는 adminHTMGroups 옵션 중 하나나 모두를 설정해야 합니다.
monitorHTMUsers userList
여기서 userList는 사용자 레지스트리의 사용자 이름 목록으로, 여기에 TaskSystemMonitor J2EE 역할을 맵핑합니다. 분리 문자는 수직선(|)입니다. 이 특성은 휴먼 타스크 컨테이너를 설치하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. monitorHTMUsers 또는 monitorHTMGroups 중 하나 또는 둘 다를 설정해야 합니다.
monitorHTMGroups groupList
여기서 groupList는 사용자 레지스트리의 그룹 이름 목록으로, 여기에 TaskSystemMonitor J2EE 역할을 맵핑합니다. 분리 문자는 수직선(|)입니다. 이 특성은 휴먼 타스크 컨테이너를 설치하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. monitorHTMUsers 또는 monitorHTMGroups 중 하나 또는 둘 다를 설정해야 합니다.
jmsHTMRunAsUser userID
여기서, userID는 J2EE 역할 EscalationUser에 대한 사용자 레지스트리의 run-as 사용자 ID입니다. 이 특성은 휴먼 타스크 컨테이너를 구성하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. 반드시 설정해야 합니다.
jmsHTMRunAsPwd password
여기서, passwordjmsHTMRunAsUser 사용자 ID의 암호입니다. 이 특성은 휴먼 타스크 컨테이너를 구성하는 데 필요합니다. 이 매개변수에는 기본값이 없습니다. 반드시 설정해야 합니다.
contextRootBFM contextRootBFM
여기서, contextRootBFM은 웹 서비스 엔드포인트 URL의 컨텍스트 루트입니다. 비즈니스 플로우 관리자(BFM)의 경우, 서버에서 기본 컨텍스트 루트는 /BFMIF_${nodeName}_${serverName}입니다. 클러스터에서 기본값은 /BFMIF_${clusterName}입니다. 반드시 설정해야 합니다.
contextRootHTM contextRootHTM
여기서, contextRootHTM은 웹 서비스 엔드포인트 URL의 컨텍스트 루트입니다. 휴먼 타스크 관리자(HTM)의 경우, 서버에서 기본 컨텍스트 루트는 /HTMIF_${nodeName}_${serverName}입니다. 클러스터에서 기본값은 /HTMIF_${clusterName}입니다. 반드시 설정해야 합니다.
mailServerName mailServerName
여기서 mailServerName은 휴먼 타스크 관리자가 공고 메일을 전송하는 데 사용할 메일 서버의 호스트 이름입니다. 이는 메일 세션을 구성할 때 필요합니다. 이 매개변수가 설정되지 않으면 메일 세션 구성을 건너뜁니다. 기본값은 로컬 호스트의 완전한 호스트 이름입니다.
mailUser mailUserID
여기서 mailUserID는 메일 서버에 액세스하기 위한 사용자 ID입니다. 이는 휴먼 타스크 관리자가 공고 메일을 전송하기 위해 메일 세션을 작성하는 데 필요합니다. 기본값은 비어 있으며 이 경우에는 인증이 필요하지 않습니다.
mailPwd mailPassword
여기서 mailPassword는 메일 서버에 액세스하기 위한 암호입니다. 이는 휴먼 타스크 관리자가 공고 메일을 전송하기 위해 메일 세션을 작성하는 데 필요합니다.
hostName explorerVirtualHostname
여기서 explorerVirtualHostname은 Business Process Choreographer 탐색기가 실행되는 가상 호스트입니다. 기본값은 default_host입니다.
explorerHost explorerURL
여기서 explorerURL은 Business Process Choreographer 탐색기의 URL입니다. 이 매개변수를 비클러스터 환경에 지정하지 않으면 기본값이 계산됩니다 (예: http://localhost:9080). 이 매개변수 값은 휴먼 타스크 관리자의 scale="90" EscalationMail.ClientDetailURL 사용자 정의 특성에 사용됩니다.
precompileJSPs { yes | no }
JSP(Java Server Page)를 사전 컴파일할지 여부를 판별합니다.
remoteNodeName nodeName
로컬 Business Process Choreographer 탐색기에 연결하지 않으려면 이 매개변수 및 remoteServerName을 사용하십시오. nodeserver 매개변수 또는 cluster 매개변수로 식별된 Business Process Choreographer 서버에 연결하려면 이 매개변수를 지정하지 마십시오.
remoteServerName serverName
로컬 Business Process Choreographer 탐색기에 연결하지 않으려면 이 매개변수 및 remoteNodeName을 사용하십시오. nodeserver 매개변수 또는 cluster 매개변수로 식별된 Business Process Choreographer 서버에 연결하려면 이 매개변수를 지정하지 마십시오.
remoteClusterName clusterName
로컬 Business Process Choreographer 탐색기에 연결하지 않고 remoteNodeNameremoteServerName을 지정하지 않으려면 이 매개변수를 사용하십시오. nodeserver 매개변수 또는 cluster 매개변수로 식별된 Business Process Choreographer 서버에 연결하려면 이 매개변수를 지정하지 마십시오.
contextRootExplorer contextRootExplorer
여기서, contextRootExplorer는 Business Process Choreographer 탐색기의 컨텍스트 루트입니다. 기본값은 /bpc이며 기본 URL은 http://host:port/contextRootExplorer입니다. 컨텍스트 루트는 WebSphere 셀에서 고유해야 합니다.
createDB { yes | no }
가능한 값은 yes 또는 no입니다. yes에 설정할 경우 스크립트가 데이터베이스를 작성합니다. z/OS 데이터베이스 및 Oracle의 경우 이 스크립트가 데이터베이스를 작성할 수 없으며 테이블 영역 및 테이블만 작성할 수 있습니다. 기타 데이터베이스 유형의 경우 기본값이 yes입니다.
dbType databaseType
여기서 databaseType은 데이터베이스 유형입니다. 이는 비즈니스 프로세스 컨테이너 설치, 데이터베이스 또는 데이터베이스 테이블 작성 및 데이터 소스 작성에 필요합니다. 기본값은 없습니다. 가능한 값은 다음과 같습니다.
  • Cloudscape
  • DB2
  • zOS-DB2
  • Informix
  • MSSQL
  • Oracle
dbVersion version
여기서, version은 데이터베이스 버전 번호입니다. 기본값은 없습니다.이 값은 다음 데이터베이스 유형에만 필요합니다.
  • z/OS용 DB2의 경우, version 값은 7 또는 8이어야 합니다.
  • Oracle의 경우, version 값은 9 또는 10이어야 합니다.
  • MSSQL의 경우, version 값은 데이터베이스에 Unicode가 지원되지 않으면 2000, Unicode가 지원되면 200U입니다.
dbHome databaseInstallPath
여기서 databaseInstallPath는 데이터베이스 시스템의 설치 디렉토리입니다. 이는 데이터베이스 또는 데이터베이스 테이블 작성 및 데이터 소스 작성에 사용합니다. 기본값과 요구사항은 데이터베이스 및 플랫폼에 따라 다릅니다.
DB2의 경우:
  • Windows 플랫폼에서 기본값은 current_drive\Program Files\IBM\SQLLIB이며, 여기서 current_drive는 현재 드라이브 이름입니다.
  • Solaris 플랫폼에서 기본값은 /export/home/${dbUser}/sqllib입니다.
  • 기타 플랫폼에서 기본값은 /home/${dbUser}/sqllib입니다.
디렉토리 ${dbHome}/bnd${dbHome}/bin이 존재해야 합니다.
Informix의 경우:
  • Windows 플랫폼에서 기본값은 current_drive\Program Files\Informix이며, 여기서, current_drive는 현재 드라이브 이름입니다.
  • Solaris 및 HP-UX 플랫폼에서 기본값은 /opt/informix입니다.
  • Linux 및 AIX 플랫폼에서 기본값은 /user/informix입니다.
파일 ${dbHome}/jdbc/lib/ifxjdbc.jar가 존재해야 합니다.
Oracle의 경우:
  • Windows 플랫폼에서 기본값은 c:\oracle\ora90입니다.
  • Solaris 및 HP-UX 플랫폼에서 기본값은 /opt/oracle입니다.
  • 기타 플랫폼에서 기본값은 /usr/oracle입니다.
파일 ${dbHome}/jdbc/lib/odbc14.jar가 존재해야 합니다.
dbJava JDBCDriverPath
여기서 JDBCDriverPath는 JDBC 드라이버가 위치한 디렉토리입니다. 이 매개변수는 다음과 같은 조합의 데이터베이스 및 드라이버 유형에만 필요합니다.
  • 드라이버 유형이 4인 DB2. 기본값은 ${dbHome}/java입니다.
  • 드라이버 유형이 4인 z/OS용 DB2. 기본값은 ${dbHome}/classes입니다.
  • 드라이버 유형이 DataDirect인 MSSQL 데이터 소스. 기본값은 없습니다.
  • Oracle. 기본값은 ${dbHome}/jdbc/lib입니다.
dbName databaseName
여기서 databaseName은 Business Process Choreographer 데이터베이스의 이름입니다. 이는 데이터베이스 또는 데이터베이스 테이블 작성 및 데이터 소스 작성에 사용합니다. Oracle의 경우 이는 TNS입니다. 기본값은 BPEDB입니다.
dbUser databaseUser
여기서 databaseUser는 데이터베이스에 액세스하기 위한 사용자 ID입니다. 이는 데이터베이스 테이블 작성 및 데이터 소스 작성에 사용합니다. 기본값은 데이터베이스 및 플랫폼에 따라 다릅니다.
  • Windows 플랫폼의 DB2인 경우: "db2admin"
  • 기타 플랫폼의 DB2인 경우: "db2inst1"
  • Oracle의 경우: "system"
  • MSSQL의 경우: <현재 로그온한 사용자>
dbPwd databasePassword
여기서databasePassword는 사용자 ID databaseUser의 암호입니다.
dbAdmin databaseAdministratorUserID
여기서 databaseAdministratorUserID는 데이터베이스 관리자의 사용자 ID입니다. Linux 및 UNIX 플랫폼에서 다음 데이터베이스 유형에 대해 데이터베이스 및 데이터베이스 테이블을 작성할 때만 필요합니다.
  • z/OS용 DB2의 경우 기본값은 db2inst1입니다.
  • Oracle의 경우 기본값은 oracle입니다.
driverType JDBCDriverType
여기서 JDBCDriverType은 JDBC 드라이버의 유형입니다. 이는 데이터 소스 작성에 사용합니다.
  • DB2의 경우 가능한 값은 Universal 또는 CLI입니다.
  • Oracle의 경우 가능한 값은 oci8 또는 thin입니다. 이는 비즈니스 프로세스 컨테이너를 설치하는 데도 사용합니다.
  • MSSQL의 경우 가능한 값은 Embedded 또는 DataDirect입니다.
dbTablespaceDir databaseTablespacePath
여기서 databaseTablespacePath는 데이터베이스 테이블 영역이 작성되는 디렉토리입니다. 이는 데이터베이스 및 데이터베이스 테이블 작성에 사용합니다. 이 매개변수는 다음 데이터베이스 유형에만 필요합니다.
  • Oracle의 경우 기본값은 없습니다. 값을 제공해야 합니다.
  • DB2의 경우 기본값이 비어 있으며 이는 테이블 영역이 작성되지 않음을 의미합니다.
dbServerName databaseServerName
여기서 databaseServerName은 Business Process Choreographer에 대해 데이터베이스를 호스트하는 호스 이름 서버입니다. 이는 데이터 소스 작성에 사용합니다.
  • DB2의 경우 기본값은 비어 있습니다. DB2 UDB의 경우 이 매개변수는 선택적이며, 지정되지 않은 경우 DB2에 대해 유형 2 JDBC 드라이버가 구성됩니다. 그렇지 않은 경우에는 유형 4 JDBC 프로바이더가 구성됩니다.
  • 기타 모든 데이터베이스 유형의 경우 기본값은 로컬 호스트의 완전한 호스트 이름입니다.
dbServerPort databaseServerPort
여기서 databaseServerPort는 Business Process Choreographer용 데이터베이스 서버의 TCP/IP 포트입니다. 이 매개변수는 dbServerName이 지정된 경우에 필요합니다.
  • DB2의 경우 기본값은 50000입니다.
  • Informix의 경우 기본값은 1526입니다.
  • MSSQL의 경우 기본값은 1433입니다.
  • 드라이버 유형이 thin인 Oracle의 경우 기본값은 1521입니다.
dbStorageGroup DB2zOSStorageGroup
여기서 DB2zOSStorageGroup은 Business Process Choreographer 데이터베이스 테이블을 작성하는 데 사용하는 기억장치 그룹입니다. 이 매개변수는 z/OS의 DB2에만 필요합니다. 기본값이 없으며 비워둘 수 없습니다.
dbSubSystem DB2zOSSubSystem
여기서 DB2zOSSubSystem은 Business Process Choreographer 데이터베이스 테이블 및 데이터 소스를 작성하는 데 사용하는 DB2 서브시스템입니다. 이 매개변수는 z/OS의 DB2에만 필요합니다. 기본값은 BPEDB입니다.
dbSQLID DB2zOSSchemaQualifier
여기서 DB2zOSSchemaQualifier는 데이터베이스 테이블을 작성하는 데 사용하는 스키마 규정자입니다. 이 매개변수는 z/OS의 DB2에만 필요합니다. 기본값은 없습니다. 값을 비워둘 수 있습니다. Universal JDBC 드라이버 유형을 사용하는 경우에만 값을 지정하십시오.
dbInstance InformixInstance
여기서 InformixInstance는 Business Process Choreographer Informix 데이터베이스의 인스턴스 이름입니다. 기본값은 ids1입니다.
mqType JMSProviderType
여기서 JMSProviderType은 Business Process Choreographer에 사용할 JMS(Java Message Service) 프로바이더 유형입니다. 이는 대기열 관리자 및 대기열, 리스너 포트 또는 ActivationSpecs, 대기열 연결 팩토리를 작성하는 데 사용합니다.

여기서 JMSProviderType은 다음 값 중 하나입니다.

WPM
기본 메시징의 경우(WebSphere 플랫폼 메시징). 이 옵션은 항상 사용 가능합니다.
MQSeries
WebSphere MQ의 경우. 이 옵션의 경우 제품 WebSphere MQ를 설치해야 합니다.
createQM { yes | no })
스크립트에서 로컬 WebSphere MQ 대기열 관리자를 작성하는지 여부를 제어합니다. 이 옵션은 매개변수 mqType에 값 MQSeries가 있는 경우에만 적용됩니다. 이 매개변수의 기본값은 yes입니다. 스크립트에서 WebSphere MQ 대기열 관리자를 작성하지 않으려는 경우 no 값을 사용하십시오. 예를 들어, 스크립트를 실행하는 서버와 다른 서버에서 대기열 관리자를 작성하려는 경우입니다.
qmNameGet getQueueManagerName
여기서 getQueueManagerName은 GET 요청에 대한 대기열 관리자 이름입니다. 대기열 관리자 및 대기열을 작성하고 리스너 포트 및 대기열 연결 팩토리를 작성하는 데 사용합니다. - 문자를 포함해서는 안됩니다. getQueueManagerName의 기본값은 BPC_nodeName_serverName입니다. 이 옵션은 매개변수 mqType에 값 MQSeries가 있는 경우에만 적용됩니다.
mqClusterName appServerClusterName
여기서 appServerClusterName은 기본 JMS 프로바이더의 메시지 엔진이 작성되는 WebSphere Application Server 클러스터의 이름입니다. WebSphere MQ 클러스터와 상관이 없습니다. 이 옵션은 클러스터에서 Business Process Choreographer를 구성하고 mqType 옵션이 WPM으로 설정된 경우에만 사용됩니다.
qmNamePut putQueueManagerName
여기서 putQueueManagerName은 PUT 요청에 대한 대기열 관리자 이름입니다. 이는 mqClusterName 매개변수가 설정된 경우에만 사용합니다. 대기열 관리자 및 대기열을 작성하고 리스너 포트 및 대기열 연결 팩토리를 작성하는 데 사용합니다. - 문자를 포함해서는 안되며 qmNameGet 매개변수에 대해 지정된 대기열 관리자 이름과 동일해서도 안됩니다. putQueueManagerName의 기본값은 BPCC_nodeName_serverName입니다.
mqHome MQInstallationDirectory
여기서 MQInstallationDirectory는 WebSphere MQ 설치 디렉토리입니다. 이는 대기열 관리자 및 대기열을 작성하고(Windows 시스템의 경우만) 리스너 포트 및 대기열 연결 팩토리를 작성하는 데 사용합니다. WebSphere 변수 MQ_INSTALL_ROOT가 설정된 경우 값이 사용되며 수정되지 않습니다. 이 옵션은 매개변수 mqType에 값 MQSeries가 있는 경우에만 적용됩니다.

MQ_INSTALL_ROOT가 설정되지 않을 경우 MQInstallationDirectory에 사용하는 기본값이 플랫폼에 따라 다릅니다.

Windows 시스템:
current_drive\Program Files\IBM\WebSphere MQ
AIX:
/usr/mqm
Solaris 및 HP-UX:
/opt/mqm
mqUser JMSProviderUserID
여기서 JMSProviderUserID는 JMS 프로바이더에 액세스하기 위한 사용자 ID입니다.
  • mqType에 WPM 값이 있는 경우 이 매개변수를 사용하여 ActivationSpecs 및 연결 팩토리를 작성합니다. 기본값은 현재 로그온한 사용자입니다.
  • mqType에 MQSeries 값이 있는 경우 비Windows 플랫폼에서 이 매개변수를 사용하여 대기열 관리자 및 대기열을 작성합니다. JMSProviderUserID의 기본값은 플랫폼에 따라 다릅니다.
    Windows 시스템:
    currently_logged-on_user
    Linux 및 UNIX 시스템
    mqm
mqPwd JMSProviderPassword
여기서 JMSProviderPasswordmqUser에 대해 제공된 사용자 ID의 암호입니다. 이 매개변수에는 기본값이 없습니다.
mqSchemaName mqSchemaName
여기서 mqSchemaName은 기본 JMS 프로바이더의 메시징 엔진에 대한 데이터베이스 스키마의 이름입니다. 기본값은 BPEME입니다. 이 옵션은 클러스터에서 Business Process Choreographer를 구성하고 mqType 옵션이 WPM으로 설정된 경우에만 사용됩니다.
mqCreateTables { true | false}
이 부울 매개변수는 첫 번째 연결 시 기본 JMS 프로바이더가 메시지 엔진 데이터베이스에서 테이블을 자동으로 작성하는지 여부를 제어합니다. 기본값은 true입니다. 이 옵션은 클러스터에서 Business Process Choreographer를 구성하고 mqType 옵션이 WPM으로 설정된 경우에만 사용됩니다.
mqDataSource datasourceName
datasourceName은 JMS 프로바이더의 메시지 엔진에 의해 사용되는 데이터 소스의 JNDI 이름입니다. mqClusterName에 의해 식별되는 WebSphere 클러스터의 클러스터 레벨 데이터 소스여야 합니다. 기본 JMS 프로바이더의 기본 데이터베이스는 수동으로 작성해야 합니다. 이 옵션은 클러스터에서 Business Process Choreographer를 구성하고 mqType 옵션이 WPM으로 설정된 경우에만 사용됩니다.
shell shell
UNIX 및 Linux 플랫폼에서 이 매개변수는 외부 명령을 실행하는 데 사용하는 쉘을 판별합니다. 기본값은 /bin/sh입니다.
createEventCollector { yes | no}
일괄처리 모드로 실행될 때 기본값은 yes이며, Business Process Choreographer 옵저버에 필요한 Business Process Choreographer 이벤트 콜렉터 응용프로그램을 구성합니다. 설치하지 않으려면, 이 매개변수의 값을 no로 설정하십시오.
createObserver { yes | no}
일괄처리 모드로 실행될 때 기본값은 yes이며, Business Process Choreographer 응용프로그램을 구성합니다. 설치하지 않으려면, 이 매개변수의 값을 no로 설정하십시오.

대화식으로 구성 스크립트 실행

다음 예제는 bpeconfig.jacl 스크립트를 실행하여 (기존 DB2 데이터베이스를 사용하는) 비즈니스 프로세스 컨테이너, 휴먼 타스크 컨테이너 및 Business Process Choreographer 탐색기를 설치 및 구성하는 것을 설명합니다.
제한사항: 대화식으로 실행할 경우, 이 스크립트는 Business Process Choreographer 옵저버나 필수 이벤트 콜렉터 응용프로그램을 구성할 수 없습니다. Business Process Choreographer 옵저버를 사용하려면 Business Process Choreographer 옵저버 하부 구조 구성을 수행해야 합니다.
  1. 서버에서 또는 ND의 경우 Deployment Manager에서 스크립트를 실행하십시오.
    • UNIX® 및 Linux® 시스템에서는 다음 명령을 입력하십시오.
      install_root/bin/wsadmin.sh  
             -f install_root/ProcessChoreographer/sample/bpeconfig.jacl  
              ( [-user userName][-password password]|[-conntype NONE])
         [-profileName profileName]
    • Windows® 시스템에서는 다음 명령을 입력하십시오.
      install_root\bin\wsadmin.bat  
             -f install_root\ProcessChoreographer\sample\bpeconfig.jacl 
              ( [-user userName][-password password]|[-conntype NONE])
         [-profileName profileName]
  2. 표시된 질문에 대화식으로 응답을 입력하십시오.
    1. ND 환경에서, 구성할 클러스터가 제공됩니다. 올바른 클러스터가 아닌 경우 다음 클러스터에 No를 입력하십시오. 올바른 클러스틴 경우, Yes를 입력하십시오.
    2. 질문 Install the business process container?에 대해서는 Yes를 입력하십시오.
    3. User(s) to add to role BPESystemAdministrator에 대해서는 비즈니스 프로세서 관리자 역할을 수행할 사용자의 사용자 ID를 입력하십시오.
    4. 질문 Group(s) to add to role BPESystemAdministrator에 대해서는 비즈니스 프로세스 관리자 역할로 맵핑되는 도메인 사용자 레지스트리의 그룹을 입력하십시오.
    5. 질문 User(s) to add to role BPESystemMonitor에 대해서는 비즈니스 프로세서 모니터 역할을 수행할 사용자의 사용자 ID를 입력하십시오.
    6. 질문 Group(s) to add to role BPESystemMonitor에 대해서는 비즈니스 프로세스 모니터 역할로 맵핑되는 도메인 사용자 레지스트리의 그룹을 입력하십시오.
    7. 질문 Use WebSphere default messaging or WebSphere MQ에 대해서는 표시된 두 개의 옵션 중 하나를 입력하십시오.
    8. 질문 Run-as UserId for role JMSAPIUser에 대해서는 JMSAPIUser 역할에 사용할 run-as 사용자 ID를 입력하십시오.
    9. run-as 사용자 ID의 암호를 입력하십시오.
    10. 이 예제의 경우, 질문 Use a DB2, an Informix, an Oracle, or an SQL Server database [DB2/Informix/Oracle/MSSQL]?에 대해, DB2를 입력하십시오. 다른 데이터베이스를 선택하면 다른 데이터베이스 질문이 나타납니다.
    11. 질문 Use WebSphere default messaging or WebSphere MQ [WPM/MQSeries]?에 대해서는 사용하려는 JMS 프로바이더를 선택하십시오.
    12. WPM(WebSphere Platform Messaging)을 선택한 경우, 다음을 또한 입력하십시오.
      1. Virtual Host for the SCA Web Service [default_host]: 질문에 대해서는 Enter를 눌러 default_host를 채택하십시오.
      2. Context root for the SCA Web Service [/BFMIF_PNODE_server1]: 질문에 대해서는 Enter를 눌러 기본값 /BFMIF_PNODE_server1을 채택하십시오.
    13. Create the DataSource for the Process Choreographer database?에 대해서는 Yes를 입력하십시오.
    14. 데이터베이스 이름을 입력하십시오.
    15. 질문 Universal or CLI?에 대해서는 JDBC 드라이버 유형을 입력하십시오.
    16. 질문 DB2 User ID에 대해서는 데이터베이스 테이블 및 스키마를 작성할 때 사용되는 사용자 ID를 입력하십시오.
    17. 질문 Database server name (may be empty, set to use the type 4 driver)에 대해서는 데이터베이스를 호스트하는 서버의 이름을 입력하십시오.
    18. 질문 Database server port에 대해서는 데이터베이스 서버 포트를 입력하십시오(예: 50000).
    19. 질문Create the Process Choreographer database?에 대해서는 사용자 ID에 데이터베이스를 작성할 수 있는 충분한 권한이 있는 경우 Yes를 입력하고 그밖에 데이터베이스가 이미 존재하거나 사용자 ID에 데이터베이스를 작성할 수 있는 충분한 권한이 없는 경우 No를 입력하십시오.
    20. 질문 DB2 tablespace directory (may be empty)에 대해서는 테이블 공간에 디렉토리를 입력하거나 공백으로 두십시오.
    21. 질문 Create the ActivationSpecs for the business flow manager?에 대해서는 Yes 또는 No를 입력하십시오.
    22. 질문 User ID for access to default messaging에 대해서는 기본 JMS 프로바이더를 액세스하는 데 사용할 사용자 ID를 입력하십시오.
    23. 질문 Name of the message engine cluster에 대해서는 메시지 엔진 클러스터의 이름을 입력하십시오.
    24. 질문 Name of the message engine database schema에 대해서는 메시지 엔진 데이터베이스 스키마의 이름을 입력하십시오.
    25. 질문 Automatically create the message engine database tables [true/false]?에 대해서는 자동으로 메시지 엔진 데이터베이스 테이블에 true을 입력하고 그렇지 않으면 false을 입력하십시오.
    26. 질문 Message engine datasource JNDI name에 대해서는 메시지 엔진 데이터 소스의 JNDI 이름을 입력하십시오.
    27. Install the task container?에 대해서는 Yes를 입력하십시오.
    28. 질문 User(s) to add to role TaskSystemAdministrator에 대해서는 타스크 관리자 역할을 수행할 사용자의 사용자 ID를 입력하십시오.
    29. 질문 Group(s) to add to role TaskSystemAdministrator에 대해서는 타스크 관리자 역할로 맵핑되는 도메인 사용자 레지스트리의 그룹을 입력하십시오.
    30. 질문 User(s) to add to role TaskSystemMonitor에 대해서는 타스크 모니터 역할을 수행할 사용자의 사용자 ID를 입력하십시오.
    31. 질문 Run-as UserID for role EscalationUser에 대해서는 에스컬레이션 사용자 역할에 대한 run-as 사용자 ID(예: db2admin)를 입력하십시오.
    32. 질문 Context root for the SCA Web Service [/HTMIF_PNODE_server1]: 에 대해서는 SCA(Service Component Architecture) 웹 서버의 컨텍스트 루트를 입력하거나 Enter를 눌러 기본값을 채택하십시오.
    33. 질문 Create the mail notification session for the human task manager?에 대해서는 휴먼 타스크 관리자의 메일 공고 세션을 작성하지 않으려는 경우 No를 입력하십시오. 그렇지 않으면 Yes를 입력하고 메일 전송 호스트 및 사용자 ID를 지정하십시오.
    34. 질문 Create the ActivationSpecs for the human task manager?에 대해서는 Yes를 입력하여 휴먼 타스크 관리자 메시지 구동 Bean(MDB)의 J2EE ActivationSpecs를 작성하고 그렇지 않으면 No를 입력하십시오.
    35. 질문 Configure in cluster 'MECluster' [Yes/no]?에 대해서는 지정된 클러스터에 구성하도록 Yes를 입력하고 그렇지 않으면 No를 입력하십시오.
    36. 질문 Add JDBC provider permissions to server.policy [Yes/no]?에 대해서는 server.policy 파일에 자동으로 JDBC 프로바이더의 사용 권한을 추가하도록 Yes를 입력하고 그렇지 않으면 No를 입력하십시오.
    37. 질문 Install the Business Process Choreographer Explorer?에 대해 Yes를 입력하여 Business Process Choreographer 탐색기를 설치하고 Business Process Choreographer 탐색기의 가상 호스트에 대해서는 Business Process Choreographer 탐색기의 가상 호스트의 이름(예: default_host)을 입력한 후, Precompile JSPs?에 대해서는 JSP(Java Server Page)를 사전 컴파일할 경우 Yes를 입력하십시오. 그렇지 않으면 No를 입력하십시오. 원격 Business Process Choreographer Explorer의 경우, 질문 Node of Process Choreographer to connect to [PNODE]:에 대해서는 연결할 Business Process Choreographer 노드의 이름을 입력하고 Server of Process Choreographer to connect to [server1]: 질문에 대해서는 연결할 Business Process Choreographer 서버의 이름을 입력하거나 또는 Enter를 눌러 기본값을 채택하십시오.
    38. 질문 Context root for the Business Process Choreographer Explorer [/bpc]:에 대해서는 Business Process Choreographer 탐색기의 컨텍스트 루트를 입력하거나 Enter를 눌러 기본값 /bpc를 사용하십시오.
    39. 질문 Create aliases for your_server in host your_host?에 대해서는 Yes를 입력하여 가상 호스트의 서버에 별명을 작성하고 그렇지 않으면 No를 입력하십시오.
    40. 예를 들어, Business Process Choreographer Explorer의 URL 및 Business Process Choreographer 옵저버를 구성하는 데 사용할 수 있는 스크립트 파일을 찾을 수 있는 리마인더를 제공하는 다양한 정보가 표시됩니다.
    41. 질문 Enable global security using the Local OS user registry?에 대해서는 Yes를 입력하여 로컬 운영 체제 사용자 레지스트리를 사용하여 글로벌 보안을 사용 가능하게 하고 그렇지 않으면 No를 입력하십시오.
    42. 질문 Server user ID에 대해서는 서버 사용자 ID를 입력하십시오.
    43. 질문 Enforce Java 2 security?에 대해서는 Yes를 입력하여 Java 2 보안을 강화하고 그렇지 않으면 No를 입력하십시오.
    44. 질문 Set 'com.ibm.SOAP.loginUserid' in soap.client.props?에 대해서는 Yes를 입력하여 SOAP 클라이언트 특성에 로그인 사용자 ID를 설정하고 그렇지 않으면 No를 입력하십시오.
    45. 질문 Delete the temporary directory?에 대해서는 Yes를 입력하여 지정된 임시 디렉토리를 삭제하고 그렇지 않으면 No를 입력하십시오.
  3. 문제점이 발생할 경우, 로그 파일을 확인하십시오.

로그 파일

bpeconfig.jacl 스크립트 파일을 사용하여 구성을 작성하는 중에 문제점이 발생한 경우, 다음 로그 파일을 확인하십시오. 두 파일 모두 사용자 프로파일의 로그 디렉토리에 있습니다. 스크립트를 연결 모드로 실행할 경우, 서버 이름 뒤에 이름 지정된 logs 디렉토리의 하위 디렉토리에서 찾을 수 있는 SystemOut.logSystemErr.log 파일을 또한 확인하십시오.

ⓒ Copyright IBM Corporation 2005, 2006.
이 Information Center는 Eclipse 기술을 기반으로 합니다. (http://www.eclipse.org)