Package org.odpi.openmetadata.adminservices.client

Class MetadataAccessServerConfigurationClient

java.lang.Object

org.odpi.openmetadata.adminservices.client.OMAGServerConfigurationClient

org.odpi.openmetadata.adminservices.client.CohortMemberConfigurationClient

org.odpi.openmetadata.adminservices.client.MetadataAccessServerConfigurationClient

Direct Known Subclasses:

MetadataAccessPointConfigurationClient, MetadataAccessStoreConfigurationClient

public class MetadataAccessServerConfigurationClient
extends CohortMemberConfigurationClient

MetadataAccessServerConfigurationClient configures a MetadataAccessServer OMAG Server. This server can become a cohort member and, through the access services, offers a wide range of specialist APIs and event streams to access and store metadata.

Field Summary

Fields inherited from class org.odpi.openmetadata.adminservices.client.OMAGServerConfigurationClient

invalidParameterHandler, nullRequestBody, restClient, serverName, serverPlatformRootURL

Constructor Summary

Constructors

Constructor	Description
MetadataAccessServerConfigurationClient(String serverName, String serverPlatformRootURL, String secretStoreProvider, String secretStoreLocation, String secretStoreCollection, AuditLog auditLog)	Create a new client with no authentication embedded in the HTTP request.

Method Summary

Modifier and Type	Method	Description
void	addRemoteEnterpriseTopic(Map<String,Object> configurationProperties)	Set up the default remote enterprise topic.
void	clearAllAccessServices()	Disable the access services.
void	configureAccessService(String serviceURLMarker)	Enable a single access service.
void	configureAccessService(String serviceURLMarker, Map<String,Object> accessServiceOptions)	Enable a single access service.
void	configureAccessServiceNoTopics(String serviceURLMarker)	Enable a single access service without the In and Out topic.
void	configureAccessServiceNoTopics(String serviceURLMarker, Map<String,Object> accessServiceOptions)	Enable a single access service without the In and Out topic.
void	configureAllAccessServices(Map<String,Object> accessServiceOptions)	Enable all access services that are registered into this server.
void	configureAllAccessServicesNoTopics(Map<String,Object> accessServiceOptions)	Enable all access services that are registered into this server without the in and out topics activated.
void	disableAccessService(String serviceURLMarker)	Disable a single access service.
List<AccessServiceConfig>	getAccessServicesConfiguration()	Return the configuration for the access services in this server.
Map<String,String>	getAccessServiceTopicNames(String serviceURLMarker)	Retrieve the topic names for this access service
Map<String,String>	getAllAccessServiceTopicNames()	Retrieve the topic names for all configured access service
List<RegisteredOMAGService>	getConfiguredAccessServices()	Return the list of access services that are configured for this server.
List<RegisteredOMAGService>	getRegisteredAccessServices()	Return the list of access services for this server.
void	overrideAccessServiceOutTopic(String serviceURLMarker, String topicName)	Override the topic name for the in topic of a single access service.
void	setAccessServicesConfig(List<AccessServiceConfig> accessServicesConfig)	Set up the configuration for all the open metadata access services (OMASs).
void	setEnterpriseAccessConfig(EnterpriseAccessConfig enterpriseAccessConfig)	Set up the configuration that controls the enterprise repository services.

Methods inherited from class org.odpi.openmetadata.adminservices.client.CohortMemberConfigurationClient

addCohortRegistration, addCohortRegistration, addStartUpOpenMetadataArchiveFile, addStartUpOpenMetadataArchiveList, clearCohortRegistration, clearLocalRepository, clearOpenMetadataArchives, getCohortTopicName, getDedicatedCohortTopicNames, getLocalMetadataCollectionId, getLocalMetadataCollectionName, overrideCohortTopicName, overrideInstancesCohortTopicName, overrideRegistrationCohortTopicName, overrideTypesCohortTopicName, resetRemoteCohortURL, setCohortConfig, setLocalMetadataCollectionId, setLocalMetadataCollectionName, setLocalRepositoryConfig

Methods inherited from class org.odpi.openmetadata.adminservices.client.OMAGServerConfigurationClient

addAuditLogDestination, addConsoleAuditLogDestination, addEventTopicAuditLogDestination, addEventTopicAuditLogDestination, addFileAuditLogDestination, addFileAuditLogDestination, addJDBCAuditLogDestination, addSLF4JAuditLogDestination, clearAuditLogDestination, clearAuditLogDestinations, clearOMAGServerConfig, clearServerSecurityConnection, deployOMAGServerConfig, getBasicServerProperties, getOMAGServerConfig, getOMAGServerInstanceConfig, getServerSecurityConnection, getServerTypeClassification, setAuditLogDestinations, setBasicServerProperties, setDefaultAuditLog, setEventBus, setMaxPageSize, setOMAGServerConfig, setOrganizationName, setServerDescription, setServerSecurityConnection, setServerType, setServerURLRoot, setServerUserId, updateAuditLogDestination

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

MetadataAccessServerConfigurationClient

public MetadataAccessServerConfigurationClient(String serverName,
 String serverPlatformRootURL,
 String secretStoreProvider,
 String secretStoreLocation,
 String secretStoreCollection,
 AuditLog auditLog)
                                        throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

