Difference between revisions of "VFoglight"

From vwiki
Jump to navigation Jump to search
m (Added Category)
(Added: "Software Upgrade", "Cartridge Install / Upgrade", and "Dashboard Creation")
Line 1: Line 1:
== Foglight not updating ==
* General support documentation can found on Vizioncore's website: [http://www.vizioncore.com/vzone/index.php http://www.vizioncore.com/vzone/index.php].
Pages are accessible, but not updating.  Caused by lack of data flow from VC server.  To resolve, reinstall the vFoglight agent on the VC server...
* Note that the local vFoglight server is known as an FMS or local child server, the global server is a Federation Master.
 
= Maintenance and Procedures =
== Software Upgrade ==
Be aware that during the upgrade, stopping/starting vFoglight service, and database changes/upgrades may take some time.  Cancelling the upgrade during any of these steps could corrupt the database.
 
# Copy installer to server
# Restart the server
# Start the installer, and select the '''Custom''' method
# Change the drive letter for the install path (probably S: - leave rest of path intact)
# Select '''Upgrade'''
# If the Agent installer pops up, cancel it
# Once the upgrade completes...
#* Verify you can login to vFoglight (it can take 5 mins+ for the services to start fully after the upgrade, be patient)
#* If a master/global Federation server, confirm this is still the case.  Browse to Dashboards | Administration | Administration, and check the Federation mode is "Master".  If not, correct the config in <code> .\Program Files\Vizone\config\foglight.config </code> so that <code> foglight.federation = true </code>, then restart the server and re-verify.
 
== Cartridge Install / Upgrade ==
If upgrading a cartridge, you might uninstall the current version 1st...
# Browse to '''Dashboards | Administration | Administration''', and in the Navigation pane click on '''Cartridges | Inventory'''
# Select the relevant cartridge, and use the '''Uninstall Selected''' button.
 
Install the cartridge...
# Download the cartridge .car file to your local machine
# Browse to '''Dashboards | Administration | Administration''', and in the Navigation pane click on '''Cartridges | Inventory'''
# Use the '''Browse''' button to locate the .car, then click on '''Install Cartridge'''
# Verify that the expected version of cartridge has been installed
 
== Dashboard Creation ==
This procedure assumes the VM's you want to view via a dashboard are contained within a resource group, in this instance called DTCP-S-NGTXRSP.
 
# '''Locate the resource pool...'''
#* From the left hand menu, navigate to '''Dashboards | Virtual | VMware | vmExplorer''', then find the resource pool in the Virtual Infrastructure topology.
# '''Create Dashboard...'''
#* From the right hand menu, on the '''General''' tab, select '''Create new dashboard'''
#* Give the dashboard a sensible name, eg "RSP VM dashboard for NGTx team"
#* Set the Relevant Role(s) to be the intended audience groups
#* Set the Allowed Role(s) to include all groups that should be allowed to see the dashboard (always include Administrators)
#* Enter a description into the Help text box, if required
# '''Customise Dashboard...'''
#* On the '''General''' tab select 1 column
#* On '''Data''' tab, navigate to '''Data | Virtual | VMware | Resource Pools'''
#* Drag and drop the '''DTCP-S-NGTXRSP (VMWResourcePool)''' object into the central pane
#* Select the '''Utilizations: Resource Pool''' view
#* Add further object views as per complete table below (ie you've already done the 1st)
 
