Skip to main content
Version: v2510

Advanced Setup

This page explains complex configuration methods for AIBooster in on-premise environments.

Choosing a Configuration Pattern​

ConfigurationFeaturesRecommended Use
Single NodeComplete on one machineValidation, learning, small PoC
Multi NodeDistributed across multiple machinesProduction operation, large-scale clusters

Single Node Configuration​

A configuration where both AIBooster Server and Agent run on a single machine.

Pattern 1: Minimal Configuration for Validation​

single-node-1

Install both AIBooster Server and AIBooster Agent on a single workstation or server equipped with GPU. Connect a monitor and open the dashboard locally to check performance information. This is the shortest route when you "just want to get it running" on offline validation machines or benchmark machines. No network configuration is required.

Pattern 2: Multi-User Configuration​

single-node-2

Install both AIBooster Server and AIBooster Agent on a single workstation or server equipped with GPU. Users view the dashboard provided by the server from their personal PCs through a browser via TCP port 3000. Ideal for small PoCs where multiple people want to view the dashboard.

Multi Node Configuration​

A configuration for production operation where AIBooster Server and Agents are distributed across multiple machines.

multi-node-1

Install AIBooster Server on the management node, and install AIBooster Agent on each GPU compute node. Users view the dashboard provided by the management node from their personal PCs through a browser via TCP port 3000. This is the recommended configuration for many GPU cluster server systems.

Pattern 2: Co-located with Compute Node​

multi-node-2

If there is no dedicated management node, select one GPU-equipped node and install both AIBooster Server and its dedicated AIBooster Agent there. Install only the Agent on the remaining GPU-equipped nodes. Users view the dashboard provided by the GPU-equipped node with AIBooster Server installed from their personal PCs through a browser via TCP port 3000.

Network, SSH, and Permission Requirements​

SSH Connection Requirements​

  • Network access must be available via SSH
  • SSH ports on each node must be open

User and Permission Requirements​

  • Must be able to log in with the same username on all nodes
  • The login user must have privileges to escalate to administrator (sudo privileges)
  • Sudo password must be set to the same value on all nodes

The installer connects to all nodes via SSH with the current username, so the same username and sudo password are required on all nodes.

Setup Procedure​

1. Run the Installer​

Copy and execute the following command in your terminal:

curl -LO assets.aibooster.fixstars.com/faibup.sh && sh faibup.sh

Setup is completed by answering configuration questions in the terminal.

2-a. Single Node Setup​

The installer will ask the following questions, please answer:

faibup-single

  1. Target node address: Enter the target node's IP address or resolvable hostname
  2. Target node SSH port: Enter the target node's SSH port

2-b. Multi Node Setup​

The installer will ask the following questions in order, please answer:

faibup-multi

Note that steps 3-4 will be repeated.

  1. Server node address: Enter the IP address or resolvable hostname of the node running AIBooster Server

  2. Server node SSH port: Enter the SSH port of the node running AIBooster Server

  3. Agent node address: Enter the address of the compute node where you want to install AIBooster Agent

  4. Agent node SSH port: Enter the SSH port of the Agent node

  5. After entering all, press Enter with an empty line to confirm

3. Enter Authentication Information​

During installation, you need to enter the following information for SSH connection and sudo privilege acquisition:

  • SSH password (required even if public key authentication is configured, for sudo privilege escalation)
  • sudo password (must be set to the same value on all nodes)

4. Installation Complete​

When "AIBooster setup completed successfully!" is displayed, setup has completed normally.

Open the URL shown at the end in your browser and confirm that the dashboard is displayed. The URL for accessing AIBooster documentation is also displayed at the same time.

Dashboard Initial Configuration​

Grafana First Login​

AIBooster uses Grafana for performance data visualization. When accessing the dashboard from a browser for the first time, the following screen will be displayed:

Grafana-login

Password Configuration​

  1. Enter admin as both username and initial password
  2. When prompted to change the administrator password, enter any password

Configuration Complete Confirmation​

When the following screen is displayed, the initial dashboard configuration is complete:

Grafana-top