Live Maps for System Center Operations Manager 2007 R2 v6.2.1 Installation Guide
CONTENTS Contents... 2 Introduction... 4 About This Guide... 4 Supported Products... 4 Understanding Live Maps... 4 Live Maps Authoring Console... 5 System Requirements... 5 Installation... 5 Verification... 5 De-installation... 5 Live Maps OpsMgr Extension... 7 System Requirements... 7 Installation... 7 Verification... 7 De-installation... 7 Live Maps Mobile Device Notification Service... 8 Firewall Considerations... 8 Installation... 8 Verification... 8 Configuration... 9 De-Installation... 9 Live Maps Web Console... 10 System Requirements... 10 Firewall Considerations... 10 Installation... 10 Verification... 11 Configuration... 11 Page 2
Multiple Worker Processes... 12 De-installation... 13 Live Maps Mobile Console... 14 System Requirements... 14 Installation... 14 Configuration... 15 FAQs... 15 De-installation... 16 Live Maps Windows Gadget... 17 System Requirements... 17 Installation... 17 Verification... 17 Configuration... 17 De-installation... 19 Show Affected Live Maps Alert Task... 20 Introduction... 20 Installation and Configuration... 20 De-installation... 20 Configurable Drill down Action in Web Console... 21 INTRODUCTION... 21 Configuration... 21 Upgrading from previous versions of Live Maps... 22 Upgrade from Live Maps v2.x to Live Maps v6.2... 22 Upgrade from Live Maps v3.x to Live Maps v6.2... 22 Upgrade from Live Maps v4.x to Live Maps v6.2... 22 Upgrade from Live Maps v5.x to Live Maps v6.2... 23 Contact... 24 Page 3
INTRODUCTION ABOUT THIS GUIDE This guide describes the steps required to successfully install Live Maps for Operations Manager 2007 R2 (Live Maps). SUPPORTED PRODUCTS This version of the product is supported on Microsoft Operations Manager 2007 R2 (OpsMgr). UNDERSTANDING LIVE MAPS Live Maps uses the extensibility features of OpsMgr; it does not require a proprietary backend or agents. Views are created by an OpsMgr administrator using the Live Maps Authoring Console. To create a new view, the OpsMgr administrator launches the Authoring Console which connects to the Root Management Server (RMS) of the management group. When a view is saved, its configuration is stored in the online Live Maps Authoring management pack. Views can be viewed in three ways: (i) from the OpsMgr operations console with the Live Maps OpsMgr Extension installed, (ii) with Microsoft Internet Explorer (version 6.0 and above) and (iii) with the Live Maps Windows Gadget (only in Windows Vista and Windows 7). The Live Maps architecture is shown in the figure below: Create Maps Live Maps Authoring Console Store Maps Savision Live Maps Library Management Pack Savision Live Maps Authoring Management Pack View Maps OpsMgr Console + Live Maps Extension OpsMgr Console + Show Affected Maps task Live Maps Web Console Live Maps Windows Gadget Page 4
LIVE MAPS AUTHORING CONSOLE SYSTEM REQUIREMENTS The Live Maps Authoring Console must be installed on a computer running the OpsMgr R2 Operations Console. INSTALLATION To install the Live Maps Authoring Console, follow these steps: 1. Logon to a computer running the OpsMgr Operations Console. 2. Run Setup.LiveMaps.exe from the installation CD/ISO image. 3. Select the Install Live Maps Authoring Console option under Installation and follow the installer instructions. VERIFICATION To verify the Live Maps Authoring Console installation, follow these steps: 1. Start the Live Maps Authoring Console (Start All Programs Savision Live Maps for OpsMgr R2 Authoring Console). 2. Every time the Live Maps Authoring Console is started, a connection logon dialog is displayed. Specify the name of the Root Management Server and click OK. The first time the Live Maps Authoring Console is started, a valid license key needs to be entered before Live Maps can be used. 3. After connecting to the OpsMgr server, the Live Maps Authoring Console prepares the OpsMgr environment; this may take a few minutes. During this time, two management packs required by Live Maps are automatically imported: (i) the Savision Live Maps Library and (ii) the Savision Live Maps Authoring management pack. DE-INSTALLATION Remove the Live Maps Authoring Console via Programs and Features in the Control Panel (or via the Add/Remove Programs option in the Control Panel on computers running previous Windows versions). Finish the de-installation by manually deleting the two Live Maps management packs according to the steps below. Note: Removing the Live Maps management packs results in the loss of all maps created with the Live Maps Authoring Console! 1. Logon to a computer running the OpsMgr Operations Console. Page 5
2. Start the OpsMgr Operations Console (Start All Programs System Center Operations Manager 2007 R2 Operations Console). 3. Go to the Administration space 4. Select Management Packs in the administration navigation tree 5. Select the Savision Live Maps vx Authoring management pack in the result pane and press the Delete button 6. Select the Savision Live Maps Library management pack in the result pane and press the Delete button Page 6
LIVE MAPS OPSMGR EXTENSION SYSTEM REQUIREMENTS The Live Maps OpsMgr Extension must be installed on a computer running the OpsMgr R2 Operations Console. INSTALLATION To install the Live Maps OpsMgr Extension, follow these steps: 1. Logon to a computer running the OpsMgr Operations Console. 2. Run Setup.LiveMaps.exe from the installation CD/ISO image. 3. Select the Install Live Maps OpsMgr Extension option under Install and follow the installer instructions. VERIFICATION To verify the Live Maps OpsMgr Extension installation, follow these steps: 1. Start the OpsMgr Operations Console (Start All Programs System Center Operations Manager 2007 R2 Operations Console). 2. In the Monitoring space open a view created with the Live Maps authoring console. DE-INSTALLATION Remove the Live Maps OpsMgr Extension via Programs and Features in the Control Panel (or via the Add/Remove Programs option in the Control Panel on computers running previous Windows versions). Page 7
LIVE MAPS MOBILE DEVICE NOTIFICATION SERVICE The Live Maps Mobile Device Notification Service is a Windows Service that will send notifications to mobile devices such as smart phones and tablets when the health states of individual Live Maps change. Only one Mobile Device Notification Service should be installed per Operations Manager management group. You do not need to install the service if you will not be using any mobile devices with Live Maps. Before installing the service, you should run the latest version of the Live Maps Authoring Console. This will ensure that the management packs that the service depends on are loaded into Operations Manager. FIREWALL CONSIDERATIONS The server hosting the Live Maps Mobile Device Notification Service needs to be able to contact the root management server on port 5724. The server also needs to be able to contact the outside world via https on port 443. INSTALLATION To install the Live Maps Mobile Device Notification Service, follow these steps: 1. Logon to the computer that will host the Live Maps Mobile Device Notification Service. 2. Run Setup.LiveMaps.exe from the installation CD/ISO image. 3. Select the Install Mobile Notifications option under Install and follow the installer instructions. 4. When prompted for System Center Operations Manager Credentials please provide the server name of the root management server as well as the credentials of a user with Administrative rights within System Center Operations Manager. These credentials will not be shared with mobile devices, but will be used to update the devices within Operations Manager. VERIFICATION To verify the Live Maps Mobile Device Notification Service installation, follow these steps: 1. Start the Operations Manager Console. 2. Navigate to the folder Monitoring Live Maps Mobile Mobile Device Notification Service. 3. Verify that the service is eventually discovered and reported as healthy by Operations Manager (this will require that the server hosting the Live Maps Mobile Device Notification Service is monitored by Operations Manager). Page 8
CONFIGURATION If necessary, modify the Live Maps Mobile Device Notification Service configuration using the Mobile Device Notifier Configuration application (Start All Programs Savision Live Maps for OpsMgr R2 Mobile Device Notifier Configuration). DE-INSTALLATION Remove the Live Maps Mobile Device Notification Service via Programs and Features in the Control Panel (or via the Add/Remove Programs option in the Control Panel on computers running previous Windows versions). Page 9
LIVE MAPS WEB CONSOLE The Live Maps Web Console is an ASP.NET application and is installed on a server running IIS 6.0 or higher. The Live Maps Web Console supports Windows and Forms authentication. For Windows authentication the Live Maps Web Console must be installed on the root management server. For Forms Authentication it is advised to install the Live Maps Web Console on an IIS server secured with certificates (SSL). SYSTEM REQUIREMENTS HARDWARE: Minimum: - 1GB RAM - 5 GB of available hard disk space - 1.8 GHz Recommended: - 2GB RAM - 20 GB of available hard disk space - 2.8 GHz SOFTWARE: -.NET Framework 2.0 -.NET Framework 3.5 Service Pack 1 - Internet Information Server (IIS) 6.0 or higher - ASP.NET 2.0 FIREWALL CONSIDERATIONS The server hosting the Live Maps Web Console needs to be able to contact the root management server on port 5724. If you are using the mobile device feature of Live Maps, mobile devices (such as smartphones and tablets) outside the network will need to be able to contact the Live Maps Web Console. It is strongly recommended that you enable SSL to protect connections from the outside world to the Live Maps Web Console. INSTALLATION To install the Live Maps Web Console, follow these steps: 1. Logon to the computer that will host the Live Maps Web Console. 2. Run Setup.LiveMaps.exe from the installation CD/ISO image. 3. Select the Install Live Maps Web Console option under Install and follow the installer instructions. Page 10
4. When prompted for System Center Operations Manager Credentials please provide the credentials of a user with Administrative rights within System Center Operations Manager. These credentials will not be shared with clients of the web console, but will be used to update the state of clients within Operations Manager. VERIFICATION To verify the Live Maps Web Console installation, follow these steps: 1. Start the Live Maps Web Console (Start All Programs Savision Live Maps for OpsMgr R2 Web Console). Or, with Microsoft Internet Explorer, open the URL http://<web server hosting Live Maps Web Console>:52909. 2. Open a view created with the Live Maps Authoring Console. CONFIGURATION If necessary, modify the Live Maps Web Console configuration using the Web Console Configuration application (Start All Programs Savision Live Maps for OpsMgr R2 Web Console Configuration). The Live Maps Web Console configuration settings are explained in the following table: Setting Description Default Value Root Management Server OpsMgr Web console URL Name of the OpsMgr Root Management Server The URL to the OpsMgr web console you want to use for integration. Set during installation Set during installation Page 11
Setting Description Default Value Refresh time Show alerts newer then Maximum number of alerts shown Show Critical Alerts Show Warning Alerts Show Information Alerts The number of minutes the application will wait before refreshing current view data Age limit (in days) of alerts displayed in the console Maximum number of alerts displayed in the console True if the critical alerts should be displayed in the web console alert list. True if the warning alerts should be displayed in the web console alert list. True if the information alerts should be displayed in the web console alert list. 5 7 50 True True False Show Health Details Show health details in a drawing view or not True MULTIPLE WORKER PROCESSES If many users use the Live Maps web console simultaneously, the result could be a slow user experience as by default the web console uses only one IIS worker process. The following instructions detail the configuration steps required to allow the web console to run on multiple worker processes. 1. Browse to the Live Maps Web Console root folder. 2. Open web.config in notepad. 3. Remove the comment strings <!-- and --> from the following fragment: <!--<sessionstate mode="stateserver" stateconnectionstring="tcpip=127.0.0.1:42424" cookieless="false" timeout="20"/>--> <!-- 4. Save the web.config file and close notepad. 5. Open IIS Manager and open the Advanced Settings of the Live Maps v6 Web Console application pool. (See image 1) 6. Change the Maximum Worker Processes to a value larger than 1. The correct value for this depends on multiple factors like number of processor cores, other software running on the machine, and number of Live Maps web console users. You may want to experiment by slowly increasing the value until it resolves the responsiveness of the web console. 7. Check if the ASP.NET State Service is started. (Make sure the Startup Type is set to automatic) (See image 2) Page 12
Image 1 Image 2 NOTE: Multiple worker processes are supported by Live Maps v6.2 and higher. DE-INSTALLATION Remove the Live Maps Web Console via Programs and Features in the Control Panel (or via the Add/Remove Programs option in the Control Panel on computers running previous Windows versions). Page 13
LIVE MAPS MOBILE CONSOLE SYSTEM REQUIREMENTS The Live Maps Mobile Console must be downloaded and installed through either the Apple App store or the Google Play store. On Android we require you to have version 2.3.3(Gingerbread) and up, on iphone we require version 5.0 and up. To get states and other Live Maps information on your mobile device, we need the Live Maps Web Console to be installed and be exposed to the internet. Note that we currently we only support Forms- Authentication. If you want to receive notifications on your devices, we need the Live Maps Mobile Device Notification Service to be installed. INSTALLATION To install the Live Maps Mobile Console, depending on your device, follow these steps. On your mobile Android device: 1. Go to the Google Play store on you mobile device. 2. Tap the Search button in the upper right corner and type Savision Live Maps for Mobile. 3. After a couple of moments a list should appear with Savision Live Maps for Mobile, tap this. 4. Tap the Install button. 5. Review the EULA and permission required for the app to run. 6. Tap the Accept & Download button. On the Google Play store in your web browser: 1. Type Savision Live Maps for Mobile in the search bar at the top. 2. Click the Install button. 3. If you haven t signed in with your Google Account at this point, the store will ask you to do so. 4. Click the Install button again. 5. Click the Ok button. 6. The app will now begin to download and install on you mobile device. On your mobile ios device: 1. Go to the itunes Store app. 2. Tap on the Search button in the bottom. 3. In the search bar, type Live Maps Mobile, then tap Search. 4. After a couple of moments a list will appear with Live Maps Mobile. Tap on the app icon. 5. Tap on the Install button. 6. As part of the itunes store procedure, fill in your itunes password. 7. The app will now begin to download and install on your mobile device. On the itunes store: 1. In itunes, click on the itunes Store button in the upper right corner. 2. Type Live Maps Mobile in the search bar, located in the upper right corner and press enter. Page 14
3. In the iphone Apps section, located Live maps Mobile and click the free button. 4. As part of the itunes store procedure, fill in your itunes password. 5. The app will now begin to download on your desktop. The next time you sync your iphone with itunes the app will be installed. CONFIGURATION On your first launch of the app, it will prompt you to specify the Live Maps Web Console address and the credentials you want to use to retrieve the maps. If you want to revisit these settings, you can always return to the settings screen and make adjustments. FAQS DURING THE INSTALLATION OF THE MOBILE DEVICE NOTIFICATION SERVICE I GET PROMPTED FOR SYSTEM CENTER OPERATIONS MANAGER CREDENTIALS, WHY DO I NEED TO SPECIFY TH ESE? Our notifications service needs to keep track of the mobile device and what Live Maps each device is interested in, so we know what notification to send and where to send them. We keep this information registered in the Savision Live Maps Mobile Device Notification Management Pack. We use the credentials provided to update this information. We do not share these credentials with the mobile clients. To see which devices are registered (and checkup on the health of the Notification Service) 1. Start the OpsMgr Operations Console (Start All Programs Microsoft System Center 2007 Operations Manager Operations Console). 2. In the monitoring space, navigate to the folder Live Maps Mobile.. 3. Here you can check the health of the service in the Mobile Device Notification Service view or check which devices have been registered in the Registered Mobile Devices view. WHY IS THERE A SLIGHT DELAY IN RECEIVING NOTIFICATIONS ON A STATE CHANGE? We poll OpsMgr every 5 minutes for states changes for the maps the devices have told it to monitor. If a state has changed in those 5 minutes we send a notification to the interested devices. HOW DO I DELETE A FAVORITE VIEW (REGARDLESS OF MY MOBILE PLATFORM)? There are two ways of doing this: 1. In the Favorites Maps View locate the view you want to delete and swipe this view, tap the delete button that appears and wait for the favorite to disappear. 2. Navigate to the Search view (on Android: Menu Search, on ios: Configuration Favorite Views) and type the name of the favorite Live Map (or common denominator of multiple favorites) you want to remove. 3. After the search has completed you can deselect these Live Maps and then return to the Favorites view. Page 15
DE-INSTALLATION On any ios device 1. Locate the Live Maps Mobile app on your screen. 2. Tap and hold the Live Maps Mobile app. 3. Once all the icons the screen start shaking, press the X on the icon. 4. Confirm that you want to delete the app. On any Android device. 1. Locate the settings app. 2. Navigate to Apps (or Applications) All Savision Live Maps for Mobile 3. Tap the Uninstall button. 4. Confirm that you want to delete the app. After this you will need to decide if the Live Maps Web Console and the Live Maps Notification Service need to be de-installed. Page 16
LIVE MAPS WINDOWS GADGET SYSTEM REQUIREMENTS The Live Maps Windows Gadget must be installed on a computer running the Windows Vista or Windows 7 Operating System. INSTALLATION To install the Live Maps Windows Gadget, follow these steps: 1. Logon to a computer with Windows Vista or Windows 7. 2. Run Setup.LiveMaps.exe from the installation CD/ISO image. 3. Select the Install Live Maps Windows Gadget option under Install and follow the installer instructions. VERIFICATION To verify the Live Maps Windows Gadget installation, follow these steps: Windows Vista: 1. Start the Windows Sidebar (Start All Programs Accessories Windows Sidebar). 2. Right-click in the Sidebar and select the menu item Add Gadget... 3. Check if the gadget Live Maps for Operations Manager R2 is in the dialog. Windows 7: 1. Right-click on the desktop and select the menu item Gadgets 2. Check if the gadget Live Maps for Operations Manager R2 is in the dialog. CONFIGURATION After installation, the Live Maps gadget should be configured to show a summary of the states on a specific view on the Live Maps Web Console. The Live Maps gadget configuration can be accessed by right-clicking the gadget and choosing Options from the context menu. Alternatively, click on the Live Maps gadget so it has the 'focus', then click the spanner symbol to activate the options, like shown below: Page 17
A window similar to the one shown on the next page will open. The Live Maps Windows Gadget configuration settings are explained in the following table: Setting Description Default Value Live Maps web console URL Use current user User Password Domain Current view Search for a view Update Frequency Open view in browser The URL to the Live Maps web console you want to use. The credentials of the current user will be used to access the Live Maps web console. The username that will be used to access the Live Maps web console. The password that will be used to access the Live Maps web console. The domain that will be used to access the Live Maps web console. The view on the Live Maps web console that will be accessed to populate the gadget. Specify (part of) the name of the view on the Live Maps web console and click the magnifier to select the view to use. The number of minutes the application will wait before refreshing current view data When checked, the associated Live Maps web console view will open in the browser instead of the fly out window. http://<your server>:52909 True - - - No view selected - 5 False Page 18
You can run multiple instances of the Live Maps gadget in the sidebar. You don't even need to have the OpsMgr Operations Console installed. DE-INSTALLATION Windows Vista: 1. Start the Windows Sidebar (Start All Programs Accessories Windows Sidebar). 2. Right click in de Sidebar and select the menu item Add Gadget... 3. Right click on the gadget Live Maps for Operations Manager R2 and select the menu item Uninstall. Windows 7: 1. Right click on the desktop and select the menu item Gadgets 2. Right click on the gadget Live Maps for Operations Manager R2 and select the menu item Uninstall. Page 19
SHOW AFFECTED LIVE MAPS ALERT TASK INTRODUCTION With Live Maps v5 functionality has been added to launch the Live Maps Web Console with the map that is affected by an alert shown on the OpsMgr Operations Console. INSTALLATION AND CONFIGURATION To install the Show Affected Live Maps task, follow these steps: 1. Open the Live Maps Web Console Configuration application (Start All Programs Savision Live Maps for OpsMgr R2 Web Console Configuration). 2. Choose the Show affected Live Maps console task info tab. 3. Use the Check button in the bottom half of the Configuration application to verify connectivity to the Web Server hosting the Live Maps Web Console and the Root Management Server: When multiple instances of the Live Maps Web Console are installed, the Live Maps Web Console instance that is to be used can be specified as the Current URL. 4. When the connectivity has successfully been verified, the button changes to Install. 5. Use the Install button to import the Savision Live Maps Tasks Management Pack on the Root Management Server. DE-INSTALLATION Remove the Savision Live Maps Tasks Management Pack by using the Uninstall button in the Live Maps Web Console Configuration application, or use the procedure as described in the de-installation of the Live Maps Authoring Console to delete the Savision Live Maps Tasks Management Pack. Page 20
CONFIGURABLE DRILL DOWN ACTION IN WEB CONSOLE INTRODUCTION The action that occurs when the user is clicking on an object in the Live Maps Web Console is now configurable. In case of a normal monitoring object Savision Vital Signs can be opened if Vital Signs supports the role of clicked object. If the Operations Manager Web Console url is configured on the Settings tab the following Operations Manager Web Console views can be opened: Health explorer Performance view State view Diagram view In case of a distributed application object the following Operations Manager Web Console views can be opened: Health explorer Diagram view Note: The Operations Manager Web Console views will only work in Internet Explorer. CONFIGURATION To configure the drill down actions, follow these steps: 1. Open the Live Maps Web Console Configuration application (Start All Programs Savision Live Maps for OpsMgr R2 Web Console Configuration). 2. Choose the Show affected Live Maps console task info tab. 3. Use the Open Vital Signs checkbox to enable or disable the use of Savision Vital Signs when a monitoring object is clicked. Use the combo boxes to choose the drill down action for a monitoring object or distributed application when the Operations Manager Web Console url is set on the Settings tab. 4. Press the Apply or OK button to save the changes. Page 21
UPGRADING FROM PREVIOUS VERSIONS OF LIVE MAPS UPGRADE FROM LIVE MAPS V2.X TO LIVE MAPS V6.2 The Live Maps setup will install the Live Maps v6.2 environment next to an existing Live Maps v2 installation. The Live Maps views that have been created with version 2 of Live Maps, for use with Operations Manager 2007 SP1, are not compatible with the format used in this version of Live Maps for Operations Manager 2007 R2. A Live Maps view conversion tool is available at www.savsion.com/download that will create a copy of each existing Live Maps v2 view in a Live Maps v5 compatible format. The original Live Maps v2 views will not be altered or deleted by the Live Maps view conversion tool. The License Key used for Live Maps v2 will not work in Live Maps for Operations Manager 2007 R2. Please contact our sales team at sales@savision.com to request a new License Key for Live Maps for Operations Manager 2007 R2. UPGRADE FROM LIVE MAPS V3.X TO LIVE MAPS V6.2 The Live Maps setup will upgrade an existing Live Maps v3 installation to a Live Maps v6.2 installation. The Live Maps views that have been created with version 3 of Live Maps, for use with Operations Manager 2007 SP1, are fully compatible with the format used in this version of Live Maps for Operations Manager 2007 R2. No Live Maps view conversion is required. The License Key used for Live Maps v3 will not work in Live Maps for Operations Manager 2007 R2. To request a new License Key for Live Maps for Operations Manager 2007 R2, contact the Savision Sales Team via email at sales@savision.com or use the contact form at /contact. Note: After using the upgraded Live Maps Authoring Console for the first time, all Live Maps OpsMgr Extensions and Live Maps Web Consoles need to be upgraded also to function properly using the Live Maps v6 environment. UPGRADE FROM LIVE MAPS V4.X TO LIVE MAPS V6.2 The Live Maps setup will upgrade the existing Live Maps v4 installation to a Live Maps v6.2 installation. The Live Maps views that have been created with version 4.x of Live Maps are fully compatible with the format used in this version of Live Maps v6.2 for Operations Manager 2007 R2. No Live Maps view conversion is required. The License Key used for Live Maps v4.x will not work in Live Maps v6.2 for Operations Manager 2007 R2. Page 22
To request a new License Key for Live Maps for Operations Manager 2007 R2, contact the Savision Sales Team via email at sales@savision.com or use the contact form at /contact. Note: After using the upgraded Live Maps Authoring Console for the first time, all Live Maps OpsMgr Extensions and Live Maps Web Consoles need to be upgraded also to function properly using the Live Maps v6 environment. UPGRADE FROM LIVE MAPS V5.X TO LIVE MAPS V6.2 The Live Maps setup will upgrade the existing Live Maps v5 installation to a Live Maps v6.2 installation. The Live Maps views that have been created with version 5.x of Live Maps are fully compatible with the format used in this version of Live Maps v6.2 for Operations Manager 2007 R2. No Live Maps view conversion is required. The License Key used for Live Maps v5.x will not work in Live Maps v6.2 for Operations Manager 2007 R2. To request a new License Key for Live Maps for Operations Manager 2007 R2, contact the Savision Sales Team via email at sales@savision.com or use the contact form at /contact. Note: After using the upgraded Live Maps Authoring Console for the first time, all Live Maps OpsMgr Extensions and Live Maps Web Consoles need to be upgraded also to function properly using the Live Maps v6.2 environment. Page 23
CONTACT For additional information, go to /support or email support@savision.com. Page 24