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