USER GUIDE. Snow Integration Manager. Version 4.7. Release date Document date SNOWSOFTWARE.COM

Transcription

1 USER GUIDE Product Snow Integration Manager Version 4.7 Release date Document date

2 CONTENTS Introduction... 4 Prerequisites... 4 Installation... 5 Configuration... 6 General... 6 Inventory File handling... 7 Local Inventory server... 7 Remote Inventory server... 7 Software filtering... 8 Connector options VMware AirWatch Symantec Altiris BMC Atrium Discovery and Dependency Mapping Citrix XenServer Dell KACE FrontRange Discovery HEAT Discovery HP Discovery & Dependency Mapping Inventory HP Server Automation IBM BigFix Inventory IBM License Metric Tool IBM Tivoli Asset Discovery for Distributed Inventory File Forwarder iquate iqsonar LANDesk Microsoft Hyper-V Microsoft SCCM MobileIron Red Hat Enterprise Virtualization ServiceNow ServiceNow Scoped Application Snow Device Manager Snow Inventory Oracle Scanner Snow Xml VMware vsphere Logging Import provider settings Page 2 of 47

3 About Snow Integration Manager Page 3 of 47

4 INTRODUCTION This document describes how to install and configure Snow Integration Manager. PREREQUISITES Very important! Read before beginning the installation. Verify that the server meets the system requirements for this product; see the document System Requirements for all Snow products, which is available for download at: For configuration of the Snow Integration Connectors, a user account with read-only access rights to the database or on the server is normally required. If additional access rights are required for a specific connector, these will be described in detail in the section of that particular connector. Configuration of Snow third party inventory connectors for IBM TAD4D and IBM ILMT require that IBM Data Server Driver Package is installed on the server where the Snow Integration Manager is installed. Download the latest version of Snow Integration Manager from: ftp://ftp.snowsoftware.com Page 4 of 47

5 INSTALLATION Make sure that the requirements listed in System Requirements for all Snow products are fulfilled before continuing with the installation. 1. Uninstall any previous versions of Snow Integration Manager (or Snow External Data Provider). 2. To start the installation, double-click the file SetupSIM.exe. 3. The Snow Integration Manager Setup wizard is started. Click Next. 4. Read and accept the terms of the End User License Agreement. Click Next. 5. In the Custom setup step, select which connectors to install, and select location for the installation files. Click Next. 6. In the Ready to install Snow Integration Manager step, click Install to start the installation. 7. After the installation has completed, click Finish to exit the Snow Integration Manager Setup wizard. Page 5 of 47

6 CONFIGURATION To configure the Snow Integration Manager, open the Snow Integration Manager Properties which is located in the start menu. GENERAL Select global settings for Site id and aggregation scheduling. The global Site id setting can be overridden using the Site id setting in the connector specific options. NOTE The global setting for aggregation scheduling will affect all connectors. If connectors are to be scheduled separately, do not enable this setting. 1. In the Site id box, type the site name provided by the Service Provider (SPE platforms only), or the default site name used in the Snow Inventory installation (Enterprise). 2. In the Scheduling section, schedule an aggregation interval (or disable it). Page 6 of 47

7 INVENTORY FILE HANDLING Select method for handling of inventory data. LOCAL INVENTORY SERVER When Snow Inventory Server is running on the same server as the Snow Integration Manager, do the following: 1. Click the Save to local inventory server check box. 2. Specify the incoming folder in the Inventory incoming file folder box. EXAMPLE C:\Program Files\Snow Software\Snow Inventory\Data\Incoming REMOTE INVENTORY SERVER When sending the inventory data to a remote inventory server (i.e. Snow Inventory Data Receiver), do the following: 1. Click the Save to remote inventory server check box. 2. Type the complete URL in the Url box. EXAMPLE Page 7 of 47

8 3. To activate and use proxy functionality, click Proxy. The Proxy settings dialog box appears. 4. Click the Use proxy check box. 5. In the Settings section, use the default proxy configured in Internet Explorer by clicking the Use default proxy check box, or configure manual proxy settings in the boxes. SOFTWARE FILTERING The Software filtering section lists folder paths and file types, which by default are excluded from/included in the inventory. NOTE Software filtering is only applicable for the Microsoft SCCM 2007/2012 and LANDesk connectors. EXAMPLE Using the filter in the image below, all content of the folder _:\WINDOWS\* will be excluded except for the folder _:\WINDOWS\SYSTEM32\SPOOL\DRIVERS\*. Page 8 of 47

