ELCCR-2026 User documentationfeature_CPDX-3591

Change-Id: I60d52a2b1e8bd5888217a6e07f3f682ea8e00539
Signed-off-by: Remus Turea <Remus.Turea@enea.com>

2 files changed, 141 insertions, 0 deletions

diff --git a/doc/book-enea-edge-getting-started/doc/book.xml b/doc/book-enea-edge-getting-started/doc/book.xml
index e74ac85..4aa2bfe 100644
--- a/doc/book-enea-edge-getting-started/doc/book.xml
+++ b/doc/book-enea-edge-getting-started/doc/book.xml
@@ -38,6 +38,8 @@
 
   <xi:include href="submaps.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 
+  <xi:include href="whitelabel.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />  
+
   <xi:include href="grafana.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 
   <xi:include href="troubleshooting.xml"
diff --git a/doc/book-enea-edge-getting-started/doc/whitelabel.xml b/doc/book-enea-edge-getting-started/doc/whitelabel.xml
new file mode 100644
index 0000000..9b85b0c
--- /dev/null
+++ b/doc/book-enea-edge-getting-started/doc/whitelabel.xml
@@ -0,0 +1,139 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<chapter id="whitelabel">
+  <title>Whitelabeling the Enea Edge Management Login</title>
+
+  <para>The Enea Edge Management login page and main page logos can be changed
+  to replace the Enea logo with a custom one. The login logo
+  URL, the title and the favicon may also be changed.</para>
+
+  <section id="white_conf_screen">
+    <title>Whitelabel Configuration Screen</title>
+
+    <para>In the <emphasis role="bold">System</emphasis> menu, click on the
+    <emphasis role="bold">Configuration</emphasis> sub-menu and on the
+    <emphasis role="bold">Properties</emphasis> tab click the <emphasis
+    role="bold">Whitelabel</emphasis> subtab. This will open a screen where
+      the following fields must be completed:</para>
+
+    <table id="white_conf_table">
+      <title>Whitelabel configuration screen</title>
+
+      <tgroup cols="2">
+        <tbody>
+          <row>
+            <entry><emphasis role="bold">Company name</emphasis></entry>
+
+            <entry>The name of the company. The default value is "Enea AB".
+            The value must have max. 255 characters.</entry>
+          </row>
+
+          <row>
+            <entry><emphasis role="bold">Display title</emphasis></entry>
+
+            <entry>The product name. It is used in the login page and as
+            the title of the pages. The default value is "Enea Edge
+            Management". The value must have max. 255 characters.</entry>
+          </row>
+
+          <row>
+            <entry><emphasis role="bold">Login logo URL</emphasis></entry>
+
+            <entry>The official address of the company. It is used as a
+            hyperlink for the login logo. The default value is
+            "http://enea.com". This must be a valid and complete URL address,
+            starting with http / https.</entry>
+          </row>
+
+          <row>
+            <entry><emphasis role="bold">Login logo</emphasis></entry>
+
+            <entry>The logo image from the login page. The default value is
+            the image <filename>images/enea_logo.png</filename>. The logo
+            must be a PNG file with maximum 800 px width and 55 px
+            height.</entry>
+          </row>
+
+          <row>
+            <entry><emphasis role="bold">Display logo</emphasis></entry>
+
+            <entry>The logo image from the main screen. The default value is
+            the image <filename>images/enea_logo.png</filename>. The logo
+            must be a PNG file with maximum 800 px width and 55 px
+            height.</entry>
+          </row>
+
+          <row>
+            <entry><emphasis role="bold">Favicon</emphasis></entry>
+
+            <entry>The favicon icon. The default icon is
+            <filename>images/favicon/favicon.ico</filename>. The image must
+            be an ICO file with exactly 16 px width and 16 px height.</entry>
+          </row>
+
+          <row>
+            <entry><emphasis role="bold">Restart now</emphasis></entry>
+
+            <entry>If checked, when pressing the 
+              <emphasis role="bold">Apply</emphasis> button, the
+            application will restart.</entry>
+          </row>
+
+          <row>
+            <entry><emphasis role="bold">Reset to defaults</emphasis></entry>
+
+            <entry>When pressed, all the values will be reset to the default
+            ones.</entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
+
+    <note>
+      <para>A restart is necessary in order to apply the changes in the
+      application. This can be done either by checking the <emphasis
+      role="bold">Restart now</emphasis> checkbox, before pressing the
+      <emphasis role="bold">Apply</emphasis> button, or alternatively, 
+        by manually restarting the application.</para>
+
+      <para>The restart operation relies on the <literal>ec_watchdog</literal> 
+        service to start the application again, so the service must be up and running.</para>
+    </note>
+
+    <para>The logo images and the favicon will be saved under a new folder:
+      <filename>images/whitelabel</filename>.</para>
+
+    <para>Only a user with administrative privileges will be able to modify
+    the Whitelabel values, the other users may only see the values.</para>
+  </section>
+
+  <section id="white_bck_restore">
+    <title>Backup and restore when using Whitelabels</title>
+
+    <para>The backup from the application may be done by accessing the <emphasis
+    role="bold">System</emphasis> menu, then choosing <emphasis
+    role="bold">System Backup</emphasis>, selecting the <emphasis
+    role="bold">Backups</emphasis> tab, and clicking the <emphasis
+    role="bold">Backup Now</emphasis> button. For the <emphasis
+    role="bold">Backup Type</emphasis> select <literal>System
+    Backup</literal>. A backup will be created and it will appear in the
+    table of backups.</para>
+
+    <para>The restore operation is made from the same tab: <emphasis
+    role="bold">Backup</emphasis>. The backup file must be selected and
+    then the <emphasis role="bold">Restore</emphasis> button needs to be clicked. 
+      In order to restore the Whitelabel settings, both the <emphasis
+    role="bold">EMS Configuration</emphasis> and the <emphasis
+    role="bold">Media Files (Images/Sounds)</emphasis> checkboxes must be
+    selected. The <emphasis role="bold">EMS
+    Configuration</emphasis> will restore the entries from the database and
+    the <emphasis role="bold">Media Files (Images/Sounds)</emphasis> will
+    restore the actual images.</para>
+  </section>
+
+  <section id="white_upgrade">
+    <title>Upgrading when using Whitelabels</title>
+
+    <para>During an Enea Edge Management upgrade operation, the Whitelabel
+    settings will be preserved without any additional steps involved.</para>
+  </section>
+</chapter>
\ No newline at end of file