1

Installation GuidePDADOC-X541-en-1001CApril 2019

Predictive Data AnalyticsR100.1

2

Disclaimer

This document contains Honeywell proprietary information. Information contained herein is to be used solely for the purpose submitted, and no part

of this document or its contents shall be reproduced, published, or disclosed to a third party without the express permission of Honeywell

International Sàrl.

While this information is presented in good faith and believed to be accurate, Honeywell disclaims the implied warranties of merchantability and

fitness for a purpose and makes no express warranties except as may be stated in its written agreement with and for its customer.

In no event is Honeywell liable to anyone for any direct, special, or consequential damages. The information and specifications in this document are

subject to change without notice.

Copyright 2019 - Honeywell International Sàrl

3

Contents

Introduction 4

Installation 5

Uninstallation 18

4

Honeywell Predictive Data Analytics (PDA) provides a unified solution to indicate overall health of a control system, generate various reports and

trends from system health data, and provide data analytics based predictive alerts for control system failures. It has a web-based application that

provides role-based access to view predictive alerts for you to analyze and take appropriate action.

PDA uses the System Performance Analyzer (SPA) to collect system health data from control system and then generate predictive alerts and notify

users. It provides a centralized view of different control system health parameters.

Introduction

5Installation

6

Installation Prerequisites

Software prerequisites

SPA R120 must be installed on L3 layer node Make sure SPA is deployed and configured in Connected mode.

Make sure on SPA node, McAfee Antivirus Access Protection and On-access Scanner are disabled while installing PDA.

For information on SPA requirements, refer to SPA Installation Guide and SPA

User Guide

Hardware (minimum required)

Processor 4 X 2.6 GHz 64-bit processor or core

Memory 8 GB

Disk space 100 GB

Software (supported)

OS

Microsoft Windows Server 2016 Standard 64-bit

Microsoft Windows Server 2012 R2 Standard 64-bit

Web browser Google Chrome V 70 or later Highly recommended to use only Google Chrome

for PDA

Active Directory Domain

The current implementation of SPA requires an active directory domain environment. This can consist of multiple domains with trust relationships. The SPA server must be joined to one of these domains and there must be a trust relationship between the domain in which SPA is installed and

any domain containing computers to be monitored. Typically this consists of an L3 domain with SPA and other computers to be monitored and one or more L2 domains.

For more information, refer to SPA user documentation

7

Installation Prerequisites

SPA Services Make sure that the SPA services “AlertingEngine” and “Node Hub Stream Processor” are running.

For collecting Experion Alarm and Event data

If you require PDA-Experion Alarm and Event related analytics model, then you must enable single signonin Experion Server Station. In Experion Station – System Configuration > Operators > Sign-On Administration. Select the Allow Single signon checkbox.

For collecting SYSLOG events from network switch

PDA relies on the data collected from network switch SYSLOG Events for network degradation loop detection models. If you require switch events to be collected, then install Visual Syslog application on SPA node. For more information about installing and configuring, see the sections Visual Syslog Server Installation and Visual Syslog Server Configuration.

NOTE: Visual Syslog Server for Windows 1.6.4 is the supported version.

8

Before installing PDA, ensure that SPA R120 is deployed in Connected mode and not on-premises mode. This section provides installer screens and

user actions.

PDA Installation

1 2

3 4

Right-click PDAL3.exe and choose Run as administrator. Welcome page

appears, click Next >.

Choose “I accept the terms in the license agreement” and click Next >.

Click Install.

9

This section provides installer screens and user actions.

PDA Installation

5 Select the Show the Windows Installer log checkbox and click Finish.

It is recommended to save the log file at the following location C:\ProgramData\Honeywell\PDA\Logs or other location for reference.

10

Visual Syslog Server is required to enable PDA to collect syslog events from network switches. This section provides installer screens and user actions.

Visual syslog application can be installed on either SPA node or any one of the SPA agent deployed nodes.

NOTE: Visual Syslog Server for Windows 1.6.4 is the qualified version with the PDA 100.1 version. Ensure after Visual Syslog Server Configuration steps

are completed, deploy the SPA Agent on the node where Visual Syslog application is installed to collect the SYSLOG events.

Visual Syslog Server Installation

1 2

3 4

Right-click visualsyslog_setup.exe and choose Run as administrator.

Welcome page appears, click Next >.Retain default path and click Next >.

Retain default path or click Browse… to point to a different path and click Next >.

Click Next >.

11

This section provides installer screens and user actions.

Visual Syslog Server Installation

5 6Click Install. Click Finish.

7 Create a folder at C:\Programdata\visualsyslog for storing syslog files.

12

This section provides application screens and user actions.

Visual Syslog Server Configuration

1 2

34

