Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment
Download as PPTX, PDF0 likes607 views
The document outlines the deployment architecture and configuration considerations for Uniface web applications using Tomcat as the servlet engine. It details the deployment process, including server configuration, resource management, licensing, and security measures, as well as performance optimization techniques. Additionally, it provides guidance on troubleshooting and resources for further investigation into Uniface deployment practices.
![Uniface Web Application Configuration
Uniface Web Application Server
1. Web Browser
2. Tomcat
3. WRD
Network
4. Uniface Router
5. Uniface Server
Call my_server_page to get an HTTP Response
http.//server.machine.8080/
6
HTTP Request
uniface/ /my_server_page
urouter.asn
Context*
UV8.urouter.server-machine+13001 user-name [password] wasv
Network
WEB-INFweb.xml
wrd/
*Context = Tomcat Virtual Directory
typically defined via named xml file in confCatalinalocalhost
pointing to physical folder containing WEB-INFweb.xml](https://image.slidesharecdn.com/unifaceresponsiveappsdeployment-170420140937/85/Uniface-Lectures-Webinar-Building-Responsive-Applications-with-Uniface-Deployment-8-320.jpg)
![Uniface Common resources
e.g. unifacewebappsunifacecommonuniface.js
Web folder: ../common
Copy or override in wasv.asn:
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=/uniface/common
or create Tomcat Context (virtual dir):
CommontomcatconfCatalinalocalhost
webstart#common.xml](https://image.slidesharecdn.com/unifaceresponsiveappsdeployment-170420140937/85/Uniface-Lectures-Webinar-Building-Responsive-Applications-with-Uniface-Deployment-21-320.jpg)
![Urouter.asn - Settings
[SETTINGS]
$putmess_logfile = D:ProjectsUniface10.2Defaultlogurouter%p.log
$priv_mon_user = urouter
$default_net = TCP:localhost+13001|||
Explicit Hostname may be needed to bind to correct IP
address (e.g. NAT used in Virtual Machine)](https://image.slidesharecdn.com/unifaceresponsiveappsdeployment-170420140937/85/Uniface-Lectures-Webinar-Building-Responsive-Applications-with-Uniface-Deployment-23-320.jpg)
![Urouter.asn – Default Servers
[SERVERS]
default = "C:Program FilesUniface10.2commonbinuserver.exe"
/adm="C:Program FilesUniface10.2unifaceadm" /maxidle=3m
; For Uniface WebApplication Server
wasv = "C:Program FilesUniface10.2commonbinuserver.exe"
/dir="D:ProjectsUniface10Defaultproject" /adm="C:Program
FilesUniface10.2unifaceadm" /asn=wasv.asn
; For debug purposes
debug = "C:Program FilesUniface10.2commonbinuserver.exe"
/max=1 /dir="D:ProjectsUniface10Defaultproject"
/adm="C:Program FilesUniface10.2unifaceadm"
/deb=localhost+13002:wait /asn=wasv.asn](https://image.slidesharecdn.com/unifaceresponsiveappsdeployment-170420140937/85/Uniface-Lectures-Webinar-Building-Responsive-Applications-with-Uniface-Deployment-24-320.jpg)
![wasv.asn (selected settings)
[SETTINGS]
;$TEST_MODE_COMPONENTS ; Don’t force reload
;$RESOURCES_OUTPUT webstart.uar ; Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx ; used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=../common ; default
$JS_BASE_URL=../common/dspjs ; default
[RESOURCES]
; Specifies folders or UAR files
; Can patch with additional resources (newest first)
webstart.uar](https://image.slidesharecdn.com/unifaceresponsiveappsdeployment-170420140937/85/Uniface-Lectures-Webinar-Building-Responsive-Applications-with-Uniface-Deployment-26-320.jpg)
Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment
- 2. Uniface Responsive Application Deployment David Akerman – Solution Consultant
- 3. Agenda Web Deployment Architecture Considerations Tomcat Servlet Engine Configuration Uniface Server Configuration Deployment Demonstration
- 4. Architecture
- 5. Web Application Resources Static Content • CSS, Images, Fonts, JavaScript etc. • Served from Web Server or Java Servlet Engine (e.g. Tomcat) Dynamic Page Content (Uniface) • Requests forwarded by Servlet Engine via Web Request Dispatcher (WRD) using middleware interface • URouter: orchestrate Uniface uservers • UServer: generate pages & process updates
- 6. Uniface Web Application Environment Server Uniface Server Runtime Engine Client * Web Server * Java Servlet Engine WRD UserBrowser http Uniface Router Network Connector Network Connector Network Connector Database Connector Uniface Runtime Objects * optional, e.g. IIS or Apache ajp * Tomcat can function as web server
- 7. Universal Resource Locators (URL’s) Identify app/environment http://server/prod/wrd/main http://server/app1/test/main Map to urouter configuration via web servlet config Context Servlet ComponentProtocol Server:port
- 8. Uniface Web Application Configuration Uniface Web Application Server 1. Web Browser 2. Tomcat 3. WRD Network 4. Uniface Router 5. Uniface Server Call my_server_page to get an HTTP Response http.//server.machine.8080/ 6 HTTP Request uniface/ /my_server_page urouter.asn Context* UV8.urouter.server-machine+13001 user-name [password] wasv Network WEB-INFweb.xml wrd/ *Context = Tomcat Virtual Directory typically defined via named xml file in confCatalinalocalhost pointing to physical folder containing WEB-INFweb.xml
- 10. Preparation Plan • Deployment, Resources, Hardening etc. Resources • Product Availability Matrix on http://unifaceinfo.com • Local Administrator privilege for installations • License • Optional: Web Server Certificate for https:// connections Installation Media for target architecture • Uniface + patches (https://download.uniface.com), DBMS drivers (match 32 or 64 bit) • Optional: Java (for Tomcat), Tomcat, IIS + ISAPI Extensions and filters for Tomcat Connector, ODBC drivers Application Build • Configuration Files, Uniface Runtime Resources, Static Resources
- 11. License Features Licensed per server core (not concurrent) • Web Features: USRVUSP, USRVSVC • + Database features etc. Use Distributed License Manage (DLM) to: • Identify host for license request • Add License • Emergency License: https://download.uniface.com/downloads Can specify license file in .asn • $LICENSE_OPTIONS=LM_LICENSE_FILE="C:DLMlicense.xml" ;7188@DLMserver, LM_NOTIFICATION=0, LM_TRANSCRIPT=15
- 12. Security SSL (needs certificate) Customize Error Messages – See Help: • “Web Application Error Pages” • “Customize WRD Error Messages Hardening • See help “Configuring the Tomcat Security Manager” • Also check online references for Tomcat • Remove manager application • Various server.xml, web.xml & context.xml configuration changes • Service Account & file permissions Firewall
- 13. Performance • Which Web Browser? • Optimize file transfer • Minify CSS & Javascript files • File Compression • Cache headers, Server Locations, CDN’s etc • Scalability (load balancing needed?) • Tuning: • Application • Code Performance, Logging, App Cache • Uniface • $memory zip=all • DBMS Connector • Web Server/Servlet Engine
- 14. Redirection from another Web Server Serve static content from, e.g., IIS or Apache Redirect dynamic content, e.g. /wrd/* to Servlet Engine (e.g. Tomcat) using AJP binary protocol Web Server Redirection • IIS: Typically, Apache JK Redirector or BonCode Tomcat Redirector for AJP connections, or ARR if you want to modify headers • Apache: modules (mod_jk or mod_proxy_ajp) • Some connectors (e.g. Apache JK redirector) can load balance
- 16. Uniface Web Request Dispatcher Browser Web Server App Server Client https:// WASV Tomcat userver urouter WRD (lib/wrd.jar) DSP ajp
- 17. Configuration: Tomcat (Context) http://server:port/webstart Tomcat virtual directory definition: tomcatconfCatalinalocalhostwebstart.xml Points to project web folder: <Context docBase="D:Projectswebstartweb"> <Valve className="org.apache.catalina.valves.AccessLogValve" prefix="tabs-" suffix=".log" pattern="common"/> </Context>
- 18. Configuration: Tomcat (wrd) Physical folder contains WEB-INFweb.xml D:ProjectsWebStartwebWEB-INFweb.xml web.xml defines servlet mapping, e.g. http://server:port/webstart/wrd/ Servlet defines connections to Uniface UROUTER
- 19. Tomcat web.xml servlet configuration <!-- Uniface W(eb) R(equest) D(ispatcher) Servlet --> <servlet> <servlet-name> wrd </servlet-name> <servlet-class> com.compuware.uniface.urd.WRDServlet </servlet-class> <init-param> <param-name>MIDDLEWARE</param-name> <param-value>UV8:localhost+13001|userver|*|webstart</param-value> </init-param>
- 20. Tomcat web.xml servlet mapping <servlet-mapping> <servlet-name>wrd</servlet-name> <url-pattern>/wrd/*</url-pattern> </servlet-mapping>
- 21. Uniface Common resources e.g. unifacewebappsunifacecommonuniface.js Web folder: ../common Copy or override in wasv.asn: [SETTINGS] $UNIFACE_RUNTIME_BASE_URL=/uniface/common or create Tomcat Context (virtual dir): CommontomcatconfCatalinalocalhost webstart#common.xml
- 23. Urouter.asn - Settings [SETTINGS] $putmess_logfile = D:ProjectsUniface10.2Defaultlogurouter%p.log $priv_mon_user = urouter $default_net = TCP:localhost+13001||| Explicit Hostname may be needed to bind to correct IP address (e.g. NAT used in Virtual Machine)
- 24. Urouter.asn – Default Servers [SERVERS] default = "C:Program FilesUniface10.2commonbinuserver.exe" /adm="C:Program FilesUniface10.2unifaceadm" /maxidle=3m ; For Uniface WebApplication Server wasv = "C:Program FilesUniface10.2commonbinuserver.exe" /dir="D:ProjectsUniface10Defaultproject" /adm="C:Program FilesUniface10.2unifaceadm" /asn=wasv.asn ; For debug purposes debug = "C:Program FilesUniface10.2commonbinuserver.exe" /max=1 /dir="D:ProjectsUniface10Defaultproject" /adm="C:Program FilesUniface10.2unifaceadm" /deb=localhost+13002:wait /asn=wasv.asn
- 25. Urouter.asn – server switch notes /max • Description: maximum number of instances of a shared Uniface Server that the Uniface Router can start • Advice: Size to avoid resource problems (memory page swapping etc.) /maxidle • Description: maximum idle period for a shared Uniface Server before close • Advice: Typically use to reduce server resource usage if /max not set or big spikes expected /maxreq • Description: maximum number of requests a shared Uniface server can execute • Advice: Typically use if you have a memory leak or are short of memory Other considerations • Consider debugger port re-use • See Help for other switches
- 26. wasv.asn (selected settings) [SETTINGS] ;$TEST_MODE_COMPONENTS ; Don’t force reload ;$RESOURCES_OUTPUT webstart.uar ; Not needed for deployment [WEB] $SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx ; used to hash protect NED fields $UNIFACE_RUNTIME_BASE_URL=../common ; default $JS_BASE_URL=../common/dspjs ; default [RESOURCES] ; Specifies folders or UAR files ; Can patch with additional resources (newest first) webstart.uar
- 27. Troubleshooting Browser Debugger Network Tab – do resources load? Tomcat • Can you load static resources? • Check middleware connection in WEB-INFweb.xml (ports, credentials, UST) Urouter/Userver • Matching UST in urouter.asn • Hostname in urouter.asn $DEFAULT_NET • Log files • Paths & File Permissions for userver user • Monitor License
- 29. Suggested Further Investigation Standardized Deployment (resources & urm) • See previous deployment lectures urouter monitor • Gracefully reload application, e.g. after patch deployment Tomcat • Manager application • WAR file deployment - see “Creating and Deploying a Web Application WAR File” help topic • Configuration, inc. Security and Performance optimization
- 30. Resources Uniface Help: Tutorials uniface.info - Samples, forums, blogs & more http://go.uniface.com/Lectures-page - Historical Lectures youtube.com/uniface - Tutorials, demos & webinar recording www.slideshare.net/Uniface github.com/uniface - Frameworks & tools Uniface Training & Consultancy