From b131e73dccfcdfe3ba2d4e60043983b59bf89073 Mon Sep 17 00:00:00 2001 From: Mandy Chessell Date: Mon, 31 Jul 2023 13:24:22 +0100 Subject: [PATCH] Update servers and assets Signed-off-by: Mandy Chessell --- .../types/0/0042-Software-Capabilities.md | 19 +++++++---------- site/docs/types/0/0045-Servers-and-Assets.md | 21 +++++++++++++++++-- site/docs/types/2/area-2-assets.drawio | 14 ++++++------- 3 files changed, 34 insertions(+), 20 deletions(-) diff --git a/site/docs/types/0/0042-Software-Capabilities.md b/site/docs/types/0/0042-Software-Capabilities.md index 3a03cbd1d3..d47a034508 100644 --- a/site/docs/types/0/0042-Software-Capabilities.md +++ b/site/docs/types/0/0042-Software-Capabilities.md @@ -3,9 +3,11 @@ # 0042 Software Capabilities +Software capabilities are the capabilities implemented in software and supported by [ITInfrastructure](/types/0/0030-Hosts-and-Platforms) such as hosts, software server platforms and software servers. They are composed of, support and/or consume various [digital resources](/concepts/resources) represented as [Asset entities](/types/0/0010-Base-Model). They are linked together using the [ServerAssetUse relationship](/types/0045-Servers-and-Assets). + ![UML](0042-Software-Capabilities.svg) -## SoftwareCapability +## SoftwareCapability entity [*IT Infrastructure*](/types/0/0030-Hosts-and-Platforms) contains many capabilities. Each capability can be catalogued using the *SoftwareCapability* entity and linked to the hosting *ITInfrastructure* entity using the *SupportedSoftwareCapability* relationship. @@ -49,20 +51,15 @@ In addition, it is possible to augment software capabilities with the following - [*FileManager*](/types/0/0056-Resource-Managers/#filemanager) - A manager of a collection of files and folders. - [*NotificationManager*](/types/0/0056-Resource-Managers/#notificationmanager) - A software capability that is distributing events from a topic to its subscriber list. -## SupportedSoftwareCapability - -Defines the relationship between a *SoftwareCapability* and the *ITInfrastructure* asset that hosts it. - -## ProcessingState - -Defines a classification for a *SoftwareCapability*. The *ProcessingState* can be used to describe additional runtime processing information used by various SoftwareCapabilities. +## SupportedSoftwareCapability relationship +Defines the relationship between a *SoftwareCapability* and the *ITInfrastructure* entity that hosts it. This relationship, plus the attached *SoftwareCapability* entity, help to build out a picture of the capabilities of a particular deployed host, software server platform or software server. Together they help to describe where and how various IT capabilities are delivered to the owning organization. This model can form the basis of traceability from business function to IT Infrastructure, particularly when combined with [location information](/types/0/0025-Locations) and [links to the data assets and APIs](/types/0/0045-Servers-and-Assets). -## ProcessingState +## ProcessingState classification -Defines a classification for a `SoftwareCapability`. It stores the last sync timestamp for critical elements. +Defines a classification for a *SoftwareCapability*. The *ProcessingState* can be used to describe additional runtime processing information used by the component represented by the *SoftwareCapability* entity. ??? deprecated "Deprecated types" - - *SoftwareServerSupportedCapability* is deprecated in favor of *SupportedSoftwareCapability*. + - *SoftwareServerSupportedCapability* is deprecated in favour of the *SupportedSoftwareCapability* relationship. --8<-- "snippets/abbr.md" diff --git a/site/docs/types/0/0045-Servers-and-Assets.md b/site/docs/types/0/0045-Servers-and-Assets.md index 6857fbcb46..cb424b3b0a 100644 --- a/site/docs/types/0/0045-Servers-and-Assets.md +++ b/site/docs/types/0/0045-Servers-and-Assets.md @@ -3,10 +3,27 @@ # 0045 Servers and Assets +Many data catalogs capture information about data stores, data sets, APIs and topics. These [digital resources](/concepts/resource) provide access to data and reusable function which is why they are of interest. These resources run on IT infrastructure. + ![UML](0045-Servers-and-Assets.svg) -## ServerAssetUse +## ServerAssetUseType enumeration + +The *ServerAssetUseType* describes the different types of dependencies that a software capability has on an asset. + +* *OWNS* means that the asset is hosted and controlled by the software capability. For example, a database server OWNS the databases deployed to it. +* *GOVERNS* means the the asset is monitored and action is taken if the asset moves out of certain boundaries or thresholds. For example, an archiving service GOVERNS a database by removing records that are past a certain date. +* *MAINTAINS* means that although the software capability does not host the asset, it is responsible for maintaining its contents. For example, an application may store its data in a database running on a remote database server. The application MAINTAINS the database. +* *USES* means that the software capability is a consumer of the asset. For example, an analytical service may read the data in a database to feed an algorithm. The analytical service USES the database. +* *OTHER* means there is another type of dependency between the software capability and the asset. + +## ServerAssetUse relationship + +[Assets](/types/0/0010-Base-Model/#asset) are managed or consumed by [SoftwareCapabilities](/types/0/0042-Software-Capabilities/#softwarecapability), which is captured by the *ServerAssetUse* relationship. The properties characterize the relationship: -[`Asset`s](/types/0/0010-Base-Model/#asset) are managed or consumed by [`SoftwareCapabilities`](/types/0/0042-Software-Capabilities/#softwarecapability), which is captured by the *`ServerAssetUse`* relationship. +* *useType* defines how the software capability depends on the asset as defined by the *SoftwareAssetUseType* enumeration. +* *description* provides a description of the use of the asset by the software capability. +* *minimumInstances* defines the minimum number of instances of the asset connected to the software capability. +* *maximumInstances* defines the maximum number of instances of the asset connected to the software capability. --8<-- "snippets/abbr.md" diff --git a/site/docs/types/2/area-2-assets.drawio b/site/docs/types/2/area-2-assets.drawio index 8c6aa902b8..5087ecc3b4 100644 --- a/site/docs/types/2/area-2-assets.drawio +++ b/site/docs/types/2/area-2-assets.drawio @@ -1,4 +1,4 @@ - + @@ -1016,7 +1016,7 @@ - + @@ -1137,7 +1137,7 @@ - + @@ -1181,16 +1181,16 @@ - + - + - + - +