serverPlatformRootURL - the network address of the server running the admin services

secretStoreProvider - class name of the secrets store

secretStoreLocation - location (networkAddress) of the secrets store

secretStoreCollection - name of the collection of secrets to use to connect to the remote server

auditLog - destination for log messages.

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

Method Details

getRegisteredAccessServices

public List<RegisteredOMAGService> getRegisteredAccessServices()
                                                        throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Return the list of access services for this server.

Returns:

list of access service descriptions

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

getConfiguredAccessServices

public List<RegisteredOMAGService> getConfiguredAccessServices()
                                                        throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Return the list of access services that are configured for this server.

Returns:

list of access service descriptions

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

getAccessServicesConfiguration

public List<AccessServiceConfig> getAccessServicesConfiguration()
                                                         throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Return the configuration for the access services in this server.

Returns:

list of access service configuration

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

configureAccessService

public void configureAccessService(String serviceURLMarker)
                            throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Enable a single access service.

Parameters:

serviceURLMarker - string indicating which access service it is configuring

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

disableAccessService

public void disableAccessService(String serviceURLMarker)
                          throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Disable a single access service.

Parameters:

serviceURLMarker - string indicating which access service it is disabling

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

configureAccessService

public void configureAccessService(String serviceURLMarker,
 Map<String,Object> accessServiceOptions)
                            throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Enable a single access service.

Parameters:

serviceURLMarker - string indicating which access service it is configuring

accessServiceOptions - property name/value pairs used to configure the access service

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

configureAccessServiceNoTopics

public void configureAccessServiceNoTopics(String serviceURLMarker)
                                    throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Enable a single access service without the In and Out topic.

Parameters:

serviceURLMarker - string indicating which access service it is configuring

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

configureAccessServiceNoTopics

public void configureAccessServiceNoTopics(String serviceURLMarker,
 Map<String,Object> accessServiceOptions)
                                    throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Enable a single access service without the In and Out topic.

Parameters:

serviceURLMarker - string indicating which access service it is configuring

accessServiceOptions - property name/value pairs used to configure the access service

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

configureAllAccessServices

public void configureAllAccessServices(Map<String,Object> accessServiceOptions)
                                throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Enable all access services that are registered into this server. The configuration properties for each access service can be changed from their default using setAccessServicesConfig operation.

Parameters:

accessServiceOptions - property name/value pairs used to configure the access services

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

configureAllAccessServicesNoTopics

public void configureAllAccessServicesNoTopics(Map<String,Object> accessServiceOptions)
                                        throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Enable all access services that are registered into this server without the in and out topics activated. The configuration properties for each access service can be changed from their default using setAccessServicesConfig operation.

Parameters:

accessServiceOptions - property name/value pairs used to configure the access services

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

getAccessServiceTopicNames

public Map<String,String> getAccessServiceTopicNames(String serviceURLMarker)
                                              throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Retrieve the topic names for this access service

Parameters:

serviceURLMarker - string indicating which access service it requested

Returns:

map of topic names to descriptions

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

getAllAccessServiceTopicNames

public Map<String,String> getAllAccessServiceTopicNames()
                                                 throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Retrieve the topic names for all configured access service

Returns:

map of topic names to descriptions

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

overrideAccessServiceOutTopic

public void overrideAccessServiceOutTopic(String serviceURLMarker,
 String topicName)
                                   throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Override the topic name for the in topic of a single access service.

Parameters:

serviceURLMarker - string indicating which access service it is configuring

topicName - new topic name

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

clearAllAccessServices

public void clearAllAccessServices()
                            throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Disable the access services. This removes all configuration for the access services and disables the enterprise repository services.

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

setAccessServicesConfig

public void setAccessServicesConfig(List<AccessServiceConfig> accessServicesConfig)
                             throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Set up the configuration for all the open metadata access services (OMASs). This overrides the current values.

Parameters:

accessServicesConfig - - list of configuration properties for each access service.

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

addRemoteEnterpriseTopic

public void addRemoteEnterpriseTopic(Map<String,Object> configurationProperties)
                              throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Set up the default remote enterprise topic. This allows a remote process to monitor enterprise topic events.

Parameters:

configurationProperties - additional properties for the cohort

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.

setEnterpriseAccessConfig

public void setEnterpriseAccessConfig(EnterpriseAccessConfig enterpriseAccessConfig)
                               throws UserNotAuthorizedException,
InvalidParameterException,
OMAGConfigurationErrorException

Set up the configuration that controls the enterprise repository services. These services are part of the Open Metadata Repository Services (OMRS). They provide federated queries and federated event notifications that cover metadata from the local repository plus any repositories connected via open metadata repository cohorts. These services are configured automatically when the access services are enabled and so this call is not normally needed unless the default settings for the enterprise access services are not sufficient.

Parameters:

enterpriseAccessConfig - - enterprise repository services configuration properties.

Throws:

UserNotAuthorizedException - the supplied userId is not authorized to issue this command.

InvalidParameterException - invalid parameter.

OMAGConfigurationErrorException - unusual state in the admin server.