Class ITInfrastructureHandler<B>


  • public class ITInfrastructureHandler<B>
    extends AssetHandler<B>
    OperatingPlatformHandler provides the exchange of metadata about hosts, software server platforms and software servers between the repository and the OMAS.
    • Constructor Detail

      • ITInfrastructureHandler

        public ITInfrastructureHandler​(OpenMetadataAPIGenericConverter<B> converter,
                                       Class<B> beanClass,
                                       String serviceName,
                                       String serverName,
                                       InvalidParameterHandler invalidParameterHandler,
                                       RepositoryHandler repositoryHandler,
                                       OMRSRepositoryHelper repositoryHelper,
                                       String localServerUserId,
                                       OpenMetadataServerSecurityVerifier securityVerifier,
                                       List<String> supportedZones,
                                       List<String> defaultZones,
                                       List<String> publishZones,
                                       AuditLog auditLog)
        Construct the operating platform handler with information needed to work with B objects.
        Parameters:
        converter - specific converter for this bean class
        beanClass - name of bean class that is represented by the generic class B
        serviceName - name of this service
        serverName - name of the local server
        invalidParameterHandler - handler for managing parameter errors
        repositoryHandler - manages calls to the repository services
        repositoryHelper - provides utilities for manipulating the repository services objects
        localServerUserId - userId for this server
        securityVerifier - open metadata security services verifier
        supportedZones - list of operating platforms that the access service is allowed to serve B instances from.
        defaultZones - list of operating platforms that the access service should set in all new B instances.
        publishZones - list of operating platforms that the access service sets up in published B instances.
        auditLog - destination for audit log events.
    • Method Detail

      • setupHostClusterMember

        public void setupHostClusterMember​(String userId,
                                           String externalSourceGUID,
                                           String externalSourceName,
                                           String hostClusterGUID,
                                           String hostClusterGUIDParameterName,
                                           String hostGUID,
                                           String hostGUIDParameterName,
                                           String methodName)
                                    throws InvalidParameterException,
                                           UserNotAuthorizedException,
                                           PropertyServerException
        Create a relationship between a host cluster and a host.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        hostClusterGUID - unique identifier of the host cluster
        hostClusterGUIDParameterName - parameter supplying the hostClusterGUID
        hostGUID - unique identifier of the member host
        hostGUIDParameterName - parameter supplying the hostGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • clearHostClusterMember

        public void clearHostClusterMember​(String userId,
                                           String externalSourceGUID,
                                           String externalSourceName,
                                           String hostClusterGUID,
                                           String hostClusterGUIDParameterName,
                                           String hostGUID,
                                           String hostGUIDParameterName,
                                           String methodName)
                                    throws InvalidParameterException,
                                           UserNotAuthorizedException,
                                           PropertyServerException
        Remove a relationship between a host cluster and a host member.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        hostClusterGUID - unique identifier of the host cluster
        hostClusterGUIDParameterName - parameter supplying the hostClusterGUID
        hostGUID - unique identifier of the member host
        hostGUIDParameterName - parameter supplying the hostGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • setupHostDeployedVirtualContainer

        public void setupHostDeployedVirtualContainer​(String userId,
                                                      String externalSourceGUID,
                                                      String externalSourceName,
                                                      String hostGUID,
                                                      String hostGUIDParameterName,
                                                      String virtualContainerGUID,
                                                      String virtualContainerGUIDParameterName,
                                                      String methodName)
                                               throws InvalidParameterException,
                                                      UserNotAuthorizedException,
                                                      PropertyServerException
        Create a relationship between a host cluster and a host.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        hostGUID - unique identifier of the host
        hostGUIDParameterName - parameter supplying the hostGUID
        virtualContainerGUID - unique identifier of the virtual container deployed on the host
        virtualContainerGUIDParameterName - parameter supplying the virtualContainerGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • clearHostDeployedVirtualContainer

        public void clearHostDeployedVirtualContainer​(String userId,
                                                      String externalSourceGUID,
                                                      String externalSourceName,
                                                      String hostGUID,
                                                      String hostGUIDParameterName,
                                                      String virtualContainerGUID,
                                                      String virtualContainerGUIDParameterName,
                                                      String methodName)
                                               throws InvalidParameterException,
                                                      UserNotAuthorizedException,
                                                      PropertyServerException
        Remove a relationship between a host cluster and a host member.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        hostGUID - unique identifier of the host
        hostGUIDParameterName - parameter supplying the virtualContainerGUID
        virtualContainerGUID - unique identifier of the virtual container deployed on the host
        virtualContainerGUIDParameterName - parameter supplying the virtualContainerGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • setupSoftwareServerPlatformDeployment

        public void setupSoftwareServerPlatformDeployment​(String userId,
                                                          String externalSourceGUID,
                                                          String externalSourceName,
                                                          String hostGUID,
                                                          String hostGUIDParameterName,
                                                          String softwareServerPlatformGUID,
                                                          String softwareServerPlatformGUIDParameterName,
                                                          Date deploymentTime,
                                                          String deployer,
                                                          int platformStatus,
                                                          String methodName)
                                                   throws InvalidParameterException,
                                                          UserNotAuthorizedException,
                                                          PropertyServerException
        Create a relationship between a a host and a software server platform.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        hostGUID - unique identifier of the host
        hostGUIDParameterName - parameter supplying the hostGUID
        softwareServerPlatformGUID - unique identifier of the software server platform
        softwareServerPlatformGUIDParameterName - parameter supplying the softwareServerPlatformGUID
        deploymentTime - date/time that the platform was deployed
        deployer - user who issued the deploy command
        platformStatus - operational status of the platform
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • clearSoftwareServerPlatformDeployment

        public void clearSoftwareServerPlatformDeployment​(String userId,
                                                          String externalSourceGUID,
                                                          String externalSourceName,
                                                          String hostGUID,
                                                          String hostGUIDParameterName,
                                                          String softwareServerPlatformGUID,
                                                          String softwareServerPlatformGUIDParameterName,
                                                          String methodName)
                                                   throws InvalidParameterException,
                                                          UserNotAuthorizedException,
                                                          PropertyServerException
        Remove a relationship between a host and a software server platform.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        hostGUID - unique identifier of the host
        hostGUIDParameterName - parameter supplying the hostGUID
        softwareServerPlatformGUID - unique identifier of the software server platform
        softwareServerPlatformGUIDParameterName - parameter supplying the softwareServerPlatformGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • setupSoftwareServerDeployment

        public void setupSoftwareServerDeployment​(String userId,
                                                  String externalSourceGUID,
                                                  String externalSourceName,
                                                  String softwareServerPlatformGUID,
                                                  String softwareServerPlatformGUIDParameterName,
                                                  String softwareServerGUID,
                                                  String softwareServerGUIDParameterName,
                                                  Date deploymentTime,
                                                  String deployer,
                                                  int serverStatus,
                                                  String methodName)
                                           throws InvalidParameterException,
                                                  UserNotAuthorizedException,
                                                  PropertyServerException
        Create a relationship between a software server platform and a software server.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        softwareServerPlatformGUID - unique identifier of the software server platform
        softwareServerPlatformGUIDParameterName - parameter supplying the softwareServerPlatformGUID
        softwareServerGUID - unique identifier of the software server
        softwareServerGUIDParameterName - parameter supplying the softwareServerGUID
        deploymentTime - date/time that the capability was deployed
        deployer - user who issued the deploy command
        serverStatus - operational status of the server
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • clearSoftwareServerDeployment

        public void clearSoftwareServerDeployment​(String userId,
                                                  String externalSourceGUID,
                                                  String externalSourceName,
                                                  String softwareServerPlatformGUID,
                                                  String softwareServerPlatformGUIDParameterName,
                                                  String softwareServerGUID,
                                                  String softwareServerGUIDParameterName,
                                                  String methodName)
                                           throws InvalidParameterException,
                                                  UserNotAuthorizedException,
                                                  PropertyServerException
        Remove a relationship between a software server platform and a software server.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        softwareServerPlatformGUID - unique identifier of the software server platform
        softwareServerPlatformGUIDParameterName - parameter supplying the softwareServerPlatformGUID
        softwareServerGUID - unique identifier of the software server
        softwareServerGUIDParameterName - parameter supplying the softwareServerGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • setupSoftwareServerEndpoint

        public void setupSoftwareServerEndpoint​(String userId,
                                                String externalSourceGUID,
                                                String externalSourceName,
                                                String softwareServerGUID,
                                                String softwareServerGUIDParameterName,
                                                String endpointGUID,
                                                String endpointGUIDParameterName,
                                                String methodName)
                                         throws InvalidParameterException,
                                                UserNotAuthorizedException,
                                                PropertyServerException
        Create a relationship between a software server and one of its endpoints.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        softwareServerGUID - unique identifier of the software server
        softwareServerGUIDParameterName - parameter supplying the softwareServerGUID
        endpointGUID - unique identifier of the endpoint
        endpointGUIDParameterName - parameter supplying the endpointGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • clearSoftwareServerEndpoint

        public void clearSoftwareServerEndpoint​(String userId,
                                                String externalSourceGUID,
                                                String externalSourceName,
                                                String softwareServerGUID,
                                                String softwareServerGUIDParameterName,
                                                String endpointGUID,
                                                String endpointGUIDParameterName,
                                                String methodName)
                                         throws InvalidParameterException,
                                                UserNotAuthorizedException,
                                                PropertyServerException
        Remove a relationship between a software server and one of its endpoints.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        softwareServerGUID - unique identifier of the software server
        softwareServerGUIDParameterName - parameter supplying the softwareServerGUID
        endpointGUID - unique identifier of the endpoint
        endpointGUIDParameterName - parameter supplying the endpointGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • setupSoftwareServerSupportedCapability

        public void setupSoftwareServerSupportedCapability​(String userId,
                                                           String externalSourceGUID,
                                                           String externalSourceName,
                                                           String softwareServerGUID,
                                                           String softwareServerGUIDParameterName,
                                                           String softwareServerCapabilityGUID,
                                                           String softwareServerCapabilityGUIDParameterName,
                                                           Date deploymentTime,
                                                           String deployer,
                                                           int serverCapabilityStatus,
                                                           String methodName)
                                                    throws InvalidParameterException,
                                                           UserNotAuthorizedException,
                                                           PropertyServerException
        Create a relationship between a software server and a software server capability.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        softwareServerGUID - unique identifier of the software server
        softwareServerGUIDParameterName - parameter supplying the softwareServerGUID
        softwareServerCapabilityGUID - unique identifier of the software server capability
        softwareServerCapabilityGUIDParameterName - parameter supplying the softwareServerCapabilityGUID
        deploymentTime - date/time that the capability was deployed
        deployer - user who issued the deploy command
        serverCapabilityStatus - operational status of the capability
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • clearSoftwareServerSupportedCapability

        public void clearSoftwareServerSupportedCapability​(String userId,
                                                           String externalSourceGUID,
                                                           String externalSourceName,
                                                           String softwareServerGUID,
                                                           String softwareServerGUIDParameterName,
                                                           String softwareServerCapabilityGUID,
                                                           String softwareServerCapabilityGUIDParameterName,
                                                           String methodName)
                                                    throws InvalidParameterException,
                                                           UserNotAuthorizedException,
                                                           PropertyServerException
        Remove a relationship between a software server and a software server capability.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        softwareServerGUID - unique identifier of the software server
        softwareServerGUIDParameterName - parameter supplying the softwareServerGUID
        softwareServerCapabilityGUID - unique identifier of the software server capability
        softwareServerCapabilityGUIDParameterName - parameter supplying the softwareServerCapabilityGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • setupSoftwareServerCapabilityAssetUse

        public void setupSoftwareServerCapabilityAssetUse​(String userId,
                                                          String externalSourceGUID,
                                                          String externalSourceName,
                                                          String softwareServerCapabilityGUID,
                                                          String softwareServerCapabilityGUIDParameterName,
                                                          String assetGUID,
                                                          String assetGUIDParameterName,
                                                          String description,
                                                          int useType,
                                                          String methodName)
                                                   throws InvalidParameterException,
                                                          UserNotAuthorizedException,
                                                          PropertyServerException
        Create a relationship between a software server capability and an asset.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        softwareServerCapabilityGUID - unique identifier of the software server capability
        softwareServerCapabilityGUIDParameterName - parameter supplying the softwareServerCapabilityGUID
        assetGUID - unique identifier of the asset
        assetGUIDParameterName - parameter supplying the assetGUID
        description - description of the use
        useType - server asset use type
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • clearSoftwareServerCapabilityAssetUse

        public void clearSoftwareServerCapabilityAssetUse​(String userId,
                                                          String externalSourceGUID,
                                                          String externalSourceName,
                                                          String softwareServerCapabilityGUID,
                                                          String softwareServerCapabilityGUIDParameterName,
                                                          String assetGUID,
                                                          String assetGUIDParameterName,
                                                          String methodName)
                                                   throws InvalidParameterException,
                                                          UserNotAuthorizedException,
                                                          PropertyServerException
        Remove a relationship between a software server and a software server capability.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        softwareServerCapabilityGUID - unique identifier of the software server capability
        softwareServerCapabilityGUIDParameterName - parameter supplying the assetGUID
        assetGUID - unique identifier of the asset
        assetGUIDParameterName - parameter supplying the assetGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • setupHostNetwork

        public void setupHostNetwork​(String userId,
                                     String externalSourceGUID,
                                     String externalSourceName,
                                     String hostGUID,
                                     String hostGUIDParameterName,
                                     String networkGUID,
                                     String networkGUIDParameterName,
                                     String methodName)
                              throws InvalidParameterException,
                                     UserNotAuthorizedException,
                                     PropertyServerException
        Create a relationship between a host and a network.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        hostGUID - unique identifier of the host
        hostGUIDParameterName - parameter supplying the hostGUID
        networkGUID - unique identifier of the network
        networkGUIDParameterName - parameter supplying the networkGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • clearHostNetwork

        public void clearHostNetwork​(String userId,
                                     String externalSourceGUID,
                                     String externalSourceName,
                                     String hostGUID,
                                     String hostGUIDParameterName,
                                     String networkGUID,
                                     String networkGUIDParameterName,
                                     String methodName)
                              throws InvalidParameterException,
                                     UserNotAuthorizedException,
                                     PropertyServerException
        Remove a relationship between a a host and a network.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        hostGUID - unique identifier of the host
        hostGUIDParameterName - parameter supplying the hostGUID
        networkGUID - unique identifier of the network
        networkGUIDParameterName - parameter supplying the networkGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • setupNetworkGatewayLink

        public void setupNetworkGatewayLink​(String userId,
                                            String externalSourceGUID,
                                            String externalSourceName,
                                            String networkGatewayGUID,
                                            String networkGatewayGUIDParameterName,
                                            String networkGUID,
                                            String networkGUIDParameterName,
                                            String methodName)
                                     throws InvalidParameterException,
                                            UserNotAuthorizedException,
                                            PropertyServerException
        Create a relationship between a network gateway and the network it connects to.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        networkGatewayGUID - unique identifier of the network gateway
        networkGatewayGUIDParameterName - parameter supplying the networkGatewayGUID
        networkGUID - unique identifier of the network
        networkGUIDParameterName - parameter supplying the networkGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)
      • clearNetworkGatewayLink

        public void clearNetworkGatewayLink​(String userId,
                                            String externalSourceGUID,
                                            String externalSourceName,
                                            String networkGatewayGUID,
                                            String networkGatewayGUIDParameterName,
                                            String networkGUID,
                                            String networkGUIDParameterName,
                                            String methodName)
                                     throws InvalidParameterException,
                                            UserNotAuthorizedException,
                                            PropertyServerException
        Remove a relationship between a network gateway and the network it connects to.
        Parameters:
        userId - calling user
        externalSourceGUID - guid of the software server capability entity that represented the external source - null for local
        externalSourceName - name of the software server capability entity that represented the external source
        networkGatewayGUID - unique identifier of the network gateway
        networkGatewayGUIDParameterName - parameter supplying the networkGatewayGUID
        networkGUID - unique identifier of the network
        networkGUIDParameterName - parameter supplying the networkGUID
        methodName - calling method
        Throws:
        InvalidParameterException - one of the parameters is invalid
        UserNotAuthorizedException - the user is not authorized to issue this request
        PropertyServerException - there is a problem reported in the open metadata server(s)