Interstage Application Server V6.0 Operation Guide

1. InterstageApplication Server V6.0Operation Guide 한국후지쯔 Internet사업부

2. □ 목차 • 1. Interstage Management Console • 2. Web Server운영 및 환경 설정 • 3. Interstage 운영 및 환경 설정 • 4. JDBC 환경 설정 • 5. WorkUnit 환경 설정 • - Deployment/Undeployment • - 환경 정의 • - Monitoring • 6. JMS 환경 설정 • 7. Appendix • - Root Context path

3. 1. Interstage Management Console Interstage 의 운영 관리는 웹 형태로 제공되는Interstage Management Console 에서 대부분 수행할 수 있다. 이 장에서는 Interstage Management Console에 로그인하는 방법과,Interstage Management Console 의 환경설정에 대해 기술되어 있다.

4. Interstage Management Console 실행 (1) 다음 URL로 해당 서버의 Interstage Management Console에 접속한다. ☞ 기동 : http://host_name:12000/IsAdmin ☞ 시스템 패스워드 (2) 접속 후 admin계정으로 로그인한다. [Solaris의 경우 ] root / (root패스워드) [Windows의 경우] administrator / (administrator의 패스워드)

5. Interstage Management Console 환경 설정 file Interstage Management Console 서비스는 12000 번 포트로 접속하게 된다. Interstage Mamagement Console 서비스를 기동하기 위한 방법은 다음과 같다. [ Windows의 경우 ] Interstage Jservlet(OperationManagement) , Interstage Operation ToolInterstage Operation Tool(FJApache) 3개의 서비스를 기동한다. Interstage Operation Tool 서비스를 기동할 경우 나머지 2개의 서비스가 같이 기동된다. Example)) [ Solaris 의 경우 ] /etc/rc2.d 아래의 해당 Shell 을 기동하게 된다. # /etc/rc2.d/S99isstartoptool start [ 기동 ] # /etc/rc2.d/S99isstartoptool stop [ 정지 ]

6. (3) 로그인 후 Console Preference 를 클릭하여Interstage Management Console 에 대한 환경을 설정한다. ☞ 기동 : http://host_name:12000/IsAdmin ※ On-Screen Item Descriptions 가 Enable일 경우 Interstage Management Console상에서 설정하는 모든 항목에 대한 설명이 화면에 표시된다.

7. 2. Web Server 운영 Interstage V6는 기본적으로 FJApache를 기본 웹 서버로 사용한다. 이 장에서는 FJApache에 대한 설정 및 운영방법에 대한 내용을 기술한다.

8. WebServer의 기동 / 정지 Solaris) 다음 명령으로 기동 정지한다. #cd /opt/FJSVihs/bin # apachectl start ( 기동 ) # apachectl stop ( 정지 ) Windows) 서비스에서 FJapache 를 기동 / 정지한다.

9. WebServer 기본 운영 및 환경 설정 Interstage Management Console에서도 웹서버를 기동 / 정지 할 수 있다. ☞ webserver (FJApache)의 환경 정의 웹 서버의 환경 설정파일은 [Windows]의 경우 c:\Interstage\F3FMihs\conf\httpd.conf[Solaris ]의 경우 /opt/FJSVihs/conf/httpd.conf 를 설정한다. Interstage Management Console에서도 대부분의 항목에 대해 설정할 수 있다. ☞ Port 등의 설정을 변경, 그 밖의 설정은 Detail Settings 의 [Show] 를 클릭한 후 설정한다.

10. ☞ Virtual Host 환경 설정 필요한 경우 FJApache 웹서버에 대해 Virtual Host 설정도Interstage Management Console 에서 할 수 있다. Virtual Host 서비스 할 IP Address, Port Number, Hostname 및DocumentRoot Folder 등의 설정을 한다. ☞ Virtual Host 를 추가해서 사용

11. 3. Interstage 운영 및 환경 설정 Interstage V6에서 기반이 되는 핵심 서비스들에 대한 환경 설정과 운영법에 대한 설정에 대해 기술한다.

12. Interstage 의 기동 / 정지 Interstage 핵심 서비스는 초기화 상태에 따라 5 ~ 6개의 서비스로 구성된다.J2EE 어플리케이션을 운영하기 위해서는 Interstage를 기동하여야 한다. Shell Prompt상에서는 다음 명령을 이용하여 기동/정지한다. # isstat SERVICE NAME STATUS ObjectDirector stop NamingService stop InterfaceRepositoryCacheService stop InterfaceRepositoryCacheEService stop TransactionDirector stop # isstart ( 기동 ) # isstop -f ( 정지 : -f 옵션은 Interstage의 모든 서비스를 강제 종료 ) ☞ Interstage Management Console상에서도 위의 작업을 수행할 수 있다. 기동 정지

