User's manual V2.0

From OneCMDB

Contents

Introduction

This User´s manual describes functions and features in OneCMDB the way they are accessed/used from the OneCMDB Desktop.

Please note that some functions are described in more detail in other manuals, for example the Administrator's manual V2.0. Also, how to use some functions and how things work are sometimes described in the Tutorial V2.0.

Installation, Un-installation, Startup and Shutdown are described in the Get Started V2.0.

If you like to plunge into using OneCMDB without even reading the User´s manual, have a look at Get Started V2.0#Quick Start, which will give you express guidance how to perform a few basic tasks in the OneCMDB Desktop.

Definitions and terminology

In OneCMDB we use the following terminology.

CMDB Configuration Management Database.

CI Configuration Item. A rather generic name for an item in the CMDB.

Template A master or blueprint for a certain type of CI.

Instance A specific CI, i.e., an instantiation of a Template.

Child A Template or Instance that have inherited its characteristics from a certain Template.

Descendant Same as Child.

Offspring Same as Child.

Parent' A Template that has one or several Children.

Reference a pointer between two CIs. Either a pointer between two Templates, or a pointer between two instances.

Object Templates, Instances and References are all objects, or CMDB objects.


Introduction to the OneCMDB Desktop

Starting the Desktop

As described above, the OneCMDB Desktop runs in a web browser. OneCMDB is a multi-user system and you may have Desktops running in parallell, either in different web browser windows or in different web browsers. You may run the Desktop on the same system as the OneCMDB Core (back-end server) is installed, or access it from another system over a LAN or WAN.

