Multi-Node Launcher is a solution for easily setting up and managing GPU nodes using Ansible. This guide provides step-by-step instructions to quickly configure your system and manage your GPU nodes.

• Overview
• Prerequisites
• Quick Setup
• Initial Setup
• Usage
• Troubleshooting
• Notes

Multi-Node Launcher automates the setup process for GPU nodes with Ansible. It ensures that required dependencies are installed and configuration is performed in a reliable, idempotent manner.

Before you start, ensure that you have met the following requirements:

1. Ansible installed on your control node
2. SSH access to target nodes
3. Sudo privileges on target nodes
4. NVIDIA GPU(s) on target nodes
5. Internet access for package downloads

You can quickly set up your GPU nodes by running the following one-liner:

curl -sL https://raw.githubusercontent.com/Ratio1/r1setup/refs/heads/main/install.sh -o install.sh && bash install.sh && rm install.sh

This command will:

• Create a temporary setup directory
• Download necessary scripts
• Execute prerequisite checks
• Perform Ansible setup and configuration

Before running the playbook, follow these steps:

1. Install required Ansible collections:

   ansible-galaxy collection install -r requirements.yml

2. Configure your hosts by editing the inventory/hosts.yml file.
3. If you need to track or bump the deployed edge_node.service template revision, edit group_vars/mnl.yml and set mnl_service_version.
4. r1setup stores the last applied service file version per node in its saved config; missing values are treated as v0.

1. Test connectivity to your nodes:

   ansible all -i inventory/hosts.yml -m ping

2. Execute the playbook:

   ansible-playbook -i inventory/hosts.yml playbooks/site.yml

If you encounter issues during setup or execution, consider the following:

• Verify that all prerequisites are met.
• Ensure that SSH keys and permissions are correctly configured.
• Consult the Ansible logs for detailed error messages.
• Search for known issues on the project's GitHub repository or open a new issue.

• The playbook is idempotent and can be run multiple times safely.
• Ensure adequate cooling and power for GPU operations.
• For macOS users: This setup uses Homebrew for package management. Ensure Homebrew is installed prior to running the setup.