BAM 정의(관찰 모델) 배포 명령

BAM 관리 유틸리티 배포 명령을 사용하여 정의를 적용, 수정 및 제거할 수 있습니다.

• deploy-all: BAM 정의를 배포합니다.

• update-all: BAM 정의를 업데이트.

• remove-all: BAM 정의를 제거합니다.

• update-livedataworkbook: 라이브 데이터 통합 문서에서 데이터베이스 연결 정보를 업데이트.

• regenerate-livedataworkbook: 서버에서 라이브 데이터 통합 문서를 다시 생성합니다.

참고

-Trace:on|off 매개 변수 스위치를 포함하여 모든 BM 유틸리티 명령에서 추적을 사용하도록 설정할 수 있습니다. 추적 스위치를 사용하면 구성 파일의 추적 설정이 재정의됩니다. 이 스위치는 일반적인 BM 명령과 함께 사용할 수 있습니다.

참고

UAC(사용자 계정 컨트롤)를 지원하는 시스템에서는 관리 권한을 사용하여 도구를 실행해야 할 수 있습니다.

deploy-all 명령

사용 현황

bm.exe deploy-all -DefinitionFile:<def file>[ -Server:<server> ][ -Database:<database> ]

매개 변수

매개 변수	Description
DefinitionFile:<def 파일>	배포할 정의가 있는 파일의 경로와 이름입니다.
Server:<server>	선택 사항: 정의를 배포할 서버의 이름입니다. 서버는 bm.exe를 실행 중인 컴퓨터와 동일한 도메인에 있어야 합니다. 서버 이름을 지정하지 않으면 bm.exe에서 기본 이름인 localhost를 사용합니다.
Database:<database>	선택 사항: 정의를 배포할 데이터베이스의 이름입니다. 이름을 지정하지 않으면 bm.exe에서 기본 이름인 BamPrimaryImport를 사용합니다.

지정한 BAM 정의 XML 파일의 모든 아티팩트를 지정한 서버 및 데이터베이스에 배포합니다. 이 파일은 BAM 정의 XML을 포함하는 텍스트 파일이거나 BAM Excel 통합 문서일 수 있습니다. 정의 파일에는 새로운 아티팩트만 포함되어야 합니다. 파일에 이미 배포된 아티팩트가 있으면 배포가 실패하고 오류가 보고됩니다.

BAM 정의 배포 시 고려 사항

경고 등록을 배포할 때는 등록자의 사용자 ID를 도메인\사용자 형식으로 지정해야 합니다.

DTC(분산 트랜잭션 코디네이터) 서비스는 deploy-all 명령이 실행된 컴퓨터에서 실행 중이어야 합니다.

정의를 배포할 때 BAM 관리 유틸리티는 RTA(실시간 집계) 보기에서 14개 차원 수준만 지원합니다. 추가 수준을 배포하면 배포 실패 오류가 반환됩니다.

서로 다른 언어 설정을 사용하는 여러 보기를 정의하고 단일 언어를 사용하는 서버에 솔루션을 배포하면 보기를 배포할 수 없습니다. 이 시나리오는 BAM 정의의 일부로 OLAP이 필요한 예약 집계가 없는 경우에만 지원됩니다.

BAM 관리 유틸리티에서는 BAM 경고가 설정된 경우 49개까지만 활동 보기를 배포할 수 있습니다. 활동 보기의 개수는 상위 활동의 개수에 보기(n)의 Summation 1..N을 곱한 값으로 계산됩니다. 예를 들어 2개의 활동을 기반으로 하는 보기를 배포할 경우 활동 보기의 개수는 2개입니다. 2개의 활동을 기반으로 하는 보기와 단일 활동을 기반으로 하는 보기 등 2개의 보기를 배포할 때는 활동 보기 개수가 3개가 됩니다.