Use a standard web browser to access the OneCMDB Desktop (GUI). In case you want to access OneCMDB from another system, open the browser on the other system and replace `localhost' with the name, or IP address, of the system with OneCMDB installed. Remember to open the firewall on the latter system to allow TCP requests on port 8080. Here are some examples:

http://localhost:8080
http://www.db-server.acme.com:8080
http://intranet.itil.acme.com:8080

Login and logout

Before you can use OneCMDB you must authenticate yourself with a name and password on the start page of the Desktop.

Image:V2_login.jpg

OneCMDB has one built-in user with a default password:

  • user name=admin
  • password=123

It is of course recommended to change the default password, see the Administrator's manual V2.0. Additional users can be added using the User Accounts function in the Desktop. Each user shall belong to one or several Groups. A Group defines certain rights and permission, what the users in the Group are allowed to see, how the Desktop shall be configured, etc.

Note that the Desktop session will time-out after some time of inactivity and you are directed to the Desktop start page with the login window. Please be aware that any unsaved data in the OneCMDB Desktop is lost when you are logged out. If you like to logout yourself, there is a Logout command in the Desktop Start Menu.

Layout of the Desktop

The OneCMDB Desktop can be resized as you wish and is also highly configurable. It usually looks something like this:



The look and layout of the Desktop may also change depending of your login credentials. I.e., an Admin will see all functionality while a restricted user will only have access to selected functions. The following information assumes you have logged in to the Desktop as Admin.

In the lower, left, corner of the Desktop there is a Start button that gives you access to all functions in the Desktop.

On the left side of the Desktop you will see icons that are shortcuts to selected functions on the Desktop Start Menu.

If you click on the OneCMDB logotype in the upper right corner you will be re-directed to the official home page for OneCMDB (www.onecmdb.org).

The Start Menu

The Start Menu is a part of the OneCMDB Desktop and its layout may also change depending of your login credentials. I.e., an Admin will see all functionality while a restricted user will only have access to selected functions. Typically it looks like this for an Administrator:

Image:V2_startmenu_user.jpg

When you open the Start Menu your user name is presented at the top.

Image:V2_startmenu_logout.jpg

To the right you have the Logout command and a Roles command where you can see the Role or Roles you belong to. If you belong to several Role groups, the current Role is marked. and you can switch to another Role by klicking on it.

Here is also a feedback function. If you click on either the :-) or the :-( smiley, a message is sent to the OneCMDB team. Before the message is sent you get a chance to enter a text message and your name, e-mail address etc. This is however optional! If you neither enter a message, nor your contact information. the message will only state whether you pressed the happy or unhappy smiley.

Image:V2_startmenu_help.jpg

At the bottom are links to the on-line Help and the public OneCMDB website.

Image:V2_startmenu_functions.jpg

The remaining commands on the Start Menu are:

  • Model - Import, export and remove Model Files (Templates, Instances etc.)
  • Model Overview - View your CMDB model and navigate through it
  • MDR - Management Data Repositories, i.e. manage external data sources
  • CMDB View - View and edit your CMDB data in different ways
  • Custom Views - Opens a list of customized and personalized views
  • Custom Reports - Opens a list of customized and personalized reports
  • Design - Tools for designing a CMDB Model
  • System - Tools for configuring and setting up the OneCMDB system
  • Admin - Tools for administrating the OneCMDB installation

Common functions in the OneCMDB Desktop

Model Import, Export and Remove

These functions allow you to manage OneCMDB Model Files. I.e., the models that define the structure of the CMDB. OneCMDB models can also provide various kind of content to the CMDB.

Import

Select the Model/Import function on the Start Menu.

The left pane shows all available Model Files in their respective folders. Click on the arrow in front of a folder to expand it and view its content. Click again to collapse it. You can also click on the plus-sign in the Title bar of the pane to expand all Folders. The corresponding minus-sign collapses all folders.

The right pane shows all Model Files that are currently in the CMDB.

Now place a checkmark in front of all the Model Files in the left pane that you like to import. If you shall import several Model Files it is often best to mark them all and import them in one command. Press the Open button and OneCMDB reads and checks all selected Model Files. If a file is corrupt or its content erroneous an error message is displayed. Correct the error and try again. If the check is OK, the Model Files are then compared to the current (if any...) Model Files in the database. A comparison report is now presented.

Image:V2_modelimport_compare_overview.jpg

The Overview tab of the report states what the impact is if you import the selected data to the OneCMDB database, the CMDB. The Details tab gives you an in-depth report of the comparison. Each new, modified and deleted Template, Instance and Reference is listed.

Image:V2_modelimport_compare_details.jpg

The Details view is a table. The table is sorted into pages if the table is long. Note also that you can change how the table is presented by clicking on a column heading. See the #Functions in a Table section for details.

Note that you in this table may exclude one or many objects from the import by removing the checkmark in front of each such object.

If you at this point do not like to proceed with the import, press Cancel, otherwise press "Commit to CMDB" and the data is imported (committed) to the CMDB. A confirmation of the result is presented. Press OK and you are back in the Import Model function. You may now either import more Model Files or press close to return to the Desktop.

Export

Select the Model/Export function on the Start Menu.

The left-most pane contains a Template Hierachy that shows all available Templates in the order they inherit characteristics from each other. I.e., the most generic Template is at the top of the tree.

Select one or several Templates in the hiearchy and note that these show up in the upper right pane. For each selected Template you must now decide what you like to export:

  • Templates - Check this option if you like to export the Model Definition for the selected Template.
  • Instances - Check this option if you like to export the Model Definitions for the instances that are based on the selected Template.
  • All Children - Check this option if you like to export the Model Definitions for ALL Children that inherit from the selected Template. Note that this can be both child-templates as well as child-instances.

If you select to export References these are listed in the lower, right pane and you have the following options:

  • Templates - Check this option if you like to export the Model Definition for the selected Template References.
  • All Children - Check this option if you like to export the Model Definitions for ALL Children that inherit from the selected Reference Template.

Note that it is not possible to export references between instances (CIs) in the CMDB. These references are always generated by OneCMDB automatically when you import or create instances.

Remove

Select the Model/Import function on the Start Menu.

The right pane shows all Model Files that are imported to the CMDB. Click on the arrow in front of a folder to expand it and view its content. Click again to collapse it. You can also click on the plus-sign in the Title bar of the pane to expand all Folders. The corresponding minus-sign collapses all folders.

Select the Model File you like to remove from the CMDB by clicking on it. If you like to remove several files, click on them one by one while pressing the CTLR-key. Click the Remove-button. A window is displayed with an overview stating how many objects that will be deleted. Note also that there is a Details tab if you like to see a more detailed view. Press Cancel if you do not like the impact the delete operation will have on the database. If you like to proceed, press "Commit to CMDB" and the delete operation is executed.

Model Overview

The Model Overview gives you a graphical overview of the current CMDB Model. You can look at the template hierarchy, view how references are used between the different Templates and also see all instances (CIs) in the database.

Select Model Overview from the Start Menu to start the function that looks like this:

The function have four panes that can be resized to your liking.

The Template Hierarchy Graph

The upper left pane contains a template hierarchy graph over the current model. You can thus follow how Templates inherit their Attributes. The template hierarchy graph expands and collapses as you click on different Templates.

There are a number of mouse actions available to navigate in the graph and to control its behavior and appearance. See the #Mouse Actions section for details.

The Attributes tabs

When you select a Template in either the hierarchy graph or the References graph, details for this Template is shown in a pane below the graph. These details are the Attributes and their default values as defined in the current Model for this selected Template.

When you view Instances (CIs) and make a selection, Attributes and their current values for this specific Instance are shown in the Attributes tab.

The OneCMDB Info tab

This tab presents statistics about the current database (CMDB).

The "References to/from" graph

A selected Template also shows up in a graph in the upper right pane.

The graph shows the Template, all References to and from it and corresponding Templates the references are pointing to. The graph can be controlled and manipulated in various ways as described in the #Graph Control section.

The "Instances of" graph

If you select a Template in the "References to/from" graph and then click on the tab named "Instances of" a graph presenting all instances (CI:s) of the selected Template.



As for all other graphs, available commands for navigation and control in the #Graph Control section. If you click on an Instance, its details (Attributes) are listed beneath the graph.

MDR

The MDR (Management Data Repository) function allows you to manage external data sources, often called MDRs. These MDRs can be relational databases, Excel spreadsheets, XML documents, etc. A set of MDRs are delivered with OneCMDB and others can be installed separately. You can also develop your own MDRs. Standard MDRs are described in the #MDR Descriptions chapter. Please note that availability of MDRs in your OneCMDB depends of what is installed and which Models you have imported.

An MDR uses a Configuration setting that specify how the MDR shall operate. Several Configurations can exist in parallel for a specific MDR. For example, if you have an MDR that can perform auto-discovery of your network, then one Configuration can specify to scan your Intranet and another Configuration can specify to scan your Extranet. Each Configuration is stored in OneCMDB as a special CI, e.g, it is based on a Template and has a number of Attributes.

An MDR is executed by selecting a Configuration that contains the wanted parameters for the job to be done. The execution is then initiated from the Desktop and the data retrieved from the execution is transformed into XML and stored as an Execution Result, i.e., a file with the resulting data in a structured format. The remaining work is similar to how Models are imported: The result is imported (opened), checked and compared with the current content of the CMDB and if the user desires, it is committed to the CMDB. Each Execution Result file is then saved and can be re-used later.

To start the MDR function, select MDR from the Start Menu.

The MDR function has two main tabs, MDR Overview and MDR Details.

MDR Overview

The MDR Overview tab shows a table with all available MDRs in your OneCMDB installation. The appearance of the table can be changed, see #Functions in a Table.

To execute an MDR, select the desired MDR Configuration in the table and press Execute. You can also select several Configurations if you like to execute them in parallel.

Image:V2_mdr_execute.jpg

A new window opens up with a tab for each selected Configuration to execute. Press the Start button and execution of the MDR starts with its pre-defined configuration settings. If you like to halt and abort the execution and abort, press Stop, otherwise wait for execution to complete. You must scroll to the bottom of the progress window and check for the text "Execution Completed" to know when the MDR has finished. Have patience, some MDRs need a lot of time.

Now close this window and look at the MDR Overview again. In the table you will see that status has changed for the MDR Configuration you just executed. If execution went well, it should say READY.

Possible status states are:

  • EXECUTING - The MDR is currently executing, initial state
  • FAILED - The MDR failed to execute, e.q the script exit code was != 0
  • READY - The MDR has executed and the result is uploaded, waiting to be committed/rejected
  • COMMITTED - Currently committed to the CMDB (only one Execution Resultat the time can be COMMITTED)
  • OUT_OF_DATE - Previously committed data, has been superseeded by another Execution Result
  • REJECTED - The import to the CMDB has failed for some reason

If the state is READY, select the same Configuration (table row) again and press Open and the data from the MDR (the Execution Result) is checked and compared with the current data in the CMDB. You will see an overview of the comparison and a if you change tab you will see a detailed view where you for instance can select that certain data shall not be imported.

Image:V2_mdr_compare.jpg

If you find the comparison OK, press Commit to CMDB to import the data, otherwise press Cancel.

Back in the MDR Overview window you will notice that status has now changed to COMMITTED. Your data is successfully imported!

MDR Details

The MDR Overview gives you a condensed view of the MDR functionality and an easy way to execute MDRs. The MDR Details tab provides you with more in-depth information and richer control over the MDRs.

Available MDRs are listed in the left pane. They are the same as the ones visible on the MDR Overview tab as described above. To execute and MDR, select it in the list. Note that one or several Configurations for this specific MDR appear in the table in the right pane.

You can now study all parameters (columns) in each Configuration. If you like to change anything, you can do it by editing in the table. The table can be edited like any other table in OneCMDB Desktop, see #Functions in a Table. Click Save when you are done. If you like to add a new configuration, press Add and edit parameters to suit your needs.

When you select a Configuration, any existing Execution Results for this specific Configuration are listed in the table at the bottom of the right pane. Now press Execute with one or several Configurations selected. A new window appears, which is used to start the execution of the selected MDR configuration or configuration. If you have selected several configurations, they appear as different tabs.

Image:V2_mdr_execute.jpg

Press the Start button and execution starts with the configuration settings you have chosen. If you like to halt and abort the execution, press Stop, otherwise wait for execution to complete. You must scroll to the bottom of the progress window and check for the text "Execution Completed" to know when the MDR has finished. Have patience, some MDRs need a lot of time.

Close the execution window and return to the previous window. You will now see that a Execution Result has been added in the table at the bottom of the right pane. The Execution Result should have its status set to READY. Each time you execute a Configuration, a new Execution Result is added to this table.

Select the latest Execution Result and click Open. The resulting data from the execution of the MDR is now compared with the current content of the CMDB. A compare window appears with the result of the comparison.

Image:V2_mdr_compare.jpg

Check for possible problems, i.e. conflicts, abnormal amount of data, etc. On the Details tab you can see more information and also uncheck selected data if you do not want to import it. If you find the comparison OK, click on Commit to CMDB and the new data is inserted in the database. If you do not like to import the data, press Cancel.

When you are back to the MDR Details window you will see in the lower table that status has changed for the Execution Result you just imported. If the import went well, it will say COMMITTED and your new data is stored in the CMDB according to how the MDR was designed and configured.

Possible status states are:

  • EXECUTING - The MDR is currently executing, initial state
  • FAILED - The MDR failed to execute, e.q the script exit code was != 0
  • READY - The MDR has executed and the result is uploaded, waiting to be committed/rejected
  • COMMITTED - Currently committed to the CMDB (only one Execution Result at the time can be COMMITTED)
  • OUT_OF_DATE - Previously committed data, has been superseded by another Execution Result
  • REJECTED - The import to the CMDB has failed for some reason

You can for example select a row with "OUT_OF_DATE" in the table and compare it to the current content of the CMDB by pressing Open. However, be aware that you may cause unwanted results in the CMDB if you commit such data.

MDR Descriptions

NMAP Discovery

NMAP_Discovery performs an auto-discovery of a network and stores the result in the NMAP Model.

The NMAP Model must be imported to OneCMDB prior to executing this MDR.

NMAP_Discovery has one default Configuration:

  • network-1 - Defines which network to scan, IP range etc. It can be changed as you like, copied and re-used.

You can change the name (network-1) of the configuration to a name that makes sense in your environment. You can also alter the IP range. Default is 192.168.1.0-255, mask 24. To limit the range, change for example to "192.168.1.1-20".

Please note that you can execute the MDR named NMAP to Basic Model after using this MDR in order to copy the discovered data into the Basic Model in the CMDB.

NMAP to Basic Model

NMAP2BasicModel copies data within the CMDB, from data previously imported to the NMAP Model to the Basic Model.

The Basic Model and the NMAP Model must be imported to OneCMDB prior to executing this MDR.

NMAP2BasicModel has one default Configuration that should not need any editing:

  • NMAP2BasicModel - Copies discovered data from the NMAP Model to the Basic Model

Import to Basic Model

Import2BasicModel imports data in various ways to the Basic Model.

The Basic Model must be imported to OneCMDB prior to executing this MDR.

Import2BasicModel has several example Configurations that can be edited to fit your purpose:

  • csv2applications - Reads a CSV file and transforms it to CMDB instances (Template = Applications)
  • csv2systems - Reads a CSV file and transforms it to CMDB instances (Template = Systems)
  • jdbc2applications - Reads a SQL database using JDBC and transforms it to CMDB instances (Template = Applications)
  • jdbc2systems - Reads a SQL database using JDBC and transforms it to CMDB instances (Template = Systems)

NAGIOS to Basic Model

Nagios2BasicModel is used for several tasks related to NAGIOS. It can read NAGIOS configuration files, store the data in the CMDB Model and also transform the data to Instances in the Basic Model. It can also export data from the Basic Model and transform it to NAGIOS configuration files.

The Basic Model and the NAGIOS Model must be imported to OneCMDB prior to executing this MDR.

Nagios2BasicModel has currently one Configuration that should not need any editing:

  • Basic Model to Nagios Model - Converts Instances based on Template System (and all its children) to a NAGIOS configuration file.

Note: More Configurations will be added to this MDR in the near future.

CMDB View

The CMDB View function provides a generic way to read, edit, delete and classify data in the CMDB. To start this function, select CMDB View from the Start Menu.

The left pane shows all Templates in the CMDB, organized in the way they inherit Attributes from each other. Hence, the Parent Template for all CIs are at the top of the tree structure.

Above this Template Hierarchy is a button where you can select between four modes:

  • Read Only - No changes can be made to the data you see in the CMDB view.
  • Edit Allowed - You can edit Attribute values
  • Delete Allowed - You can delete CIs (Instances) and Attributes
  • Classify Allowed - You can move CIs (Instances)from one Template to another. I.e., move a PC from Desktop to Laptop.

The right pane contains three tabs, a table view, a tree view and a graph view. You select which CIs to view by selecting a Template in the Template Hierarchy and then you click on a tab to decide how you like to present the data.

Table View

The Table View is shown in the picture above. Each row in the table is one CI (Instance) and each column contains information about the CI. This information is attribute values and each column heading states the name of the Attribute. The Attributes listed are the ones defined in the CI´s Template. As you will notice the further down you go in the Template Hierarchy, the more columns are presented as more and more Attributes are added.

The table can be manipulated as described in the #Functions in a Table section. If you right click on a row you can open the Properties window for this CI. See chapter #The Properties Function for more details.

Tree View

The Tree View lists a row for each CI (Instance) to present.

If you select a row, a table appears at the bottom of the right pane. This table contains more information about the selected Instance, i.e., all its Attributes and corresponding values, just like in the Table View described above.

By clicking on the arrow in front of an CI (Instance) in the tree you expand that row and you will see all inbound and outbound References to/from this CI. You can drill down in the structure by subsequently clicking arrows in the chain.

Graph View

The Graph View shows all CIs (Instances) in a dynamic graph. If you click on an Instance in the graph you will see more information (its Attributes) in the lower right pane. Note also that a new pane has appeared to the far right. This pane has three tabs named References, Search and Graph Control.

The graph can be controlled and manipulated in different ways. See chapter #Graph Control.

Custom Views

The Custom Views function displays a list of customized views of the CMDB. As default the list contains a few example views.

Image:V2_customviews.jpg

To start the function, select Custom Views from the Start Menu. You can expand an entry in the list to view more details of it. To select and open a view, double-click on it or press Open. Here is example of a typical view:

You can design your own customized views. See #Customs Views Design for more details.

Custom Reports

The Custom Reports function displays a list of customized reports than can be generated. As default the list contains a few example reports in different formats and with different content.

Image:V2_customreports.jpg

To start the function, select Custom Reports from the Start Menu. You can expand an entry in the list to view more details of it. To select and generate a certain report, double-click on it or press Open. Here is an example of a typical report:

You can design your own customized reports. See #Customs Reports Design for more details.

Design functions in OneCMDB Desktop

Model Editor

The Model Editor allows you to create, edit and delete Templates.

To start the function, select Design from the Start Menu and then Model Editor.

MDR Setup

The MDR Setup function lets you configure and set up your own MDRs (Management Data Repositories).

To start the function, select Design from the Start Menu and then MDR Setup.

Custom Views Design

The Custom Views Design function enables you to create your own, customized views of data in the CMDB. The views you design are then available under #Custom Views.

To start the function, select Design from the Start Menu and then Custom Views Design.

Custom Reports Design

The Custom Reports Design function is a tool for creating customized reports that can be shown on screen, saved to file or printed. The custom reports you create can then be invoked from the #Custom Reports function or by calling a unique URL per report.

To start the function, select Design from the Start Menu and then Custom Reports Design.


System functions in OneCMDB Desktop

System Overview

The System Overview function is the same as the #Model Overview function, but it gives an overview of the whole OneCMDB database including system related models etc.

To start the function, select System from the Start Menu and then System Overview.

System Editor

The System Editor is the same as the #Model Editor, except that system related models and templates can be edited. The Model Editor is restricted to only view and edit CMDB related (user created) model data.

To start the function, select System from the Start Menu and then System Editor.

System View

The System View function is the same function as the #CMDB View function, except that it allows you to view everything in the OneCMDB database. The CMDB View, as the name suggests, will only show CMDB (user created) data.

To start the function, select System from the Start Menu and then System View.

System Export

The System Export function is the same function as the #Model Export function except that it can be used to export anything in the OneCMDB database, including system related objects. Model Export will only show and export CMDB (user created) data.

To start the function, select System from the Start Menu and then System Export.


Admin functions in OneCMDB Desktop

User Accounts

The User Accounts function lets you add, change and delete users. You can also manage Roles, privileges etc.

To start the function, select Admin from the Start Menu and then User Accounts.

Desktop File Editor

The Desktop File Editor enables you to edit all configuration and setup files that the OneCMDB Desktop uses.

To start the function, select Admin from the Start Menu and then Desktop File Editor.

Delete CMDB Objects

The Delete CMDB Objects function allows you to delete Templates, Instances and other objects in the CMDB database in an effective way.

To start the function, select Admin from the Start Menu and then Delete CMDB Objects.


Desktop Widget List

The Desktop Widget List function displays a list of all widgets used in OneCMDB Desktop.

To start the function, select Admin from the Start Menu and then Desktop Widget List.

Help functions

Help function

The Help function on the Start Menu opens a window with on-line documentation. The documentation resides on a public Internet server.

Context sensitive help

Many functions in the OneCMDB Desktop have an icon with a question mark in the upper right corner. Pressing this icon opens a new browser window with on-line help for this specific function. The help texts resides on a public Internet server.


Commonly used features

Graph Control

More or less all graph functions in OneCMDB are controlled in the same way as described below. Note that some features may be unavailable in certain graphs because they are not relevant.

Mouse Actions

The following commands (mouse actions) can be used to control the behavior and appearance of a graph:

  • Hold left mouse button and move mouse: Move the graph
  • Hold right mouse button and move mouse: Zoom in/out
  • Turn mouse wheel: Zoom in/out
  • Single-click with right mouse button: Adjust zoom so all objects fit within window
  • Double-click with left mouse button: Center where the cursor is and zoom in
  • Single-click with left mouse button on an object: Select this object
  • Hold left mouse button on an object and move mouse: Move this object

The References tab

The References tab allows you to select the References you like to include in the graph. Note that the list of References is context sensitive, it will change depending of the Instances that are viewed in the graph. When you select one or more reference types, they show up in the graph and so do a the Instance in the other end of each Reference.

The Search tab

The search function allows you to search for keywords. You search all Attributes (values) in all instances of a selected Template. The result is shown in the graph.

The Graph Control tab

The Graph Control tab provides you with graph control where you can:

  • Change whether items in the graph shall be allowed to disappear outside the window or not
  • Change whether the graph shall be animated (dynamic) or not
  • Change how many levels out from a selected Template the graph shall view
  • Change whether to show Instances that lack references to other CI:s or not
  • Limit the number of instances to show in the graph

Functions in a Table

Please note that all functions are not always available in a certain table. Commands can be disabled in some modes.

Image:V2_table.jpg

Typical look of a table.

Sorting and Grouping

A table in the OneCMDB Desktop can be changed in many ways. You can change sort order, grouping, etc. You change a table´s behavior by clicking on the column headings.


Available commands are (typically):

  • Sort Ascending - Sort alphabetically based on this column
  • Sort Descending - Sort alphabetically (reversed order) based on this column
  • Columns - Include or exclude columns from the table
  • Group By This Field - The available values in this column are used as titles in the table.

Refresh

Press the Refresh button to reload the table. N.B., if you have unsaved data in the table, the changes will be lost.

Paging

If the table is long it will be divided into pages. The arrows are used to navigate between the pages.

Search

Enter a keyword and press Enter. The table will only show rows that contain the keyword.

All children

Often a table shows data originating from a certain Template. If the "All children" checkbox is checked, data is also shown for all Templates and/or Instances that has the selected Template as Parent.

The Properties Function

The Properties function can be invoked from many places in the OneCMDB Desktop, typically by double-clicking on a row in a table or by right-clicking on an item and selecting Properties.

Image:V2_properties.jpg

The Properties window has three tabs, Properties, Graph and Change Log.

The Properties tab

The tab is shown in the illustration above. It contains a table with two groups, one with internal Attributes and one with user defined Attributes for the selected Template or Instance (CI). Attributes in the first group are defined in the OneCMDB Model and varies from Template to Template. The latter group are always the same and most of them are system generated.

Above the table is a button where you can switch between Read Only and Edit Allowed. The table can be changed and edited like any other table in OneCMDB Desktop, see #Functions in a Table.

The Graph tab

The Graph tab displays a dynamic graph showing the selected object and if you like, References to and from it.

If you select an object, its Attributes are displayed under the graph. To manage the graph, see chapter #Graph Control.

The Change Log tab

The Change Log displays all changes that has been made to the selected object. This provides an important feature of the CMDB. The Change Log is a table that can be sorted, grouped, etc as described in chapter #Functions in a Table.

The Change Log includes:

  • RFC-ID - A unique ID for one specific change.
  • TX-ID - A unique ID for a set of changes carried out at the same time.
  • Who - The user name of the person who performed the change.
  • Summary - Textual description of the change.
  • Date - Time and date when the change took place.
Community and support