Ctrl K
ring2all.com

System Misc (System Settings) Module Documentation

Table of Contents

  1. Module Overview (Technical)
  2. Module Overview (Commercial/Business)
  3. Module Overview (End User/Administrator)
  4. Configuration Sections
  5. Settings Reference
  6. Common Scenarios & Examples
  7. Limitations & Important Notes
  8. Troubleshooting Tips
  9. Glossary

---

1. Module Overview (Technical)

What Is System Misc?

System Misc is a system configuration module that manages server-wide settings including timezone, NTP time synchronization, and resource monitoring with email alerts for storage and CPU thresholds.

Architecture

Plaintext
┌─────────────────────────────────────────────────────────────────┐
│              System Misc Architecture                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  System Configuration                                           │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        System Misc Settings                              │   │
│  │                                                          │   │
│  │  Time & NTP:                                             │   │
│  │  ├─ Timezone: America/New_York                          │   │
│  │  ├─ NTP Enabled: ✓                                      │   │
│  │  └─ NTP Servers: pool.ntp.org, time.google.com          │   │
│  │                                                          │   │
│  │  Storage Monitoring:                                     │   │
│  │  ├─ Root Partition: 85% threshold                       │   │
│  │  ├─ Var Partition: 90% threshold                        │   │
│  │  └─ Alert Email: admin@company.com                      │   │
│  │                                                          │   │
│  │  CPU Monitoring:                                         │   │
│  │  ├─ Threshold: 90%                                      │   │
│  │  └─ Alert Email: admin@company.com                      │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│       │                                                         │
│       ▼ Applied to server(s)                                   │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        Monitoring Service                                │   │
│  │                                                          │   │
│  │  ├─ Periodic resource checks                            │   │
│  │  ├─ Threshold comparisons                               │   │
│  │  └─ Email alerts when exceeded                          │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│       │                                                         │
│       ▼ Real-time display                                      │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        System Status Dashboard                           │   │
│  │                                                          │   │
│  │  NTP Status: Synced ✓                                   │   │
│  │  Root Storage: ████████░░ 78%                           │   │
│  │  Var Storage: ██████░░░░ 55%                            │   │
│  │  CPU Usage: ███░░░░░░░ 32%                              │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Key Tables

TablePurpose
public.system_settingsSystem configuration

Key Files

FileDescription
modules/systemMisc/Frontend module
---

2. Module Overview (Commercial/Business)

Business Value

System Misc provides proactive system management:

Without System MiscWith System Misc
Manual time syncAutomatic NTP
Unknown disk usageThreshold alerts
CPU spikes unnoticedProactive monitoring
After-the-fact issuesPreventive alerts

Use Cases

  1. Time Synchronization

- Consistent timestamps

- Accurate CDR records

  1. Storage Alerts

- Prevent disk full errors

- Proactive capacity planning

  1. CPU Monitoring

- Detect overload conditions

- Performance optimization

  1. Multi-Server Management

- Centralized configuration

- Consistent settings

Feature Highlights

FeatureBenefit
TimezoneConsistent time display
NTP ServersUp to 4 redundant sources
Storage MonitoringDisk usage alerts
CPU MonitoringLoad alerts
Email AlertsProactive notifications
Usage BarsVisual resource status
---

3. Module Overview (End User/Administrator)

What Can You Do?

  • Set system timezone
  • Configure NTP time synchronization
  • Set up to 4 NTP servers
  • Monitor storage usage
  • Monitor CPU usage
  • Configure threshold alerts
  • Receive email notifications

System Settings Interface

Plaintext
┌─────────────────────────────────────────────────────────────────┐
│              System Settings                                    │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Configure system timezone, NTP settings, and monitoring       │
│  notifications                                                  │
│                                                                 │
│  ──────────────────────────────────────────────────────────────│
│                                                                 │
│  System Status                                                  │
│                                                                 │
│  Current Time: 2025-01-16 14:30:45 EST                         │
│  NTP Status: ● Synced                                          │
│                                                                 │
│  Storage Usage:                                                 │
│  Root (/)   ████████░░░░░░░░ 52%  [Threshold: 85%]            │
│  Var (/var) █████████░░░░░░░ 58%  [Threshold: 90%]            │
│                                                                 │
│  CPU Usage:                                                     │
│  CPU         ███░░░░░░░░░░░░ 22%  [Threshold: 90%]            │
│                                                                 │
│  [🔄 Refresh]                                                   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Time & NTP Settings

Plaintext
┌─────────────────────────────────────────────────────────────────┐
│              Time & NTP                                         │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  System Timezone: [America/New_York ▼]                         │
│    Select the system time zone                                  │
│                                                                 │
│  Enable NTP: ✓                                                 │
│    Enables network time synchronization                         │
│                                                                 │
│  NTP Servers                                                    │
│                                                                 │
│  NTP Server 1: [pool.ntp.org               ]                   │
│  NTP Server 2: [time.google.com            ]                   │
│  NTP Server 3: [time.cloudflare.com        ]                   │
│  NTP Server 4: [time.windows.com           ]                   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Notifications & Monitoring

