> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/on-premise/ru/on-premise/how-to-guide/troubleshooting/checking-service-statuses.md).

# Проверка статусов сервисов

В этом разделе описывается общая процедура действий и пункты для проверки при устранении неполадок на платформе Navixy. Он охватывает базовую диагностику Java-сервисов, веб-сервера и сервера базы данных. Знание того, как проверять и перезапускать сервисы, поможет понять причину проблемы и точнее её устранить.

Рекомендуется сначала ознакомиться с информацией на странице [Компоненты системы](/docs/on-premise/ru/on-premise/how-to-guide/troubleshooting/system-components.md) чтобы иметь представление о конфигурации и расположении файлов журналов сервисов.

## Общая проверка состояния

На актуальных инстансах Navixy On-premise, работающих на Linux, реализован скрипт, который выполняет быструю проверку состояния всех основных компонентов платформы: базы данных, веб-сайта и бэкенд-сервисов. Для его использования выполните вход под root и введите следующую команду в CLI вашего сервера:

```
check-navixy
```

Вывод покажет тип установки (на основе systemd или запущена в Docker) и состояние каждого из сервисов. Ожидаемый вывод должен быть следующим:

![](/files/7052f1c5020f9c7c7a48a34b99cc0252f6536467)

Если вы видите, что какой-либо из сервисов не запущен, это повод принять экстренные меры, так как в таком случае платформа не полностью функциональна.

![](/files/58384d67263954e306ab940511f14011f7e92328)

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

{% hint style="info" %}
The `check-navixy` скрипт доступен только для инстансов на базе Linux. Для Windows смотрите инструкции ниже.
{% endhint %}

## Java‑сервисы

Вы можете проверить Java-сервисы (Navixy backend) по отдельности, чтобы получить более подробную информацию об их текущем состоянии и при необходимости перезапустить их.

#### Linux

На Linux Navixy использует **systemd**, который входит в состав наиболее распространённых дистрибутивов Linux и является альтернативой традиционным init.d-скриптам. Ранее для той же цели использовался runit, но он сейчас устарел.

Чтобы проверить состояния Java-сервисов Navixy, используйте следующие команды:

```
systemctl status api-server
systemctl status sms-server
systemctl status tcp-server
```

**Когда всё работает нормально**, вывод для каждой команды должен показывать **active (running)** статус, вместе с текущим временем работы, объёмом используемой памяти и другой технической информацией. Например, нормальный вывод для API-server выглядит так:

```
● api-server.service - Navixy API Server
     Loaded: loaded (/home/java/api-server/api-server.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2023-08-10 08:44:31 UTC; 1 weeks 5 days ago
   Main PID: 3666212 (java)
      Tasks: 277 (limit: 37888)
     Memory: 2.2G
        CPU: 13h 8min 11.334s
```

Также будут показаны последние записи журнала сервиса, которые могут быть чрезвычайно полезны при диагностике неполадок.

**Когда какой-либо из сервисов не работает**, команда вернёт **inactive (dead)** статус. Пример:

```
○ api-server.service - Navixy API Server
     Loaded: loaded (/etc/systemd/system/api-server.service; enabled; vendor pr>
     Active: inactive (dead) since Tue 2023-08-22 13:59:59 UTC; 3s ago
    Process: 1002 ExecStart=/bin/bash /home/java/api-server/bin/service-run.sh >
   Main PID: 1002 (code=exited, status=143)
        CPU: 15.664s
```

В этом случае необходимо изучить логи неработающего сервиса. По умолчанию все журналы находятся в каталоге `/home/java/<service_name>/log/` директории.

Если сервис не удаётся запустить, в логах обычно появляются связанные ошибки. Попробуйте проверить информацию до записи `Server stopped` или любые недавние записи, начинающиеся с `WARN` или `ERROR`. Вы также можете попробовать перезапустить сервис и посмотреть, какие новые записи появятся с помощью команды `tail -f log.txt`.

