Contents

 
Preface
Introducing Software AG MashZone NextGen
MashZone NextGen welcome page
Open a dashboard in MashZone NextGen
Use the dashboard editor
Use dashboards in view mode
Open a dashboard in view mode
Use interactive filters in dashboards
Use the filter panel of Process Mining context-based widgets
Refresh data of widgets
Pause automatic data refreshing
Change column width and sort order
Use multiple selection in lists and tables
Save widget data as a CSV file
Set the step width of a distribution chart
Use bookmarks
Open the bookmark bar
Create bookmarks
Open a bookmarked dashboard
Rename a bookmark
Delete a bookmark
Update a bookmark
Share a bookmark
Use dashboard in edit mode
Open a dashboard in the dashboard editor
Create a dashboard in the dashboard editor
Use smart dashboard edit mode
Insert new row
Delete a row
Resize a row
Lock row height
Change a row order
Place a widget
Resize widgets
Avoid line break in dashboard view mode
Group widgets
Set row style
Set layout group style
Set dashboard tab style
Switch to fixed-grid workspace
Save a dashboard
Edit a dashboard
Delete a dashboard
Edit dashboard properties
Manage dashboard permissions
Change the dashboard style
Process Mining context
Create a Process Mining context
Edit a Process Mining context
Delete a Process Mining context
Assign data columns to Process Mining context-based widgets
Configure filters for Process Mining context-based widgets
Configure a date filter for a Process Mining context
Exclude a widget from a Process Mining context filter
Enable the filter panel
Configure the filter panel
Migrate a dashboard context
Use Multi-lingual dashboards
Configure languages for translation
Translate the widget content
Select the language for your dashboard
Translate the tab title
Manage bookmarks
Enable the bookmark bar
Open the bookmark bar
Rename a bookmark
Delete a bookmark
Share a bookmark
Set and reset a bookmark as default
Configure widgets
Set up widgets
Insert widgets in a dashboard
Copy and paste widgets in dashboards
Assign data sources to widgets
Assign data columns to line, column or bar charts
Set properties of widget elements
Configure KPI thresholds
Configure KPI rating
Assign data columns to a distribution chart
Set properties of widget elements
Assign data columns to pie charts
Set properties of widget elements
Assign data columns to bubble charts
Set properties of widget elements
Configure KPI thresholds
Assign data columns to grids
Set properties of widget elements
Configure thresholds
Assign data columns to lists
Set properties of widget elements
Assign data columns to circular gauge charts
Set properties of widget elements
Configure thresholds
Assign data columns to horizontal and vertical gauge charts
Set properties of widget elements
Configure thresholds
Assign data columns to traffic lights
Set properties of widget elements
Configure thresholds
Assign data columns to a drop-down box
Set properties of widget elements
Assign data columns to labels
Set properties of widget elements
Assign data columns to a rich text area
Set properties of widget elements
Assign data columns to sliders
Set properties of widget elements
Assign data columns to date filters
Assign data columns to vector map
Set properties of widget elements
Configure KPI thresholds
Assign data columns to map with markers
Set properties of widget elements
Configure KPI thresholds
Create input parameters
Calculate the feed data
Specify the color mapping for dimensions
Display legend
Remove widgets from dashboard
Define filters for widgets
Specify actions for widgets
Change tab
Set selection
Call URL
Specify an image source URL
Post data
Send events
Hide or display widget header and border
Resize widgets
Move widgets to the foreground or background
Display widgets on multiple dashboard tabs
Change the widget style
Configure dashboard tabs
Add dashboard tabs
Delete dashboard tabs
Set dashboard tab properties
Set dashboard tab style
Set dashboard tab as default
Other
Use dynamic URL selection
Hide tab bar in view mode
Set display size
Set grid lines
Allow anonymous access to dashboards
PPM data source operator
File resources
Display dashboards without application header
Export and import dashboards
Customize styles and themes
Use the data feed editor
Create a data feed
Open the data feed editor
Select data sources
Calculate the feed data
Add further operators
Connect the operators
Save the data feed
Edit a data feed
Delete data feeds
Edit data feed properties
Manage data feed permissions
Data feed operators
Use Materialized Feeds
Use datasets storing data feed results
Manage Materialized Feeds in Terracotta
Use datasets from an external application
Which privileges are required?
Other
Export and import data feeds
Display data feed without application header
Valuable information
What are dashboards?
What are data feeds?
What is a view-only license?
Administration
Open the Admin Console
MashZone NextGen security
Manage your MashZone NextGen profile
Manage your locale and account information
Change your password
MashZone NextGen server
MashZone NextGen repository
Authentication and Guest Access
User Authentication
Valid Credentials
Sessions and Timeouts
Default user account
Authentication with single sign-on solutions
Configuration for Agent-Based SSO Solutions
Implementing a Custom SSO Filter
SSO integration in My webMethods
Protect MashZone NextGen Event Service access
Anti-Clickjacking prevention when using iFrame
MashZone NextGen HTTP header security filter
Example
MashZone NextGen Content Security Policy
Add a trusted site to allow iFrame
Add multiple trusted sites to allow iFrame
Content-Security-Policy using wildcards
Handle personal data in log files
Create whitelists for URL calls
Getting Started with the MashZone NextGen Server
Additional MashZone NextGen System and Software Requirements
Additional Recommendations for MashZone NextGen
What is Installed with MashZone NextGen
Start and Stop the MashZone NextGen Server
Start the MashZone NextGen Event Service
Start the MashZone NextGen Server
Stop the MashZone NextGen Event Service
Stop the MashZone NextGen Server
Startup Considerations
Manage Licenses for MashZone NextGen and BigMemory Max
Move the MashZone NextGen repository to a robust database solution
Troubleshooting Connections to the MashZone NextGen Repository
Move the MashZone NextGen repository to Microsoft SQL Server
Move the MashZone NextGen repository to MySQL
Move the MashZone NextGen repository to Oracle
Move the MashZone NextGen repository to PostGres
Integrate Your LDAP Directory with MashZone NextGen
Defining LDAP Connection Configuration
Defining the Authentication Scheme
Defining the Authorization Scheme
Enabling MashZone NextGen Application Queries for All LDAP Users or Groups for Permissions
Start MashZone NextGen with an initial administrator user
Use the default MashZone NextGen user repository
Manage users
Create users
Edit, assign roles and other user management tasks
Manage user groups
Which user roles exist?
Install MashZone NextGen and MashZone NextGen Event Service as Windows services
Command Central
MashZone NextGen plug-in
Instance Overview
Instance Configuration
Instance Logs
Enable remote JMX connection
MashZone NextGen Event Service plug-in
Instance overview
Instance configuration
Instance Logs
Configure ports
Configure keystores
Configure truststores
Configure SSL certificates
Manage licenses
Required installer modules
MashZone NextGen Server Configuration
Memory Configuration for the MashZone NextGen Server
Configuration When MashZone NextGen Uses Only Heap Memory
Configuration When MashZone NextGen Uses Heap and Off-Heap Memory
Configure feed processing time zone
Support International Character Sets and Locales
Set the Repository Character Encoding
Set the Repository Timezone or Offset
Date, Time and Numeric Display Options
Message Log and Default Locales
Configure the MashZone NextGen server with custom ports
Change MashZone NextGen Server Ports
Change MashZone NextGen Repository Ports
Tomcat Application Server Port
Configure the MashZone NextGen server to work with a proxy server
Embedding MashZone NextGen in external system environments
Configure MashZone NextGen server to work with iFrame
Post data
URL selection
Define a Proxy Server White list for MashZone NextGen
Using Regular Expressions in a White list
Specifying Literal Dot Separators
Specifying Domains
Specifying Host Names
Configure MashZone NextGen for SSL and Digital Certificates
The Certificate Store and Certificates
Key Certificate Pairs
Trusted Peer Certificates
The Certificate Store
Configure Mutual SSL Between Users and MashZone NextGen
One-Way SSL to MashZone NextGen
One-Way SSL to Information Sources
Configure HTTPS and Certificate Stores in the Application Server
Update SSL Configuration for Java
MashZone NextGen Logging
Configure Logging for the MashZone NextGen Server
Audit logging for dashboards, data feeds, aliases, and permissions
BigMemory Max for Caching, Connections and In-Memory Stores
Caching for the MashZone NextGen Server
Artifact Caching
Response Caching
Distributed Caching for MashZone NextGen Clusters
Configure BigMemory Max Servers for MashZone NextGen Caching
Working with BigMemory Max Stores for RAQL
Declared In-Memory Stores
Declare a new In-Memory Store
Modify a Declared In-Memory Store
View Details for Declared In-Memory Stores
Define permissions for declared In-Memory Strores
Dynamic In-Memory Stores
Manage Dynamic BigMemory Max Stores for MashZone NextGen Analytics
Add an External Dynamic In-Memory Store Connection
Delete External Dynamic In-Memory Store Connections
Define permissions for external dynamic In-Memory Store Connections
Manage Terracotta connections
Register Terracotta connections
Edit Terracotta connections
Test Terracotta connections
Share Terracotta connections
Delete Terracotta connections
Ensure secure interaction with Terracotta
Manage data sources and drivers
Add a data source
Edit, test or remove data sources
Share data sources
Add or manage JDBC drivers
Migrate JDBC connections
Migrate JDBC configuration of Presto to MashZone NextGen
Migrate JDBC connections of Presto to MashZone NextGen
Migrate JDBC configuration of MashZone NextGen 9.10
Migrate JDBC connections of MashZone legacy to MashZone NextGen
Manage geographical map ressources
Manage geoJSON files
Manage tile server configuration files
Tune memory/caching for MashZone NextGen
Tune MashZone Memory and Cache Configuration Manually
Update Cache Memory Settings
Update MashZone ThreadSize Properties
Manage Materialized Feeds
Configure Materialized Feeds
Edit Materialized Feeds
Delete Materialized Feeds
Share Materialized Feeds
Materialize data feed results in Terracotta
Use the Admin Console
Use the API Console
Use the server administration tool
Use server web services
MashZone NextGen Server Administration
Manage files for MashZone NextGen dashboards and data feeds
Add external resources as MashZone NextGen files
Find MashZone NextGen files
Update or delete MashZone NextGen files
Share MashZone NextGen resource files
Manage resource directories
Create resource directory
Change resource directory
Delete resource directory
Share resource directory
Manage URL aliases
Create URL alias
Change URL alias
Delete URL alias
Share URL alias
Deploying MashZone NextGen instances, clusters, or artifacts
Deploying the core widgets
Deploying artifacts and other metadata using the command line
Export users, groups, and role assignments
Export role assignments for users and groups
Export dashboards
Export data feeds
Export aliases
Import users, groups, and role assignments
Import role assignements for users and groups
Import dashboards
Import data feeds
Import aliases
Deploying multiple MashZone NextGen servers in one host
Deploying artifacts using the Admin Console
Export dashboards, data feeds, and aliases
Import dashboards, data feeds, and aliases
Clustering MashZone NextGen Servers
Setting Up a New Cluster
Adding New Members to an Existing Cluster
Sharing the MashZone NextGen Repository in Clustered Environments
Create and Share a New MashZone NextGen Repository
Share an Existing MashZone NextGen Repository
Setting Up an External MashZone NextGen Configuration Folder
MashZone NextGen File-Based Configuration and Extensions
MashZone NextGen Configuration Files That Can Be External
MashZone NextGen Configuration Files That Must Be Internal
MashZone NextGen Extensions
MashZone NextGen dashboards in a clustered scenario
Preliminary
Configuration
MashZone NextGen Event Service
rtbs.properties
zookeeper.properties
server.properties
MashZone NextGen nodes
Customizing dashboards
Custom styles
Custom widgets
Using JDBC drivers
Local file resources
Customize application and dashboard styles
Customize dashboard and widget styles
Customize the application style
Customize the MashZone NextGen welcome page
Download styles
Upload styles
Compile styles
Delete styles
Switch the style editing mode
Adjust the font size to different devices
Custom widgets
How are the style files structured?
Event Service Configuration and Administration
About the Event Service and Event Data
Use Events as Information Sources
Manage EDA Event Sources
Create EDA Event Sources
Edit EDA Event Sources
Simple and Hybrid Throttling Strategies
Duplicate EDA Event Sources
Delete EDA Event Sources
Share EDA Event Sources
Manage Apama Event Sources
Create Apama Event Sources
Duplicate Apama Event Sources
Delete Apama Event Sources
Edit Apama Event Sources
Share Apama Event Sources
Start or Stop an Event Source
Restart all Event Sources
Manage Apama Instances
Create Apama Instances
Edit Apama Instances
Delete Apama Instances
Manage Apama Event Targets
Create Apama Event Targets
Edit Apama Event Targets
Delete Apama Event Targets
Share Apama Event Target
Process Performance Manager Integration
Manage PPM Connections
Create PPM Connections
Edit PPM Connections
Delete PPM Connections
Share PPM connections
webMethods Business Console Integration
Example
Authentication
Example URL
Configuration
Outbound API
Inbound API
MashZone NextGen Repositories
Maintenance Suggestions
Tuning the MashZone NextGen Repository Connection Pool
Connection Pool Size Properties
Idle Pool Connection Properties
Synchronize the MashZone NextGen Repository and MashZone NextGen Server Time Zones
Appendix
Widgets
Action button
Bar chart
Bubble chart
Circular gauge chart
Column chart
Date filter
Distribution chart
Drop-down box
Grid
Horizontal and vertical gauge chart
Image
Input field
Label
Line chart
List
Map with markers
Pie chart
Rich text area
Slider
Jump to PPM client
Traffic lights
Vector map
Operators
Data source operators
ARIS table
BigMemory Max
CSV
Data feed
Events
JDBC
JSON
Excel
PPM
Add filters
Terracotta
XML
URL parameter syntax
RAQL and SQL statement parameters
Data transformation operators
Aggregate
Arithmetic
Average
Change data type
Change data type - single value
Column to value
Combine data feeds
Concatenate data feeds
Concatenate texts
Conditional replace
Convert text
Copy data feeds
Copy single value
Delete column
Duplicate column
Extract text
Filter by date
Filter rows
Find text index
Goal accomplishment
Insert column
Merge single texts
Move date
Named copy
RAQL Inline
Rename column
Replace text
Round up/down
Round up/down date
Runtime info
Value to column
User input operators
Date user input
Date user input (List)
Number user input
Number user input (List)
Text user input
Text user input (List)
Analytics with RAQL
About the Real-Time Analytical Query Language
Scope of RAQL
RAQL in MashZone NextGen
Query Syntax of RAQL
Data types in RAQL
Language reference
Reserved keywords
Syntax Reference
ExplainOrSelectStatement
CharacterConstant
SelectStatement
SelectWithOrder
QueryExpressionBody
QueryTerm
QueryPrimary
SelectWithoutOrder
SelectList
SelectItem
SelectStar
ObjectName
SqlSimpleExpression
SqlMultiplicativeExpression
SqlExponentExpression
SqlUnaryExpression
SqlPrimaryExpression
SqlExpression
SqlAndExpression
SqlUnaryLogicalExpression
SqlRelationalExpression
SqlExpressionList
SqlRelationalOperatorExpression
Relop
SqlInClause
SqlBetweenClause
SqlLikeClause
IsNullClause
Constant
FunctionCall
CastableDataTypeDeclaration
UserDefinedType
SimpleCaseCall
BooleanCaseCall
AggregateFunctionCall
SourceField
GenericFunctionCall
ConstantList
WindowSpecification
OrderByClause
WindowFrameClause
WindowFrameStart
FrameBound
WindowFrameBound
GroupingOperation
WindowFunctionCall
LongConstant
IntegerConstant
ArrayElementReference
ArrayValueConstructor
Alias
FromClause
FromItem
SourceReferenceOrSubquery
SourceReference
JoinedTable
SourceFieldList
WhereClause
GroupByClause
GroupingElementList
GroupingElement
EmptyGroupingSet
OrdinaryGroupingSet
GroupingExpressionReferenceList
GroupingExpressionReference
RollupList
OrdinaryGroupingSetList
CubeList
GroupingSetsSpecification
GroupingSetList
GroupingSet
HavingClause
LimitClause
S_NUMBER
FLOAT
INTEGER
DIGIT
S_PARAMETER
S_IDENTIFIER
NAMESTARTCHAR
NAMECHAR
S_QUOTED_IDENTIFIER
S_CHAR_LITERAL
IgnorableWhitespace
LINE_COMMENT
MULTI_LINE_COMMENT
RAQL extensions
RAQL function extensions
Plain functions
Analytic functions
Window functions over RANGEs
Migrate RAQL queries from Version 3.7 to 3.8
Update plain functions for 3.8
Update analytic functions for 3.8
Creating new user-defined functions
Set Up Your Development Environment
Write Plain Functions for RAQL
Configure, Compile, Deploy and Test User-Defined Functions
UDF Library Configuration
External UDF Library Deployment Folder
Write Window Analytic Functions for RAQL
Construct and Initialize the Window Analytic Function Class
Implement the call Method for the Window Analytic Function
Complete WindowSum Example
Work with Specific Records in Window Calculations
Write Aggregate Analytic Functions for RAQL
My Average Aggregate Example
Kurtosis Using a Third Party Library
Use a Factory for Function Overloading
MashZone NextGen Platform API Console
Open the MashZone NextGen API Console
MashZone NextGen Platform Services
Root Cause Miner
Symptoms and root causes
Limitations
Score
Scaled system
Permissions
How to use the Root Cause Miner widget
Additional Information and Support
Samples, Help and Other Documentation
Version and License Information
Legal information
Documentation scope
Data protection
Legal notices
Index