Установка коробочной версии на Windows

Инструкция для администратора компьютера, на котором будет работать коробочная версия КОМЕТУМ: офисного компьютера или сервера организации. Установка занимает несколько минут.

Требования к компьютеру

• Windows 10 или Windows 11 (64-разрядная), либо Windows Server 2019 и новее.
• Права администратора на время установки.
• Компьютер включён постоянно и не уходит в сон — питание, сон и ИБП.
• Постоянный адрес в офисной сети — офисная сеть.
• Свободное место: не меньше 10 ГБ под программу и данные, плюс место под копии на другом диске.
• Доступ в интернет — для активации, обновлений и подбора реквизитов по ИНН. Без интернета программа работает до оплаченной даты.

Что подготовить

1. Письмо от менеджера КОМЕТУМ: в нём личная ссылка на файл установки и код активации. Ссылка действует 3 дня. Если срок прошёл, при переходе по ссылке появится «Ссылка устарела или не найдена — попросите менеджера прислать новую»: менеджер выпустит новую ссылку, и она придёт новым письмом.
2. Постоянный адрес компьютера в сети и его сетевое имя — офисная сеть.
3. Папку для копий на другом диске, например D:\KometumКопии, или внешний диск, подключённый постоянно.

Установка

1. Скачайте файл установки по ссылке из письма. Имя файла — kometum-box-setup-<версия>.exe.
2. Нажмите на файл правой кнопкой мыши → «Запуск от имени администратора».
3. На странице «Сценарий установки» выберите:
   • «Новый экземпляр» — первая установка, в том числе при переезде из облачной версии: данные из облака переносятся после активации (переезд из облачной версии);
   • «Перенести из облака» — только если этот сценарий прямо указан в письме менеджера;
   • «Восстановить из копии» — установка на новый компьютер из резервной копии (перенос на новый компьютер).
4. На странице «Папки»:
   • «Папка данных» — оставьте предложенную C:\ProgramData\Kometum, если на диске C достаточно места;
   • «Папка копий» — укажите папку на другом внутреннем или внешнем диске. Сетевые папки не поддерживаются.
5. На странице «Сеть»:
   • «Сетевое имя и адрес» — имя компьютера и его постоянный адрес через запятую, например kometum, 192.168.1.10. Если в офисной сети компьютеры имеют полные имена, добавьте и полное имя, например kometum, kometum.office.local, 192.168.1.10;
   • «Порт HTTPS» — оставьте 443;
   • «Наименование организации» — как в документах организации.
6. Для сценария «Перенести из облака» введите код активации из письма. Для «Восстановить из копии» укажите папку копии вида kometum-ГГГГММДД-ЧЧММСС.
7. Нажмите «Установить» и дождитесь окончания.

Что делает установка

• раскладывает программу, базу данных и службу печати документов;
• создаёт уникальные для этого компьютера пароли и ключи;
• создаёт корневой сертификат организации и сертификат сервера для защищённого соединения в офисной сети;
• регистрирует службы «Kometum» и «KometumPostgreSQL» с автоматическим запуском;
• разрешает в брандмауэре Windows входящие подключения к портам 443 и 80 в частной и доменной сети;
• отключает сон и гибернацию при питании от сети;
• закрывает папку программы от обычных пользователей компьютера.

Первый запуск

Установщик сам устанавливает корневой сертификат организации на компьютере с программой, поэтому на этом компьютере программу можно открывать в браузере сразу.

На последней странице установщик показывает:

• адрес активации — https://<адрес>/activate;
• адрес для сотрудников — https://<адрес>;
• путь к корневому сертификату для рабочих мест — C:\ProgramData\Kometum\certs\root.cer;
• установлен ли сертификат на этом компьютере.

Перепишите адреса и путь. Затем:

1. Оставьте отмеченным «Открыть страницу активации» и нажмите «Завершить».
2. Если на последней странице указано, что сертификат на этом компьютере нужно установить, или браузер предупреждает о незащищённом подключении, установите сертификат по статье «Рабочее место сотрудника» и обновите страницу.
3. Активируйте программу — активация.