BAM 관리 유틸리티는 동일 RTA 및 큐브 이름 조합으로 정의된 여러 피벗 테이블 보고서가 있는 BAM 정의의 배포를 차단합니다. Bm.exe는 이러한 배포를 종료하고 다음 오류를 반환합니다.

보기 배포 중... 오류: BAM 배포에 실패했습니다.

지정한 RTA 및 큐브에는 하나의 피벗 테이블 보기만 정의할 수 있습니다.

예약된 다음 이름 목록을 사용하면 정의 배포가 실패합니다.

• RecordID

• ActivityID

• IsVisible

• IsComplete

• LastModified

참고

배포 중 bm.exe에 오류가 발생하면 배포가 종료되고 보기 및 활동의 변경 내용이 롤백됩니다. OLAP 큐브의 변경 내용은 OLAP에서 트랜잭션 배포가 지원되지 않기 때문에 롤백되지 않습니다.

참고

하나의 로캘 설정을 사용하는 컴퓨터에서 만든 BAM 정의는 여러 로캘 설정으로 구성된 컴퓨터에 배포할 수 없습니다. 예를 들어 Microsoft Excel 영어 버전을 사용하여 EN 로캘 설정으로 구성된 컴퓨터에서 생성된 BAM 정의는 JA 로캘 설정을 사용하여 일본어로 구성된 컴퓨터에 배포할 수 없습니다.

예

bm.exe deploy-all -DefinitionFile:MyDef.xml  
bm.exe deploy-all -DefinitionFile:MyWorkbook.xls -Server:machine1  

update-all 명령

사용 현황

bm.exe update-all -DefinitionFile:<def file>[ -Server:<server> ][ -Database:<database> ]

매개 변수

매개 변수	Description
DefinitionFile:<def 파일>	업데이트를 수행하려는 정의를 포함하는 파일의 경로 및 이름입니다.
Server:<server>	선택 사항: 정의 업데이트를 배포할 서버의 이름입니다. 서버는 bm.exe를 실행 중인 컴퓨터와 동일한 도메인에 있어야 합니다. 서버 이름을 지정하지 않으면 bm.exe에서 기본 이름인 localhost를 사용합니다.
Database:<database>	선택 사항: 정의 업데이트를 배포할 데이터베이스의 이름입니다. 이름을 지정하지 않으면 bm.exe에서 기본 이름인 BamPrimaryImport를 사용합니다.

BAM 정의 XML에서 특정 아티팩트를 업데이트합니다. 이 파일은 BAM 정의 XML을 포함하는 텍스트 파일이거나 BAM Excel 통합 문서일 수 있습니다. 업데이트 시 현재 정의 파일에 기술되지 않은 아티팩트는 삭제되지 않습니다. 업데이트 시에는 활동에 새로운 검사점을 추가할 수 있지만 배포된 활동에서 검사점을 삭제할 수 없습니다. 업데이트 시 검사점 이름을 바꾸거나 검사점 속성을 변경할 수 없습니다.

활동을 배포한 후에는 활동에 대해 수행할 수 있는 작업이 제한됩니다. 특히 관리자가 전체 BAM 활동 및 보기 집합의 배포를 취소했다가 다시 배포하지 않는 한 활동에서 항목을 삭제할 수 없습니다. 이 경우 관리자가 데이터에 대한 백업 및 복원을 수행하지 않으면 데이터를 계속 표시할 수 없게 되거나 데이터가 손실될 수 있습니다.

참고

이 명령을 사용하여 기존 보기에 새 활동을 추가할 수 없습니다. 활동에 보기를 추가하려면 새 활동을 포함하는 새 보기를 만들어야 합니다. 그런 다음 이전 보기를 배포 취소할 수 있지만 그러면 OLAP 데이터 기록이 삭제되므로 주의하십시오.

예

bm.exe update-all -DefinitionFile:MyDef.xml  
bm.exe update-all -DefinitionFile:MyWorkbook.xls -Server:machine1  

remove-all 명령

사용 현황

bm.exe remove-all DefinitionFile:<def 파일> [ -Server:<server> ][ -Database:<database> ]

