Interstage Application Server V6.0 Operation Guide

1

Interstage Application Server

V6.0

Operation Guide

한국후지쯔 Internet 사업부

All Rights Reserved, Copyright © FUJITSU LIMITED 2002

2

□ 목차

1. Interstage Management Console

2. Web Server 운영 및 환경 설정

3. Interstage 운영 및 환경 설정

4. JDBC 환경 설정

5. WorkUnit 환경 설정

- Deployment/Undeployment

- 환경 정의

- Monitoring

6. JMS 환경 설정

7. Appendix

- Root Context path

□ 목차


2. Web Server 운영 및 환경 설정

3. Interstage 운영 및 환경 설정

4. JDBC 환경 설정

5. WorkUnit 환경 설정

- Deployment/Undeployment

- 환경 정의

- Monitoring

6. JMS 환경 설정

7. Appendix

- Root Context path


3



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

[ Windows 의 경우 ]

Interstage Jservlet(OperationManagement) , Interstage Operation ToolInterstage Operation Tool(FJApache) 3 개의 서비스를 기동한다 .

Interstage Operation Tool 서비스를 기동할 경우 나머지 2 개의 서비스가 같이 기동된다 .

Example))

Interstage Management Console 서비스는 12000 번 포트로 접속하게 된다 .

Interstage Mamagement Console 서비스를 기동하기 위한 방법은 다음과 같다 .

[ 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

설정 항목 설명

Automatic Refresh Interstage Management Console 상의페이지를 자동으로 Refresh 한다 .

Automatic Refresh Interval 자동 Refresh 주기 .

On-Screen Item Descriptions Interstage Management Console 상에서설정할 각 항목에 대한 설명을 보여준다 .

※ On-Screen Item Descriptions 가 Enable 일 경우 Interstage Management Console 상에서 설정하는 모든 항목에 대한 설명이 화면에 표시된다 .


7

2. Web Server 운영 2. Web Server 운영

Interstage V6 는 기본적으로 FJApache 를 기본 웹 서버로 사용한다 .

이 장에서는 FJApache 에 대한 설정 및 운영방법에 대한 내용을 기술한다 .


8

WebServer 의 기동 / 정지

#cd /opt/FJSVihs/bin

# apachectl start ( 기동 )

# apachectl stop ( 정지 )

#cd /opt/FJSVihs/bin

# apachectl start ( 기동 )

# apachectl stop ( 정지 )

Solaris) 다음 명령으로 기동 정지한다 .

Windows) 서비스에서 FJapache 를 기동 / 정지한다 .


9

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] 를 클릭한 후 설정한다 .

WebServer 기본 운영 및 환경 설정


10

☞ Virtual Host 환경 설정

필요한 경우 FJApache 웹서버에 대해 Virtual Host 설정도Interstage Management Console 에서 할 수 있다 .

Virtual Host 서비스 할 IP Address, Port Number, Hostname 및DocumentRoot Folder 등의 설정을 한다 .

☞ Virtual Host 를 추가해서 사용


11

3. Interstage 운영 및 환경 설정 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 의 모든 서비스를 강제 종료 )

# 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 를 클릭하여 각 서비스 부분에 대해 환경설정을 할 수 있다 .

☞ 각 서비스에 대해 설정을 하려면 [Show] 를 클릭하여 설정

☞ [Show] 를 클릭하면 각 서비스별 설정 을 위한 항목이 보여짐

☞ J2EE 어플리케이션에 필요한 클래스패스 등록 ,

한 행에 하나의 클래스를 기술한다 .

◈ 주의 : JDBC Driver 의 클래스패스 정보는 시스템 환경의 CLASSPATH 또는 위 화면 J2EE Settings 의 Classpath 에 등록하여 사용 .


14

항 목 항 목 값

Component services Operation Mode

◇ mode1 (Interstage and component services are synchronized)

◎ mode2 (Interstage and component services are not synchronized)

Automatic Performance Enhancement

◎ Enable Automatic Enhancement◇ Disable Automatic Enhancement

항 목 항 목 값 기 타

Port number 8002 CORBA 서비스를 위한 Port

Maximum number of client connections

512 Max : 500,000

Maximum number of client requests

512 Connection 당 동시에 처리가능한Request 수

Client connection timeout 360 second(s)만약 ‘ 0’ 으로 설정되면 무한정 기다리는 상황 발생 가능

IP version◎ IPv4-dual◇ IPv4◇ IPv6

Server idle timeout 600 second(s)


Use proxy for HTTP tunneling?◇ Yes◎ No

Proxy Server Hostname proxy_host

Proxy Server Port Number 8080


Enable SSL encryption?◇ Yes◎ No

SSL listen port 4433

Select an SSL configuration None

( 참고 ) ◎ : default 설정 값

※ 참고 : Interstage 환경 설정 항목 (1/3)

각 항목에 대한 자세한 설명은 Interstage Management Console 의 화면상에 표시된다 .


15


Use Remote Host for Naming Service?

◇ Yes◎ No

Naming service 를 위한 remote host setup 정보Server Hostname

Port Number 8002


Maximum number of connections per dynamically-generated EventChannel

5Default Value : 50Max : 9999

Maximum number of processes per dynamically-generated EventChannel

2

Use SSL encryption for dynamically-generated EventChannels?

◇ Yes◎ No

TemporaryQueue 나 TemporaryTopic 을 사용할 경우 JMS 상세설정




16


System Mode◎ sys◇ rmp

Transaction log file C:\Interstage\ots\var\tranlog\default.log

Maximum number of transactions

100

OTS system concurrency 5

JTS RMP process concurrency 2

JTS RMP thread concurrency 16

Maximum number of resources per global transaction

4

Naming Service Hostname

Naming Service Port Number

OTS System Encoding Type

