Керівний документ по локалізації збоїв та приготування звітів про них
Вступ
Налагодженню та тестуванню системи OpenSCADA приділяється значний час розробників, однак у зв'язку із обмеженістю ресурсів та і практичною неможливістю охопити всі варіанти конфігурації та виконання системи OpenSCADA помилки можуть проявлятися як у вигляді невиконання окремих функцій, некоректності їх виконання та навіть аварійного завершення програми у користувачів. Розуміння цього з боку користувача дуже важливе, та з його боку потребується добра воля для приділення деякого часу на приготування звіту про проблему з метою її наступного усунення розробниками.
Перед приготуванням повідомлення про проблему рекомендується ознайомитися з переліком помилок та зауважень у відповідному розділі Помилки та зауваження до системи OpenSCADA.
Вимоги до повідомлення про помилку
Для виключення зайвих навідних питань та для прискорення процесу локалізації проблеми рекомендується слідувати наступним вимогам до повідомлення.
- Вказати оточення виконання OpenSCADA, а саме дистрибутив та версію операційної систем.
- Вказати версію системи OpenSCADA.
- Вказати особливості конфігурації та виконання. Бажано добиватися відтворення проблеми у стандартних конфігураціях та на демонстраційній БД. Якщо цього не вдається досягнути, тоді потрібно описати особливості конфігурації та прикласти до повідомлення БД, на якій проблема відтворюється.
- Описати дії які викликають помилку.
- Прикласти протокол повідомлень OpenSCADA для сеансу з відтворенням помилки.
- У випадку аварійного завершення потрібно сформувати файл передсмертного дампу пам'яті програми та отримати з нього розвороту стеку виконання на момент аварії, про що нижче.
Способи повідомлення
Повідомити про помилку у системі OpenSCADA можна декількома способами:
- у відповідному розділі форуму офіційного сайту:
http://oscada.org/ru/forum ;
- по електронній пошті на адресу
oscada@oscada.org або адреса розробників;
- у розділі Помилки та зауваження до системи OpenSCADA у базі знань проекту;
- у системі відслідковування помилок дистрибутиву ALTLinux ОС Linux, для пакету openscada.
Переклад триває
Получение файла предсмертного дампа и его обработка
В ОС Linux, при сбое программ, ядро ОС может формировать предсмертный дамп памяти программы. С помощью этого дампа часто можно выявить место в программе, вызвавшее аварийную остановку. Для включения возможности генерации предсмертного дампа памяти программы ядром необходимо выполнить команды:
# Проверка возможности генерации дампов памяти
# Указывает "core", если включена
$ cat /proc/sys/kernel/core_pattern
# Включение генерации дампов памяти
$ echo "core" > /proc/sys/kernel/core_pattern
После этого необходимо снять ограничение на размер генерируемого файла дампа, для чего OpenSCADA можно запустить с аргументом --CoreDumpAllow или выполнить специальную команду перед вызовом OpenSCADA "$ ulimit -c unlimited".
Затем достаточно убедиться в том, что пользователь, запускающий OpenSCADA, имеет право записи в рабочую директорию OpenSCADA, параметр "Workdir" в конфигурационном файле программы.
Далее запускается система OpenSCADA и воспроизводится аварийное завершение, в результате которого в рабочей директории OpenSCADA создаётся файл core.
Типовые скрипты запуска OpenSCADA, которые поставляются в пакетах дистрибутивов OpenSCADA с версии 0.8.0, включают генерацию дампа памяти и автоматически формируют из него отчёт обратных вызовов (backtrace) в виде файлов "crash_2012-01-05_11:05.txt" в рабочей директории.
Если сформировался файл дампа памяти core, а отчёт обратных вызовов автоматически не сформировался, то вероятно не установлен отладчик "gdb". В таком случае Вы должны его установить и вызвать вручную команду, из текущей директории для глобальной конфигурации:
Или-же выполнить процедуру в интерактивном режиме, для глобальной конфигурации:
# Переход к рабочей директории OpenSCADA
(gdb) cd /var/spool/openscada
# Указание исполняемого файла, не скрипты!
(gdb) file /usr/bin/openscada
# Указание файла дампа памяти программы
(gdb) core-file /var/spool/openscada/core.26658
# Получение разворота стека исполнения
(gdb) bt
#0 0xb7d104c0 in pthread_cancel () from /lib/librt.so.1
#1 0xb7d1edaa in start_thread () from /lib/libpthread.so.0
#2 0xb7dfcf5e in clone () from /lib/libc.so.6