️ Commvault v11 — Enterprise Backup

If you like this project, consider supporting me on Buy Me a Coffee ☕️

tags:

• backups
• s3
• sysadmin

• linux

  Commvault v11 (Simpana) is a unified data management and protection platform for enterprise environments. It provides backup, recovery, archiving, and replication across physical, virtual, and cloud workloads. Commvault is widely used in large organizations for centralized backup management with a single CommServe console managing thousands of clients. / Commvault v11 (Simpana) — унифицированная платформа управления и защиты данных для корпоративных сред. Обеспечивает резервное копирование, восстановление, архивирование и репликацию для физической, виртуальной и облачной инфраструктуры.

[!NOTE] Commvault v11 (Simpana) is a legacy product. Current versions are branded Commvault Complete™ Backup & Recovery (v2024+). The CLI and architecture remain similar but the web UI has been significantly modernized.

Installation & Configuration

Default Ports

Core Registry Paths

/etc/CommVaultRegistry

cat /etc/CommVaultRegistry/Galaxy/Instance001/.properties  # View instance properties / Просмотреть свойства инстанса

System Tuning

/etc/sysctl.conf

# Recommended for MediaAgent
net.ipv4.ip_local_port_range = 1024 65535
fs.file-max = 655360

Core Management

CLI Login

/opt/commvault/Base

./qlogin -cs <HOST> -u <USER>  # Basic login / Базовый вход
# Password will be prompted

Resource Listing

./qlist client  # List all clients / Список всех клиентов
./qlist mediaagent  # List all MediaAgents / Список всех MediaAgent
./qlist job -c <HOST>  # List active jobs for client / Список активных заданий клиента

Job Control

./qoperation job_control -j <JOB_ID> -o suspend  # Suspend job / Приостановить задание
./qoperation job_control -j <JOB_ID> -o resume   # Resume job / Возобновить задание
./qoperation job_control -j <JOB_ID> -o kill     # Kill job / Убить задание

[!CAUTION] Killing a backup job may leave partial data or snapshots. Use only if job is hung. / Принудительное завершение задания может оставить частичные данные или снапшоты. Используйте только если задание зависло.

Sysadmin Operations

Service Control

commvault status   # Check overall status / Проверить общий статус
commvault stop     # Stop all services / Остановить все сервисы
commvault start    # Start all services / Запустить все сервисы
commvault restart  # Restart services / Перезапустить сервисы

Log Locations

/var/log/commvault/Log_Files (Simpana 11)

tail -f CVD.log        # Core service logs / Логи основного сервиса
tail -f EvMgrC.log     # Event manager logs / Логи менеджера событий
tail -f install.log    # Installation diagnostics / Диагностика установки

Infrastructure Components

Security & Auth

Certificate Management

./qoperation qreinit_cert -c <HOST>  # Reinitialize certificate / Переинициализировать сертификат

User Permissions

./qlist usergroup  # View user groups / Просмотреть группы пользователей

Performance Tuning

Data Streams Configuration

To increase backup speed, you can configure the number of parallel connections (streams). / Для увеличения скорости бэкапа можно настроить количество параллельных соединений (потоков).

Via Command Center (Web UI):

1. Navigate to Manage > Servers > [Server Name].
2. Click on the Subclient (e.g., default).
3. Under Settings, find Number of Data Streams.
4. Increase the value (Default is 1, recommended 4-8 for high-speed disks).

Via CommCell Console (Java GUI):

1. Client Computers > [Client Name] > [Agent Name] > [Backup Set].
2. Right-click Subclient > Properties.
3. Storage Device tab > Data Transfer Option sub-tab.
4. Set Max Number of Data Pipes / Number of Data Readers.

Registry Tuning (Linux/Windows)

/etc/CommVaultRegistry/Galaxy/Instance001/.properties

# Increase parallel transfer limit on Agent
nMaxParallelTransfers 8  # Set to desired number / Установите желаемое число

[!TIP] Number of Data Readers should not exceed the number of CPU cores or available network bandwidth. / Количество читателей данных не должно превышать количество ядер CPU или доступную пропускную способность сети.

Low Impact Backups