9 By default, only.exe and.dll file types will be included in the inventory, but more file types can be added. 1. To remove a filter, select filter in the list and then click Remove. 2. To create a new filter, click Add. The Add software filter dialog box appears. To exclude a folder, type a path in the Filter box, and the click the Excluding check box. Click Save. To include a folder in an already excluded path, type a path in the Filter box, and then leave the Excluding check box cleared. Click Save. To include a new file extension, type the extension in the Filter box, and then click the Is extension check box. Click Save. Page 9 of 47

10 CONNECTOR OPTIONS Select which connectors to configure. For details of the specific configuration options for each connector, see the sections that follow. 1. To add connectors, select connector in the Available connectors list and then click Add >>. 2. To remove connectors from the Active connectors list, select connector and then click << Remove. 3. To configure connector specific options, click Settings For each specific connector, see the sections that follow. 4. To configure a schedule for a selected Active connector, click Schedule. 5. To rename an Active connector, select connector and then click Rename. 6. To start an immediate aggregation for a selected connector, click Aggregate selected. This option is mostly used for test purposes. 7. In the Missing metadata reporting level list, select how to handle reporting of missing metadata. 8. To include software that lacks description, click the Include software with missing metadata check box. The filename will be used as placeholder for the description. Page 10 of 47

11 VMWARE AIRWATCH The AirWatch connector uses an API connection. 1. In the API URL (Host) box, type the URL to the AirWatch Web API. EXAMPLE 2. In the User Id and Password boxes, type credentials for a user account with access to the AirWatch Web API. The account needs to have the API role assigned. 3. Type the token for AirWatch authentication in the Authentication token box. 4. To only include information on registered devices, click the Include only enrolled devices check box. 5. To verify the connection, click Test connection. 6. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 7. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 8. Optionally, type a site Id for this connector. Page 11 of 47

12 SYMANTEC ALTIRIS The Symantec Altiris connector uses a database connection. 1. In the Server box, type the SQL server name. 2. Select one of the following: Type user credentials for the Symantec Altiris database in the User id and Password boxes. Click the Use integrated security check box. 3. In the Database list, select database. 4. To verify the connection, click Test connection. 5. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 6. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 7. Optionally, type a site Id for this connector. Page 12 of 47

13 BMC ATRIUM DISCOVERY AND DEPENDENCY MAPPING The BMC ADDM connector uses an API connection. DATA CONNECTION 1. Click the Data connection tab. 2. In the Server box, type the server URL. EXAMPLE 3. Type user credentials for the server connection in the User id and Password boxes. 4. To verify the connection, click Test connection. 5. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 6. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 7. Optionally, type a site Id for this connector. Page 13 of 47

14 FILTERING 1. Click the Filtering tab. 2. To include or exclude computers, define a filter based on a computer attribute. Multiple criteria can be used in the filter. 3. To add the created filter, click Add. 4. To test the filter and check the result, click Preview. 5. To remove a created filter, click Remove. Page 14 of 47

15 CITRIX XENSERVER The Citrix XenServer connector uses an API connection. 1. Type a Site name for this collection of XenServer servers. 2. To add one or more XenServer servers to scan for virtual machines, click Add. The Citrix XenServer dialog box appears. 3. Type the Name of the server. 4. To use the typed name of the server instead of the default name, click the Use this name as datacenter name checkbox. 5. Select whether HyperThreading is enabled on the hosts to ensure that correct processor core count is reported to Snow License Manager. 6. Type IP address, Port, User account, and Password to access the server. XenServer uses port 80 by default, so use that port on a default installation. 7. To verify the connection, click Test. 8. Click OK to save settings and close the Citrix XenServer dialog box. 9. Click OK to save the settings. Page 15 of 47

16 NOTE To configure the Citrix XenServer connector for a scenario where the Pool Master is changed regularly; add all XenServer hosts, use the same Name for all hosts, and select the Use this name as datacenter name check box for all hosts. When SIM goes through the list of hosts, it will only collect information from the current Pool Master. XENSERVER TOOLS The connector will be able to extract more information from virtual machines with XenServer Tools installed. Install XenServer Tools on all VMs to retrieve the maximum amount of information. HOSTS AND VIRTUAL MACHINES If a VM is not running, it is not necessarily associated with any host. It is only when a VM is running that a host is defined. This means that a VM that is not running may in fact be associated with *no* host. When the connector is trying to figure out which host a VM is associated with, the following logic is used: 1. If the VM is running, the host is known and we use that. 2. If the VM is not running, the host is inferred by the VM's affinity field (the preferred starting host). 3. If the host could not be inferred, the VM is ignored. XENSERVER CONNECTOR AND SSL Configure the connector to communicate over HTTPS by specifying port 443 in the server settings. A default XenServer installation uses a self-signed certificate for TLS/SSL. To make the connector work over HTTPS, either replace the default certificate with one from a trusted certificate authority, or add XenServer s self-signed certificate to the client machine s Page 16 of 47

