Apache Axis2 Installation Guide
이 문서는 Axis2 배포 패키지에 대한 정보, 시스템 요구사항, 환경변수 셋팅, 설치 방법에 대한 상세한 설명이 있는 도구를 제공한다.
Send your feedback to: axis-dev@ws.apache.org. Prefix subject with [Axis2]. To subscribe to mailing list see here.
Contents
-------------------------------------------------------------------------------------------------------------------
● Download Axis2
● System Requirements
● Installation Using Standard Binary Distribution
○ Install the Apache Axis2 Binary Distribution
○ Starting up Axis2 Standalone Server
○ Building WAR File Using Standard Binary Distribution
○ Getting Familiar with the Axis2 Convenient Scripts
● Installing Axis2 in a Servlet Container
● Uploading Services
● Advanced
○ Axis2 Source Distribution
■ Setting up the Environment and Tools
■ Building Axis2 Binaries and WAR file Using the Source Distribution
Download Axis2
-------------------------------------------------------------------------------------------------------------------
Axis2 는 몇가지의 편리한 배포 패키지안에 배포되며 standalone 서버 또는 J2EE compliant 서블릿 컨테이너의 일부분으로 설치될수 있다. Axis2 는 Apache License (버젼 2.0) 으로 배포된다. 이 설치 가이드는 Standard Binary Distribution 을 이용하여 Apache Axis2 를 실행하는것에 초점을 맞출것이다.
Apache Axis2 1.1.1 버젼(최신)의 배포 패키지를 다운로드 하라.
Apache Axis2 모든 버젼의 배포 패키지를 다운로드 하라.
배포 패키지는 다음과 같은것들을 제공한다:
1. Standard Binary Distribution
-------------------------------------------------------------------------------------------------------------------
이것은 완벽한 버젼의 Axis2 이며 sample 과 convenient script 를 포함하고 있다.
Standard Binary Distribution 를 다운로드 하라.
2. WAR (Web Archive) Distribution
-------------------------------------------------------------------------------------------------------------------
이것은 대부분의 서블릿 컨테이너에 디플로이 될수 있는 Axis2 웹 어플리케이션이 될것이다.
Download WAR (Web Archive) Distribution
3. Documents Distribution
-------------------------------------------------------------------------------------------------------------------
이것은 하나의 패키지안에 있는 모든 문서를 포함할 것이다. 그 패키지는 이 프로젝트의 xdoc 과 Java API doc 을 포함한다.
Download Documents Distribution
4. Source Distribution
-------------------------------------------------------------------------------------------------------------------
이것은 Axis2 standard distribution 의 소스를 포함할 것이며 주로 advance 사용자들을 위한것이다.
$maven dist-bin 명령어를 이용해 소스로 부터 binary distribution 을 생성할수 있다.
이 명령어를 실행하기전에 당신은 Axis2 환경을 셋팅해야 한다.
Advanced section 에 단계적으로 binary distribution 을 생성하는 방법에 대한 상세설명이 있다.
Download Source Distribution
System Requirements
-------------------------------------------------------------------------------------------------------------------
● Java Development Kit (JDK) - 1.4 or later (For instructions on setting up the JDK in different operating systems,
visit http://java.sun.com)
● Disk - Approximately 11 MB separately for standard binary distribution
● Operating system - Tested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu, Gentoo
● Build Tool-Apache Ant - To run samples and to build war from Axis2 binary distribution.
Version 1.6.5 or higher (download).
● Build Tool-Apache Maven 1.x - Required only for building Axis2 from Source Distribution
1.0.2 or higher in Maven 1.x series (download). Please download maven 1.x version.
Axis2 does not support maven 2.
Installation Using Standard Binary Distribution
-------------------------------------------------------------------------------------------------------------------
1. Download and Install the Apache Axis2 Binary Distribution
-------------------------------------------------------------------------------------------------------------------
Java Development Kit (JDK) release (version 1.4 or later) 을 여기서 다운로드하고 설치하라.
release 에 포함된 설명서에 따라 JDK 를 설치하라.
JAVA_HOME 환경변수를 JDK 가 설치된 디렉토리 경로의 이름으로 셋팅하라.
Axis2 Standard Binary Distribution 을 다운로드하고 편리한 곳에 압축을 풀어라.
AXIS2_HOME 환경변수를 Axis2 의 디렉토리 경로의 이름으로 셋팅하라(예, /opt/axis2-1.1.1).
2. Starting up Axis2 Standalone Server
-------------------------------------------------------------------------------------------------------------------
Standalone Axis2 server 는 다음의 명령어 실행으로 시작할수 있다:
$AXIS2_HOME\bin\axis2server.bat (Windows)
$AXIS2_HOME/bin/axis2server.sh (Unix)
서버를 구동한 후 Axis2 에 포함된 기본 웹 서비스를 http://localhost:8080/axis2/services/ 에서 확인가능하다.
3. Building the Axis2 Web Application (axis2.war) Using Standard Binary Distribution
-------------------------------------------------------------------------------------------------------------------
여기에서 Apache Ant (version 1.6.5 or later) 를 다운로드 하고 설치하라. Ant release 에 포함된 설명서에 따라 설치하라.
ant build file (build.xml) 을 Axis2 home 디렉토리 아래의 webapp 디렉토리 안에 넣어라(예, $AXIS_HOME/webapp).
$AXIS2_HOME/webapps 폴더 안에서 "ant create.war" 를 실행해서 Ant build 를 실행하라.
$AXIS2_HOME/dist 디렉토리 안에서 생성된 axis2.war 를 발견할수 있다.
AXIS2_HOME/repository 안의 모든 service 와 module 들이 $AXIS2_HOME/conf/axis2.xml (Axis2 configuration) 과 함께 axis2.war 안에 포함될 것이다.
아래의 Installing Axis2 in a Servlet Container 부분을 보면 Axis2 web application 을 servlet container 에 디플로이 하는 방법을 알수 있다.
4. Getting Familiar with the Axis2 Convenient Scripts
-------------------------------------------------------------------------------------------------------------------
아래의 스크립트를 원하는 장소에서 실행하기위해 $AXIS2_HOME/bin 을 PATH 에 추가하라.
----------------------------------------------------------------------------------------------------------------
Script Name Description
----------------------------------------------------------------------------------------------------------------
axis2.{bat|sh} Axis2 를 이용하는 web service client 를 실행하기위해 이 스크립트를 사용할수 있다. 이 스크립트는
Axis2 dependent libraries (AXIS2_HOME/lib 폴더 안에 있는 *.jar 파일들) 를 classpath 에 추가하고
Axis2 repository location (AXIS2_HOME/repository) 을 셋팅하고 Axis2 설정파일 위치
(AXIS2_HOME/conf/axis2.xml) 를 세팅한 후 "java" 명령어를 호출한다. 이렇게 함으로서 위의 모든
Axis2 specific parameter 들을 셋팅하는 것으로부터 자유로워질수 있다.
Usage : axis2.{sh.bat} [-options] class [args...]
----------------------------------------------------------------------------------------------------------------
axis2server.{sh|bat} 이 스크립트는 AXIS2_HOME/repository 를 Axis2 repository 로 이용하고
AXIS2_HOME/conf/axis2.xml 파일을 Axis2 설정파일로 이용하는 standalone Axis2 server 를 시작할 수
있다. 이것은 AXIS2_HOME/conf/axis2.xml 에 명시된 모든 transport listener 들을 시작할수 있다.
예를 들면, 만약 당신이 standalone Axis2 server 에 하나의 서비스를 디플로이 하고 싶으면 당신의
service archive 를 AXIS2_HOME/repository/services 디렉토리에 복사해 넣어라. 그런다음
AXIS2_HOME/conf/axis2.xml 의 "Transport Ins" section 으로 이동한다음 transport receivers 를
설정하라 (8080 포트에 simpleHttpServer 가 기본으로 지정되있다). 그런다음 이 스크립트를 호출하라.
----------------------------------------------------------------------------------------------------------------
wsdl2java.{bat|sh} 이 스크립트는 웹 서비스 호출을 관리하기 위한 WSDL 파일에 따라 자바 코드를 생성한다
(Client side Stubs). 또한 이 스크립트는 주어진 WSDL 에 따라 service skeleton 들을 생성할수 있다.
Usage: wsdl2java.{sh|bat} [OPTION]... -uri <Location of WSDL>
Eg: wsdl2java.sh -uri ../wsdl/Axis2Sample.wsdl
이 스크립트에 대한 더 자세한 참조는 여기서 찾을수 있다.
----------------------------------------------------------------------------------------------------------------
java2wsdl.{bat|sh} 이 스크립트는 주어진 자바 클래스로부터 적절한 WSDL 파일을 생성한다.
Usage: Java2WSDL.{sh|bat} [OPTION]... -cn <fully qualified class name>
Eg: Java2WSDL.sh -cn ../samples/test/searchTool.Search
이 스크립트에 대한 더 자세한 참조는 여기서 찾을수 있다.
----------------------------------------------------------------------------------------------------------------
Installing Axis2 in a Servlet Container
-------------------------------------------------------------------------------------------------------------------
어떤 배포본 이던지, 아래와 같이 J2EE compliant servlet container 에 Axis2 를 설치할수 있다:
1. Axis2 Standard Binary Distribution 을 이용해 Axis2 WAR file 을 빌드하라. (아니면 axis2.war 를 다운로드 하던지
Source Distribution 을 이용해 axis2.war 를 빌드할수있다.)
2. servlet container 의 webapps 폴더에 war 를 집어넣어라. 대부분의 servlet container 들은 자동으로 war 를 설치할
것이다. (어떤 서블릿 컨테이너는 새로운 웹 어플리케이션을 인식하기위한 재시작이 필요할수도 있다. 이것에 대한 더
자세한 정보를 원하면 당신의 서블릿 컨테이너의 문서를 참조하라.)
3. WAR 가 성공적으로 설치되고 나면 웹 브라우져로 http://<host :port>/axis2 를 열어 테스트 하라. 그러면 아래와 같이
Axis2 웹 어플리케이션 홈 페이지가 보일것이다.
4. 모든것이 자연스럽고 올바르게 됬는지 확인하기위해 "Validate" 링크를 이용하라. 만약 validation 이 실패하면 war 가
올바르게 설치되것이 아니거나 어떤 필요한 jar 가 누락된 것이다. 실패할 경우 각각의 서블릿 컨테이너의 문서가 문제점을
찾기위한 조언을 제공할것이다. 다음 페이지는 성공적인 validation 의 경우 보여진다. core Axis2 libraries 가 존재하는지
확인하라.
Note: 특정 어플리케이션 서버가 제공하는 설치 정보는 그 어플리케이션 서버가 제공하는 설정 가이드를 참조하라.
Uploading Services
-------------------------------------------------------------------------------------------------------------------
또한 Axis2 Web application 은 서비스를 업로드하기위한 인터페이스를 제공한다. Apache Axis2 Web Administrator's Guide 에서 설명한데로 서비스 명세서에 따라 생성된 서비스의 jar 파일은 업로드 페이지를 이용해 업로드될수 있다.
업로드된 jar 파일들은 기본 서비스 디렉토리에 저장될 것이다. Axis2 에서는 <webapps>/axis2/WEB-INF/services 디렉토리가 된다. 일단 서비스가 업로드되면 즉시 설치될 것이다.
Axis2 가 hot deployment 를 지원하므로 service jar 를 파일 시스템을 통해 위에서 언급한 서비스 디렉토리에 직접 집어넣을수 있다. 또한 이것은 컨테이너의 재시작 없이 서비스가 자동으로 설치되도록 한다.
서비스의 성공적인 설치를 확인하기 위해 웹 어플리케이션 홈 페이지의 'Services' 링크를 이용하라. 성공적으로 설치된 서비스의 service 와 operation 들은 가능한 서비스 페이지에 보여진다.
만약 서비스가 deployment time error 가 발생하면 이 서비스들은 실패 서비스로 보여진다. 링크를 누르면 deployment fault error message(s) 를 볼수 있다.
Deployment time error message
Axis2 Administration 은 런타임에 모든 설정을 할수있으며 짧은시간안에 반영된다. 더 자세한 설명은 Axis2 Web Administration Guide 에서 볼수 있다.
Advanced
-------------------------------------------------------------------------------------------------------------------
Axis2 Source Distribution
-------------------------------------------------------------------------------------------------------------------
Source Distribution 을 사용한 binary 파일 (Standard Binary Distribution 으로 다운로드 가능하다) 과 axis2.war 파일 (WAR distribution 으로 다운로드 가능하다) 의 생성은 maven 명령어로 이루어진다.
필요한 jar 파일들은 distribution 에 포함되 있지 않으며 그들도 또한 maven 명령어의 실행을 통해 만들어진다. 이문서를 더 진행하기위해서는 Maven 을 설채해야 한다.
Setting Up the Environment and Tools
-------------------------------------------------------------------------------------------------------------------
Maven
-------------------------------------------------------------------------------------------------------------------
Axis2 build 는 Maven 을 기반으로 한다. source distribution 으로부터 Axis2 를 빌드하기위해 Maven 이 설치되어 있어야 한다. Maven 사이트에서 많은 설명서를 볼수 있다. 그러므로 이 가이드에서는 빠른 환경 설정을 위해 가장쉬운 방법을 설명한다. Maven 에 대해 더 많은것을 알고 싶으면 여기를 방문하라.
● MS Windows
1. Maven Windows installer package 를 다운로드 하고 실행하라.
2. 'Environment Variables' 를 설정하라. (시스템 변수 MAVEN_HOME 을 생성하고 path 를 수정하라.
예: "C:\Program Files\Apache Software Foundation\maven-1.0.2"; path %MAVEN_HOME%\bin)
3. JAVA_HOME 시스템 변수가 당신의 JDK 가 설치된 폴더로 셋팅되 있는지 확인하라.
예, C:\Program Files\Java\jdk1.5.0_02
4. 올바르게 설치됬는지 확인하기위해 'maven --version' 을 실행하라.
● Unix based OS (Linux etc)
tar ball 또는 zip archive 가 최선의 선택이다. archive 를 다운로드하고 선택한 디렉토리에 압축을 푼다음 MAVEN_HOME 환경변수를 셋팅하고 path 에 MAVEN_HOME/bin 을 추가하라. 유닉스 기반의 OS에 Maven 을 설치하기위한 더 많은 설명서를 보고 싶으면 여기를 방문하라.
maven 을 올바르게 설치한다음 Axis2 를 빌드할수 있다.
자주 사용되는 Maven 명령어들을 FAQs 페이지에 설명해 놨다.
Building Binaries and WAR File Using the Source Distribution
-------------------------------------------------------------------------------------------------------------------
Source Distribution 을 zipped archive 형태로 얻을수 있다. 모든 필요한 빌드 스크립트들은 source distribution 에 포함되있다.
선택된 디렉토리에 source archive 를 푼다음 특정 디렉토리로 이동한다음 maven 명령어를 실행하면 Axis2 jar 파일을 빌드할 것이다.
명령이 완료된 다음에 새로 생성된 "target" 디렉토리에서 binaries (이 경우 jar 파일들) 를 찾을수 있다.
Note: Maven 을 처음 빌드할때 (만약 maven repository 가 먼저 만들어져 있지 않으면) 필요한 jar 파일들을 다운로드하는데 시간이 조금 걸릴것이다. 그러나 성공적인 빌드들에는 영향을 미치지 않고 한번만 처리된다.
기본 maven build 는 Axis2 jar 파일만 빌드한다. WAR (Web Archive) 를 얻기위해서 maven war 명령어를 사용하라. 그러면 target 디렉토리안에 완벽한 axis2.war 파일을 생성할 것이다.
이 빌드 단계가 완료되면 binaries 는 디플로이될 준비가 된것이다.
-------------------------------------------------------------------------------------------------
원본 : http://ws.apache.org/axis2/1_1_1/installationguide.html
번역 : 김운주 ounju@naver.com
댓글 없음:
댓글 쓰기