Skip to content

Tutorial 1: First Steps with ChronoLog

Jump to bottom
Eneko Gonzalez edited this page Jan 28, 2025 · 7 revisions

Welcome to ChronoLog! We’re so excited to have you here. ChronoLog is a powerful open-source project, proudly funded by the NSF, that aims to make managing and processing log data simple, scalable, and high-performance. Whether you’re working with edge computing or high-performance computing (HPC) systems, ChronoLog has got your back. Let’s dive in and get you up and running in no time!

What is ChronoLog?

Imagine you have a flood of data coming at you from all directions: activities, events, logs — all the stuff you need to make sense of. ChronoLog steps in as your superhero, a distributed shared log store designed to:

  • Scale effortlessly to handle huge volumes of data.
  • Deliver blazing-fast performance.
  • Adapt to a wide variety of use cases.

From edge devices to massive HPC systems, ChronoLog ensures you have a reliable and efficient way to organize and analyze your data. Sounds cool, right? Let’s get you started with your very first ChronoLog setup!

Getting Started: Setting Up ChronoLog

We’ve made sure to keep the setup as straightforward as possible. Just follow these steps, and you’ll be ready to roll!

Step 1: Clone the Repository

First, let’s grab the ChronoLog repository. Open your terminal and run:

git clone https://github.com/grc-iit/ChronoLog.git

This will download the project to your local machine. Now you’ve got all the code you need!

Step 2: Install the Spack Package Manager

Spack is an awesome tool for managing software builds. To get Spack, run:

git clone --branch v0.21.2 https://github.com/spack/spack.git

Once it’s installed, you’re one step closer to launching ChronoLog.

Step 3: Move to the Deploy Folder

Navigate to the “deploy” folder inside the ChronoLog repository:

cd /path-to-repo/deploy

Replace /path-to-repo/ with the actual path to where you cloned the ChronoLog repository.

Step 4: Build the Project

It’s time to build ChronoLog. In the deploy folder, run:

./local_single_user_deploy.sh -b -t Debug

This will compile the project in Debug mode. Don’t worry if it takes a little while; ChronoLog is getting ready to do big things!

Step 5: Install the Project

Now, let’s install ChronoLog to your local machine. Run:

./local_single_user_deploy.sh -i -w /home/$USER/chronolog/Debug

This sets up ChronoLog in a local directory so you can use it.

Step 6: Deploy the Project

You’re almost there! To deploy ChronoLog, simply run:

./local_single_user_deploy.sh -d -w /home/$USER/chronolog/Debug

ChronoLog is now deployed and ready for action.

Step 7: Check the Installation

Let’s make sure everything is running smoothly. Use this command to verify:

pgrep -la chrono

If you see a process with the name “chrono,” congratulations! ChronoLog is successfully installed and deployed on your system. You’re ready to start exploring its capabilities.

What’s Next?

Now that you’ve set up ChronoLog, you’re all set to explore its powerful features. Keep an eye out for our next tutorial, where we’ll guide you through running your first ChronoLog application and uncovering the magic it can bring to your data workflows.

Welcome to the ChronoLog community — we can’t wait to see what you’ll build!

Clone this wiki locally