13. Interstage 의 각 서비스 환경 설정 ☞ Update System Settings 를 클릭하여 각 서비스 부분에 대해 환경설정을 할 수 있다. ☞ J2EE 어플리케이션에 필요한 클래스패스 등록, 한 행에 하나의 클래스를 기술한다. ☞ [Show]를 클릭하면 각 서비스별 설정 을 위한 항목이 보여짐 ☞ 각 서비스에 대해 설정을 하려면 [Show]를 클릭하여 설정 ◈주의: JDBC Driver의 클래스패스 정보는 시스템환경의 CLASSPATH 또는 위 화면 J2EE Settings의 Classpath에 등록하여 사용.

14. ※ 참고 : Interstage 환경 설정 항목 (1/3) 각 항목에 대한 자세한 설명은 Interstage Management Console의 화면상에 표시된다. (참고) ◎ : default 설정 값

15. ※ 참고 : Interstage 환경 설정 항목 (2/3) (참고) ◎ : default 설정 값 TemporaryQueue 나 TemporaryTopic 을 사용할 경우 JMS 상세설정

16. ※ 참고 : Interstage 환경 설정 항목 (3/3) (참고) ◎ : default 설정 값

17. 4. JDBC Resource 설정 J2EE Application에서 가장 많이 사용하는 Database 연결을 위한JDBC Resource설정하는 방법을 기술한다.

18. JDBC DataSource 환경 설정 (1) 왼쪽 트리 메뉴에서 Services > JDBC 선택한 후 Create a new JDBC Data Source 를 선택한다.

19. (2) 생성할Data Source의DB정보를입력하고‘Create’버튼을누른다. Data Source 명 DB 접속 계정 .bindings 파일 생성 위치 Data Source JNDI명 Thin/Oci 방식 선택 URL 및 port명 ORACLE SID명 <Connection Pool Type선택>* Pool connections in Interstage : OracleConnectionPoolDataSource 사용 * Pool connections in Oracle : OracleConnectionCacheImpl 사용 * Use the distributed transaction : OracleXADataSource 사용

20. 5. Work Unit환경 설정 InterstageV6에서는 모든 J2EE Application이 Interstage고유의 서비스구조인 Work Unit에서 운영된다. 이 절에서는 원하는 어플리케이션 구조에 맞게 Work Unit을 생성하고운영하는 방법에 대해 기술한다. 참고로 J2EE Application에 한해서 Work Unit과 IJServer는 동일한의미를 갖는다. 만약 C, C++, COBOL, Java 언어등를 이용해 CORBA Application,TP Monitor Application을 작성할 경우에는 IJServer란 용어를 사용하지않는다.

21. WorkUnit 운영 다음 화면에서 Work Unit의 운영상태를 알 수 있으며 해당 버튼을 이용해기동, 종료할 수 있다. Console상에서 다음 명령을 이용할 수도 있다. # islistwu -a ( 등록된 모든 IJServer 목록 나열 ) # islistwu ( 기동중인 IJServer 목록 나열 ) # isstopwu -c [IJServer명] (IJServer 정지 ) # isstartwu [IJServer명] ( IJServer 기동 )

22. [ WorkUnit 생성 ] (1) WorkUnit 신규 생성 : : WorkUnit Name 을 입력한 후 Detailed Settings 오른쪽의 [Show] 버튼을 누른다. (2) IJServer Settings 메뉴에서 해당 WorkUnit의 운영 Type을 결정한다. Note)) IJServer Type이Web+EJB[same VM]에deployment일 경우 ,이에 속해 있는 EJB를 다른 IJServer에서 호출할수없다. 다른 IJServer혹은 Remote환경에서해당 IJServer에 속해있는 EJB를호출할 수 있게 하려면, Web+EJB[separate VM]또는EJB Only server를 선택해야 함.

23. (3) WorkUnit세팅 : : WorkUnit Setiings 메뉴에서 해당 파라미터들을 설정한다. 각 파라미터 들에 대한 설명은 해당 페이지 오른쪽에 각각 기술되어 있다. (4) Servlet Container Settings 세팅 : : WorkUnit Setiings 메뉴에서 각 파라미터들을 설정한다.

24. (5) DB Connection Settings : 마지막으로 해당 IJServer에서 사용할 DB Connection Pool 대한 정보를 설정한 후 IJServer를 생성하기 위해 “Create” 버튼을 누른다. (6) Work Unit 리스트 확인 : Work Unit이 새로 생성되었음을 알 수 있다.

