configTool 유틸리티

구성 페이지의 특성 및 값은 시스템 테이블에 저장됩니다. configTool 유틸리티를 사용하여 시스템 테이블로 구성 설정을 가져오거나 내보낼 수 있습니다.

configTool 사용 시점

다음과 같은 이유로 configTool을 사용할 수 있습니다.

구성 페이지를 사용하여 수정하거나 복제할 수 있고, Campaign에 제공되는 파티션 및 데이터 소스 템플리트를 가져오려는 경우

제품 설치 프로그램이 데이터베이스에 특성을 자동으로 추가할 수 없는 경우 IBM EMM 제품을 등록(제품의 구성 특성 가져오기)합니다.

백업에 사용하도록 구성 설정의 XML 버전을 내보내거나 IBM EMM의 다른 설치에 가져옵니다.

카테고리 삭제 링크가 없는 카테고리를 삭제합니다. 이를 수행하려면 configTool을 사용하여 구성을 내보낸 다음 카테고리를 작성하는 XML을 수동으로 삭제하고 configTool을 사용하여 편집된 XML을 가져와야 합니다.

이 유틸리티는 Marketing Platform 시스템 테이블 데이터베이스에서, 구성 특성과 값이 들어 있는 usm_configuration 및 usm_configuration_values 테이블을 수정합니다. 이러한 테이블의 백업 사본을 작성하거나 configTool을 사용하여 기존 구성을 내보내고 결과 파일을 백업하는 것이 좋습니다. 이렇게 하면 configTool을 사용하여 가져올 때 실수를 하는 경우 구성을 복원할 수 있습니다.

구문

configTool -d -p "elementPath" [-o]

configTool -i -p "parent ElementPath" -f importFile [-o]

configTool -x -p "elementPath" -f exportFile

configTool -vp -p "elementPath" -f importFile [-d]

configTool -r productName -f registrationFile [-o] configTool -u productName

명령

-d -p "elementPath" [o]

구성 특성 계층 구조에 경로를 지정하여 구성 특성과 해당 설정을 삭제합니다.

요소 경로는 카테고리와 특성의 내부 이름을 사용해야 합니다. 이러한 카테고리 및 특성은 구성 페이지로 이동하여 원하는 카테고리나 특성을 선택한 다음 오른쪽 분할창의 소괄호 안에 표시된 경로에서 찾아 가져올 수 있습니다. | 문자를 사용하여 구성 특성 계층에서 경로를 구분하고 큰따옴표로 경로를 묶으십시오.

다음 사항에 유의하십시오.

이 명령을 사용하면 전체 애플리케이션이 아닌 애플리케이션 내의 카테고리와 특성만 삭제할 수 있습니다. 전체 애플리케이션을 등록 취소하려면 -u 명령을 사용하십시오.

구성 페이지에 카테고리 삭제 링크가 없는 카테고리를 삭제하려면 -o 옵션을 사용하십시오.

-vp 명령에 -d 옵션을 사용하면 사용자가 지정하는 XML 파일에 사용자 지정 경로의 하위 노드가 포함되지 않은 경우 configTool이 이러한 경로를 삭제합니다.

-i -p "parentElementPath" -f importFile [o]

지정된 XML 파일에서 구성 특성과 해당 설정을 가져옵니다.

가져오기를 수행하기 위해 카테고리를 가져올 대상 상위 요소의 경로를 지정합니다. configTool 유틸리티는 사용자가 경로에 지정한 카테고리 아래의 특성을 가져옵니다.

최상위 아래의 모든 레벨에 카테고리를 추가할 수 있지만 최상위 레벨 카테고리와 같은 레벨에는 카테고리를 추가할 수 없습니다.

상위 요소 경로는 카테고리와 특성의 내부 이름을 사용해야 합니다. 이러한 카테고리 및 특성은 구성 페이지로 이동하여 원하는 카테고리나 특성을 선택한 다음 오른쪽 분할창의 소괄호 안에 표시되는 경로에서 찾아 가져올 수 있습니다. | 문자를 사용하여 구성 특성 계층에서 경로를 구분하고 큰따옴표로 경로를 묶으십시오.

tools/bin 디렉토리와 관련된 가져오기 파일 위치를 지정하거나 전체 디렉토리 경로를 지정할 수 있습니다. 상대 경로를 지정하거나 아무 경로도 지정하지 않는 경우 configTool은 첫 번째로 tools/bin 디렉토리와 관련된 파일을 찾습니다.

기본적으로 이 명령은 기존 카테고리를 겹쳐쓰지 않지만 -o 옵션을 사용하여 겹쳐쓰기를 강제 실행할 수 있습니다.

-x -p "elementPath" -f exportFile

구성 특성과 해당 설정을 지정된 이름을 사용하여 XML 파일로 내보냅니다.

모든 구성 특성을 내보내거나 구성 특성 계층 구조에 경로를 지정하여 특정 카테고리만 내보내도록 제한할 수 있습니다.

요소 경로는 카테고리 및 특성의 내부 이름을 사용해야 합니다. 이러한 카테고리 및 특성은 구성 페이지로 이동하여 원하는 카테고리나 특성을 선택한 다음 오른쪽 분할창의 소괄호 안에 표시되는 경로에서 찾아 가져올 수 있습니다. | 문자를 사용하여 구성 특성 계층에서 경로를 구분하고 큰따옴표로 경로를 묶으십시오.

현재 디렉토리와 관련된 내보내기 파일 위치를 지정하거나 전체 디렉토리 경로를 지정할 수 있습니다. 파일 사양에 구분 기호(UNIX™의 경우 /, Windows™의 경우 / 또는 \)가 없는 경우, configTool이 Marketing Platform 설치의 tools/bin 디렉토리에 파일을 기록합니다. xml 확장자를 입력하지 않으면 configTool이 이를 추가합니다.

