configTool 유틸리티
구성 페이지의 특성 및 값은 시스템 테이블에 저장됩니다. configTool 유틸리티를 사용하여 시스템 테이블에서 구성 설정을 가져오고 내보낼 수 있습니다.
configTool 사용 시점
다음과 같은 이유로 configTool을 사용할 수 있습니다.
*
Campaign과 함께 제공되는 파티션 및 데이터 소스 템플리트를 가져와 구성 페이지에서 수정 및 복제할 수 있습니다.
*
*
백업용으로 XML 버전의 구성 설정을 내보내거나 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 옵션을 사용합니다.
-d와 함께 -vp 명령을 사용할 경우 지정된 XML 파일에 해당 노드가 포함되어 있지 않으면 configTool이 지정된 경로에서 하위 노드를 삭제합니다.
-i -p "parentElementPath" -f importFile [o]
지정된 XML 파일에서 구성 특성 및 해당 설정을 가져옵니다.
가져오려면 카테고리를 가져올 상위 요소에 대한 경로를 지정합니다. configTool 유틸리티는 경로에서 지정한 카테고리 아래의 특성을 가져옵니다.
상위 레벨 아래의 모든 레벨에서 카테고리를 추가할 수 있지만 상위 카테고리와 동일한 레벨에서 카테고리를 추가할 수 있습니다.
상위 요소 경로는 카테고리 및 특성의 내부 이름을 사용해야 합니다. 구성 페이지로 이동하고 필요한 카테고리 및 특성을 선택하고 오른쪽 분할창에서 괄호 안에 표시되는 경로를 확인하여 가져올 수 있습니다. | 문자를 사용하여 구성 특성 계층 구조의 경로를 구분하고 큰따옴표로 경로를 묶습니다.
tools/bin 디렉토리와 관련된 가져오기 파일 위치를 지정하거나 전체 디렉토리 경로를 지정할 수 있습니다. 상대 경로를 지정했거나 경로가 없으면 configTool이 먼저 tools/bin 디렉토리와 관련된 파일을 검색합니다.
기본적으로 이 명령은 기존 카테고리를 겹쳐쓰지 않지만 -o 옵션을 사용하여 겹쳐쓰기를 강제 실행할 수 있습니다.
-x -p "elementPath" -f exportFile
지정된 이름을 사용하여 구성 특성 및 해당 설정을 XML 파일로 내보냅니다.
구성 특성 계층 구조에서 경로를 지정하여 모든 구성 특성을 내보내거나 특정 카테고리로 내보내기를 제한할 수 있습니다.
요소 경로는 카테고리 및 특성의 내부 이름을 사용해야 합니다. 이 이름은 구성 페이지로 이동하고 원하는 카테고리 또는 특성을 선택하고 오른쪽 분할창에서 괄호 안에 표시되는 경로를 검색할 수 있습니다. | 문자를 사용하여 구성 특성 계층 구조의 경로를 구분하고 큰따옴표로 경로를 묶습니다.
현재 디렉토리와 관련된 내보내기 파일 위치를 지정하거나 전체 디렉토리 경로를 지정할 수 있습니다. 파일 사양에 구분 기호(UNIX의 경우 /, Windows의 경우 / 또는 \)가 포함되지 않은 경우 configToolMarketing Platform이 설치된 tools/bin 디렉토리에 파일을 씁니다. xml 확장자를 제공하지 않으면 configTool이 확장자를 추가합니다.
-vp -p "elementPath" -f importFile [-d]
이 명령은 대개 수동 업그레이드에서 구성 특성을 가져오기 위해 사용됩니다. 새로운 구성 특성이 포함된 수정팩을 적용한 후 업그레이드한 경우 수동 업그레이드 프로세스의 일부로 구성 파일을 가져오면 수정팩이 적용될 때 설정된 값을 대체할 수 있습니다. -vp 명령을 사용하면 가져오기가 이전에 설정된 구성 값을 겹쳐쓰지 않습니다.
*
-vp 옵션을 사용하여 configTool 유틸리티를 사용한 후 Marketing Platform이 배포된 웹 애플리케이션 서버를 다시 시작해야 변경사항이 적용됩니다.
-d와 함께 -vp 명령을 사용할 경우 지정된 XML 파일에 해당 노드가 포함되어 있지 않으면 configTool이 지정된 경로에서 하위 노드를 삭제합니다.
-r productName -f registrationFile
애플리케이션을 등록합니다. 등록 파일 위치는 tools/bin 디렉토리의 상대 경로이거나 전체 경로일 수 있습니다. 기본적으로 이 명령은 기존 구성을 겹쳐쓰지 않지만 -o 옵션을 사용하여 겹쳐쓰기를 강제 실행할 수 있습니다. productName 매개변수는 위에 나열된 이름 중 하나여야 합니다.
다음 사항에 주의하십시오.
*
-r 명령을 사용할 경우 XML의 첫 번째 태그로 <application>이 등록 파일에 포함되어야 합니다.
다른 파일은 구성 특성을 Marketing Platform 데이터베이스에 삽입할 때 사용할 수 있는 제품과 함께 제공될 수 있습니다. 이러한 파일의 경우 -i 명령을 사용합니다. <application> 태그가 첫 번째 태그로 사용되는 파일만 -r 명령으로 사용될 수 있습니다.
*
Marketing Platform의 등록 파일의 이름은 Manager_config.xml이고 첫 번째 태그는 <Suite>입니다. 새 설치에 이 파일을 등록하려면 IBM® Marketing Platform 설치 안내서의 설명에 따라 populateDb 유틸리티를 사용하거나 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 파티션인 partition1으로 제공된 Campaign 데이터 소스 템플리트 중 하나를 가져옵니다. 이 예에서는 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