1. Introduction
This is a Microsoft Visio 2010 and SharePoint server 2010 Add-In Implementation. Disk Space Monitoring Add-In provides a graphical view of free space available in the machines. The data refreshable diagrams are created from Visio using Disk Space Monitoring Add-In. This server side implementation makes it possible to refresh the diagram published from Visio in the SharePoint 2010. It connects to the SCOM/uses WMI for the data which has been taken during the diagram generation and refreshes the diagram back with the data from SCOM/using WMI.
2. Installation Overview
2.1 Permission for Installation
|
Permissions needed |
Description |
|
Local Administrator on the target machine |
Required for
- Execute the MSI
- Read/write registry |
|
Read access on the SCOM |
Required for refreshing the data |
|
Administrator access on the SharePoint server |
Required for deploying SharePoint solution package. |
|
Power Shell with SharePoint 2010 Management Shell |
Required for executing the script. |
Table 1: Permissions for Installation
2.2 Software Prerequisites
1. .NET Framework 3.5
2. Microsoft SharePoint 2010
2.3 Installation of Prerequisites
1. .NET Framework 3.5
Download and install the .NET framework 3.5 from:
http://www.microsoft.com/downloads/details.aspx?FamilyID=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en
2. Microsoft SharePoint 2010
The system should have the Microsoft SharePoint 2010installed.
2.4 Installation Flow
The Visio Services Data Provider for Disk Space Monitoring add-in.msi installs the Visio Services Data Provider for Exchange script along with the SharePoint solution package.
· Run the Visio Services Data Provider for Disk Space Monitoring add-in.msi
· The Welcome Screen appears.
Figure 1: Welcome Screen
· Click Next to continue.
· The Select Installation Folder screen with the Setup Installation Path and Disk Space Information appears.
Figure 2: Set Up Installation Path and Disk Space Information
1. Click Next, to install in the default folder path or click Browse to select the destination folder path.
2. To check the Disk Space Required, click Disk Cost.
3. Click Next to continue
Figure 3: Disk Space
The Confirm Installation screen appears.
Figure 4: Confirm Installation
1. Click Next to begin installation.
2. If you want to make any changes to the installation settings or go back to the previous pages, click Back.
3. Click Cancel to exit the setup wizard.
The Installing Visio Services Data Provider for Disk Space Monitoring add-in screen appears.
Figure 5: Installing Visio Services Data Provider for Disk Space Monitoring add-in
1. Please wait while the setup wizard installs Visio Services Data Provider for Exchange add-in. This may take few minutes. (See Figure 5: Visio Services Data Provider for Disk Space Monitoring add-in).
2. The installation bar is 
dispalyed.
3. To cancel the installation click Cancel
Once the installation is successful, the Installation Complete screenappears (see Figure 6).
Figure 6: Installation Complete
3. Script Configuration
This section describes the PowerShell script configuration. These PowerShell scripts install/uninstall the SharePoint 2010 solution. In addition to that it makes configuration changes to make the published Visio diagrams data refreshable.
3.1 Manual script installation
1. Open the SharePoint2010 Management Shell under All programs à Microsoft SharePoint 2010 Products. Right Click it and run as administrator since it deploys the SharePoint solution.
Figure 7: SharePoint 2010 Management Shell console
2. Execute the command & “<>\ InstallDataModule.ps1” and then press enter.
Figure 8: Manual script installation
3.2 Automated script installation
Alternatively the PowerShell script can be installed by double clicking the InstallScript.vbs present at the installed location.
Figure 9: Automated script installation
3.3 Manual Script Uninstallation
1 Open the SharePoint2010 Management Shell under All programs à Microsoft SharePoint 2010 Products. Right click it and run it as administrator since it removes the SharePoint solution.
Figure 10: SharePoint 2010 Management Shell console
2 Execute the command & “<>\ RemoveDataModule.ps1” and then press enter.
Figure 11: Manual script uninstallation
3.4 Automated script uninstallation
Alternatively the PowerShell script can be uninstalled by double clicking the UnInstallScript.vbs present at the installed location.
Figure 12: Automated script uninstallation
4. Site Configuration
This section explains about some fine tunings and miscellaneous options that can be modified for the Visio Data Graphics Service.
Open Central Administration Site à Manage Service Applications à Visio Graphics Service à Global Settings. This Global Settings provides the administrator to configure the data refreshable diagrams published from Visio 2010. The administrator can configure the maximum size of the diagram that can be published, cache time and the time out for refreshing the data for the diagrams published.
Figure 13: Global Settings
5. Environment Configuration
This section explains how the SCOM and SharePoint2010 server should be configured.
If WMI has been used for getting the free space from the machine, ensure that firewall settings don’t block the WMI calls. Ensure that WMI has been checked in the Fire wall settings exception in both the Server and the machines which are being monitored. This is the most commonly faced problem while refreshing the data using WMI. For detailed information about the firewall settings for WMI monitoring please refer this site.
Figure 14: Firewall settings
Next, the commonly faced problem is with regards to the credentials supplied for collecting the data from SCOM/using WMI. Visio Data Graphics service is the one which is solely responsible for fetching the data and refreshing it in the UI. By default it uses the credentials which have been supplied for the SharePoint site on which the diagram were published. This credential should have sufficient permission to collect the data from the machines from which data has been to be collected.
For WMI – administrator rights should be there on the machines where they are being monitored. It’s recommended to use Domain Admin/local admin credentials for Visio Data Graphics service when WMI option has been used for monitoring.
For SCOM – Visio Data Graphics services should have permission to read and access data from SCOM. SCOM SDK group account is nothing but a group, where the members under the group has right to access the SCOM and its database. SCOM SDK group account is recommended for Visio Data Graphics services when they are going to refresh the data from SCOM.
The credentials can also be checked from the SharePoint central administration site à Configure service Accounts. Check the SharePoint site on which the diagrams are published for its credentials. From Register new managed account option the credentials can be changed.
Figure 16: Credential Management in Central Admin
SharePoint 2010, SCOM and the machines for which the data has monitored using WMI should all be present in an Active directory which can establish communication with each other. This should be handled while configuring the environment.
If the data in the SCOM/WMI is too heavy for the SharePoint server to get it please refer the site configuration section in this document to increase the time out. 2 minutes can be the maximum time that is allowed to fetch the data from the Exchange Server.
Any sudden/drastic change in the SCOM after the diagram has been published will result in the Schema breakage. Please generate the diagram once again from the Visio and publish it. This provides a way only for the refresh in the data published and in no way it reflects the new changes that have been incorporated in the SCOM/WMI.
