Skip to content

Latest commit

 

History

History
132 lines (107 loc) · 10.3 KB

README.ru-RU.md

File metadata and controls

132 lines (107 loc) · 10.3 KB

In English

GaladrielMap Demo image License: CC BY-NC-SA 4.0

Имеется три готовых образа:

  • Образ для Docker
  • Образ виртуальной машины в формате Открытого формата виртуализации .ova с операционной системой Ubuntu
  • Платный образ загрузочного накопителя для Raspberry Pi.

Каждый вариант содержит готовые к использованию:

  • картплотер GaladrielMap v.2.9.8 с gpsdPROXY v.0.6.14
  • тайловый кеш GaladrielCache v.2.7.5
  • средство обмена информацией о местоположении netAIS v.1.5.10

Образ .ova может быть запущен в любой системе виртуальных машин (VirtualBox, VMware или другой). Образ Raspberry Pi может быть запущен в виртуальной машине QEMU или с него может быть загружена реальная машина.

Ссылки для скачивания:
образ Docker magnet link
виртуальная машина magnet link

Использование

Образ Docker

Загрузите образ в Docker: gunzip -c galadrielmapimage.tar.gz | docker load
Запустите контейнер: docker run -p 80:80 -p 3838:3838 -d --name galadrielmap galadrielmap
Добавьте параметр -p 9050:9050 в команду запуска контейнера, если предполагается использовать сервер netAIS.
Откройте 'http://YourDocker/map' в браузере.

Образ Docker запускает имитацию поступления данных NMEA, так что в на экране уже будет изменяющееся местоположение на движущейся карте.

.ova

  1. Загрузите образ виртуальной машины в используемую вами систему виртуальных машин (образ сделан в VirtualBox).
  2. Запустите виртуальную машину образа (она называется "гостевая машина").
  3. После того, как машина стартует, войдите в систему:
    имя пользователя: gm
    пароль: gm
  4. Определите ip_адрес_машины, введя:
    ifconfig
    Или просто подключитесь $ ssh [email protected]

Откройте адрес
http://ip_адрес_машины/map/
в браузере на любом компьютере локальной сети.
Или просто откройте адрес http://galadrielmap.local/map

Вы должнв поменять по крайней мере имя судна в файле \GaladrielMap\netAIS\boatinfo.ini
Если нужна имитация движения -- запустите её сами, выполнив \GaladrielMap\map\samples\startSimulation

Raspberry Pi

  1. Запишите образ Raspberry Pi на флеш-карту как это указано в документации. Необходима карта ёмкостью не менее 32G.
  2. Запустите Raspberry Pi.
  3. После загрузки определите ip_адрес_машины, можно воспользоваться документацией. Raspberry Pi доступна по найденному адресу по ssh: ssh pi@_ip_адрес_машины_.
    Или просто $ ssh [email protected]
    пароль: raspberry

Откройте адрес
http://ip_адрес_машины/map/
в браузере на любом компьютере локальной сети.
Или просто откройте адрес
http://raspberrypi.local/map

Ещё возможности

Использование приёмника ГПС

Кроме образа Docker:

  1. Подсоедините приёмник спутниковой геопозиционной системы в USB порт.
  2. Если это виртуальная машина -- разрешите виртуальной машине доступ к этому USB порту.

Приборная панель

Откройте адрес
http://ip_адрес_машины/map/dashboard.php
в браузере.
Панель оптимизтрована для слабых устройств с экраном на электронных чернилах (eInk).

netAIS

Кроме образа Docker:
Для запуска собственного сервера netAIS укажите в переменной $onion в файле /GaladrielMap/netAIS/params.php адрес скрытого сервиса TOR. Адрес находится в файле /var/lib/tor/hidden_service_netAIS/hostname и будет сгенерировани при первом запуске виртуальной машины.
Увидеть адрес можно, сказав cat /var/lib/tor/hidden_service_netAIS/hostname
Заполните файл информации о судне boatInfo.ini чем-нибудь.
Управление netAIS находится по адресу http://ip_адрес_машины/netAIS/

В образе Docker уже всё настроено и запущено.

Имитация движения

В каталоге /GaladrielMap/map/gpsdAISd имеется naiveNMEAdaemon.php -- средство имитации потока сообщений NMEA для gpsd. Там же есть три файла с записью потока сообщений: sample1.log -- запись AIS обстановки в порту, Suomi_2018.nmea и Suomi_2019.nmea -- две записи пути по озеру Сайма в Финляндии.
Для запуска имитации:

  1. Остановите gpsd:
    sudo systemctl stop gpsd.socket gpsd.service
  2. Создайте две сессии screen: screen, CtrlA-D для выхода из сессии
    screen, CtrlA-D для выхода из сессии
    screen -ls для получения списка сессий
  3. Запустите имитацию потока NMEA screen -r НомерПервойСессииподключитесь к первой сессии
    Внутри сессии:
    cd /GaladrielMap/map/gpsdAISd/' 'php naiveNMEAdaemon.php -iSuomi_2018.nmea -btcp://localhost:2222 для воспроизведения Suomi_2018.nmea
    CtrlA-D для выхода из сессии
  4. Запустите gpsd screen -r НомерВторойСессииподключитесь к второй сессии
    Внутри сессии:
    gpsd -N -n tcp://localhost:2222 CtrlA-D для выхода из сессии
  5. Убедитесь, что воспроизведение началось screen -r НомерПервойСессииподключитесь к первой сессии

или просто выполните \GaladrielMap\map\samples\startSimulation

Откройте в браузере http://ip_адрес_машины/map/.

В образе Docker уже всё настроено и запущено.

Администрирование сервера -- имеется только в .ova

Откройте адрес
http://ip_адрес_виртуальной_машины:10000/
в браузере.

Обновление программного обеспечения

Обновить программное обеспечение можно, воспользовавшись архивом GaladrielMap Emergency Kit. Скачайте свежий архив в домашний каталог и разархивируйте как указано в README.txt внутри архива. Нужно позаботиться о сохранении от перезаписи файла boatInfo.ini и, возможно, файлов параметров /GaladrielMap/netAIS/params.php, /GaladrielMap/tileproxy/params.php, /GaladrielMap/map/params.php и /GaladrielMap/tileproxy/mapsources/C-MAP.json.

Образ содержит

  • Apache2
  • PHP7
  • TOR
  • gpsd
  • mc
  • другие обычные утилиты и приложения

Оплата

Готовый к использованию загрузочный образ для Raspberry Pi может быть получен за 2 500 руб. через ЮMoney, или при оплате другим способом.
Можно заказать готовую карту SD требуемой ёмкости, с прошитым образом. Её нужно будет просто вставить в Raspberry Pi.