---
title: "System Misc (System Settings) Module Documentation"
description: "Documentation for System Misc"
---

## Table of Contents
1. [Navigation & Access](#navigation--access)
2. [Screenshots & Visual Interface](#screenshots--visual-interface)
3. [🎯 User Roles & Key Capabilities](#-user-roles--key-capabilities)
4. [Module Overview (Technical)](#1-module-overview-technical)
5. [Module Overview (Commercial/Business)](#2-module-overview-commercialbusiness)
6. [Module Overview (End User/Administrator)](#3-module-overview-end-useradministrator)
7. [Configuration Sections](#4-configuration-sections)
8. [Settings Reference](#5-settings-reference)
9. [Common Scenarios & Examples](#6-common-scenarios--examples)
10. [Model Context Protocol (MCP) AI Integration](#model-context-protocol-mcp-ai-integration)
11. [Limitations & Important Notes](#7-limitations--important-notes)
12. [Troubleshooting Tips](#8-troubleshooting-tips)
13. [Glossary](#9-glossary)
---

## Navigation & Access

To access the System Misc configuration module:
1. Log in to the Ring2All Web Portal (`https://<domain-or-ip>/login`).
2. In the left navigation sidebar, expand **Admin**.
3. Under **System Settings**, click **System Misc** (`/admin/system-settings/misc`).
4. To configure a new server misc profile, click the **+ Add Configuration** button.
5. To view or edit an existing system configuration, click on the server entry or action controls (`/admin/system-settings/system-misc/:id`).

---

## Screenshots & Visual Interface

### System Misc Configurations List View
The System Misc dashboard displays server-level operational settings across all telephony nodes, showing server names, active timezones, NTP synchronization pools, logging levels, retention horizons, and alert channels.
![System Misc List](/screenshots/admin/system/system-misc-list.png)

### System Misc Configuration Form
The system configuration form manages system-wide time synchronization, log verbosity thresholds, automated backup schedules, Slack/Email alert webhooks, and emergency maintenance mode toggles.
![System Misc Configuration Form](/screenshots/admin/system/system-misc-form.png)

---

## 🎯 User Roles & Key Capabilities

The System Misc module governs platform-wide operating environment variables and physical host constraints:

| Role | Key Capabilities & Operational Scope |
|------|--------------------------------------|
| **Super Administrator / System Architect** | Sets the master server timezone, defines upstream NTP reference servers, adjusts system log levels, and triggers emergency maintenance mode. |
| **Site Reliability Engineer (SRE) / DevOps** | Configures disk storage utilization thresholds (root `/` and `/var`), defines CPU usage alert boundaries, and tests notification webhooks. |
| **VoIP / PBX Systems Administrator** | Verifies timezone consistency across CDR rating engines, billing schedulers, and time condition evaluation routines. |
| **Telephony Auditor (Read-Only)** | Audits NTP time synchronization status, threshold alert configurations, and system logging verbosity settings. |

---

## 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

```
┌─────────────────────────────────────────────────────────────────┐
│              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%                              │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

---

## 2. Module Overview (Commercial/Business)

### Business Value

System Misc provides **proactive system management**:

| Without System Misc | With System Misc |
|---------------------|-----------------|
| Manual time sync | Automatic NTP |
| Unknown disk usage | Threshold alerts |
| CPU spikes unnoticed | Proactive monitoring |
| After-the-fact issues | Preventive alerts |

### Use Cases

1. **Time Synchronization**
   - Consistent timestamps
   - Accurate CDR records

2. **Storage Alerts**
   - Prevent disk full errors
   - Proactive capacity planning

3. **CPU Monitoring**
   - Detect overload conditions
   - Performance optimization

4. **Multi-Server Management**
   - Centralized configuration
   - Consistent settings

### Feature Highlights

| Feature | Benefit |
|---------|---------|
| **Timezone** | Consistent time display |
| **NTP Servers** | Up to 4 redundant sources |
| **Storage Monitoring** | Disk usage alerts |
| **CPU Monitoring** | Load alerts |
| **Email Alerts** | Proactive notifications |
| **Usage Bars** | Visual 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

```
┌─────────────────────────────────────────────────────────────────┐
│              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

```
┌─────────────────────────────────────────────────────────────────┐
│              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

```
┌─────────────────────────────────────────────────────────────────┐
│              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

| Field | Description |
|-------|-------------|
| **System Timezone** | Server timezone |
| **Enable NTP** | Time sync toggle |
| **NTP Server 1-4** | Time sources |

### Storage Monitoring

| Field | Description |
|-------|-------------|
| **Enable Monitoring** | Toggle monitoring |
| **Threshold** | Alert percentage |
| **Notification Email** | Alert recipient |

### CPU Monitoring

| Field | Description |
|-------|-------------|
| **Enable Monitoring** | Toggle monitoring |
| **Threshold** | Alert percentage |
| **Notification Email** | Alert recipient |

---

## 5. Settings Reference

### Recommended NTP Servers

| Server | Provider |
|--------|----------|
| pool.ntp.org | NTP Pool Project |
| time.google.com | Google |
| time.cloudflare.com | Cloudflare |
| time.windows.com | Microsoft |
| time.apple.com | Apple |

### Threshold Guidelines

| Resource | Recommended |
|----------|-------------|
| **Root Storage** | 80-85% |
| **Var Storage** | 85-90% |
| **CPU** | 85-95% |

### NTP Status Values

| Status | Meaning |
|--------|---------|
| **Synced** | Time synchronized |
| **Not Synced** | Sync 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

---

## Model Context Protocol (MCP) AI Integration

The Ring2All PBX platform provides Model Context Protocol (MCP) tools for inspecting server-wide miscellaneous configuration settings and monitoring thresholds.

### MCP Tools Reference

| Tool Name | Operation | Description | Risk Level |
|-----------|-----------|-------------|------------|
| `get_system_misc_settings` | Read | Retrieves server timezone, NTP synchronization servers, log levels, and maintenance mode status. | Low |

### JSON Schema Definitions

#### `get_system_misc_settings`
```json
{
  "name": "get_system_misc_settings",
  "description": "Retrieves global system configuration including server timezone, NTP synchronization servers, log levels, and maintenance mode status.",
  "parameters": {
    "type": "object",
    "properties": {}
  }
}
```

### Natural Language Prompt Examples

#### English
- *"What is the active timezone configured for the PBX operating system?"*
- *"Check the list of NTP servers used for clock synchronization."*
- *"Is the PBX system currently in maintenance mode?"*

#### Spanish
- *"¿Cuál es la zona horaria activa configurada en el sistema?"*
- *"Consulta los servidores NTP configurados para la sincronización horaria."*
- *"Verifica si el sistema PBX tiene activo el modo de mantenimiento."*

### Enterprise Safeguards & Guardrails
1. **Clock Drift Prevention**: Read-only inspection prevents unintentional disruption to CDR billing timestamps and Time Condition schedules.
2. **Graceful Fallback**: If custom database parameters are not present, the tool safely falls back to standard operating system environment defaults.

---

## 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

| Threshold | Too Low | Good | Too High |
|-----------|---------|------|----------|
| Storage | <70% | 80-90% | >95% |
| CPU | <70% | 85-95% | 99% |

---

## 8. Troubleshooting Tips

### Common Issues

| Symptom | Possible Cause | Solution |
|---------|---------------|----------|
| Time not syncing | NTP blocked | Check firewall |
| No alerts received | Wrong email | Verify email address |
| Constant alerts | Threshold too low | Increase threshold |
| NTP not synced | Bad server | Try 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

| Term | Definition |
|------|------------|
| **NTP** | Network Time Protocol |
| **Timezone** | Regional time offset |
| **Threshold** | Alert trigger level |
| **Sync** | Time synchronization |
| **Partition** | Disk section |

---

*Documentation last updated: January 2026*