configTool 유틸리티
구성 페이지의 특성과 값은 Marketing Platform 시스템 테이블에 저장됩니다. configTool 유틸리티는 Marketing Platform 시스템 테이블에서 구성 설정을 가져오고 내보냅니다.
configTool 사용 시점
다음과 같은 이유로 configTool을 사용할 수 있습니다.
*
Campaign에서 제공하는 데이터 소스 템플리트 및 파티션을 가져온 후 구성 페이지를 사용하여 수정 및 복제할 수 있습니다.
*
제품 설치 프로그램이 데이터베이스에 특성을 자동으로 추가할 수 없는 경우 IBM® EMM 제품을 등록(제품의 구성 특성 가져오기)합니다.
*
*
카테고리 삭제 링크가 없는 카테고리를 삭제합니다. configTool을 사용하여 구성을 내보낸 후 카테고리를 작성하는 XML을 수동으로 삭제하고 configTool을 사용하여 편집된 XML을 내보냄으로써 이를 수행합니다.
*
이 유틸리티는 구성 특성과 해당 값이 있는 Marketing Platform 시스템 테이블 데이터베이스의 usm_configurationusm_configuration_values 테이블을 수정합니다. 최상의 결과를 얻으려면 해당 테이블의 백업 사본을 작성하거나, configTool을 사용하여 가져올 때 오류가 발생하는 경우 구성을 복원할 수 있도록 configTool을 사용하여 기존 구성을 내보내고 결과 파일을 백업하십시오.
올바른 제품 이름
configTool 유틸리티는 이 절에서 나중에 설명하는 것처럼 제품을 등록하고 등록 취소하는 명령에서 제품 이름을 매개변수로 사용합니다. IBM® EMM의 8.0.0 릴리스에서 여러 제품 이름이 변경되었습니다. 그러나 configTool에서 인식하는 이름은 변경되지 않았습니다. 제품의 현재 이름과 함께 configTool에서 사용할 올바른 제품 이름이 아래 나열되어 있습니다.
구문
configTool -d -p "elementPath" [-o]
configTool -i -p "parent ElementPath" -f importFile [-o]
configTool -x -p "elementPath" -f exportFile
configTool -r productName -f registrationFile [-o]
configTool -u productName
명령
-d -p "elementPath"
구성 특성 계층 구조에 경로를 지정하여 구성 특성과 해당 설정을 삭제합니다.
요소 경로에서는 카테고리와 특성의 내부 이름을 사용해야 합니다. 구성 페이지로 이동하여 원하는 카테고리 또는 특성을 선택하고 오른쪽 분할창에서 소괄호 안에 표시되는 경로를 보면 내부 이름을 찾을 수 있습니다. | 문자를 사용하여 구성 특성 계층에서 경로를 구분하고 해당 경로를 큰따옴표로 묶으십시오.
다음 사항에 유의하십시오.
*
*
구성 페이지에서 카테고리 삭제 링크가 없는 카테고리를 삭제하려면 -o 옵션을 사용하십시오.
-i -p "parentElementPath" -f importFile
지정된 XML 파일에서 구성 특성과 해당 설정을 가져옵니다.
가져오기를 수행하기 위해 카테고리를 가져올 대상 상위 요소의 경로를 지정합니다. configTool 유틸리티가 사용자가 경로에 지정하는 카테고리 아래 특성을 가져옵니다.
최상위 아래의 모든 레벨에 카테고리를 추가할 수 있지만 최상위 레벨 카테고리와 같은 레벨에는 카테고리를 추가할 수 없습니다.
상위 요소 경로에서는 카테고리와 특성의 내부 이름을 사용해야 합니다. 구성 페이지로 이동하여 원하는 카테고리 또는 특성을 선택하고 오른쪽 분할창에서 소괄호 안에 표시되는 경로를 보면 내부 이름을 찾을 수 있습니다. | 문자를 사용하여 구성 특성 계층에서 경로를 구분하고 해당 경로를 큰따옴표로 묶으십시오.
tools/bin 디렉토리와 관련된 가져오기 파일 위치를 지정하거나 전체 디렉토리 경로를 지정할 수 있습니다. 상대 경로를 지정하거나 아무 경로도 지정하지 않는 경우 configTool은 첫 번째로 tools/bin 디렉토리와 관련된 파일을 찾습니다.
기본적으로 이 명령은 기존 카테고리를 겹쳐쓰지 않지만 -o 옵션을 사용하여 겹쳐쓰기를 강제 실행할 수 있습니다.
-x -p "elementPath" -f exportFile
구성 특성과 해당 설정을 지정된 이름을 사용하여 XML 파일로 내보냅니다.
모든 구성 특성을 내보내거나 구성 특성 계층 구조에 경로를 지정하여 특정 카테고리만 내보내도록 제한할 수 있습니다.
요소 경로에서는 카테고리와 특성의 내부 이름을 사용해야 합니다. 구성 페이지로 이동하여 원하는 카테고리 또는 특성을 선택하고 오른쪽 분할창에서 소괄호 안에 표시되는 경로를 보면 내부 이름을 찾을 수 있습니다. | 문자를 사용하여 구성 특성 계층에서 경로를 구분하고 해당 경로를 큰따옴표로 묶으십시오.
현재 디렉토리와 관련된 내보내기 파일 위치를 지정하거나 전체 디렉토리 경로를 지정할 수 있습니다. 파일 사양에 구분 기호(Unix의 경우 /, Windows의 경우 / 또는 \)가 없는 경우 configToolMarketing Platform 설치의 tools/bin 디렉토리에 파일을 작성합니다. xml 확장자를 입력하지 않으면 configTool이 이를 추가합니다.
-r productName -f registrationFile
애플리케이션을 등록합니다. 등록 파일 위치는 tools/bin 디렉토리와 관련되어 있거나 전체 경로일 수 있습니다. 기본적으로 이 명령은 기존 구성을 겹쳐쓰지 않지만 -o 옵션을 사용하여 겹쳐쓰기를 강제 실행할 수 있습니다. productName 매개변수는 위에 나열된 이름 중 하나여야 합니다.
다음 사항에 유의하십시오.
*
-r 옵션을 사용하는 경우 등록 파일에 XML의 첫 번째 태그로 <application>이 있어야 합니다.
Marketing Platform 데이터베이스에 구성 특성을 삽입하는 데 사용할 수 있는 기타 파일이 제품과 함께 제공될 수 있습니다. 이러한 파일의 경우 -i 옵션을 사용하십시오. 첫 번째 태그로 <application> 태그가 있는 파일만 -r 옵션과 함께 사용할 수 있습니다.
*
Marketing Platform의 등록 파일 이름은 Manager_config.xml로 지정되고 첫 번째 태그는 <Suite>입니다. 새 설치에 이 파일을 등록하려면 populateDb 유틸리티를 사용하거나 IBM® Marketing Platform 설치 가이드의 설명 대로 Marketing Platform 설치 프로그램을 다시 실행하십시오.
*
초기 설치 이후 Marketing Platform 이외의 제품을 등록하려면 configTool-r 옵션과 함께 사용하고 기존 특성을 겹쳐쓰려면 -o 옵션을 함께 사용하십시오.
-u productName
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.xmlMarketing 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
*
configTool -u productName