매개 변수

매개 변수	Description
DefinitionFile:<def 파일>	제거할 정의가 있는 파일의 경로와 이름입니다.
Server:<server>	선택 사항: 정의를 제거할 서버의 이름입니다. 서버는 bm.exe를 실행 중인 컴퓨터와 동일한 도메인에 있어야 합니다. 서버 이름을 지정하지 않으면 bm.exe에서 기본 이름인 localhost를 사용합니다.
Database:<database>	선택 사항: 정의를 제거할 데이터베이스의 이름입니다. 이름을 지정하지 않으면 bm.exe에서 기본 이름인 BamPrimaryImport를 사용합니다.

BAM 정의 XML 파일에 지정된 모든 아티팩트를 제거합니다. 이 파일은 BAM 정의 XML을 포함하는 텍스트 파일이거나 BAM Excel 통합 문서일 수 있습니다. 각 아티팩트의 정의는 배포에 사용된 원래 정의와 정확히 일치해야 합니다.

예

bm.exe remove-all -DefinitionFile:MyDef.xml  
bm.exe remove-all -DefinitionFile:MyWorkbook.xls -Server:machine1  

update-livedataworkbook 명령

사용 현황

bm.exe update-livedataworkbook -Name:<livedata 통합 문서 파일 이름>[ -Server:<server> ][ -Database:<database> ]

매개 변수

매개 변수	Description
이름:<livedata 통합 문서>	업데이트할 기존의 사용 중인 통합 문서의 이름입니다.
Server:<server>	선택 사항: 통합 문서가 있는 서버의 이름입니다. 서버는 bm.exe를 실행 중인 컴퓨터와 동일한 도메인에 있어야 합니다. 서버 이름을 지정하지 않으면 bm.exe에서 기본 이름인 localhost를 사용합니다.
Database:<database>	선택 사항: 통합 문서가 있는 데이터베이스의 이름입니다. 이름을 지정하지 않으면 bm.exe에서 기본 이름인 BamPrimaryImport를 사용합니다.

지정한 사용 중인 BAM 데이터 통합 문서에서 BAM 기본 가져오기 데이터베이스 연결 정보를 업데이트합니다.

참고

새 연결 문자열을 구성한 경우에는 TDDS 서비스가 변경 내용을 인식할 있도록 서비스를 다시 시작해야 합니다. TDDS 서비스에 대한 자세한 내용은 BAM Event Bus 서비스 저장 프로시저를 참조하세요.

예

bm.exe update-livedataworkbook -Name:SalesManager_Live.xls  
bm.exe update-livedataworkbook -Name:SalesManager_Live.xls -Server:SalesSrv  

regenerate-livedataworkbook 명령

사용 현황

bm.exe regenerate-livedataworkbook -WorkbookName:<livedata 통합 문서 파일 이름>[ -Server:<server> ][ -Database:<database> ]

매개 변수

매개 변수	Description
WorkbookName:<livedata 통합 문서 파일 이름>	업데이트할 통합 문서의 이름입니다.
Server:<server>	선택 사항: 통합 문서가 있는 서버의 이름입니다. 서버는 bm.exe를 실행 중인 컴퓨터와 동일한 도메인에 있어야 합니다. 서버 이름을 지정하지 않으면 bm.exe에서 기본 이름인 localhost를 사용합니다.
Database:<database>	선택 사항: 통합 문서가 있는 데이터베이스의 이름입니다. 이름을 지정하지 않으면 bm.exe에서 기본 이름인 BamPrimaryImport를 사용합니다.

사용 중인 BAM 데이터 통합 문서를 생성하지만 통합 문서를 배포하지 않습니다.

예제

bm.exe regenerate-livedataworkbook -WorkbookName:SalesManager_Live.xls  
bm.exe regenerate-livedataworkbook -WorkbookName:SM_Live.xls -Server:S1  

참고 항목

BAM 관리 유틸리티