Configure GRE in distributed mode

If you are running the Genero Report Engine (GRE) daemon on a different machine than the DVM, you must configure the REPORT_REMOTE_URL_PREFIX with the URL of the remote server.

The GAS provides three URLs with the report-r prefix to locate the Genero Web Report viewer and resources.

Note: The URL prefix used is report-r as distinct from report used in local mode. The use of the viewer, private and public URL prefixes are the same as those used for local reports.

$(connector.uri)/ua/report-r/viewer
$(connector.uri)/ua/report-r/public
$(connector.uri)/ua/report-r/private/$(session.id)

The GAS proxies these URLs on the remote server, adding first the URL of the server specified in the REPORT_REMOTE_URL_PREFIX in the application configuration file.

The $(connector.uri) is provided by the GAS. This will vary as it is implementation dependent. In our example it is "viewer":

http://remotehost:12345/viewer

Get private resources for report in distributed mode

When the GAS receives a request for a resource with a URL with report-r, this indicates that the GRE is operating in distributed mode on another server. For example:

http://localhost:6394/ua/report-r/private/
      ebf19aba4d09e80cd19cfea7868a9a2a/4BF69549-BA5C-4258-8F42-BFB4A3494339/page000001.svg

The GAS will proxy the request to the configured server using the URL specified in the REPORT_REMOTE_URL_PREFIX in the application configuration file (xcf), for example like this:

http://remotehost:12345/reports/private/
      ebf19aba4d09e80cd19cfea7868a9a2a/4BF69549-BA5C-4258-8F42-BFB4A3494339/page000001.svg

GAS end of session notification

Note: At the end of the session the GAS will send an HTTP request to the remote host to notify that the session has ended for the purpose of deleting the private data associated with the session identifier.

DELETE /reports/delete/ebf19aba4d09e80cd19cfea7868a9a2a

The GAS provides several environment variables to the started application. With these the GAS is able to access the GRE, and provide applications with the public and private resources that are configured for reports.

Important: Resources must be located in the associated public and private directories on the remote server.

Table 1. Environment variables dedicated to GRE in distributed mode
Variable	Description	Example Values
GRE_REPORT_VIEWER_R_URL_PREFIX	URL of the server where the GRE daemon is running.	http://localhost:6394/ua/report-r/viewer
GRE_PRIVATE_R_URL_PREFIX	Public URL prefix	http://localhost:6394/ua/report-r/private/ 89be6b3867148e738fc6bd1daad1ff2e
GRE_PUBLIC_R_URL_PREFIX	Public resource directory	http://localhost:6394/ua/report-r/public
GRE_PRIVATE_R_DIR	Private resource directory.	private/89be6b3867148e738fc6bd1daad1ff2e
GRE_PUBLIC_R_DIR	Private URL prefix	public