pyegeria 0.2.3__py3-none-any.whl → 5.3.0.dev2__py3-none-any.whl

pyegeria/full_omag_server_config.py

@@ -2,18 +2,20 @@
 SPDX-License-Identifier: Apache-2.0
 Copyright Contributors to the ODPi Egeria project.
 
- OMAG Server configuration functions.  These functions add definitions to an OMAG server's configuration document
+ OMAG Server configuration functions.  These functions add definitions to an OMAG server's configuration document.
+ This class encompasses the full set of configuration methods.
 """
 
-from pyegeria._validators import validate_name
-from .exceptions import (
-    InvalidParameterException,
-)
-from ._globals import enable_ssl_check
-from ._client import Client
+import json
 
+from pyegeria import Client
+from pyegeria import InvalidParameterException
+from pyegeria._globals import enable_ssl_check
+from pyegeria._validators import validate_name, validate_url
+from .core_omag_server_config import CoreServerConfig
 
-class FullServerConfig(Client):
+
+class FullServerConfig(CoreServerConfig):
     """
     This class represents a client for configuring the OMAG Server.
 
@@ -33,99 +35,154 @@ class FullServerConfig(Client):
     """
 
     def __init__(
-            self,
-            server_name: str,
-            platform_url: str,
-            user_id: str,
-            user_pwd: str = None,
-            verify_flag: bool = enable_ssl_check,
+        self,
+        server_name: str,
+        platform_url: str,
+        user_id: str,
+        user_pwd: str = None,
     ):
-        self.admin_command_root: str
-        Client.__init__(self, server_name, platform_url, user_id, user_pwd, verify_flag)
-        self.admin_command_root = (
-                self.platform_url
-                + "/open-metadata/admin-services/users/"
-                + user_id
+        self.full_config_command_root: str
+        CoreServerConfig.__init__(self, server_name, platform_url, user_id, user_pwd)
+        self.full_config_command_root = (
+            self.platform_url + "/open-metadata/admin-services/users/" + user_id
         )
 
-    def get_access_services_topic_names(self, access_service_name: str, server_name: str = None) -> list[str]:
+    def get_access_services_topic_names(
+        self, access_service_name: str, server_name: str = None
+    ) -> list[str]:
+        """Retrieve the topic names for this access service.
+        Parameters
+        ----------
+        access_service_name : str
+            The name of the access service.
+
+        server_name : str, optional
+            The name of the server. If not provided, the server name of the instance is used.
+
+        Returns
+        -------
+        list[str]
+            A list of topic names associated with the specified access service.
+
+        """
         if server_name is None:
             server_name = self.server_name
         validate_name(access_service_name)
-        url = (self.admin_command_root + "/servers/" + server_name + "/access-services/"
-               + access_service_name + "/topic-names")
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/access-services/"
+            + access_service_name
+            + "/topic-names"
+        )
         response = self.make_request("GET", url)
 
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code == 200:
-            return response.json()  # todo fix
-        else:
-            raise InvalidParameterException(response.content)
+        return response.json()  # todo fix
 
-    def get_all_access_services_topic_names(self, server_name: str = None) -> str:
+    def get_all_access_services_topic_names(self, server_name: str = None) -> list:
+        """Retrieve the topic names for all access services.
+        Parameters
+        ----------
+        server_name : str, optional
+            The name of the server. If not provided, the default server name will be used.
+
+        Returns
+        -------
+        list
+            The JSON response containing the access services topic names.
+
+        """
         if server_name is None:
             server_name = self.server_name
 
-        url = (self.admin_command_root + "/servers/" + server_name + "/access-services/topic-names")
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/access-services/topic-names"
+        )
         response = self.make_request("GET", url)
 
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code == 200:
-            return response.json()  # todo fix
-        else:
-            raise InvalidParameterException(response.content)
+        return response.json()  # todo fix
 
-    def set_access_services_configuration(self, access_services_body: str, server_name: str = None):
-        if server_name is None:
-            server_name = self.server_name
+    def set_access_services_configuration(
+        self, access_services_body: str, server_name: str = None
+    ) -> None:
+        """Set up the configuration for selected open metadata access services (OMASs).
+        This overrides the current configured values.
 
-        url = self.admin_command_root + "/servers/" + server_name + "/access-services/configuration"
-        response = self.make_request("POST", url, access_services_body)
+        Parameters
+        ----------
+        access_services_body: str
+            The body of the access services configuration. This should be a string representation of the desired
+            configuration.
 
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code == 200:
-            return
-        else:
-            raise InvalidParameterException(response.content)
+        server_name: str, optional
+            The name of the server. If not provided, the default server will be used.
 