To minimize impact on production workloads during business hours. / Для минимизации влияния на рабочие нагрузки в рабочее время.

Network Throttling / Ограничение сетевого трафика:

1. Command Center: Manage > Servers > [Server] > Configuration > Network Throttling.
2. Enable throttling and set the limit (e.g., 500 Mbps) and schedule. / Включите ограничение и установите лимит (например, 500 Мбит/с) и расписание.

CPU Priority / Приоритет CPU:

1. Console: Right-click Client > Properties > Advanced.
2. Job Configuration tab > CPU Priority.
3. Set to Below Normal or Low. / Установите значение Below Normal или Low.

Operation Windows / Окна выполнения операций:

1. Right-click CommServe/Client > All Tasks > Operation Window.
2. Click Add to define a "Blackout Window" (e.g., Mon-Fri 09:00-18:00). / Нажмите Add, чтобы определить окно запрета операций (например, Пн-Пт 09:00-18:00).
3. Select operations to ignore (e.g., Full Backups). / Выберите операции, которые следует игнорировать (например, Full Backups).

Database Protection

MongoDB Protection

Commvault supports both traditional and IntelliSnap (hardware-based) backups for MongoDB. / Commvault поддерживает как традиционное, так и аппаратное (IntelliSnap) резервное копирование для MongoDB.

Agent Configuration / Конфигурация агента:

1. Linux Client: Requires mongosh or mongo shell in PATH. / Клиент Linux: Требует mongosh или mongo shell в PATH.
2. Permissions: Create a backup user in MongoDB admin database.

   db.createUser({ user: "<USER>", pwd: "<PASSWORD>", roles: ["backup", "clusterMonitor"] })

Physical vs Logical Backup / Физический и логический бэкап:

Manual Backup Trigger / Ручной запуск бэкапа: /opt/commvault/Base

./qoperation backup -c <HOST> -a "BigData Apps" -i "MongoDB" -t FULL  # Trigger Full / Запустить полный бэкап

MySQL & PostgreSQL

1. Binaries: Specify paths to mysqldump or pg_dump in subclient properties. / Бинарные файлы: Укажите пути к mysqldump или pg_dump в свойствах subclient.
2. Staging: Commvault creates a temporary dump in the configured staging directory. / Стейджинг: Commvault создает временный дамп в настроенном каталоге стейджинга.

Service Accounts / Сервисные учетные записи:

# Verify mysql access
mysql -u <USER> -p<PASSWORD> -e "SHOW DATABASES;"

[!IMPORTANT] PostgreSQL: Ensure the postgres user group has read access to the data directory for physical backups. / PostgreSQL: Убедитесь, что группа пользователей postgres имеет доступ на чтение к каталогу данных для физических бэкапов.

Backup & Restore

Backup Types Comparison

Production Runbook: Agent Deployment

1. Preparation: Verify ports 8400 and 8403 are open in firewall. / Подготовка: Проверьте доступность портов 8400 и 8403.
2. Binary Transfer: Copy CVPkgSmg to <HOST>. / Перенос: Скопируйте CVPkgSmg на <HOST>.
3. Silent Install:

   ./cvpkgadd -isC1 -instance Instance001 -client <HOST> -cs <COMM_SERVE_IP>

4. Verification: Check status.

   commvault status

Troubleshooting

Diagnostic Tools

/opt/commvault/Base/cvcheck -all  # Comprehensive health check / Комплексная проверка здоровья

Network Connectivity

./CvPing <CS_HOST> -p 8400  # Internal ping tool / Внутренняя утилита пинга

[!WARNING] High CPU/Memory usage by MediaAgent is normal during deduplication. / Высокое потребление CPU/RAM на MediaAgent — это нормально во время дедупликации.

Additional Notes

Log Rotation

Commvault manages its own log rotation inside /var/log/commvault/Log_Files. If you need to use system logrotate:

/etc/logrotate.d/commvault

/var/log/commvault/Log_Files/*.log {
    daily
    rotate 7
    compress
    delaycompress
    missingok
    notifempty
    create 640 root root
}

Documentation

• Commvault Documentation: https://documentation.commvault.com/