altair panopticon designer (desktop) installation and ... · installing and publishing designer in...

46
Panopticon Designer – Desktop Edition Installation and Troubleshooting Guide Version 2020.0.0 April 2020

Upload: others

Post on 27-May-2020

6 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Panopticon Designer – Desktop Edition Installation and Troubleshooting Guide Version 2020.0.0

April 2020

Page 2: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Engineering, Inc. makes no representation or warranties with respect to the contents of this manual or the associated software and especially disclaims any implied warranties of merchantability or fitness for any particular purpose. Further, Altair Engineering, Inc. reserves the right to revise this publication and make changes from time to time to its contents without obligation to notify anyone of such revisions or changes.

Altair Panopticon Designer -Desktop Edition software is offered and is to be used in accordance with a SOFTWARE LICENSE AND MAINTENANCE AGREEMENT. This agreement stipulates that this software be used only in the computer system designated in that agreement. The agreement further stipulates that the customer shall not copy or alter, or permit others to copy or alter, the software or related materials in whole or in part, in any media for any purpose, except to make an archive (back-up) copy or to make a copy as an essential step in the use of the software with the customer's computer.

Altair Engineering, Inc. hereby grants the buyer the right to reprint this documentation for internal uses only. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, for any other purposes, without the prior written permission of Altair Engineering, Inc.

Altair Panopticon Designer – Desktop Edition Installation and Troubleshooting Guide Version 2020.0.0 Copyright © 2020 by Altair Engineering, Inc. All rights reserved. Printed in the U.S.A. Unpublished - Rights reserved under the copyright law of the United States.

Altair Panopticon Designer – Desktop Edition, Panopticon Designer (Desktop), and Altair Panopticon Visualization Server are trademarks of Altair Engineering, Inc. Other products mentioned herein may be trademarks or registered trademarks of their respective owners in the United States or other countries.

For U.S. Government End Users, the software is a “Commercial Item(s),” as that term is defined at 48 C.F.R. Section 2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R. Section 12.212 or 48 C.F.R. Section 227.7202, as applicable. Consistent with 48 C.F.R. Section 12.212 or 48 C.F.R. Sections 227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the Altair Engineering, Inc. Software License and Maintenance Agreement.

SALES INFORMATION

US: + 1.800.445.3311 International: + 1.978.441.2200 Sales Email

US: [email protected] Europe: [email protected] Asia Pacific: [email protected] SUPPORT CONTACT INFORMATION

Customer Portal: https://support.datawatch.com Email: [email protected] US: +1 800.988.4739 International: +1 978.275.8350

Page 3: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Table of Contents [1] Overview................................................................................................................................................................. 1

Installation Packages ................................................................................................................... 1 Downloading Altair Panopticon Designer (Desktop) ...................................................................... 1 System Requirements .................................................................................................................. 2

[2] Installing Altair Panopticon Designer (Desktop) .................................................................................... 3

Silent Install of Altair Panopticon Designer (Desktop).................................................................... 7 Silent Install through Running a Command Line ............................................................... 7 Silent Install Through Running a Batch File ...................................................................... 7

Installing and Publishing Panopticon Designer (Desktop) in Citrix ................................................. 9 Setting Folder Permissions ............................................................................................ 15

Licensing .................................................................................................................................................................... 16

Using HyperWorks Units License in a Stand-alone Installation ......................................... 17 Using Volume-based License in a Stand-alone Installation .............................................. 18

[3] Data Connectors Third Party Software Installation ............................................................................ 20

SAP Sybase ESP.............................................................................................................. 20 StreamBase 7.1 ............................................................................................................. 21 StreamBase LiveView ..................................................................................................... 21 OneTick & OneTick CEP ................................................................................................. 22 JMX ............................................................................................................................... 23 Advanced Message Processing System (AMPS) ................................................................ 23 Solace ........................................................................................................................... 23

R & Python Transform Support ......................................................................................................................... 24

R Integration ............................................................................................................................. 24 Python Integration ..................................................................................................................... 25

[4] Running Altair Panopticon Designer (Desktop) for the First Time .............................................. 29

Changing the Usage Mode ............................................................................................. 32

Upgrading Altair Panopticon Designer (Desktop) ..................................................................................... 37

Upgrading ..................................................................................................................... 37 Uninstalling and Re-Installing ........................................................................................ 37 Silent Uninstalling and Re-installing ............................................................................... 38