-    def override_access_service_in_topic_name(self, access_service_name: str, new_topic_name: str,
-                                              server_name: str = None):
+        Returns
+        -------
+        None
+
+        """
         if server_name is None:
             server_name = self.server_name
 
-        url = (self.admin_command_root + "/servers/" + server_name + "/access-services/" +
-               access_service_name + "/topic-names/in-topic")
-        response = self.make_request("POST", url, new_topic_name)
-
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code == 200:
-            return response.json()  # todo fix
-        else:
-            raise InvalidParameterException(response.content)
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/access-services/configuration"
+        )
+        self.make_request("POST", url, access_services_body)
+        return
 
-    def override_access_service_out_topic_name(self, access_service_name: str, new_topic_name: str,
-                                               server_name: str = None):
+    def override_access_service_in_topic_name(
+        self, access_service_name: str, new_topic_name: str, server_name: str = None
+    ) -> None:
+        """override the in topic for the access service"""
         if server_name is None:
             server_name = self.server_name
 
-        url = (self.admin_command_root + "/servers/" + server_name + "/access-services/" +
-               access_service_name + "/topic-names/out-topic")
-        response = self.make_request("POST", url, new_topic_name)
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/access-services/"
+            + access_service_name
+            + "/topic-names/in-topic"
+        )
+        self.make_request("POST", url, new_topic_name)
+        return
 
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code == 200:
-            return response.json()  # todo fix
-        else:
-            raise InvalidParameterException(response.content)
+    def override_access_service_out_topic_name(
+        self, access_service_name: str, new_topic_name: str, server_name: str = None
+    ) -> None:
+        """override the out topic for the access service"""
+        if server_name is None:
+            server_name = self.server_name
 
-    def set_audit_log_destinations(self, audit_dest_body: str, server_name: str = None):
-        """ Sets the audit log destinations for a server
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/access-services/"
+            + access_service_name
+            + "/topic-names/out-topic"
+        )
+        self.make_request("POST", url, new_topic_name)
+        return
+
+    def set_audit_log_destinations(
+        self, audit_dest_body: str, server_name: str = None
+    ) -> None:
+        """Sets the audit log destinations for a server
 
         /open-metadata/admin-services/users/{userId}/servers/{serverName}/audit-log-destinations
 
         Parameters
         ----------
-
         audit_dest_body : str
             A JSON document describing the audit destinations for this server.
 
@@ -134,7 +191,7 @@ class FullServerConfig(Client):
 
         Returns
         -------
-        JSON string containing the status of the request.
+        None
 
         Raises
         ------
@@ -150,17 +207,20 @@ class FullServerConfig(Client):
         if server_name is None:
             server_name = self.server_name
 
-        url = self.admin_command_root + "/servers/" + server_name + "/audit-log-destinations"
-        response = self.make_request("POST", url, audit_dest_body)
-
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code == 200:
-            return
-        else:
-            raise InvalidParameterException(response.content)
-
-    def update_audit_log_destination(self, connection_name: str, audit_dest_body: str, server_name: str = None):
-        """
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/audit-log-destinations"
+        )
+        self.make_request("POST", url, audit_dest_body)
+        return
+
+    def update_audit_log_destination(
+        self, connection_name: str, audit_dest_body: str, server_name: str = None
+    ) -> None:
+        """Update an audit log destination that is identified with the supplied destination name
+            with the supplied connection object.
         Parameters
         ----------
         connection_name : str
@@ -183,17 +243,20 @@ class FullServerConfig(Client):
         if server_name is None:
             server_name = self.server_name
 
-        url = self.admin_command_root + "/servers/" + server_name + "/audit-log-destinations/connection/" + connection_name
-        response = self.make_request("POST", url, audit_dest_body)
-
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code == 200:
-            return
-        else:
-            raise InvalidParameterException(response.content)
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/audit-log-destinations/connection/"
+            + connection_name
+        )
+        self.make_request("POST", url, audit_dest_body)
+        return
 
-    def add_audit_log_destination(self, connection_body: str, server_name: str = None):
-        """ Adds an audit log destination to a server.
+    def add_audit_log_destination(
+        self, connection_body: str, server_name: str = None
+    ) -> None:
+        """Adds an audit log destination to a server.
 
         /open-metadata/admin-services/users/{userId}/servers/{serverName}/audit-log-destinations/connection
 
@@ -206,7 +269,7 @@ class FullServerConfig(Client):
 
         Returns
         -------
-        Void
+        None
 
         Raises
         ------
@@ -224,31 +287,60 @@ class FullServerConfig(Client):
         if server_name is None:
             server_name = self.server_name
 
-        url = self.admin_command_root + "/servers/" + server_name + "/audit-log-destinations/connection"
-        response = self.make_request("POST", url, connection_body)
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/audit-log-destinations/connection"
+        )
+        self.make_request("POST", url, connection_body)
+        return
+
+    def set_cohort_config(
+        self, cohort_name: str, cohort_config_body: str, server_name: str = None
+    ) -> None:
+        """Set up the configuration properties for a cohort. This may reconfigure an existing cohort or
+            create a cohort. Use setCohortMode to delete a cohort.
+        Parameters
+        ----------
+        cohort_name : str
+            The name of the cohort for which the configuration is being set.
+        cohort_config_body : str
+            The body of the cohort configuration.
+        server_name : str, optional
+            The name of the server. If not provided, the method will use the server name that is already set.
 
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code == 200:
-            return
-        else:
-            raise InvalidParameterException(response.content)
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        InvalidParameterException
+            If the cohort_config_body is None.
 