17 trusted certificate store. For information on how to replace XenServer s default certificate, refer to the XenServer documentation. To trust the self-signed certificate, perform the following steps on the machine that the connector is running on: 1. Start Internet Explorer using the running as administrator option. 2. Navigate to the XenServer over HTTPS. 3. If this warning is displayed, XenServer is not using a trusted certificate. 4. Click Continue to this website. 5. Click the Security report icon in the URL, and then click View certificates. Page 17 of 47

18 6. In the Certificate dialog, click Install Certificate The Certificate Import Wizard is started. 8. Select Local Machine, and then click Next. Page 18 of 47

19 9. Select Place all certificates in the following store. 10. Click Browse, and then select Trusted Root Certification Authorities. Click OK. 11. Click Next. 12. Click Finish to start the import. 13. A message box should be displayed informing that the import was successful. 14. Restart Internet Explorer and verify that it is possible to navigate to the XenServer over HTTPS without getting a certificate warning. Page 19 of 47

20 DELL KACE 1000 The Dell KACE 1000 connector uses a database connection. 1. In the Server box, type the MySQL server name. 2. Select one of the following: Type user credentials for the Dell KACE 1000 database in the User id and Password boxes. Click the Use integrated security check box. 3. Type the name of the Database. 4. To verify the connection, click Test connection. 5. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 6. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 7. Optionally, type a site Id for this connector. Page 20 of 47

21 FRONTRANGE DISCOVERY The FrontRange Discovery connector uses a database connection. 1. In the Server box, type the SQL server name. 2. Select one of the following: Type user credentials for the FrontRange Discovery database in the User id and Password boxes. Click the Use integrated security check box. 3. In the Database list, select database. 4. To verify the connection, click Test connection. 5. In the Organizations that start with box, specify an organization filter which will be used to select computers that are connected to those organizations. Use % as a wildcard character. 6. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 7. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 8. Optionally, type a site Id for this connector. Page 21 of 47

22 HEAT DISCOVERY The HEAT Discovery connector uses a database connection. 1. In the Server box, type the SQL server name. 2. Select one of the following: Type user credentials for the HEAT Discovery database in the User id and Password boxes. Click the Use integrated security check box. 3. In the Database list, select database. 4. To verify the connection, click Test connection. 5. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 6. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 7. Optionally, type a site Id for this connector. Page 22 of 47

23 HP DISCOVERY & DEPENDENCY MAPPING INVENTORY The HP DDMI connector reads data from files in a folder. The HP Discovery & Dependency Mapping Inventory (HP DDMI) connector opens each of the HP DDMI scan files (.xsf) and converts the inventory data to a standard Snow inventory file that can be integrated with the Snow database. 1. In the XSF scan file folder box, type the folder where the HP DDMI connector will look for HP DDMI XSF scan files. 2. Optionally, type a Site id for this connector. 3. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 4. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. NOTE Due to high CPU and memory usage the recommendation is to use a server with higher performance than the recommended minimum SIM server requirements, or there is a risk that the HP DDMI aggregation will underperform. Page 23 of 47

24 HP SERVER AUTOMATION The HP Server Automation connector uses an API connection. 1. In the Server box, type the server URL. EXAMPLE 2. Type user credentials for the server connection in the User id and Password boxes. 3. To verify the connection, click Test connection. 4. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 5. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 6. Optionally, type a site Id for this connector KNOWN LIMITATIONS When gathering inventory data from HP Server Automation (HPSA) using this integration connector the actual servers running the HPSA software itself will not be included and presented in Snow License Manager. This is due to a limitation in the HPSA API that excludes these servers from the list of devices managed by HPSA. Page 24 of 47

25 IBM BIGFIX INVENTORY The IBM BigFix Inventory connector uses an API connection, and can be used for gathering data from both BigFix Inventory and ILMT version 9 (based on BigFix). 1. In the BigFix Web API URL box, type the URL to the BigFix Web API. EXAMPLE 2. In the User Id and Password boxes, type credentials for a user account with access to the BigFix Web API. Use the credentials of a valid Console operator. 3. The BigFix inventory port and BigFix platform port boxes show the default ports set by IBM. The ports can be changed. 4. To verify the connection, click Test connection. 5. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 6. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 7. Optionally, type a site Id for this connector. Page 25 of 47

