Add Install method to software.

src/primaite/simulator/system/services/database.py

@@ -1,3 +1,5 @@
+from typing import Dict
+
 from primaite.simulator.file_system.file_system_file_type import FileSystemFileType
 from primaite.simulator.network.hardware.base import Node
 from primaite.simulator.system.services.service import Service
@@ -6,11 +8,17 @@ from primaite.simulator.system.services.service import Service
 class DatabaseService(Service):
     """TODO."""
 
-    def __init__(self, parent_node: Node, **kwargs):
-        super().__init__(**kwargs)
-        self._setup_files_on_node()
+    def describe_state(self) -> Dict:
+        """TODO."""
+        return super().describe_state()
 
-    def _setup_files_on_node(
+    def install(self) -> None:
+        """Perform first time install on a node, creating necessary files."""
+        super().install()
+        assert isinstance(self.parent, Node), "Database install can only happen after the db service is added to a node"
+        self._setup_files()
+
+    def _setup_files(
         self,
         db_size: int = 1000,
         use_secondary_db_file: bool = False,
@@ -30,6 +38,7 @@ class DatabaseService(Service):
         """
         # note that this parent.file_system.create_folder call in the future will be authenticated by using permissions
         # handler. This permission will be granted based on service account given to the database service.
+        self.parent: Node
         folder = self.parent.file_system.create_folder(folder_name)
         self.parent.file_system.create_file("db_primary_store", db_size, FileSystemFileType.MDF, folder=folder)
         self.parent.file_system.create_file("db_transaction_log", "1", FileSystemFileType.LDF, folder=folder)
@@ -37,7 +46,3 @@ class DatabaseService(Service):
             self.parent.file_system.create_file(
                 "db_secondary_store", secondary_db_size, FileSystemFileType.NDF, folder=folder
             )
-
-    # todo next:
-    # create session? (maybe not)
-    # add actions for setting service state to compromised? (probably definitely)

src/primaite/simulator/system/software.py

@@ -1,10 +1,13 @@
 from abc import abstractmethod
 from enum import Enum
-from typing import Any, Dict, Set
+from typing import Any, Dict, Set, TYPE_CHECKING
 
 from primaite.simulator.core import Action, ActionManager, SimComponent
 from primaite.simulator.network.transmission.transport_layer import Port
 
+if TYPE_CHECKING:
+    from primaite.simulator.network.hardware.base import Node
+
 
 class SoftwareType(Enum):
     """
@@ -132,6 +135,20 @@ class Software(SimComponent):
         """
         self.health_state_actual = health_state
 
+    @abstractmethod
+    def install(self) -> None:
+        """
+        Perform first-time setup of this service on a node.
+
+        This is an abstract class that should be overwritten by specific applications or services. It must be called
+        after the service is already associate with a node. For example, a service may need to authenticate with a
+        server during installation, or create files in the node's filesystem.
+
+        :param node: Node on which this software runs.
+        :type node: Node
+        """
+        parent: "Node" = self.parent  # noqa
+
     def scan(self) -> None:
         """Update the observed health status to match the actual health status."""
         self.health_state_visible = self.health_state_actual