Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Forms: System Configuration

The system configuration shows all general system wide properties configured in PhixFlow.To open the system configuration, press the 'Admin' button in the top right hand corner, and select 'System Configuration' from the menu.

...

The following fields are configured on the General Settings tab:in system configuration

AnchordefaultExportExcelVersion
FieldDescription
General Settings
Customer NameThis field cannot be modified. The Customer Name is entered during system installation.
PhixFlow InstanceAny text entered here appears on the application banner. For example if you have multiple instances of PhixFlow installed (Live, Test etc.) then you can enter a value in this field so that users can easily see which system they are using.

After changing this field you will need to restart the browser or reload the application (User → Reload Application) to see the new value in the banner.

System Email AddressThe email address where system generated mails will be sent from.Allow anonymous export
Anchor
defaultExportExcelVersion
defaultExportExcelVersion
Default Export Excel Version
The default version of Excel to be used when exporting data from PhixFlow to Excel. This is only used if a non-valid excel extension, such as "csv", is used in the file name extension specified in the exporter. Otherwise PhixFlow will determine the correct format from the extension specified in the file name. See file exporters for details.
Validate attribute exists at runtimeSpecifies whether or not PhixFlow should check that an attribute exists when a model attempts to read the value of an attribute from a stream record or a record supplied by a collector. Previously, if no attribute could be found with the given name a Null value was return. If this flagged is ticked PhixFlow will now treat this as an error.Allow access to data by defaultSpecifies the default data access permission on new streams. Possible values are:
  • "T" - By default, all users will be allowed access to the stream data.
  • "F" - By default, no users will be allowed access to the stream data unless they are a member of a user group which is explicitly added to the stream.
Note that this is just a default behaviour as any user with the permission to add user groups to a stream may change the data access rights for a stream.
Row Selection StyleSelect the default row selection style. This will apply to all selected rows in all grid views, unless on that grid view a local selection style is set.
Default Component PaletteSelect a default component palette.
Decimal PlacesThe default number of decimal places to show for float values in view, unless a different value is set for an individual stream view attribute.
Date FormatThe default format for dates in views, unless a different format is applied for an individual stream view attribute.
Date/Time FormatThe default format for datetimes in views, unless a different format is applied for an individual stream view attribute.
Allow access to data by defaultSpecifies the default data access permission on
exporting data from a Datasource
new streams. Possible values are:
  • "T" - By default, all users will be allowed access to
export functionality
  • the stream data.
  • "F" - By default, no users will be allowed access to
export functionality
  • the stream data unless they are
specifically configured against the datasource.Colour of Windows with Focus

Colour for focused windows in PhixFlow front end.

After changing this field you will need to restart the browser or reload the application (User → Reload Application) to see the new colour.

Colour of Windows without Focus

Colour for unfocused windows in PhixFlow front end.

After changing this field you will need to restart the browser or reload the application (User → Reload Application) to see the new colour
  • a member of a user group which is explicitly added to the stream.
Note that this is just a default behaviour as any user with the permission to add user groups to a stream may change the data access rights for a stream.
Allow anonymous export by defaultSpecifies the default access permission on exporting data from a Datasource. Possible values are:
  • "T" - By default, all users will be allowed access to export functionality.
  • "F" - By default, no users will be allowed access to export functionality unless they are specifically configured against the datasource.
Help UrlThe base url for PhixFlow help. This is pre-set for each PhixFlow release, and should not be changed without consulting PhixFlow support.
Online Support Url

The Url to open when the user requests online support through PhixFlow. Under normal circumstances you should not need to update this setting. If you have problem with PhixFlow help, please contact the PhixFlow support team (see the welcome page for contact details).

After changing this field you will need to restart the browser or reload the application (User → Reload Application) to start using the new help location.

Home Screen Message HTML FileThe path and filename of a file containing HTML that will be displayed on the PhixFlow home screen before logging into PhixFlow. See Setup PhixFlow Home Screen Message for details.

System Directories tab

The following fields are configured on the System Directories tab:

FieldDescriptionImport File LocationThe default base directory path for files to be imported into Geneva. This field can be left blank. See File Collectors for further details.Export File LocationThe default base directory path for files to be exported into Geneva. This field can be left blank. See File Exporters for further details.Template LocationThe location templates when doing excel downloads.Archive DirectoryThe default base directory path for data to be archived. This field can be left blank.Restore DirectoryThe default base directory path for data to be restored from. This field can be left blank.Application LocationThe location of the PhixFlow installation.
System Email AddressThe email address where system generated mails will be sent from.
Restrict non admin logins onlyRestrict access to PhixFlow to only users who are part of the administrators group. This can be set if a system is being put into a maintenance state, and normal access needs to be revoked to everyone other than administration users.
Allow access to run actions by defaultIf ticked, by default all users will have access to run actions (providing they have functional rights to run actions), unless this is overridden at the level of individual actions.
Home Screen Message HTML FileThe path and filename of a file containing HTML that will be displayed on the PhixFlow home screen before logging into PhixFlow. See Setup PhixFlow Home Screen Message for details.