Resolving Installation Issues ...................................................................................................... 38 ALtair Panopticon Designer (Desktop) Log ..................................................................... 38

Page 4: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

[Known Issues] ........................................................................................................................................................ 40

Activation Failed – Unknown Error [–77] ..................................................................................... 40 Activation Failed – Insufficient Privileges to start the service ...................................................... 41 Authorized Using a Standalone License File. License File Invalid ................................................. 42 Windows Firewall has blocked some features of this program .................................................... 42

Page 5: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 1

[1] Overview

Installation Packages Altair Panopticon Designer – Desktop Edition or Panopticon Designer (Desktop)) and Altair Panopticon Visualization Server or Panopticon Visualization Server include several separate installation packages:

Altair Panopticon Designer (Desktop) 32-bit

Altair Panopticon Designer (Desktop) 64-bit

Altair Panopticon Visualization Server

The Panopticon Designer (Desktop) program can be used on its own without being connected to the Panopticon Visualization Server component. Panopticon Designer (Desktop) allows users to design and use new Panopticon workbooks and dashboards and also publish to the Panopticon Visualization Server, for distributed web access.

The Panopticon Visualization Server is the best way to make Panopticon workbooks and dashboards available to large numbers of users.

Both components are licensed to provide data connectivity and visualization options.

A typical installation scenario is to provide authors with copies of Panopticon Designer (Desktop). They develop new workbooks and dashboards based on user requirements and then publish them to the Panopticon Visualization Server. Most business users then access the system over the web with no local software installation needed.

Downloading Altair Panopticon Designer (Desktop) You can download Panopticon Designer (Desktop) directly from our support website.

If you have received this document without the software package itself, if you need to acquire a new version of Panopticon Designer (Desktop), or if you wish us to deliver an add-on, please contact Altair Engineering, Inc. directly using the information listed on the cover pages of this document.

Our standard installation consists of:

32-bit: AltairPanopticonDesignerx86wInstaller.exe

64-bit: AltairPanopticonDesignerx64wInstaller.exe

Page 6: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

2 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

System Requirements The Panopticon Designer (Desktop) is supported on Microsoft Windows operating systems, including:

Windows 7

Windows 10

Windows Server 2012

These can be physical or virtualized systems such as Citrix. Refer to Installing and Publishing Designer in Citrix for more information.

Further information on minimum configurations is listed in the Panopticon Designer (Desktop) Reference Guide.

To support R data transforms & connectivity it also requires:

R

Rserve

Additional libraries as required for specific capabilities

To support Python data transforms & connectivity it also requires:

CPython

Latest version of Pyro4

Additional modules such as Numpy, Scipy and Pandas, as required for specific capabilities

NOTES

Panopticon Designer (Desktop) requires Microsoft .NET Framework 4.5.

Panopticon Designer (Desktop) also requires administrative privileges during installation. Administrative privileges are not required after installation is complete.

Page 7: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 3

[2] Installing Altair Panopticon Designer (Desktop) Panopticon Designer (Desktop) is a Windows program for use in a desktop environment. The install file consists of a single executable:

32-bit: AltairPanopticonDesignerx86wInstaller.exe

64-bit: AltairPanopticonDesignerx64wInstaller.exe

A separate MSI and setup.exe is available on request for integration into corporate delivery mechanisms.

Steps:

1. Run setup.exe as an administrator (right-click and Run as Administrator).

The Setup Wizard displays:

2. Click Next.

The End-User License Agreement dialog displays:

Page 8: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

4 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

3. Read and check the I accept the terms in the License Agreement box then click Next.

The Destination Folder dialog displays:

4. Confirm the installation folder.

5. Click Next.

The Confirm Installation dialog displays:

Page 9: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 5

6. Click Install to confirm the installation. You will be informed about the progress of the installation process:

Installation typically takes less than 30 seconds.

You will be notified once the installation is complete:

Page 10: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

6 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

7. And finaly, click Finish.

The installation creates a Datawatch Desktop folder under the user’s My Documents folder. Within this folder you will find several sub-folders:

• Data

• Datatables

• Example Datatable Templates

• Example Workbooks

• Workbooks

• Cached Data

• Global Caches

These folders are the default locations for workbooks and data tables created with the Panopticon Designer (Desktop) software; plus storage for any data files retrieved from the Panopticon Visualization Server.

