1. Class Machine (OS server)

    Article: AN0002420Updated: 26.01.2024

    Description

    Machine is the main entity of the system layer of the Configuration database. It records servers and other intengible items that are defined by operating system, not by a physical device.

    ObjectGears Configuration database contains the entity Machine (OS server) which is determined for servers in the intangible meaning and differentiates them from objects recorded in the class Device (Hardware layer). When we start with Configuration database, properties of the both entities may coincide to us. Therefore, you may have in a table with list of servers properties like server name, IP address, operating system, windows domain and together with them also manufacturer, hardware model, serial number, year of production, support end date, inventory number and server location (position in rack, building, location).

    It is useful to separate both categories and better differentiate the server concept. In case of a physical object let`s speak about Device, which has associated properties like manufacturer, model, serial number or inventory number. Server, which has usually an operating system as a key property, will be called Machine (OS server). In the class Machine we are going to keep records of not only physical (native) and virtual servers, but also server farms, clusters, cluster services and other entities.

    Automated data import

    This entity can be filled in automatically by means of infrastructure function OG_Servers.

    Location and referencing

    Location Code Name
    Model it IT
    Class machine Machine (OS server)
    Parent class ci Configuration items
    Child classes    
    Script object OG.ClassDef.GetByCode(OGModel.Id, 'machine')
    OG.ClassDef.GetByCode('it', 'machine')

    Columns

    Overview of class columns (excl. system columns, for inhereted columns see parent classes):

    Code Name Type Link information Description
    administered-by Administered by Class link (simple) Owned by Organization responsible for server maintenance - e.g. with servers leased/operated by vendor.
    allowed-restart Restart during business hours True/untrue   Indicates that the server can be restarted during business hours.
    back-up-dc-ip Back up DC IP Text   Server IP address in the back-up center.
    cl_machine Catalogue request - Machine (OS server) Revers class link (multiple) Requests:Catalogue request
    (revers)
    Automatically created column.
    cl_machine_2 machine_1 - Virtual on Revers class link (multiple) Machine (OS server) - Baseline
    (revers)
    Automatically created column.
    cl_machine_3 machine_1 - Member of farm/cluster Revers class link (multiple) Machine (OS server) - Baseline
    (revers)
    Automatically created column.
    cl_machine_4 machine_1 - Preferred node Revers class link (multiple) Machine (OS server) - Baseline
    (revers)
    Automatically created column.
    cl_machine_5 machine_1 - Current node Revers class link (multiple) Machine (OS server) - Baseline
    (revers)
    Automatically created column.
    cl_machine_6 machine_1 - Failover node Revers class link (multiple) Machine (OS server) - Baseline
    (revers)
    Automatically created column.
    cl-machine Filesystem - Machine (OS server) Revers class link (multiple) Filesystem
    (revers)
    Automatically created column.
    cl-machine-10 Network interfaces - Machine (OS server) Revers class link (multiple) Network interfaces
    (revers)
    Automatically created column.
    cl-machine-11 Routing table - Machine (OS server) Revers class link (multiple) Routing table
    (revers)
    Automatically created column.
    cl-machine-12 Patches on machines (OS server) - Machine (OS server) Revers class link (multiple) Patches on machines (OS server)
    (revers)
    Automatically created column.
    cl-machine-13 Machine (OS server) - Current node Revers class link (multiple) Machine (OS server)
    (revers)
    Automatically created column.
    cl-machine-14 Machine (OS server) - Failover node Revers class link (multiple) Machine (OS server)
    (revers)
    Automatically created column.
    cl-machine-15 Servers - Reference Revers class link (multiple) Mon. & Man.:Servers
    (revers)
    Automatically created column.
    cl-machine-16 Scheduled tasks - Machine (OS server) Revers class link (multiple) Scheduled tasks
    (revers)
    Automatically created column.
    cl-machine-17 Installed applications on machines - Machine (OS server) Revers class link (multiple) Installed applications on machines
    (revers)
    Automatically created column.
    cl-machine-18 Machine (OS server) - IP - Machine (OS server) Revers class link (multiple) Machine (OS server) - IP
    (revers)
    Automatically created column.
    cl-machine-19 PK certificates - Certificate distribution Revers class link (multiple) PK certificates
    (revers)
    Automatically created column.
    cl-machine-2 DB server - Machine (OS server) Revers class link (multiple) DB server
    (revers)
    Automatically created column.
    cl-machine-20 Sevices on machines - Machine (OS server) Revers class link (multiple) Sevices on machines
    (revers)
    Automatically created column.
    cl-machine-21 Machine (OS server) - Back up - Machine (OS server) Revers class link (multiple) Machine (OS server) - Back up
    (revers)
    Automatically created column.
    cl-machine-22 Storage group - Host - Machine (OS server) Revers class link (multiple) Storage group - Host
    (revers)
    Automatically created column.
    cl-machine-3 Machine (OS server) - LUN - Machine (OS server) Revers class link (multiple) Machine (OS server) - LUN
    (revers)
    Automatically created column.
    cl-machine-4 Machine (OS server) - Virtual on Revers class link (multiple) Machine (OS server)
    (revers)
    Automatically created column.
    cl-machine-5 Application components - Machine (OS server) Revers class link (multiple) Application components
    (revers)
    Automatically created column.
    cl-machine-6 Machine (OS server) - Member of farm/cluster Revers class link (multiple) Machine (OS server)
    (revers)
    Automatically created column.
    cl-machine-7 Local groups - Machine (OS server) Revers class link (multiple) Local groups
    (revers)
    Automatically created column.
    cl-machine-8 PK certificates - Machine (OS server) Revers class link (multiple) PK certificates
    (revers)
    Automatically created column.
    cl-machine-9 Machine (OS server) - Preferred node Revers class link (multiple) Machine (OS server)
    (revers)
    Automatically created column.
    current-node Current node Class link (simple) Machine (OS server) Node on which the server is currently running.
    description Description Text   Server description
    dhcp-reservation DHCP reservation True/untrue   Indicates that the server is using DHCP reservation of the IP address.
    dns-name DNS name Text   DNS name of the server.
    environment Environment Class link (simple) Environment Environment, into which the server belongs (e.g. Development, Test, Acceptace, Production).
    failover-node Failover node Class link (simple) Machine (OS server) Node on which the server will be migrated in case of the current node failure.
    ip IP Text   Primary server IP address.
    ip_live_migration IP Live Migration Text   IP adress of the server in the back up center.
    last_import_datetime Last import date and time Date and time   Date and time of the last import that contained the server record.
    last-wsus-sync-time Last WSUS server sync Date and time   Date and time of the last synchronization with Windows System Update Services serverem (WSUS).
    machine_contacts Machine contacts Class link (multiple) User Contacts (users), that responsible for the server or have a stake in its operations.
    machine_group Machine group Class link (simple) Machine group Group of servers into which the server belongs.
    machine-type Machine type Class link (simple) Machine type Type of machine (e.g. server, cluster, cluster service, appliance, workstation, farm...).
    maintenance_window Maintenance window Text   Window in which server maintenance can be performed.
    management_ip Management IP Text   IP address of the remote administration card. It relates to physical (native) servers.
    manual_update Manual update True/untrue   Indicates that the server record is updated manually.
    member-of Member of farm/cluster Class link (simple) Machine (OS server) Farm or cluster, member of which the server is.
    name Name Text   Server name.
    os OS Class link (simple) OS (Operating system) Operating system.
    patch-category Patch category Class link (simple) Patch category Category (group of servers), in which patches are applied to the server.
    physical Physical True/untrue   Device, on which the server is running. It relates to physical (native) servers.
    preferred-node Preferred node Class link (simple) Machine (OS server) Node preferred for the server to run.
    present_in_last_import Present in the last import True/untrue   Indicates whether the server was included in the last import.
    running-on Physical on Class link (simple) Device Device on which the server is running. It is applicable for physical (native) servers.
    san_hostname SAN host name Text   Name of the server in the SAN network.
    security-zone Security zone Class link (simple) Security zone Security zone, into which the server belongs (e.g. Internal network, particular DMZ, Internet).
    status Status Class link (simple) Machine (OS server) status Server status.
    team Team Class link (simple) Requests:Solution team Team to which the server belongs.
    vcpu CPU number Integer   Number of server CPU.
    virtual-on Virtual on Class link (simple) Machine (OS server) Cluster or object of virtualization platform, on which the Machine is running. It relates to cluster services and virtual servers.
    virtual-server-cpu vCPU Text   Number of CPU (physical or virtual) allocated to the server.
    virtual-server-ram vRAM Text   Size of RAM (physical or virtual) allocated to the server.
    vm_name VM name Text   Name of the virtual machine in the virtualization platform (VMware, Hyper-V...).
    vm_notes VM Notes Text   Notes to the server from the virtualization platform.
    vm_provisioned_storage_gb VM Provisoned (GB) Integer   Space provided to server in the virtualization platform (VMware, Hyper-V...).
    vm_used_storage_gb VM Used (GB) Integer   Space used by server in the virtualization platform (VMware, Hyper-V...).
    vram RAM Integer   RAM in GB.
    windows-domain Windows domain Class link (simple) Windows domain Domain to which the server belongs.
    wsus-server WSUS server Text   Windows System Update Services server (WSUS).

    Rules

    Code Event type Action type Order Description
    virtual_physical_new Before new record save Condition 10 Checks if the Server record contains which Device it is running on or which Server it is virtual on.
    virtual_physical_upd Before existing record save Condition 10 Checks if the Server record contains which Device it is running on or which Server it is virtual on.
    check_physical_new Before new record save Start a script 20 Sets the value in column Physical on.
    check_physical_upd Before existing record save Start a script 20 Sets the value in column Physical on.

    Quick filter

    In order users can easily filter the records some columns are selected for a Quick filter.

    Buttons

    Icon Code Name Order Description
    update_baseline Update baseline 10 Updates baseline according to current record.

    Master/detail relations

    Code Column Placement Bookmark name Type
    code_1 Filesystem - Machine (OS server) Below Filesystem Reference to class
    code_2 Application components - Machine (OS server) Below Appl. components Reference to class
    code_3 Local groups - Machine (OS server) Below Local groups Reference to class
    code_4 Scheduled tasks - Machine (OS server) Below Scheduled tasks Reference to class
    code_5 Patches on machines (OS server) - Machine (OS server) Below Patches Reference to class
    code_6 Routing table - Machine (OS server) Below Network Reference to class
    code_8 Network interfaces - Machine (OS server) Below Network Reference to class
    code_136 Machine (OS server) - IP - Machine (OS server) Below Network Reference to class
    code_26 Installed applications on machines - Machine (OS server) Below Installed applications Reference to class
    code_9 Project - Added configuration items Below Projects Reference to class
    code_10 Project - Modified configuration items Below Projects Reference to class
    code_11 Project - Removed configuration items Below Projects Reference to class
    code_38 Task - Affected CI Below Projects Reference to class
    code_54 Work schedule - Affected CI Below Projects Reference to class
    code_12 Incident - Related CI Below Incidents and Problems Reference to class
    code_13 Problem - Related CI Below Incidents and Problems Reference to class
    code_88 Changes - Affected CI Below Changes Reference to class
    code_137 PK certificates - Machine (OS server) Below Certificates Reference to class
    code_138 PK certificates - Certificate distribution Below Certificates Reference to class
    code_157 Configuration items - Is installed on CI (ITIL) Below ITIL relations Reference to class
    code_158 Sevices on machines - Machine (OS server) Below Services Reference to class
    code_192 Technical services - Uses CI Below Supports technical services Reference to class
    code_179 DB server - Machine (OS server) Below Hosting Reference to class
    code_180 Machine (OS server) - Virtual on Below Hosting Reference to class
    code_238 Machine (OS server) - Member of farm/cluster Below Nodes Reference to class
    code_237 Machine (OS server) - Back up - Machine (OS server) Below Back up Reference to class
    code_249 Storage group - Host - Machine (OS server) Below Storage group Reference to class
    code_264 Article - Configuration items Below KB Reference to class
    baseline machine Below Baseline Reference to class
    operations_log Operations log - Impacted machines or machine groups Below Operation log Reference to class


    Potential improvements

    You can improve the solution according to your needs. Here are some tips.

    Add new columns

    Add new columns, if you are going to need them.

    Add buttons

    Add new buttons to automate edits that you would otherwise make one at a time.

×