IBM Application Gateway (IAG) can serve content from the inbuilt local web server document root. Requests made directly to IAG which do not match any resource servers will be served content from this local document root.
By default, the IAG local document root includes a splash screen 'index.html' and an icon 'favicon.ico'. A copy of the default document root can be retrieved from the pages directory of the IAG Resources repository.
|local_pages.zip||This zip file contains a directory structure including the default local pages content.|
Replacing the default Document Root
The default document root can be replaced by providing content to IAG in two different ways. The content can either be provided as a zip archive or a directory which is bind mounted into the IAG container.
For example, to replace the document root with the content of an archive 'staticContent.zip' which is mounted in the container at '/var/iag/config/staticContent.zip':
server: local_pages: content: "@staticContent.zip" type: zip
For example, to replace the document root with the content of the directory 'staticContent' which is mounted in the container at '/var/iag/config/staticContent':
server: local_pages: content: staticContent type: path
See also: YAML Reference for local_pages
Note that when any content is provided, IAG first removes all of the default content from the document root before populating it with the provided content.
When Local Content is Served
Requests which do not match any resource server and will be processed by the local web server are:
- Requests that do not contain a host header that matches any 'virtual_host' type resource servers
- Requests with a URL that does not match any 'path' type resource servers
Using Directories within Local Content
The directory structure of the provided content may contain subdirectories. Be aware that IAG will first attempt to match the request to a resource server before falling back to the local web server.
For example, consider the following provided content and IAG configuration
Provided Content localContent.zip
index.html images/logo.jpg assets/style.css
version: "23.04" server: local_pages: content: localContent.zip type: zip resource_servers: - path: /assets servers: - host: 10.10.10.200 port: 2308
A request which attempts to retrieve the local content '/assets/style.css' will not be possible as IAG will process the request using the resource server '/assets' rather than the local web server.
Note that if a
pathtype resource server is created with the path
/the local web server document root will not be accessible.
How Local Content is Stored
Regardless of how the content is provided, IAG will copy the provided content to a directory inside of the container during bootstrapping. Be aware that if a large amount of content or large files are included, these will contribute to the container size and startup time.
Updated about 2 months ago