26 IBM LICENSE METRIC TOOL The IBM License Metric Tool connector can either use a database connection or import reports that have been exported from IBM ILMT. DATABASE CONNECTION 1. In the Input Source section, select the DB2 database option. 2. In the Server text box, type the DB2 server name. 3. Type user credentials for the IBM License Metric Tool database in the User id and Password boxes. 4. In the Database box, type the name of the database. 5. In the Port box, type the database server port. 6. To verify the connection, click Test connection. 7. In the Period for peak capacity reporting box, type the number of days to be included in the period for Sub Capacity Reporting. 8. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 9. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 10. Optionally, type a site Id for this connector. Page 26 of 47

27 CSV FILES 1. In the Input Source section, select the CSV files option. 2. In the Folder text box, type the folder where the connector will look for inventory files. 3. In the Mappings section, select ILMT version; ILMT v 7.x or ILMT v9.x. 4. Map the Target fields to the Source fields in the ILMT file. Either type the Source fields manually, or click Get headers from file to use the header of an import file as template. Then click on each Source row and select a field from the list that is shown. 5. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 6. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 7. Optionally, type a site Id for this connector. Page 27 of 47

28 IBM TIVOLI ASSET DISCOVERY FOR DISTRIBUTED The IBM TAD4D connector uses a database connection. 1. In the Server text box, type the DB2 server name. 2. Type user credentials for the IBM TAD4D database in the User id and Password boxes. 3. Type the name of the Database. 4. Type the Port of the database server. 5. To verify the connection, click Test connection. 6. In the Period (days) field, select the number of days to be included in the period for Sub Capacity Reporting. 7. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 8. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 9. Optionally, type a site Id for this connector. Page 28 of 47

29 INVENTORY FILE FORWARDER The Inventory File Forwarder connector reads data from files in a folder. 1. In the Inventory file folder box, type the folder where the connector will look for inventory files. 2. In the Data receiver url box, type the complete URL to the Inventory Data Receiver. EXAMPLE 3. To verify the connection, click Test. 4. Optionally, type a Site id for this connector. 5. To activate the proxy functionality, click the Use proxy check box. 6. In the Settings section, use the default proxy configured in Internet Explorer by clicking the Use default proxy check box, or configure manual proxy settings by using the boxes. Page 29 of 47

30 IQUATE IQSONAR The iqsonar connector uses a database connection. 1. In the Server box, type the SQL server name. 2. Select one of the following: Type user credentials for the iqsonar database in the User id and Password boxes. Click the Use integrated security check box. 3. In the Database list, select database. 4. To verify the connection, click Test connection. 5. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 6. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 7. Optionally, type a site Id for this connector. Page 30 of 47

31 LANDESK The LANDesk connector uses a database connection. 1. In the Server box, type the SQL server name. 2. Select one of the following: Type user credentials for the LANDesk database in the User id and Password boxes. Click the Use integrated security check box. 3. In the Database list, select database. 4. To verify the connection, click Test connection. 5. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 6. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 7. Optionally, type a site Id for this connector. Page 31 of 47

32 MICROSOFT HYPER-V The Microsoft Hyper-V connector uses an API connection. 1. Type the Site name for this collection of Hyper-V servers. This setting will override the Global site id. 2. To add one or more Hyper-V servers to scan for virtual machines, click Add. The Microsoft Hyper-V Server dialog box appears. 3. In the Server name or IP box, type the hostname or IP address of the server (type. for localhost). 4. Specify whether this is a single Hyper-V server or a VMM server controlling one or more Hyper-V hosts. For a VMM server, select whether HyperThreading is enabled on the hosts to ensure that the correct number of processor cores is reported to Snow License Manager 5. Type logon credentials in the User (username or DOMAIN\username) and Password boxes. 6. By default, each virtual machine s name is its Fully Qualified Domain Name (computer name + domain; MYCOMPUTER.mydomain.local). If only the computer name is needed, click the Remove domain suffix check box. 7. To verify the connection, click Test. Page 32 of 47

