Merge pull request #13 from NextronSystems/v2

V2

Author: redteampanda-ng

admin/index.rst

@@ -11,4 +11,5 @@ continuing.
     :caption: Contents
 
     updates
-    upgrade
+    upgrade
+    password

admin/password.rst

@@ -0,0 +1,14 @@
+Password Reset
+==============
+
+Since the password for the admin user is stored only on the Backend,
+you have to reset the password via console. To reset the password for
+the ``admin`` user on the **Security Center Backend**, run the following
+command via console:
+
+.. code-block:: console
+
+    nextron@sc-back:~$ sudo asgard-security-center-backend set-password
+    Please enter password for user `admin`: 
+    Please re-enter password for user `admin`: 
+    nextron@sc-back:~$

issues/issue_1.rst

@@ -1,18 +1,58 @@
-ABN#001: Placeholder
-====================
+ASC#001: Backend is down after Upgrade to v2
+============================================
 
 .. list-table::
     :header-rows: 1
     :widths: 50, 50
 
     * - Introduced Version
       - Fixed Version
-    * - x
-      - y
+    * - 2.x
+      - N/A
 
-Placeholder Text.
+There is currently a rare issue where the backend is not starting
+after upgrading to v2. This is due to insufficient permissions for
+the MySQL Trigger.
 
-ABN#001: Workaround
+If you upgraded your Security Center to version 2 and everything
+seems to be working fine, you can ignore this advisory.
+
+We are currently working on a more robust upgrade process to prevent
+this from happening in the future.
+
+ASC#001: Workaround
 -------------------
 
-Placeholder Text.
+After a successful upgrade to version 2 ("Upgrade finished" message can be
+seen, see :ref:`admin/upgrade:performing the upgrade`), you might encounter
+the following error message in ``/var/log/asgard-security-center-backend/server.log``:
+
+.. code-block:: json
+
+  {
+    "level": "FATAL",
+    "time": "2024-04-03T18:49:16+02:00",
+    "message": "failed to init database schema",
+    "error": "Error 1142 (42000): TRIGGER command denied to user 'securitycenter-model'@'localhost' for table `asgard-security-center-backend`.`assets`"
+  }
+
+To fix this problem, run the following commands on your backend.
+
+Drop the MySQL trigger (no data will be lost):
+
+.. code-block:: console
+
+  nextron@backend:~$ sudo mysql asgard-security-center-backend -e "DROP TRIGGER IF EXISTS assets_updated_fields;"
+
+Restart the backend service. This will recreate the trigger with the correct permissions
+automatically:
+
+.. code-block:: console
+
+  nextron@backend:~$ sudo systemctl restart asgard-security-center-backend.service
+
+Check if the service is running:
+
+.. code-block:: console
+
+  nextron@backend:~$ sudo systemctl status asgard-security-center-backend.service

setup/components.rst

@@ -27,6 +27,8 @@ focuses on the ``ASGARD Security Center (All-in-one)``):
   * ASGARD Gatekeeper
   * ASGARD Lobby
 
+- Master ASGARD
+
 - ASGARD Analysis Cockpit; alternatively:
 
   * Elasticsearch Cluster Node for ASGARD Analysis Cockpit