uniface lectures webinar - building responsive applications with uniface: deployment

31

Upload: uniface

Post on 23-Jan-2018

286 views

Category:

Software


7 download

TRANSCRIPT

Page 1: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 2: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 3: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 4: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 5: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 6: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 7: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 8: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 9: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 10: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 11: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 12: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 13: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 14: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 15: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 16: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 17: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 18: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 19: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 20: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 21: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 22: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 23: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 24: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 25: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 26: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 27: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 28: Uniface Lectures Webinar - Building Responsive Applications with Uniface: 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

Page 29: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

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

Page 30: Uniface Lectures Webinar - Building Responsive Applications with Uniface: Deployment

Thank You

amp Questions