Opened 21 months ago

Closed 18 months ago

Last modified 15 months ago

#977 closed дефект (готово)

РЭ: ошибочный OID переменной COMMAND плат SM-01/SM-02/SM-03

Reported by: alx Owned by: Vladimir
Priority: major Component: Руководство по эксплуатации
Keywords: Cc:

Description

В РЭ аппаратуры MC04-DSL-3U редакции 53 в п. 5.2.14 на странице 35 неверно указан OID регистра команд. Эта переменная на самом деле имеет OID .6.0, а не .8.0, как указано в тексте РЭ.

Чтобы не вводить в заблуждение читателей я предлагаю заменить в тексте РЭ неверный OID на верный.

Change History (8)

comment:1 by alx, 21 months ago

Summary: РЭ: ошибочнчный OID переменной COMMAND плат SM-01/SM-02/SM-03РЭ: ошибочный OID переменной COMMAND плат SM-01/SM-02/SM-03

in reply to:  description ; comment:2 by Vladimir, 20 months ago

Replying to alx:

В РЭ аппаратуры MC04-DSL-3U редакции 53 в п. 5.2.14 на странице 35 неверно указан OID регистра команд.

В РЭ-53 на стр.35 нет букв "OID".
Первый раз это сочетание встречается на стр.173 в
"Табл. 6.4 Описание содержимого таблицы Список всех аварий".

Эта переменная на самом деле имеет OID .6.0, а не .8.0, как указано в тексте РЭ.

Надо бы как-то указать в тексте на стр.35 это сочетание и пояснить, а сейчас там
не очень понятный текст:
"Обновление информации о состоянии и/или наличии устройств тракта (кроме ближних плат SM) инициируется записью команды 1 (для пары A) или 2 (для пары B) в регистр
команд .6.0 плат SM
"

Чуть подробнее можешь пояснить для РЭ?
Кто, как где именно должен записать команду 1 или 2
Где тут добавить в тексте буквы OID?
От каких слов эти буквы?

Чтобы не вводить в заблуждение читателей я предлагаю заменить в тексте РЭ неверный OID на верный.

Цифру 8 я уже поменял на цифру 6.

in reply to:  2 ; comment:3 by alx, 20 months ago

Replying to Vladimir:

Надо бы как-то указать в тексте на стр.35 это сочетание и пояснить, а сейчас там
не очень понятный текст:
"Обновление информации о состоянии и/или наличии устройств тракта (кроме ближних плат SM) инициируется записью команды 1 (для пары A) или 2 (для пары B) в регистр
команд .6.0 плат SM
"

Чуть подробнее можешь пояснить для РЭ?

Уточни, пожалуйста, что именно требуется пояснить (если требуется пояснить что-то помимо написанного ниже).

Кто, как где именно должен записать команду 1 или 2

Кто должен, я не знаю. :)

Как - есть несколько способов.

  1. Можно записать вручную (интерактивно) через веб-интерфейс, выбрав в диалоге настройки платы на вкладке "Состояние" нужную пару и нажав кнопку "Опрос". По понятным причинам для мониторинга этот вариант не подходит.
  2. Можно записать по протоколу SNMP. На мой взгляд, это наиболее простой способ для осуществления мониторинга.
  3. Можно записать по протоколу HTTP с помощью команды API snmpset (собственно, именно так происходит запись из веб-интерфейса в п. 1, только в данном случае без самого интерфейса). В принципе, для мониторинга этот способ тоже годится, но он сложнее чем предыдущий (хотя бы потому что требуется предварительно выполнять аутентификацию), поэтому не вижу практического смысла в его использовании.

Где именно - какая разница? Плате, которая получила команду, совершенно безразлично, откуда эта команда была отправлена. Для платы имеет значение только сам факт получения команды.

