serviceDeploy 명령을 사용하여
SCA(Service Component Architecture) 호환 모듈을 서버에 설치할 수 있는 Java™ 응용프로그램으로
패키지합니다. 이 명령은
wsadmin을 통해 일괄처리 설치를 수행할 때 유용합니다.
목적
serviceDeploy 명령은 서비스 컴포넌트를 포함하는
.jar 또는 .zip 파일에서 .ear 파일을 빌드합니다.
주: 매개변수는
대소문자를 구분하지 않습니다.
역할
이 명령은 다음 역할이 있는 사용자가
발행할 수 있습니다.
구문

>>-serviceDeploy-- -inputarchive-------------------------------->
>--+--------------------------------+--------------------------->
'- -workingDirectory-- -temppath-'
>--+------------------------------------------------+----------->
'- -outputApplication-- -+-inputarchiveApp.ear-+-'
'-outputpathname.ear--'
>--+----------------+--+------------+--------------------------->
'- -noJ2eeDeploy-' '- -freeform-'
>--+-----------------------+--+--------+--+----------------+---->
'- -cleanStagingModules-' '- -keep-' '- -ignoreErrors-'
>--+----------------------------------------------------+------->
'- -classpath-- -jarpathname--;--rarpathname--;--...-'
>--+---------------------------+--+-------------+--------------->
'- -fileEncoding-- -charset-' '- -javaDebug-'
>--+----------------+--+----------------+--+--------+----------><
'- -noJavaSource-' '- -uniqueCellID-' '- -help-'
매개변수
- inputarchive
- 전개할 응용프로그램을 포함하는 .jar, .zip 또는 .ear
파일을 지정하는 필수 위치 매개변수입니다. 파일이 위치한 경로에서
명령을 발행하지 않은 경우 파일의 전체 경로여야
합니다. .zip 파일은 오버레이된 아카이브 또는 Eclipse 프로젝트
교환 형식 파일이 될 수 있습니다.
- -classpath
- 필수 자원 파일(.jar 및 .rar) 위치를 지정하는 선택적 매개변수입니다. 각 파일의 경로는
공백 없이 세미콜론(;)으로 구분되는 완전한 경로여야 합니다.
- -fileEncoding
- 전개할 응용프로그램이 JVM(Java virtual machine)의 기본 파일 인코딩에서
지원하는 것과 다른 charset를 사용하는 경우 필요한 문자 세트(charset)를 지정하는
선택적 매개변수입니다.
주: z/OS®에서 serviceDeploy 명령은 항상
기본 파일 인코딩으로 ASCII를 사용합니다.
예를 들어, 응용프로그램에 일본어 문자를 포함하는
비즈니스 규칙 테이블이 들어 있는 경우 생성된 Java 및 클래스 파일의
데이터 손상을 방지하기 위해 2바이트 문자를 지원하는 charset(예: UTF-8)를
지정해야 합니다.
-fileEncoding에 유효한 값은
http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html에 있습니다.
지정되어 있지 않으면 이 매개변수의 기본값은
JDK(Java development kit)에서 지원하는 기본 문자 세트입니다.
중요사항: 이 매개변수는
serviceDeploy로 생성되는 파일에만 영향을 줍니다.
기존 파일은 해당 현재 인코딩을 보유합니다.
제한사항: serviceDeploy 명령을
실행 중인 운영 체제에서 지원되지 않는 charset를 지정하면, 시스템에서는
-fileEncoding을 지정하지 않은 것처럼 아카이브를 처리하고
시스템 로그에 메시지가 기록됩니다.
- -freeform
- service.jar의 J2EE 서브디렉토리가 자유 형식 프로젝트로 처리되도록 지정하는
선택적 매개변수입니다.
- -help
- 이 명령의 매개변수를 표시하는 데 사용되는 선택적 매개변수입니다.
- -ignoreErrors
- 응용프로그램을 빌드 또는 유효성을 검증하는 동안 오류에 관계 없이 serviceDeploy 명령이
.ear 파일을 빌드하도록 지정하는 선택적 매개변수입니다. 기본적으로 응용프로그램에 오류가 있는 경우
serviceDeploy 명령은 .ear 파일을 생성하지 않습니다.
- -javaDebug
- 생성된 클래스 파일에 모든 디버그 정보가 포함되어야 하는지를 지정하는 선택적 매개변수
- -noJavaSource
- 생성된 EAR 파일에서 Java 소스 파일이 제외되어야 하는지를 지정하는 선택적 매개변수. 기본적으로
Java 소스 파일은 포함됩니다.
- -cleanStagingModules
- 전개 전에 입력 .ear 파일에서 스테이징 모듈 삭제 여부를 지정하는
선택적 매개변수입니다. 기본적으로 serviceDeploy 명령은
기존 스테이징 모듈 및 해당 컨텐츠를 가져옵니다.
- -keep
- 전개 후에 생성된 임시 파일 저장 여부를 지정하는
선택적 매개변수입니다. 기본적으로 serviceDeploy 명령은
임시 작업공간을 삭제합니다.
- -noJ2eeDeploy
- .ear 파일 생성 후에 응용프로그램에서 EJB 전개를 필요로 하는지를 지정하는
선택적 매개변수입니다. 기본적으로 serviceDeploy 명령은
응용프로그램에 J2EE 전개자를 실행합니다.
- -outputApplication
- serviceDeploy 명령으로 작성된 .ear 파일 이름을 지정하는
선택적 매개변수입니다. 기본값은 inputarchiveApp.ear이며, 여기서 inputarchive는
입력 .jar 파일에 지정된 확장자를 제외한 파일 이름입니다.
- -outputApplicationMigratedApp.ear
- 입력 아카이브를 WebSphere® Interchange Server에서
이주된 .jar 파일로 지정하는 선택적 매개변수입니다.
- -uniqueCellID
- 응용프로그램의 고유 인스턴스를 작성하는 데
사용하는 문자열 ID를 지정하는 선택적 매개변수입니다.
ID는 셀의 컨텍스트에서 고유해야 합니다.
- -workingDirectory
- serviceDeploy 명령이 임시 파일을 작성하는 데 사용하는 디렉토리를
지정하는 선택적 매개변수입니다.
입력
다음 파일 유형은
serviceDeploy 명령에 대한 입력으로
사용할 수 있습니다.
- jar
- 가장 간단한 응용프로그램의 가장 유용한 파일 유형입니다. 결과 .ear 파일에는
하나의 .jar 파일과 필요한 모든 생성된 스테이징 모듈이 들어 있습니다.
.jar 파일에는 service.module 파일이 들어 있어야 합니다.
- zip(프로젝트 상호 교환)
- 프로젝트 상호 교환 형식으로 WebSphere Integration Developer에서
아카이브 파일을 내보낼 수 있습니다. 이 형식은 Eclipse
개발에 고유합니다. 내보낸 zip 파일에는 service.module 파일을 포함한
단 하나의 프로젝트가 들어 있어야 합니다. 정확하게 Project Interchange에 있는
것에 따라서 결과 .ear 파일에 임의 숫자의 모듈이 들어 있습니다.
- zip
- .jar 파일, .war 파일 및 .rar 파일이 들어 있는 zip 파일을 작성할 수
있습니다. 정확하게 하나의 .jar 파일이 service.module 파일을 포함해야
합니다. 포함된 모든 아카이브가 내보낸 최종 .ear 파일의 구성원이 됩니다.
- ear
- .ear 파일에 있는 하나의 .jar 파일에 service.module 파일이
포함되어 있는 경우 .ear 파일에 대해 항상 serviceDeploy 명령을
실행할 수 있습니다.
출력
serviceDeploy가
처리를 완료하면 -outputApplication 매개변수가 지정되지 않는 경우 명령이 실행되는
디렉토리에 .ear 파일이 작성됩니다.
serviceDeploy 명령 예제
다음 명령 예제:
- MyValueModule.jar 파일에서 MyValueModule.ear이라는
응용프로그램 파일을 작성합니다.
- 자원이 c:\java\myvaluemoduleres.rar 및 c:\java\commonres.jar 디렉토리에 상주하도록 지정합니다.
- .jar 파일 내에서 Java 하위 디렉토리가 자유 형식으로 사용되록 합니다.
- 전개 시 생성된 임시 파일을 보관합니다.
servicedeploy MyValueModule.jar
-classpath "c:\java\myvaluemoduleres.rar;c:\java\commonres.jar"
-noj2eedeploy -freeform true -keep