명령행을 통해 관리 서버에 서비스 요청을 제출하여 하나 이상의 서비스를 실행할 수 있습니다.
서비스를 실행하기 전에 관리 프로그램을 사용하여 서비스를 프록시 및 관리 서버에 지정해야 합니다. 서비스 요청을 처리할 수 있도록 프록시 및 관리 서버가 실행 중이어야 합니다. 또한 명령행 처리를 실행하는 데 필요한 파일을 확보하기 위해 InfoSphere™ Data Architect 및 IBM Optim Designer를 설치해야 합니다.
runservice 스크립트는 ida_folder\optim\designer\runservice 폴더에 있습니다. 여기서, ida_folder는 InfoSphere Data Architect가 설치된 폴더입니다. ida_folder\optim\designer\runservice 폴더에서 명령행을 열어야 합니다. 폴더에는 Microsoft Windows(runservice.bat)용과 Linux 및 UNIX(runservice.sh)용 등 두 개의 스크립트 파일이 있습니다.
runservice 스크립트의 경우 Java 6.0 JRE 또는 JDK 설치의 루트 폴더를 PATH 환경 변수에 추가해야 합니다.
관리 서버 및 프록시에 지정된 서비스를 실행할 때 runservice 스크립트는 다음 구문을 사용합니다.
runservice {--service | -s} servicename:version {--url | -u} serverURL {--continueOnError | -c}
서비스 이름 및 버전 번호(n.n.n 형식)이며, 필수입니다.
서비스 이름은 대소문자를 구분합니다. 서비스 이름에 스페이스 또는 멀티바이트 문자 세트(MBCS) 문자가 포함된 경우 이름을 큰따옴표로 묶어야 합니다.
예: -s demosvc:1.0.0.
예: -u http://mgmtserver1:8080.
이 매개변수는 서비스가 프록시에 의해 시작되지 못하더라도 실행을 위해 프록시에 계속해서 서비스를 보내도록 스크립트를 설정합니다.
내보낸 서비스 요청을 실행할 때 runservice 스크립트는 다음 구문을 사용합니다.
runservice {-r|--serviceRequest} requestfilepath {-u|-url} proxyURL {-j|--jarMap} mapfilepath {-v|--overrideValues} overridefilepath {-l|--logLevel} loglevel {-t|--timeout} seconds|never {-p|--serviceResponse} responsefilepath
내보낸 서비스 요청에 대한 완전한 파일 경로로, 필수입니다.
서비스 요청 파일 이름은 대소문자를 구분합니다. 파일 이름에 스페이스 또는 멀티바이트 문자 세트(MBCS) 문자가 포함된 경우 이름을 큰따옴표로 묶어야 합니다.
예: -r demosvc.jar.
예: -u http://proxy1:12000.
맵 파일에 대한 완전한 파일 경로입니다.
맵 파일 이름은 대소문자를 구분합니다. 파일 이름에 스페이스 또는 멀티바이트 문자 세트(MBCS) 문자가 포함된 경우 이름을 큰따옴표로 묶어야 합니다.
겹쳐쓰기 파일에 대한 완전한 파일 경로입니다.
맵 파일 이름은 대소문자를 구분합니다. 파일 이름에 스페이스 또는 멀티바이트 문자 세트(MBCS) 문자가 포함된 경우 이름을 큰따옴표로 묶어야 합니다.
예: -l INFO.
종료하기 전에 응답을 기다리는 시간(초)을 지정합니다(또는 기다리지 않음). 기본적으로 runservice 스크립트는 600초 동안 기다립니다.
서비스 응답이 작성될 파일의 완전한 파일 경로입니다.
com-ibm-nex-client-tool.jar 파일은 ida_folder\optim\designer\runservice 폴더에 있습니다. 여기서, ida_folder는 InfoSphere Data Architect가 설치된 폴더입니다. ida_folder\optim\designer\runservice 폴더에서 명령행을 열어야 합니다.
java -jar com-ibm-nex-client-tool.jar 명령은 다음과 같은 구문을 사용합니다. 여기서, java_folder는 Java 6.0 JRE 또는 JDK 설치의 루트 폴더입니다. 이 명령을 입력할 때마다 루트 폴더를 입력하도록 요청받지 않으려면 PATH 환경 변수에 루트 폴더를 추가하십시오.
java_folder/java -jar com-ibm-nex-client-tool.jar {--service | -s} servicename:version {--url | -u} serverURL {--continueOnError | -c}
데이터 관리 서비스 이름 및 버전 번호(n.n.n 형식)입니다. 필수입니다.
서비스 이름은 대소문자를 구분합니다. 서비스 이름에 스페이스 또는 멀티바이트 문자 세트(MBCS) 문자가 포함된 경우 이름을 큰따옴표로 묶어야 합니다.
예: -s demosvc:1.0.0.
예: -u http://mgmtserver1:8080.
이 매개변수는 서비스가 프록시에 의해 시작되지 못하더라도 실행을 위해 프록시에 계속해서 서비스를 보내도록 스크립트를 설정합니다.
명령행을 사용하여 동일한 관리 서버에 배치된 다중 서비스를 실행할 수 있습니다. 서비스는 지정된 순서로 한 번에 하나씩 시작됩니다(병렬로 실행).
각 서비스 및 버전 쌍을 쉼표로 분리하여 지정하십시오. 쉼표 앞이나 뒤에 스페이스를 두지 마십시오.
예:
runservice -s service1:1.0.0,service2:1.0.0 -u http://mymgmtserver:8080 -c
서비스 이름에 스페이스 또는 멀티바이트 문자 세트(MBCS) 문자가 포함된 경우 이름을 큰따옴표(" ")로 묶어야 합니다. 예:
runservice -s "service name":1.0.0 -u http://mymgmtserver:8080
명령행을 사용하여 파일로 내보낸 서비스 요청을 실행할 수 있습니다.
예:
runservice -r C:\services\service1.jar -u http://myproxy:12000
오버라이드 파일은 서비스 요청 매개변수가 포함된 XML 파일입니다. 내보낸 서비스 요청을 실행할 때 오버라이드 파일을 지정하는 경우 runservice 스크립트에서 요청을 실행할 때 오버라이드 파일의 매개변수를 사용합니다.
runservice 스크립트를 사용하여 서비스 요청의 매개변수가 있는 오버라이드 파일을 생성할 수 있습니다.
runservice {-g|--generateOverrideTemplate} requestfilepath {-v|--overrideValues} overridefilepath {-i|--includeComments} {true|false}
내보낸 서비스 요청에 대한 완전한 파일 경로로, 필수입니다.
서비스 요청 파일 이름은 대소문자를 구분합니다. 서비스 요청 파일 이름에 스페이스 또는 멀티바이트 문자 세트(MBCS) 문자가 포함된 경우 이름을 큰따옴표로 묶어야 합니다.
예: -v C:\override\requestfileoverride.xml.
겹쳐쓰기 파일에 주석을 포함시킬지 여부를 지정합니다. 올바른 값은 true 및 false입니다. 기본적으로 오버라이드 파일에는 주석이 포함되지 않습니다.
오버라이드 파일을 생성하면 오버라이드 파일에서 매개변수를 변경할 수 있습니다. 서비스 요청을 실행하는 경우 변경된 오버라이드 파일을 지정할 수 있으며 runservice 스크립트에서 변경된 매개변수를 사용하여 서비스 요청을 실행할 수 있습니다.
<?xml version=”1.0” encoding=”UTF-8”?> <svc:Overrides xmlns:svc=”http://www.ibm.com/nex/ecore/2.2.0/svc”> <svc:ParentGroup uuid=”...”> <svc:ChildGroup uuid=”...”> <svc:Attribute1 value=”...” uuid=”...” /> <svc:Attribute2 value=”...” uuid=”...” /> <svc:Attribute3 value=”...” uuid=”...” /> ... </svc:ChildGroup> ... </svc:ParentGroup> ... </svc:Overrides>오버라이드 파일은 UTF-8로 인코딩되어야 합니다.
맵 파일은 프록시에서 서비스 요청의 JDBC 드라이버를 프록시의 JDBC 드라이버와 일치시키는 데 사용하는 파일입니다. 서비스 요청의 JDBC 드라이버가 맵 파일의 한 행과 일치하는 경우 프록시에서는 해당 행에 지정된 JDBC 드라이버를 사용합니다. 서비스 요청의 JDBC 드라이버가 맵 파일의 행과 일치하지 않는 경우 프록시는 서비스 요청에서 지정된 JDBC 드라이버를 사용합니다. (프록시에 JDBC 드라이버가 있는 경우 최신 버전의 JDBC 드라이버를 사용하도록 프록시를 구성할 수 있습니다.)
<regex>=<path><regex>는 디자이너에서 제공하는 .jar 이름과 일치시키는 데 사용할 올바른 정규식 패턴입니다. <path>는 프록시에 있는 실제 .jar 파일의 완전한 경로입니다.
db2jcc4.*\.jar=/opt/IBM/sqllib/java/db2jcc4.jar db2jcc4_license_cu.*\.jar=/opt/IBM/sqllib/java/db2jcc4_license_cu.jar서비스 요청이 JDBC 드라이버 db2jcc4-9.1.jar를 사용하도록 설정되면 프록시는 JDBC 드라이버 /opt/IBM/sqllib/java/db2jcc4.jar로 서비스 요청을 실행합니다. 서비스 요청이 JDBC 드라이버 db2jcc4_license_cu-9.1.jar를 사용하도록 설정되면 프록시는 JDBC 드라이버 /opt/IBM/sqllib/java/db2jcc4_license_cu.jar로 서비스 요청을 실행합니다.
runservice 스크립트를 사용하여 서비스 요청에서 명확한 텍스트 비밀번호를 암호화할 수 있습니다.
runservice {-e|--encryptPassword} password
암호화할 일반 텍스트 비밀번호로, 필수입니다.
runservice 스크립트를 사용하여 서비스 요청에서 시작 테이블(및 다른 테이블)을 표시할 수 있습니다.
runservice {-a|--startTable} requestfilepath {-o|--otherTables } {true|false}
시작 테이블을 표시할 내보낸 서비스 요청에 대한 완전한 파일 경로로, 필수입니다.
서비스 요청 파일 이름은 대소문자를 구분합니다. 파일 이름에 스페이스 또는 멀티바이트 문자 세트(MBCS) 문자가 포함된 경우 이름을 큰따옴표로 묶어야 합니다.
서비스 요청에 있는 다른 테이블을 출력에 포함시킬지 여부를 지정합니다. 올바른 값은 true 및 false입니다. 기본적으로 모든 테이블이 포함됩니다.
runservice 스크립트를 사용하여 서비스 요청의 정보를 표시할 수 있습니다.
runservice {-d|--displayService} requestfilepath {-x|--xsltStylesheet} stylesheetpath
정보를 표시할 내보낸 서비스 요청에 대한 완전한 파일 경로로, 필수입니다.
서비스 요청 파일 이름은 대소문자를 구분합니다. 파일 이름에 스페이스 또는 멀티바이트 문자 세트(MBCS) 문자가 포함된 경우 이름을 큰따옴표로 묶어야 합니다.
서비스 요청을 형식화하는 데 사용될 XSLT 스타일시트의 완전한 파일 경로입니다.
XSLT 스타일시트 파일 이름은 대소문자를 구분합니다. 파일 이름에 스페이스 또는 멀티바이트 문자 세트(MBCS) 문자가 포함된 경우 이름을 큰따옴표로 묶어야 합니다.