{% hint style="info" %}
Для получения информации о перезапуске сервисов обратитесь к соответствующей странице: [Перезапуск инстанса - Linux](/docs/on-premise/ru/on-premise/how-to-guide/maintenance/restarting-instance.md#restarting-on-linux).
{% endhint %}

#### Windows

В Windows Java-сервисы Navixy устанавливаются как обычные службы Windows NT. Чтобы получить доступ к службам, откройте **services.msc** оснастку, и вы найдёте в списке три службы Navixy:

![Проверка статусов служб - Windows](/files/825c85668f9728473bd0dcd6f9cfe3f93f4f7a44)

Службы должны иметь *Running* статус. Если какой-либо из сервисов находится в ином состоянии, попробуйте запустить его и проверьте, начнёт ли он работать корректно. Если служба падает, причину следует искать в логах. Стандартное расположение журналов: `C:\java\<service_name>\log\`. Если сервис не удаётся запустить, в логах обычно появляются связанные ошибки. Попробуйте проверить информацию до записи `Server stopped` или любые недавние записи, начинающиеся с `WARN` или `ERROR`. Рекомендуется использовать продвинутые текстовые редакторы, такие как Notepad++ или Sublime Text, для просмотра логов. Стандартный Блокнот обычно не справляется с большими текстовыми файлами.

{% hint style="info" %}
Для получения информации о перезапуске сервисов обратитесь к соответствующей странице: [Перезапуск инстанса - Windows.](/docs/on-premise/ru/on-premise/how-to-guide/maintenance/restarting-instance.md#restarting-on-windows)
{% endhint %}

## Веб-сервер

Если Java-сервисы запущены, но доступ к интерфейсу по-прежнему отсутствует, следует проверить, запущен ли веб-сервер Nginx.

#### Linux

На Linux-инстансе проверьте статус Nginx следующей командой:

```
/etc/init.d/nginx status
```

Вывод должен показать **active (running)** статус, вместе с текущим временем работы, объёмом используемой памяти, другой технической информацией и последними записями журналов Nginx.

Если служба имеет **inactive (dead)** статус, попробуйте запустить её с помощью этой команды:

```
/etc/init.d/nginx start
```

Убедитесь, что Nginx запустился и работает нормально, а если нет, проверьте возможные ошибки в его журнале.

#### Windows

В Windows Nginx не является службой, а представляет собой небольшое приложение, работающее в фоновом режиме. Чтобы проверить, запущено ли оно, откройте Диспетчер задач (вкладка "Подробности") и найдите процессы **nginx.exe** - обычно их два или более.

![Проверка статуса Nginx - Windows](/files/39a1a7e8b10e4575cd481502ce78ee863265f6e2)

Если вы не можете найти **nginx.exe** в списке, попробуйте запустить его исполняемый файл из `C:\nginx` вручную или с помощью следующих команд в CMD:

```
cd /nginx
start nginx
```

{% hint style="info" %}
Если Nginx запущен, но вы всё ещё не можете получить доступ к платформе, обратитесь к соответствующим руководствам по устранению неполадок [панели администратора](https://navixy.com/docs/admin/ru/) или [пользовательского интерфейса](broken://spaces/OseFD01RLb3vNCjxHtPo) .
{% endhint %}

## База данных

Если вы подозреваете проблемы с подключением к базе данных (или обнаружили соответствующую информацию в логах сервисов), необходимо проверить её состояние. Navixy использует СУБД MySQL, поэтому прежде всего убедитесь, что сервер MySQL запущен. На Linux используйте следующую команду:

```
/etc/init.d/mysql status
```

В Windows проверьте, что у MySQL статус *Running* в оснастке `services.msc` .

Если СУБД работает, но в логах всё ещё встречаются ошибки подключения к базе данных, попробуйте подключиться к MySQL под той же учётной записью, что и Java-сервисы. Например, откройте файл `/home/java/api-server/conf/db.properties` , получите из него логин и пароль к базе данных и используйте их для подключения к MySQL из оболочки:

```
mysql -u<username> -p<password> google
```

Убедитесь, что и другие Java-сервисы также могут подключаться.

Если ваша база данных размещена на отдельном сервере, убедитесь, что соединение с ним доступно по стандартному порту MySQL 3306 (или по пользовательскому порту, если установка выполнена таким образом — проверьте файл `db.properties` любого из Java-сервисов).

{% hint style="info" %}
Если в логах вы видите ошибки, связанные не с доступностью базы данных, а с выполнением определённых SQL-запросов, пожалуйста, сообщите об этом в техническую поддержку. Такие проблемы, как правило, слишком сложны для самостоятельного решения.
{% endhint %}

## Свяжитесь с технической поддержкой

Шаги, показанные выше, являются очень базовыми для проверки платформы. Если вы не можете устранить проблему, пожалуйста, свяжитесь с нами по адресу <support@navixy.com>и опишите проблему подробно, предоставив логи и всю другую ценную информацию, которая у вас есть. Мы сделаем всё возможное, чтобы помочь.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/on-premise/ru/on-premise/how-to-guide/troubleshooting/checking-service-statuses.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
