Описание

Начиная с версии ПО 1.30.2 для устройств WLC-15, WLC-30, WLC-3200, появилась возможность переноса журналов show wlc journal clients/ap/wids на внешний диск.

Данный функционал позволяет:

Увеличить объем информации, которая может хранится в журналах
Существенно увеличить скорость чтения/записи, в случае использования SSD

Перенос (миграция) журналов происходит только c внутренней flash-памяти устройства на внешний диск.

Перенос журналов с внешнего диска на flash не поддерживается, в связи с тем, что в определенных ситуациях размер журналов может превышать размер flash-памяти на устройстве.

Требования к внешнему диску

Требования:

Интерфейс подключения: SATA-3
Формат диска: 2.5
Минимальный рекомендуемый размер диска: 128 ГБ
Файловая система: ext4

Рекомендуется использовать SSD-диск вместо HDD в связи с большей производительностью.

Первичное подключение диска

При первичном подключение нового диска он не размечен, поэтому, он не будет отображаться в выводах команды show storage-device hdd.
Устройства WLC-15, WLC-30, WLC-3200 имеют только 1 слот для диска, поэтому при форматировании диска средствами устройства, используя команду clear storage device, <SLOT_NUMBER> всегда равен 1.

Подключить диск к устройству в разъем для установки диска. Проверить, что загорелся зеленый индикатор. Подробная информация представлена в разделе "Описание изделий".

Форматировать диск средствами устройства, используя команду clear storage device hdd-dev://1 <hdd_name>.

wlc-30# clear storage-device hdd-dev://1 MYDISK
Formatting will erase all data on this device
Do you really want to continue? (y/N): y
mke2fs 1.43.1 (08-Jun-2016)
Device clear success.

Выполнить команду show storage-device hdd и убедиться, что диск успешно отформатирован и корректно определяется устройством.

wlc-30# show storage-devices hdd 
Name                             Filesystem   Total, MB    Used, MB     Free, MB     
------------------------------   ----------   ----------   ----------   ----------   
MYDISK                           ext4         234601.75    60.02        234541.72

Перенос журналов с Flash на Disk

Зайти в конфигурационный режим устройства, выполнить настройки wlc-jounral storage hdd://<hdd_name>:/<dir> и выполнить команды commit и confirm.

- <hdd_name> – имя внешнего диска.
- <dir> – директория, в которую будут перенесены журналы.

Пример конфигурации переноса журналов на SSD "MYDISK" в директорию SSD-JOURNAL

wlc# 
wlc# configure 
wlc(config)# wlc-journal storage hdd://MYDISK:/SSD-JOURNAL
wlc(config)# do commit 
2025-02-19T15:05:50+07:00 %SYS-W-EVENT: WARNING!!! the database will be moving to SATA storage device after reboot hardware
Configuration has been successfully applied and saved to flash. Commit timer started, changes will be reverted in 600 seconds.
2025-02-19T15:05:53+07:00 %CLI-I-CRIT: user techsupport from console  input: do commit
wlc(config)# do confirm
Configuration has been confirmed. Commit timer canceled.

Директория для хранения журналов, создается автоматически после выполнения команды commit, при условии, что она отсутствует на диске. В случае, если директория с данным для журналов уже существует, то после перезагрузки будет использоваться она.
Вложенные директории не поддерживаются. Только один уровень вложенности.

2. Проверить, что директория успешно создана командой dir.

Проверка создания директории на внешнем диске

wlc# dir hdd://MYDISK:/
Name                                                         Type         Size            Last modified               
----------------------------------------------------------   ----------   --------   --   -------------------------     
SSD-JOURNAL                                                  Directory    0.00       B    Wed Feb 19 15:05:50 2025

3. Перезагрузить устройство командой reload system.

Пезагрузка устойства

wlc-30# reload system

4. Проверить выводы команд show wlc journal ap/clients/wids и убедиться, что данные журналов успешно перенесены c flash-памяти устройства.

wlc# show wlc journal clients
wlc# show wlc journal ap
wlc# show wlc journal wids

После переноса на disk данные журналов, которые были на flash удаляются.

Переключение с Disk на Flash

Зайти в конфигурационный режим устройства, выполнить настройки wlc-jounral storage flash:wlc_database, выполнить команды commit и confirm и перезагрузить устройство командой reload system.
```
wlc-30-failover# configure 
wlc-30-failover(config)# wlc-journal storage flash:wlc_database 
wlc-30-failover(config)# do commit 
2025-02-20T16:58:13+07:00 %SYS-W-EVENT: WARNING!!! the database will be placed on the FLASH after reboot hardware
Configuration has been successfully applied and saved to flash. Commit timer started, changes will be reverted in 600 seconds.
2025-02-20T16:58:17+07:00 %CLI-I-CRIT: user techsupport from console  input: do commit
wlc-30-failover(config)# 
```
После перезагрузки устройства на flash будет создана директория для хранения журналов, в случае если она отсутствует. Данные в журналах будут отсутствовать.
В случае, если директория с данными для журналов уже присутствует на flash-памяти устройства, то после перезагрузки устройства она будет использоваться.
Проверить выводы команд show wlc journal ap/clients/wids.

Корректное извлечение диска

Не рекомендуется отключать диск на "Горячую" без использования команды unmount storage-device, если в текущем состояние устройство использует диск для хранения данных журналов.

Для того чтобы корректно извлечь внешний диск из устройства, необходимо использовать команду unmount storage-device.

Пример команды unmount

wlc# unmount storage-device hdd-dev://1

В случае, если устройство использует внешний диск для хранения журналов (выполнены шаги из подраздела "Перенос журналов с Flash на Disk"), команда unmount storage-device не выполнится.

Для выполнения команды unmount storage-device в данном случае, необходимо выполнить следующие шаги:

Переключить хранение журналов с disk на flash, выполнить команды commit и confirm, перезагрузить устройство командой reload system.

wlc# configure
wlc(config)# wlc-journal storage flash:wlc_database
wlc(config)# do commit 
2025-02-20T10:13:33+07:00 %SYS-W-EVENT: WARNING!!! the database will be placed on the FLASH after reboot hardware
wlc(config)# 
wlc(config)# do confirm 
Configuration has been confirmed. Commit timer canceled
wlc# reload system 
Do you really want to reload system now? (y/N): y

Выполнить команду unmount storage-device.

wlc# unmount storage-device hdd://MYDISK1
2025-02-20T11:59:36+07:00 %FILE_MGR-I-INFO: operation started: 'unmout storage-device hdd://MYDISK1' (index: 1, origin: CLI)
Device unmount
Do you really want to continue? (y/N): y
2025-02-20T11:59:51+07:00 %HDD-I-CHANGE: 'MYDISK1' has been removed!
2025-02-20T11:59:52+07:00 %FILE_MGR-I-INFO: operation is finished: 'unmout storage-device hdd://MYDISK1' (index: 1, origin: CLI)
Device unmount success.

Извлечь диск из устройства.

Форматирование диска средствами устройства

Для того чтобы форматировать диск, необходимо выполнить команду clear storage-device.

После форматирование диск будет с одним разделом, имя которого задал пользователь и файловой системой ext4.

Пример использования команды clear storage-device

wlc# clear storage-device hdd-dev://1 MYDISK2

В случае, если устройство, использует внешний диск для хранения журналов (выполнены шаги из подраздела "Перенос журналов с Flash на Disk"), форматировать диск командой clear storage-device не получится.

Для выполнения команды clear storage-device в данном случае, необходимо выполнить шаги: