« Single Sign-On   |   Amazon Aurora Configuration Guide »

Using a Program Download Server

This manual is in pilot operation.

By default, the program download server and the request processing server for fusion_place are the same. This section describes the configuration when these servers are set up separately.

Program Download Server

The server that supplies fusion_place program files to each client PC. Normally, this is the server mapped to the fusion_place menu URL and the launch URLs for client programs such as [Manager] and [Browser].

Request Processing Server

The server that receives and processes requests from clients. This is the server mapped to the URL displayed in the "Server URL Specification" screen, which is shown by selecting Options  Server URL…​ from the menu of client programs such as [Manager] and [Browser].

Motivation for Setting Up a Program Download Server Separate from the Request Processing Server

Normally, the server where fusion_place is installed serves both as the request processing server and as the program download server.

For example, when operating fusion_place by connecting from a branch office with limited network bandwidth to a server at headquarters, you may want to suppress network traffic by placing the program download server on the local network at the branch, while keeping the request processing server at headquarters.

To accommodate such needs, fusion_place allows you to set up a program download server separate from the request processing server.

Operational Considerations

The same version of fusion_place must be installed on both the request processing server and the program download server. Otherwise, version mismatches may cause errors on the client side. If an error occurs, reinstall the older fusion_place version to match the newer one.

Adding Configuration for the Request Processing Server URL to the Tomcat Configuration File on the Server

If you set up the program download server and request processing server separately, modify the Tomcat configuration file server.xml on the program download server side.

(fusion_place ⇐ 13.0)
No configuration is required on the request processing server side.

(fusion_place >= 14.0)
You must configure the program download server URL on the request processing server side. The configuration method is described later.

For the location of server.xml, refer to "Location for Recording Installation Information".

The contents of server.xml are in XML format. By adding Environment elements (environment variables) under the Context element (with path="/fusionplace"), you can support using a program download server. Here is an example:

  <Context docBase="fusionplace.war" path="/fusionplace">
    <Environment name="fusionplace/dbms" value="H2" type="java.lang.String"/>
    <Environment name="fusionplace/pivot_time_out" value="60000" type="java.lang.Integer"/>

    <!-- Environment variables to use program download servers

      <Environment name="fusionplace/request_server_url" type="java.lang.String" value="http://fpserver.nowhere.com:50000/fusionplace" />
      <Environment name="fusionplace/request_server_url_editable" type="java.lang.Boolean" value="true" />

    --> ・・・

  </Context>

As shown above, each Environment element has three attributes: name, type, and value. Follow the table below to set the appropriate values. Multiple Environment elements may be included in any order.

name
(Environment Variable Name)		 type
(Environment Variable Type)		 value
(Environment Variable Value)

fusionplace/request_server_url

java.lang.String

Specify the URL of the request processing server (ending with /fusionplace). If not specified, this server (the program download server) is regarded as the request processing server (this is the default).

fusionplace/request_server_url_editable

java.lang.Boolean

Specify whether to allow editing the request processing server URL on the client side. Set to true to allow editing, or false to disallow. The default setting is false.
(fusion_place >= 14.0) If editing the request processing server URL on the client side is allowed, the same setting is required on the request processing server.

Configuring the Request Processing Server URL on the Client Side

If you specify in the server-side Tomcat configuration file (server.xml) via the environment variable "fusionplace/request_server_url_editable" that editing the request processing server URL on the client side is allowed, you can edit the request processing server URL in each client program ([Manager], [Browser], [Contributor]).

  1. Select Options  Server URL…​ from the menu of each client program.

    → The "Server URL Specification" dialog box opens, and the URL field displays the request processing server URL.

  2. Edit the request processing server URL in the URL field. If you want to restore the default value (the URL supplied by the server) during editing, click the Reset button.

  3. Click the OK button. The settings will be saved.

If you click the Reset button or otherwise restore and save the URL field to its default value, the setting will follow any changes to the default value on the server side.

The default value is the URL specified in the environment variable "fusionplace/request_server_url" on the server side. If this environment variable is not specified, the program download server URL becomes the default.

Adding Configuration for the Program Download Server URL to the Request Processing Server (fusion_place >= 14.0)

From fusion_place 14.0 onward, since authentication is performed on the web page (request processing server), it is necessary to set the program download server URL on the request processing server.

For the location of server.xml, refer to "Location for Recording Installation Information".

The contents of server.xml are in XML format. By adding Environment elements (environment variables) under the Context element (with path="/fusionplace"), you can support using a program download server. Here is an example:

  <Context docBase="fusionplace.war" path="/fusionplace">
    <Environment name="fusionplace/dbms" value="H2" type="java.lang.String"/>
    <Environment name="fusionplace/pivot_time_out" value="60000" type="java.lang.Integer"/>

    <!-- Environment variables to use program download servers

      <Environment name="fusionplace/download_server_url" type="java.lang.String" value="http://downloadserver.nowhere.com:50000/fusionplace" />
      <Environment name="fusionplace/request_server_url_editable" type="java.lang.Boolean" value="true" />
    --> ・・・

  </Context>

As shown above, each Environment element has three attributes: name, type, and value. Follow the table below to set the appropriate values. Multiple Environment elements may be included in any order.

name
(Environment Variable Name)		 type
(Environment Variable Type)		 value
(Environment Variable Value)

fusionplace/download_server_url

java.lang.String

Specify the URL of the program download server (ending with /fusionplace). If not specified, this server (the request processing server) is regarded as the program download server (this is the default).

fusionplace/request_server_url_editable

java.lang.Boolean

Specify whether to allow editing the request processing server URL on the client side. Set to true to allow editing, or false to disallow. The default setting is false.
If editing the request processing server URL on the client side is allowed, the same setting is required on the program download server.