Package org.odpi.openmetadata.adminservices.client

Class OMAGServerPlatformConfigurationClient

java.lang.Object

org.odpi.openmetadata.adminservices.client.OMAGServerPlatformConfigurationClient

public class OMAGServerPlatformConfigurationClient
extends Object

OMAGServerPlatformConfigurationClient provides services to configure an OMAG Server Platform. There are two aspects to this. Firstly setting up the connector for the configuration document store. Then secondly, configuring the platform security connector.

Constructor Summary

Constructors

Constructor	Description
OMAGServerPlatformConfigurationClient(String adminUserId, String serverPlatformRootURL)	Create a new client with no authentication embedded in the HTTP request.
OMAGServerPlatformConfigurationClient(String adminUserId, String serverPlatformRootURL, String connectionUserId, String connectionPassword)	Create a new client that passes a connection userId and password in each HTTP request.

Method Summary

Modifier and Type	Method	Description
void	clearConfigurationStoreConnection()	Clear the connection object for the configuration store which means the platform uses the default store.
void	clearDefaultServerConfig()	Clear the default configuration document.
void	clearPlatformSecurityConnection()	Deprecated.
Set<org.odpi.openmetadata.adminservices.configuration.properties.OMAGServerConfig>	getAllServerConfigurations()	Return all the OMAG Server configurations that are stored on this platform
org.odpi.openmetadata.frameworks.connectors.properties.beans.Connection	getConfigurationStoreConnection()	Return the connection object for the configuration store.
org.odpi.openmetadata.adminservices.configuration.properties.OMAGServerConfig	getDefaultOMAGServerConfig()	Return the default server configuration document.
org.odpi.openmetadata.frameworks.connectors.properties.beans.Connection	getPlatformSecurityConnection()	Deprecated.
void	setConfigurationStoreConnection(org.odpi.openmetadata.frameworks.connectors.properties.beans.Connection connection)	Override the default implementation or configuration of the configuration document store.
void	setDefaultOMAGServerConfig(org.odpi.openmetadata.adminservices.configuration.properties.OMAGServerConfig defaultServerConfig)	Override the default server configuration document.
void	setPlatformSecurityConnection(org.odpi.openmetadata.frameworks.connectors.properties.beans.Connection connection)	Deprecated.

Methods inherited from class java.lang.Object

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

Constructor Details

OMAGServerPlatformConfigurationClient

public OMAGServerPlatformConfigurationClient(String adminUserId,
 String serverPlatformRootURL)
                                      throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException

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

Parameters:

adminUserId - administrator's (end user's) userId to associate with calls.

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

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

OMAGServerPlatformConfigurationClient

public OMAGServerPlatformConfigurationClient(String adminUserId,
 String serverPlatformRootURL,
 String connectionUserId,
 String connectionPassword)
                                      throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException

Create a new client that passes a connection userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is passed as the admin userId.

Parameters:

adminUserId - administrator's (end user's) userId to associate with calls.

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

connectionUserId - caller's system userId embedded in all HTTP requests

connectionPassword - caller's system password embedded in all HTTP requests

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

Method Details

setDefaultOMAGServerConfig

public void setDefaultOMAGServerConfig(org.odpi.openmetadata.adminservices.configuration.properties.OMAGServerConfig defaultServerConfig)
                                throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException

Override the default server configuration document.

Parameters:

defaultServerConfig - values to include in every new configured server.

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.

getDefaultOMAGServerConfig

public org.odpi.openmetadata.adminservices.configuration.properties.OMAGServerConfig getDefaultOMAGServerConfig()
                                                                                                         throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException

Return the default server configuration document.

Returns:

connection response

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.

clearDefaultServerConfig

public void clearDefaultServerConfig()
                              throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException

Clear the default configuration document.

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.

setConfigurationStoreConnection

public void setConfigurationStoreConnection(org.odpi.openmetadata.frameworks.connectors.properties.beans.Connection connection)
                                     throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException

Override the default implementation or configuration of the configuration document store.

Parameters:

connection - connection object that defines the configuration document store

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.

clearConfigurationStoreConnection

public void clearConfigurationStoreConnection()
                                       throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException

Clear the connection object for the configuration store which means the platform uses the default store.

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.

getConfigurationStoreConnection

public org.odpi.openmetadata.frameworks.connectors.properties.beans.Connection getConfigurationStoreConnection()
                                                                                                        throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException

Return the connection object for the configuration store. Null is returned if the server is using the default store with the default configuration.

Returns:

Platform security connection

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.

setPlatformSecurityConnection

@Deprecated
public void setPlatformSecurityConnection(org.odpi.openmetadata.frameworks.connectors.properties.beans.Connection connection)
                                   throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException

Deprecated.

Set up a platform security connector. This connector provides additional authorization checks on API requests to the platform.

Parameters:

connection - connection object that defines the platform security connector

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.

clearPlatformSecurityConnection

@Deprecated
public void clearPlatformSecurityConnection()
                                     throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException

Deprecated.

Clear the connection object for platform security. This means there is no platform security set up and there will be no authorization checks within the platform. All security will have to come from the surrounding deployment environment. This is the default state.

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.

getPlatformSecurityConnection

@Deprecated
public org.odpi.openmetadata.frameworks.connectors.properties.beans.Connection getPlatformSecurityConnection()
                                                                                                      throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException

Deprecated.

Return the connection object for platform security connector. Null is returned if no platform security has been set up.

Returns:

Platform security connection

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.

getAllServerConfigurations

public Set<org.odpi.openmetadata.adminservices.configuration.properties.OMAGServerConfig> getAllServerConfigurations()
                                                                                                              throws org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException,
org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException

Return all the OMAG Server configurations that are stored on this platform

Returns:

the OMAG Server configurations that are stored on this platform

Throws:

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGNotAuthorizedException - the supplied userId is not authorized to issue this command.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGInvalidParameterException - invalid parameter.

org.odpi.openmetadata.adminservices.ffdc.exception.OMAGConfigurationErrorException - unusual state in the admin server.