Лично мне наиболее разумным и логичным видится отправка команды оттуда же, откуда и осуществляется мониторинг (где находится система мониторинга). Иначе может возникнуть ситуация, когда хост, отправляющий команду, потерял связность с блоком, а система мониторинга - нет, и в результате система мониторинга будет получать из блока устаревшие (не обновляющиеся) данные... Но пользователь, конечно, может сделать как угодно - как посчитает нужным исходя из своих конкретных условий...

Где тут добавить в тексте буквы OID?

Вопрос не по адресу. Я не знаю. Я в описании тикета не предлагал добавить в тексте буквы OID. Рекомендую задать этот вопрос тому, кто предлагает добавить в тексте буквы OID. :)

От каких слов эти буквы?

От Object IDentifier.

in reply to:  3 ; comment:4 by Vladimir, 20 months ago

Replying to alx:

Replying to Vladimir:

Надо бы как-то указать в тексте на стр.35 это сочетание и пояснить, а сейчас там
не очень понятный текст:
"Обновление информации о состоянии и/или наличии устройств тракта (кроме ближних плат SM) инициируется записью команды 1 (для пары A) или 2 (для пары B) в регистр
команд .6.0 плат SM
"

Чуть подробнее можешь пояснить для РЭ?

Уточни, пожалуйста, что именно требуется пояснить (если требуется пояснить что-то помимо написанного ниже).

Для юзера, который первый раз это читает (как я), могут быть вопросы, например,
"...(кроме ближних плат SM)" - почему "кроме": их состояние не надо обновлять?
"...инициируется записью команды..." - это юзер должен как-то инициировать (тогда как?), или это, например, умная SW-01 будет инициировать?
"...записью команды..." юзер должен как-то руками записать - где и как: какое окно открыть,
что там напечатать, или это как-то само-собой запишется? :-)
"... в регистр команд..." это сочетание встретилось впервые, да и слово "регистр" в единственном числе тоже впервые - как работать с этим регистром...

Как - есть несколько способов.

  1. Можно записать вручную (интерактивно) через веб-интерфейс, выбрав в диалоге настройки платы на вкладке "Состояние" нужную пару и нажав кнопку "Опрос". По понятным причинам для мониторинга этот вариант не подходит.

Это тебе сразу понятно, но не каждому - лучше пояснить почему не подходит...

  1. Можно записать по протоколу SNMP. На мой взгляд, это наиболее простой способ для осуществления мониторинга.

А как это сделать - описание, или ссылка?

  1. Можно записать по протоколу HTTP с помощью команды API snmpset (собственно, именно так происходит запись из веб-интерфейса в п. 1, только в данном случае без самого интерфейса). В принципе, для мониторинга этот способ тоже годится, но он сложнее чем предыдущий (хотя бы потому что требуется предварительно выполнять аутентификацию), поэтому не вижу практического смысла в его использовании.

Лучше не упоминать, а то опять будут вопросы, как конкретно это сделать...

Лично мне наиболее разумным и логичным видится отправка команды оттуда же, откуда и осуществляется мониторинг (где находится система мониторинга).

Обычно, наверное, так все и делают - от Узла связи с установленным РМО...

Где тут добавить в тексте буквы OID?

Вопрос не по адресу. Я не знаю. Я в описании тикета не предлагал добавить в тексте буквы OID.

Ты же прямо в Тикете напечатал:
"...на странице 35 неверно указан OID регистра команд.
Эта переменная на самом деле имеет OID .6.0
"
поэтому раз уж приводятся какие-то команды, то надо их и обозвать правильно...

От каких слов эти буквы?

От Object IDentifier.

Попробую это добавить в РЭ, т.е. это сочетание встречается 31 раз,
а расшифровки нет ни разу.

in reply to:  4 ; comment:5 by alx, 20 months ago

Replying to Vladimir:

"...(кроме ближних плат SM)" - почему "кроме": их состояние не надо обновлять?

Я этого не знаю. Рекомендую адресовать этот вопрос разработчику плат SM-01/SM-02/SM-03.