25. [ WorkUnit 정의 수정 ] (1) 수정할 WorkUnit을 클릭한다. (2) “Settings” 탭으로 이동한 후 생성 시와 같은 방법으로 설정한 후 “Update”버튼을 클릭한다. .

26. [Deployment] (1) 해당 WorkUnit의 Deploy 탭으로 이동(2) Deploy할 war,jar,ear 파일을 선택하고 “Deploy” 버튼을 누른다. ☞ Deploy 후에 WorkUnit이 재기동 되게 하려면 체크 (3) 필요한 경우 [Show] 버튼을 클릭하고 세부 설정을 할 수 있다. <참고> 해당 컨테이너의 jsp등을 호출하기 위한URL이 된다.

27. (4) Deploy 경로 • 웹 어플리케이션 war파일을 디플로이 할 경우 각 O/S별로 다음 경로에 배치된다. • [Solaris판의 경우] • /opt/FJSVj2ee/var/deployment/ijserver/{IJServer 명}/webapps/{어플리케이션 명} • [Windows판의 경우] • c:\Interstage\J2EE\var\deployment\ijserver\{IJServer 명}\webapps\{어플리케이션 명}

28. 같은 workunit안에서 dispatch 허용 Jsp 파일의 reloadable 기능과 시간 정의 [ Web Application 환경설정 ] WorkUnit Tree화면에서 환경을 설정할 workunit의 Web Application을 선택한다. ☞ 환경설정 할 어플리케이션 선택 ☞ 환경 수정

29. [WorkUnit 기동/정지] 해당 WorkUnit화면에서 “Start/Stop WorkUnit” 버튼을 눌러 기동/정지한다. ☞ 기동/정지

30. [ 실행 ] 다음과 같이 웹 브라우저에서 호출한다.호출할 때의 URL은 다음과 같다. http://{host IP}/{웹 어플리케이션 명}/aaa.jsp 호출 예)

31. [ WorkUnit Monitoring ] ☞ 해당 Work Unit 화면의 “Monitoring” 탭에서 JVM 정보 및 Connection Pool 정보를 모니터링 할 수 있다. [ Application Monitoring ] ☞ [워크유닛]-[어플리케이션 Type]화면의 “Monitoring” 탭에서 각 어플리케이션의 성능정보를 모니터링 할 수 있다.

32. [Deployment] (1) 해당 WorkUnit의 Undeploy 탭으로 이동(2) Undeploy할 war,jar,ear 파일을 선택하고 “UnDeploy” 버튼을 누른다.

33. 6. JMS 환경 설정 이 절에서는 JMS(Java Message Service) 환경을 설정하는 방법을 기술한다.

34. ☞ Topic 이나 Queue 선택 JMS 서비스의 환경설정 JMS 서비스를 하기 위해서는 해당 Unit 등록, 이벤트 채널 등록, JNDI 서비스를 위한 ConnectionFactory, Destination 리소스를 등록하고, 해당 서비스를 기동하여 사용한다. ☞ 이벤트 채널 등록

35. ☞ JMS>Stores를 통해서 이미 Unit이 등록되어 있어야 한다. 이벤트 채널의 상세내용에 대해서는 하단의 Detailed Setting를 통해서 기입. ☞ Destination Resource 등록 Tree에서 작성된 이벤트 채널의 Destination을 선택, Create a New Configuration 탭을 눌러 JNDI 명을 등록한다.

36. ☞ 이벤트 채널 기동 / 정지 왼쪽 프레임의 트리에서 Interstage > System > Services > JMS > EventChannels 를 선택하여 등록된 이벤트 채널을 선택하여 기동 / 정지한다.

37. ☞ Unit 등록

38. ☞ ConnectionFactory 등록 작성하고자 하는 ConnectionFactory의 타입에 맞는 QueueCF 또는 TopicCF를 선택하여 JNDI 와 Client 명을 지정하여 새로운 ConnectionFactory를 등록한다.

39. 7. Appendix