Node type◎ Active◇ Standby


Transaction Timeout 300 second(s)

2-Phase Commit Timeout 60 second(s)

Maximum number of transactions per resource 10

Version of JDK/JRE for JTS RMP

◎ JDK/JRE 1.3◇ JDK/JRE 1.4 ◇ Do not use JTS RMP

Path for JDK/JRE for JTS RMP C:\Interstage\JDK13\bin\java.exe

Trace Mode (Trace is output to installation_directory\ots\var)

1

Trace Level 1




17

4. JDBC Resource 설정 4. JDBC Resource 설정

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


18

JDBC DataSource 환경 설정

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


19

ORACLE SID 명

DB 접속 계정

.bindings 파일 생성 위치

Data Source JNDI 명

Thin/Oci 방식 선택

URL 및 port 명

<Connection Pool Type 선 택 >* Pool connections in Interstage : OracleConnectionPoolDataSource 사용* Pool connections in Oracle : OracleConnectionCacheImpl 사용* Use the distributed transaction : OracleXADataSource 사용

Data Source 명

(2) 생성할 Data Source 의 DB 정보를 입력하고 ‘ Create’ 버튼을 누른다 .


20

5. Work Unit 환경 설정 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 의 운영상태를 알 수 있으며 해당 버튼을 이용해기동 , 종료할 수 있다 .

# islistwu -a ( 등록된 모든 IJServer 목록 나열 )

# islistwu ( 기동중인 IJServer 목록 나열 )

# isstopwu -c [IJServer 명 ] ( IJServer 정지 )

# isstartwu [IJServer 명 ] ( IJServer 기동 )

# islistwu -a ( 등록된 모든 IJServer 목록 나열 )

# islistwu ( 기동중인 IJServer 목록 나열 )

# isstopwu -c [IJServer 명 ] ( IJServer 정지 )

# isstartwu [IJServer 명 ] ( IJServer 기동 )

Console 상에서 다음 명령을 이용할 수도 있다 .


22

Note))

IJServer Type 이 Web+EJB[same VM] 에 deployment 일 경우 , 이에 속해 있는 EJB 를 다른 IJServer 에서 호출할 수 없다 .

다른 IJServer 혹은 Remote 환경에서 해당 IJServer 에 속해있는 EJB 를 호출할 수 있게 하려면 , Web+EJB[separate VM] 또는 EJB Only server 를 선택해야 함 .

Note))

IJServer Type 이 Web+EJB[same VM] 에 deployment 일 경우 , 이에 속해 있는 EJB 를 다른 IJServer 에서 호출할 수 없다 .

다른 IJServer 혹은 Remote 환경에서 해당 IJServer 에 속해있는 EJB 를 호출할 수 있게 하려면 , Web+EJB[separate VM] 또는 EJB Only server 를 선택해야 함 .

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

(2) IJServer Settings 메뉴에서 해당 WorkUnit 의 운영 Type 을 결정한다 .


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

(1) 수정할 WorkUnit 을 클릭한다 .

[ WorkUnit 정의 수정 ]

(2) “Settings” 탭으로 이동한 후 생성 시와 같은 방법으로 설정한 후

“Update” 버튼을 클릭한다 . .


26

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

[Deployment]

< 참고 > 해당 컨테이너의 jsp 등을 호출하기 위한 URL 이 된다 .

☞ Deploy 후에 WorkUnit 이 재기동 되게 하려면 체크

(3) 필요한 경우 [Show] 버튼을 클릭하고 세부 설정을 할 수 있다 .


27

(4) Deploy 경로

-웹 어플리케이션 war 파일을 디플로이 할 경우 각 O/S 별로 다음 경로에 배치된다 .

[Solaris 판의 경우 ]

/ opt/FJSVj2ee/var/deployment/ijserver/{IJServer 명 }/webapps/{ 어플리케이션 명 }

[Windows 판의 경우 ]

c:\Interstage\J2EE\var\deployment\ijserver\{IJServer 명 }\webapps\{ 어플리케이션 명 }


28

[ Web Application 환경설정 ]WorkUnit Tree 화면에서 환경을 설정할 workunit 의 Web Application 을 선택한다 .

☞ 환경설정 할 어플리케이션 선택

☞ 환경 수정

같은 workunit 안에서 dispatch 허용

Jsp 파일의 reloadable 기능과 시간 정의


29

☞ 기동 / 정지

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


30

다음과 같이 웹 브라우저에서 호출한다 .호출할 때의 URL 은 다음과 같다 .

http://{host IP}/{ 웹 어플리케이션 명 }/aaa.jsp

[ 실행 ]

호출 예 )


31

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

[ WorkUnit Monitoring ]

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

[ Application Monitoring ]


32

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

[Deployment]


33

6. JMS 환경 설정 6. JMS 환경 설정

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


34

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

☞ 이벤트 채널 등록

☞ Topic 이나 Queue 선택


35

이벤트 채널의 상세내용에 대해서는 하단의 Detailed Setting 를 통해서 기입 .

Tree 에서 작성된 이벤트 채널의 Destination 을 선택 , Create a New Configuration 탭을 눌러 JNDI 명을 등록한다 .

☞ Destination Resource 등록

☞ JMS>Stores 를 통해서 이미 Unit 이 등록되어 있어야 한다 .


36

☞ 이벤트 채널 기동 / 정지

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


37

☞ Unit 등록


38

☞ ConnectionFactory 등록

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


39

7. Appendix7. Appendix


40

① 먼저 웹 서버쪽의 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.

기타 환경설정

☞ Root 의 Context path 설정 ( URL 상에서 Root URL 상에서 JSP, Servlet 을 서비스 하고자 할 때 )


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


☞ 기존 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


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

Documents

Interstage Application Server V6.0 Operation Guide