Welcome to your go-to guide for installing and configuring Apromore Core, the open-source edition of the popular process mining toolset. With a rich set of features, Apromore Core empowers you to harness the power of predictive process analytics efficiently. Let’s dive into the straightforward process of getting it up and running seamlessly!

Prerequisites

Before you start your Apromore adventure, make sure your system meets the following requirements:

• Linux Ubuntu 20.04 (or newer versions with minor adaptability), Windows 10, WS2016, WS2019, Mac OSX 10.8 or newer.
• Java SE 11 [Server JRE](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html) or [JDK 11](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html).
• Gradlew Wrapper – included in the source code.
• (Optional) [MySQL server](https://dev.mysql.com/downloads/mysql) 8.0.

Installation Instructions

Follow these simple steps to install Apromore Core from the source code:

1. Check out the source code using Git:

git clone https://github.com/apromore/ApromoreCore.git

2. Switch to the ApromoreCore directory:

cd ApromoreCore

3. Check out the desired branch or tag:

git checkout development

4. Compile the source code and run the project:

./gradlew build --args=--spring.profiles.active=dev

5. Browse to the following URL to access the portal:

http://localhost:8181

Login with these credentials:

Username: admin

Password: password

6. Keep the terminal window open. Press Ctrl-C to shut the server down.

Configuration Options

Configuration is primarily done through the application.properties file located in the ApromoreCore/Apromore-Boot/src/main/resources directory. To set up a MySQL database or customize the default settings, follow the instructions provided in the database setup and other configuration sections of your README file.

MySQL Setup

If you are using MySQL, here’s what you need to do:

1. Ensure MySQL is configured to accept local TCP connections on port 3306.
2. Create a database and necessary user accounts:

bash
mysql -u root -p
CREATE DATABASE apromore CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'apromore'@'%' IDENTIFIED BY 'choose a password';
GRANT SELECT, INSERT, UPDATE, DELETE, LOCK TABLES, EXECUTE, SHOW VIEW ON apromore.* TO 'apromore'@'%';
CREATE USER 'liquibase_user'@'%' IDENTIFIED BY 'choose another password';
GRANT ALL PRIVILEGES ON apromore.* TO 'liquibase_user'@'%';

Troubleshooting

Even the best laid plans can go awry. Here are some common issues you might encounter:

• Server fails to start: Check if your MySQL server is running if configured.
• Can’t view models: Make sure popup blocking is disabled in your browser.
• Where is the server log? You can find it at the location specified in application.properties under logging.file.name. The default is $user_home/.apromore/logs/apromore.log.

For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.

Key Concepts Explained Through an Analogy

Think of installing Apromore Core like setting up a new restaurant:

• The Practical Steps (installation instructions) are akin to choosing a location, preparing the kitchen, and hiring staff.
• Configuration options resemble deciding on the menu and how your restaurant will operate (e.g., hours, special dishes).
• Troubleshooting is like handling hiccups that arise during your opening week, like shortage of ingredients or equipment failures.

Every restaurant has its own unique flavor, and Apromore Core is no exception. Tailor it to your needs and serve up those analytics!

Conclusion

At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.

Now you’re equipped and ready to unleash the full potential of Apromore Core. Get started today, and let the data lead you on an extraordinary journey!