Skip to content

Setup and Build PObserve

[Step 1] Install Java

PObserve is built in Java and requires Java version 17 or higher. If you already have Java 17+ installed 😇, ignore this step.

Installing Java 17 on MacOS using Homebrew (details) 

brew install openjdk@17
Dont have Homebrew? Directly use installer.

Installing Java 17 on Ubuntu (details)

sudo apt update
sudo apt install openjdk-17-jdk

Installing Java 17 on Amazon Linux:

sudo yum install java-17-amazon-corretto-devel

Installing Java 17 on Windows:

  1. Download Java 17 from Oracle or OpenJDK
  2. Run the installer and follow the setup wizard
  3. Add Java to your PATH environment variable
Troubleshoot: Confirm that Java 17+ is correctly installed on your machine.

java -version

You should see output showing Java version 17 or higher. If you get java command not found error, you most likely need to add the path to java in your PATH environment variable.

[Step 2] Install Gradle

PObserve uses gradle build system and requires gradle 8.x. If you already have the required version of gradle installed, ignore this step.

Installing Gradle 8.x on MacOS using Homebrew (details) 

brew install gradle@8

Or using SDKMAN to install specific version: 

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install gradle 8.10.2

Installing Gradle 8.x on Ubuntu using SDKMAN (details)

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install gradle 8.10.2

Note: The apt package may not have Gradle 8.x, so SDKMAN is recommended for version control.

Installing Gradle 8.x on Amazon Linux using SDKMAN:

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install gradle 8.10.2

Installing Gradle 8.x on Windows using Chocolatey (details) 

choco install gradle --version=8.10.2

Or download Gradle 8.x directly from Gradle releases and add to PATH.

Troubleshoot: Confirm that gradle 8.x is correctly installed on your machine.

gradle --version

You should see output showing Gradle version 8.x. If you get gradle command not found error, you need to add gradle to your PATH or use the gradle wrapper (gradlew) which will be set up in the next step.

[Step 3] Build PObserve

  1. Clone the repository 

    git clone https://github.com/p-org/P.git

  2. Generate the gradle wrapper 

    cd P/Src/PObserve/PObserve
gradle wrapper

  3. Build the PObserve project:

    ./gradlew build

    gradlew.bat build

The build will create a standalone JAR file with all dependencies included in path: Src/PObserve/PObserve/build/libs/PObserve-1.0.0.jar

🎉 Voilà! You now have PObserve successfully built and ready to use! 🚀

Now that you have the PObserve JAR file, read the PObserve CLI Guide page to see how to use PObserve to monitor your system logs against P specifications. Happy monitoring! 📊✨