The installation program also creates a log file under the user’s profile within the Application Data folder in Windows XP (the AppData\Roaming folder in Windows 7/10/2012) using this folder structure:

\Datawatch Desktop\Designer\Log.txt

This log file can also easily be retrieved by using the Help > Export Log File… menu option within the Panopticon Designer (Desktop).

After a successful installation, you will need to either connect to a Panopticon Visualization Server or select the license type to use your copy of Panopticon Designer (Desktop) for stand-alone use.

Page 11: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 7

Silent Install of Altair Panopticon Designer (Desktop) Silent installation is also supported for Panopticon Designer (Desktop). There are two ways to do this:

Running a command line

Running a batch file

Silent Install through Running a Command Line

Steps:

1. Run the following command line on the Command prompt as an Administrator:

msiexec.exe /i <path to package> [/q{n}]

Where:

• /i – normal installation

• /q – set the UI Level

♦ n – no UI

Sample command line:

msiexec.exe /i “[path to DatawatchDesignerx64.msi]”/qn

Example:

msiexec.exe /i “C:\Users\User\Desktop\DatawatchDesignerMSI_x64_16-2-0\DatawatchDesignerx64.msi” /qn

Silent Install Through Running a Batch File

Running the silent installation through a batch (.bat) file is highly recommended for large scale deployment as the batch file can be easily executed on all machines.

NOTES

Make sure the Panopticon Designer (Desktop) MSI file location mentioned in the command line is accessible.

Page 12: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

8 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

Steps:

1. Create a new text file and copy the preferred command line mentioned in the previous section:

msiexec.exe /i <path to package> [/q{n}]

Sample command line:

msiexec.exe /i “[path to DatawatchDesignerx64.msi]”/qn

Example:

msiexec.exe /i “C:\Users\User\Desktop\DatawatchDesignerMSI_x64_16-2-0\DatawatchDesignerx64.msi” /qn

2. Save this as a batch (*.bat) file.

3. Double-click this batch file as an Administrator.

Page 13: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 9

Installing and Publishing Panopticon Designer (Desktop) in Citrix Customers with complex environments involving systems such as OSI are accustomed to managing desktops using Citrix. Citrix is used for desktop virtualization that delivers Windows applications and desktops to any user on any device.

Follow the instructions below to install and publish Panopticon Designer (Desktop) in Citrix.

Steps:

1. Log-on to your Citrix environment.

The available Desktops you can use are displayed.

2. Select a particular environment to install Panopticon Designer (Desktop). For example, Win2012R2:

Page 14: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

10 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

3. After opening the selected environment, copy the Panopticon Designer (Desktop) Client

installer in the Desktop.

4. Install Panopticon Designer (Desktop) on the Remote Desktop Server: Control Panel> All Control Panel Items > Install Application on Remote Desktop Server Wizard for Installing Applications in RD-Install Mode.

The Install Program from Floppy Disk or CD-ROM dialog displays.

Page 15: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 11

Click Next. The Run Installation Program displays.

Click Browse and select the Panopticon Designer (Desktop) installer in the dialog.

This installs the Panopticon Designer (Desktop) Client.

5. In the Citrix Studio, publish Panopticon Designer (Desktop).

5.1. Click Apps in the Citrix Workspace. This displays the available apps.

Page 16: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

12 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

5.2. Click Citrix Studio.

The Citrix Studio is displayed.

5.3. In the Citrix Studio panel list, click Delivery Groups. The Delivery Groups tab

displays with the list of available Desktops.

5.4.Select the environment (e.g., Win2012R2) then select Add Applications on the context menu.

Page 17: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 13

The Create Application dialog displays.

5.5. Click Next. The Applications list is displayed and select the Panopticon Designer

(Desktop) you installed (i.e., Designer x64)

Page 18: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

14 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

5.6. Click Next. The Summary page displays.

5.7. Click Finish.

6. In the Apps window, you can view also click to add apps. Click All Apps in the menu to display the apps you can add.

7. Select an app.

Page 19: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 15

It is added on the Apps desktop.

Setting Folder Permissions

Starting from the support of Citrix, folder permissions are not allowed to Users/Public/Document and its subfolders.

This can be fixed by enabling the injection of the default document root for Panopticon Designer (Desktop).

Ensure that the DocumentsRootFolder setting is added in the Panopticon Designer (Desktop) application config (C:\Program Files\Datawatch Desktop\Designer\EXDesigner.exe.config)

