Usm checker - История изменений

N.Skrypnik в 09:49, 18 октября 2024

2024-10-18T09:49:17Z

← Предыдущая версия		Версия от 09:49, 18 октября 2024
Строка 17:		Строка 17:

	== Требования ==		== Требования ==
	* Python - ''Для работы модуля необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[[https://devguide.python.org/versions/\|Status of Python versions]]"		* Python - ''Для работы модуля необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''
	Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''
	* USERSIDE 3.12.41+ (для версии 2.0.0-alpha)		* USERSIDE 3.12.41+ (для версии 2.0.0-alpha)
	* USERSIDE 3.12.69+ (для версии 2.0.0-beta)		* USERSIDE 3.12.69+ (для версии 2.0.0-beta)

N.Skrypnik в 09:48, 18 октября 2024

2024-10-18T09:48:03Z

← Предыдущая версия		Версия от 09:48, 18 октября 2024
Строка 17:		Строка 17:

	== Требования ==		== Требования ==
	* Python 3.5		* Python - ''Для работы модуля необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[[https://devguide.python.org/versions/\|Status of Python versions]]"
			Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''
	* USERSIDE 3.12.41+ (для версии 2.0.0-alpha)		* USERSIDE 3.12.41+ (для версии 2.0.0-alpha)
	* USERSIDE 3.12.69+ (для версии 2.0.0-beta)		* USERSIDE 3.12.69+ (для версии 2.0.0-beta)

Uscld2: /* Установка */

2024-09-05T11:04:41Z

Установка

← Предыдущая версия		Версия от 11:04, 5 сентября 2024
Строка 24:		Строка 24:
	== Установка ==		== Установка ==
	Установите Python и менеджер пакетов pip		Установите Python и менеджер пакетов pip
	sudo apt install -y python3 python3-dev python3-pip		sudo apt install -y python3 python3-dev python3-pip libsnmp-dev

	Скачайте архив, извлеките из него каталог с файлами модуля (это следует делать также и при обновлении).		Скачайте архив, извлеките из него каталог с файлами модуля (это следует делать также и при обновлении).

Uscld2: /* ping */

2024-01-10T07:17:36Z

ping

← Предыдущая версия		Версия от 07:17, 10 января 2024
Строка 76:		Строка 76:
	* '''retry''' - количество попыток выполнения запросов. По умолчанию 0 - дополнительные попытки не предпринимаются. Если же у вас есть сегменты сети с частыми потерями, можно увеличить это значение до 1 или 2, но не больше, т.к. перезапрос будет выполняться для всех узлов в предедлах одной итерации (асинхронной пачки).		* '''retry''' - количество попыток выполнения запросов. По умолчанию 0 - дополнительные попытки не предпринимаются. Если же у вас есть сегменты сети с частыми потерями, можно увеличить это значение до 1 или 2, но не больше, т.к. перезапрос будет выполняться для всех узлов в предедлах одной итерации (асинхронной пачки).

	[[Файл:Usm checker PING time diagram.png~~\|обрамить~~\|центр]]		[[Файл:Usm checker PING time diagram.png\|центр]]

	==== cmd ====		==== cmd ====

Uscld2: /* ping */

2024-01-10T07:16:58Z

ping

← Предыдущая версия		Версия от 07:16, 10 января 2024
Строка 75:		Строка 75:
	* '''timeout''' - таймаут ожидания ответов в секундах (время на одну итерацию). Значение по умолчанию - 1 секунда. Не рекомендуется указывать время ожидания менее секунды. Если нужно увеличить время между итерациями - увеличьте это значение. Если же ваша сетевая инфраструктура не работает асинхронно и '''in_iteration''' = 0 или около того, то можно использовать значения менее секунды, чтобы ускорить опрос.		* '''timeout''' - таймаут ожидания ответов в секундах (время на одну итерацию). Значение по умолчанию - 1 секунда. Не рекомендуется указывать время ожидания менее секунды. Если нужно увеличить время между итерациями - увеличьте это значение. Если же ваша сетевая инфраструктура не работает асинхронно и '''in_iteration''' = 0 или около того, то можно использовать значения менее секунды, чтобы ускорить опрос.
	* '''retry''' - количество попыток выполнения запросов. По умолчанию 0 - дополнительные попытки не предпринимаются. Если же у вас есть сегменты сети с частыми потерями, можно увеличить это значение до 1 или 2, но не больше, т.к. перезапрос будет выполняться для всех узлов в предедлах одной итерации (асинхронной пачки).		* '''retry''' - количество попыток выполнения запросов. По умолчанию 0 - дополнительные попытки не предпринимаются. Если же у вас есть сегменты сети с частыми потерями, можно увеличить это значение до 1 или 2, но не больше, т.к. перезапрос будет выполняться для всех узлов в предедлах одной итерации (асинхронной пачки).

			[[Файл:Usm checker PING time diagram.png\|обрамить\|центр]]

	==== cmd ====		==== cmd ====

Uscld2: /* Установка */

2023-11-10T09:39:10Z

Установка

← Предыдущая версия		Версия от 09:39, 10 ноября 2023
Строка 27:		Строка 27:

	Скачайте архив, извлеките из него каталог с файлами модуля (это следует делать также и при обновлении).		Скачайте архив, извлеките из него каталог с файлами модуля (это следует делать также и при обновлении).
	Перейдите в этот каталог и установите зависимости:		Перейдите в этот каталог и установите зависимости (по умолчанию подразумевается, что все модули находятся в каталоге <code>/opt/userside/название_модуля</code>):
	<pre>		<pre>
	python3 -m venv venv		python3 -m venv venv

Uscld2: /* Автоматизированный запуск */

2023-11-10T09:38:03Z

Автоматизированный запуск

← Предыдущая версия		Версия от 09:38, 10 ноября 2023
Строка 124:		Строка 124:

	Если у вас небольшая сеть (до 500 узлов), то достаточно запускать модуль раз в несколько минут, чтобы он определял активность как оборудования так и абонентов.		Если у вас небольшая сеть (до 500 узлов), то достаточно запускать модуль раз в несколько минут, чтобы он определял активность как оборудования так и абонентов.
	/2 * * * root ~~python3~~ /~~path~~/to/usm_checker.py > /dev/null 2>&1		/2 * * * root /opt/userside/usm_checker/venv/bin/python /opt/userside/usm_checker/usm_checker.py > /dev/null 2>&1
	В этом случае будут запускаться все проверки из конфигурационного файла.		В этом случае будут запускаться все проверки из конфигурационного файла.

Строка 148:		Строка 148:

	Например, чтобы запускать проверки для оборудования раз в минуту, а проверки для абонентов раз в 10 минут, cron будет выглядеть следующим образом:		Например, чтобы запускать проверки для оборудования раз в минуту, а проверки для абонентов раз в 10 минут, cron будет выглядеть следующим образом:
	/1 * * * root ~~python3~~ /~~path~~/to/usm_checker.py equipment > /dev/null 2>&1		/1 * * * root /opt/userside/usm_checker/venv/bin/python /opt/userside/usm_checker/usm_checker.py equipment > /dev/null 2>&1
	/10 * * * root ~~python3~~ /~~path~~/to/usm_checker.py customers > /dev/null 2>&1		/10 * * * root /opt/userside/usm_checker/venv/bin/python /opt/userside/usm_checker/usm_checker.py customers > /dev/null 2>&1

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

	''В FreeBSD необходимо либо прописать полный путь к python3 <code>/usr/local/bin/python3</code>, либо (что лучше), прописать в переменную PATH файла /etc/crontab путь <code>;/usr/local/bin;</code>
	''

	== Ротация файлов журнала ==		== Ротация файлов журнала ==

Uscld2: /* Первый тестовый запуск */

2023-11-10T09:36:05Z

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

← Предыдущая версия		Версия от 09:36, 10 ноября 2023
Строка 114:		Строка 114:
	== Первый тестовый запуск ==		== Первый тестовый запуск ==
	Выполните тестовый запуск модуля с правами суперпользователя:		Выполните тестовый запуск модуля с правами суперпользователя:
	sudo ~~python3~~ usm_checker.py		sudo ./venv/bin/python usm_checker.py

	В консоль будут выводиться сообщения о его работе. Убедитесь, что модуль отработал корректно. По завершении модуль передает данные об активных хостах в USERSIDE и отображает количество узлов в USERSIDE, которые изменили свое состояние по результатам работы модуля. Убедитесь, что всё работает как нужно, прежде чем ставить модуль на автоматический запуск.		В консоль будут выводиться сообщения о его работе. Убедитесь, что модуль отработал корректно. По завершении модуль передает данные об активных хостах в USERSIDE и отображает количество узлов в USERSIDE, которые изменили свое состояние по результатам работы модуля. Убедитесь, что всё работает как нужно, прежде чем ставить модуль на автоматический запуск.

Uscld2: /* Установка */

2023-11-10T09:35:40Z

Установка

← Предыдущая версия		Версия от 09:35, 10 ноября 2023
Строка 26:		Строка 26:
	sudo apt install -y python3 python3-dev python3-pip		sudo apt install -y python3 python3-dev python3-pip

	Скачайте архив, извлеките из него каталог с файлами модуля (это следует делать также и при обновлении). Вы можете использовать [[Python_venv\|виртуальную среду python]] с соответствующими исправлениями к приведенным далее командам, либо устанавливать все согласно этой инструкции глобально.		Скачайте архив, извлеките из него каталог с файлами модуля (это следует делать также и при обновлении).
	Перейдите в этот каталог и установите зависимости~~, введя следующую команду~~:		Перейдите в этот каталог и установите зависимости:
	~~sudo pip3~~ install --upgrade -r requirements.txt		<pre>
			python3 -m venv venv
			./venv/bin/pip install --upgrade pip
			./venv/bin/pip install --upgrade -r requirements.txt
			</pre>

	Затем, если это первоначальная установка, скопируйте файл settings.yml-example с именем settings.yml		Затем, если это первоначальная установка, скопируйте файл settings.yml-example с именем settings.yml

N.Skrypnik в 14:27, 4 октября 2023

2023-10-04T14:27:53Z

← Предыдущая версия		Версия от 14:27, 4 октября 2023
Строка 1:		Строка 1:
			[[Usm_checker_EN\|en]] \| [[Usm_checker\|ru]]

	'''Данный модуль является заменой устаревшему модулю [[usm_ping]]'''		'''Данный модуль является заменой устаревшему модулю [[usm_ping]]'''