-    def set_cohort_config(self, cohort_name: str, cohort_config_body: str, server_name: str = None):
+        """
         if server_name is None:
             server_name = self.server_name
         validate_name(cohort_name)
         if cohort_config_body is None:
             raise InvalidParameterException(cohort_config_body)
 
-        url = self.admin_command_root + "/servers/" + server_name + "/cohorts/" + cohort_name + "/configuration"
-        response = self.make_request("POST", url, cohort_config_body)
-
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code != 200:
-            raise InvalidParameterException(response.content)
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/cohorts/"
+            + cohort_name
+            + "/configuration"
+        )
+        self.make_request("POST", url, cohort_config_body)
+        return
 
-    def clear_cohort_configuration(self, cohort_name: str, server_name: str = None) -> None:
-        """ Retrieves the stored configurations for a server
+    def clear_cohort_configuration(
+        self, cohort_name: str, server_name: str = None
+    ) -> None:
+        """Retrieves the stored configurations for a server
         Parameters
         ----------
         cohort_name : str
@@ -270,133 +362,259 @@ class FullServerConfig(Client):
         """
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/cohorts/{cohort_name}"
+        url = f"{self.full_config_command_root}/servers/{server_name}/cohorts/{cohort_name}"
         validate_name(cohort_name)
 
         self.make_request("DELETE", url)
 
-    def get_dedicated_cohort_topic_names(self, cohort_name: str, server_name: str = None) -> [str]:
+    def get_dedicated_cohort_topic_names(
+        self, cohort_name: str, server_name: str = None
+    ) -> list:
+        """Retrieve the current topic name for the cohort. This call can only be made once the cohort is set up with
+            add_cohort_registration().
+
+        Parameters
+        ----------
+        cohort_name : str
+            The name of the cohort for which to retrieve the dedicated topic names.
+
+        server_name : str, optional
+            The name of the server on which the cohort resides. If not provided, the default server name will be used.
+
+        Returns
+        -------
+        list
+            A list of topic names that are dedicated to the specified cohort.
+
+        """
         if server_name is None:
             server_name = self.server_name
 
         validate_name(cohort_name)
 
-        url = self.admin_command_root + "/servers/" + server_name + "/cohorts/" + cohort_name + "/dedicated-topic-names"
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/cohorts/"
+            + cohort_name
+            + "/dedicated-topic-names"
+        )
         response = self.make_request("POST", url)
-
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code != 200:
-            raise InvalidParameterException(response.content)
-        else:
-            return (response.json().get("topicNames"))
+        return response.json().get("topicNames")
 
     def get_cohort_topic_name(self, cohort_name: str, server_name: str = None) -> str:
+        """Retrieve the current topic name for the cohort. This call can only be made once the
+            cohort is set up with add_cohort_registration().
+        Parameters
+        ----------
+        cohort_name : str
+            The name of the cohort for which to retrieve the topic name.
+        server_name : str, optional
+            The name of the server on which the cohort is located. If not provided, the default server name will be used.
+
+        Returns
+        -------
+        str
+            The topic name associated with the specified cohort.
+
+        Raises
+        ------
+        InvalidParameterException
+            If the request to retrieve the topic name fails or returns an invalid parameter code.
+
+        """
         if server_name is None:
             server_name = self.server_name
         validate_name(cohort_name)
 
-        url = f"{self.admin_command_root}/servers/{server_name}/cohorts/{cohort_name}/topic-name"
+        url = f"{self.full_config_command_root}/servers/{server_name}/cohorts/{cohort_name}/topic-name"
         response = self.make_request("GET", url)
+        return response.json().get("topicName")
 
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code != 200:
-            raise InvalidParameterException(response.content)
-        else:
-            return (response.json().get("topicName"))
+    def override_cohort_topic_name(
+        self, cohort_name: str, topic_override: str, server_name: str = None
+    ) -> None:
+        """Override the current name for the single topic for the cohort. This call can only be made once the
+            cohort is set up with add_cohort_registration().
+        Parameters
+        ----------
+        cohort_name : str
+            The name of the cohort for which the topic name is to be overridden.
+
+        topic_override : str
+            The new topic name to override the original topic name.
 
-    def override_cohort_topic_name(self, cohort_name: str, topic_override: str, server_name: str = None) -> None:
+        server_name : str, optional
+            The name of the server. If not provided, the default server name will be used.
+
+        """
         if server_name is None:
             server_name = self.server_name
         validate_name(cohort_name)
         validate_name(topic_override)
 
-        url = self.admin_command_root + "/servers/" + server_name + "/cohorts/" + cohort_name + "/topic-name-override"
-        response = self.make_request("POST", url, topic_override)
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/cohorts/"
+            + cohort_name
+            + "/topic-name-override"
+        )
+        self.make_request("POST", url, topic_override)
+        return
+
+    def override_instances_cohort_topic_name(
+        self, cohort_name: str, topic_override: str, server_name: str = None
+    ) -> None:
+        """Override the current name for the "instances" topic for the cohort. This call can only be made once
+            the cohort is set up with add_cohort_registration().
+        Parameters
+        ----------
+        cohort_name : str
+            The name of the cohort to override the topic name for.
+
+        topic_override : str
+            The new topic name to override for the cohort.
 
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code != 200:
-            raise InvalidParameterException(response.content)
+        server_name : str, optional
+            The name of the server where the cohort is located. If not specified,
+            the default server name will be used.
 
-    def override_instances_cohort_topic_name(self, cohort_name: str, topic_override: str,
-                                             server_name: str = None) -> None:
+        """
         if server_name is None:
             server_name = self.server_name
         validate_name(cohort_name)
         validate_name(topic_override)
 