33 SYSTEM REQUIREMENTS When running SIM from Windows 7 or Windows Server 2008, Windows Management Framework 3.0 must be installed. Logon credentials: Standalone Hyper-V servers: The credentials must have access to the server s WMI interface. VMM servers: The user must be an Administrator on the VMM server. The user must also be added to a role with read rights in Virtual Machine Manager Console on the VMM server (in the console, go to Settings User roles). VMM servers: Make sure that PowerShell Remoting is enabled on the server. Example of PowerShell script: Enable-PSRemoting -Force If the connection fails to a server that is not a member of the domain, or if connection by IP address is used, the server s IP address (or name) might need to be added to TrustedHosts on the local computer. Example of PowerShell script: set-item wsman:\localhost\client\trustedhosts -Value xxx.xxx.xxx.xxx, xxx.xxx.xxx.xxx, NOTE The recommendation is to either install the Snow Inventory Client for Windows on the virtual machines or gather inventory data from the virtual machines using another SIM connector. The Hyper-V connector does not perform software scan on the virtual machines Page 33 of 47

34 MICROSOFT SCCM The Microsoft SCCM connector uses a database connection. DATA CONNECTION 1. Click the Data connection tab. 2. In the Server box, type the SQL server name. 3. Select one of the following: Type user credentials for the SCCM database in the User id and Password boxes. Click the Use integrated security check box. 4. In the Database list, select database. 5. To verify the connection, click Test connection. 6. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 7. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 8. Select Identifier. 9. Optionally, type a site Id for this connector. Page 34 of 47

35 DATA SOURCE OPTIONS The SCCM data source options gives a better overview of the SCCM setup and what views and fields the Snow Integration Manager is able to aggregate from. It is also possible to apply filters to collections and clients. 1. Click the Data source options tab. 2. Collection filter In the Collection filter (Site ID) box, type the Site ID s that clients will be aggregated from. Use semi colon as separator. 3. Client filter In the Client filter box, type the names of the clients that will be aggregated. Use semi colon as separator. A wildcard character (* or %) can be used to match several clients. EXAMPLE Type STO-* for all clients with a name beginning with STO-. 4. Enable Apply software exclusion filters to metering data by clicking the check box. 5. To test the filters, click Preview. Select the Use config value check box to use the last aggregation date. Note that this will either be the last aggregation date if such a value exists, or todays date subtracted with the number of months specified for initial aggregation. Clear the Use config value check box to select a manual date for the preview. Page 35 of 47

36 MOBILEIRON The MobileIron connector uses an API connection. 1. In the Core Admin Portal URL box, type the URL to the MobileIron Core Admin Portal. EXAMPLE 2. In the User Name and Password boxes, type credentials for a user account in the MobileIron Core Admin Portal. The account needs to have the API role assigned. 3. To verify the connection, click Test connection. 4. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 5. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 6. Optionally, type a site Id for this connector. Page 36 of 47

37 RED HAT ENTERPRISE VIRTUALIZATION The Red Hat Enterprise Virtualization connector uses an API connection. 1. Type a Site name for this collection of Red Hat Enterprise Virtualization servers. This setting will override the Global site id. 2. To add one or more Red Hat Enterprise Virtualization Manager connections to scan for physical and virtual machines, click Add. The RHEV Server dialog box appears. 3. Type the Name of the data center. NOTE This name will only be used for reference in the Snow RHEV Scanner Configurator list. The actual data center name is collected via the API. 4. Type the Webservice url for the Red Hat Enterprise Virtualization Manager API. EXAMPLE 5. In the User and Password boxes, type user credentials for an account with access to the Red Hat Enterprise Virtualization Manager API. 6. To verify the connection, click Test. Page 37 of 47

38 SERVICENOW The ServiceNow connector uses an API connection. NOTE Use the ServiceNow connector for the ServiceNow releases Dublin, Eureka, and Fuji (up to patch 8). Prior to configuring the ServiceNow connector, apply the Snow CMDB Integration update set to the ServiceNow instance. A user account is required for ServiceNow web services authentication. The user account needs to be associated with the soap, import_transformer, itil, and sam roles. 1. In the SLM Web API URL box, type the URL to the Snow License Manager Web API. 2. In the User Name and Password boxes, type credentials for a user account with administrative privileges in the Snow License Manager platform. 3. To verify the SLM connection, click Test connection. 4. For SPE platforms only In the Customer list, select the customer for whom information will be replicated. 5. In the ServiceNow URL box, type the URL to the ServiceNow instance. 6. In the User Name and Password boxes, type user credentials for an administrative account in the ServiceNow platform. 7. To verify the ServiceNow connection, click Test connection. 8. To exclude replication of inventory information on users, clear the Include Users check box (the check box is selected by default). 9. To reset an ongoing incremental import and perform a full import instead, click Clear Last Import Date. Page 38 of 47

