Third-Party Configurations

Before installing Process Discovery, there are some key steps to take. These include setting up databases (MariaDB and MongoDB) and configuring Seq (Structured Event Query Language).

While the System Manager supports an all-in-one installation, you will still need to separately install MongoDB and MariaDB. You have the option to install them on the same server or a remote server. However, it is recommended to install them on a remote server for optimal performance.

This list will walk you through the process, to ensure a successful Process Discovery installation.

Seq

  1. Download Seq.

  2. Locate and open the downloaded MSI installer file to start the installation process.

  3. Follow the installation on-screen prompts and instructions.

    Leave the installation configurations at their default settings unless you have specific requirements.

  4. Proceed with the installation and wait for the process to complete.

  5. Start the Seq service.

    If this is your first time installing Seq, selecting to start the Seq service will open the Seq Service Administration dialog for initial configuration.

  6. Provide a location to store Seq's data files and a URL to host the user interface and HTTP API. If you are unsure, it is recommended to choose the default options.

  7. Deselect the option Create a limited user account for the Seq Windows Service.

  8. Complete the Password fields with a strong and unique password that is not used for any other accounts.

  9. Click Next.

Make sure to remember the API key generated during the installation process. Once the Seq Service Administration dialog is closed, the API key will not be accessible or retrievable. It is important to keep the API key in a secure location for future use.

  1. Open the Seq admin panel in your web browser.

  2. Navigate to the API Keys section in the admin panel menu.

  3. Complete any required fields or provide necessary information for the API key, such as a name or description.

  4. Choose the desired permissions or access levels for the API key. This may include options such as read-only access or full administrative privileges.

  5. Click SAVE CHANGES to generate the API key.

  6. Make a note of the API key token for future reference and use. It is important to store the API key token securely as it will be needed for authentication and accessing the Seq API in the future.

MariaDB

The installation process may vary slightly depending on your operating system and the version of MariaDB you are installing. Always refer to the official MariaDB documentation and installation guides for the most accurate and up-to-date instructions.

  1. Download the MariaDB Server installation package from the official website using the pre-signed URL provided: MariaDB Server Download.

  2. Open the downloaded MSI installer.

  3. Click Next.

  4. Select the I accept the terms in the License Agreement checkbox.

  5. Click Next until the installation wizard reaches the Default instance properties dialog.

  6. Set the password for the root user.

    This password is important for administrative tasks, so choose a strong and secure password, and keep it accessible.

  7. Select the Enable access from remote machines for 'root' user checkbox. This will allow you to connect to the database from external tools.

  8. Click Next until the installation wizard reaches completion.

  9. Click Install to finalize the installation.

    If you have upgradable instances of MariaDB/MySQL already running as services, an additional dialog will appear with a Do you want to upgrade existing instances checkbox. If selected, this checkbox will launch the Upgrade Wizard post-installation. For instances where you have installed a database instance as a service, the service will already be running.

  1. Run the HeidiSQL Setup application (HeidiSQL_12.4.0.6659_Setup) from the Process Discovery bundle zip file (C:\Downloads\nintex-pd-23.8.0-full\installer-assets).

  2. Follow the installation on-screen prompts and instructions.

    Leave the installation configurations at their default settings unless you have specific requirements.

  3. Click Finish to complete the installation.

  4. Launch HeidiSQL from the Start menu or by double-clicking the desktop shortcut.

  5. Click New in the Session manager.

  6. In the Settings tab, configure the connection details:

    • Network type: MariaDB or MySQL (whichever is applicable)

    • Hostname/IP: Enter the hostname or IP address of the server where MariaDB is installed.

    • User: Enter the username (typically 'root') for the MariaDB server.

    • Password: Enter the password associated with the username.

    • Port: Default is usually 3306 for MariaDB.

  7. Click Open to establish the connection to the MariaDB server.

MongoDB

Ensure that port 27017 is open between the database server and the application server. This applies to both internal and external firewalls.

  1. Download the MongoDB Community Server.

  2. Run the installer package and follow the on-screen instructions to begin the installation process, using the default options.

  3. Once the installation is finished, configure MongoDB by modifying the configuration file C:\Program Files\MongoDB\Server\6.0\bin\mongod.cfg in a text editor like Notepad++ or a similar program:

    This is the default installation path, which may vary depending on your MongoDB version and whether you chose a different installation folder during installation.

    1. Remove the bindIp field in the net section.

    2. Add a new field called bindIpAll in the net section with the value set to true.

    3. Add a new field called ipv6 in the net section with the value set to true.

      Copy

      Edit file

        port: 27017
        bindIpAll: true
        ipv6: true

  4. Restart the MongoDB service.

  1. Launch MongoDB Compass.

  2. Click Connect to establish the connection to the local server.

  3. Click on the + (Add) icon next to Databases on the left side menu.

  4. Enter kryon-db in the Database Name and Collection Name fields.

    The collection name is required for the database setup but can be removed after the database is created since it's not needed for normal operations.

  5. Choose additional options such as the Time-Series and Additional preferences if necessary.

  6. Click Create Database.

    MongoDB creates the database, and it appears in the list under the Databases section.

  1. Launch MongoDB Compass.

  2. Click on >_MONGOSH, which is typically located near the bottom left of the application interface.

  3. Enter the following command and press Enter. The confirmation should display switched to db admin.

    Copy 
    use admin

  4. Enter the following command and press Enter to create a new user. The confirmation should display { ok: 1 }.

    The default password can be changed later if needed

    Copy 
    db.createUser(
           {
               user: "nintex",
               pwd: "Nintex123!",
               roles: [ { role : "readWrite", db: "kryon-db"}]
           }
       )

  5. Enter the following command and press Enter to create a new admin user. The confirmation should display { ok: 1 }.

    Copy 
    db.createUser(
           {
               user: "admin",
               pwd: "Nintex123!",
               roles: [ "root" ]
           }
       )

  6. Minimize the MongoDB shell.

    In the MongoDB shell window, in the top right corner of the shell interface, click the downward-pointing arrow to collapse or minimize the window.

  1. Run the Robo 3T application (mongodb-client-robo3t-1.4.1-windowns-x86_64-122dbd9) from the Process Discovery bundle zip file (C:\Downloads\nintex-pd-23.8.0-full\installer-assets).

  2. Click on Connect or go to File > Connect from the menu.

  3. Click Create button to create a new connection.

  4. In the Connection tab, configure the connection details:

    • Type: Direct Connection

    • Name: A name to identify this connection.

    • Address: FQDN Database server

    • Port: 27017

  5. In the Authentication tab, configure the connection details:

    • Perform authentication: Check this box.

    • Database: admin

    • Username: Database username

    • Password: Database password

    • Auth Mechanism: SCREAM-SHA-1

  6. Click Test to check the success of the connection.

Next step:

After completing these configurations, continue with the Process Discovery installation using either the GUI installer or the Silent installation.