"...инициируется записью команды..." - это юзер должен как-то инициировать (тогда как?), или это, например, умная SW-01 будет инициировать?

SW-01 по свой собственной инициативе такую запись не делает. Как - уже ответил в comment:3.

"...записью команды..." юзер должен как-то руками записать - где и как: какое окно открыть,
что там напечатать, или это как-то само-собой запишется? :-)

Само собой не запишется. Где и как, ответил в comment:3.

"... в регистр команд..." это сочетание встретилось впервые, да и слово "регистр" в единственном числе тоже впервые - как работать с этим регистром...

С ним работают путем записи туда команд. Команда представляет собой число. При записи команды плата начинает эту команду выполнять (в контексте данного тикета - опрашивать регенераторы).

Это тебе сразу понятно, но не каждому - лучше пояснить почему не подходит...

Потому что это будет очень дорого для компании - держать в штате, как минимум, четырех человек, работа которых будет заключаться только в том, чтобы каждые 5 минут нажимать кнопку "Опрос" в веб-интерфейсе. Гораздо дешевле будет купить компьютер и возложить эту работу на него. Даже при средней зарплате сотрудников компьютер окупится за 1 рабочий день. :) А учитывая, что, скорее всего, компьютер в компании и так уже есть (ведь чтобы запустить веб-браузер тоже компьютер нужен!), вопрос окупаемости просто не возникает...

Хотя, если компания настолько богатая, что денег вообще не считает, возможно, что вариант 1 ей вполне подойдет... :)

А как это сделать

Не уверен, что правильно понял вопрос. Для этого надо воспользоваться SNMP клиентом, предписав ему послать плате SW-01 SNMP запрос SET, содержащий OID регистра команд платы SM-01/SM-02/SM-03 и записываемое значение (1 или 2).

описание, или ссылка?

Что "описание или ссылка"? Если это просьба ко мне дать тебе описание или ссылку, то уточни, пожалуйста, описание чего или ссылка на что. :)

Лучше не упоминать, а то опять будут вопросы, как конкретно это сделать...

??? Ты просишь меня об этой возможности не упоминать? :) Или я понял неправильно?

Я в описании тикета не предлагал добавить в тексте буквы OID.

Ты же прямо в Тикете напечатал:
"...на странице 35 неверно указан OID регистра команд.
Эта переменная на самом деле имеет OID .6.0
"

Напечатал. И что? В процитированном тобой фрагменте не содержится предложения добавить в тексте буквы OID. Мое предложение написано в последнем абзаце описания:

Чтобы не вводить в заблуждение читателей я предлагаю заменить в тексте РЭ неверный OID на верный.

Last edited 20 months ago by alx (previous) (diff)

in reply to:  5 comment:6 by Vladimir, 20 months ago

Replying to alx:

Replying to Vladimir:

"...(кроме ближних плат SM)" - почему "кроме": их состояние не надо обновлять?

Я этого не знаю. Рекомендую адресовать этот вопрос разработчику плат SM-01/SM-02/SM-03.

У нас всё знает САН и он предложил такую запись в скобках:
"(информация о состоянии ближней платы SM обновляется автоматически)" -
у тебя есть уточнение на такую фразу в РЭ ?

"...инициируется записью команды..." - это юзер должен как-то инициировать (тогда как?),

Если это инициирует не SW-01, тогда запишу так:
"...инициируется пользователем..." - согласен с таким дополнением?

Само собой не запишется. Где и как, ответил в comment:3.

Про первый вариант ты сам в конце ответил: "...для мониторинга этот вариант не подходит",
тогда в в РЭ про это не надо записывать.
Про 3-й вариант ты записал - "не вижу практического смысла в его использовании.",
т.е. и в РЭ нет смысла вставлять.

Второй вариант про SNMP ты, на мой взгляд, одобрил, но в РЭ надо бы записать
не просто название способа, а последовательность действий юзера:
что и как открыть, что найти в открывшемся окне и нажать или что там напечатать,
либо дать ссылку на текст, где подробно описаны эти действия.

