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는 / 또는 \)가 없는 경우 configTool이 파일을 Marketing Platform 설치의 tools/bin 디렉토리에 작성합니다. xml 확장자를 제공하지 않으면 configTool이 이를 추가합니다.
-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 옵션과 함께 사용하여 기존 특성을 겹쳐쓰십시오.
-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