ProView – Installation Guide
www.opslogix.com/ProView
ProView Dynamic Azure™ and System Center™ insights
Installation Guide For System Center operations Manager 2012
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
2 | P a g e
Copyright
The information contained in this document represents the current view of OpsLogix on the issues
discussed as of the date of publication and is subject to change at any time without notice to you. This
document and its contents are provided AS IS without warranty of any kind, and should not be interpreted
as an offer or commitment on the part of OpsLogix, and OpsLogix cannot guarantee the accuracy of any
information presented. OPSLOGIX MAKES NO WARRANTIES, EXPRESS OR IMPLIED, IN THIS
DOCUMENT.
The descriptions of other companies’ products in this document, if any, are provided only as a
convenience to you. Any such references should not be considered an endorsement or support by
OpsLogix. OpsLogix cannot guarantee their accuracy, and the products may change over time. Also, the
descriptions are intended as brief highlights to aid understanding, rather than as thorough coverage.
For authoritative descriptions of these products, please consult their respective manufacturers.
This deliverable is provided AS IS without warranty of any kind and OPSLOGIX MAKES NO
WARRANTIES, EXPRESS OR IMPLIED, OR OTHERWISE.
All trademarks are the property of their respective companies. © 2009 OpsLogix BV. All rights
reserved.
The names of actual companies and products mentioned herein may be the trademarks of their respective owners.
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
3 | P a g e
Table of Content
1 License Agreement ____________________________________________________________________________________ 4
2 ProView – Installation Guide ________________________________________________________________________ 5
3 Document Version _____________________________________________________________________________________ 6
4 Software Prerequisites _______________________________________________________________________________ 7
5 Compatibility ___________________________________________________________________________________________ 7
6 ProView Installation __________________________________________________________________________________ 8
6.1 Overview ____________________________________________________________________________________________________ 8
6.2 Order of installation: _____________________________________________________________________________________ 9
7 Installing the ProView License ____________________________________________________________________ 10
8 Installation of the ProView Visio Authoring Plugin. __________________________________________ 12
9 Installing the ProView website ___________________________________________________________________ 14
10 Validating Installed Components ________________________________________________________________ 20
10.1 Check the Dashboard selection page.________________________________________________________________ 20
10.2 Check the ProView Visio authoring Plugin. ________________________________________________________ 21
11 Appendix: Manual configuration/altering of the ProView website _______________________ 23
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
4 | P a g e
1 License Agreement LICENSE AGREEMENT BETWEEN OPSLOGIX B.V. AND THE CUSTOMER
1. LICENSE GRANT: OPSLOGIX B.V. (hereinafter "OPSLOGIX") hereby grants you (hereinafter "CUSTOMER") a non-transferable, non-exclusive, non-
assignable right to use, display, copy, load and run following software and the documentation related thereto (collectively, the "Software") on any
compatible computer platform at the CUSTOMER's location only for the internal purposes of the CUSTOMER. If a license was issued to the
CUSTOMER for an evaluation period (hereinafter "Evaluation Period"), the Evaluation Period commences on the date of delivery of the Software to
CUSTOMER and ends no more than 30 days later at no charges to the CUSTOMER. CUSTOMER EXPRESSLY ACKNOWLEDGES THAT THE SOFTWARE
WILL BE RENDERED INOPERATIVE AFTER THIS EVALUATION PERIOD. If a license has been purchased by the CUSTOMER, the foregoing license is
restricted to the Microsoft Systems Center Operations Manager 2007 management group.
2. TITLE: CUSTOMER acknowledges that title to the Software, including all intellectual property rights related thereto, is and shall remain the sole and
exclusive property of OPSLOGIX and / or its licensors.
3. NO WARRANTY: OPSLOGIX makes no warranty whatsoever with respect to the operation of the Software. The Software is provided to CUSTOMER
"as is". All implied and statutory warranties are hereby disclaimed.
4. LIMITATION OF LIABILITY: In no event shall OPSLOGIX neither OPSLOGIX's partners be liable for any consequential, indirect or special damages or
lost revenues or profits, including, without limitation, consequential or special damages for work stoppage or loss of work product data caused by the
use or inability to use this software, even if OPSLOGIX has been advised of the possibility or such damages or losses. By signing this Agreement, you
agree that OPSLOGIX's liability for damages caused by the use or inability to use this software is governed by Dutch Law. In case you suffer any
damages for which OPSLOGIX is liable to compensate you or in cases where the jurisdiction of a specific country does not permit limiting liability as
far as compensation for damages, the contracting parties have agreed that a conventional fine in the amount of the license fee paid for the software
will be assessed by the CUSTOMER. This fine is inclusive of any and all compensation for damages caused. The software is not specifically designed for
high-risk applications including situations where the failure of such software would threaten lives or cause extensive material damages. Such
applications include operating parts of nuclear power plants, weapon systems, equipment designed for sustaining people's basic bodily functions, etc.
5. CONFIDENTIAL INFORMATION: The Software provided to the CUSTOMER constitutes confidential information and trade secrets of OPSLOGIX and
/ or its licensors. CUSTOMER shall not disclose the Software to any third party other than employees of CUSTOMER involved with evaluation of the
Software and shall use the same degree of care to avoid disclosure as the CUSTOMER employs with respect to its own confidential information. The
CUSTOMER shall not reverse engineer, disassemble or decompile the Software. Any OPSLOGIX designations, logos, trade names or trade-marks on
the Software shall not be removed or altered.
6. TERMINATION: OPSLOGIX may terminate this Agreement if CUSTOMER is in breach of any of its terms. Upon such termination, CUSTOMER shall
comply with the provisions of subparagraph (b) below. If this Agreement has not been terminated by CUSTOMER's breach, the CUSTOMER agrees
that by the end of the Evaluation Period it will either: (a) enter into a license agreement with OPSLOGIX for a perpetual, non-exclusive right to use the
Software; or (b) remove all copies of the Software from its computer system(s) and either return to OPSLOGIX the Software, including any related
documentation in CUSTOMER's possession and the media on which the Software was delivered to CUSTOMER or destroy all copies of the Software if
obtained electronically. IF CUSTOMER FAILS TO COMPLY WITH THE TERMS OF THIS PARAGRAPH, OPSLOGIX MAY COMMENCE LEGAL
PROCEEDINGS AGAINST CUSTOMER FOR BREACH OF THIS AGREEMENT.
7. RESPONSIBILITY FOR SOFTWARE UPDATES. In order to ensure that the software functions properly, OPSLOGIX publishes updates to this software
on its web pages. These updates improve the workings of the software, ensure the software complies with minor Microsoft updates or remove any
bugs known to OpsLogix at the time of issuing of the update.
CUSTOMER is entitled to these updates for a period of one year after purchase of the Software. This period can be prolonged for subsequent years
by paying an annual maintenance fee of 20% of the original purchase price of the SOFTWARE. The CUSTOMER is responsible for proper
configuration of the software updating process to provide for the highest possible level of functional reliability.
8. GOVERNING LAW, ARBITRATION CLAUSE. This Agreement shall be governed by the laws of the Netherlands and any disputes arising from this
contract shall be submitted exclusively to the jurisdiction of the competent courts of Amsterdam, The Netherlands.
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
5 | P a g e
2 ProView – Installation Guide
Before using ProView, read the license agreement carefully.
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
6 | P a g e
3 Document Version
Release Date Version Changes
Feb 3, 2015 1.0.0.0 First draft
Apr 29, 2015 1.0.0.1 Review 1
Apr 30, 2015 1.0.0.5 First Release
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
7 | P a g e
4 Installation Prerequisites
In order to install ProView successfully, please make sure that all the prerequisites are satisfied before
installing ProView:
ProView requires Microsoft System Center Operations Manager 2012 SP1/R2.
ProView requires at least Microsoft Visio 2013.
Microsoft System Center Operations Manager account with administration access
Microsoft System Center Operations Manager account that has operator/read-only access
Microsoft Windows Server 2008 R2 or higher with the following components installed:
o Microsoft .NET 4.0 components enabled
o Microsoft Internet Information Server (IIS) components enabled on the server which ProView will be
installed
o System Center Operations Manager 2012 SP1/R2 Web Console
5 Compatibility
The ProView Visio Plugin works with the following versions of Microsoft Visio:
Version
Visio 2013 Standard
Visio 2013 Professional
Visio 2013 Pro for Office 365
The ProView dashboard render engine viewer has been tested for compatibility with the following browsers:
Version
Microsoft Internet Explorer 10 or higher
Chrome 40.0 or higher
Firefox 33.1 or higher
Safari 5.1 or higher
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
8 | P a g e
6 ProView Installation
6.1 Overview
The diagram below shows the relationship of the components used by the ProView Dashboard solution.
The ProView Website: contains the Dashboard Render Engine components.
The ProView Visio Add-In: is used to author the relevant dashboards.
During dashboard authoring, a SCOM SDK connection as well as a connection to the ProView Web service
(for the previewing feature) will be established. After the dashboard is saved to SCOM it can be viewed on
any device with the HTML5 ProView Dashboard Viewer page in IE, Chrome, Firefox and Safari and even
on your tablet or phone.
Proview Dashboard Visio Author
Proview Website
ProView Webservice
Proview Dashboard Viewer
IIS WebServer
SCOM SDK Service
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
9 | P a g e
6.2 Order of installation:
In order to complete the installation of ProView successfully, you need to install the following components:
1. OpsLogix License Management Pack and ProView License
2. ProView Visio Add-in: The ProView Visio Add-In needs to be installed on every work
station that is going to be used for dashboard authoring.
3. ProView Website: The ProView website needs to be installed on the SCOM server which
also has the SCOM Web Console website installed.
OpsLogix Proview License
Proview Visio Addin
Proview Website
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
10 | P a g e
7 Installing the ProView License
In order to use ProView you will need a valid OpsLogix license key. If you do not have a valid license key,
please contact [email protected] or fill out the contact form on our website.
The steps below should be followed in order to add the OpsLogix license extension to the SCOM console and
import the license.
1. From the ProView installation zip file locate the folder ManagementPack.
(1) Open the SCOM operations console (with SCOM administrator privileges) and navigate to the
Administration pane.
(2) Open view “management packs”.
(3) Navigate to “import management Packs”
(4) Click “Add”.
(5) Add all the MPs (listed below) from the folder ManagementPack in the ProView installation
zip:
- OpsLogix.BaseLibrary.mp
- OpsLogix IMP – Licensing Dashboard vx.x.x.x.mpb (where x varies)
- OpsLogix.ProView.DocumentStorage.mpb
(6) Click Open.
(7) Click Import.
(8) Restart the SCOM console.
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
11 | P a g e
2. Open the SCOM console as an administrator and then:
(1) Navigate to the Monitoring pane (2) Open the OpsLogix Licensing Dashboard
(3) Select the Keys tab (4) Click Add License
(5) Paste the license key in the text box and click the “import license(s)” key.
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
12 | P a g e
8 Installation of the ProView Visio Authoring Plugin.
1. In order to install the ProView Visio authoring plugin, Microsoft Visio 2013
and the System Center Operations Manager 2012 R2 Console (see
software prerequisites) must be installed on the machine on which you will
be installing the OpsLogix ProView Authoring Plugin.
2. Download and Unzip the ProView software package to a drive on the
computer which will be used to install the authoring plugin. There will be a directory structure created
as shown in the screenshot. (version numbers may vary).
3. I
n
s
t
a
l
l
t
h
e
f
ile “VisioAddin\setup.exe” by running the setup. (You need to be a local administrator on the
computer where the plugin is being installed).
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
13 | P a g e
4. If you are prompted for the installation of VSTO runtime, please click Accept.
5. Start Visio to check if the plugin is installed. In order to confirm that the plugin is installed correctly,
create a blank drawing in Visio. The OPSLOGIX PROVIEW tab should appear on the Visio ribbon
(see screenshot).
The installation of the ProView Authoring Plugin for Visio is now complete. If you didn’t do so already,
you need to install the ProView website in order to start authoring maps and dashboards.
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
14 | P a g e
9 Installing the ProView website
ProView uses Microsoft Internet Information Server (Microsoft IIS) for displaying maps and dashboards
created with OpsLogix ProView. In order to successfully install this component please follow the steps below
on the Microsoft Internet Information Server which has the System Center Operations Manager 2012 SP1/R2
Web Console website installed. After you complete this installation all clients viewing dashboards will need to
connect to this server.
1. Logon as an Administrator on the server that’s going to be used as Dashboard Render Engine (where
you are going to install the ProView website).
2. Start the Setup Package Website\SetupProView.msi
3. Accept the terms and click Next
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
15 | P a g e
4. Select what type of web install you would like to do. The recommend type is the “as Virtual
Directory..”
5. Select the installation location of the website and click Next.
Note: by default the installation directory is C:\Inetpub.
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
16 | P a g e
6. Enter the details for the Application Pool Settings. By default the Application Pool Name is ProView
(best practice is to keep the default name).
Change the domain, username and password to that of the user that will be used to retrieve the
dashboard data from SCOM (an account which needs at least read permission in SCOM) and click
Next.
7. Specify the SCOM Management server to be used for the SCOM SDK access
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
17 | P a g e
8. Click Install to start the installation.
9. After the installation has completed click Finish to exit the installation wizard.
10. Open IIS manager and check whether the website installation was successful.
If you selected the web install “as New Website..” there should be a new website called “ProView
Website” listening on port 5050 (you can change the port number if required).
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
18 | P a g e
If you selected the installation option “as Virtual Directory..” there should be a web application folder
below the default website.
11. Using IIS manager open the “Application Pools” folder. Check the Pool that you specified (default:
ProView) exists and is started.
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
19 | P a g e
12. Note: If the pool is not started you may have to check the credentials that you configured during
setup. You can change it by opening the selected pool at “Advanced Settings” -> “Process Model” ->
“Identity” property.
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
20 | P a g e
10 Validating Installed Components
After you have installed all the ProView components, you can check if they are functioning correctly by
following the steps below.
10.1 Check the Dashboard selection page.
In order to display the saved dashboards, open a browser on any computer and open the page:
http://<Servername>:5050/DashboardList.html or if you are not using the default virtual directory for
your ProView installation: http://<Servername>/ProViewWeb/DashboardList.html.
You should now see the Dashboard selection page that contains no dashboards:
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
21 | P a g e
10.2 Check the ProView Visio authoring Plugin.
Open Visio 2013 on the computer where you have installed the ProView Visio authoring Plugin.
1. Start Visio in order to check if the ProView Authoring plugin is installed. The ProView Authoring plugin
is installed correctly if the “OPSLOGIX PROVIEW” ribbon tab appears in the Visio ribbon bar.
2. Select the “OPSLOGIX PROVIEW” and click the “Configure Connection” button. A “Configure” dialog
window should appear. Enter the required information in the dialog box and click the “Test
Connection” button in order to validate the connection.
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
22 | P a g e
3. Click on the “Preview” tab in the “Configure” dialog box and enter the URL where the ProView website
is installed. For Example: http://olxmka01:5050/ or http://olxmka01/ProViewWeb (if you installed
ProView in a virtual directory). Make sure that the URL ends with a forward slash (/). Click “Apply And
Close” once you have entered all of the relevant settings.
4. On the “OPSLOGIX PROVIEW” tab click the “Connect to OpsMgr” button in order to connect to SCOM.
If the connection is successfully established, the disabled (greyed out) buttons on the “OPSLOGIX
PROVIEW” tab will now be enabled (and no longer be greyed out).
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
23 | P a g e
11 Appendix: Manual configuration/altering of the ProView website
If you would like to change the website for ProView, please follow the steps below.
1. If you have not already done so, install the ProView website by using the installer using the steps
described in previous chapter.
2. Click the IIS management console and select the website you would like to add the ProView website
and then click "Add Application"
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
24 | P a g e
3. In the "Add Application" dialog enter "ProViewWeb" as an alias in the "Alias" field and set the
"Physical Path" to the directory specified during the ProView web setup. (For example
"C:\Inetpub\ProViewWeb"). Select the application pool that you specified during the ProView setup.
Click OK to close the dialog.
4. Check that the Application pool is set to a .NET 4.0 application pool and check whether it is started. If
an incorrect application pool is selected, it is of crucial importance that you correct this setting.
Capacity reports Management Pack – Installation Guide
ProView – Installation Guide
www.opslogix.com/ProView
25 | P a g e
5. If necessary you can now clean up the old website as shown in the screenshot:
6. After changing the website location, the URL for ProView will have changed as well. To display the
saved dashboards in the new location, open a browser and go to the server where you installed the
ProView Web page. Open page: http://<Servername>/ProViewWeb/DashboardList.html. Select the
dashboard you would like to view.