herolib/examples/installers/horus/README.md

Horus Installation Examples

This directory contains example scripts for installing and managing all Horus components using the herolib installer framework.

Components

The Horus ecosystem consists of the following components:

1. Coordinator - Central coordination service (HTTP: 8081, WS: 9653)
2. Supervisor - Supervision and monitoring service (HTTP: 8082, WS: 9654)
3. Hero Runner - Command execution runner for Hero jobs
4. Osiris Runner - Database-backed runner
5. SAL Runner - System Abstraction Layer runner

Quick Start

Full Installation and Start

To install and start all Horus components:

# 1. Install all components (this will take several minutes)
./horus_full_install.vsh

# 2. Start all services
./horus_start_all.vsh

# 3. Check status
./horus_status.vsh

Stop All Services

./horus_stop_all.vsh

Available Scripts

horus_full_install.vsh

Installs all Horus components:

• Checks and installs Redis if needed
• Checks and installs Rust if needed
• Clones the horus repository
• Builds all binaries from source

Note: This script can take 10-30 minutes depending on your system, as it compiles Rust code.

horus_start_all.vsh

Starts all Horus services in the correct order:

1. Coordinator
2. Supervisor
3. Hero Runner
4. Osiris Runner
5. SAL Runner

horus_stop_all.vsh

Stops all running Horus services in reverse order.

horus_status.vsh

Checks and displays the status of all Horus services.

Prerequisites

• Operating System: Linux or macOS
• Dependencies (automatically installed):
  • Redis (required for all components)
  • Rust toolchain (for building from source)
  • Git (for cloning repositories)

Configuration

All components use default configurations:

Coordinator

• Binary: /hero/var/bin/coordinator
• HTTP Port: 8081
• WebSocket Port: 9653
• Redis: 127.0.0.1:6379

Supervisor

• Binary: /hero/var/bin/supervisor
• HTTP Port: 8082
• WebSocket Port: 9654
• Redis: 127.0.0.1:6379

Runners

• Hero Runner: /hero/var/bin/herorunner
• Osiris Runner: /hero/var/bin/runner_osiris
• SAL Runner: /hero/var/bin/runner_sal

Custom Configuration

To customize the configuration, you can use heroscript:

import incubaid.herolib.installers.horus.coordinator

mut coordinator := herocoordinator.get(create: true)!
coordinator.http_port = 9000
coordinator.ws_port = 9001
coordinator.log_level = 'debug'
herocoordinator.set(coordinator)!
coordinator.install()!
coordinator.start()!

Testing

After starting the services, you can test them:

# Test Coordinator HTTP endpoint
curl http://127.0.0.1:8081

# Test Supervisor HTTP endpoint
curl http://127.0.0.1:8082

# Check running processes
pgrep -f coordinator
pgrep -f supervisor
pgrep -f herorunner
pgrep -f runner_osiris
pgrep -f runner_sal

Troubleshooting

Redis Not Running

If you get Redis connection errors:

# Check if Redis is running
redis-cli ping

# Start Redis (Ubuntu/Debian)
sudo systemctl start redis-server

# Start Redis (macOS with Homebrew)
brew services start redis

Build Failures

If the build fails:

1. Ensure you have enough disk space (at least 5GB free)
2. Check that Rust is properly installed: rustc --version
3. Try cleaning the build: cd /root/code/git.ourworld.tf/herocode/horus && cargo clean

Port Conflicts

If ports 8081 or 8082 are already in use, you can customize the ports in the configuration.

Advanced Usage

Individual Component Installation

You can install components individually:

# Install only coordinator
v run coordinator_only.vsh

# Install only supervisor
v run supervisor_only.vsh

Using with Heroscript

You can also use heroscript files for configuration:

!!herocoordinator.configure
    name:'production'
    http_port:8081
    ws_port:9653
    log_level:'info'

!!herocoordinator.install

!!herocoordinator.start

Service Management

Services are managed using the system's startup manager (zinit or systemd):

# Check service status with systemd
systemctl status coordinator

# View logs
journalctl -u coordinator -f

Cleanup

To completely remove all Horus components:

# Stop all services
./horus_stop_all.vsh

# Destroy all components (removes binaries)
v run horus_destroy_all.vsh

Support

For issues or questions:

• Check the main Horus repository: https://git.ourworld.tf/herocode/horus
• Review the installer code in lib/installers/horus/