Installation Guide Savision iq

Size: px

Start display at page:

Download "Installation Guide Savision iq"

Julius Short
5 years ago
Views:

1 Installation Guide Savision iq

Contents 1. Introduction... 3 1.1 About This Guide... 3 1.2 Supported Integrations... 3 1.3 Software Components... 3 2. Installing Savision iq... 4 2.1 Upgrading from Savision iq Beta 1& 2... 4 2.2 Frequently Asked Questions - Installation.

2 Contents 1. Introduction About This Guide Supported Integrations Software Components Installing Savision iq Upgrading from Savision iq Beta 1& Frequently Asked Questions - Installation What are the computer requirements for Savision iq? Pre-Installation Tasks What User Names and Passwords do I need? What Roles & Features do I need to install? What other requirements do I need? Installation Configure Savision iq Frequently Asked Questions What is the impact of iq? Is it read-only to source systems? How does iq connect to SolarWinds? What outbound ports are used by the integrations? What permissions are required to connect to ServiceNow? How do I get an out of the box saved search back after it is deleted? Support Known Issues... 8 ServiceNow and Ivanti Marketplace Apps Pending Certification

3 1. Introduction 1.1 About This Guide This guide describes the steps required to successfully install and run Savision iq. 1.2 Supported Integrations Savision iq provides integration with the follow: System Center Operations Manager 2012 SP1, 2012 R2 and SolarWinds Orion Nagios Core and XI VMware vcenter Microsoft Azure Amazon Web Services (AWS) ServiceNow Ivanti Service Management (Powered by HEAT) 1.3 Software Components Savision iq has the following software components: Web application running in IIS (Core) Middleware running together with Core in IIS (Local Agent) Elasticsearch data store ( NOTE: By default, Elasticsearch is installed in the Program Files directory and is where the bulk of the data Savision iq collects is stored. Please see section 2.1 for storage requirements on this drive. Microsoft SQL Server 2012 or higher, for configuration store. 3

4 2. Installing Savision iq 2.1 Upgrading from Savision iq Beta 1& 2 There is no upgrade path to Savision iq from Savision iq Beta 1 & 2. However, the SQL database can be upgraded. We store all user configuration in the SQL database, so you will not lose your existing integrations. You will lose the data we have collected from the integrations, but once Savision iq starts up, it will collect all that information once again, and the only thing lost will be the limited amount of history that would have been stored while running Savision iq Beta 1 or 2. Steps to Upgrade from Savision iq Beta 1 or 2: -Uninstall Savision iq from the Control Panel -Ensure the IIS Application Pool and Website have been removed (using IIS Manager) -Stop the Elasticsearch service. -Delete the Elasticsearch indices. This is where the collected data is stored. We ve made some breaking schema changes in Savision iq, so the old data will not be supported. To remove the indices, remove the folders found in \Program Files\Savision\Elasticsearch\elasticsearch\data\nodes\0\indices. The folders will have obscure names such as htc1mxcjt6u8c3_jpn_gsw. The indices folder should be empty before installing Savision iq. - Uninstall the ElasticSearch that was part of the Beta 1 and 2 installations. The Savision iq installation package contains a newer version which resolves some bugs we found. -Install Savision iq. 2.2 Frequently Asked Questions - Installation What are the computer requirements for Savision iq? The Savision iq application needs to be installed on a Windows Server 2008 R2 or higher with IIS 7.5 or higher. Also network connectivity to your integrated source systems and a Microsoft SQL server is needed. We highly recommend Google Chrome as a browser for optimal performance. The hardware requirements for Savision iq are: Component Minimum Requirement Recommended Processor 1.4 GHz 2 GHz or faster Memory 8 GB RAM 16 GB or greater, but not greater then 64GB Available Server Disk Space (Program Files directory) 2 GB per integration 10 GB or greater per integration Available SQL Server Disk Space 20 MB 100 MB For detailed information about sizing Elasticsearch see: 4

5 2.3 Pre-Installation Tasks What User Names and Passwords do I need? Ø Administrator access to the operating system to install the required software Ø Administrator access to a Microsoft SQL Server What Roles & Features do I need to install? The Savision iq installer is capable of adding the roles and features needed for Savision iq to function properly. If you want to install these manually, you will have to add the following Roles & Features to your Windows Server: Roles: Ø Web Server (IIS) Ø Common Ø Default Document Ø Static Content Ø Health and Diagnostics Ø HTTP Logging Ø Security Ø Request Filtering Ø Windows Authentication Ø Application Development Ø.Net Extensibility 4.5 Ø ASP.NET 4.5 Ø ISAPI Extensions Ø ISAPI Filters Ø Management Tools Ø IIS Management Console Features: Ø.NET Framework 3.5 Features Ø.NET Framework 3.5 (includes.net 2.0 and 3.0) Ø.NET Framework 4.5 Features Ø.NET Framework 4.5 Ø ASP.NET 4.5 Ø WCF Services Ø HTTP Activation Ø TCP Port Sharing Enable automatic start-up for the Windows Process Activation (WAS) and World Wide Web Publishing (W3SVC) services (enabled by default) What other requirements do I need? Elasticsearch requires Java to be installed. We strongly recommend using the latest JRE 8 (at least u20 or higher). The installer will guide you to the correct Java download page. After installing Java, make sure the JAVA_HOME environment variable is configured correctly. Savision iq requires.net Framework or higher to be installed. 5

6 2.4 Installation The Savision iq installation package contains two installers: Savision iq-2.0.exe Elasticsearch exe The Savision iq installer will launch the Elasticsearch installer, if needed. To install Savision iq you have to execute Savision iq-2.0.exe. The installer will guide you through installing pre-requisites and where possible will install them automatically. During the installation, the wizard will ask for a connection to a SQL Server instance and credentials. These credentials mush have enough privileges to create a new database. If a Windows Account is provided, this account will also be used as the application pool identity. However, if SQL authentication is used then the installer will pick the Network Services account as the application pool identity. The credentials used in the installer are also used by Savision iq to operate. The installer will create and use a self-signed certificate for the https binding. If you want an http binding (not recommended) or use your own SSL certificate you can change this using the IIS manager after the installation as completed. By default, the Elasticsearch is not bound to an external IP address so there is no user authentication enabled. The default URL for the Savision iq application will follow this example: FQDN>:529212/ Elasticsearch is a distributed, RESTful search and analytics engine Savision iq uses to store and search data from the integrated systems. By default, the Savision iq, installation will install ElasticSearch on the web server. This works fine in an evaluation scenario or with limited users, integrations and data. Using Savision iq in a more demanding scenario we advise to setup a multi node ElasticSearch cluster. Documentation about how to set this up can be found here The Savision iq installer installs ElasticSearch, so it is only accessible on the local system, but without authentication. When security is required, for example when ElasticSearch is installed on a different machine, you need to use x-pack. The details how to install x-pack can be found here. With x-pack you can also do monitoring. Connection settings are configured in the web.config under <connectionstrings> the ElasticSearch connection string can be defined as followed: Default: <add name="defaultelasticsearchconnection" connectionstring="nodes= /> Multi node cluster: <add name="defaultelasticsearchconnection" connectionstring="nodes= /> With authentication: <add name="defaultelasticsearchconnection" connectionstring="nodes= Username=iquser, Password=secret" /> 6

7 3. Configure Savision iq Before you can start using Savision iq there are two configuration tasks that you have to do: First you need to activate a valid license key. If you don t have a license key already please contact Savision sales. The second is that Savision iq needs to know where it can find data from the supported source systems. This can be done by navigating to FQDN>:529212/#/admin on the Integrations tab. All new integrations can be added and configured there. 4. Frequently Asked Questions 4.1 What is the impact of iq? We ve kept the impact on the source system as small as possible. The first time it will load all components, alerts and incidents, after that it will only load data that has changed since the last load time. You can control how often data gets loaded; by default, it loads component properties every hour and health states, alerts and incidents every 2 minutes. 4.2 Is it read-only to source systems? Savision iq has the capability to resolve alerts from connected monitoring systems, as well as to create and update incidents in connected ITSM systems. All other actions are readonly. 4.3 How does iq connect to SolarWinds? We use the SolarWinds Information Service (SWIS) to load data from SolarWinds Orion ( 4.4 What outbound ports are used by the integrations? System Center Operations Manager: 5724 SolarWinds: Nagios Core and XI: 443 or configured in the url VMware vcenter: 443 Microsoft Azure: 443 Amazon Web Services (AWS): 80 and 443 ServiceNow: 443 Ivanti Service Management (HEAT Software is now Ivanti): 443 Cloud instance: 443 On Premise: 80 or What permissions are required to connect to ServiceNow? A scoped application is created for Savision iq. This application is available in the ServiceNow Store. After the Savision iq app is installed, in your ServiceNow instance, a user with the role x_savis_savision iq Role can be used in the integration settings for ServiceNow. 7

8 4.6 How do I get an out of the box saved search back after it is deleted? We automatically add saved searches to Savision iq. But because we don t know if those saved searches are also useful for your environment we made it possible to delete them. What if an out of the box saved search is deleted by accident. For that scenario, we added an application setting that will trigger Savision iq to restore the saved searches. This setting is in the SQL database the Savision iq configuration data is stored in and can be set using the following SQL query: UPDATE [Savision_iQ].[dbo].[AppSettings] SET Value = 'false' WHERE Name = 'SavedSearchesImported' 5. Support If you need help or encounter any issues to report then please contact support 6. Known Issues 6.1 ServiceNow and Ivanti Marketplace Apps Pending Certification Both the ServiceNow and Ivanti marketplace apps are pending certification. We expect this to be completed before the end of October If you have any questions on the functionality provided by the ServiceNow or Ivanti apps, please don t hesitate to reach out to support@savision.com. We d be happy to have a chat with you or even give you a demonstration of the functionality. 8

Installation Guide. Savision iq V Amsterdam - Ottawa - Dallas

Installation Guide. Savision iq V Amsterdam - Ottawa - Dallas Installation Guide Savision iq V2.5.1 Amsterdam - Ottawa - Dallas Installation Guide Savision iq V2.5.1 1. Introduction 1.1 About this Guide 1.2 Understanding Savision iq 2. System Requirements 2.1 Server