Interstage Application Server V7.0 Operation Guide

1. Interstage Application Server V7.0Operation Guide Fujitsu Korea Limited ITA Consulting Group

2. INDEX 0. Interstage Architecture 1. Interstage Management Console 2. Web Server 운영 3. Interstage 운영 및 환경 설정 4. JDBC Resource 설정 5. Work Unit 환경 설정 6. Appendix

3. 0. Interstage Architecture

4. Servlet EJB Servlet Servlet Servlet Servlet Servlet EJB EJB Servlet Servlet Servlet EJB Servlet EJB Servlet Servlet Servlet Interstage Architecture (어플리케이션 관리) Interstage 監視デーモン 감시 프로세스 WorkUnit Manager (어플리케이션 관리) WebOnly Type (Work Unit) 큐 관리 Webコンテナ User FJApache (웹서버) DB DB 서버 キュー制御 큐 관리 Web + EJB Type (Work Unit) Webコンテナ 개발자 웹 서비스 Eclipse IHV キュー制御 EJB Only Type (Work Unit) Webコンテナ 레거시시스템 Interstage의 Web기반 서비스는 크게 웹 서버(FJApache)와 Interstage기반에서 실행되는 WorkUnit으로 구분한다.Work Unit이란 서블릿,EJB컨테이너를 기동 정지하는 단위이며, 목적에 따라 여러가지 Type으로 설정할 수 있다.

5. 1. Interstage Management Console Interstage 의 운영 관리의 대부분은 웹 브라우저 기반으로 제공되는Interstage Management Console 수행할 수 있다. 이 장에서는 Interstage Management Console에 로그인하는 방법과,Interstage Management Console 의 환경설정에 대해 기술되어 있다.

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

7. Interstage Management Console 환경 설정 file Interstage Management Console 서비스는 12000 번 포트로 접속하게 된다. Interstage Mamagement Console 서비스를 기동하기 위한 방법은 다음과 같다. [ Windows의 경우 ] Interstage Jservlet(OperationManagement) , Interstage Operation Tool Interstage Operation Tool(FJApache) 3개의 서비스를 기동한다. Interstage Operation Tool 서비스를 기동하면, 나머지 2개의 서비스가 같이 기동 된다.

8. [ Solaris, Linux 의 경우 ] # /opt/FJSVisgui/bin/ismngconsolestart [ 기동 ] # /opt/FJSVisgui/bin/ismngconsolestop [ 정지 ] (3) 로그인 후 Console Preference 를 클릭하여Interstage Management Console 에 대한 환경을 설정한다. ☞ 기동 : http://host_name:12000/IsAdmin ※ On-Screen Item Descriptions 가 Enable일 경우 Interstage Management Console상에서 설정하는 모든 항목에 대한 설명이 화면에 표시된다.

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

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

11. WebServer 기본 운영 및 환경 설정 Interstage Management Console에서도 웹서버를 기동 / 정지 할 수 있다.

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

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

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

15. 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의 모든 서비스를 강제 종료, 웹 서비스도 포함)

16. ☞ Interstage Management Console상에서도 아래 버튼을 클릭하여 기동/정지 할 수 있다. 기동 정지

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

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

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

20. Data Source 명 DB Type 설정 .bindings 파일 생성 위치 Data Source JNDI명 Thin/Oci 방식 선택 URL 및 port명 ORACLE SID명 (2) 생성할Data Source의DB정보를입력하고‘Create’버튼을누른다.

21. (3) 생성한Data Source를 이용하여 DB에 접속하기 위한 Sample Code import= javax.naming.*; …..중간 생략 javax.sql.DataSource dataSource = null; try { InitialContext ctx = new InitialContext(); //Data Source Lookup dataSource = (javax.sql.DataSource) ctx.lookup("java:comp/env/jdbc/test"); } catch(NamingException ex) { ex.printStackTrace(); } java.sql.Connection connection = null; java.sql.Statement stmt= null; java.sql.ResultSet rs = null; try { connection = dataSource.getConnection(); //DB Connection stmt = connection.createStatement(); } catch (java.sql.SQLException e) { e.printStackTrace(); } ……생략 Note) 다음과 같은 코딩형태도 가능. 1) dataSource = (javax.sql.DataSource) ctx.lookup("jdbc/test"); 2) dataSource = (javax.sql.DataSource) ctx.lookup(“test");

22. 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란 용어를 사용하지않는다.

23. WorkUnit 운영 다음 화면에서 Work Unit의 운영상태를 알 수 있으며 해당 버튼을 이용해 기동, 종료할 수 있다. Console상에서 다음 명령을 이용할 수도 있다. # islistwu –a ( 등록된 모든 IJServer 목록 나열 ) # islistwu ( 기동중인 IJServer 목록 나열 ) # isstopwu -c [IJServer명] ( IJServer 정지 ) # isstartwu [IJServer명] ( IJServer 기동 ) # islistaplproc ( workunit에서 운용되고 있는 어플리케이션의 프로세스 정보표시)

24. [ WorkUnit 생성 ] (1) WorkUnit 신규 생성 : : WorkUnit Name 을 입력한 후 Detailed Settings 오른쪽의 [Show] 버튼을 누른다.

25. (2) IJServer Settings 메뉴에서 해당 WorkUnit의 운영 Type을 결정한다. Note)) IJServer Type이Web+EJB[same VM]일 경우,이에 속해 있는 EJB를 다른 IJServer에서 호출할수없다. 다른 IJServer혹은 Remote환경에서해당 IJServer에 속해있는 EJB를호출할 수 있게 하려면, Web+EJB[separate VM]또는EJB Only server를 선택해야 함.

