Basic setup

MonetDB

You must install MonetDB to use IBM Process Mining NextGen. For more information on installation, see the Installing MonetDB topic.

MongoDB

You need a working MongoDB instance before you proceed with the database installation. For more information about installing MongoDB, see the Installing MongoDB instance topic.

To configure and initialize the MongoDB for the application, do the following configurations:

• Basic MongoDB configuration
• MongoDB configuration for process app

Basic MongoDB configuration

To configure MongoDB, copy and paste the following code snippet in the persistence section in <PM_HOME>/etc/processmining.conf:

persistence: {
  mongodb: {
    database: "<database name>",
    host: "<database host>",
    port: 27017,
    user: "<database user>",
    password: "<database password>"
 }
}

To ensure security, you must enter the encrypted <database password> in the processmining.conf file. For more information on how to encrypt the password, see the Password encryption topic.

MongoDB configuration for process app

To configure MongoDB for process app, edit the following attributes in the <PM_HOME>/etc/accelerator-core.properties file per your existing MongoDB configurations:

# mongo configuration please update as per your mongo db detail
spring.data.mongodb.authentication-database=<authentication database name>
spring.data.mongodb.database=<database name>
spring.data.mongodb.port=27017
spring.data.mongodb.host=<database host>
spring.data.mongodb.password=<database unencrypted-password>
spring.data.mongodb.username=<database user>
spring.data.mongodb.uuid-representation=standard

where:

• <authentication database name> is the name of database in which the <database user> is created and in most cases it is the same as <database name>.
• <database host> is the hostname of MongoDB.
• <database user> is the user created in MongoDB.
• <database unencrypted-password> is the unencrypted version of the <database password>.

Alternatively, you can set up the MongoDB for Process App using URI. For more information about configuring MongoDB using URI, see the Setting up MongoDB for process app using URI topic.

Optimizing memory for process app

To optimize the memory for process app, you can change the value of mem_limit_bytes in the custom.ini file in the following filepath:

PM_HOME/etc/accelerators/custom.ini

However, the recommended minimum value for mem_limit_bytes is 16000 * 1024 * 1024 (16 GB).

Install NGINX

To install NGINX, use one of the following options depending on the operating system of the web server:

• If you want to install NGINX in Ubuntu operating system, use the following command:

   apt-get install nginx
  

• If you want to install NGINX in Red Hat operating system, use the following command:

  yum install nginx
  

After installing NGINX, you must activate NGINX if you did not activate it earlier. To activate NGINX, use the following command:

  systemctl enable nginx
  systemctl start nginx

Configure the NGINX virtual host

To configure the NGINX virtual host, you must copy the Template Virtual Host file, which is available in the IBM Process Mining package, into the NGINX configuration. Use one of the following options to copy the Template Virtual Host file depending on the operating system of the web server:

• If you use the Ubuntu operating system, use the following command:

  cp <PM_HOME>/nginx/processmining.conf /etc/nginx/sites-available/
  

• If you use the Red Hat operating system, use the following command:

  mv /etc/nginx/conf.d/default.conf /etc/nginx/confd/default_origin.conf
  cp <PM_HOME>/nginx/processmining.conf /etc/nginx/conf.d/default.conf
  

Configure NGINX SSL

To configure NGINX SSL, do the following steps:

1. Create the ssl directory by using the following command:

     mkdir /etc/nginx/ssl
   

2. Copy the SSL certificate to the ssl directory. Use one of the following options depending on the type of certificate that you created:

   • If you created a self-signed certificate per the steps mentioned in the Self-signed certificates topic, use the following command:

     cp /home/pm/cert/server.* /etc/nginx/ssl/
   

   • If you want to create and download a certificate from a certificate authority (CA), follow the documentation of the CA that you choose. After downloading the certificate, copy the certificate in the /etc/nginx/ssl/ repository.

3. Update the Virtual Host file with the file paths of both the certificate and key that you created.

     ssl_certificate /etc/nginx/ssl/mycompany_com.pem;
     ssl_certificate_key /etc/nginx/ssl/mycompany_com.key;
   

   For example, if you created a self-signed certificate, use the following filepath:

     ssl_certificate /etc/nginx/ssl/server.pem;
     ssl_certificate_key /etc/nginx/ssl/server.key;
   

4. Depending on the operating systems, do one of the following options:

   • If the operating system of the web server is Ubuntu, use the following command to add the virtual host to the enabled sites:

       ln -s /etc/nginx/sites-available/processmining.conf /etc/nginx/sites-enabled/
     

   • If the operating system of the web server is Red Hat with the SELinux enabled, use the following command:

       chcon -t httpd_config_t /etc/nginx/ssl/*.*
       setsebool -P httpd_can_network_connect 1
     

     If the SELinux security is enabled, refer to the Application service startup might fail on SELinux topic for more details.

Test and restart NGINX

To test the changes to your NGINX configuration, use the following command:

  nginx -T

If the test result is good, restart NGINX service by using the following command:

  systemctl restart nginx

Disable data-derived end-activities

In the <PM_HOME>/etc/processmining.conf file, add the following properties to the engine.defaults section to disable the data-derived end-activities.

endActivity:{
enable: false
},

Example:

engine: {

defaults: {
...
endActivity:{
enable: false
},
....
}
}