Оргнавигатор
Назад к документации

Установка на Windows

Содержание комплекта поставки

  • orgnavigator.zip — Архив с приложением

Установка Node.js

Установите Node.js версии 20.9 или выше.

Скачать можно здесь: https://nodejs.org/en/download

Распаковка архива

Распакуйте архив orgnavigator.zip в каталог, в котором будут храниться данные приложения.

Например, сюда: c:\orgnavigator

Подготовка СУБД

Установка PostgreSQL

Если уже есть, можно пропустить.

Скачать можно с официального сайта: https://www.postgresql.org/download/windows/

Создание пользователя в PostgreSQL

Создайте пользователя для работы с базой данных. Например, так:

CREATE USER orgnavigator WITH 
    LOGIN 
    PASSWORD 'wc2jO2E5TWLGuOPPk1OcTq'
    CREATEDB;

Создание базы данных

Создайте базу данных и назначьте владельцем созданного пользователя. Например, так:

CREATE DATABASE orgnavigator OWNER orgnavigator;

Создание структуры базы данных

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

Внимание! Для развёртывания базы данных с тестовыми данными выполните скрипт из файла example.sql.

Настройка приложения

В каталоге с приложением в файле .env.production измените параметры подключения к БД и ключ для шифрования сессий пользователей JWT_SECRET.

Запуск сервера

Откройте командную строку и перейдите в каталог с приложением:

cd c:\orgnavigator

Запустите сервер:

node server.js

После запуска сервера приложение будет доступно по адресу http://localhost:3000

Поменять порт можно через переменную окружения PORT.

Пример для командной строки:

set PORT=3001 && node server.js

Пример для PowerShell:

$env:PORT=3001; node server.js

Создание службы Windows

Установка NSSM

Скачайте NSSM (Non-Sucking Service Manager) — утилиту для запуска приложений в качестве служб Windows.

Создайте каталог для NSSM (например, C:\Tools\nssm) и распакуйте в него исполняемый файл.

Установка службы

Запустите командную строку от имени администратора и выполните:

C:\Tools\nssm\nssm.exe install orgnavigator

Настройка параметров службы

Вкладка Application

  • Path: C:\Program Files\nodejs\node.exe
  • Startup directory: c:\orgnavigator
  • Arguments: c:\orgnavigator\server.js

Вкладка Details

  • Display name: Оргнавигатор

Вкладка Environment

  • Environment variables: PORT=3001

Остальные параметры заполните при необходимости.

Нажмите Install service.

Настройка восстановления службы

  1. Зайдите в Панель управления → Администрирование → Службы
  2. Найдите службу Оргнавигатор и откройте свойства
  3. Перейдите на вкладку Восстановление
  4. В полях Первый сбой, Второй сбой и Последующие сбои выберите Перезапуск службы
  5. Нажмите ОК

Запуск службы

Запустите службу из оснастки Службы или командой:

net start orgnavigator

Доступ к приложению

После запуска сервера приложение будет доступно по адресу:

http://localhost:3001

Начало работы

Первые шаги описаны в отдельной статье.