configTool 유틸리티
구성 페이지의 등록 정보와 값은 Marketing Platform 시스템 테이블에 저장됩니다. configTool 유틸리티는 Marketing Platform 시스템 테이블에서 구성 설정을 가져오고 내보냅니다.
configTool 사용 시점
다음과 같은 이유로 configTool을 사용할 수 있습니다.
*
Campaign에서 제공하는 데이터 원본 템플릿과 파티션을 가져온 후 구성 페이지를 사용하여 수정 및/또는 복제할 수 있습니다.
*
제품 설치 프로그램이 데이터베이스에 등록 정보를 자동으로 추가할 수 없는 경우 IBM® Unica Marketing 제품을 등록(제품의 구성 등록 정보 가져오기)합니다.
*
백업에 사용하도록 구성 설정의 XML 버전을 내보내거나 IBM® Unica Marketing의 다른 설치에 가져옵니다.
*
범주 삭제 링크가 없는 범주를 삭제합니다. configTool을 사용하여 구성을 내보낸 후 범주를 생성하는 XML을 수동으로 삭제하고 configTool을 사용하여 편집된 XML을 내보냄으로써 이를 수행합니다.
*
이 유틸리티는 구성 등록 정보와 해당 값이 있는 Marketing Platform 시스템 테이블 데이터베이스의 usm_configurationusm_configuration_values 테이블을 수정합니다. 최상의 결과를 얻으려면 해당 테이블의 백업 사본을 생성하거나, configTool을 사용하여 가져올 때 오류가 발생하는 경우 구성을 복원할 수 있도록 configTool을 사용하여 기존 구성을 내보내고 결과 파일을 백업하십시오.
올바른 제품 이름
configTool 유틸리티는 이 절에서 나중에 설명하는 것처럼 제품을 등록하고 등록 취소하는 명령에서 제품 이름을 매개변수로 사용합니다. IBM® Unica Marketing의 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® Unica 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