40. 기타 환경설정 ☞ Root의 Context path 설정( URL상에서 Root URL상에서 JSP, Servlet을 서비스 하고자 할 때 ) ① 먼저 웹 서버쪽의 gateway 환경을 수정 C:\Interstage\F3FMihs\conf\workers2.properties파일의 맨 하단에 현재 등록되어 있는 [uri:/MemberClient/*] 가 존재. 이 부분을 [uri:/*]로 변경. 이것은 /로 들어오는 모든 것을 아래 적혀진 group으로 보낸다라는 의미. ② 해당workunit의 환경 정보 수정    웹 소스인 *.war 파일을 deploy 하게 되면 C:\Interstage\J2EE\var\deployment\ijserver 밑에 해당 workunit 이름 밑으로 각 정보가 배치. 웹의 경우 webapps 밑으로 기본 구조에 맞게 deploy 됨.  예) C:\Interstage\J2EE\var\deployment\ijserver\MyDebug밑의 server.xml에서 Root context path를 추가. 추가 할 내용 (예) : <Context path="" docBase="MemberClient" debug="0">          <Loader checkInterval="15" />      </Context> 으로 해당 디렉토리의 webapps 밑에 MemberClient를 ROOT로 잡고 있습니다. 위와 같이 / 로 Context Path를 수정. ※ 유의사항 : 1.workers2.properties파일이 수정되면 웹 서버를 재 기동.      (Windows) 서비스의 FJapache 서비스를 재기동. (Solaris) /opt/FJSVihs/bin/apachectl stop 2.server.xml 파일이 수정되면 해당 workunit을 재 기동. operation tool(http://ip:12000/IsAdmin) 을 이용하여 해당 workunit을 stop/start.

41. 기타 환경설정 (Continue) ☞ 수동으로 임의의 디렉토리와 URL명을 지정하는 싶은 경우 *.war, *.ear 파일이기본적으로 Deployment가 되는 위치 [Windows] C:\Interstage\J2EE\var\deployment\ijserver\해당 IJServer명 이하 [Solaris] /opt/FJSVj2ee/var/deployment/ijserver/해당 IJServer명 이하 ① 먼저 웹 서버쪽의 gateway 환경을 수정 C:\Interstage\F3FMihs\conf\workers2.properties파일의 맨 하단에 등록하고자 하는 uri 정보와 실행을 담당할 IJServer 명을 그룹으로 등록한다. [uri:/TestWeb/*] group=IJServer003. 이것은 /testWeb로 들어오는 모든 것을 아래 적혀진 group (IJServer003)으로 보낸다라는 의미. ② 해당IJServer의 환경 정보 수정    작업을 담당할 IJServer의 환경정보 추가  예) C:\Interstage\J2EE\var\deployment\ijserver\IJServer003밑의 server.xml에서 해당 context path를 추가. (Solaris 일 경우 : /opt/FJSVj2ee/var/deployment/ijserver/IJServer003/server.xml) 추가 할 내용 (예) : <Context path="/TestWeb" docBase="D:\testWeb" reloadable="false" crossContext="false" cookies="true" storeSessionCookies="false" urlEncode="0" jsAuthentication="true"> <Resources className="org.apache.naming.resources.FileDirContext" allowLinking="false" /> <Logger className="org.apache.catalina.logger.SystemOutLogger" /> <Manager maxActiveSessions="-1" /> <Loader checkInterval="15" /> </Context> ③ 웹 서버와 해당 IJServer의 서비스 재기동

42. 기타 환경설정 (Continue) ☞ 기존 deployment 된 uri의 DocBase 위치를 바꾸고자 할 경우 ① 해당 IJServer의 환경 정보 수정 deployment가 수행된 IJServer의 server.xml 수정 예) C:\Interstage\J2EE\var\deployment\ijserver\IJServer003 밑의 server.xml에서 docBase 위치 변경. 변경할 내용 (예) : <Context path="/TestWebApp" docBase="D:\testWeb" reloadable="false“ debug="0"> ……. ……. ② 해당 IJServer의 서비스 재기동

43. 기타 환경설정 (Continue) ☞ JSP Page encoding C:\Interstage\J2EE\var\deployment\ijserver\{IJServer명}\webapps\web.xml 에 다음을 삽입 <servlet> <servlet-name>jsp</servlet-name> <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class> <init-param> <param-name>logVerbosityLevel</param-name> <param-value>WARNING</param-value> </init-param> <!-- for jsp page encoding --> <init-param> <param-name>jspPageEncoding</param-name> <param-value>euc-kr</param-value> </init-param> <init-param> <param-name>enablePooling</param-name> <param-value>true</param-value> </init-param><load-on-startup>3</load-on-startup> </servlet> Note) C:\Interstage\J2EE\var\deployment\ijserver\{IJServer명}\webapps\{servlet-context명}\WEB-INF\web.xml 에 위의 내용을 해당 부분에 삽입할 경우에는 기동 후 jsp를 호출할 경우 not found 에러가 발생