ProView Dynamic Azure and System Center insights Installation Guide For System Center operations Manager 2012
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. 2 P a g e
Table of Content 1 License Agreement 4 2 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 3 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, nonassignable 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. 4 P a g e
2 Before using ProView, read the license agreement carefully. 5 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 6 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 o o Microsoft.NET 4.0 components enabled Microsoft Internet Information Server (IIS) components enabled on the server which ProView will be installed 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 7 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 Viewer Proview Dashboard Visio Author IIS WebServer Proview Website ProView Webservice SCOM SDK Service 8 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: OpsLogix Proview License Proview Visio Addin Proview Website 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. 9 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 sales@opslogix.com 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. 10 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. 11 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). 12 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. 13 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 14 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. 15 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 16 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). 17 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. 18 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. 19 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: 20 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. 21 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). 22 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" 23 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. 24 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. 25 P a g e