{|cellpadding="4" cellspacing="0" border="1"
|- style="background-color:#bbddff;"
! Object            !! View
|-
| DTCP-S-NGTXRSP (VMWResourcePool)  || Utilizations: Resource Pool
|-
| DTCP-S-NGTXRSP (VMWResourcePool)  || Reportlet: Advanced Alarm History
|-
| DTCP-S-NGTXRSP (VMWResourcePool)  || Alarm List with Filter (TopologyObject)
|-
| Data (VMWResourcePool: DTCP-S-NGTXRSP (VMWResourcePool)/virtualMachines  || vmExplorer: VMCPUdetails (used/ready)
|-
|}
 
 
== Active Directory Integration ==
Procedure to enable vFoglight to authenticate user logins on AD domain, and to be able to use AD groups.  The vFoglight server needs a service account in order to be able to interact with AD domain.
 
#
 
= Troubleshooting =
== vFoglight not updating ==
Pages are accessible, but not updating (normally animated dials etc are grey/black).  Caused by lack of data flow from VC server to the vFoglight server.  To resolve, check vFoglight services on the vCenter and potentially reinstall the vFoglight agent on the VC server...


# On VC, browse to vFoglight server
# On VC, browse to vFoglight server
# Go to Administration, then Cartridges | Component Download
# Go to '''Administration''', then '''Cartridges | Component Download'''
# Install the Virtual VMware Agent (accept all default options, Next, Next, Next)
# Install the '''Virtual VMware Agent''' (accept all default options, Next, Next, Next)
# Ensure vFoglight services are running on VC
# Ensure vFoglight services are running on VC
On the Federation vFoglight server, the problem is caused by a lack of data to the source FMS/local vFoglight server, or a problem between that server and the master Federation server.


[[Category:VMware]]
[[Category:VMware]]

Revision as of 15:00, 30 July 2009

  • General support documentation can found on Vizioncore's website: http://www.vizioncore.com/vzone/index.php.
  • Note that the local vFoglight server is known as an FMS or local child server, the global server is a Federation Master.

Maintenance and Procedures

Software Upgrade

Be aware that during the upgrade, stopping/starting vFoglight service, and database changes/upgrades may take some time. Cancelling the upgrade during any of these steps could corrupt the database.

  1. Copy installer to server
  2. Restart the server
  3. Start the installer, and select the Custom method
  4. Change the drive letter for the install path (probably S: - leave rest of path intact)
  5. Select Upgrade
  6. If the Agent installer pops up, cancel it
  7. Once the upgrade completes...
    • Verify you can login to vFoglight (it can take 5 mins+ for the services to start fully after the upgrade, be patient)
    • If a master/global Federation server, confirm this is still the case. Browse to Dashboards | Administration | Administration, and check the Federation mode is "Master". If not, correct the config in .\Program Files\Vizone\config\foglight.config so that foglight.federation = true , then restart the server and re-verify.

Cartridge Install / Upgrade

If upgrading a cartridge, you might uninstall the current version 1st...

  1. Browse to Dashboards | Administration | Administration, and in the Navigation pane click on Cartridges | Inventory
  2. Select the relevant cartridge, and use the Uninstall Selected button.

Install the cartridge...

  1. Download the cartridge .car file to your local machine
  2. Browse to Dashboards | Administration | Administration, and in the Navigation pane click on Cartridges | Inventory
  3. Use the Browse button to locate the .car, then click on Install Cartridge
  4. Verify that the expected version of cartridge has been installed

Dashboard Creation

This procedure assumes the VM's you want to view via a dashboard are contained within a resource group, in this instance called DTCP-S-NGTXRSP.

  1. Locate the resource pool...
    • From the left hand menu, navigate to Dashboards | Virtual | VMware | vmExplorer, then find the resource pool in the Virtual Infrastructure topology.
  2. Create Dashboard...
    • From the right hand menu, on the General tab, select Create new dashboard
    • Give the dashboard a sensible name, eg "RSP VM dashboard for NGTx team"
    • Set the Relevant Role(s) to be the intended audience groups
    • Set the Allowed Role(s) to include all groups that should be allowed to see the dashboard (always include Administrators)
    • Enter a description into the Help text box, if required
  3. Customise Dashboard...
    • On the General tab select 1 column
    • On Data tab, navigate to Data | Virtual | VMware | Resource Pools
    • Drag and drop the DTCP-S-NGTXRSP (VMWResourcePool) object into the central pane
    • Select the Utilizations: Resource Pool view
    • Add further object views as per complete table below (ie you've already done the 1st)
Object View
DTCP-S-NGTXRSP (VMWResourcePool) Utilizations: Resource Pool
DTCP-S-NGTXRSP (VMWResourcePool) Reportlet: Advanced Alarm History
DTCP-S-NGTXRSP (VMWResourcePool) Alarm List with Filter (TopologyObject)
Data (VMWResourcePool: DTCP-S-NGTXRSP (VMWResourcePool)/virtualMachines vmExplorer: VMCPUdetails (used/ready)


Active Directory Integration

Procedure to enable vFoglight to authenticate user logins on AD domain, and to be able to use AD groups. The vFoglight server needs a service account in order to be able to interact with AD domain.

Troubleshooting

vFoglight not updating

Pages are accessible, but not updating (normally animated dials etc are grey/black). Caused by lack of data flow from VC server to the vFoglight server. To resolve, check vFoglight services on the vCenter and potentially reinstall the vFoglight agent on the VC server...

  1. On VC, browse to vFoglight server
  2. Go to Administration, then Cartridges | Component Download
  3. Install the Virtual VMware Agent (accept all default options, Next, Next, Next)
  4. Ensure vFoglight services are running on VC

On the Federation vFoglight server, the problem is caused by a lack of data to the source FMS/local vFoglight server, or a problem between that server and the master Federation server.