39 SERVICENOW SCOPED APPLICATION The ServiceNow Scoped Application connector uses an API connection. NOTE Use the ServiceNow Scoped Application connector for the ServiceNow releases Fuji (from patch 9) and Geneva. Prior to configuring the ServiceNow Scoped Application connector, install the Snow CMDB Integration scoped application from the ServiceNow Store. A user account is required for ServiceNow web services authentication. The user account needs to be associated with the x_snsab_snow_cmdb.snw role. 1. In the SLM Web API URL box, type the URL to the Snow License Manager Web API. 2. In the User Name and Password boxes, type credentials for a user account with administrative privileges in the Snow License Manager platform. 3. To verify the SLM connection, click Test connection. 4. For SPE platforms only In the Customer list, select the customer for whom information will be replicated. 5. In the ServiceNow URL box, type the URL to the ServiceNow instance. 6. In the User Name and Password boxes, type user credentials for an administrative account in the ServiceNow platform. 7. To verify the ServiceNow connection, click Test connection. 8. To exclude replication of inventory information on users, clear the Include Users check box (the check box is selected by default). 9. To reset an ongoing incremental import and perform a full import instead, click Clear Last Import Date. Page 39 of 47

40 SNOW DEVICE MANAGER The Snow Device Manager connector uses an API connection. 1. In the SDM Web API URL box, type the URL to the Snow Device Manager Web API. 2. In the Domain, User Name, and Password boxes, type credentials for a domain user account with administrative privileges in the Snow Device Manager platform. 3. To only include information on registered devices, click the Include only enrolled devices check box. 4. To verify the connection, click Test connection. 5. In the Initial aggregation length field, select number of months for initial aggregation of inventory data. 6. To reset an ongoing incremental aggregation, click Clear Last Aggregation Date. 7. Optionally, type a site Id for this connector. Page 40 of 47

41 SNOW INVENTORY ORACLE SCANNER The Snow Inventory Oracle Scanner connector reads data from files in a folder. This connector is used for import of Snow Inventory Oracle Scanner 2.x output xml files. It is also used for processing of inventory result xml files generated by the Snow Inventory Client for Unix. 1. Add one or more folders where Snow Inventory Oracle Scanner will look for xml files. 2. Optionally, type a site Id for this connector. Page 41 of 47

42 SNOW XML The Snow XML connector reads data from files in a folder. Snow XML is an xml format that enables integration of data from any other hardware and/or software inventory system. The Snow XML connector reads data from a structured xml file and converts it to the standard Snow Inventory format. 1. Browse for a folder where Snow XML will look for xml files. 2. Optionally, type a site Id for this connector. Page 42 of 47

43 VMWARE VSPHERE The VMware vsphere connector uses an API connection. 1. Type a Site name for this collection of vsphere servers. This setting will override the Global site id. 2. To add one or more vsphere servers to scan for virtual machines, click Add. The vsphere Server dialog box appears. 3. Type the Name of the server. 4. To use the typed name instead of vsphere s default ha-datacenter name, click the Use this name as default name for data center check box. 5. Type the Webservice url and user credentials to access the server s VMware vsphere Web Services SDK. 6. To verify the connection, click Test. Page 43 of 47

44 NOTE The user account that is used for access should be assigned the vcenter Server Role Read-only (minimum requirement) or higher. To have the complete license key for each vsphere host displayed in Snow License Manager, the user account needs to be assigned a vcenter Server Role with the granted privilege Licenses of the Global privilege category. Page 44 of 47

45 LOGGING On the Logging tab specifications can be made on what information to append to the log files, how the files are formatted, where they are located, and allowed number and size of the files (default settings are recommended). Page 45 of 47

46 IMPORT PROVIDER SETTINGS From Snow Integration Manager (named EDP when released) version 4.1 it is possible to import the active provider settings from an earlier External Data Provider 3.x installation, if installed on the same computer. All existing settings on the General tab (company name, site name, schedules) for the Snow Integration Manager will remain the same as in the earlier installation. The Snow Integration Manager Properties application presents the user with an option to import the settings the first time it starts. Note that this message will be displayed only once regardless of the answer being Yes or No. Page 46 of 47

47 ABOUT SNOW INTEGRATION MANAGER To check the version of the installed Snow Integration Manager: 1. In Snow Integration Manager Properties, press F1 on your keyboard. The About Snow Integration Manager dialog box appears. 2. Click OK to close the About Snow Integration Manager dialog box. Page 47 of 47