Documentation

{{docApp.title}}

{{docApp.description}}

INDEX

Documentation Library

Search for information on Hornbill Documentation.

{{docApp.searchError}}

{{docApp.searchResultFilteredItems.length}} results for "{{docApp.currentResultsSearchText}}" in {{docApp.searchFilterBySpecificBookTitle}}

Have questions about this site?


What is this site?

  • This website is Hornbill's new product documentation website and is currently under development.
  • It is intended that all existing and future public-facing documentation we produce will be available to search, browse and share.
  • Hornbill's current documentation is available at Hornbill Wiki but over time this content will be migrated to this documentation site.
  • Please feel free to have a look around at any time.

Why has Hornbill created this site?

  • Hornbill's products have moved on considerably since we introduced it almost 10 years ago. At the time, the MediaWiki tool was sufficient, but we have outgrown it.
  • Our customers are more enterprise focused and more self-sufficient than ever before, so for 2023 and beyond we have established a new documentation platform and team to drive our documentation initiative forwards.
  • We are aiming to deprecate the use of Hornbill Wiki for most Hornbill related documentation.
  • We want to enable our growing partner network with product resources and information, documentation beyond our Wiki approach is required.
  • We could definitely do with some help, and may even pay for some! If you have domain knowledge and would like to help, please check out our Hornbill Docs Contributor Guide and contact the Hornbill docs team at docs@hornbill.com.

What will this site be good for?

  • Community contribution will be facilitated, encouraged, and most welcome.
  • High quality documentation, will be kept up to date as rapidly as our products evolve.
  • Real-time content search and discovery.
  • Articles organized into books, books into libraries, creating a more natural and logical structure to our documentation.
  • Legacy API documentation and various other documentation sources will all be consolidated into a single unified documentation system.
  • Documentation available in browser as well as printable/viewable as PDF on demand.
  • Personalized documentation experience, allowing dark/light mode, article subscriptions, social media sharing and other useful features.
  • Almost all publicly available documentation on docs.hornbill.com will be open-source and available to fork on GitHub, allowing customers to derive their own custom documentation around Hornbill products should they wish to.

What is the timeline for this site?

  • We have taken the decision to publish and make available early, there is very little content at this time.
  • As and when we have completed/usable documentation, it will be published here.
  • We have a host of additional features we wish to add over time, so please watch this space.
  • We expect most of our existing documentation should be reviewed/migrated to docs.hornbill.com over the coming months.
  • The documentation project will be ongoing, will continue to expand, evolve and improve day-by-day.

{{docApp.libraryHomeViewProduct.title || docApp.libraryHomeViewProduct.id}}

{{docApp.libraryHomeViewProduct.description}}

  1. {{book.title}}

{{group.title || group.id}}

{{group.description}}

  1. {{book.title}}

{{group.title}}

Configuration Items

Configuration Manager is a repository / data warehouse for information technology (IT) installations (CMDB). It holds data relating to a collection of IT entities (commonly referred to as configuration items (CI)), as well as descriptive relationships between such entities.

A Configuration Item may be:

  • A physical entity, such as an Asset (Server, Switch etc), a User, Request or Document
  • A logical entity such as an Asset (instance of a database)
  • Conceptual, such as a Service

Regardless of the Configuration Item type it is important to understand and manage their attributes and understand the relationships and dependancies between them. For Example if a database instance get’s corrupted, this may affect the ERP service and prevent orders from being processed and directly affect the efficiency and productiveness of a businesses employees.

Features

Configuration Manager allows you to view relationships between Configuration Items via it’s graphical Configuration Item Explorer. Configuration Items which can be viewed, and the relationships between them include:

  • Assets
  • Services
  • Requests
  • Users
  • Documents

You can launch the Explorer from the following Configuration Item views:

  • Configuration Manager List
  • Asset records
  • Service records
  • Request records

In Policy Configuration Items

Certain Configuration Item types can be marked as In Policy, this provides you with the ability to Manage the Configuration Item’s which are most important to you, and in some cases enhance and enable additional functionality against the original entity.

You may wish to manage your Server’s and understand which Services are dependant on them, this would be an example of why you would want to put those Configuration Item’s In Policy You may want to schedule routine maintenance against business critical infrastructure, and as such enable Activities to manage this work, this would be a reason to put these Configuration Item’s in Policy You may have several thousand computer peripherals such as Mice which are low value and hold no business value in terms dependancies or relationships to other Configurations Items, these may add no value being In Policy

Assets

You can already records your Assets if you have Service Manager installed on your instance. This includes the following functionality:

  • Defining each Assets Class and Type
  • Defining the attributes which you wish to record for the Assets
  • Automatically track and audit all changes to the Asset’s attributes through the History feature
  • View all requests raised against the Asset
  • Link Assets to other Assets and Services

Individual assets marked as being In Policy will enable the following functionality on such Assets

  • The ability via the Configuration Manager Explorer to define the bi-directional dependancies and impact of the Links between the Asset and other Assets and Services it is linked to
  • Enable Activities on the Asset record, allowing you to schedule and manage Activities relating to the Asset such as routine maintenance or reviews
  • Enable an Activity Stream on the Asset record, allowing for the collaboration and discussion on the asset with other users.
  • Post and Comment on the Asset
  • Follow the Asset to get updates to its Activity Stream posted to your News Feed, allowing you to keep informed about all discussions around business critical assets

Services

You can already records your Services if you have Service Manager installed on your instance. This includes the following functionality:

  • Creating Services and managing their Catalog Status
  • Create Links to Assets

Marking individual Services as being In Policy will enable the following functionality on such Services

  • The ability via the Configuration Manager Explorer to define the bi-directional dependancies and impact of the Links between the Service and Assets it is linked to.

CI Explorer

  • Request record
    Launch the CI Explorer directly from any request form. This will put the request as the focus of the explorer and allow you to visualize the related CIs associated to this request.
  • Asset record
    Launch the CI Explorer directly from any asset form. This will put the asset as the focus of the explorer and allow you to visualize the related CIs to this asset
  • Services record
    Launch the CI Explorer directly from any Service form. This will put the Service as the focus of the explorer and allow you to visualize the related CIs to this.
In This Document