-        url = self.admin_command_root + "/servers/" + server_name + "/cohorts/" + cohort_name + "/topic-name-override/instances"
-        response = self.make_request("POST", url, topic_override)
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/cohorts/"
+            + cohort_name
+            + "/topic-name-override/instances"
+        )
+        self.make_request("POST", url, topic_override)
+        return
+
+    def override_registration_cohort_topic_name(
+        self, cohort_name: str, topic_override: str, server_name: str = None
+    ) -> None:
+        """Override the current name for the registration topic for the cohort. This call can only be made once
+            the cohort is set up with add_cohort_registration().
+        Parameters
+        ----------
+        cohort_name : str
+            Name of the cohort to override the topic name for.
+        topic_override : str
+            The overriding topic name for the cohort.
+        server_name : str, optional
+            Name of the server. If not provided, the default server name will be used.
 
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code != 200:
-            raise InvalidParameterException(response.content)
+        Returns
+        -------
+        None
+            This method does not return any value.
 
-    def override_registration_cohort_topic_name(self, cohort_name: str, topic_override: str,
-                                                server_name: str = None) -> None:
+        """
         if server_name is None:
             server_name = self.server_name
         validate_name(cohort_name)
         validate_name(topic_override)
 
-        url = self.admin_command_root + "/servers/" + server_name + "/cohorts/" + cohort_name + "/topic-name-override/registration"
-        response = self.make_request("POST", url, topic_override)
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/cohorts/"
+            + cohort_name
+            + "/topic-name-override/registration"
+        )
+        self.make_request("POST", url, topic_override)
+        return
+
+    def override_types_cohort_topic_name(
+        self, cohort_name: str, topic_override: str, server_name: str = None
+    ) -> None:
+        """Override the current name for the "types" topic for the cohort. This call can only be made once
+            the cohort is set up with add_cohort_registration().
+        Parameters
+        ----------
+        cohort_name : str
+            The name of the cohort.
+        topic_override : str
+            The topic override to be set for the cohort.
+        server_name : str, optional
+            The name of the server. If not provided, it will use the default server name from the class.
 
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code != 200:
-            raise InvalidParameterException(response.content)
+        Raises
+        ------
+        InvalidParameterException
+            If the response from the server has a relatedHTTPCode other than 200.
 
-    def override_types_cohort_topic_name(self, cohort_name: str, topic_override: str, server_name: str = None) -> None:
+        """
         if server_name is None:
             server_name = self.server_name
         validate_name(cohort_name)
         validate_name(topic_override)
 
-        url = self.admin_command_root + "/servers/" + server_name + "/cohorts/" + cohort_name + "/topic-name-override/types"
-        response = self.make_request("POST", url, topic_override)
-
-        related_code = response.json().get("relatedHTTPCode")
-        if related_code != 200:
-            raise InvalidParameterException(response.content)
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/cohorts/"
+            + cohort_name
+            + "/topic-name-override/types"
+        )
+        self.make_request("POST", url, topic_override)
+        return
 
-    def add_cohort_registration(self, cohort_name: str, topic_structure: str, server_name: str = None) -> None:
-        """ add a cohort registration
+    def add_full_cohort_registration(
+        self, cohort_name: str, topic_structure: str, server_name: str = None
+    ) -> None:
+        """add a full cohort registration
 
-            Parameters
-            ----------
-            cohort_name : str
-                Name of the cohort to be registered.
-            topic_structure : str
-                Topic structure for the cohort. This is a string from an enumerated list.
-                'Dedicated Cohort Topics', description='The cohort members use three topics to exchange information. One for
-                    registration requests, one for type validation and one for exchange of instances stored by the cohort members.
-                    This is the preferred and optimal approach
-                 'Single Topic', description='All asynchronous communication between cohort members is via a single topic.
-                    This is the original design and may still be used when communicating with back level cohort members.
-                'Both Single and Dedicated Topics', description='Both the single cohort topic and the dedicated topics are
-                    set up and used. This is necessary when the cohort has members with different capabilities.
-                     This configuration may cause some events to be processed twice.'
-            server_name : str, optional
-                Name of the server to which the cohort should be added. Defaults to None.
+        Parameters
+        ----------
+        cohort_name : str
+            Name of the cohort to be registered.
+        topic_structure : str
+            Topic structure for the cohort. This is a string from an enumerated list.
+            'Dedicated Cohort Topics', description='The cohort members use three topics to exchange information.
+            One for registration requests, one for type validation and one for exchange of instances stored by the
+            cohort members.
+                This is the preferred and optimal approach
+             'Single Topic', description='All asynchronous communication between cohort members is via a single topic.
+                This is the original design and may still be used when communicating with back level cohort members.
+            'Both Single and Dedicated Topics', description='Both the single cohort topic and the dedicated topics are
+                set up and used. This is necessary when the cohort has members with different capabilities.
+                 This configuration may cause some events to be processed twice.'
+        server_name : str, optional
+            Name of the server to which the cohort should be added. Defaults to None.
 
