You must enable javascript in order to view this page or you can go
here
to view the webhelp.
Genero Application Server User Guide 3.21
Content
Search Results
Index
Loading, please wait ...
Genero Application Server User Guide
What's New in 3.21
General
What is the Genero Application Server?
Standalone Genero Application Server
Front-ends
Quick Start
Explore the configuration file
Quick start guide for applications with UI
Launch an application
Configure an application
Run an application
Deploy an application
Quick start guide for Web services applications
What is Web Service?
Explore Genero demo Web services (server side)
Configure a web service
Run a client app on Web service using GBC
Deploy a web service
Genero demo applications
The demo applications
Access demo applications
Basics
Architecture
Architecture overview
Reliability inherent in the architecture
Standalone GAS
Setting up production environment
Services Pool (GWS Only)
Components
Dispatcher
Proxy
DVM
Directories: installation and appdata
Application environment
Application Web Address
URI Examples
File serving URIs
What is auto logout?
Web application timeouts
Re-login prompt
What is delegation?
What is Single sign-on (SSO)?
Internationalization and localization
Best practices
Encoding architecture
Genero Browser Client charset
GAS configuration encoding files
System encoding
Charsets configuration
DVM locale settings in .xcf files
Configuration
Security recommendations for production environment
Managing user access rights
Validating the installation with GBC
Validate with GBC (standalone GAS )
Validate with GBC with a Web server
Validating the Installation with the GDC
Validate with GDC (standalone GAS )
Troubleshooting GAS configuration issues
Proxy errors on Windows® platform
Cannot find 127.0.0.1 or localhost on Windows
What if the application doesn't start?
Error taking session ownership
Licensing examples
Base example
Using the RUN command
Multiple user agents
Summary case
Front-ends and license counting
Tips and tricks / Troubleshooting
Configuring the ADDRESS element
Setting the USER_AGENT timeout
Setting MAX_AVAILABLE for a Web Service
Migrating from GDC
Web Server configuration
ISAPI Extension Installation
Internet Information Services (IIS)
Installing the ISAPI dispatcher
Manual configuration for IIS 8.x and IIS 10.x
Manual configuration for IIS 7.x
Manual configuration for IIS 6.0
Finishing the installation
Configure for HTTP/2
Configure IIS to pass through HTTP errors
Application root directory
ISAPI Extension configuration file
Troubleshooting installation
Restarting the ISAPI dispatcher
FastCGI Installation
Using the FastCGI dispatcher
Configuration on various Apache web server
Configure Apache prior to 2.4
Configure Apache 2.4
Configure Apache for HTTP/2
Configure FastCGI for nginx
Configure FastCGI for Lighttpd
Configure FastCGI for Sun Java System Web Server 7.0
Configure FastCGI for Windows
Troubleshooting FastCGI
Application timeout on Apache
Application fails with fastcgi
Invalid installation directory
Application URL not decoding
File download fails due to spaces in filename
Applications all down at the same time
Applications fail using multiple dispatchers
Restart fastcgidispatch without losing sessions
Validating configuration files
What is an XML Schema Definition file?
Specifying the XSD file
Validating with the gasadmin tool
Selecting an XML editor
Configure deployment directories
Configuring applications
Application configuration overview
Abstract applications
Create an application group
Application configuration file
Application configuration files for GBC, GWS, and GDC
Configure Web applications
Configure applications for web service
Configure GDC applications
Configure service to start when GAS starts
Configure DVM environment variables
Set environment with script
Override resources with dispatcher
Specify the GBC customization
Specify the application directory
Set override options in a file
Troubleshooting application Issues
Troubleshooting HTTP errors
What if the application doesn't start?
Get application session id
Rendering issues
How to implement delegation
How delegation works
Configure delegation for application or service
Optimize delegation with HTTP options
From the user agent to the REST service
From the REST service to the proxy
REST service example
Delegation use cases
How to develop delegation for Genero apps
How to implement Single sign-on (SSO)
Identity Provider (IdP)
Single sign-on workflow
OpenID Connect/OAuth2 SSO
Identify the protocol in use
Quick start: Set up OpenID Connect
Configure OpenID Connect SSO
Configure OpenID Connect identity on Google
Add OpenID Connect SSO to Web application
Configure OAuth redirect
Configure application starting mode
Retrieve the OpenID Connect user identifier
Authorize an authenticated OpenID Connect user
Authorize re-log in with OpenID Connect SSO
Configure SSO log out
Genero OpenID Connect fglprofile
Genero OpenID Connect log file
Support for OAuth2 protocol
Import metadata
The ImportOAuth program
Set OAuth request format
How to integrate Facebook SSO
How to integrate Instagram SSO
Configure service to service authentication with IdP
SAML SSO
Quick start: Set up SAML
Configure support for SAML SSO
The ImportIdP program
Add SAML SSO to a Genero Web application
Select the SAML server (Identity Provider)
Define the SAML user identifier format
Retrieve the SAML user identifier
Set the authentication context
Retrieve identity attributes with SAML
Authorization and SAML SSO
Authorize re-log in with SAML SSO
Execute an application with SAML SSO
Configure SAML SSO log out
SAML configuration file
SAML fglprofile location and use
Specify a database to store SAML data
SAML log file
SSO custom sample (simplesso)
How autologout re-login prompt works
Connect to the application database with SSO
Compression
Configure for GBC development and troubleshooting
Configure multiple dispatchers
Configuring for GRE in distributed mode
Configure for local machine
Configure for remote machine
Administration
Monitoring
Usage
Monitor URL
Check for invalid Web service configurations
Monitor dispatcher logs
Monitor proxy logs
Monitor proxies and DVM
Monitor HTTP requests
Log files
Sensitive data in logs
Using the debugger
Run the debugger on Windows
Run the debugger on Linux/UNIX
Performance tuning
Web server configuration: Keep Alive
HTTP/2
Load balancing
GAS requests
Sessionless request processing
Session-bound request processing
Load balancing configuration examples
Internet Information Services 5.x and 6.0
Internet Information Services 7.x
Apache 1.3.x and 2.0.x
Apache 2.2.x
NGINX
Genero Identity Provider (GIP)
GIP scenario
GIP components
Setting up the GIP
Provide access to the openid-connect directory
Configure multiple GAS within one GIP
Configure for an external GIP
StarterApp reference
Quick Start: Set authorization for group
Create a user group
Set group authorization scopes
Deploy and secure an app
Set group scopes for profile API
Set group scopes for app using a service
Managing GIP components
Manage users
Manage groups
Manage applications
Manage Web services
Manage authorization scopes
Manage Web service access scopes
Manage refresh tokens
Deploying and securing applications and web services
Deploy and secure an application using the Genero Deployment App
Deploy an application NOT using the Genero Deployment App
Deploy a Web service using the Genero Deployment App
Deploy a Web service NOT using the Genero Deployment App
Automate application deployment via scripts
Automate application configuration via scripts
Configure service to service authentication with GIP
Sharing files
Share files using the Genero SharedFile App
GIP Troubleshooting
GIP log files
Troubleshoot GIP errors in logs
IdP errors
Access service errors
OIDC service errors
HTTPS errors
Reference
Tools and Commands
GetToken
DeployGar
DeployGbc
GIP API scopes reference
GIP working directory
Developing Web applications and Web services
Genero Browser Client (GBC)
Create zip file with customization project
Deploy GBC with gasadmin
Deploy GBC with Deployment App
Provide GBC in application path
Configuring GBC client for applications
With _default file
With deploymentApp
Reset GBC to FGLGWS installed version
Genero Web Services
Web services URI information
Web service invalidation
Configure sticky Web services
Deploying apps with Genero Archive
What is Genero Archive?
Create Genero Archive
Understanding packaging
Steps to packaging applications
Gather files for packaging
Organize resources
Create application configuration files
Create MANIFEST file
Create Genero Archive from MANIFEST
Resource deployment
Paths to application resources
Deploy public images
Deploy private images
Deploy Web components for GBC
MANIFEST file
DESCRIPTION
TRIGGERS
DEPLOY
UNDEPLOY
RESOURCES
APPLICATION
SERVICE
Deploying and managing applications with GAR
Genero Archive lifecycle
Deploy an archive
Deploy with Genero Deployment App
Deploy and secure
Deploy with gasadmin
File system layout of deployed archive
List deployed archives
Enable an archive
Enable with Genero Deployment App
Enable with gasadmin
Disable a deployed archive
Undeploy an archive
Undeploy with the Genero Deployment App
Undeploy with gasadmin
Clean up undeployed archives
Upgrade an archive
Upgrade a Web service
Upgrade using Genero archive
Upgrade manually
Redeploy after software upgrade
Examples: deploy, enable, and run applications
Deployment on remote server
Run in Docker container
Upgrading
New Features of the GAS
GAS 3.21 new features
GAS 3.20 new features
GAS 3.10 new features
GAS 3.00 new features
GAS 2.50 new features
GAS 2.41 new features
GAS 2.40 new features
GAS 2.32 new features
GAS 2.30 new features
GAS 2.22 new features
GAS 2.21 new features
GAS 2.20 new features
Upgrade Guides for the GAS
Migrate your configuration files
GAS 3.21 upgrade guide
GAS 3.20 upgrade guide
GAS 3.10 upgrade guide
GAS 3.00 upgrade guide
GAS 2.50 upgrade guide
GAS 2.41 upgrade guide
GAS 2.40 upgrade guide
Template and snippets
Template paths
GAS 2.30 upgrade guide
Starting the GAS
Configuration
Support
Template functions
XPathConfig migration
Legacy connectors
Mod_fcgid
GAS 2.22 upgrade guide
GAS 2.21 upgrade guide
GAS 2.20 upgrade guide
Configuration
Snippets sets
Legacy connectors installation
Templates and snippets
Migrating from GAS 2.10.x or GWC 2.10.x
Application configuration
Template and snippets
Deprecated functions and paths
GAS (GWC) 2.10 upgrade guide
Migrating to the snippet-based rendering engine
GAS 2.00 upgrade guide
fglxmlp
Migrating from GWC-HTML5
Migrating Templates and Snippets Customizations
Reference
Tools and Commands
Dispatcher: httpdispatch
Dispatcher: fastcgidispatch
Dispatcher: isapidispatch
Proxy: uaproxy
Proxy: gwsproxy
gasadmin tool
Systemd service template
Predefined resources
Overview
Common predefined resources
Configuration Reference
GAS configuration file (as.xcf)
Configuration for Web and service applications
Configuration file hierarchies
GAS configuration file hierarchy
GBC configuration file hierarchy
GWS configuration file hierarchy
Syntax diagrams for configuration files
Configuration file elements
ACCESS_CONTROL
ADDRESS
ADDRESS (LISTEN)
ALLOW_FROM
APPLICATION (for an application)
APPLICATION (for HTTP)
APPLICATION (for a service)
APPLICATION_LIST
APPLICATION_SERVER
AUTO_LOGOUT
AUTO_LOGOUT_COMPONENT
CACHE_CONTROL_MAX_AGE
CATEGORIES_FILTER
COMPONENT_LIST
COMMAND (for auto logout)
CONFIGURATION
DELEGATE
DELEGATE_OPTIONS (for a service)
DESCRIPTION
DOCUMENT_ROOT
DVM_AVAILABLE
DVM
END_URL
ENVIRONMENT_VARIABLE
EXECUTION (for an application)
EXECUTION (for a service)
FORMAT
GBC
GBC_LOOKUP_PATH
GDC_SHORTCUT
GROUP (for an application)
GROUP (for a service)
HEADER
HTTP
INTERFACE_TO_CONNECTOR
INTERFACE_TO_DVM
KEEP_ALIVE
LISTEN
LOG
LONG
MAX_AVAILABLE
MAX_REQUESTS_PER_DVM
MONITOR
MIN_AVAILABLE
MODULE
OUTPUT (under LOG)
PARAMETER
PARAMETERS
PATH (under EXECUTION)
PLATFORM_INDEPENDENT
POOL
PROMPT (for auto logout)
PROXY (for an application)
PROXY (for a service)
PUBLIC_IMAGEPATH
RAW_DATA
REPORT_REMOTE_URL_PREFIX
REPORT_VIEWER_DIRECTORY
REQUEST_RESULT (for an application)
REQUEST_RESULT (for a service)
RESOURCE
RESOURCE (for a service)
RESOURCE (for an application)
RESOURCE_LIST
ROOT_URL_PREFIX
SEND_VERSION
SERVICE_APPLICATION_EXECUTION_COMPONENT
SERVICE_APPLICATION_TIMEOUT_COMPONENT
SERVICE (for HTTP)
SERVICE_LIST
SESSION_DIRECTORY
SESSION_COOKIE
SHORT
SOCKET_FAMILY
SOCKET_PATH
START
TCP_ADMIN_PORT
TCP_BASE_PORT
TCP_PORT_OFFSET
TEMPORARY_DIRECTORY
TIMEOUT (for an application)
TIMEOUT (for a service)
TIMEOUT (for auto logout)
UA_OUTPUT
UA_OUTPUT_COMPONENT
UNX
USER_AGENT
WEB_APPLICATION_EXECUTION_COMPONENT
WEB_APPLICATION_TIMEOUT_COMPONENT
WEB_COMPONENT_DIRECTORY
WNT
SSO oauth2callback redirect URL
Legal Notices
Copyrights and Trademarks
Your browser does not support iframes.