Skip to content

Latest commit

 

History

History
35 lines (25 loc) · 2.56 KB

how_to_build.md

File metadata and controls

35 lines (25 loc) · 2.56 KB

How to Build and Run the PSM from Sources

1. Building from Command Line

  1. Install JDK 8 64bit (do not use JRE!)
  2. Install git or Mercurial (depends on your repository type)
  3. Install sbt 1.2.x or higher
  4. Install maven and add its folder bin into the Windows PATH
  5. Increase the sbt heap: add system variable SBT_OPTS and set it to 4-8Gb: -Xmx8G (use the same Windows tab as for the previous step)
  6. Download XES implementation OpenXes-XXX.jar and install it into your local maven repository: mvn install:install-file -Dfile=c:\openxes\OpenXES-20211004.jar -DgroupId=org.xes-standard -DartifactId=openxes -Dversion=2.27 -Dpackaging=jar
  7. check out the PSM repository
  8. run sbt from your source root directory and execute commands compile, package

2. Building an Überjar and Running the PSM as a Stand-Alone Application

Read about an Überjar here.

  1. Go to your source root directory and run sbt "set test in assembly := {}" clean assembly from command line.
  2. Move resulting jar file into a separate directory
  3. Copy file log4j.properties into the same directory
  4. Execute java -cp "perf_spec-assembly-1.1.0.jar" org.processmining.scala.viewers.spectrum.view.Form

Increase the JVM heap size for working with large event logs using -Xmx JVM option, e.g., set the heap size to 30Gb if your machine has 32Gb RAM as follows: java -Xmx30G -cp "perf_spec-assembly-1.1.0.jar" org.processmining.scala.viewers.spectrum.view.Form

3. Working in an IDE

  1. First, build the project in the sbt command line: executed compile then package.
  2. Install your favorite IDE that supports Java and Scala development. This project has being developed in Intellij IDEA
  3. Import the pre-built project (use 'import the project structure from sbt files')
  4. Setup Scala 2.12.8 SDK. Earlier versions are not binary compatible.
  5. Use Java 8

Configuration steps depend on the IDE.

If Intellij IDEA highlights lines of .sbt files with red, try to reimport all sbt files through the sbt tool panel (button 'Reload All sbr Projects').