Home / Manager / Install guide

Install guide

Install Hardware Lifecycle Manager

About fifteen minutes for a ServiceNow administrator. Manager adds no tables or fields; it saves dates in ServiceNow's own lifecycle table.


You need
The admin role on the instance, to install from the ServiceNow Store and assign roles.
Releases
Tested on ServiceNow Zurich. The Store listing shows every supported release.
HAM Pro
Optional. With it, its lifecycle dates and normalization appear automatically, and your own dates fill the gaps.
Scope
x_catah_hlm
  1. Install the app

    Buy Hardware Lifecycle Manager on the ServiceNow Store, then install it on your instance from System Applications › All Available Applications › All. Install on a sub-production instance first if that's your practice.

  2. Give people access

    Manager has two roles. Assigning them to groups is easiest to manage.

    • x_catah_hlm.viewer: sees the page, read-only.
    • x_catah_hlm.admin: also opens the editor and the CSV import. It includes the viewer role.

    Saving dates also needs ServiceNow's own model_manager role. Manager saves under each person's own rights, so it never lets anyone change more than they already could. Without model_manager, the editor opens read-only and says why.

  3. Open the page

    In the navigator, open Hardware Lifecycle Manager › Lifecycle Manager. The first load counts every hardware model; on a large instance this takes a few seconds. Refresh counts again.

  4. Add your dates

    Edit dates opens a grid on the page. To add many at once, select Import CSV, download the template, fill it in and import it: a preview shows every change before anything is saved.

    Manager writes only its own internal lifecycle rows. Publisher dates and dates other tools calculated are never changed. Removing one of your dates sets your row inactive.

  5. Adjust the settings (optional)

    Two system properties, changed by an administrator in System Properties (filter the list on x_catah_hlm):

    • x_catah_hlm.due_days: how many days ahead count as Due. Default 365; any whole number from 0 to 3650.
    • x_catah_hlm.ci_classes: blank counts every hardware CI class. To count fewer, list CI class table names separated by commas, for example cmdb_ci_computer,cmdb_ci_server.

    If a value can't be used, the page says so above the tiles and falls back to the default.


From Viewer
If you use Hardware Lifecycle Viewer, install Manager and assign its roles. It shows the same data straight away. Remove Viewer whenever you like; it stores no data.
Uninstall
Uninstall from System Applications › All Available Applications › All. The dates you entered stay in ServiceNow's own lifecycle table.
Problems
If the page shows an error, it gives a code and a reference. Select Copy diagnostics and send the text with the code to [email protected]. More on the support page.