Genero Application Server User Guide 4.01

Content
Search Results
Index
Loading, please wait ...

Loading

  • Genero Application Server User Guide
  • What's New in 4.01
  • Documentation conventions
    • Syntax diagrams
    • Notes, tips, and warnings
    • Code examples
  • General
    • What is the Genero Application Server?
    • Standalone Genero Application Server
    • Front-ends
  • Quick Start
    • Explore the GAS 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
      • DVM locale settings in .xcf files
  • Install Genero Application Server
    • Genero compatibility for the GAS
      • GAS 4.01 and Genero compatibility
      • GAS 3.21 and Genero compatibility
      • GAS 3.10 and Genero compatibility
    • Install GAS on UNIX™ platforms
      • In silent mode
      • Systemd service template
    • Install GAS on Windows®
      • In silent mode
    • Install GAS on macOS™
  • 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 reverse proxy
          • 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 reverse proxy
          • 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
      • Create configuration files for GBC, GWS, and GDC
        • Configure Web applications
        • Configure applications for web service
        • Configure GDC applications
        • Configure Web applications for third-party portal
      • Configure service to start when GAS starts
      • Configure DVM environment variables
      • Set environment with script
      • Configure application headers
      • Configure to close child applications on exit
      • 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
    • Single sign-on (SSO)
      • Identity Provider (IdP)
      • Single sign-on workflow
      • OpenID Connect/OAuth2 SSO
        • Identify the protocol in use
        • Configure GAS for OpenID Connect/OAuth2
        • Implement SSO using OpenID Connect
          • Add OpenID Connect SSO to web application
          • Configure OpenID Connect identity on Google
        • Implement SSO using OAuth2
          • Add OAuth2 SSO to web application
          • Import IdP metadata
          • How to integrate Facebook SSO
          • How to integrate Instagram SSO
          • ImportOAuth
          • Set OAuth request format
        • Configure OAuth redirect
        • Configure client remote IP address
        • Configure application starting mode
        • Retrieve the OpenID Connect user identifier
        • Retrieve roles and scopes
        • Configure service to service authentication with IdP
        • 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
      • SAML SSO
        • 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
        • Specify a database to store SAML data
        • SAML fglprofile location and use
        • SAML configuration file
        • SAML log file
      • SSO custom sample (simplesso)
      • How autologout re-login prompt works
      • Connect to the application database with SSO
    • Enable and disable GAS compression
    • Launch GBC applications in debug mode
    • Use multiple dispatchers
    • Configuring for GRE in distributed mode
      • Configure for local machine
      • Configure for remote machine
  • Administration
    • Monitoring Web services
      • Quick start: setting monitoring alarms
      • Monitoring directory
      • Configure monitoring with commands file
      • Managing alarms
        • How alarms work
        • Display available alarms
        • Configure alarms
        • Configure alarm thresholds
        • Unset alarms
      • Managing monitoring
        • Display monitor status
        • Change the monitoring level
        • Enable and disable web service monitoring
        • Reset monitoring
        • Fetch monitoring data
        • Remove monitoring data
      • Reference
        • Monitoring alarms reference
        • Monitoring data (.dat) files
        • Commands file
        • Alert script example
    • Monitor URL
      • Usage
      • Viewing information about the GAS
      • 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 7.x
        • Apache 2.2.x
        • NGINX
    • Send administrative messages to user agents
  • Genero Identity Provider (GIP)
    • GIP scenario
    • GIP components
    • Setting up the GIP
      • Provide access to the openid-connect directory
      • Configure GIP across multiple GASes
      • Configure the GIP
      • Configure an external GIP
      • StarterApp reference
    • Quick Start: Set authorization for group
      • Create a user group and a user
      • Deploy and secure an app
      • Set group authorization scopes
      • Set group scopes for profile API
      • Set group scopes for app using a service
    • Managing GIP components
      • Manage users
      • Manage user properties
      • 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 Deployment App
      • Deploy an application NOT using the Deployment App
      • Deploy a web service using the Deployment App
      • Deploy a web service NOT using the Deployment App
      • Automate application deployment via scripts
      • Automate application configuration via scripts
    • Configure service to service authentication with GIP
    • Deploying and managing the GBC
      • Deploy runtime on GAS
    • Share files using the 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
        • DeployGar
        • DeployGbc
        • GetToken
      • GIP API scopes reference
      • GIP working directory
  • Genero Browser Client (GBC)
    • Deploy GBC with Deployment App
    • Deploy GBC with gasadmin
    • Which GBC client is used?
      • How the GAS finds default GBC
      • Set GBC default in Deployment App
      • Set GBC default with gasadmin
      • Reset GBC to FGLGWS default
      • Set GBC in application path
      • Set GBC in application URL
      • Set GBC in app configuration
      • Test GBC during development
  • 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 Deployment App
        • Deploy and secure
        • Deploy with gasadmin
      • File system layout of deployed archive
      • List deployed archives
      • Enable an archive
        • Enable with Deployment App
        • Enable with gasadmin
      • Disable a deployed archive
      • Undeploy an archive
        • Undeploy with the 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 4.01 new features
      • GAS 4.00 new features
      • 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
      • Migrate your GIP database
      • GAS 4.01 upgrade guide
      • GAS 4.00 upgrade guide
      • 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
        • 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
      • GetToken
    • 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)
        • ALERT_SCRIPT
        • ALLOW_FROM
        • APPLICATION
        • APPLICATION (for embedded apps)
        • APPLICATIONS
        • 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
        • DATA_DIRECTORY
        • DELEGATE
        • DELEGATE_OPTIONS (for a service)
        • DESCRIPTION
        • DOCUMENT_ROOT
        • DVM_AVAILABLE
        • DVM
        • END_URL
        • ENVIRONMENT_VARIABLE
        • EXECUTION (for application)
        • EXECUTION (for service)
        • FORMAT
        • GBC
        • GBC_LOOKUP_PATH
        • GDC_SHORTCUT
        • GROUP (for an application)
        • GROUP (for a service)
        • HEADER (Dedicated)
        • HEADER (Common)
        • HTTP (Dedicated)
        • HTTP (Common)
        • 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 (deprecated)
        • 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