2,187
edits
(Added "Active Directory Integration") |
(Removed VMware category) |
||
(14 intermediate revisions by the same user not shown) | |||
Line 3: | Line 3: | ||
= Maintenance and Procedures = | = Maintenance and Procedures = | ||
== Add Regional Servers to Federative == | |||
# Add name and IP of regional server to Federative's host file | |||
# Add the names of the regional servers to the Federative's config file | |||
#* Open <code> S:\Program Files\vizioncore\vFoglight\config\federation.config </code> | |||
#* Add to <code> JndiURLs </code> section, eg <code> "jnp://server.domain.com:1099" </code> | |||
#* Restart Foglight services | |||
# Check status of new connection | |||
#* Log into Federative server | |||
#* Go to Administration, and find the Federation pane | |||
#* Click on "Number of Children" to view the server topology | |||
== Software Upgrade == | == 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. | 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. | ||
Line 15: | Line 26: | ||
#* Verify you can login to vFoglight (it can take 5 mins+ for the services to start fully after the upgrade, be patient) | #* 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. | #* 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. | ||
#* Note that the software can report incorrect version numbers, for example after installing v5.2.6.0 the GUI shows v5.2.5 (found at '''Dashboards | Administration | Administration''', Current Statistics pane). | |||
== Cartridge Install / Upgrade == | == Cartridge Install / Upgrade == | ||
Line 28: | Line 40: | ||
== Dashboard Creation == | == 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 | This procedure assumes the VM's you want to view via a dashboard are contained within a resource group, in this instance called ''WEB-SERVICE'' (based on the resource pool that the servers are contained within). | ||
# '''Create Dashboard...''' | # '''Create Dashboard...''' | ||
#* From the right hand menu, on the '''General''' tab, select '''Create new dashboard''' | #* From the right hand menu, on the '''General''' tab, select '''Create new dashboard''' | ||
#* Give the dashboard a sensible name, eg " | #* Give the dashboard a sensible name, eg "WEB-SERVICE dashboard for 2nd line team" | ||
#* Set the Relevant Role(s) to be the intended audience groups | #* 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) | #* Set the Allowed Role(s) to include all groups that should be allowed to see the dashboard (always include Administrators) | ||
Line 41: | Line 51: | ||
#* On the '''General''' tab select 1 column | #* On the '''General''' tab select 1 column | ||
#* On '''Data''' tab, navigate to '''Data | Virtual | VMware | Resource Pools''' | #* On '''Data''' tab, navigate to '''Data | Virtual | VMware | Resource Pools''' | ||
#* Drag and drop the ''' | #* Drag and drop the '''WEB-SERVICE (VMWResourcePool)''' object into the central pane | ||
#* Select the '''Utilizations: Resource Pool''' view | #* Select the '''Utilizations: Resource Pool''' view | ||
#* Add further object views as per complete table below (ie you've already done the 1st) | #* Add further object views as per complete table below (ie you've already done the 1st) | ||
Line 49: | Line 59: | ||
! Object !! View | ! Object !! View | ||
|- | |- | ||
| | | WEB-SERVICE (VMWResourcePool) || Utilizations: Resource Pool | ||
|- | |- | ||
| | | WEB-SERVICE (VMWResourcePool) || Reportlet: Advanced Alarm History | ||
|- | |- | ||
| | | WEB-SERVICE (VMWResourcePool) || Alarm List with Filter (TopologyObject) | ||
|- | |- | ||
| | | virtualMachines (under "WEB-SERVICE (VMWResourcePool)") || vmExplorer: VMCPUdetails (used/ready) | ||
|- | |- | ||
|} | |} | ||
== Active Directory Integration == | == Active Directory Integration == | ||
Line 69: | Line 78: | ||
|} | |} | ||
# Create service account on | # Create service account on PROD domain | ||
#* EG | #* EG Create account <code> svc-vFog </code> using something like | ||
#* <code> dsadd user "cn=- | #* <code> dsadd user "cn=svc-vFog, cn=Users, dc=prod, dc=domain, dc=com" - pwd "password-here" -pwdneverexpires yes -disabled no </code> | ||
#* and make a member of the "SQL Service Accounts" group | |||
# Log into vFoglight (as foglight/foglight), and navigate to '''Dashboards | Users & Security | Configure Directory Services''' | # Log into vFoglight (as foglight/foglight), and navigate to '''Dashboards | Users & Security | Configure Directory Services''' | ||
# Configure AD integration using the table below, leave all other fields as is | # Configure AD integration using the table below, leave all other fields as is | ||
# Kick start AD integration | # Kick start AD integration | ||
#* Log out of the vFoglight interface, then log in as a | #* Log out of the vFoglight interface, then log in as a CORP domain user (ie yourself). The login should partially succeed, and you should receive a error message like | ||
#* ''You logged in as user 123456 and do not have access to the application.'' | #* ''You logged in as user 123456 and do not have access to the application.'' | ||
#* If not, check the latest ManagementServer log at <code> .\Program Files\vizioncore\vFoglight\logs\ </code> and attempt to resolve. | #* If not, check the latest ManagementServer log at <code> .\Program Files\vizioncore\vFoglight\logs\ </code> and attempt to resolve. | ||
Line 90: | Line 100: | ||
! Field !! Description !! Example | ! Field !! Description !! Example | ||
|- | |- | ||
| Nearest LDAP server || Primary Domain Controller || <code> ldap:// | | Nearest LDAP server || Primary Domain Controller || <code> ldap://dcsvr01.corp.domain.com:389/ </code> | ||
|- | |- | ||
| Secondary LDAP server URL || Secondary Domain Controller || <code> ldap:// | | Secondary LDAP server URL || Secondary Domain Controller || <code> ldap://dcsvr02.corp.domain.com:389/ </code> | ||
|- | |- | ||
| Distinguished name of the service account || vFoglight server's Service Account || <code> CN=- | | Distinguished name of the service account || vFoglight server's Service Account || <code> CN=svc-vFog,CN=Users,DC=corp,DC=domain,DC=com </code> | ||
|- | |- | ||
| Password || vFoglight Service Account password || ''Password for - | | Password || vFoglight Service Account password || ''Password for svc-vFog'' | ||
|- | |- | ||
| LDAP query prefix || Query prefix for user a/c finding || <code> CN= </code> | | LDAP query prefix || Query prefix for user a/c finding || <code> CN= </code> | ||
|- | |- | ||
| LDAP query suffix || Query suffix for user a/c finding, note the leading ''',''' || <code> ,DC= | | LDAP query suffix || Query suffix for user a/c finding, note the leading ''',''' || <code> ,DC=corp,DC=domain,DC=com </code> | ||
|- | |- | ||
| The scope(s) to search for groups || Where to look for domain user groups || <code> DC= | | The scope(s) to search for groups || Where to look for domain user groups || <code> DC=corp,DC=domain,DC=com </code> | ||
|- | |- | ||
| The LDAP context for user searching || Where to look for domain users || <code> DC= | | The LDAP context for user searching || Where to look for domain users || <code> DC=corp,DC=domain,DC=com </code> | ||
|- | |- | ||
|} | |} | ||
== Database Backup Scheduling == | |||
Procedure to set-up backup of vFoglight MySQL database to local disk | |||
<!-- COMMENTED OUT, AS DOMAIN ACCOUNTS DON'T SEEM TO WORK | |||
# Create scheduled task account on GMI domain | |||
#* EG create <code> svc-vFog </code> using something like | |||
#* <code> dsadd user "cn=svc-vFog, cn=Users, dc=gmi, dc=dtc, dc=reuint, dc=com" -pwd "password-here" -pwdneverexpires yes -disabled no </code> | |||
#* and make a member of the "Scheduling Clients" group --> | |||
# Create directory structure on the backup drive... | |||
#* <code> T:\backup\config </code> | |||
#* <code> T:\backup\data </code> | |||
# Within the config directory create two config files and one batch script; backup.conf, my.conf and DoBackup.bat; with contents as shown at bottom of procedure. | |||
#* As long as S: is your software/database drive, and T: is your backup drive there should be no reason to edit the conf or batch files | |||
# From a command prompt, run the DoBackup.bat script and check that the following files are created | |||
#* <code> T:\backup\data\ibdata1 </code> | |||
#* <code> T:\backup\data\ibbackup_logfile </code> | |||
# Schedule the batch script to run at 07:00 and 19:00 hrs ''local'' time, using a command similar to (edit as suggested)... | |||
#* <code> schtasks /create /tn "vFoglight MySQL backup" /ru <user> /rp <password> /tr T:\backup\config\DoBackup.bat /sc hourly /mo 12 /st 07:00:00 </code> | |||
#* /ru - ''Service account username'' | |||
#* /rp - ''Service account password'' – edit as required | |||
#* /st - ''First run start time'' – change to be GMT representation of 7am local time | |||
#* Note that due to the GMI lock-down policy, this command must be run as a local admin | |||
{| cellpadding="4" valign="top" | |||
|- | |||
| '''backup.conf''' | |||
||<pre>datadir="T:\backup\data" | |||
innodb_data_home_dir="T:\backup\data" | |||
innodb_data_file_path=ibdata1:10M:autoextend | |||
innodb_log_group_home_dir="T:\backup\data" | |||
set-variable=innodb_log_files_in_group=2 | |||
set-variable=innodb_log_file_size=134217728 </pre> | |||
|- | |||
| '''my.conf''' | |||
||<pre>datadir="S:\Program Files\vizioncore\vFoglight\mysql\data" | |||
innodb_data_home_dir="S:\Program Files\vizioncore\vFoglight\mysql\data" | |||
innodb_data_file_path=ibdata1:10M:autoextend | |||
innodb_log_group_home_dir="S:\Program Files\vizioncore\vFoglight\mysql\data" | |||
set-variable=innodb_log_files_in_group=2 | |||
set-variable=innodb_log_file_size=134217728 </pre> | |||
|- | |||
| '''DoBackup.bat''' | |||
||<pre>REM vFoglight database back-up script | |||
REM Simon Strutt v1.1 11-Aug-09 | |||
if exist T:\backup\data\ibdata1.4 del /q T:\backup\data\ibdata1.4 | |||
if exist T:\backup\data\ibdata1.3 ren T:\backup\data\ibdata1.3 ibdata1.4 | |||
if exist T:\backup\data\ibdata1.2 ren T:\backup\data\ibdata1.2 ibdata1.3 | |||
if exist T:\backup\data\ibdata1.1 ren T:\backup\data\ibdata1.1 ibdata1.2 | |||
if exist T:\backup\data\ibdata1 ren T:\backup\data\ibdata1 ibdata1.1 | |||
if exist T:\backup\data\ibbackup_logfile.4 del /q T:\backup\data\ibbackup_logfile.4 | |||
if exist T:\backup\data\ibbackup_logfile.3 ren T:\backup\data\ibbackup_logfile.3 ibbackup_logfile.4 | |||
if exist T:\backup\data\ibbackup_logfile.2 ren T:\backup\data\ibbackup_logfile.2 ibbackup_logfile.3 | |||
if exist T:\backup\data\ibbackup_logfile.1 ren T:\backup\data\ibbackup_logfile.1 ibbackup_logfile.2 | |||
if exist T:\backup\data\ibbackup_logfile ren T:\backup\data\ibbackup_logfile ibbackup_logfile.1 | |||
"S:\Program Files\vizioncore\vFoglight\mysql\bin\ibbackup" T:\backup\config\my.conf T:\backup\config\backup.conf </pre> | |||
|} | |||
= Troubleshooting = | = Troubleshooting = | ||
Line 120: | Line 190: | ||
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. | 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: | == Duplicate / Unwanted vCentre == | ||
To remove a vCentre server instance that's not required from vFoglight... | |||
# In the left-hand '''Dashboards''' menu | |||
# Browse to '''Management Server | Servers | Data Management''' | |||
# Then expand '''VMware Model | virtualCenters''' | |||
# Locate the vCentre you want to remove, and click the '''delete''' icon | |||
...if the vCentre comes back, then there's probably a vFoglight VMware agent still sending data to the server | |||
[[Category:Applications]] | |||
[[Category:Virtualisation]] |