For example:

<setting name="DocumentsRootFolder" serializeAs="String"> <value>CommonDocuments</value> </setting>

The DocumentsRootFolder parameter is used on the first application start up to determine where to create the Datatables, Data, Workbooks, CacheData, etc. directories. If the DocumentsRootFolder is not set, the SpecialFolder.CommonDocuments will be used instead (C:\Users\Public\Documents).

The DocumentsRootFolder accepts any value of the SpecialFolder enumeration:

https://msdn.microsoft.com/en-us/library/system.environment.specialfolder(v=vs.110).aspx

For example, using MyDocuments would revert to the behavior of lower versions of Panopticon Designer (Desktop) 13.3.

If the value is not found in the SpecialFolders enumeration, it is expected to be an absolute file path.

Page 20: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

16 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

Licensing Licensing within Panopticon Designer (Desktop) supports four modes of operation:

Stand alone with HyperWorks Units license

Stand alone with a volume-based license file

Connected to a Panopticon Visualization Server with HyperWorks Units license

Connected to a Panopticon Visualization Server with a volume-based license file

For the stand-alone installation, both the HyperWorks Units license and volume license file are delivered separately from the installation packages.

If you install Panopticon Designer (Desktop) for use with the Panopticon Visualization Server component, the Designer software will retrieve its license (HyperWorks Units or volume-based) automatically from the Server.

For the volume-based license file (named DatawatchLicense.xml), which is used to store all license information for a specific customer, it must be copied to the designated AppData folder (i.e., c:\vizserverdata)

For the HyperWorks Units license, refer to the Server Installation and Troubleshooting Guide for more information

NOTES

You can change the licensing mode in the Tools > Options dialog. Refer to Changing the Usage Mode for more information.

NOTES

• Starting with version 17.4, the Nalpeiron Licensing service is no longer supported alongside with the activation of Panopticon Designer (Desktop) using the License Manager.

• The license checkout uses standard leveling based on the username & hostname (i.e., running multiple instances of Panopticon Designer (Desktop) on the same machine draws 21 units/21000 features)

Page 21: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 17

Using HyperWorks Units License in a Stand-alone Installation

After installation, you can use the Panopticon Designer (Desktop) for a stand-alone mode using a HyperWorks Unit license.

NOTES

You need to connect to an Altair License Server (local or over the network) with the corresponding HyperWorks Units license that may be provided by our Sales team.

In the Usage Mode dialog, click Work with Altair Panopticon Designer (Desktop) stand-alone radio button and select HyperWorks Units in the drop-down box.

Then enter the location of the Altair License Server where the license is located. The syntax is PORTNUMBER@HOST where HOST is the IP address value (e.g., [email protected]).

Page 22: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

18 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

Using Volume-based License in a Stand-alone Installation

After installation, you can use the Panopticon Designer (Desktop) for a stand-alone mode using a volume-based license.

In the Usage mode dialog, click Work with Altair Panopticon Designer (Desktop) stand-alone radio button and select Volume License File in the drop-down box.

The dialog changes to allow the selection of the license file:

Page 23: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 19

Click Browse, select the license file, and click OK.

Page 24: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

20 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

[3] Data Connectors Third Party Software Installation A number of data connectors require additional third party software installation to be enabled and listed in the Connect to Data dialog. These include:

StreamBase 7.1

StreamBase LiveView 1.5

SAP Sybase ESP

One Market Data OneTick & OneTick CEP

JMX

Advanced Message Processing System (AMPS)

AMPS Discovery

Solace

SAP Sybase ESP

For SAP Sybase ESP, manually copy the following dependency files from the Sybase ESP installation folder (e.g., C:\Sybase\ESP-5_1\net\interfaces\sdk\net35):

icudt44.dll

icuin44.dll

icuuc44.dll

libeay32.dll

ssleay32.dll

streamingidentity_lib.dll

streamingnetsdk_lib.dll

streamingsystem_lib.dll

xerces-c_2_6.dll

Page 25: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 21

To the corresponding Sybase ESP plugin folder:

Designer & OS Path

32-bit on 32-bit C:\Program Files\Datawatch Desktop\Designer\Plugins\Panopticon.SybaseESPPlugin

64-bit on 64-bit C:\Program Files\Datawatch Desktop\Designer\Plugins\Panopticon.SybaseESPPlugin