-vp -p "elementPath" -f importFile [-d]

이 명령은 주로 수동 업그레이드에서 구성 특성을 가져오는 데 사용됩니다. 새 구성 특성을 포함하는 수정팩을 적용한 다음 업그레이드하는 경우, 수동 업그레이드 프로세스 중에 구성 파일을 가져오면 수정팩 적용 시 설정된 값이 대체될 수 있습니다. -vp 명령은 이전에 설정한 구성 값이 가져오기로 인해 대체되지 않도록 해줍니다.

-vp 옵션과 함께 configTool 유틸리티를 사용한 다음 변경 내용이 적용될 수 있도록 Marketing Platform이 배포된 웹 애플리케이션 서버를 다시 시작해야 합니다.

-r productName -f registrationFile

애플리케이션을 등록합니다. 등록 파일 위치는 tools/bin 디렉토리에 대해 상대적이거나 전체 경로입니다. 기본적으로 이 명령은 기존 구성을 겹쳐쓰지 않지만 -o 옵션을 사용하여 겹쳐쓰기를 강제 실행할 수 있습니다. productName 매개변수는 위에 나열된 이름 중 하나여야 합니다.

다음 사항에 유의하십시오.

-r 옵션을 사용하는 경우, <application>이 XML의 첫 번째 태그로 등록 파일에 있어야 합니다.

구성 특성을 Marketing Platform 데이터베이스에 삽입하는 데 사용할 수 있는 기타 파일이 제품에 제공될 수 있습니다. 이러한 파일에는, -i 명령을 사용하십시오. <application> 태그가 첫 번째 태그인 파일만 -r 명령과 함께 사용할 수 있습니다.

Marketing Platform의 등록 파일 이름은 Manager_config.xml로 지정되고 첫 번째 태그는 <Suite>입니다. 새 설치에 이 파일을 등록하려면 populateDb 유틸리티를 사용하거나 IBM Marketing Platform 설치 안내서에 설명된 대로 Marketing Platform 설치 프로그램을 다시 실행하십시오.

처음 설치한 후, Marketing Platform이 아닌 다른 제품을 재등록하려면, configTool을 -r 명령 및 -o 명령과 함께 사용하여 기존 특성을 겹쳐쓰십시오.

configTool 유틸리티는 제품을 등록하거나 등록 취소하는 명령에서 제품 이름을 매개변수로 사용합니다. IBM EMM의 8.5.0 릴리스에서는, 많은 제품 이름이 변경되었습니다. 하지만 configTool에서 인식하는 이름은 변경되지 않았습니다. 제품의 현재 이름과 함께 configTool에서 사용할 올바른 제품 이름이 아래 나열되어 있습니다.

configTool 등록 및 등록 취소를 위한 제품 이름
제품 이름	configTool에서 사용되는 이름
Marketing Platform	Manager
Campaign	Campaign
Distributed Marketing	Collaborate
eMessage	eMessage
Interact	Interact
Contact Optimization	Optimize
Marketing Operations	Plan
CustomerInsight	Insight
Digital Analytics for On Premises	NetInsight
Opportunity Detection	Detect
Leads	Leads
Interaction History	InteractionHistory
Attribution Modeler	AttributionModeler
IBM SPSS Modeler Advantage Enterprise Marketing Management Edition	SPSS
Digital Analytics	Coremetrics

-u productName

productName에서 지정하는 애플리케이션을 등록 취소합니다. 제품 카테고리에 대한 경로를 포함하지 않아도 됩니다. 제품 이름이면 충분하고 이는 필수입니다. 등록 취소하면 제품에 대한 모든 특성 및 구성 설정이 제거됩니다.

옵션

-o

-i 또는 -r과 함께 사용하면, 기존 카테고리 또는 제품 등록(노드)을 겹쳐씁니다.

-d와 함께 사용하면, 구성 페이지에 카테고리 삭제 링크가 없는 카테고리(노드)를 삭제할 수 있습니다.

예

Marketing Platform 설치의 conf 디렉토리에 있는 Product_config.xml 파일에서 구성 설정을 가져옵니다.

configTool -i -p "Affinium" -f Product_config.xml

제공된 Campaign 데이터 소스 템플리트 중 하나를 기본 Campaign 파티션인 partition1에 가져옵니다. 이 예제에서는 Oracle 데이터 소스 템플리트인 OracleTemplate.xml을 Marketing Platform 설치의 tools/bin 디렉토리에 배포한 것으로 가정합니다.

configTool -i -p "Affinium|Campaign|partitions|partition1|dataSources" -f OracleTemplate.xml

모든 구성 설정을 D:\backups 디렉토리에 있는 myConfig.xml 파일로 내보냅니다.

configTool -x -f D:\backups\myConfig.xml

기존 Campaign 파티션(데이터 소스 항목으로 완료)을 내보내 partitionTemplate.xml 파일에 저장하고 이를 Marketing Platform 설치의 기본 tools/bin 디렉토리에 저장합니다.

configTool -x -p "Affinium|Campaign|partitions|partition1" -f partitionTemplate.xml

Marketing Platform 설치의 기본 tools/bin 디렉토리에 있는 app_config.xml 파일을 사용하여 애플리케이션 productName을 수동으로 등록하고 이 애플리케이션의 기존 등록이 겹쳐쓰이게 합니다.

configTool -r product Name -f app_config.xml -o

productName 애플리케이션을 등록 취소합니다.

configTool -u productName