Open Visual Syslog Server and click Setup. For UDP/TCP settings, under Main tab, type the IP Address of the

Visual Syslog configured node and retain default port number.

NOTE: You can either use UDP or TCP syslog server, in this case, TCP

option is unchecked since UDP is selected.

Under Files tab, add the folder C:\ProgramData\visualsyslog\syslog as the

default path for logging. If the file location does not exist, create the

visualsyslog\syslog folder under C:\ProgramData manually and then add the

folder as a default path for logging. Delete any preexisting folders.

Choose “Rotation by size” and select 10 MB as file size.

5 Choose “New name” and type syslog_(dd_mm_yyyy_hh_nn_ss).

File names will follow this format.

NOTE:Ensure in the Notification - Hidden icon section, verify that only one instance of Visual Syslog is running. In case of multiple instances are running, terminate additional Visual Syslog instances.

13

This section describes configuring network switches for sending syslog events from network switches to the visual syslog configured node.

Connect to a network switch in configuration mode and type the following commands in the same sequence:

• [switch:] Config t

• [Switch:#] service timestamps log datetime localtime show -timezone

RESULT: Makes the switch to log the events as per datetime and not in terms of hours since the network switch was powered on.

• [Switch:#] logging host 178.15.2.215

RESULT: Changes 178.15.2.215 to the IP address of the visual syslog configured node.

• [Switch:#] logging trap notification

RESULT: Sets the Logging Level to notification for collecting all switch notification level syslog messages.

• Exit or quit the configuration mode and save the changes made in configuration mode.

NOTE: You can use NTP configuration on network switches or use the following command to manually feed current datetime.

• [Switch:] clock set [dd MMM yyyy hh:mm:ss]

RESULT: Sets the switch clock to current time stamp for events synchronization.

NOTE: If there are routers or firewalls in the syslog event communication path with the Visual Syslog configured node, make sure that you configure

Access Control List (ACL) for port number 514. Make sure to configure the time zone according to the switch model and commands.

For more information on logging levels and network switch configuration, go to http://www.ciscopress.com/articles/article.asp?p=426638&seqNum=3.

Network Switches Configuration

14

To Verify Installation

Item Done ()

Verify if Honeywell Predictive Data Analytics L3 is visible in the list of applications installed through Start > Control Panel > Programs > Programs and Features .

15

Post-Installation Tasks

Item Done ()

Modify Processing Time

To increase the processing speed, modify process time as following:1. Navigate to the following location: C:\Program Files (x86)\Honeywell\ServiceLine\Honeywell.ServiceLine.SdxConnector2. Locate the Honeywell.ServiceLine.SdxConnector.exe.config file and open with Notepad or Notepad++.3. Modify the following parameter: <add key="files.LogFileIntervalInSeconds" value="60" /> to <add key="files.LogFileIntervalInSeconds" value="10" />4. Click Save.5. Press Windows + R button, enter Services.msc and click OK.6. Search for ServiceLineSdxConnector service and Restart the service.

Grant Permissions to Folders

Grant Modify permission to CDALogFiles, ExperionBLGFiles, and SysLogFiles folders that are created at the following location after the PDA installation is complete.1. Navigate to the following location C:\ProgramData\Honeywell\ServiceLine 2. Right-click CDALogFiles, select Properties > Security tab.3. Click Edit.

4. Click Add.

16

Post-Installation Tasks

Item Done ()

5. Click Locations and select local SPA node host name and click OK. For example, SPA2K16 in the following image.

6. To add users, follow one of the methods:a. Type LOCAL SERVICE and click Check Names. List of valid name is displayed. Select LOCAL SERVICE and click OK.ora. Click Advanced and click Find Now for user options. Select the LOCAL SERVICE and click OK.

7. Click OK.8. In the Permissions for folder pane, you must provide Modify permission for the LOCAL SERVICE user.9. Click Apply and OK.10. Repeat Steps 1-10 for ExperionBLGFiles, and SysLogFiles folders.

17

This section describes how to start or stop PDA data collection if the need arises.

1. Open the Windows Powershell in Administrator mode.

2. Change directory to c:\Program Files (x86)\Honeywell\PDA\PdaProvision folder.

3. To Start or Stop, run the following command: EnablePDA.ps1.

Start/Stop PDA Data Collection

18Uninstallation

19

PDA Uninstallation

1 Open Control Panel.

This section provides uninstallation screens and user actions.

2 Under Programs, click Uninstall a program.

3 Select Honeywell Predictive Data Analytics L3 and then click Uninstall.

4 When the confirmation message appears, click Yes.

5 Run the command: EnablePDA.ps1 to stop the service using PowerShell in Administrator mode from c:\Program Files

(x86)\Honeywell\PDA\PdaProvision folder.

20

Feedback