-            Returns
-            -------
-            None
+        Returns
+        -------
+        None
 
-            Raises
-            ------
-            InvalidParameterException
-                If the response code is not 200 after making the POST request.
+        Raises
+        ------
+        InvalidParameterException
+            If the response code is not 200 after making the POST request.
 
-            """
+        """
         if server_name is None:
             server_name = self.server_name
         validate_name(cohort_name)
 
-        url = f"{self.admin_command_root}/servers/{server_name}/cohorts/{cohort_name}/topic-structure/{topic_structure}"
+        url = f"{self.full_config_command_root}/servers/{server_name}/cohorts/{cohort_name}/topic-structure/{topic_structure}"
         self.make_request("POST", url)
 
-    def set_server_configuration(self, config_body: str, server_name: str = None) -> None | str:
-        """ Sets the configurations for a server
+    def set_server_configuration(
+        self, config_body: str, server_name: str = None
+    ) -> None | str:
+        """Sets the configurations for a server
         Parameters
         ----------
 
@@ -420,7 +638,9 @@ class FullServerConfig(Client):
         """
         if server_name is None:
             server_name = self.server_name
-        url = self.admin_command_root + "/servers/" + server_name + "/configuration"
+        url = (
+            self.full_config_command_root + "/servers/" + server_name + "/configuration"
+        )
         response = self.make_request("POST", url, config_body)
         if response.status_code != 200:
             return str(response.status_code)  # should never get here?
@@ -432,7 +652,7 @@ class FullServerConfig(Client):
             raise InvalidParameterException(response.content)
 
     def clear_stored_configuration(self, server_name: str = None) -> None | str:
-        """ Retrieves the stored configurations for a server
+        """Retrieves the stored configurations for a server
         Parameters
         ----------
 
@@ -456,7 +676,9 @@ class FullServerConfig(Client):
         """
         if server_name is None:
             server_name = self.server_name
-        url = self.admin_command_root + "/servers/" + server_name + "/configuration"
+        url = (
+            self.full_config_command_root + "/servers/" + server_name + "/configuration"
+        )
         response = self.make_request("DELETE", url)
         if response.status_code != 200:
             return str(response.status_code)  # should never get here?
@@ -467,8 +689,10 @@ class FullServerConfig(Client):
         else:
             raise InvalidParameterException(response.content)
 
-    def deploy_stored_configurations(self, target_url_root: str, server_name: str = None) -> None:
-        """ Push the configuration for the server to another OMAG Server Platform.
+    def deploy_stored_configurations(
+        self, target_url_root: str, server_name: str = None
+    ) -> None:
+        """Push the configuration for the server to another OMAG Server Platform.
         Parameters
         ----------
         target_url_root : str
@@ -490,13 +714,12 @@ class FullServerConfig(Client):
         if server_name is None:
             server_name = self.server_name
 
-        url = f"{self.admin_command_root}/servers/{server_name}/configuration/deploy"
+        url = f"{self.full_config_command_root}/servers/{server_name}/configuration/deploy"
 
         self.make_request("POST", url, target_url_root)
 
-
     def get_event_bus(self, server_name: str = None) -> dict:
-        """ Returns the event bus configuration for the specified server
+        """Returns the event bus configuration for the specified server
 
         Parameters
         ----------
@@ -520,12 +743,14 @@ class FullServerConfig(Client):
         """
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/event-bus"
+        url = f"{self.full_config_command_root}/servers/{server_name}/event-bus"
 
         response = self.make_request("GET", url)
         return response.json().get("config")
 
-    def set_event_bus(self, connector_provider: str, topic_url_root: str, server_name: str = None) -> None:
+    def set_event_bus_detailed(
+        self, connector_provider: str, topic_url_root: str, server_name: str = None
+    ) -> None:
         """
         Parameters
         ----------
@@ -562,12 +787,14 @@ class FullServerConfig(Client):
         if server_name is None:
             server_name = self.server_name
 
-        url = (f"{self.admin_command_root}/servers/{server_name}/event-bus?connectorProvider="
-               f"{connector_provider}&topicURLRoot={topic_url_root}")
+        url = (
+            f"{self.full_config_command_root}/servers/{server_name}/event-bus?connectorProvider="
+            f"{connector_provider}&topicURLRoot={topic_url_root}"
+        )
         self.make_request("POST", url)
 
     def delete_event_bus(self, server_name: str = None) -> None:
-        """ Delete the event bus configuration for the given server.
+        """Delete the event bus configuration for the given server.
 
         Parameters
         ----------
@@ -593,14 +820,15 @@ class FullServerConfig(Client):
         if server_name is None:
             server_name = self.server_name
 
