Uniface Responsive
Application Deployment
David Akerman ndash Solution Consultant
Agenda
Web Deployment Architecture
Considerations
Tomcat Servlet Engine Configuration
Uniface Server Configuration
Deployment Demonstration
Architecture
Web Application Resources
Static Content
bull CSS Images Fonts JavaScript etc
bull Served from Web Server or Java Servlet Engine (eg Tomcat)
Dynamic Page Content (Uniface)
bull Requests forwarded by Servlet Engine via Web Request Dispatcher (WRD) using middleware interface
bull URouter orchestrate Uniface uservers
bull UServer generate pages amp process updates
Uniface Web Application Environment
Server
Uniface ServerRuntime Engine
Client
Web Server
Java Servlet Engine
WRD
UserBrowser
http
Uniface Router
Network Connector
Network Connector NetworkConnector
DatabaseConnector
Uniface Runtime Objects
optional eg IIS or Apache
ajp Tomcat can function as web server
Universal Resource Locators (URLrsquos)
Identify appenvironment
httpserverprodwrdmainhttpserverapp1testmain
Map to urouter configuration via web servlet config
Context Servlet ComponentProtocol Serverport
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
httpservermachine8080
6
HTTP Requestuniface my_server_page
urouterasn
Context
UV8urouterserver-machine+13001 user-name [password] wasv
Network
WEB-INFwebxml
wrd
Context = Tomcat Virtual Directory
typically defined via named xml file in confCatalinalocalhostpointing to physical folder containing WEB-INFwebxml
Considerations
Preparation
Planbull Deployment Resources Hardening etc
Resourcesbull Product Availability Matrix on httpunifaceinfocom
bull Local Administrator privilege for installations
bull License
bull Optional Web Server Certificate for https connections
Installation Media for target architecturebull Uniface + patches (httpsdownloadunifacecom) DBMS drivers (match 32 or 64 bit)
bull Optional Java (for Tomcat) Tomcat IIS + ISAPI Extensions and filters for Tomcat ConnectorODBC drivers
Application Buildbull Configuration Files Uniface Runtime Resources Static Resources
License
Features Licensed per server core (not concurrent)bull Web Features USRVUSP USRVSVC
bull + Database features etc
Use Distributed License Manage (DLM) tobull Identify host for license request
bull Add License
bull Emergency License httpsdownloadunifacecomdownloads
Can specify license file in asnbull $LICENSE_OPTIONS=LM_LICENSE_FILE=CDLMlicensexml7188DLMserver LM_NOTIFICATION=0 LM_TRANSCRIPT=15
SecuritySSL (needs certificate)
Customize Error Messages ndash See Helpbull ldquoWeb Application Error Pagesrdquo
bull ldquoCustomize WRD Error Messages
Hardeningbull See help ldquoConfiguring the Tomcat Security Managerrdquo
bull Also check online references for Tomcat bull Remove manager application
bull Various serverxml webxml amp contextxml configuration changes
bull Service Account amp file permissions
Firewall
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Agenda
Web Deployment Architecture
Considerations
Tomcat Servlet Engine Configuration
Uniface Server Configuration
Deployment Demonstration
Architecture
Web Application Resources
Static Content
bull CSS Images Fonts JavaScript etc
bull Served from Web Server or Java Servlet Engine (eg Tomcat)
Dynamic Page Content (Uniface)
bull Requests forwarded by Servlet Engine via Web Request Dispatcher (WRD) using middleware interface
bull URouter orchestrate Uniface uservers
bull UServer generate pages amp process updates
Uniface Web Application Environment
Server
Uniface ServerRuntime Engine
Client
Web Server
Java Servlet Engine
WRD
UserBrowser
http
Uniface Router
Network Connector
Network Connector NetworkConnector
DatabaseConnector
Uniface Runtime Objects
optional eg IIS or Apache
ajp Tomcat can function as web server
Universal Resource Locators (URLrsquos)
Identify appenvironment
httpserverprodwrdmainhttpserverapp1testmain
Map to urouter configuration via web servlet config
Context Servlet ComponentProtocol Serverport
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
httpservermachine8080
6
HTTP Requestuniface my_server_page
urouterasn
Context
UV8urouterserver-machine+13001 user-name [password] wasv
Network
WEB-INFwebxml
wrd
Context = Tomcat Virtual Directory
typically defined via named xml file in confCatalinalocalhostpointing to physical folder containing WEB-INFwebxml
Considerations
Preparation
Planbull Deployment Resources Hardening etc
Resourcesbull Product Availability Matrix on httpunifaceinfocom
bull Local Administrator privilege for installations
bull License
bull Optional Web Server Certificate for https connections
Installation Media for target architecturebull Uniface + patches (httpsdownloadunifacecom) DBMS drivers (match 32 or 64 bit)
bull Optional Java (for Tomcat) Tomcat IIS + ISAPI Extensions and filters for Tomcat ConnectorODBC drivers
Application Buildbull Configuration Files Uniface Runtime Resources Static Resources
License
Features Licensed per server core (not concurrent)bull Web Features USRVUSP USRVSVC
bull + Database features etc
Use Distributed License Manage (DLM) tobull Identify host for license request
bull Add License
bull Emergency License httpsdownloadunifacecomdownloads
Can specify license file in asnbull $LICENSE_OPTIONS=LM_LICENSE_FILE=CDLMlicensexml7188DLMserver LM_NOTIFICATION=0 LM_TRANSCRIPT=15
SecuritySSL (needs certificate)
Customize Error Messages ndash See Helpbull ldquoWeb Application Error Pagesrdquo
bull ldquoCustomize WRD Error Messages
Hardeningbull See help ldquoConfiguring the Tomcat Security Managerrdquo
bull Also check online references for Tomcat bull Remove manager application
bull Various serverxml webxml amp contextxml configuration changes
bull Service Account amp file permissions
Firewall
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Architecture
Web Application Resources
Static Content
bull CSS Images Fonts JavaScript etc
bull Served from Web Server or Java Servlet Engine (eg Tomcat)
Dynamic Page Content (Uniface)
bull Requests forwarded by Servlet Engine via Web Request Dispatcher (WRD) using middleware interface
bull URouter orchestrate Uniface uservers
bull UServer generate pages amp process updates
Uniface Web Application Environment
Server
Uniface ServerRuntime Engine
Client
Web Server
Java Servlet Engine
WRD
UserBrowser
http
Uniface Router
Network Connector
Network Connector NetworkConnector
DatabaseConnector
Uniface Runtime Objects
optional eg IIS or Apache
ajp Tomcat can function as web server
Universal Resource Locators (URLrsquos)
Identify appenvironment
httpserverprodwrdmainhttpserverapp1testmain
Map to urouter configuration via web servlet config
Context Servlet ComponentProtocol Serverport
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
httpservermachine8080
6
HTTP Requestuniface my_server_page
urouterasn
Context
UV8urouterserver-machine+13001 user-name [password] wasv
Network
WEB-INFwebxml
wrd
Context = Tomcat Virtual Directory
typically defined via named xml file in confCatalinalocalhostpointing to physical folder containing WEB-INFwebxml
Considerations
Preparation
Planbull Deployment Resources Hardening etc
Resourcesbull Product Availability Matrix on httpunifaceinfocom
bull Local Administrator privilege for installations
bull License
bull Optional Web Server Certificate for https connections
Installation Media for target architecturebull Uniface + patches (httpsdownloadunifacecom) DBMS drivers (match 32 or 64 bit)
bull Optional Java (for Tomcat) Tomcat IIS + ISAPI Extensions and filters for Tomcat ConnectorODBC drivers
Application Buildbull Configuration Files Uniface Runtime Resources Static Resources
License
Features Licensed per server core (not concurrent)bull Web Features USRVUSP USRVSVC
bull + Database features etc
Use Distributed License Manage (DLM) tobull Identify host for license request
bull Add License
bull Emergency License httpsdownloadunifacecomdownloads
Can specify license file in asnbull $LICENSE_OPTIONS=LM_LICENSE_FILE=CDLMlicensexml7188DLMserver LM_NOTIFICATION=0 LM_TRANSCRIPT=15
SecuritySSL (needs certificate)
Customize Error Messages ndash See Helpbull ldquoWeb Application Error Pagesrdquo
bull ldquoCustomize WRD Error Messages
Hardeningbull See help ldquoConfiguring the Tomcat Security Managerrdquo
bull Also check online references for Tomcat bull Remove manager application
bull Various serverxml webxml amp contextxml configuration changes
bull Service Account amp file permissions
Firewall
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Web Application Resources
Static Content
bull CSS Images Fonts JavaScript etc
bull Served from Web Server or Java Servlet Engine (eg Tomcat)
Dynamic Page Content (Uniface)
bull Requests forwarded by Servlet Engine via Web Request Dispatcher (WRD) using middleware interface
bull URouter orchestrate Uniface uservers
bull UServer generate pages amp process updates
Uniface Web Application Environment
Server
Uniface ServerRuntime Engine
Client
Web Server
Java Servlet Engine
WRD
UserBrowser
http
Uniface Router
Network Connector
Network Connector NetworkConnector
DatabaseConnector
Uniface Runtime Objects
optional eg IIS or Apache
ajp Tomcat can function as web server
Universal Resource Locators (URLrsquos)
Identify appenvironment
httpserverprodwrdmainhttpserverapp1testmain
Map to urouter configuration via web servlet config
Context Servlet ComponentProtocol Serverport
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
httpservermachine8080
6
HTTP Requestuniface my_server_page
urouterasn
Context
UV8urouterserver-machine+13001 user-name [password] wasv
Network
WEB-INFwebxml
wrd
Context = Tomcat Virtual Directory
typically defined via named xml file in confCatalinalocalhostpointing to physical folder containing WEB-INFwebxml
Considerations
Preparation
Planbull Deployment Resources Hardening etc
Resourcesbull Product Availability Matrix on httpunifaceinfocom
bull Local Administrator privilege for installations
bull License
bull Optional Web Server Certificate for https connections
Installation Media for target architecturebull Uniface + patches (httpsdownloadunifacecom) DBMS drivers (match 32 or 64 bit)
bull Optional Java (for Tomcat) Tomcat IIS + ISAPI Extensions and filters for Tomcat ConnectorODBC drivers
Application Buildbull Configuration Files Uniface Runtime Resources Static Resources
License
Features Licensed per server core (not concurrent)bull Web Features USRVUSP USRVSVC
bull + Database features etc
Use Distributed License Manage (DLM) tobull Identify host for license request
bull Add License
bull Emergency License httpsdownloadunifacecomdownloads
Can specify license file in asnbull $LICENSE_OPTIONS=LM_LICENSE_FILE=CDLMlicensexml7188DLMserver LM_NOTIFICATION=0 LM_TRANSCRIPT=15
SecuritySSL (needs certificate)
Customize Error Messages ndash See Helpbull ldquoWeb Application Error Pagesrdquo
bull ldquoCustomize WRD Error Messages
Hardeningbull See help ldquoConfiguring the Tomcat Security Managerrdquo
bull Also check online references for Tomcat bull Remove manager application
bull Various serverxml webxml amp contextxml configuration changes
bull Service Account amp file permissions
Firewall
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Uniface Web Application Environment
Server
Uniface ServerRuntime Engine
Client
Web Server
Java Servlet Engine
WRD
UserBrowser
http
Uniface Router
Network Connector
Network Connector NetworkConnector
DatabaseConnector
Uniface Runtime Objects
optional eg IIS or Apache
ajp Tomcat can function as web server
Universal Resource Locators (URLrsquos)
Identify appenvironment
httpserverprodwrdmainhttpserverapp1testmain
Map to urouter configuration via web servlet config
Context Servlet ComponentProtocol Serverport
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
httpservermachine8080
6
HTTP Requestuniface my_server_page
urouterasn
Context
UV8urouterserver-machine+13001 user-name [password] wasv
Network
WEB-INFwebxml
wrd
Context = Tomcat Virtual Directory
typically defined via named xml file in confCatalinalocalhostpointing to physical folder containing WEB-INFwebxml
Considerations
Preparation
Planbull Deployment Resources Hardening etc
Resourcesbull Product Availability Matrix on httpunifaceinfocom
bull Local Administrator privilege for installations
bull License
bull Optional Web Server Certificate for https connections
Installation Media for target architecturebull Uniface + patches (httpsdownloadunifacecom) DBMS drivers (match 32 or 64 bit)
bull Optional Java (for Tomcat) Tomcat IIS + ISAPI Extensions and filters for Tomcat ConnectorODBC drivers
Application Buildbull Configuration Files Uniface Runtime Resources Static Resources
License
Features Licensed per server core (not concurrent)bull Web Features USRVUSP USRVSVC
bull + Database features etc
Use Distributed License Manage (DLM) tobull Identify host for license request
bull Add License
bull Emergency License httpsdownloadunifacecomdownloads
Can specify license file in asnbull $LICENSE_OPTIONS=LM_LICENSE_FILE=CDLMlicensexml7188DLMserver LM_NOTIFICATION=0 LM_TRANSCRIPT=15
SecuritySSL (needs certificate)
Customize Error Messages ndash See Helpbull ldquoWeb Application Error Pagesrdquo
bull ldquoCustomize WRD Error Messages
Hardeningbull See help ldquoConfiguring the Tomcat Security Managerrdquo
bull Also check online references for Tomcat bull Remove manager application
bull Various serverxml webxml amp contextxml configuration changes
bull Service Account amp file permissions
Firewall
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Universal Resource Locators (URLrsquos)
Identify appenvironment
httpserverprodwrdmainhttpserverapp1testmain
Map to urouter configuration via web servlet config
Context Servlet ComponentProtocol Serverport
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
httpservermachine8080
6
HTTP Requestuniface my_server_page
urouterasn
Context
UV8urouterserver-machine+13001 user-name [password] wasv
Network
WEB-INFwebxml
wrd
Context = Tomcat Virtual Directory
typically defined via named xml file in confCatalinalocalhostpointing to physical folder containing WEB-INFwebxml
Considerations
Preparation
Planbull Deployment Resources Hardening etc
Resourcesbull Product Availability Matrix on httpunifaceinfocom
bull Local Administrator privilege for installations
bull License
bull Optional Web Server Certificate for https connections
Installation Media for target architecturebull Uniface + patches (httpsdownloadunifacecom) DBMS drivers (match 32 or 64 bit)
bull Optional Java (for Tomcat) Tomcat IIS + ISAPI Extensions and filters for Tomcat ConnectorODBC drivers
Application Buildbull Configuration Files Uniface Runtime Resources Static Resources
License
Features Licensed per server core (not concurrent)bull Web Features USRVUSP USRVSVC
bull + Database features etc
Use Distributed License Manage (DLM) tobull Identify host for license request
bull Add License
bull Emergency License httpsdownloadunifacecomdownloads
Can specify license file in asnbull $LICENSE_OPTIONS=LM_LICENSE_FILE=CDLMlicensexml7188DLMserver LM_NOTIFICATION=0 LM_TRANSCRIPT=15
SecuritySSL (needs certificate)
Customize Error Messages ndash See Helpbull ldquoWeb Application Error Pagesrdquo
bull ldquoCustomize WRD Error Messages
Hardeningbull See help ldquoConfiguring the Tomcat Security Managerrdquo
bull Also check online references for Tomcat bull Remove manager application
bull Various serverxml webxml amp contextxml configuration changes
bull Service Account amp file permissions
Firewall
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
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
httpservermachine8080
6
HTTP Requestuniface my_server_page
urouterasn
Context
UV8urouterserver-machine+13001 user-name [password] wasv
Network
WEB-INFwebxml
wrd
Context = Tomcat Virtual Directory
typically defined via named xml file in confCatalinalocalhostpointing to physical folder containing WEB-INFwebxml
Considerations
Preparation
Planbull Deployment Resources Hardening etc
Resourcesbull Product Availability Matrix on httpunifaceinfocom
bull Local Administrator privilege for installations
bull License
bull Optional Web Server Certificate for https connections
Installation Media for target architecturebull Uniface + patches (httpsdownloadunifacecom) DBMS drivers (match 32 or 64 bit)
bull Optional Java (for Tomcat) Tomcat IIS + ISAPI Extensions and filters for Tomcat ConnectorODBC drivers
Application Buildbull Configuration Files Uniface Runtime Resources Static Resources
License
Features Licensed per server core (not concurrent)bull Web Features USRVUSP USRVSVC
bull + Database features etc
Use Distributed License Manage (DLM) tobull Identify host for license request
bull Add License
bull Emergency License httpsdownloadunifacecomdownloads
Can specify license file in asnbull $LICENSE_OPTIONS=LM_LICENSE_FILE=CDLMlicensexml7188DLMserver LM_NOTIFICATION=0 LM_TRANSCRIPT=15
SecuritySSL (needs certificate)
Customize Error Messages ndash See Helpbull ldquoWeb Application Error Pagesrdquo
bull ldquoCustomize WRD Error Messages
Hardeningbull See help ldquoConfiguring the Tomcat Security Managerrdquo
bull Also check online references for Tomcat bull Remove manager application
bull Various serverxml webxml amp contextxml configuration changes
bull Service Account amp file permissions
Firewall
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Considerations
Preparation
Planbull Deployment Resources Hardening etc
Resourcesbull Product Availability Matrix on httpunifaceinfocom
bull Local Administrator privilege for installations
bull License
bull Optional Web Server Certificate for https connections
Installation Media for target architecturebull Uniface + patches (httpsdownloadunifacecom) DBMS drivers (match 32 or 64 bit)
bull Optional Java (for Tomcat) Tomcat IIS + ISAPI Extensions and filters for Tomcat ConnectorODBC drivers
Application Buildbull Configuration Files Uniface Runtime Resources Static Resources
License
Features Licensed per server core (not concurrent)bull Web Features USRVUSP USRVSVC
bull + Database features etc
Use Distributed License Manage (DLM) tobull Identify host for license request
bull Add License
bull Emergency License httpsdownloadunifacecomdownloads
Can specify license file in asnbull $LICENSE_OPTIONS=LM_LICENSE_FILE=CDLMlicensexml7188DLMserver LM_NOTIFICATION=0 LM_TRANSCRIPT=15
SecuritySSL (needs certificate)
Customize Error Messages ndash See Helpbull ldquoWeb Application Error Pagesrdquo
bull ldquoCustomize WRD Error Messages
Hardeningbull See help ldquoConfiguring the Tomcat Security Managerrdquo
bull Also check online references for Tomcat bull Remove manager application
bull Various serverxml webxml amp contextxml configuration changes
bull Service Account amp file permissions
Firewall
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Preparation
Planbull Deployment Resources Hardening etc
Resourcesbull Product Availability Matrix on httpunifaceinfocom
bull Local Administrator privilege for installations
bull License
bull Optional Web Server Certificate for https connections
Installation Media for target architecturebull Uniface + patches (httpsdownloadunifacecom) DBMS drivers (match 32 or 64 bit)
bull Optional Java (for Tomcat) Tomcat IIS + ISAPI Extensions and filters for Tomcat ConnectorODBC drivers
Application Buildbull Configuration Files Uniface Runtime Resources Static Resources
License
Features Licensed per server core (not concurrent)bull Web Features USRVUSP USRVSVC
bull + Database features etc
Use Distributed License Manage (DLM) tobull Identify host for license request
bull Add License
bull Emergency License httpsdownloadunifacecomdownloads
Can specify license file in asnbull $LICENSE_OPTIONS=LM_LICENSE_FILE=CDLMlicensexml7188DLMserver LM_NOTIFICATION=0 LM_TRANSCRIPT=15
SecuritySSL (needs certificate)
Customize Error Messages ndash See Helpbull ldquoWeb Application Error Pagesrdquo
bull ldquoCustomize WRD Error Messages
Hardeningbull See help ldquoConfiguring the Tomcat Security Managerrdquo
bull Also check online references for Tomcat bull Remove manager application
bull Various serverxml webxml amp contextxml configuration changes
bull Service Account amp file permissions
Firewall
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
License
Features Licensed per server core (not concurrent)bull Web Features USRVUSP USRVSVC
bull + Database features etc
Use Distributed License Manage (DLM) tobull Identify host for license request
bull Add License
bull Emergency License httpsdownloadunifacecomdownloads
Can specify license file in asnbull $LICENSE_OPTIONS=LM_LICENSE_FILE=CDLMlicensexml7188DLMserver LM_NOTIFICATION=0 LM_TRANSCRIPT=15
SecuritySSL (needs certificate)
Customize Error Messages ndash See Helpbull ldquoWeb Application Error Pagesrdquo
bull ldquoCustomize WRD Error Messages
Hardeningbull See help ldquoConfiguring the Tomcat Security Managerrdquo
bull Also check online references for Tomcat bull Remove manager application
bull Various serverxml webxml amp contextxml configuration changes
bull Service Account amp file permissions
Firewall
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
SecuritySSL (needs certificate)
Customize Error Messages ndash See Helpbull ldquoWeb Application Error Pagesrdquo
bull ldquoCustomize WRD Error Messages
Hardeningbull See help ldquoConfiguring the Tomcat Security Managerrdquo
bull Also check online references for Tomcat bull Remove manager application
bull Various serverxml webxml amp contextxml configuration changes
bull Service Account amp file permissions
Firewall
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Performancebull Which Web Browser
bull Optimize file transferbull Minify CSS amp Javascript files
bull File Compression
bull Cache headers Server Locations CDNrsquos etc
bull Scalability (load balancing needed)
bull Tuning
bull Applicationbull Code Performance Logging App Cache
bull Unifacebull $memory zip=all
bull DBMS Connector
bull Web ServerServlet Engine
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Redirection from another Web Server
Serve static content from eg IIS or Apache
Redirect dynamic content eg wrd to Servlet Engine
(eg Tomcat) using AJP binary protocol
Web Server Redirectionbull IIS Typically Apache JK Redirector or BonCode Tomcat Redirector
for AJP connections or ARR if you want to modify headers
bull Apache modules (mod_jk or mod_proxy_ajp)
bull Some connectors (eg Apache JK redirector) can load balance
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Tomcat
Servlet Engine
Configuration
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Uniface Web Request Dispatcher
Browser Web Server App Server
Client
https WASV
Tomcat
userver
urouter
WRD(libwrdjar)
DSP
ajp
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Configuration Tomcat (Context)
httpserverportwebstart
Tomcat virtual directory definition
tomcatconfCatalinalocalhostwebstartxml
Points to project web folder
ltContext docBase=DProjectswebstartwebgt
ltValve className=orgapachecatalinavalvesAccessLogValve
prefix=tabs- suffix=log pattern=commongt
ltContextgt
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Configuration Tomcat (wrd)
Physical folder contains WEB-INFwebxml DProjectsWebStartwebWEB-INFwebxml
webxml defines servlet mapping eg
httpserverportwebstartwrd
Servlet defines connections to Uniface UROUTER
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Tomcat webxml servlet configuration
lt-- Uniface W(eb) R(equest) D(ispatcher) Servlet --gt
ltservletgt
ltservlet-namegt
wrd
ltservlet-namegt
ltservlet-classgt
comcompuwareunifaceurdWRDServlet
ltservlet-classgt
ltinit-paramgt
ltparam-namegtMIDDLEWAREltparam-namegt
ltparam-valuegtUV8localhost+13001|userver||webstartltparam-valuegt
ltinit-paramgt
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Tomcat webxml servlet mapping
ltservlet-mappinggt
ltservlet-namegtwrdltservlet-namegt
lturl-patterngtwrdlturl-patterngt
ltservlet-mappinggt
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Uniface Common resources
eg unifacewebappsunifacecommonunifacejs
Web folder common
Copy or override in wasvasn
[SETTINGS]
$UNIFACE_RUNTIME_BASE_URL=unifacecommon
or create Tomcat Context (virtual dir)
CommontomcatconfCatalinalocalhost
webstartcommonxml
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Uniface
urouteruserver
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Urouterasn - Settings[SETTINGS]
$putmess_logfile = DProjectsUniface102Defaultlogurouterplog
$priv_mon_user = urouter
$default_net = TCPlocalhost+13001|||
Explicit Hostname may be needed to bind to correct IP address (eg NAT used in Virtual Machine)
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Urouterasn ndash Default Servers
[SERVERS]
default = CProgram FilesUniface102commonbinuserverexe
adm=CProgram FilesUniface102unifaceadm maxidle=3m
For Uniface WebApplication Server
wasv = CProgram FilesUniface102commonbinuserverexe
dir=DProjectsUniface10Defaultproject adm=CProgram
FilesUniface102unifaceadm asn=wasvasn
For debug purposes
debug = CProgram FilesUniface102commonbinuserverexe
max=1 dir=DProjectsUniface10Defaultproject
adm=CProgram FilesUniface102unifaceadm
deb=localhost+13002wait asn=wasvasn
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Urouterasn ndash server switch notes
maxbull Description maximum number of instances of a shared Uniface Server that the Uniface Router
can start
bull Advice Size to avoid resource problems (memory page swapping etc)
maxidlebull Description maximum idle period for a shared Uniface Server before close
bull Advice Typically use to reduce server resource usage if max not set or big spikes expected
maxreqbull Description maximum number of requests a shared Uniface server can execute
bull Advice Typically use if you have a memory leak or are short of memory
Other considerationsbull Consider debugger port re-use
bull See Help for other switches
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
wasvasn (selected settings)
[SETTINGS]
$TEST_MODE_COMPONENTS Donrsquot force reload
$RESOURCES_OUTPUT webstartuar Not needed for deployment
[WEB]
$SERVER_SECRET=xxxxxxxxxxxxxxxxxxxxxxx used to hash protect NED fields
$UNIFACE_RUNTIME_BASE_URL=common default
$JS_BASE_URL=commondspjs default
[RESOURCES]
Specifies folders or UAR files
Can patch with additional resources (newest first)
webstartuar
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Troubleshooting
Browser Debugger Network Tab ndash do resources load
Tomcatbull Can you load static resources
bull Check middleware connection in WEB-INFwebxml (ports credentials UST)
UrouterUserverbull Matching UST in urouterasn
bull Hostname in urouterasn $DEFAULT_NET
bull Log files
bull Paths amp File Permissions for userver user
bull Monitor
License
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Demo
Application
Deployment
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Suggested Further Investigation
Standardized Deployment (resources amp urm)bull See previous deployment lectures
urouter monitorbull Gracefully reload application eg after patch deployment
Tomcatbull Manager application
bull WAR file deployment- see ldquoCreating and Deploying a Web Application WAR Filerdquo help topic
bull Configuration inc Security and Performance optimization
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
ResourcesUniface Help Tutorials
unifaceinfo - Samples forums blogs amp more
httpgounifacecomLectures-page- Historical Lectures
youtubecomuniface- Tutorials demos amp webinar recording
wwwslidesharenetUniface
githubcomuniface- Frameworks amp tools
Uniface Training amp Consultancy
Thank You
amp Questions
Thank You
amp Questions