configTool
구성 페이지의 특성 및 값은 시스템 테이블에 저장됩니다. configTool 유틸리티를 사용하여 시스템 테이블에서 구성 설정을 가져오고 내보낼 수 있습니다.
configTool 사용 시기
다음과 같은 이유를 위해 configTool을 사용할 수 있습니다.
*
Campaign과 함께 제공되며 구성 페이지를 사용하여 수정하고 복제할 수 있는 파티션 및 데이터 소스 템플리트 가져오기
*
IBM® EMM 제품의 등록 및 이 제품에 대한 구성 특성 가져오기(제품 설치 프로그램이 데이터베이스에 특성을 자동으로 추가할 수 없는 경우)
*
*
카테고리 삭제 링크가 없는 카테고리 삭제. configTool을 사용하여 구성을 내보낸 후 해당 카테고리를 작성하는 XML을 수동으로 삭제하고 configTool을 사용하여 편집된 XML을 가져옴으로써 이를 수행합니다.
*
이 유틸리티는 Marketing Platform 시스템 테이블 데이터베이스에서 usm_configurationusm_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]
구성 특성 계층 구조에서 경로를 지정하여 구성 특성 및 해당 설정을 삭제합니다.
요소 경로는 카테고리 및 특성의 내부 이름을 사용해야 합니다. 이러한 이름은 구성 페이지로 이동하여 원하는 카테고리 또는 특성을 선택한 후 오른쪽 분할창의 소괄호 안에 표시되는 경로를 확인하여 확보할 수 있습니다. | 문자를 사용하여 구성 특성 계층 구조에서 경로를 구분하고 큰따옴표로 경로를 묶으십시오.
다음 사항에 유의하십시오.
*
*
구성 페이지에 카테고리 삭제 링크가 없는 카테고리를 삭제하려면 -o 옵션을 사용하십시오.
-vp 명령에 -d를 사용하는 경우, configTool은 지정한 경로의 모든 하위 노드가 지정한 XML 파일에 포함되어 있지 않으면 해당 노드를 삭제합니다.
-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 명령은 가져오기에서 이전에 설정된 구성 값이 대체되지 않도록 합니다.
*
configTool 유틸리티를 -vp 옵션과 함께 사용한 후 변경사항이 적용되도록 하려면 Marketing Platform이 배포된 웹 애플리케이션 서버를 다시 시작해야 합니다.
-vp 명령에 -d를 사용하는 경우, configTool은 지정한 경로의 모든 하위 노드가 지정한 XML 파일에 포함되어 있지 않으면 해당 노드를 삭제합니다.
-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 명령과 함께 사용하여 기존 특성을 겹쳐쓰십시오.
configTool 유틸리티는 제품을 등록하고 등록 취소하는 명령과 함께 매개변수로 제품 이름을 사용합니다. IBM® EMM 8.5.0 릴리스에서는 많은 제품 이름이 변경되었습니다. 하지만 configTool이 인식하는 이름은 변경되지 않았습니다. configTool과 함께 사용할 수 있는 유효한 제품 이름이 제품의 현재 이름과 함께 아래에 나열됩니다.
IBM® SPSS® Modeler Advantage Enterprise Marketing Management Edition
-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
*
configTool -u productName