Administration menu items are missing or inoperable after an upgrade

Document ID : KB000039829
Last Modified Date : 14/02/2018
Show Technical Document Details

Symptom:

As an administrator, navigate to the Administration tab following an upgrade from a previous version. You may experience either or both of the following symptoms:
   - Menu items that have been added by the new, upgraded version of Service Desk Manager are not present. The menu tree may resemble the menu tree from your previous version of the product, and does not appear to contain the expected new items.
   - Menu items yield an error message when clicked. For example, clicking on the System > Current Locks item may yield the error AHD04617: Unknown webengine operation "LIST_LOCKS".
 

 

Environment: 

This issue occurs on systems that have migrated from a previous version of the product. In the previous version, the Administration menu tree may have been customized by the administrator, either through the web interface or at a database level.

 

Cause:

If the administrative menu was customized at any point, it may not have been updated during the upgrade process. This can lead to expected items not being present, or items that have changed their underlying commands no longer functioning. The list below includes some menu items that were added or modified in a particular version of Service Desk Manager:
   - 12.7 : The Current Locks feature changed its' underlying command. Customized menu trees that reference the old LIST_LOCKS command will yield the AHD04617 error as listed above.
   - 12.9 : The Servers and Configurations items were added to allow administrators to add servers to configurations through the web interface. Pre-creating servers through these options makes setting up additional servers easier, as they will correctly identify their intended function during the installation process when they connect to the database.

 

Resolution:

 
For the Current Locks feature:
- Open the Service Desk web interface, and log in with an administrative account. 
- Navigate to the Administration tab > Security and Role Management > Role Management > Menu Tree Resources. 
- Locate the "Current Locks" item in the right-hand pane and open its' configuration page. 
- Click the Edit button. 
- Locate the "Resource" field. (For reference, this will currently contain "LIST_LOCKS" as part of the command.)
- Change the contents of the field to the value below: 
OP=SEARCH+FACTORY=record_lock+QBE.NN.lock_time=NULL 
- Save your changes and re-cycle the Service Desk services. 
- Test the Current Locks functionality. The error no longer appears, and the Current Locks function operates as expected.
 
For the missing Servers and Configurations items:
   - Open the Service Desk web interface, and log in with an administrative account.
   - Navigate to the Administration tab > Security and Role Management > Role Management > Menu Tree Resources.
   - Search for the missing menu item by name (e.g. Configurations or Servers). If it does not exist, click on the Create New button.
   - For the Configurations item, enter values into the fields as follows:
   Name : Configurations
   Status : Active
   Description : Configurations
   Resource : OP=SEARCH+FACTORY=config+QBE.EQ.delete_flag=0
   - For the Servers item, enter values into the fields as follows:
   Name : Servers
   Status : Active
   Description : Standard and Advanced Availability Server Names
   Resource : OP=SEARCH+FACTORY=usp_servers+QBE.EQ.delete_flag=0
   - Save your changes and re-cycle the Service Desk services.
   - Log in again and check for the presence of the menu items.
 
If you require additional assistance with missing or non-functioning menu items, please open a case with CA Support.