Package org.odpi.openmetadata.adminservices.server

Class OMAGServerAdminForEngineHostServices

java.lang.Object
org.odpi.openmetadata.adminservices.server.OMAGServerAdminForEngineHostServices
public class OMAGServerAdminForEngineHostServices extends Object
OMAGServerAdminForEngineServices provides the server-side support for the services that add engine services configuration to an OMAG Server.

  • Constructor Details

    • OMAGServerAdminForEngineHostServices

      public OMAGServerAdminForEngineHostServices()
      Default constructor

  • Method Details

    • setEngineDefinitionsClientConfig

      public VoidResponse setEngineDefinitionsClientConfig(String userId, String serverName, OMAGServerClientConfig clientConfig)
      Set up the name and platform URL root for the metadata server running the Governance Engine OMAS that provides the governance engine definitions used by the engine services.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      clientConfig - URL root and server name for the metadata server.
      Returns:
      void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException unexpected exception or OMAGInvalidParameterException invalid serverName parameter.

    • clearEngineDefinitionsClientConfig

      public VoidResponse clearEngineDefinitionsClientConfig(String userId, String serverName)
      Remove the configuration for the Governance Engine OMAS Engine client configuration in a single call. This overrides the current values.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      Returns:
      void response OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException unexpected exception or OMAGInvalidParameterException invalid serverName parameter.

    • setEngineList

      public VoidResponse setEngineList(String userId, String serverName, List<EngineConfig> engines)
      Set up the list of governance engines that will use the metadata from the same metadata access server as the engine host uses for retrieving the engine configuration.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      engines - list of engines
      Returns:
      void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException unexpected exception or OMAGInvalidParameterException invalid serverName parameter.

    • addEngine

      public VoidResponse addEngine(String userId, String serverName, EngineConfig engine)
      Set up the list of governance engines that will use the metadata from the same metadata access server as the engine host uses for retrieving the engine configuration.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      engine - new engine
      Returns:
      void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException unexpected exception or OMAGInvalidParameterException invalid serverName parameter.

    • clearEngineList

      public VoidResponse clearEngineList(String userId, String serverName)
      Remove the configuration for the governance engines in a single call. This overrides the current values.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      Returns:
      void response OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException unexpected exception or OMAGInvalidParameterException invalid serverName parameter.

    • getEngineServiceConfiguration

      public EngineServiceConfigResponse getEngineServiceConfiguration(String userId, String serverName, String serviceURLMarker)
      Return the configuration for the requested engine service that is configured for this server.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      serviceURLMarker - engine service name used in URL
      Returns:
      void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGInvalidParameterException invalid serverName or serviceURLMarker parameter.

    • getConfiguredEngineServices

      public RegisteredOMAGServicesResponse getConfiguredEngineServices(String userId, String serverName)
      Return the list of engine services that are configured for this server. If you want to see the configuration for these services, use the getEngineHostServicesConfiguration.
      Parameters:
      userId - calling user
      serverName - name of server
      Returns:
      list of engine service descriptions

    • configureEngineService

      public VoidResponse configureEngineService(String userId, String serverName, String serviceURLMarker, EngineServiceRequestBody requestBody)
      Enable a single registered engine service. This builds the engine service configuration for the server's config document.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      serviceURLMarker - engine service name used in URL
      requestBody - minimum values to configure an engine service
      Returns:
      void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException the event bus has not been configured or OMAGInvalidParameterException invalid serverName parameter.

    • configureAllEngineServices

      public VoidResponse configureAllEngineServices(String userId, String serverName, EngineServiceRequestBody requestBody)
      Enable all non-deprecated engine services. This builds the engine service configuration for the server's config document.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      requestBody - minimum values to configure an engine service
      Returns:
      void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException the event bus has not been configured or OMAGInvalidParameterException invalid serverName parameter.

    • configureEngineService

      public VoidResponse configureEngineService(String userId, String serverName, EngineServiceConfig serviceConfig)
      Add configuration for a single engine service to the server's config document.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      serviceConfig - all values to configure an engine service
      Returns:
      void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException the event bus has not been configured or OMAGInvalidParameterException invalid serverName parameter.

    • setEngineServicesConfig

      public VoidResponse setEngineServicesConfig(String userId, String serverName, List<EngineServiceConfig> engineServicesConfig)
      Set up the configuration for all the open metadata engine services (OMESs). This overrides the current values.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      engineServicesConfig - list of configuration properties for each engine service.
      Returns:
      void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGInvalidParameterException invalid serverName or engineServicesConfig parameter.

    • clearAllEngineServices

      public VoidResponse clearAllEngineServices(String userId, String serverName)
      Disable the engine services. This removes all configuration for the engine services and disables the enterprise repository services.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      Returns:
      void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGInvalidParameterException invalid serverName parameter.

    • clearEngineService

      public VoidResponse clearEngineService(String userId, String serverName, String serviceURLMarker)
      Remove an engine service. This removes all configuration for the engine service.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      serviceURLMarker - engine service name used in URL
      Returns:
      void response or OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGInvalidParameterException invalid serverName parameter.

    • getEngineHostServicesConfiguration

      public EngineHostServicesResponse getEngineHostServicesConfiguration(String userId, String serverName)
      Return the engine host services configuration including the list of engine services that are configured for this server.
      Parameters:
      userId - calling user
      serverName - name of server
      Returns:
      engine host services configuration

    • setEngineHostServicesConfig

      public VoidResponse setEngineHostServicesConfig(String userId, String serverName, EngineHostServicesConfig servicesConfig)
      Set up the configuration for an Engine Host OMAG Server in a single call. This overrides the current values.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      servicesConfig - full configuration for the engine host server.
      Returns:
      void response OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException unexpected exception or OMAGInvalidParameterException invalid serverName parameter.

    • clearEngineHostServicesConfig

      public VoidResponse clearEngineHostServicesConfig(String userId, String serverName)
      Remove the configuration for an Engine Host OMAG Server in a single call. This overrides the current values.
      Parameters:
      userId - user that is issuing the request.
      serverName - local server name.
      Returns:
      void response OMAGNotAuthorizedException the supplied userId is not authorized to issue this command or OMAGConfigurationErrorException unexpected exception or OMAGInvalidParameterException invalid serverName parameter.