System Directories

On Windows hosted systems, please be sure to prefix directory names with a drive letter, e.g. 'C:'

Plugin LocationThe location of any PhixFlow plugin applications.
Temporary File
Application LocationThe location of
any PhixFlow temporary files that are generated
the PhixFlow installation.
Performance
Import File LocationThe
location of the resultant analysis performance files when the system tuning 'Generate Performance Files' check box has been ticked.Restricted DirectoryThe root directory path that all files read using File Collectors must reside under. Note that this value is not editable through the GUI and must be set directly within the database.File Upload DirectoryThe root location of all uploaded files and all processed incoming email's.
The sub directory structure of the resultant (uploaded files/processed email's) is the following:-
Uploaded Files:
/FileCollector Name/in/YYYYMMDD/UniqueId/
where YYYYMMDD represents the date the files were uploaded and UniqueId is a 32 character unique identifier.
Incoming Email's:
/YYYYMMDD/EmailId/
where YYYYMMDD represents the date the email was read and processed by PhixFlow and EmailId is a 32 character unique email identifier.
For Email's each EmailId folder will contain a file called body.txt representing the main body content of the email and also any corresponding email attachments.

System Tuning tab

The following fields are configured on the System Tuning tab:

Advanced tab

The following fields are configured on the Advanced tab:

FieldDescriptionSystem LanguageThe system language code specifies which language should be used for login screens and for all non interactive messages.Defines how frequently objects are written to disc. This is Delete Batch the default number of rows to be deleted from a Stream in a single transaction when Archiving or Rolling back dataDefault When reading option which should not be updated without advice from the PhixFlow support team.The length of time the PhixFlow front end application will wait for a result from an asynchronous query before abandoning it. This is an advanced option which should not be updated without advice from the PhixFlow support team Email's or not
FieldDescription
Thread Pool SizeThe number of threads that can be in the pool at any time. This is an advanced option which should not be updated without advice from the PhixFlow support team. This is generally a small multiple of the number of CPU cores on your machine.
Write Processes Per Stream SetThis is an advanced tuning feature which enables PhixFlow to multi-thread the process of writing Stream Data to the database. The value of this parameter is dependent upon machine versus database performance.
Database Flush Sizedefault base directory path for files to be imported into PhixFlow. This field can be left blank. See File Collectors for further details.
Export File LocationThe default base directory path for files to be exported from PhixFlow. This field can be left blank. See File Exporters for further details.
Template LocationThe location templates when doing excel downloads.
Temporary File LocationThe location of any PhixFlow temporary files that are generated.
Performance File LocationThe location of the resultant analysis performance files when the system tuning 'Generate Performance Files' check box has been ticked.
Archive DirectoryThe default base directory path for data to be archived. This field can be left blank.
Restore DirectoryThe default base directory path for data to be restored from. This field can be left blank.
Restricted DirectoryThe root directory path that all files read using File Collectors must reside under. Note that this value is not editable through the GUI and must be set directly within the database.
File Upload Directory

The root location of all uploaded files and received email messages.

Uploaded files/processed emails are saved in standard sub-directories as follows:

.../tag/in/yyyymmdd/uid/

where

tag is the File Collector tag or the #tag extracted from an email subject line, or default

yyyymmdd is the date the files were uploaded / received

uid is a 32 character unique identifier

For each email message received, the folder will contain a file called body.txt representing the main body content of the email and also any corresponding email attachments.

System Tuning

Warning: The following are advanced settings which should not be changed without consulting PhixFlow Solutions.

Thread Pool SizeThe number of threads that can be in the pool at any time. This is an advanced option which should not be updated without advice from the PhixFlow support team. This is generally a small multiple of the number of CPU cores on your machine.
Database Flush SizeDefines how frequently objects are written to disc. This is an advanced option which should not be updated without advice from the PhixFlow support team.
Result Expiry Time (sec)The length of time the PhixFlow front end application will wait for a result from an asynchronous query before abandoning it. This is an advanced option which should not be updated without advice from the PhixFlow support team.
Default Page Size

Defines the default number of rows to be loaded into to a grid when displayed in PhixFlow. This is an advanced option which should not be updated without advice from the PhixFlow support team.

After changing this field you will need to restart the browser or reload the application (User → Reload Application) to apply the new default page size.

Maximum Page/Chart SizeThis value defines the largest number of records that can be downloaded from a chart in a single file. Downloads with more than this number of records will be split into multiple files which are zipped together.
Default Buffer SizeDefault Buffer SizeWhen reading in data from a collector, this defines how many rows are held in memory before passing them on for processing. This means that if PhixFlow is reading in 10,000,000 records, it doesn't have to wait until all have been loaded before it begins to process them, but can begin processing after the first 2000 have been read. This is an advanced
Enforce Pipe Cache Size

If checked, the Pipe Cache sizes below, and per Pipe, are strictly enforced; a pipe lookup which tries to cache too many records will fail and an error will be reported.

If not checked, exceeding the cache size on a pipe will result in a warning message.

Default Pipe Cache SizeThis value is used when a pipe's cache size has not been set.
Max Pipe Cache SizeThis value is the maximum allowed cache size; pipes with caches greater than this will be failed.
Result Expiry Time (sec)option which should not be updated without advice from the PhixFlow support team.
Delete Batch SizeDefines the default number of rows to be deleted from a Stream in a single transaction when Archiving or Rolling back data. This is an advanced option which should not be updated without advice from the PhixFlow support team.
Default Batch SizeThe size of batches used to write records to the database - that is, this many records are written to the database between each commit.
Write Processes Per Stream SetThis is an advanced tuning feature which enables PhixFlow to multi-thread the process of writing Stream Data to the database. The value of this parameter is dependent upon machine versus database performance.
Maximum Download SizeThis value defines the largest number of records that can be downloaded from a chart in a single file. Downloads with more than this number of records will be split into multiple files which are zipped together.
Validate attribute exists at runtime

Specifies whether or not PhixFlow should check that an attribute exists when a model attempts to read the value of an attribute from a stream record or a record supplied by a collector. If not ticked, if no attribute could be found with the given name a null value is return. If ticked, PhixFlow will raise an error. 

It is strongly recommended that this flag is ticked.

Inactivity Time (sec)This sets the amount of time (in seconds) that must pass after a user operation before the PhixFlow client application will start any background clean-up processes.
Maximum File Size Attachment (MB)

Outgoing

emails will only attach files (zipped or unzipped) that do not exceed this configuration limit. An extra message will appear in the email's message subject/body indicating to the recipient that a file attachment has been removed due to this size restriction.

PhixFlow will not impose any upper limit to the size of the attached files if this field is left blank, hence in this case the underlying email servers will determine if the message is sent/received correctly

or not.

Maximum Pivot ColumnsThe system-wide default for the maximum number of columns that can be generated by a pivot table. This applies unless a different maximum pivot columns setting is applied for an individual stream view.
Maximum Exporters Errors

If required, you can set the maximum number of errors found, before exporters will stop attempting to export records.

This is useful where you process large number of records and do not want

to wait until all records are processed in case of errors occurred. This value can be overridden in Exporters.
Generate Performance StatsIf checked, PhixFlow will generate performance statistics whilst the analysis engine is running.
Log Statistics to FileIf checked, logging is enabled and Processing Statistics are written to file

to wait until all records are processed in case of errors occurred. This value can be overridden in Exporters.

Stats File Logging SecondsA period in seconds controlling how often statistical data is written to file.
Log Statistics to DBFileIf checkedticked, logging is enabled and Processing Statistics are written to the database. See Processing Statistics for further detail.
Stats DB Logging SecondsA period in seconds controlling how often statistical data is written to the database.

GUI Tuning tab

The following fields are configured on the GUI Tuning tab:

Warning: The following are advanced settings which should not be changed without consulting PhixFlow Solutions.

...

written to file.
Log Statistics to DBIf checked, PhixFlow will generate performance statistics whilst the analysis engine is running and write the results to a database table.
Stats DB Logging SecondsA period in seconds controlling how often statistical data is written to the database.
Log Statistics to DBIf ticked, logging is enabled and Processing Statistics are written to the database. See Processing Statistics for further detail.

Anchor
enforcePipeCacheSize
enforcePipeCacheSize
Enforce Pipe Cache Size

If ticked, Pipe Cache sizes are strictly enforced; a pipe lookup which tries to cache too many records will fail and an error will be reported.

If not ticked, exceeding the cache size on a pipe will result in a warning message.

Default Pipe Cache SizeThis value is used when a pipe's cache size has not been set.
Maximum Pipe Cache SizeThis value is the maximum value that Cache Size can be set to on any pipe; a pipe with a Cache Size greater than this will generate a run-time error.
Enforce In Memory Cache Size

If ticked, cache sizes for in memory streams are strictly enforced; an in memory stream which tries to cache too many records will fail and an error will be reported.

If not ticked, exceeding the cache size on an in memory stream will result in a warning message.

Default In Memory Cache SizeThe size of the cache for an in memory stream if this is not set on the stream.
Maximum In Memory Cache SizeThe maximum allowed cache size for any in memory stream. A stream with a cache size greater than this will generate a run-time error.
Advanced
Default Character SetThe character set PhixFlow assumes when reading from or writing to any plain text or CSV file. Please note that this must be a character set supported by the Java virtual machine and that multi byte settings such as
UTF8 (e.g. for Japanese etc.) are supported.
UTF8 (e.g. for Japanese etc.) are supported.
Data Storage Group

The Data Storage Group to use when creating tables to store Stream data. This field is interpreted differently depending on the underlying database:

  • On Oracle, a Data Storage Group is equivalent to a Tablespace.
  • On SQL Server, a Data Storage Group is equivalent to a Filegroup.
  • If no Data Storage Group is specified, the database user's default setting will be used.
Line Separator StyleThe
user can specify a
default line separator style that will be used by File Exporters where no particular line separator has been specified. If
the user does
you do not specify a default style here then
the default will revert to be the default of the operating system on which the PhixFlow server is running. In addition you can specify the line separator on each file exporter where a particular exporter needs to use a style other than the system default.Data Storage GroupThe Data Storage Group to use when creating tables to store Stream data. This field is interpreted differently depending on the underlying database:
On Oracle, a Data Storage Group is equivalent to a Tablespace.
On SQL Server, a Data Storage Group is equivalent to a Filegroup.
If no Data Storage Group is specified, the database user's default setting will be used
the default will revert to be the default of the operating system on which the PhixFlow server is running. In addition you can specify the line separator on each file exporter where a particular exporter needs to use a style other than the system default.
Default Stream StorageThis specifies the default Storage Type when creating a new Stream.
  • Database: Store the data in a regular table within the PhixFlow database. This is the most common option
  • Database (Partitioned): Store the data in a partitioned table within the PhixFlow database. This option provides improved performance for rollback and archiving of very large Streamsets. The option is only available if "partitioning" is available within your database installation.
  • In Memory: Data for the Stream will not be written to the database. This option can be used (for example) when you want to aggregate large amounts of unsorted data which can then be written to a stored Stream.
Effective DateEffective date to be used when date override is in use.
Schema VersionRead only: the version of the schema currently installed.
Licence KeyThis is the Licence Key for your PhixFlow Installation which is provided by PhixFlow Customer Support. If PhixFlow is not configured with a valid key, analysis tasks will not run and an error message will be displayed in the log file.

A Licence key

can sometimes be associated

issued with an expiry date. If the licence has expired an additional field will show the expiry date. After a licence has expired PhixFlow will generate warning messages in the analysis logs for 28 days beyond the expiry date. After this time analysis tasks will cease to run.

Expires OnThe date that the current Licence Key will expire.

Anchor
deleteLogMessagesAfterDays
deleteLogMessagesAfterDays
Delete Log Messages after Days


If this field is set, a System Task, when run, deletes Log Messages and Managed Files for Log Files older than this number of days.

See
Plans
a System

Anchor
archiveDeletedLogMessagesToFile
archiveDeletedLogMessagesToFile
Archive deleted log messages to file

Whether to archive Log Messages to file before deletion. Archived Log Messages are written to archive files in the Archive Directory (see above).

There is no option to archive Managed File entries to file before deleting them.

Default
Password PolicyThe password policy selected by default when creating new users. Password Policies can be edited in the Password Policies List
Allow Reset Configuration

Before performing a 'Reset Configuration' the administrator must tick this checkbox to allow access to reset the configuration.

WARNING: Resetting the configuration will delete all configuration data in the PhixFlow Instance.

See Configuration Reset for how to reset the configuration

Anchor
deleteStatisticsAfterDays
deleteStatisticsAfterDays
Delete

Stats Records

Statistics after Days

If this field is set, a System Task, when run, deletes Processing Statistics records from the Database older than this number of days.

See

See Task

Plans

for how to set up and run

a System

a System Task.

Archive deleted
Stats Records
Statistics to fileArchiving is not yet available for Processing Statistics records that have been deleted. Records are currently only deleted after the number of days specified in the System Configuration 'Delete Stats Record after Days' field.

Active Directory tab

...

Active Directory

...

Field
Description

Default DomainThe default Domain which will be initially selected on the login screen.
Active Directory Login GroupNames of Active Directory Groups whose members are allowed to log in into the PhixFlow. Names can be separated by a semicolon. Use {instance} to include the PhixFlow instance name.

Form Icons

...

The form provides the standard form icons.

See Also