# Quantum Run (QRun) - Test Orchestration Agent

Last updated on : 21 Jan 2025

## Overview

QuantumRun(QRun) is your go-to intelligent testing platform that transforms traditional test execution into high-performance, scalable operations. This guide will walk you through creating your first project and running jobs.

Download Sample Project Here.

## Creating Your First Project

### Step 1: Access the QuantumRun Page

- Navigate to the QuantumRun page from your Pcloudy dashboard
- Click on Create Project to begin

### Step 2: Enter Project Details

Configure your new project with the following information:

- Project Name: Choose a descriptive name for your testing project
- Project Description: Add details about the project's purpose and scope

## Configuring Your Job

### Job Setup

Once your project is created, configure your testing job:

- Job Name: Enter a clear, identifiable name for your job
- Job Description: Provide details about what this job will test
- Automation Tool: Select your preferred automation tool from the available options
- Language: Choose the programming language for your tests
- Testing Framework: Select the testing framework that matches your setup

### Configuration File Upload

Upload your configuration package:

- Prepare a ZIP file containing your configuration files
- The ZIP should include all necessary setup and configuration details
- Upload the file through the interface
- Enter any additional configuration details as prompted

### Project Management

After configuration:

- Your project details will be automatically updated in the project list
- Projects can be deleted if no longer needed.

## Running Your Job

### Starting a Test Run

- Locate your created job in the project list
- Click the Run button to initiate execution
- Monitor the run status to track progress

## Real-time Monitoring

### Once your run starts:

- Track execution progress in real-time
- Monitor resource allocation and task distribution
- View status updates as tests execute

### Understanding the Run Page

### Job Overview

The Jobs page serves as your central hub for all test executions:

- All tests executed on Quantum Run appear as individual Jobs
- Each run is assigned a unique Run ID for tracking
- Status indicators show current execution state

### Task Management

The left sidebar displays:

- All Tasks that are part of your current job
- Just-in-time testing environments created for execution
- Resource allocation and distribution details

## Test Details Section

### Comprehensive Test Information

Access detailed insights for your test executions:

Run Metadata:

- Project Name: The parent project containing this job
- Job Name: The specific job being executed
- Run ID: Unique identifier for this execution
- User: Who initiated the test run
- Total Duration: Complete execution time

Log Management

- Download aggregated logs: Access comprehensive execution logs

## Limitations

Supported Programming Languages - Java and Python

## Key Features

### Dynamic Scaling

- Handle anywhere from 10 to 10,000 tests seamlessly
- Automatic resource optimization based on demand
- No infrastructure constraints or bottlenecks
### Intelligent Orchestration

- Advanced task distribution across available resources
- Elimination of network latency through smart scheduling
- Optimal resource usage for maximum efficiency