26. (3) WorkUnit세팅 : : WorkUnit Setiings 메뉴에서 해당 파라미터들을 설정한다. 각 파라미터 들에 대한 설명은 해당 페이지 오른쪽에 각각 기술되어 있다. ☞ 해당 WorkUnit 에서 필요로 하는 CLASSPATH 등록 ☞ JDK버전 선택 ☞ heap 사이즈 설정 등 VM 옵션 설정 ☞ Automatic Start 일 경우, Interstage(WAS) 기동 시 자동기동 ☞ 관련 어플리케이션에 따라 튜닝 꼭 필요!!

27. (4) Common Application Settings 세팅 : : WorkUnit Setiings 메뉴에서 각 파라미터들을 설정한다. ☞ HotDoploy의 기본값은 Disabled. Enabled : 관련 모듈을 deploy후 적용함에 있어서 Container의 재기동없이 적용가능. ※ 기본 제공되는 파서가 아닌 다른 파서를 이용하고자 할 경우 1) Common Application Settings - Type of XML parser to use 부분의 User defined parser path를 선택. C:\alex 처럼 파서파일이 위치한 디렉토리 등록. 2) WorkUnit Settings - Java VM Options 에 아래의 옵션 추가 -Djava.endorsed.dirs=C:\alex(파서가 위치한 디렉토리)

28. ☞ 서블릿 파일을 이용할 경우에는 『 On』을 선택한다 (5) Servlet Container Settings 세팅 : : WorkUnit Setiings 메뉴에서 각 파라미터들을 설정한다. (6) DB Connection Settings : 마지막으로 해당 IJServer에서 사용할 DB Connection Pool 대한 정보를 설정한 후 IJServer를 생성하기 위해 “Create” 버튼을 누른다. ☞ 수정할 Data Source Name 앞에 체크 후, 수정을 해야 수정내용이 반영됨.

29. (6) Work Unit 리스트 확인 : Work Unit이 새로 생성되었음을 알 수 있다

30. [ WorkUnit 정의 수정 ] (1) 수정할 WorkUnit을 클릭한다.

31. (2) “Settings” 탭으로 이동한 후 생성 시와 같은 방법으로 설정한 후 “Update”버튼을 클릭한다. . ☞ 여러 개의 Virtual Host가 등록된 경우, 사용하고자 하는 가상호스트를 선택.

32. [Deployment] (1) 해당 WorkUnit의 Deploy 탭으로 이동 (2) Deploy할 war,jar,ear 파일을 선택하고 “Deploy” 버튼을 누른다. ☞ Deploy 후에 WorkUnit이 재기동 되게 하려면 체크

33. <참고>해당 컨테이너의 jsp등을 호출하기 위한 Context URL이 된다. Context를 “/” 로 하고 싶을 경우에는 Web Application Name의 이름을 “ROOT”로 설정한다. (3) 필요한 경우 [Show] 버튼을 클릭하고 세부 설정을 할 수 있다. (4) Deploy 경로 • 웹 어플리케이션 war파일을 디플로이 할 경우 각 O/S별로 다음 경로에 배치된다. • [Solaris판의 경우] • /opt/FJSVj2ee/var/deployment/ijserver/{IJServer 명}/apps/{모듈 명} • [Windows판의 경우] • c:\Interstage\J2EE\var\deployment\ijserver\{IJServer 명}\apps\{모듈 명}

34. [Undeployment] (1) 해당 WorkUnit의 Application Status 탭으로 이동 (2) 보여줄 목록의 타입 선택 (모듈/어플리케이션) (3) Undeploy할 모듈이나 어플리케이션을 선택하고 “UnDeploy” 버튼을 누른다.

35. [ Deployment/UnDeployment 실행방법 (Command) ] 명령어로 만들어진 war, jar 파일들을 디플로이/언디플로이 하는 방법입니다. ☞ 제한 조건 Interstage Application Server Enterprise Edition, Interstage Application Server Standard Edition에서만 사용 가능합니다. ☞ 명령어 [ 디플로이 방법 ] - ijsdeployment -n IJServer명 -f 해당파일(*.war, *.jar, ...)  (예) ijsdeployment -n web1 -f testWeb.war [ 언디플로이 방법 ] - ijsundeployment -n IJServer명 -f : 해당 IJServer에 배치된 모든 어플리케이션 해제 - ijsundeployment -n IJServer명 -k [ejb|web] -a Application명 : 어플리케이션 명은 공백으로 복수 지정가능하며, 배치해제 하고자 하는 종류를 선택할 수 있음.

