Difference between revisions of "Installing Multiple Edge Instances"

From Datonis
Jump to: navigation, search
(Created page with "== On Windows == == On Linux ==")
 
Line 1: Line 1:
 
== On Windows ==
 
== On Windows ==
 +
 +
=== Installation Guide: Adding Multiple Edge Instances on Windows ===
 +
 +
'''Prerequisites:'''
 +
Before installing multiple instances of Datonis Edge on the same Windows PC, you must adjust several configuration settings within the `datonis_edge` folder. Below are the configurations that need to be modified.
 +
 +
=== Configuration Steps: ===
 +
 +
==== 1. Change the Service Name ====
 +
When installing multiple instances or if you need a custom service name, you will need to update the service name in both the `install_edge_service.bat` and `uninstall_edge_service.bat` files. By default, the service name is set to `DatonisEdge`.
 +
 +
* '''File Locations:'''
 +
    * `datonis-edge/bin/install_edge_service.bat`
 +
    * `datonis-edge/bin/uninstall_edge_service.bat`
 +
   
 +
* '''Instructions:'''
 +
    * In both files, locate the line that starts with `java -jar`.
 +
    * Append the following argument to this line in both files:
 +
      <pre><code>--winservicename new_datonis_edge_service_name</code></pre>
 +
    * Replace `new_datonis_edge_service_name` with your desired custom service name.
 +
 +
This ensures that both installation and uninstallation processes recognize the same custom service name.
 +
 +
==== 2. Change Heap Memory Size ====
 +
To adjust the default heap memory size (which is set to 2048 MB by default), edit the `install_edge_service.bat` file.
 +
 +
* '''File Location:''' `bin/install_edge_service.bat`
 +
* '''Instructions:'''
 +
    * Locate the argument:
 +
      <pre><code>--jvmarg Xmx2048m</code></pre>
 +
    * Change `Xmx2048m` to the desired memory size. For example, to set the heap size to 4096 MB:
 +
      <pre><code>--jvmarg Xmx4096m</code></pre>
 +
 +
==== 3. Change Default Ports ====
 +
Datonis Edge uses ports `8080` for HTTP and `8443` for HTTPS by default. If you’re running multiple edge instances, you’ll need to assign different ports for each instance.
 +
 +
* '''File Location:''' `config/config.ini`
 +
* '''Instructions:'''
 +
    * Open the `config.ini` file and locate the following lines:
 +
      <pre><code>org.osgi.service.http.port=8080
 +
org.osgi.service.http.port.secure=8443</code></pre>
 +
    * Change `8080` to your preferred HTTP port and `8443` to your preferred HTTPS port.
 +
 +
=== Example: ===
 +
For instance, if you're setting up a second instance of Datonis Edge, you might make the following changes:
 +
 +
* '''Service Name''': Modify the service name to `DatonisEdge_2`:
 +
  <pre><code>--winservicename DatonisEdge_2</code></pre>
 +
  This change needs to be applied to both the `install_edge_service.bat` and `uninstall_edge_service.bat` files.
 +
 +
* '''Heap Memory Size''': Increase heap memory to 4096 MB:
 +
  <pre><code>--jvmarg Xmx4096m</code></pre>
 +
 +
* '''Port Configuration''': Change the HTTP port to `8090` and the HTTPS port to `8444`:
 +
  <pre><code>org.osgi.service.http.port=8090
 +
org.osgi.service.http.port.secure=8444</code></pre>
  
 
== On Linux ==
 
== On Linux ==

Revision as of 05:57, 30 September 2024

On Windows

Installation Guide: Adding Multiple Edge Instances on Windows

Prerequisites: Before installing multiple instances of Datonis Edge on the same Windows PC, you must adjust several configuration settings within the `datonis_edge` folder. Below are the configurations that need to be modified.

Configuration Steps:

1. Change the Service Name

When installing multiple instances or if you need a custom service name, you will need to update the service name in both the `install_edge_service.bat` and `uninstall_edge_service.bat` files. By default, the service name is set to `DatonisEdge`.

  • File Locations:
   * `datonis-edge/bin/install_edge_service.bat`
   * `datonis-edge/bin/uninstall_edge_service.bat`
   
  • Instructions:
   * In both files, locate the line that starts with `java -jar`.
   * Append the following argument to this line in both files:
<code>--winservicename new_datonis_edge_service_name</code>
   * Replace `new_datonis_edge_service_name` with your desired custom service name.

This ensures that both installation and uninstallation processes recognize the same custom service name.

2. Change Heap Memory Size

To adjust the default heap memory size (which is set to 2048 MB by default), edit the `install_edge_service.bat` file.

  • File Location: `bin/install_edge_service.bat`
  • Instructions:
   * Locate the argument:
<code>--jvmarg Xmx2048m</code>
   * Change `Xmx2048m` to the desired memory size. For example, to set the heap size to 4096 MB:
<code>--jvmarg Xmx4096m</code>

3. Change Default Ports

Datonis Edge uses ports `8080` for HTTP and `8443` for HTTPS by default. If you’re running multiple edge instances, you’ll need to assign different ports for each instance.

  • File Location: `config/config.ini`
  • Instructions:
   * Open the `config.ini` file and locate the following lines:
<code>org.osgi.service.http.port=8080
org.osgi.service.http.port.secure=8443</code>
   * Change `8080` to your preferred HTTP port and `8443` to your preferred HTTPS port.

Example:

For instance, if you're setting up a second instance of Datonis Edge, you might make the following changes:

  • Service Name: Modify the service name to `DatonisEdge_2`:
<code>--winservicename DatonisEdge_2</code>
 This change needs to be applied to both the `install_edge_service.bat` and `uninstall_edge_service.bat` files.
  • Heap Memory Size: Increase heap memory to 4096 MB:
<code>--jvmarg Xmx4096m</code>
  • Port Configuration: Change the HTTP port to `8090` and the HTTPS port to `8444`:
<code>org.osgi.service.http.port=8090
org.osgi.service.http.port.secure=8444</code>

On Linux