![[MC-04 logo]](/mc-04/chrome/site/logo.png){kind=logo}
#727 closed улучшение (готово)
Дополнить описание таблицы состояния регенераторов
| Reported by: | san | Owned by: | Vladimir |
|---|---|---|---|
| Priority: | major | Component: | Руководство по эксплуатации |
| Keywords: | Cc: | alx |
Description
Считаю, что в п.5.2.13 не достаточно понятно описана таблица Состояние регенераторов. Предлагаю заменить процитированный фрагмент текста со стр.35 (РЭ-42)
При нажатии кнопки Опрос происходит считывание состояния интерфейсов DSL на дальнем конце линии и отображение состояния в таблице Состояние регенераторов.
текст для замены:
Таблица Состояние регенераторов предназначена для отображения состояния устройств DSL тракта. В первой строке таблице отображается состояние DSL интерфейсов платы SM, окно конфигурации которой вы открыли (обновление параметров состояния интерфейсов происходит автоматически).
При нажатии кнопки Опрос в таблице последовательно отобразятся все устройства DSL-тракта, доступные в данный момент через встроенный канал связи, в следующем порядке:
- ближняя плата SM (первая строка)
- линейные регенераторы (пронумерованные от ближнего к дальнему R1,R2...)
- дальняя плата SM или модем MC04-DSL 1U/2U.
Состояние или наличие устройств тракта, кроме ближней платы SM, обновляется только после нажатия кнопки Опрос. Всего в таблицу помещается до 16-ти устройств тракта DSL.
Плата SM или модем имеют два DSL интерфейса(A и B), регенератор имеет четыре DSL интерфейса: два входных(A1, B1) и два выходных(A2, B2).
p.s. В тексте я упоминаю термин "плата SM", предполагая что он введён ранее.
Change History (14)
follow-up: 2 comment:1 by , 4 years ago
follow-up: 3 comment:2 by , 4 years ago
Replying to alx:
Replying to san:
Состояние или наличие устройств тракта, кроме ближней платы SM, обновляется только после нажатия кнопки Опрос.
Это не совсем точно. Как следует из более раннего обсуждения, при мониторинге системами мониторинга опрос следует инициировать программно (то есть автоматически, без участия человека, записью команд 1/2 в переменную .8.0 платы SM-01/SM-02), например snmpset'ом из cron'а. Поэтому предлагаю написать примерно так:
Обновление информации о состоянии и/или наличии устройств тракта (кроме ближней платы SM-01/SM-02) инициируется записью команды 1 (для пары A) или 2 (для пары B) в регистр команд .8.0 платы SM-01/SM-02 или нажатием кнопки "Опрос" в веб-интерфейсе.
Здесь для полноты картины надо добавить рекомендации не писать команду слишком часто (рекомендовать, например, раз в 5 минут) и рекомендацию не нажимать кнопку "Опрос" в веб-интерфейсе, если опрос выполняется автоматически.
Тогда текст для замены будет такой:
"Обновление информации о состоянии и/или наличии устройств тракта (кроме ближней платы SM-01/SM-02) инициируется записью команды 1 (для пары A) или 2 (для пары B) в регистр команд .8.0 платы SM-01/SM-02 (рекомендуется не писать команды не чаще одного раза в 5 минут) или нажатием кнопки "Опрос" в веб-интерфейсе (рекомендуется не нажимать кнопку "Опрос" в веб-интерфейсе, если опрос выполняется автоматически."
Это ты предлагаешь заменить только последний абзац текста от САН или весь его текст?
follow-up: 4 comment:3 by , 4 years ago
follow-up: 5 comment:4 by , 4 years ago
Replying to alx:
Replying to Vladimir:
Это ты предлагаешь заменить только последний абзац текста от САН или весь его текст?
Мое предложение в comment:1 касалось процитированного фрагмента.
Т.е. вариант замены от САН не подходит даже частично?
Мой текст (комм-2) на базе твоего с учётом рекомендаций по-твоему подходит для закрытия тикета,
или надо что-то изменить?
follow-up: 6 comment:5 by , 4 years ago
Replying to Vladimir:
Т.е. вариант замены от САН не подходит даже частично?
Я не понимаю, что значит "подходит частично". Предложенный в описании тикета вариант текста не совсем точен, так как не учитывает тот факт, что при мониторинге состояния регенераторов конманды "опрос" передаются плате автоматически (иначе параметры регенераторов не будут обновляться). Поэтому я сделал уточнение в своем комментарии.
follow-ups: 7 8 comment:6 by , 4 years ago
Replying to alx:
Replying to Vladimir:
Т.е. вариант замены от САН не подходит даже частично?
Я не понимаю, что значит "подходит частично". Предложенный в описании тикета вариант текста не совсем точен, так как не учитывает тот факт, что при мониторинге состояния регенераторов конманды "опрос" передаются плате автоматически (иначе параметры регенераторов не будут обновляться). Поэтому я сделал уточнение в своем комментарии.
Тут я имел ввиду, что ты предлагаешь заменить не весь текст для замены от Саши,
а только последний абзац Сашиного текста.
Конечный результат от САН + Алекс + ВАУ:
"Таблица Состояние регенераторов предназначена для отображения состояния устройств DSL тракта. В первой строке таблице отображается состояние DSL интерфейсов платы SM, окно конфигурации которой вы открыли (обновление параметров состояния интерфейсов происходит автоматически). Назначение граф таблицы Состояние регенераторов на Рис. 5.13 – в Табл. 5.13.
При нажатии кнопки Опрос в таблице последовательно отобразятся все устройства DSL-тракта, доступные в данный момент через встроенный канал связи, в следующем порядке:
- ближняя плата SM (первая строка)
- линейные регенераторы (пронумерованные от ближнего к дальнему R1,R2...)
- дальняя плата SM или модем MC04-DSL 1U/2U.
При нажатии кнопки Сброс счетчиков происходит сброс счетчиков BBE, ES, SES, AS, UAS в таблицах Состояние интерфейсов Е1 и Состояние регенераторов.
Обновление информации о состоянии и/или наличии устройств тракта (кроме ближней платы SM-01/SM-02) инициируется записью команды 1 (для пары A) или 2 (для пары B) в регистр команд .8.0 платы SM-01/SM-02 (рекомендуется не писать команды чаще одного раза в 5 минут), или нажатием кнопки Опрос в веб-интерфейсе (рекомендуется не нажимать кнопку Опрос
в Web-интерфейсе, если опрос выполняется автоматически."
Замечания ещё есть?
comment:7 by , 4 years ago
Replying to Vladimir:
Тут я имел ввиду, что ты предлагаешь заменить не весь текст для замены от Саши,
а только последний абзац Сашиного текста.
Ни то, ни другое. Я предлагал заменить тот фрагмент, который я процитировал.
follow-ups: 9 10 comment:8 by , 4 years ago
Replying to Vladimir:
Замечания ещё есть?
Мне немного не нравится компоновка текста, повествование перескакивает туда-сюда, предлагаю чуть переставить слова, заодно Web и веб, SM и SM-01/SM-02 привести к единообразию:
Таблица Состояние регенераторов(рис. 5.13) предназначена для отображения данных о состоянии и/или наличии устройств DSL тракта, назначение граф таблицы Состояние регенераторов описано в Табл. 5.13.
В первой строке таблицы Состояние регенераторов отображается состояние DSL интерфейсов платы SM, окно конфигурации которой вы открыли (обновление параметров первой строки происходит автоматически). Обновление информации в следующих строках инициируется нажатием кнопки Опрос.
При нажатии кнопки Опрос в таблице последовательно отобразятся все устройства DSL-тракта, доступные в данный момент через встроенный канал связи, в следующем порядке:
- ближняя плата SM (первая строка)
- линейные регенераторы (пронумерованные от ближнего к дальнему R1,R2...)
- дальняя плата SM или модем MC04-DSL 1U/2U.
При нажатии кнопки Сброс счетчиков происходит сброс счетчиков BBE, ES, SES, AS, UAS в таблицах Состояние интерфейсов Е1 и Состояние регенераторов.
Так-же обновление информации в таблице может быть инициировано записью команды 1 (для пары A) или 2 (для пары B) в регистр команд .8.0 платы SM (рекомендуется не писать команды чаще одного раза в 5 минут), инициатором может быть, например, система мониторинга. Рекомендуется не нажимать кнопку Опрос в веб-интерфейсе, если опрос выполняется автоматически.
Напомню, что в тексте я упоминаю термин "плата SM", предполагая что он введён ранее.
Например так:
5.2 Платы SM(передача по технологии SHDSL): SМ-01, SМ-02, SМ-03, SМ-04
Платы SM предназначены для передачи данных потоков Е1 и трафика Ethernet с использованием технологии SHDSL по одной или двум парам кабеля типа КСПП, МКС, ЗКП, ТЗ, ТП. К платам SM относятся платы типов SМ-01, SМ-02, SМ-03, SМ-04. ... ... ... и далее по тексту
И по поводу предложенного Алексеем уточнения у меня есть сомнения стоит ли его вставлять в РЭ. Дело в том, что пользоваться этим автоматическим опросом крайне неудобно(см. обсуждение), поэтому и описывать эты "сырую функцию не очень то и хочется...
comment:9 by , 4 years ago
Replying to san:
И по поводу предложенного Алексеем уточнения у меня есть сомнения стоит ли его вставлять в РЭ.
Если не вставить, люди будут уверены, что они мониторят регенераторы, и что поэтому у них все под контролем, а на самом деле они будут мониторить состояния полугодовой давности, кабели с тех пор деградировали, а персонал об этом не догадывается, так как видит красивые стабильные цифры... Это - диверсия.
comment:10 by , 4 years ago
Replying to san:
Replying to Vladimir:
Таблица Состояние регенераторов(рис. 5.13) предназначена для отображения данных о состоянии и/или
.....................................................................
Так-же обновление информации в таблице может быть инициировано записью команды 1 (для пары A) или 2 (для пары B) в регистр команд .8.0 платы SM (рекомендуется не писать команды чаще одного раза в 5 минут), инициатором может быть, например, система мониторинга. Рекомендуется не нажимать кнопку Опрос в веб-интерфейсе, если опрос выполняется автоматически.
Очень хорошо и спасибо, что скорректировал текст!
Как я понял, в этом тексте учтено и предложение Алекса в К2 (комменте-2)?
5.2 Платы SM(передача по технологии SHDSL): SМ-01, SМ-02, SМ-03, SМ-04
SM не только передача, но и приём, т.е. приёмо-передатчик, а короче иногда называют "модем"
(в названии S - Shdsl, M - Modem), тогда м.б. "(модем по технологии SHDSL),
или (SHDSL-модем) ? Кому и как больше нравится ???
Платы SM предназначены для передачи данных потоков Е1 и трафика Ethernet с использованием технологии SHDSL по одной или двум парам кабеля типа КСПП, МКС, ЗКП, ТЗ, ТП. К платам SM относятся платы типов SМ-01, SМ-02, SМ-03, SМ-04. ... ... ... и далее по тексту
Это уже изменил в РЭ-44.
И по поводу предложенного Алексеем уточнения у меня есть сомнения стоит ли его вставлять в РЭ. Дело в том, что пользоваться этим автоматическим опросом крайне неудобно(см. обсуждение), поэтому и описывать эты "сырую функцию не очень то и хочется...
Если ты в своём предложенном тексте это оставил, то я это не удалю, т.к. у Алекса есть веские доводы оставить предложенный им текст.
follow-up: 12 comment:11 by , 4 years ago
Как я понял, в этом тексте учтено и предложение Алекса в К2 (комменте-2)?
Учтено
SM не только передача, но и приём
Я взял формулировку которая была в РЭ, против "SHDSL модем" не возражаю
comment:12 by , 4 years ago
| Resolution: | → готово |
|---|---|
| Status: | new → closed |
Replying to san:
Как я понял, в этом тексте учтено и предложение Алекса в К2 (комменте-2)?
Учтено
SM не только передача, но и приём
Я взял формулировку которая была в РЭ, против "SHDSL модем" не возражаю
В РЭ-44 от 19.08.2020 теперь:
"5.2 Платы SM (SHDSL модем): SМ-01, SМ-02, SМ-03, SМ-04"
и текст из https://trac.adc-line.ru/mc-04/ticket/727#comment:8
Кстати, хорошее решение предложил Саша: если в заголовке пункта есть краткое название платы,
например, из двух знаков, и указано перечисление плат, относящихся к обозначению,
например, SM, то далее в тексте уже можно не указывать полный перечень плат вида "SM".
Это можно распространить и на другие платы разных исполнений.
Replying to san:
Это не совсем точно. Как следует из более раннего обсуждения, при мониторинге системами мониторинга опрос следует инициировать программно (то есть автоматически, без участия человека, записью команд 1/2 в переменную .8.0 платы SM-01/SM-02), например snmpset'ом из cron'а. Поэтому предлагаю написать примерно так:
Здесь для полноты картины надо добавить рекомендации не писать команду слишком часто (рекомендовать, например, раз в 5 минут) и рекомендацию не нажимать кнопку "Опрос" в веб-интерфейсе, если опрос выполняется автоматически.