36. [ Tip ] • 개발자의 다른 Edition (Plus Edition, …) 에서 위의 명령어를 사용하려면 Standard Edition 이상이 설치된시스템에서 다음 파일들을 해당 디렉토리에 복사하여 사용할 수 있다. • C:\Interstage\J2EE\lib 이하 • isj2eecmd.jar • C:\Interstage\J2EE\bin 이하 • ijsdeployment.exe , ijsundeployment.exe, libisj2eecmdcom.dll

37. [ IJServer별 어플리케이션 보기 (Command)] IJServer에 deployment 된 어플리케이션의 리스트를 보고자 할 경우 사용. ☞ 제한 조건 Interstage Application Server Enterprise Edition, Interstage Application Server Standard Edition에서만 사용 가능합니다. ☞ 명령어 - ijslistapl -n IJServer명 : 해당 IJServer에 등록된 모든 어플리케이션의 타입과 이름 나열 - ijslistapl : 모든 IJServer에 등록된 모든 어플리케이션의 타입과 이름 나열 (예) # ijslistapl -n web1 ** web1 ** kind name WEB Web1 WEB testWeb11 # ijslistapl ** web1 ** kind name WEB Web1 WEB testWeb11 ** IJServer ** kind name EJB sample1

38. [ Web Application 환경설정 ] WorkUnit Tree화면에서 환경을 수정할 workunit의 모듈 선택. ☞ 환경설정 할 어플리케이션 선택 / 환경수정 Jsp 파일의 reloadable 기능과 시간 정의

39. [ EJB Application 환경설정 ] WorkUnit Tree화면에서 환경을 설정할 workunit의 EJB Application을 선택한다. <ear 파일로 배치시킬 경우, jar 파일로 배치하면 jar로 나옴> 클릭 <ear 파일안의 jar 모듈> EJB Application의 환경설정에서 auto reload 설정을 하면 수정한 클래스를 /app 디렉토리 밑에 복사만으로 재기동 없이 자동 적용됨. (단, Interface가 모두 변경되는 경우 제외)

40. Default : Module List로 보여짐. 상세정보

41. ☞ 환경설정 할 어플리케이션 선택 (MDBean의 경우) 해당 Application의 이름을 선택하여 각 Application의 설정 정보를 수정한다.

42. Message-driven Bean에서는 시스템 예외가 발생했을 경우, Rollback에 의한 무한루핑을 방지하기 위해 [Message Saving During Failure] 에 설정한 Retry Count 만큼 재기동 하는 기능을 지원. ※ Transaction 속성이 Required 일 경우에 가능. [Retry Count 설정값 의미] 0 : 정상 처리가 될 때까지 무한 1 : 재 실행을 하지 않음 2 이상 : 숫자만큼 재실행 원하는 타입으로 변경가능.

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

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

45. [WorkUnit Monitoring] ☞ 해당 Work Unit 화면의 “Monitoring” 탭에서 JVM 정보 및 Connection Pool 정보를 모니터링 할 수 있다.

46. [Application Monitoring] ☞ [워크유닛]-[어플리케이션 Type]화면의 “Monitoring” 탭에서 각 어플리케이션의 성능정보를 모니터링 할 수 있다.

47. 6. Appendix

48. ☞ 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 에러가 발생

49. ☞ input parameter encoding 설정 ① 해당 IJServer의 server.xml 에 다음 설정을 추가한다. [Unix계열일 경우] /opt/FJSVj2ee/var/deployment/ijserver/{IJServer명}/server.xml [Windows일 경우] c:\interstage\j2ee\var\deployment\ijserver\{IJServer명}\server.xml 수정 …. <Context path="/partner3" docBase="partner3" reloadable="false" crossContext="false" cookies="true" storeSessionCookies="false" urlEncode="0" jsAuthentication="true" inputcode="euc-kr"> …. ② 해당 IJServer를 재기동한다.

50. ☞ JSP 수정시 바로 적용 설정 (개발 시) ① C:\interstage\j2ee\var\deployment\ijserver\{IJServer명}\web.xml 에서 "development" 옵션을 "true"로 설정하고 해당 ijserver를 재기동 합니다. [Unix계열일 경우] /opt/FJSVj2ee/var/deployment/ijserver/{IJServer명}/ web.xml [Windows일 경우] c:\interstage\j2ee\var\deployment\ijserver\{IJServer명}\ web.xml 수정 <servlet> <servlet-name>jsp</servlet-name> <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class> .... <!-- change start ---!> <init-param>             <param-name>development</param-name>             <param-value>true</param-value>                    </init-param> <!-- change end ---!> .... </servlet> Note) JSP Reload설정 및 Reload주기가 설정되어 있는 경우, 기본설정은1) Reload주기까지는 JSP재 컴파일을 하지 않으며2) 수정한 JSP가 문법 오류가 있는 경우, container.log 상에는 컴파일 에러를 출력하지만, 실제 서비스에는 서비스가 정상적으로 되었던 이전 JSP를 서비스 하도록 되어 있습니다. 때문에 한 번 정상적으로 컴파일된 클래스가 클래스 로더에 의해, 메모리에 로딩되면 Reload 주기가 되기 전까지는 이전의 클래스를 계속 이용합니다.