Установка DataExpress Web Server в Ubuntu 22.04
Прежде чем переходить к установке веб-сервера, убедитесь что у вас установлена СУБД Firebird. Инструкции по установке вы можете найти здесь и здесь. В качестве операционной системы будем использовать Ubuntu 22.04.
Хотя веб-сервер может быть установлен отдельно от Firebird, рекомендуется устанавливать их вместе — отзывчивость веб-сервера будет значительно выше.
Русификация системы
Сначала русифицируем систему:
# apt install language-pack-ru # dpkg-reconfigure locales
В первом окне находим и отмечаем строчку ru_RU.UTF8, во втором тоже выбираем ru_RU.UTF8. Перезагружаем систему:
# reboot
Установка веб-сервера
Установку веб-сервера будем производить в каталог /opt/dxwebsrv_linux64. Введите в терминале следующие команды:
# cd /opt # wget https://mydataexpress.ru/files/dxwebsrv_linux64.tar.gz # tar -xzf dxwebsrv_linux64.tar.gz # cd dxwebsrv_linux64
Теперь настроим автоматический запуск веб-сервера при загрузке системы. В папке веб-сервера есть файл dxwebsrv.service. Копируем его в каталог /etc/systemd/system:
# cp dxwebsrv.service /etc/systemd/system
Включаем сервис и стартуем его:
# systemctl enable dxwebsrv # systemctl start dxwebsrv
Проверить работает ли веб-сервер можно следующей командой:
# systemctl status dxwebsrv
Вывод будет примерно таким:
Если у вас чистая система, то проблем с запуском быть не должно. В случае успешного запуска статус будет active (running). А статус active (exited), например, говорит о том, что при запуске веб-сервера возникли проблемы. Все ошибки записываются в файл dxwebsrv.log. Посмотрите его, чтобы понять причину сбоя.
По умолчанию, веб-сервер использует порт 80 — HTTP. Если он будет занят каким-то процессом, то веб-сервер не запустится. Если порт занят, то нужно задать другой порт.
Базовая настройка веб-сервера
Все настройки веб-сервера находятся в конфигурационном файле dxwebsrv.cfg. Откройте файл в редакторе:
# mcedit /opt/dxwebsrv_linux64/dxwebsrv.cfg
Поменять порт можно в параметре Port. В параметре Firebird введите версию вашей СУБД Firebird. Возможные значения: 2.5 и 5. Если вы укажете неверную версию, то веб-сервер не запустится.
Теперь введите сведения о вашей базе данных. Для каждой базы данных создается своя секция. Название секции может быть любым. В названии допускается использовать латинские символы, цифры и знак подчеркивания. Например:
[DemoDB] Database=127.0.0.1:/opt/bases/DEMO_DB.DXDB
В параметре Database указывается строка подключения к базе данных. Строка подключения указывается точно так же, как и в настольной версии, в формате IP-адрес:ПолныйПутьКБазеДанных
.
Обратите внимание на IP-адрес. Т. к. веб-сервер и Firebird установлены на одной системе, вводим именно указанный выше адрес. Также допустимо указывать localhost.
После изменения файла конфигурации требуется перезапустить веб-сервер:
# systemctl restart dxwebsrv
Проверка связи
Откройте браузер и введите в строке IP-адрес вашего сервера или имя домена.
Если вы видите эту страницу, то значит веб-сервер работает. Теперь подключитесь к базе данных. Для этого после IP-адреса, через слэш, введите название секции из конфигурационного файла (регистр значения не имеет).
Если порт веб-сервера отличается от 80, то обязательно укажите его после IP-адреса. Например: http://18.23.2.76:8080/demodb/