Installation Guide - WordPress.com · 2 ProView – Installation Guide ... LICENSE AGREEMENT BETWEEN OPSLOGIX B.V. AND THE CUSTOMER 1. LICENSE GRANT: OPSLOGIX B.V. (hereinafter "OPSLOGIX")

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



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.




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




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.




5 | P a g e

2 ProView – Installation Guide

Before using ProView, read the license agreement carefully.




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




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




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




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




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.

mailto:[email protected]




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.




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).




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.




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




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.




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




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).




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.




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.




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:




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.




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).

http://olxmka01:5050/

http://olxmka01/ProViewWeb




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"




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.




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.

Documents

Installation Guide - WordPress.com · 2 ProView – Installation Guide ... LICENSE AGREEMENT BETWEEN OPSLOGIX B.V. AND THE CUSTOMER 1. LICENSE GRANT: OPSLOGIX B.V. (hereinafter "OPSLOGIX")