This documentation supports the 22.1 version of BMC Helix ITSM.To view an earlier version, select the version from the Product version menu.

Running the Prefix Manager

You must run the Prefix Manager to add a unique identifier, or prefix, to all of the forms on each server because the hub and spoke architecture allows sharing of records between multiple instances of AR System servers. In the case of spoke servers, the Prefix Manager updates the form's default ID (either the form's unique field or the request ID number, depending on the type of form) with the two-letter prefix that you provided earlier, during the registration procedure. On the hub server, the Prefix Manager updates the forms with the default prefix HB.

Prefix values

If the form ID has an existing prefix, the new two-letter prefix appears between the character and the integer sections of the ID number. For example, an incident record created on a spoke server that uses SP as the prefix would look like this: INCSP0000000001.

The Prefix Manager updates field default values at the form level and does not update existing data. Only record IDs created after you run the Prefix Manager has the prefix attached to them.

Warning

Use only this method for creating unique form prefixes in a Hub and Spoke environment. Do not use the System Configuration Settings - System Settings dialog box found under the Foundation > Advanced Options selection of the Application Administration console.

Before you begin

Perform this procedure after you register the hub and spoke servers. For more information, see Registering-hub-and-spoke-servers.

Important

  • After you establish a prefix for a spoke server, you cannot change it.
  • If you perform an upgrade to your BMC Helix ITSM on the servers running your Hub and Spoke environment, you must run the Prefix Manager again and perform several other tasks.

To run the Prefix Manager

You must perform the procedure once for each hub server and spoke server that is registered in your environment. You perform the procedure directly on the server that you are updating.

  1. On the IT Home page of the hub or spoke server that you are updating, click the Applications selection menu and select Administration Console > Application Administration console.
  2. On the Custom Configuration tab, select Hub and Spoke > Configuration Settings and click Prefix Manager.
  3. To add the prefix to the listed DSO related forms, click Update Form Prefix.
    The Prefix Status of each record in the table changes to Updated. Later, if you add more forms through customization or upgrade, you can use this table to check for forms that are not updated with the prefix. If forms need to receive the prefix, you can run the Prefix Manager again. The Prefix Manager updates only those records that have a status of Updated.
  4. Click Close.
  5. Restart the AR System server for the changes to take effect.

Where to go from here

When you finish running the prefix manager, see Creating-foundation-data-for-hub-and-spoke-servers.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*