To run and use Scheer PASProcess Analytics you need a database to store the collected statistical and tracing data. The Scheer PASProcess Analytics can be connected to an MySQL, an Oracle, or an SQLServer database. To set up the analytic database, you need a valid installation of one of these three.
When preparing the database installation, please consider the following:
The Process Analytics database contains analytic data for statistical analysis and can reach a considerable size. But, in contrast to databases that store application data, it does not need to be highly available and fulfill strict recovery requirements. To prevent that the Process Analytics database reaches an unbearable size, you should
use a separate database to store the Process Analytics data.
run this separate database within a less strict recovery mode (e.g. NOARCHIVELOG in Oracle).
This may lead to the fact that a point in time recovery is not possible, but this will not cause problems as lost data can be simply reloaded from the BRIDGE logs.
The analytic database is composed of two parts:
The first part contains stored procedures and working tables used during the collection of data.
The second part contains the front-end tables which are queried by the Process Analytics services to present the data in a user interface.
Setting up an MySQL Database
To use an MySQL database, you need to
create an empty schema.
grant the Process Analytics user SELECT privileges on table mysql.proc.
GRANT SELECT ON 'mysql'.'proc' TO '<user>'@'<mysql server>';
All tables and procedures will be created by the TrxLogsETL service at startup.
If you want to install the Process Analytics database on a MySQL Database using Amazon Web Services RDS, you may get the following error:
You do not have the SUPER privilege and binary logging is enabled
To solve this problem, enable log_bin_trust_function_creators by following the explanations of the AWS Guide.
Setting up an SQLServer Database
To use an SQLServer database, you only need to create an empty schema. All tables and procedures will be created by the TrxLogsETL service at startup.
If you want to use Bulk Upload with SQLServer, you need to provide the database user that is associated with the TrxLogsETL with permissions to administer bulk operations, like e.g.
GRANT ADMINISTER BULK OPERATIONS TO <db_user>
Setting up an Oracle Database
To use an Oracle database with ETL by inserts, you need to create an empty schema. All tables and procedures will be created by the TrxLogsETL service at startup.
Setup for ETL by Bulk Upload
On your Oracle server, create a work directory that will contain the logs to be loaded into the database. The collector services TryLogsCollector and TrxLogsETL will use this directory.
Open an SQLPlus command shell and connect to the Oracle database with an administration account.
Make the directory created in step 1 known to Oracle. Create a reference using:
CREATE DIRECTORY oracleWork AS '<path to folder>';
GRANT READ ON DIRECTORY oracleWork TO <database user the dashboard services will use>;
The name of the work directory must be oracleWork.
All tables and procedures will be created by the TrxLogsETL service at startup.
Access to sys.dbms_crypto
For both setup scenarios the database administrator needs to grant access to package sys.dbms_crypto to the Process Analytics database user:
GRANT EXECUTE ON SYS.DBMS_CRYPTO TO <dashboard_user>;