Skip to content

Infrastructure Menu

1. Root Servers

Main server configuration for SSH access, command execution, monitoring, and code server management.

Connection Fields

  1. Server Name - Display name for the server (required, tracked)
  2. Server IP - IP address (required, tracked)
  3. SSH Username - Login user (required, default: root, tracked)
  4. SSH Port - SSH connection port (required, default: 22, tracked)
  5. Password - SSH password (used if no private key)
  6. Private Key - RSA private key for SSH authentication
  7. Sudo - Whether to prepend sudo to commands (for non-root users, tracked)
  8. Country - Server physical location country
  9. State - Server physical location state/province
  10. UUID - Auto-generated unique server identifier (readonly)
  11. Active - Soft delete flag (default: True)

Server State

Draft → Confirmed → Cancelled
State Description
Draft Initial setup, all fields editable
Confirmed SSH connection validated, server ready for use
Cancelled Server disabled
Action Description
Confirm Validate SSH connection and mark as ready
Reset to Draft Return to editable state
Cancel Disable the server (stops monitoring if active)

Command Execution

  1. Command - Text box for the command to run via SSH
  2. Execute Command - Button to run the command
  3. Command Output - Result of the executed command

Action Log

Every executed command is logged for audit purposes.

  1. Model Name - Source model (readonly)
  2. Record ID - Source record (readonly)
  3. Input Text - Command sent (readonly)
  4. Output Text - Result received (readonly)
  5. Action Type - Category: none, root_server_ssh, root_server_dir_init

Monitoring

Real-time server health monitoring with configurable intervals.

  1. Monitoring Enabled - Whether monitoring is active (tracked)
  2. Monitor Update Interval - Data collection frequency: 10s, 60s, or 120s
  3. Monitor From Date - Monitoring period start filter
  4. Monitor To Date - Monitoring period end filter
  5. Monitor Data - Current monitoring snapshot

Monitored Metrics:

Metric Description
CPU Usage CPU utilization percentage
RAM Total / Used / % Memory usage in GB and percentage
Disk Total / Used / % Disk space in GB and percentage
Network RX / TX Network bytes received and transmitted
Load Average 1-min, 5-min, and 15-min load averages

Derived Server State (computed from monitoring data):

State Description
No Monitor Monitoring not enabled
Online Server responding normally
Warning Elevated resource usage
Down Server not responding
Action Description
Start Monitoring Install monitoring cron script on the remote server
Stop Monitoring Remove monitoring from the server

Log Retention

Monitoring logs are automatically cleaned up after the configured retention period (default: 2 days). This is configurable in Settings > Keep Root Server Log Period.

Code Server (VS Code)

Browser-based VS Code editor for remote file browsing and editing.

  1. Code Server Domain - Access URL (HTTPS recommended, tracked)
  2. Code Server Password - Authentication password
  3. Code Server Port - Internal port (default: 8080)
  4. Code Server State - Draft, Running, or Stopped
Action Description
Install Code Server Install VS Code Server on the remote server
Remove Code Server Uninstall VS Code Server
Change Password Update the code server password
Open Code Server Open the editor in browser

Directory Setup

  1. Directory Init Done - Whether the Odoo directory structure has been initialized (tracked)
Action Description
Setup Directory Structure Initialize the required Odoo directory structure on the server

2. Root Servers Dashboard

Real-time dashboard showing all confirmed servers with their current monitoring status (CPU, RAM, Disk, Network, Load Average).