Difference between revisions of "Fusion Edge Server 3.0 Static Publication"

From Fusion Registry Wiki
Jump to navigation Jump to search
(Step 4: deploy to the Edge Server)
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:EdgeServer3Beta]]
+
[[Category:Fusion Edge Server]]
 +
[[Category:How_to_FES]]
 
The following is a worked example for publishing all publicly accessible datasets from a specified Fusion Registry data warehouse to a Fusion Edge Server 3.0 environment using Static Mode.
 
The following is a worked example for publishing all publicly accessible datasets from a specified Fusion Registry data warehouse to a Fusion Edge Server 3.0 environment using Static Mode.
  
 
==Step 1: pull all data from your Fusion Registry==
 
==Step 1: pull all data from your Fusion Registry==
  
  <nowiki>buildFileSystem.ba</nowiki>t -api "https://[hostname]/ws/public/sdmxapi/rest" -df all -tgt FileSystem
+
  <nowiki>buildFileSystem.ba</nowiki>t -api "https://<strong>[hostname]</strong>/ws/public/sdmxapi/rest" -df all -tgt FileSystem
  
 
This will create a directory called ‘FileSystem’ with copies of the structures and data pulled from your Fusion Registry
 
This will create a directory called ‘FileSystem’ with copies of the structures and data pulled from your Fusion Registry
 +
 +
[hostname] should be the hostname of the server (and port if necessary) where the Fusion Registry instance is deployed.
  
 
==Step 2: compile the content in the FileSystem directory ready for deployment to your Edge Server==
 
==Step 2: compile the content in the FileSystem directory ready for deployment to your Edge Server==
Line 32: Line 35:
 
Create the directory if it doesn’t exist.
 
Create the directory if it doesn’t exist.
  
Create an Edge Server properties file in the FusionEdgeServer ‘home’ directory. The file must be named '''edgeserver.properties''' and should have the following contents:
+
Create an Edge Server properties file in the FusionEdgeServer ‘home’ directory. The file must be named '''edgeserver.properties''' and, for this example, should have the following contents:
  app.url=http://[hostname]/FusionEdgeServer
+
  app.url=http://<strong>[hostname]</strong>/FusionEdgeServer
 
  ledger.secret=signature
 
  ledger.secret=signature
  
 
[hostname] should be the hostname (and port if necessary) where the Fusion Edge Server is deployed.<br>
 
[hostname] should be the hostname (and port if necessary) where the Fusion Edge Server is deployed.<br>
 
Examples:<br>
 
Examples:<br>
<pre>
+
<nowiki>app.url=https://stats.mydomain.org/FusionEdgeServer</nowiki>
app.url=http://stats.mydomain.org/FusionEdgeServer
+
 
stats.mydomain.org
+
<nowiki>app.url=http://localhost:8080/FusionEdgeServer</nowiki>
localhost:8080
 
</pre>
 
  
 
Copy the ‘<nowiki>node.zi</nowiki>p’ into the same directory.
 
Copy the ‘<nowiki>node.zi</nowiki>p’ into the same directory.

Latest revision as of 07:38, 11 September 2023

The following is a worked example for publishing all publicly accessible datasets from a specified Fusion Registry data warehouse to a Fusion Edge Server 3.0 environment using Static Mode.

Step 1: pull all data from your Fusion Registry

buildFileSystem.bat -api "https://[hostname]/ws/public/sdmxapi/rest" -df all -tgt FileSystem

This will create a directory called ‘FileSystem’ with copies of the structures and data pulled from your Fusion Registry

[hostname] should be the hostname of the server (and port if necessary) where the Fusion Registry instance is deployed.

Step 2: compile the content in the FileSystem directory ready for deployment to your Edge Server

compileFileSystem.bat -src FileSystem -tgt Compiled -sgn signature

This will create another directory called ‘Compiled’ containing all of the data and structures pre-compiled for use by the Edge Server and digitally signed for security using the secret passphrase ‘signature’.


Step 3: create node.zip

Zip the contents of the Compiled directory into a ZIP file which must be called ‘node.zip’.

It should look something like the following:

Node.zip.png

Step 4: deploy to the Edge Server

On the Edge Server platform, locate the FusionEdgeServer ‘home’ directory which is usually in the following location on Windows:

C:\Users\[username]\MetadataTechnology\FusionEdgeServer

Create the directory if it doesn’t exist.

Create an Edge Server properties file in the FusionEdgeServer ‘home’ directory. The file must be named edgeserver.properties and, for this example, should have the following contents:

app.url=http://[hostname]/FusionEdgeServer
ledger.secret=signature

[hostname] should be the hostname (and port if necessary) where the Fusion Edge Server is deployed.
Examples:

app.url=https://stats.mydomain.org/FusionEdgeServer
app.url=http://localhost:8080/FusionEdgeServer

Copy the ‘node.zip’ into the same directory.

The ‘home’ directory should look something like the following (ignore tmp):

Homedirectory.png

Step 5: start the Edge Server

When it starts, check that the data and structure web services are responding as expected.