Вот я, например, не знаю, как это "записать по протоколу SNMP":
что открыть, куда смотреть, где можно записать...

"... в регистр команд..." ... - как работать с этим регистром...

С ним работают путем записи туда команд.

Это слишком абстрактно, не конкретно...

Команда представляет собой число. При записи команды плата начинает эту команду выполнять (в контексте данного тикета - опрашивать регенераторы).

Опять нет последовательности действий юзера для выполнения записи...

А как это "записать по протоколу SNMP"

Для этого надо воспользоваться SNMP клиентом,

Как воспользоваться, что открыть, что нажать

предписав ему послать плате SW-01 SNMP запрос SET, содержащий OID регистра команд платы SM-01/SM-02/SM-03 и записываемое значение (1 или 2).

Как "предписав" - например, так: "Пошли-ка ты плате SW-01 SNMP запрос SET...!"? :-)

описание, или ссылка?

Что "описание или ссылка"? Если это просьба ко мне дать тебе описание или ссылку, то уточни, пожалуйста, описание чего или ссылка на что. :)

на то, как именно надо выполнять предписание, что открыть, где сделать запись,
а если такого описания нет и нет ссылки на описание, то сделай это описание для РЭ,
т.к. я не смогу.

Лучше не упоминать, а то опять будут вопросы, как конкретно это сделать...

??? Ты просишь меня об этой возможности не упоминать? :) Или я понял неправильно?

Не правильно: я ждал ответ-рекомендацию для РЭ, например: "Да, лучше не упоминать",
или "Нет, лучше упомянуть, например, так: ..." и я сам сделаю так, как ты посоветуешь,
т.к. я не могу судить о том, чего не знаю...

Я в описании тикета не предлагал добавить в тексте буквы OID.

Ты же прямо в Тикете напечатал:
"...на странице 35 неверно указан OID регистра команд.
Эта переменная на самом деле имеет OID .6.0
"

Напечатал. И что? В процитированном тобой фрагменте не содержится предложения добавить в тексте буквы OID.

Если все Разработчики и Знатоки называют цифры типа ".6.0" буквами "OID"?
то лучше бы и в РЭ так же обозвать эти цифры, например, таким образом:
"...инициируется записью команды 1 (для пары A) или 2 (для пары B) в регистр
команд OID (Object IDentifier) .6.0 плат SM" - одобряешь такую фразу? Правильная ли она?

Мое предложение написано в последнем абзаце описания:

Чтобы не вводить в заблуждение читателей я предлагаю заменить в тексте РЭ неверный OID на верный.

Это я уже исправил, но, если мне не всё ясно, то и некоторые юзеры будут надоедать тебе и САН глупыми на твой взгляд вопросами, а юзеров наших МС04 уже, наверное, тысячи...
Чем подробнее РЭ, тем меньше будет вопросов и ошибок юзеров,
для этого в РЭ надо бы описывать последовательность конкретных действий руками.
Юзеры МС04 - это как бы "живые роботы", которые действуют по "программе" в РЭ :-)

Мне опять кажется, что на подобные тикеты из 2-х строчек описание на сложные для меня вопросы лучше бы предлагал кто-то из Авторов Харда и Софта: по количеству прочитанного и напечатанного текста в комментах это было бы гораздо короче, быстрее и правильнее :-)

in reply to:  description comment:7 by Vladimir, 18 months ago

Resolution: готово
Status: newclosed

Replying to alx:

В РЭ аппаратуры MC04-DSL-3U редакции 53 в п. 5.2.14 на странице 35 неверно указан OID регистра команд. Эта переменная на самом деле имеет OID .6.0, а не .8.0, как указано в тексте РЭ.

В РЭ-54 записан правильный OID .6.0

comment:8 by san, 15 months ago

milestone: 1 очередь

Milestone deleted

Note: See TracTickets for help on using tickets.