32-bit on 64-bit C:\Program Files (x86)\Datawatch Desktop\Designer\Plugins\Panopticon.SybaseESPPlugin

StreamBase 7.1

For StreamBase 7.1, either install the full StreamBase CEP 7.1 client or the StreamBase 7.1 .NET Client Redistributable. If no StreamBase model development is to occur on the machine, install the .NET client redistributable that is appropriate for the Panopticon Designer (Desktop) installed (32-bit or 64-bit).

Example:

Streamabse-.NET-client-redist-7.1.12.1_1211191613.msi (32-bit)

StreamBase-.NET-Win64-client-redist-7.1.12.1_1211191613.msi (64-bit)

Refer to http://www.streambase.com/products/streambasecep/download-streambase/ for more information in downloading StreamBase products.

StreamBase LiveView

For StreamBase LiveView, the following two files are required to be copied in the Altair Panopticon Designer (Desktop) Plugin folder (C:\Program Files\Datawatch Desktop\Designer\Plugins):

StreamBase.SB.Client.dll

StreamBase.LiveView.API.dll

In StreamBase Liveview 1.5

StreamBase.SB.Client.dll can be found in the Streambase bin or bin64 folders.

Example:

C:\Program Files (x86)\StreamBase Systems\StreamBase.7.3\bin (32-bit)

C:\Program Files (x86)\StreamBase Systems\StreamBase.7.3\bin64 (64-bit)

StreamBase.LiveView.API.dll can be found in the LiveView 1.5 SDK bin folder.

Example:

C:\Program Files (x86)\StreamBase Systems\StreamBase.7.3\liveview\sdk\bin

Page 26: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

22 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

In StreamBase Liveview 2.0 (Live Datamart)

StreamBase.SB.Client.dll can be found in the Streambase bin or bin64 folders.

Example:

C:\TIBCO\sb-cep\7.5\bin (32-bit)

C:\TIBCO\sb-cep\7.5\bin64 (64-bit)

StreamBase.LiveView.API.dll can be found in the LiveView SDK bin folder.

Example:

C:\TIBCO\sb-cep\7.5\sdk\bin

OneTick & OneTick CEP

NOTES

For version 16.7.0, the OneTick connector is built and tested against version 1.17 of the OneTick Client.

For OneTick, manually copy specific dependency files from the OneTick installation. (e.g., C:\omd\one_market_data\one_tick\bin) to the Plugins folder.

This is available by default at:

C:\Program Files\Datawatch Desktop\Designer\Plugins\Panopticon.OneTickPlugin

The specific files to be copied are:

Csomd.dll

Csomd_native.dll

Libonetick.dll

In addition, the following files are required for streaming continuous query support:

msvcp100.dll

msvcr100.dll

Finally, a new folder titled config, must be created under the Plugins folder.

e.g. C:\Program Files\Datawatch Desktop\Designer\Plugins\config

And the file: windows_tz_mapping.dat

Copied into it, from the OneTick folder: C:\omd\one_market_data\one_tick\config

The OneTick connector also requires that the environment variable: ONE_TICK_CONFIG

Has been configured with the path to the required config file.

Example:

C:\omd\client_data\config\one_tick_config.txt

Page 27: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 23

And that the OneTick configuration file has entries for Windows OS time zone mapping and information.

Example:

WINDOWS_TZ_MAPPING_FILE="C:/OMD/one_market_data/one_tick/config/windows_tz_mapping.dat"

WINDOWS_ZONEINFO_PATH="C:/OMD/one_market_data/one_tick/config/zoneinfo"

JMX

Use the following java options to enable JMX monitoring for JMX plugin:

Enable JMX remote connection: (-Dcom.sun.management.jmxremote)

Disable JMX authentication: (- Dcom.sun.management.jmxremote.authenticate=false) Note: This is not supported for now.

Set remote port for jmx: (-Dcom.sun.management.jmxremote.port=number)

Advanced Message Processing System (AMPS)

For the Advanced Message Processing System (AMPS), download the latest version from the 60East official website: http://www.crankuptheamps.com/amps/

Manually copy AMPS.Client.dll and AMPS.Client.Xaml.dll dependency files to the corresponding Panopticon Designer (Desktop) installed folder:

C:\Program Files\Datawatch Desktop\Designer\Plugins\Panopticon.AMPSPlugin (64-bit)

C:\Program Files (x86)\Datawatch Desktop\Designer\Plugins\Panopticon.AMPSPlugin (32-bit)

