ITM for Virtual Environments Agent for Citrix XenServer – Importing Logical Navigator

The IBM Tivoli Monitoring for Virtual Environments Agent for Citrix XenServer v71, released in November 2011, includes a new optional Tivoli Enterprise Portal (TEP) based logical navigator that can be used to provide an enhanced view of multiple monitored XenServer Pool Instances. The logical navigator provides a consolidated/aggregated view of the health and availability of all monitored XenServer Pools and hypervisors within the environment.

As seen below, the default Navigator View (Physical) represents the physical hierarchy of the managed systems being monitored in the ITM environment. A close examination reveals that each monitored Pool, represented by ITM Managed Sytem Names H1:XI and H2:XI are distinct entries in the Physical navigator. The Physical navigator (essentially the view within the TEP), out-of-the-box, does not provide any views (in TEP-speak “Workspaces” of all monitored XenServer hosts.Before the Logical Navigator -> 16 Hosts (2 Pools) spread across two distinct ITM instances

Importing the new Logical Navigator view allows managed system data to aggregated into a single “dashboard” view that allows you to view the status of all of the monitored XenServer Pools and hosts across the enterprise.

After the Logical Navigator -> 16 Hosts (two Pools) in one consolidated TEP Workspace/view

Importing the logical navigator

• Assure the TEPS user has Custom Navigator Views ‘Modify’ permissions (Administer Users->Permissions Tab->Tivoli Enterprise Portal Authorities->Custom Navigator Views->Modify)
• Login with tacmd

C:\Users\Administrator>tacmd login -s localhost -u sysadmin -p password
 Validating user...
 KUIC00007I: User sysadmin logged into server on https://localhost:3661.

• Navigate to the Logical_Navigator directory (in the root of the agent installation media)

T:\agents\kxiagent\kxiagent_710\ga_refresh\CRG3WML\ITMfVE_XenServer_Application_Support\Logical_Navigator>

• Install the logical navigator:

T:\agents\kxiagent\kxiagent_710\ga_refresh\CRG3WML\

ITMfVE_XenServer_Application_Support\Logical_Navigator>tacmd
 importnavigator -x kxi_logicalnav.xml -s localhost -u sysadmin -p
 password
 KUICIN001I Validating user credentials...
 KUICIN003I Reading XML and converting to custom navigator view...
 KUICIN012I The custom navigator view "XenServer_Details" already
 exists on the server. Do you want to delete the existing child
 nodes for the custom navigator view, and import the custom
 navigator view "XenServer_Details" to the Tivoli Enterprise Portal
 Server on http://localhost:1920? Existing user assignments for the
 custom navigator view will be maintained.
 Enter Y for yes or N for no: Y
 KUICIN013I Deleting child nodes for navigator "XenServer_Details"...
 KUICIN005I Writing queries to the server...
 KUICIN021I The queries for the custom navigator view were
successfully imported.
 KUICIN006I Writing workspaces to the server...
 KUICIN022I The workspaces for the custom navigator view
were successfully imported.
 KUICIN020I The custom navigator view "XenServer_Details"
was successfully imported from the file T:\agents\kxiagent\kxiagent_710\ga_refresh\CRG3WML\ITMfVE_XenServer_Application_Support\Logical_Navigator\kxi_logicalnav.xml to the Tivoli Enterprise Portal Server on http://localhost:1920. The
navigator view import operation did not assign the imported navigator view to any users. If the navigator view already existed, the existing user assignments were preserved. The tacmd edit User command or the Administer Users dialog can be used to assign the navigator view to a user.

• Modify the permissions of the TEPS user:

tacmd edituser -u sysadmin -w password -i sysadmin -p
 NavigatorViews=physical,logical,XenServer_Details

Results

After running these commands, refresh the TEPD or TEPW to view XenServer host (hypervisor) details in the logical navigator window.

references: http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/index.jsp?topic=%2Fcom.ibm.tivoli.itmvs.doc_7.1%2Fxenserver%2Fimport_logical_nav.html