# 6. Troubleshooting

<div align="right">

![logo](https://docs.tic.gal/uploads/images/gallery/2026-09/bTctJOpu7RWx7g5Z-embedded-image-jx8a12tf.png)

</div>

*Part of the **BSM** manual — see also [1. Introduction](https://docs.tic.gal/books/bsm/page/1-introduction), [2. What's New](https://docs.tic.gal/books/bsm/page/2-whats-new), [3. Scope](https://docs.tic.gal/books/bsm/page/3-scope), [4. Setup](https://docs.tic.gal/books/bsm/page/4-setup), [5.1 How to use](https://docs.tic.gal/books/bsm/page/51-how-to-use), [5.2 Business Services](https://docs.tic.gal/books/bsm/page/52-business-services), [5.3 Application Services](https://docs.tic.gal/books/bsm/page/53-application-services), [5.4 Service Map](https://docs.tic.gal/books/bsm/page/54-service-map), [5.5 RACI Matrix](https://docs.tic.gal/books/bsm/page/55-raci-matrix), [5.6 RACI summaries](https://docs.tic.gal/books/bsm/page/56-raci-summaries).*

## I don't see the BSM menu, or a service's RACI tab is missing

BSM's menu entries and tabs only appear for a profile that has been granted the relevant right under **Administration > Profiles > (a profile) > BSM**: Business Service, Application Service, Configuration, and RACI Matrix each have their own Read/Create/Update/Delete right. A profile with none of these granted sees no BSM menu at all, not an error — check the profile's BSM tab first.

## I can't find a way to edit actors from the RACI Matrix page

The RACI Matrix is read-only by design — it's an overview, not an editor. To change who is Responsible, Accountable, Consulted or Informed for a service, open that service's own record (Business Service or Application Service) and edit its **Actors** section there; you need Update on that service's own tier to do so.

## The Business owner group list doesn't show the group I expected

The **Business owner group** picker on a Business Service is limited to groups the chosen **Business owner** actually belongs to. If the group you expect is missing, either it doesn't have that user as a member, or no owner has been selected yet — pick the owner first, then the group list narrows to their groups.

## The Service Map is missing assets I expect to see

The Service Map only draws asset types that are enabled in **Setup > General > BSM > Item types**, and software installations only if they are added to the **Tracked software** list there — an asset of an untracked type or an untracked software install is skipped entirely rather than shown greyed out. Check both lists if an expected node is missing.

## "Group by" boxes look empty or oddly grouped

Grouping is driven by the same Setup > General > BSM configuration (item type tiers, tracked software). An item that has never been assigned a tier falls back to an "Unassigned" grouping rather than being hidden — if a group looks unexpectedly full or empty, check the **Tiers** picker in Setup for that item type.

## The Status field on an Application Service has no options to choose from

Status is mandatory, but a State only appears there once it has been explicitly marked visible for Application Services — on a fresh install no State is marked that way yet, so the field starts empty. Open **Setup > Dropdowns > Statuses**, edit a State, and enable it for Application Services (or create a new one and do the same); it will then appear in the dropdown.

## The "Copy actors from Business Service" button did nothing, or isn't there at all

The button only appears once the Application Service is saved and linked to **exactly one** Business Service — it's hidden on a new, unsaved record, and clicking it on a service linked to zero or several Business Services shows a message explaining which of those is the case instead of copying anything. When it does run, it only fills fields that are currently empty: if Responsible or Accountable already has a value, that field is left untouched.

## Changes to a service's actors don't show on the Service Map or RACI Matrix immediately

Both views read the current state of the service records on each load; a hard refresh of the page resolves cases where a stale copy of the diagram or matrix was cached in the browser.

> Generated for **BSM 0.21.0-beta.1** on GLPI 11.0.8 — 2026-09-13.