Проверка после установки

1. Откройте «Службы»: нажмите Win + R, введите services.msc, нажмите Enter.
2. Найдите службы «Kometum» и «KometumPostgreSQL». У обеих должно быть: состояние «Выполняется», тип запуска «Автоматически».
3. Перезагрузите компьютер. Не входя в систему, подождите 2–3 минуты и откройте адрес программы с другого компьютера — программа должна открыться: службы запускаются сами, без входа пользователя.

Если установка не завершилась

Установщик показывает окно с причиной. Полный журнал — C:\ProgramData\Kometum\logs\setup.log.

1. Устраните причину (например, освободите место или выберите другую папку копий).
2. Запустите установку ещё раз от имени администратора.
3. Если ошибка повторяется, подготовьте отчёт для службы поддержки и приложите к нему setup.log.

Где что лежит

Папка C:\ProgramData\Kometum доступна только администраторам компьютера. Не открывайте к ней общий доступ по сети: в ней хранятся пароли и ключи программы.

Смена адреса компьютера

Если компьютеру выдан другой постоянный адрес, смените адрес программы в её окне.

1. Закрепите новый адрес за компьютером на роутере — офисная сеть, раздел «Постоянный адрес».
2. Войдите в программу пользователем с правом «Обновления и копии» (у владельца оно есть).
3. Откройте «Параметры системы» → «Обновления и копии», блок «Адрес программы».
4. В поле «Новый адрес в офисной сети» введите новый адрес, например 192.168.1.20.
5. Нажмите «Изменить адрес» и подтвердите. Программа выпустит сертификат сервера на новый адрес и перезапустится: около минуты она недоступна.
6. Откройте программу по новому адресу и сообщите его сотрудникам. Сертификат организации на рабочих местах переустанавливать не нужно.

Если адрес сменить не удалось, в блоке «Адрес программы» появится сообщение «Адрес не изменён» с причиной.

Смена адреса без окна программы

Если программа не открывается, смените адрес вручную:

1. Запустите Блокнот от имени администратора и откройте в нём файл C:\ProgramData\Kometum\config\box.json.
2. В строке "hosts" замените старый адрес новым, например "hosts": ["kometum", "192.168.1.20"].
3. Если сотрудники открывают программу по адресу, а не по имени, замените адрес и в строке "baseUrl", например "baseUrl": "https://192.168.1.20". Этот адрес программа подставляет в ссылки в письмах.
4. Сохраните файл.
5. Откройте «Командную строку» от имени администратора и выполните:
   "C:\ProgramData\Kometum\bin\kometum-box.exe" certs
6. В «Службах» перезапустите службу «Kometum».

Новый адрес в офисной сети не требует переустановки сертификата на рабочих местах. Новое имя требует: программа сообщит об этом при выполнении команды certs или при смене адреса в окне программы. В этом случае обратитесь в поддержку.

Тихая установка

Для установки без вопросов мастера подготовьте файл ответов по образцу answers.sample.json (образец можно запросить в службе поддержки; после установки программы он лежит в папке инструкций payload\docs в папке программы) и выполните в «Командной строке» от имени администратора:

kometum-box-setup-<версия>.exe /VERYSILENT /SUPPRESSMSGBOXES /ANSWERS="C:\путь\answers.json" /LOG="C:\путь\setup.log"

Поля tlsCertFile и tlsKeyFile заполняются только для сервера с именем в интернете — работа сотрудников вне офиса, раздел «Сервер с именем в интернете».

Остановка и удаление

• Остановить программу: в «Службах» остановите «Kometum», затем «KometumPostgreSQL». Запуск — в обратном порядке.
• Удалить программу: «Параметры» → «Приложения» → «Kometum» → «Удалить». Данные, настройки и копии при этом сохраняются. Удаляйте их вручную, только если они точно больше не нужны. Сертификат организации из доверенных на этом компьютере программа при удалении убирает.