-        url = f"{self.admin_command_root}/servers/{server_name}/event-bus"
+        url = f"{self.full_config_command_root}/servers/{server_name}/event-bus"
         self.make_request("DELETE", url)
 
     def set_server_url_root(self, url_root: str, server_name: str = None) -> None:
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/server-url-root-for-caller"
-        response = self.make_request("POST", url, payload=url_root)
+        url = f"{self.full_config_command_root}/servers/{server_name}/server-url-root-for-caller"
+        body = {"urlRoot": url_root}
+        response = self.make_request("POST", url, payload=body)
         related_code = response.json().get("relatedHTTPCode")
         if related_code != 200:
             raise InvalidParameterException(response.content)
@@ -616,7 +844,8 @@ class FullServerConfig(Client):
         max_page_size : int
             The maximum page size to set.
         server_name : str, optional
-            The name of the server for which to set the maximum page size. If not specified, the default server name will be used.
+            The name of the server for which to set the maximum page size. If not specified, the default server name
+            will be used.
 
         Returns
         -------
@@ -636,13 +865,13 @@ class FullServerConfig(Client):
         """
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/max-page-size?limit={max_page_size}"
+        url = f"{self.full_config_command_root}/servers/{server_name}/max-page-size?limit={max_page_size}"
         self.make_request("POST", url)
 
     def set_server_user_id(self, server_user_id: str, server_name: str = None) -> None:
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/server-user-id?id={server_user_id}"
+        url = f"{self.full_config_command_root}/servers/{server_name}/server-user-id?id={server_user_id}"
         response = self.make_request("POST", url)
         related_code = response.json().get("relatedHTTPCode")
         if related_code != 200:
@@ -650,10 +879,12 @@ class FullServerConfig(Client):
         else:
             return
 
-    def set_server_user_password(self, server_user_pwd: str, server_name: str = None) -> None:
+    def set_server_user_password(
+        self, server_user_pwd: str, server_name: str = None
+    ) -> None:
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/server-user-password?password={server_user_pwd}"
+        url = f"{self.full_config_command_root}/servers/{server_name}/server-user-password?password={server_user_pwd}"
         response = self.make_request("POST", url)
         related_code = response.json().get("relatedHTTPCode")
         if related_code != 200:
@@ -664,7 +895,7 @@ class FullServerConfig(Client):
     def set_organization_name(self, org_name: str, server_name: str = None) -> None:
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/organization-name?name={org_name}"
+        url = f"{self.full_config_command_root}/servers/{server_name}/organization-name?name={org_name}"
         response = self.make_request("POST", url)
         related_code = response.json().get("relatedHTTPCode")
         if related_code != 200:
@@ -672,10 +903,17 @@ class FullServerConfig(Client):
         else:
             return
 
-    def set_local_repository_config(self, repository_body: str, server_name: str = None) -> None:
+    def set_local_repository_config(
+        self, repository_body: str, server_name: str = None
+    ) -> None:
         if server_name is None:
             server_name = self.server_name
-        url = self.admin_command_root + "/servers/" + server_name + "/local-repository/configuration"
+        url = (
+            self.full_config_command_root
+            + "/servers/"
+            + server_name
+            + "/local-repository/configuration"
+        )
         response = self.make_request("POST", url, payload=repository_body)
         related_code = response.json().get("relatedHTTPCode")
         if related_code != 200:
@@ -683,15 +921,18 @@ class FullServerConfig(Client):
         else:
             return
 
-    def set_plug_in_repository_connection(self, repository_connection_body: str, server_name: str = None) -> None:
+    def set_plug_in_repository_connection(
+        self, repository_connection_body: str, server_name: str = None
+    ) -> None:
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/local-repository/mode/plugin-repository/connection"
+        url = f"{self.full_config_command_root}/servers/{server_name}/local-repository/mode/plugin-repository/connection"
         self.make_request("POST", url, payload=repository_connection_body)
 
-    def set_plug_in_repository_connection_provider(self, repository_connection_provider: str,
-                                                   server_name: str = None) -> None:
-        """ Set the local repository connection with a user specified connection provider
+    def set_plug_in_repository_connection_provider(
+        self, repository_connection_provider: str, server_name: str = None
+    ) -> None:
+        """Set the local repository connection with a user specified connection provider
 
         Parameters
         ----------
@@ -717,14 +958,18 @@ class FullServerConfig(Client):
         """
         if server_name is None:
             server_name = self.server_name
-        url = (f"{self.admin_command_root}/servers/{server_name}/local-repository/mode/plugin-repository/"
-               f"details?connectionProvider={repository_connection_provider}")
+        url = (
+            f"{self.full_config_command_root}/servers/{server_name}/local-repository/mode/plugin-repository/"
+            f"details?connectionProvider={repository_connection_provider}"
+        )
         self.make_request("POST", url)
 
-    def set_open_metadata_archives(self, archives_list_body: str, server_name: str = None) -> None:
+    def set_open_metadata_archives(
+        self, archives_list_body: str, server_name: str = None
+    ) -> None:
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/open-metadata-archives"
+        url = f"{self.full_config_command_root}/servers/{server_name}/open-metadata-archives"
         response = self.make_request("POST", url, payload=archives_list_body)
         related_code = response.json().get("relatedHTTPCode")
         if related_code != 200:
@@ -732,41 +977,45 @@ class FullServerConfig(Client):
         else:
             return
 