Restart Panopticon Designer (Desktop) to view and use the enabled AMPS connector.

Solace

For Solace, manually copy dependency files from http://dev.solace.com/tech/dot-net-api/ (e.g., solclient_dotnet_10.1.1\bin\Win64) to the Panopticon Designer (Desktop) Plugins folder.

This is available by default at:

C:\Program Files\Datawatch Desktop\Designer\Plugins\Panopticon.SolacePlugin (64-bit)

C:\Program Files (x86)\Datawatch Desktop\Designer\Plugins\Panopticon.SolacePlugin (32-bit)

The files to be copied are:

SolaceSystems.Solclient.Messaging.dll

Libsolclient.dll

Page 28: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

24 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

R & Python Transform Support R and Python connectivity and transforms occur over TCP/IP network links.

For R, Rserve is used.

For Python, Pyro (Python Remote Data Objects) is used.

R Integration Follow the steps below to enable R connectivity.

Steps:

1. Download R, install it, and the R Console ( http://cran.rstudio.com/ )

2. Open the R Console.

2. Install Rserve using the following command from within the R Console:

install.packages("Rserve")

3. Initiatiate the Rserve library using the following command:

library(Rserve)

4. Run Rserve by executing the following command:

Rserve()

Only 2, 4 & 5 need to be repeated when R connectivity is required.

Example:

Page 29: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 25

NOTES

Connectivity by default is over Port 6311

To enable authentication across the Rserve TCP/IP link

create a password file (pwdfile.pwd)

Each line of the file should have the user and then the password.

Example:

user1 password1

user2 password2

Create a configuration file with following parameters (rconfig.conf)

auth required pwdfile [path of password file] Example: remote enable auth required port 6311 pwdfile C:\\RIntegration\\pwdfile.pwd

load the created configuration file (the default Rserve configuration file is still loaded, but its settings have lower priority) and run Rserve:

Rserve(args="--RS-conf [path of configuration file]")

Example:

Rserve(args="--RS-conf C:\\RIntegration\\rconfig.conf")

Python Integration Follow the steps below to enable Python connectivity.

Steps:

1. Download and install either Python 2.7, or Python 3.5.

For ease of deployment we suggest the Anaconda Python distribution

https://www.continuum.io/downloads

2. Add Python installation folder to your PATH environment variable.

3. Download the latest version of Pyro4.

https://pypi.org/project/Pyro4/

For Windows download the Wheel: Pyro4-4.79-py2.py3-none-any.whl

4. Open the Anaconda Prompt. Navigate to the location of Pyro4-4.79-py2.py3-none-any.whl and run:

Pip install Pyro4-4.79-py2.py3-none-any.whl

Page 30: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

26 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

Pyro is now installed into the Python site packages.

5. Open Panopticon Designer (Desktop) then select Tools > Options.

The Altair Panopticon Options dialog displays.

6. Check the Enable Python Connectivity on Start Up box then click OK.

7. Restart Panopticon Designer (Desktop).

This saves the change and enables Python connectivity whenever Panopticon Designer (Desktop) is opened.

NOTES

To uninstall prior versions of Pyro:

pip uninstall Pyro4

The default password to secure connectivity is set to: password

To change this:

Edit start_Python_connectivity.bat, editing the line:

start python -m Pyro4.naming -k "password"

Edit pyro.py, editing the line:

ns = Pyro4.locateNS(host=host, hmac_key="password")

Pyro is set to listen on a specific host/IP, which by default is localhost.

Page 31: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 27

This can be modified through editing the batch file that instantiates Pyro.

@echo on start python -m Pyro4.naming -n "[Required HostName]" -k "password" ping localhost cd "%~dp0" python pyro.py "[Required HostName]" pause

To enable the Pickle serialization, modify the configuration.py file located in ..\Anaconda3\Lib\site-packages\Pyro4 to specify the serialization to be used.

For example, if Pickle is selected, self.SERIALIZER value should be changed to pickle and self.SERIALIZERS_ACCEPTED value should be changed to include pickle:

Page 32: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

28 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

def reset(self, useenvironment=True): """ Set default config items. If useenvironment is False, won't read environment variables settings (useful if you can't trust your env). """ self.HOST = "localhost" # don't expose us to the outside world by default self.NS_HOST = self.HOST self.NS_PORT = 9090 # tcp self.NS_BCPORT = 9091 # udp self.NS_BCHOST = None self.NATHOST = None self.NATPORT = 0 self.COMPRESSION = False self.SERVERTYPE = "thread" self.COMMTIMEOUT = 0.0 self.POLLTIMEOUT = 2.0 # seconds self.SOCK_REUSE = True # so_reuseaddr on server sockets? self.SOCK_NODELAY = False # tcp_nodelay on socket? self.THREADING2 = False # use threading2 if available? self.ONEWAY_THREADED = True # oneway calls run in their own thread self.DETAILED_TRACEBACK = False self.THREADPOOL_SIZE = 16 self.AUTOPROXY = True self.MAX_MESSAGE_SIZE = 0 # 0 = unlimited self.BROADCAST_ADDRS = "<broadcast>, 0.0.0.0" # comma separated list of broadcast addresses self.FLAME_ENABLED = False self.PREFER_IP_VERSION = 4 # 4, 6 or 0 (let OS choose according to RFC 3484) self.SERIALIZER = "pickle" self.SERIALIZERS_ACCEPTED = "pickle,marshal,json" # these are the 'safe' serializers self.LOGWIRE = False # log wire-level messages self.PICKLE_PROTOCOL_VERSION = pickle.HIGHEST_PROTOCOL self.METADATA = True # get metadata from server on proxy connect self.REQUIRE_EXPOSE = False # require @expose to make members remotely accessible (if False, everything is accessible) self.USE_MSG_WAITALL = hasattr(socket, "MSG_WAITALL") and platform.system() != "Windows" # not reliable on windows even though it is defined self.JSON_MODULE = "json" self.MAX_RETRIES = 0

Page 33: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 29

[4] Running Altair Panopticon Designer (Desktop) for the First Time Steps:

1. You can select either, depending on your Desktop Environment, from the Start Menu in Windows:

• 32-bit: Altair Panopticon > Designer 32-bit

• 64-bit: Altair Panopticon > Designer 64-bit

The Usage Mode dialog will appear:

If you are running the Designer against a pre-installed Panopticon Visualization Server, just enter the Server URL and click OK.

2. If you plan to run Designer without the Server component, select the Work with Altair

Panopticon Designer (Desktop) stand alone button.

You can either:

Page 34: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

30 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

• select Volume License File in the drop-down list box and click Browse to select the volume-based license file

• select HyperWorks Units in the drop-down list box and enter the location of the Altair License Server where the license file is located (e.g., [email protected])

3. If you choose to Connect to an Altair Panopticon Server Instance, the following

dialog may be displayed:

Page 35: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 31

Enter the Username and Password of the Panopticon Visualization Server you are connecting to. Check the Save Password box if you want to save the password.

Click Continue as Guest if you want to use Designer as a guest.

Click OK. The Connecting to Server dialog displays with the information of the selected usage mode.

The Designer is displayed with the list of available workbooks.

4. If you are using the kdb+ cache option, the kdb+ cache will be initialized, and communication between the Designer and kdb+ cache will occur over TCP/IP via a pre-defined port, normally 10501.

When prompted by your firewall, Allow access to q.exe; the kdb+ cache process.

Page 36: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

32 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

Refer to the Panopticon Designer (Desktop) Reference Guide for more information.

Changing the Usage Mode

To change from Standalone usage mode to connecting to a Panopticon Visualization Server instance, or vice versa, you can do this from the Tools > Options.

Steps:

1. Select Tools >Options on the menu bar.

The Altair Panopticon Options dialog box displays.

Page 37: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 33

2. You can select either:

• Server URL and enter the URL of the Panopticon Visualization Server that you will connect to, or

• Run Locally then either:

♦ select Volume License File in the drop-down list box and click Browse to select the volume-based license file

Page 38: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

34 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

♦ select HyperWorks Units in the drop-down list box and enter the location of the

Altair License Server where the license file is located (e.g., [email protected] or c:\Program Files\Altair\Licensing12.0\altair_lic.dat)

Page 39: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 35

3. Click OK.

A message box displays.

4. Click OK.

5. Select File > Exit to close Panopticon Designer (Desktop) and apply the changes.

NOTES

• In the Altair Panopticon Actions dialog, if the selected license is Volume License File but there is no license file selected, when you open Panopticon Designer (Desktop), this dialog displays that allows you to do so:

Click Browse to select the volume-based license file and then OK.

• In the Altair Panopticon Actions dialog, if the selected license is HyperWorks Units but there is no specified License Server URL, when you open Panopticon Designer (Desktop), this dialog displays that allows you to do so:

Enter the location of the Altair License Server where the license file is located then click OK.

Page 40: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

36 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

• In the Altair Panopticon Actions dialog, if Server URL is selected but there is no specified Panopticon Visualization Server URL, when you open Panopticon Designer (Desktop), this dialog displays that allows you to do so:

Enter the URL of the Panopticon Visualization Server that you will connect to and then click OK.

Page 41: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 37

Upgrading Altair Panopticon Designer (Desktop) A previously installed Panopticon Designer (Desktop) can be upgraded to the latest version through any of the following options:

Upgrading

Uninstalling and Re-Installing

Silent Uninstalling and Re-Installing

Upgrading

Simply install the latest release as defined earlier. This will update the existing software installation.

This capability is only available when the version number changes, and consequently may not be available for customer specific builds.

NOTES

A new major release of Panopticon Designer (Desktop) may require a new license key to be activated when used on a stand-alone basis.

Uninstalling and Re-Installing

Steps:

1. Select Control Panel > Programs and Features.

2. Select the Altair Panopticon Designer (Desktop) <version> <bitness> from the listing of installed programs and select Uninstall.

3. Then install the latest release as defined previously.

Page 42: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

38 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

Silent Uninstalling and Re-installing

Steps:

1. Run the following command line on the command prompt:

msiexec /x c:\temp\DatawatchDesignerx86.msi /qb /L* c:\temp\Designerx86install.log

Where:

• /x

This option uninstalls the program.

• /qb

This option displays the uninstall progress bar. To suppress displaying the uninstall progress bar, replace /qb with /qn.

2. Then install the latest release as defined previously.

Resolving Installation Issues Issues are investigated and resolved through investigation and controlled reproduction. A number of known issues are included in the next section and predominately relate to problematic installations of the MS .NET Framework and incorrect permissioning.

If you experience an unknown issue, send complete details to: [email protected]

Be sure to send this important information to Altair Support in the event of a problem:

ALtair Panopticon Designer (Desktop) Log

This is created under the user’s profile within the Application Data folder (the AppData\Roaming folder in Windows 7/8/10) using this folder structure:

%APPDATA%\Datawatch Desktop\Designer\Log.txt

Access this log file through the Panopticon Designer (Desktop) menu using the Help > Export Log File menu item:

Page 43: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 39

The level of detail for this log can be specified using the Designer menu Tools > Options.

By default, it is set to Error, while the most verbose is Info.

Include your Designer Workbook and associated data sources if the issue is specific to a particular Workbook.

Page 44: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

40 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

[Known Issues]

Activation Failed – Unknown Error [–77] This is typically because direct access to the Internet based License Server is blocked.

Click on the link Activate using a web browser, a file, email or phone.

Then either Activate via phone or email, or:

1. Click on the link Use the browser to get an activation certificate.

2. Enter the installation key and license code into the web page and click Generate Unlock

Code Certificate.

Page 45: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0 41

3. Paste this certificate back into the open section, and click Activate.

Activation Failed – Insufficient Privileges to start the service The licensing service used by Panopticon Designer (Desktop) has failed to start.

To activate the product without this service:

1. Click on the link Activate using a web browser, a file, email or phone.

2. Click on the option Activate using a license file

3. Click Browse…., and select the supplied license XML file.

4. Click Activate.

Page 46: Altair Panopticon Designer (Desktop) Installation and ... · Installing and Publishing Designer in Citrix. for more information. Further information on minimum configurations is listed

42 Altair Panopticon Designer (Desktop) Installation and Troubleshooting Guide 2020.0.0

Authorized Using a Standalone License File. License File Invalid This typically occurs where authorization was previously set to use a standalone license file, and the file has since been moved, so that it is no longer available.

Steps:

1. Click on the link Activate using a web browser, a file, email or phone.

2. Click on the option Activate using a license file.

3. Click Browse…., and select the supplied license XML file.

4. Click Activate.

Windows Firewall has blocked some features of this program If you are using the kdb+ cache option, the kdb+ cache will be initialized, and communication between the Panopticon Designer (Desktop) and kdb+ cache will occur over TCP/IP via a pre-defined port, normally 10501.

If prompted by your firewall, Allow access to q.exe; the kdb+ cache process.