Interstage Application Server V501 Operation Guide Internet 1
1 1 FJApache FJApache (WWW (WWW server) server) - - file file - - 2 2 InfoProviderPro InfoProviderPro (WWW (WWW server) server) - - file file - - 3 3 Jservlet Jservlet (Servlet (Servlet engine) engine) - - file file - - 4 4 EJB EJB Service Service 5 5 IJServer IJServer Appendix Appendix FAQ FAQ 2
3
4
5
6
Port WWW serverroot directory URLserver, loading file URLdirectory, loading file CGI application Virtual directory 7
8
9
10
WWW WWW server server Web application Web application Servlet Servlet container container Monitor Servlet Servlet gateway gateway Communication Java Java VM VM Web application Web application Servlet Servlet container container Monitor Container Container Processing Processing Process Process Java Java VM VM 11
12
13
14
15
16
17
18
19
20
(1) InfoProvider Pro /sample URI /home/sample /opt/fjsvjs2/conf/jsgwconf Mount Mount /sample /sample ID1 ID1 Mount Mount /sample /sample ID2 ID2 Container Container ID1 ID1 ajpv12://localhost:8009/ ajpv12://localhost:8009/ Container Container ID2 ID2 ajpv12://localhost:8010/ ajpv12://localhost:8010/ /opt/fjsvjs2/conf/jswatchconf sampleipaddress=localhost sampleipaddress=localhost sampleport=8009 sampleport=8009 samplecontainerconf=/etc/opt/fjsvjs2/jscontainer1xml samplecontainerconf=/etc/opt/fjsvjs2/jscontainer1xml sample2ipaddress=localhost sample2ipaddress=localhost sample2port=8010 sample2port=8010 sample2containerconf=/etc/opt/fjsvjs2/jscontainer2xml sample2containerconf=/etc/opt/fjsvjs2/jscontainer2xml /opt/fjsvjs2/conf/jscontainer1xml /opt/fjsvjs2/conf/jscontainer2xml 21
(2) Apache /sample URI /home/sample /opt/fjsvjs2/conf/jsgw_apapiconf ApJServMount ApJServMount /sample /sample balance://balance1/ balance://balance1/ ApJServBalance ApJServBalance balance1 balance1 sample1 sample1 ApJServBalance ApJServBalance balance1 balance1 sample2 sample2 ApJServHost ApJServHost sample1 sample1 ajpv12://localhost:8009/ ajpv12://localhost:8009/ ApJServHost ApJServHost sample2 sample2 ajpv12://localhost:8010/ ajpv12://localhost:8010/ /opt/fjsvjs2/conf/jswatchconf sampleipaddress=localhost sampleipaddress=localhost sampleport=8009 sampleport=8009 samplecontainerconf=/etc/opt/fjsvjs2/jscontainer1xml samplecontainerconf=/etc/opt/fjsvjs2/jscontainer1xml sample2ipaddress=localhost sample2ipaddress=localhost sample2port=8010 sample2port=8010 sample2containerconf=/etc/opt/fjsvjs2/jscontainer2xml sample2containerconf=/etc/opt/fjsvjs2/jscontainer2xml /opt/fjsvjs2/conf/jscontainer1xml /opt/fjsvjs2/conf/jscontainer2xml 22
4 4 EJB EJB Service 23
(1) EJB Application EJB Application 3 Apworks EJB Application [Apworks online Manual ] Deploy EJB Application Deploy [Apworks Online Manual ] Application Deploy EJB 3 Deploy 24
(2) Deployment ApplicationDeploy 3 1) Apworks Deploy Apworks Deploy [Apworks online Manual ] 2) ejbinstalleb / ejbuninstalleb Apworks Deployment Tool, C:InterstageJ2EEvardeploymentdeployed EJB ejbinstalleb Deploy DeployEJB ftp ) C:InterstageJ2EEvardeploymentdeployedejbHelloEJB /tmp ejbinstalleb Deploy # ejbinstalleb [ ] ) # ejbinstalleb /tmp/helloejb # ejbinstalleb -s [IJServer] [ ) # ejbinstalleb -s MyServer /tmp/helloejb ] IJServer Deploy # ejbuninstalleb [ EJB] ) # ejbuninstalleb HelloEJB DeployEJB 25
(3) EJB Application 1) Application Ex>> Ex>> DeployEJB # ejbinfoapfolder -l -l path path ::/opt/fjsvj2ee/var/deployment/deployed/ejbapp name name type type ssl ssl HelloEJB EB/stateless OFF OFF AccessMemberBmp EB/stateful OFF OFF MemberBmp EB/BMP-entity OFF OFF AccessMemberCmp EB/stateful OFF OFF MemberCmp EB/CMP-entity OFF OFF # ejbdstarteb HelloEJB -> -> EJB EJB Application # ejbdstopeb HelloEJB -> -> EJB EJB Application < > 1 ejbdstarteb/ejbdstopeb /var/adm/messages 2 EJB log /opt/fjsvejb/var/fjejbconsole 26
2) Work Unit EJB Application Work Unit Work Unit EJB, EJB -> EJB EJB / Work Unit Work Unit < WorkUnit > [WORK UNIT], [CONTROL OPTION], [APPLICATION PROGRAM] 3 EJB, [APPLICATION PROGRAM] [WORK UNIT] [CONTROL OPTION] [APPLICATION PROGRAM] EJB Application 27
WorkUnit [WORK [WORK UNIT] UNIT] #WorkUnit #WorkUnit Name:SAMPLEWU Name:SAMPLEWU #WorkUnit #WorkUnit kind:ejb kind:ejb [CONTROL [CONTROL OPTION] OPTION] #EJB #EJB / / Current Current Directory:c:temp Directory:c:temp # # (ABEND) (ABEND) Application Application Retry Retry Count: Count: # # PATH PATH Path Path Application:C:OracleOra81lib Application:C:OracleOra81lib # # Environment Environment Variable:ORACLE_HOME=C:OracleOra81 Variable:ORACLE_HOME=C:OracleOra81 Environment Environment Variable:ORACLE_SID=sv1 Variable:ORACLE_SID=sv1 [APPLICATION [APPLICATION PROGRAM] PROGRAM] #EJB #EJB Destination:SAMPLEEB Destination:SAMPLEEB # # (1255 (1255 ) ) Concurrency:2 Concurrency:2 # # Maximum Maximum Processing Processing Time: Time: # # Terminate Terminate Process Process Time Time out: out: #EJB #EJB Maximum Maximum Memory Memory EJB EJB Application: Application: # # CLASSPATH CLASSPATH Application:C:Oracleora81jdbclibclasses12zip Application:C:Oracleora81jdbclibclasses12zip CLASSPATH CLASSPATH Application:C:Oracleora81jdbclibnls_charset12zip Application:C:Oracleora81jdbclibnls_charset12zip CLASSPATH CLASSPATH Application:C:classesproviderutiljar Application:C:classesproviderutiljar CLASSPATH CLASSPATH Application:C:classesfscontextjar Application:C:classesfscontextjar #EJB #EJB JVM JVM Java Java Command Command Option: Option: # # Maximum Maximum Queuing Queuing Message: Message: 28
WorkUnit ( EJB ) [WORK [WORK UNIT] UNIT] Name:psib Name:psib Kind:EJB Kind:EJB [Control [Control Option] Option] Current Current Directory:/home/easy/log Directory:/home/easy/log Application Application Retry Retry Count:5 Count:5 Maximum Maximum Processing Processing Time Time Exit Exit Program:300 Program:300 Library Library Application:/home/oracle/app/oracle/product/oracle9/lib32 Application:/home/oracle/app/oracle/product/oracle9/lib32 [Application [Application Program] Program] Destination:COMMPSIBLogin Destination:COMMPSIBLogin Concurrency:1 Concurrency:1 Maximum Maximum Processing Processing Time:300 Time:300 #Maximum #Maximum Memory Memory EJB EJB Application:64 Application:64 Terminate Terminate Process Process Time Time out:yes out:yes CLASSPATH CLASSPATH Application:/home/easy/www/webapps/psib/WEB-INF/classes Application:/home/easy/www/webapps/psib/WEB-INF/classes CLASSPATH CLASSPATH Application:/home/easy/src/datasource/driver/classes12zip Application:/home/easy/src/datasource/driver/classes12zip CLASSPATH CLASSPATH Application:/home/easy/src/datasource/driver/nls_charset12zip Application:/home/easy/src/datasource/driver/nls_charset12zip CLASSPATH CLASSPATH Application:/home/easy/src/datasource/driver/fscontextjar Application:/home/easy/src/datasource/driver/fscontextjar CLASSPATH CLASSPATH Application:/home/easy/src/datasource/driver/providerutiljar Application:/home/easy/src/datasource/driver/providerutiljar Maximum Maximum Processing Processing Time Time Exit Exit Program:300 Program:300 Environment Environment Variable:ORACLE_HOME=/home/oracle/app/oracle/product/oracle9 Variable:ORACLE_HOME=/home/oracle/app/oracle/product/oracle9 Environment Environment Variable:ORACLE_SID=ISW Variable:ORACLE_SID=ISW Environment Environment Variable:NLS_LANG=American_AmericaKO16KSC5601 Variable:NLS_LANG=American_AmericaKO16KSC5601 [Application [Application Program] Program] Destination:COMMPSIBMenu Destination:COMMPSIBMenu Concurrency:1 Concurrency:1 Maximum Maximum Processing Processing Time:300 Time:300 #Maximum #Maximum Memory Memory EJB EJB Application:64 Application:64 Terminate Terminate Process Process Time Time out:yes out:yes CLASSPATH CLASSPATH Application:/home/easy/www/webapps/psib/WEB-INF/classes Application:/home/easy/www/webapps/psib/WEB-INF/classes CLASSPATH CLASSPATH Application:/home/easy/src/datasource/driver/classes12zip Application:/home/easy/src/datasource/driver/classes12zip CLASSPATH CLASSPATH Application:/home/easy/src/datasource/driver/nls_charset12zip Application:/home/easy/src/datasource/driver/nls_charset12zip EJB 1 EJB 2 29
< WorkUnit > HelloEJBwu [WORK UNIT] Name:HelloEJB Kind:EJB [Control Option] Current Directory:/tmp Application Retry Count:5 Maximum Processing Time Exit Program:300 [Application Program] Destination:HelloEJB Concurrency:1 Maximum Processing Time:300 Maximum Memory EJB Application:128 Terminate Process Time out:yes CLASSPATH Application:/chunma/jslee/lib/classes12zip Maximum Processing Time Exit Program:300 # isaddwudef < > ex) # isaddwudef HelloEJBwu Work Unit # isstartwu < > ex) # isstartwu HelloEJB Work Unit # islistwu Work Unit # isstopwu c < > Ex) # isstopwu c HelloEJB ( ) -c WorkUnit # isaddwudef -o < > ex) # isaddwudef -o HelloEJBwu # isdelwudef < > ex) # isdelwudef HelloEJB Work Unit ( Work Unit ) Work Unit Interstage Opreation Tool ( http://[ IP]:12000 ) 30
< WorkUnit standard log > EJB standard log Current Directory [Control Option] Current Directory:/tmp < : Work Unit > Work Unit # islistwu -a 31
(4) EJB Application DeployEJB ( J2EE User s Guide Chapter 50 ) 1) GUIejbcustx Xejbcustx # ejbcustx ejbcustx[file]-[open EJB Application Runtime Environment Definition] EJB Application open open 32
[Tool] [Rapid Invocation] EJB EJB JVM EJB EJB Session Bean 1 JavaVM-1 Session Bean 2 Session Bean 3 Entity Bean 1 Entity Bean 2 JavaVM-2 Session Bean 4 [Tool] [Rapid Invocation] Setting 33
[Invoking Bean][Invoked Bean] Data Source 34
2) EJB ejbcustx GUI EJB xml EJB export # ejbdefexport EJB{-s EJBContainer} -f xml -comment editable Ex) # ejbdefexport HelloEJB -s MyServer -f /tmp/aaaxml -comment editable I start export EJB container name:myserver export EB name: HelloEJB A file name: /tmp/aaaxml I finished export EJBIJServer -s EJB aaaxml (EJB XML J2EE User s Guide Chapter 50 ) EJB import # ejbdefimport [EJB] -f [ xml ] # ejbdefimport HelloEJB -f aaaxml import is started Definition file name:aaaxml EJB application name:helloejb 35
(5) Data Source Database Data Source PATHCLASSPATH PATH : /opt/fjsvj2ee/bin CLASSPATH (ORACLE File System Provider JNDI Library) : classes12zip, providerutiljar, fscontextjar 1) GUIj2eejndisetup Xj2eejndisetup # j2eejndisetup JDBC [File] [New Definition] Definition 36
DB Apply 37
5 5 IJServer 38
(1) IJServer IJServerEJB ContainerServlet Container ( IJServer ) = ( EJB Work Unit ) + ( Servlet Container ) IJServer - IJServer, ( jsgw_apapiconf, jswatchconf, jscontainerxml ) EJB Web Container(war ) Deploy ( Deploy ) EJB ContainerServlet Container ( IJServer ), IJServer EJB ContainerServlet Container, ) (JVM) 39
(2) J2EE Management Tool J2EE Management Tool IJServerJ2EE, Interstage Operation Tool http://server:12000 root J2EE Management Tool 40
(3) J2EE JDBC20 ORACLE 2 - JDBC20 : classes12zip ( ) -JNDI : fscontextjar, providerutiljar JDBC20 classes12zip File System Service Provider (JNDI) File System Service Provider (JNDI) fscontextjar providerutiljar Sun http://javasuncom/products/jndi/ Download JNDI 121 & More File System Service Provider, 12 JNDI File System Library ( fscontextjar, providerutiljar ) /opt/fjsvj2ee/lib Interstage ( Normal Termination ) [ Interstage Management ] [ Stop ] [ Normal Termination ] 41
J2EE Management Tool J2EE Property CLASSPATH LD_LIBRARY_PATH update Classpath : ORACLE CLASSPATH ) /home/jslee/j2ee/lib/classes12zip:/opt/fjsvj2ee/lib/fscontextjar:/opt/fjsv j2ee/lib/providerutiljar:/oracle/app/oracle/product/9i/jdbc/lib/nls_charset1 2zip LD_LIBRARY_PATH : ORACLE ( JDBCThin OCI, ORACLE ) ) /oracle/app/oracle/product/9i/lib32 42
(4) Data Source JDBC, Data Source ( : ORACLE ) New DB Create 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 43
(5) IJServer Interstage ( Normal Termination ) Normal Termination Component Transaction Service Stop 44
IJServer Create Maximum heap area size of the JavaVM : EJB Heap Class path : Classpath Other Option : Java Process Concurrency : web EJB Data Source : IJServer Data Source, Isolation level, Connection Count Isolation Leveldefault DBDefault Isolation Level 45
J2EE Management Tool IJServerList, IJServer -IJServer name - Set detailed inmation Create IJServer jswatchconf (IJServer Name)_001 Servlet Container fujitsu_001 Servlet Container 46
IJServer List, IJServer Definition Update IJServer, /opt/fjsvjs2/conf Web Container (IJServer_name)_001xml ContextMangerclientSession default - permanent : Client Timeout - default : Client <ContextManager workdir="/opt/fjsvjs2/work/fujitsu_001" clientsession="permanent" version="51"> <ContextManager workdir="/opt/fjsvjs2/work/fujitsu_001" clientsession= default" version="51"> 47
(6) Web Application EJB Deploy Deploy IJServer, Deploy/Undeploy 48
Deploy ( war, jar, ear ) Deploy * Reload : web application Reloadable true * Differential Deployment : Deploy * Start :, IJServer IJServer < 1 > EJB Install, Deploy ftp Deploy EJB Deploy Install # ejbinstalleb -s [IJServer] ) # ejbinstalleb -s fujitsu < 2 > IJServerWork Unit WorkUnit (IJServer)def /opt/fjsvejb/etc 49
< 3> Web Application war Deploy, Jservlet - /home/jslee/servlet - URI edu, Jservlet [Apache Servlet Gateway ] [IPP Servlet Gateway] ApJServMount /edu ajpv12://localhost:8010 Mount /edu EDU Container EDU ajpv12://localhost:8010 [Servlet Container ] <Context path="/edu" docbase= /home/jslee/servlet" reloadable="true" dirlist="false" /> 50
(7) IJServer IJServer Interstage [Start] [Detail] 51
IJServer, [Start] [ 1] IJServer Active, EJB Active, Web Active, Stopped 3 - Active : Web EJB - EJB Active : EJB - Web Active : Web - Stopped : IJServer Web EJB [ 2] EJB Containerstandard log /opt/fjsvejb/var/[ijserver]/[ijserver]/[process ID]/ EJB Application Systemoutprintln( ); stdout [ 3] EJB /opt/fjsvejb/var/fjejbconsole 52
EJB Container, # islistwu wuname kind status fujitsu EJB execute # isstopwu -c fujitsu UX:isstopwu: INFO: is30199:the command was processed normally Management Tool Web Active # isstartwu fujitsu UX:isstartwu: INFO: is30199:the command was processed normally # islistwu wuname kind status fujitsu EJB execute Management Tool Active 53
Web Container, Console Operation Tool - # jscontdisp PID STATUS Container Name ------ -------- -------------------------------- 18332 ACTIVE sample 18335 ACTIVE sample2 18338 ACTIVE wscontainer 18344 ACTIVE jslee_001 18347 ACTIVE myke_001 20688 ACTIVE fujitsu_001 # jscontstop fujitsu_001 UX:FJSVjs2: INFO: 2012: fujitsu_001 has been stopped # jscontstart fujitsu_001 UX:FJSVjs2: INFO: 2006: fujitsu_001 has been started Jservlet Web Web -Operation Tool ( Servlet Operation ),, Web Container 54
Appendix 55
(1) EJB Permance Monitoring ( Interstage Operator s Guide, Chapter 4 ) EJB Container EJBPermance Trace # isstart # ispmakeenv -i 1m -m 5 -d /home/jslee/log # isstopwu -c jslee Interstage ( ) Monitoring -i 1m : 1 -m 5 : 5MB -d : log Property ) [EJBCONT] jslee fujitsu [EJB-APPLICATION] EJBCT1 EJBCT2 Monitoring EJB Work Unit [EJBCONT] IJServer [EJB-APPLICATION] IJServer EJB # ispstart -f isp_property # ispstatus shm : 1 time : 1 minute(s) dir : /home/jslee/log status : active ejb-cont : jslee # isstartwu jslee # ispreport -k EJBAPL isp20030813log > aaacsv # ispstop Csv 56
csv, 57
< : csv > Data collection start date Data collection start time Data collection end date Data collection end time EJB application name Method name + signature Process ID Thread ID Maximum request processing time (ms) Minimum request processing time (ms) Average request processing time (ms) Maximum request processing Wait time (ms) Minimum request processing Wait time (ms) Average request processing Wait time (ms) Number of processes Number of requests Received Number of requests awaiting processing Number of EJB object (Session) Maximum Passivate number Entity Maximum size of memory area used in VM (KB) Average size of memory area used in VM (KB) 58
F A Q 59
Q A? 1 ) application2 container jsgwconf Mount /sample ID1 Mount /sample ID2 Container ID1 ajpv12://localhost:8009/ Container ID2 ajpv12://localhost:8010/ LogFile /opt/fjsvjs2/log/jsgwlog ErrorPage 404 /opt/fjsvjs2/gateway/404html ErrorPage 500 /opt/fjsvjs2/gateway/500html jswatchconf # container sampleport=8009 samplecontainerconf=/opt/fjsvjs2/conf/jscontainerxml # container sample2port=8010 sample2containerconf=/opt/fjsvjs2/conf/jscontainer2xml jscontainerxml #cp jscontainerxml jscontainer2xml #vi jscontainer2xml <Logger name="tc_log" path="log/sample2-containerlog" /> <Logger name="servlet_log" path="log/sample2-servletlog" /> <Parameter name="port" value="8010"/> 60
A 2 application container jsgwconf Mount /sample ID1 Mount /park ID2 Container ID1 ajpv12://localhos:8009/ Container ID2 ajpv12://localhost:8010/ LogFile /opt/fjsvjs2/log/jsgwlog ErrorPage 404 /opt/fjsvjs2/gateway/404html ErrorPage 500 /opt/fjsvjs2/gateway/500html jswatchconf # container sampleport=8009 samplecontainerconf=/opt/fjsvjs2/conf/jscontainerxml # container parkport=8010 parkcontainerconf=/opt/fjsvjs2/conf/jscontainer2xml jscontainerxml #cp jscontainerxml jscontainer2xml #vi jscontainer2xml <Logger name="tc_log" path="log/park-containerlog" /> <Logger name="servlet_log" path="log/park-servletlog" /> <Parameter name="port" value="8010"/> <Context path="/park" docbase="/home/park" /> 61
Q A 62