-    def set_descriptive_server_type(self, type_name: str, server_name: str = None) -> None:
-        """ Set descriptiveServerType for this OMAG server
+    def set_descriptive_server_type(
+        self, type_name: str, server_name: str = None
+    ) -> None:
+        """Set descriptiveServerType for this OMAG server
 
-            Parameters
-            ----------
-            type_name : str
-                The name of the descriptive server type to set.
+        Parameters
+        ----------
+        type_name : str
+            The name of the descriptive server type to set.
 
-            server_name : str, optional
-                The name of the server for which the descriptive server type is being set. If not provided, the
-                default server name associated with the object is used.
+        server_name : str, optional
+            The name of the server for which the descriptive server type is being set. If not provided, the
+            default server name associated with the object is used.
 
-            Returns
-            -------
-            None
+        Returns
+        -------
+        None
 
-            Raises
-            ------
-            InvalidParameterException
-                If the response code is not 200.
-            PropertyServerException:
-                Raised by the server when an issue arises in processing a valid request
-            NotAuthorizedException:
-                The principle specified by the user_id does not have authorization for the requested action
+        Raises
+        ------
+        InvalidParameterException
+            If the response code is not 200.
+        PropertyServerException:
+            Raised by the server when an issue arises in processing a valid request
+        NotAuthorizedException:
+            The principle specified by the user_id does not have authorization for the requested action
 
-            """
+        """
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/server-type?typeName={type_name}"
+        url = f"{self.full_config_command_root}/servers/{server_name}/server-type?typeName={type_name}"
         self.make_request("POST", url)
 
     def set_server_description(self, server_desc: str, server_name: str = None) -> None:
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/server-description"
+        url = (
+            f"{self.full_config_command_root}/servers/{server_name}/server-description"
+        )
         response = self.make_request("POST", url, server_desc)
         related_code = response.json().get("relatedHTTPCode")
         if related_code != 200:
@@ -775,7 +1024,7 @@ class FullServerConfig(Client):
             return
 
     def set_server_type(self, server_type: str, server_name: str = None) -> None:
-        """ Sets the server type for the given server
+        """Sets the server type for the given server
 
         Parameters
         ----------
@@ -807,12 +1056,14 @@ class FullServerConfig(Client):
         if server_name is None:
             server_name = self.server_name
 
-        url = (f"{self.admin_command_root}/servers/{server_name}/"
-               f"server-type?typename={server_type}")
+        url = (
+            f"{self.full_config_command_root}/servers/{server_name}/"
+            f"server-type?typename={server_type}"
+        )
         self.make_request("POST", url)
 
         def clear_server_type(self, server_name: str = None) -> None:
-            """ Clears the server type for the given server
+            """Clears the server type for the given server
 
             Parameters
             ----------
@@ -835,11 +1086,13 @@ class FullServerConfig(Client):
             """
             if server_name is None:
                 server_name = self.server_name
-            url = f"{self.admin_command_root}/servers/{server_name}/server-type?typeName="
+            url = f"{self.full_config_command_root}/servers/{server_name}/server-type?typeName="
             self.make_request("POST", url)
 
-    def config_view_service(self, service_url_marker: str, view_service_body: dict, server_name: str = None) -> None:
-        """ Configure a the view service specified by the service_url_marker using the view_service_body.
+    def config_view_service(
+        self, service_url_marker: str, view_service_body: dict, server_name: str = None
+    ) -> None:
+        """Configure a the view service specified by the service_url_marker using the view_service_body.
 
         Parameters
         ----------
@@ -851,7 +1104,7 @@ class FullServerConfig(Client):
             The body of the view service request.
 
         server_name : str, optional
-            The name of the server. If not provided, the value of `self.server_name` will be used.
+            The name of the server. If not provided, the value of `self.view_server` will be used.
 
         Returns
         -------
@@ -878,11 +1131,14 @@ class FullServerConfig(Client):
             server_name = self.server_name
         validate_name(service_url_marker)
 
-        url = f"{self.admin_command_root}/servers/{server_name}/view-services/{service_url_marker}"
+        url = f"{self.full_config_command_root}/servers/{server_name}/view-services/{service_url_marker}"
         self.make_request("POST", url, view_service_body)
+
     # todo - this may not be used anymore - old
-    def set_view_svcs_config(self, view_svcs_config_body: dict, server_name: str = None) -> None:
-        """ Set up the configuration for all the open metadata integration groups. This overrides the current values.
+    def set_view_svcs_config(
+        self, view_svcs_config_body: dict, server_name: str = None
+    ) -> None:
+        """Set up the configuration for all the open metadata integration groups. This overrides the current values.
 
         Parameters
         ----------
@@ -915,11 +1171,13 @@ class FullServerConfig(Client):
         """
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/view-services/configuration"
+        url = f"{self.full_config_command_root}/servers/{server_name}/view-services/configuration"
         self.make_request("POST", url, view_svcs_config_body)
 
-    def set_integration_groups_config(self, integration_groups_config_body: dict, server_name: str = None) -> None:
-        """ Set up the configuration for all the open metadata integration groups. This overrides the current values.
+    def set_integration_groups_config(
+        self, integration_groups_config_body: dict, server_name: str = None
+    ) -> None:
+        """Set up the configuration for all the open metadata integration groups. This overrides the current values.
         Parameters
         ----------
         integration_groups_config_body : dict
