Package: adengine
ADEngineScroll down for russian languageПрокрутите ниже для русского языкаen-US:AboutThis is a python engine for Activity Data Extractor.It is a special python module, designed to extract data from multiple activity files at the same time.InstallationDownload and install Cisco Packet TracerDownload and installActivity Data ExtractorDownload and install PythonInstall engine fromPyPIusing commandpython3 -m pip install adengineNow the engine should be installed and ready to goRequirementsCisco Packet Tracer 7.3.0, 7.3.1 or 8.0.0.It is possible, that engine would run on higher versions on PacketTracer, but this isuntestedfunctionality.Activity Data Extractor1.0.3 and higher.Python 3.8 or higher.OS depends on version of Packet TracerUbuntu 18.04 for Cisco Packet Tracer 7.3.*Ubuntu 20.04 for Cisco Packet Tracer 8.0.0Java 8 or higher.xvfb and xvfb-run, if you want to run app using virtual display.UsageThere are several possible ADEngine use cases:Use ADEngine from Python code. Actual documentation for API can be foundhereRun ADEngine server using commandpython3 -m adegine.serverAdditional parameters can be found using commandpython3 -m adengine.server --helpParameters can be passed to ADEngine using command line parameters or via environment variable.Command line parameters have and advantage.ParameterDescriptionUsing cmdUsing envPossible valuesDefaultLog levelLevel of logs-ADENGINE_LOG_LEVELDEBUG,INFO,WARNING,ERRORINFOQueue sizeSize of queue with tasks--queue-sizeADENGINE_QUEUE_SIZEpositive integer20Read file timeoutTimeout for ADE to read file in seconds--read-file-timeoutADENGINE_READ_FILE_TIMEOUTpositive integer in range 5..6010Use virtual displayEnable using xvfb to run Packet Tracer--use-virtual-displayADENGINE_USE_VIRTUAL_DISPLAY0 or 1 for env, specified or not specified for cmdDisabledResult TTLResult time to live--result-ttlADENGINE_RESULT_TTLhh:mm:ss00:05:00Tasks before session restartNum of tasks before session restart--tasks-before-session-restartADENGINE_TASKS_BEFORE_SESSION_RESTARTpositive integer100Unix socketPath to unix socket--unix-socketADENGINE_UNIX_SOCKabsolute path to unix socket (non existent)/tmp/adengine.sockMax connectionsNum of maximum connections to server--max-connectionsADENGINE_MAX_CONNECTIONSpositive integer10Run ADEngine client using commandpython3 -m adegine.clientAdditional parameters can be found using commandpython3 -m adengine.client --helpParameters can be passed to ADEngine using command line parameters or via environment variable.Command line parameters have and advantage.ParameterDescriptionUsing cmdUsing envPossible valuesDefaultActivityAbsolute path to activity fileactivity-absolute path to file-PasswordPassword to activity file--password-stringNoneNet stabilization delaySimulated network stabilization delay--net-stabilization-delay-non negative integer in range 0..6000SocketAbsolute path to unix socket to connect to ADEngine server--socketADENGINE_UNIX_SOCKabsolute path to file/tmp/adengine.sockru-RU:О репозиторииДанный репозиторий содержит движок и API на Python для Activity Data Extractor.Это специальный модуль Python, разработанный для параллельного извлечения данных из нескольких файлов Packet Tracer Activity.УстановкаСкачайте и установите Cisco Packet TracerСкачайте и установитеActivity Data ExtractorСкачайте и установите PythonУстановите движок изPyPIиспользуя командуpython3 -m pip install adengineТеперь движок должен быть установлен и готов к использованиюТребования к системеCisco Packet Tracer 7.3.0, 7.3.1 или 8.0.0.Вполне возможно, что движок будет работать и на более свежих версиях Cisco Packet Tracer, но эта функциональностьне протестирована.Activity Data Extractor1.0.3 или выше.Python 3.8 или выше.ОС зависит от версии Packet TracerUbuntu 18.04 для Cisco Packet Tracer 7.3.*Ubuntu 20.04 для Cisco Packet Tracer 8.0.0Java 8 или выше.xvfb и xvfb-run, если вы хотите запустить приложение с использованием виртуального дисплея.UsageЕсть несколько вариантов использования ADEngine:ADEngine можно использовать как модуль Python. Актуальная документация API находитсяздесьЗапускать сервер ADEngine используя командуpython3 -m adegine.serverДополнительный параметры можно посмотреть используя командуpython3 -m adengine.server --helpПараметры могут быть переданы серверу ADEngine используя аргументы командной строки или через переменные среды.Аргументы командной строки имеют преимущество.ПараметрОписаниеАргумент комадной строкиПеременная окруженияВозможные значенияЗначение по умолчаниюLog levelУровень логирования-ADENGINE_LOG_LEVELDEBUG,INFO,WARNING,ERRORINFOQueue sizeРазмер очереди задач--queue-sizeADENGINE_QUEUE_SIZEположительное целое число20Read file timeoutТаймаут для ADE на чтение файла в секундах--read-file-timeoutADENGINE_READ_FILE_TIMEOUTположительное целое число в диапазоне 5..6010Use virtual displayВключает использование виртуального дисплея для запуска Packet Tracer--use-virtual-displayADENGINE_USE_VIRTUAL_DISPLAY0 или 1 для переменной окружения, указано или не указано для аргумента командной строкиВыключеноResult TTLВремя жизни результата--result-ttlADENGINE_RESULT_TTLчч:мм:сс00:05:00Tasks before session restartКоличество выполненных задач перед перезапуском сессии--tasks-before-session-restartADENGINE_TASKS_BEFORE_SESSION_RESTARTположительное целое число100Unix socketПуть к unix сокету--unix-socketADENGINE_UNIX_SOCKабсолютный путь к unix сокету (на данный момент файл не должен существовать)/tmp/adengine.sockMax connectionsМаксимальное количество одновременных подключений к серверу--max-connectionsADENGINE_MAX_CONNECTIONSположительное целое число10Запускать клиент ADEngine используя командуpython3 -m adegine.clientДополнительный параметры можно посмотреть используя командуpython3 -m adengine.client --helpПараметры могут быть переданы клиенту ADEngine используя аргументы командной строки или через переменные среды.Аргументы командной строки имеют преимущество.ПараметрОписаниеАргумент комадной строкиПеременная окруженияВозможные значенияЗначение по умолчаниюActivityАбсолютный путь до файла Packet Tracer Activityactivity-абсолютный путь до файла-PasswordПароль к файлу Packet Tracer Activity--password-строкаNoneNet stabilization delayВремя стабилизации симулируемой сети--net-stabilization-delay-неотрицательное целое число в диапазоне 0..6000SocketАбсолютный путь до Unix сокета для подключения с серверу ADEngine--socketADENGINE_UNIX_SOCKабсолютный путь до файла/tmp/adengine.sock