Plaintext
┌─────────────────────────────────────────────────────────────────┐
│              Notifications & Monitoring                         │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Storage Monitoring                                             │
│                                                                 │
│  Root Partition (/)                                             │
│  Enable Storage Monitoring: ✓                                  │
│  Storage Threshold: [85              ] %                       │
│  Notification Email: [admin@company.com       ]                │
│                                                                 │
│  Var Partition (/var)                                           │
│  Enable Storage Monitoring: ✓                                  │
│  Storage Threshold: [90              ] %                       │
│  Notification Email: [admin@company.com       ]                │
│                                                                 │
│  ──────────────────────────────────────────────────────────────│
│                                                                 │
│  CPU Monitoring                                                 │
│                                                                 │
│  Enable CPU Monitoring: ✓                                      │
│  CPU Threshold: [90              ] %                           │
│  Notification Email: [admin@company.com       ]                │
│                                                                 │
│  [Save] [Cancel]                                                │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Quick Tips

TIP
Multiple NTP: Use 2-4 servers for redundancy.
TIP
Threshold Balance: Not too low (alert fatigue), not too high (too late).
NOTE
Email Required: Must provide email when monitoring is enabled.

---

4. Configuration Sections

Time & NTP

FieldDescription
System TimezoneServer timezone
Enable NTPTime sync toggle
NTP Server 1-4Time sources

Storage Monitoring

FieldDescription
Enable MonitoringToggle monitoring
ThresholdAlert percentage
Notification EmailAlert recipient

CPU Monitoring

FieldDescription
Enable MonitoringToggle monitoring
ThresholdAlert percentage
Notification EmailAlert recipient
---

5. Settings Reference

ServerProvider
pool.ntp.orgNTP Pool Project
time.google.comGoogle
time.cloudflare.comCloudflare
time.windows.comMicrosoft
time.apple.comApple

Threshold Guidelines

ResourceRecommended
Root Storage80-85%
Var Storage85-90%
CPU85-95%

NTP Status Values

StatusMeaning
SyncedTime synchronized
Not SyncedSync failed
---

6. Common Scenarios & Examples

Scenario 1: Set Timezone

  1. Open System Settings
  2. Select timezone from dropdown
  3. Save
  4. All timestamps use new timezone

Scenario 2: Configure NTP

  1. Enable NTP toggle
  2. Enter primary NTP server
  3. Add 2-3 backup servers
  4. Save
  5. System syncs time automatically

Scenario 3: Storage Alerts

  1. Enable Storage Monitoring
  2. Set threshold = 85%
  3. Enter email address
  4. Save
  5. Receive alert when disk exceeds 85%

Scenario 4: CPU Alerts

  1. Enable CPU Monitoring
  2. Set threshold = 90%
  3. Enter email address
  4. Save
  5. Receive alert during high CPU

---

7. Limitations & Important Notes

Technical Notes

NOTE
Email Required: Monitoring requires valid email.
NOTE
NTP Redundancy: Use multiple servers.
WARNING
Timezone Change: Affects all timestamps.

Best Practices

  1. Multiple NTP: Use 2-4 servers
  2. Reasonable Thresholds: Avoid alert fatigue
  3. Valid Email: Ensure delivery
  4. Test Alerts: Verify notifications work
  5. Regular Review: Adjust thresholds as needed

Threshold Recommendations

ThresholdToo LowGoodToo High
Storage<70%80-90%>95%
CPU<70%85-95%99%
---

8. Troubleshooting Tips

Common Issues

SymptomPossible CauseSolution
Time not syncingNTP blockedCheck firewall
No alerts receivedWrong emailVerify email address
Constant alertsThreshold too lowIncrease threshold
NTP not syncedBad serverTry different NTP

Check NTP Status

Bash
# Check NTP sync
timedatectl status

# Query NTP server
ntpq -p

# Force sync
ntpdate -s pool.ntp.org

Check Storage

Bash
# Check disk usage
df -h

# Check specific mount
df -h /
df -h /var

Check CPU

Bash
# Real-time CPU
top

# Average load
uptime

# CPU info
cat /proc/cpuinfo | grep "model name"

---

9. Glossary

TermDefinition
NTPNetwork Time Protocol
TimezoneRegional time offset
ThresholdAlert trigger level
SyncTime synchronization
PartitionDisk section
---

Lua Script Status ℹ️

System Module

ComponentStatus
System Miscℹ️ System configuration - no Lua handler required
System Misc is a system configuration module. It manages server settings like timezone and monitoring. No Lua handlers are used - monitoring is handled by the backend service.

---

Documentation last updated: January 2026
AI Assistant

👋 Hello! I'm your Ring2All documentation assistant. I can help you find information about configuring and using the Ring2All PBX platform.

How can I help you today?