@@ -959,28 +1217,121 @@ class FullServerConfig(Client):
         """
         if server_name is None:
             server_name = self.server_name
-        url = f"{self.admin_command_root}/servers/{server_name}/integration-groups/configuration/all"
+        url = f"{self.full_config_command_root}/servers/{server_name}/integration-groups/configuration/all"
         self.make_request("POST", url, integration_groups_config_body)
 
-    # def set_plug_in_repository_connection_from_provider(self, repository_connection: str, server_name: str = None) -> None:
-    #     if server_name is None:
-    #         server_name = self.server_name
-    #     url = f"{self.admin_command_root}/servers/{server_name}/local-repository/mode/plugin-repository/connection"
-    #     response = self.make_request("POST", url, json= repository_connection)
-    #     related_code = response.json().get("relatedHTTPCode")
-    #     if related_code != 200:
-    #         raise InvalidParameterException(response.content)
-    #     else:
-    #         return
-
-    #
-    #
-    # %% Repository configurations
     def set_engine_host_services(self):
         # handles an array of engine list - pass in JSON
 
         pass
+
     def set_integration_daemon_services_configuration(self):
         # pass a json list
         pass
 
+    def config_integration_service(
+        self,
+        remote_omag_server: str,
+        remote_omag_platform_url: str,
+        service_url_marker: str,
+        integration_service_options: dict,
+        connector_configs: list,
+        server_name: str = None,
+    ) -> None:
+        if server_name is None:
+            server_name = self.server_name
+
+        if not isinstance(connector_configs, list):
+            exc_msg = " ==> connector_configs must be a list of dictionaries"
+            raise Exception(exc_msg)
+
+        validate_name(remote_omag_server)
+        validate_url(remote_omag_platform_url)
+
+        validate_name(service_url_marker)
+
+        request_body = {
+            "class": "IntegrationServiceRequestBody",
+            "omagserverPlatformRootURL": remote_omag_platform_url,
+            "omagserverName": remote_omag_server,
+            "integrationServiceOptions": integration_service_options,
+            "integrationConnectorConfigs": connector_configs,
+        }
+
+        url = f"{self.full_config_command_root}/servers/{server_name}/integration-services/{service_url_marker}"
+        # print(f"URL is : {url}")
+        # print(f"body is : \n{json.dumps(request_body, indent=4)}")
+
+        self.make_request("POST", url, request_body)
+        return
+
+    def config_all_integration_services(
+        self,
+        remote_omag_server: str,
+        remote_omag_platform_url: str,
+        integration_service_options: dict,
+        connector_configs: dict,
+        server_name: str = None,
+    ) -> None:
+        if server_name is None:
+            server_name = self.server_name
+        validate_name(remote_omag_server)
+        validate_url(remote_omag_platform_url)
+
+        request_body = {
+            "IntegrationConnectorConfigs": [
+                {
+                    "class": "IntegrationServiceRequestBody",
+                    "omagserverPlatformRootURL": remote_omag_platform_url,
+                    "omagserverName": remote_omag_server,
+                    "integrationServiceOptions": integration_service_options,
+                    "integrationConnectorConfigs": connector_configs,
+                }
+            ]
+        }
+
+        url = f"{self.full_config_command_root}/servers/{server_name}/integration-services"
+        print(f"URL is : {url}")
+        print(f"body is : \n{json.dumps(request_body, indent=4)}")
+
+        self.make_request("POST", url, request_body)
+
+    def clear_integration_service(
+        self, service_url_marker: str, server_name: str = None
+    ) -> None:
+        if server_name is None:
+            server_name = self.server_name
+        validate_name(service_url_marker)
+
+        url = f"{self.full_config_command_root}/servers/{server_name}/integration-services/{service_url_marker}"
+        self.make_request("DELETE", url)
+
+    def get_integration_service_config(
+        self, service_url_marker: str, server_name: str = None
+    ) -> dict | str:
+        if server_name is None:
+            server_name = self.server_name
+        validate_name(service_url_marker)
+        url = f"{self.full_config_command_root}/servers/{server_name}/integration-services/{service_url_marker}/configuration"
+        response = self.make_request("GET", url)
+        return response.json().get("config", "No configuration found")
+
+    def get_integration_services_configs(self, server_name: str = None) -> dict | str:
+        if server_name is None:
+            server_name = self.server_name
+
+        url = f"{self.full_config_command_root}/servers/{server_name}/integration-services/configuration"
+        response = self.make_request("GET", url)
+        return response.json().get("services", "No configuration found")
+
+    def set_lineage_warehouse_services(self, body: dict, lineage_server: str) -> None:
+        url = f"{self.full_config_command_root}/servers/{lineage_server}/lineage-warehouse/configuration"
+        self.make_request("POST", url, body)
+
+    def remove_lineage_warehouse_services(self, lineage_server: str = None) -> None:
+        url = f"{self.full_config_command_root}/servers/{lineage_server}/lineage-warehouse/configuration"
+        self.make_request("DELETE", url)
+
+
+if __name__ == "__main__":
+    print("Main-Full OMAG Server Config")