Configure GRE in distributed mode on remote machine

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.

In the INTERFACE_TO_CONNECTOR configuration element in the GAS configuration file (as.xcf), specify a REPORT_REMOTE_URL_PREFIX element and set the URL of the GRE:
<REPORT_REMOTE_URL_PREFIX>http://remotehost:12345</REPORT_REMOTE_URL_PREFIX>
The GAS provides three URLs with the report-r prefix to locate the Genero Report Viewer for HTML5 and resources.
Note:

The URL prefix used is report-r as distinct from report used in GRE in distributed mode locally. 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