Устарело
Пассворк 5

Windows Server 2016/2019

23min

Установка Пассворк в Windows Server 2016/2019

1. Минимальные системные требования

Пассворк не требователен к ресурсам сервера(-ов). Объемы необходимых ресурсов (RAM, CPU, HDD) и количество серверов зависят от количества активных пользователей, объема хранимых данных, а также требований к отказоустойчивости системы.

2. Изменение имени сервера, установка IIS 10, открытие порта 5353

Нажмите «Win+X», затем «Y» и измените стандартное имя сервера. Измените имя на «passwork» для того, чтобы задействовать локальный домен «passwork.local» в частной сети.

Document image


Для того, чтобы внесенные изменения вступили в силу необходимо перезагрузить систему.

Откройте «Server Manager» и добавьте роль «Web Server (IIS)».

Document image


Установите «CGI» для «IIS».

Document image


В настройках брэндмауэра разрешите входящее соединение по протоколу UDP на порт 5353.

Document image

Document image

Document image


3. Установка MongoDB

Скачайте установщик MongoDB и запустите его

⬇️ https://portal.passwork.pro/mongodb-win32-x86_64-2012plus-4.2.9-signed.msi

Нажмите «Next», согласитесь с условиями использования, опять нажмите «Next». Выберите опцию «Complete».

Document image


Отметьте пункт «Install MongoD as a Service». Нажмите «Next».

Document image


Отмените установку «Install MongoDB Compass». Нажмите «Next», затем «Install» для начала процесса установки.

Document image


Нажмите «Finish» после завершения процесса установки.

Настройка брэндмауэра Windows

Откройте «Control Panel» и выберите раздел «System and Security». Затем нажмите на «Windows Firewall».

Вы должны увидеть окно управления брэндмауэром Windows:

Document image


Нажмите на «Allow an app or feature trough Windows Firewall», появится новое окно. Нажмите «Allow another app» -> нажмите «Browse» и найдите приложение MongoDB Database Server «C:\Program Files\MongoDB\Server\4.2\bin\mongod.exe», затем нажмите «Add» и «Ok».

Document image


Убедитесь в том, что служба MongoDB была успешно запущена

Проверьте лог файл C:\Program Files\MongoDB\Server\4.2\log\mongod.log и обратите внимание на строку: [initandlisten] waiting for connections on port 27017

4. Установка PHP 8.0

💡 Необходимо установить версию PHP 8.0. Более новые версии пока не поддерживаются.

  1. Скачайте PHP 8.0 с официального сайта — https://windows.php.net/downloads/releases/php-8.0.29-nts-Win32-vs16-x64.zip
  2. Проверьте свойства архива. Снять свойство «заблокирован», если архив получил его при скачивании
  3. Распаковать архив
  4. Переместить папку с распакованным архивом (В данном примере путь C:\Program Files\php8)

5. Установка Phalcon PHP расширения и MongoDB PHP драйвера, а также дополнительных расширений и опций.

Скачайте и установите Visual C++ Redistributable Packages for Visual Studio.

⬇️ https://download.visualstudio.microsoft.com/download/pr/b929b7fe-5c89-4553-9abe-6324631dcc3a/296F96CD102250636BCD23AB6E6CF70935337B1BBB3507FE8521D8D9CFAA932F/VC_redist.x64.exe

А также:

⬇️https://github.com/phpmanager/phpmanager/releases/download/v2.7/PHPManagerForIIS_x64.msi

Перезагрузите сервер чтобы изменения вступили в силу.

Скачайте архивы с файлами расширений:

⬇️ https://github.com/phalcon/cphalcon/releases/download/v5.1.4/phalcon-php8.0-nts-windows2019-vs16-x64.zip

⬇️https://windows.php.net/downloads/pecl/releases/mongodb/1.13.0/php_mongodb-1.13.0-8.0-nts-vs16-x64.zip

Проверьте свойства файлов и снимите свойство «заблокирован», если они получили его при скачивании. Распакуйте архивы.

Откройте «IIS Manager» и перейдите в «PHP Manager».

Document image


Настройте PHP:

  1. Зарегистрируйте версию PHP указав путь к php-cgi.exe
  2. Настройте путь для файлов логов
Document image


3.Добавьте ранее распакованные расширения, а также включите необходимые и отключите ненужные. Итоговый список расширений:

Document image


Выполните рестарт IIS для вступление в силу изменений.

6. Загрузка и установка Passwork

Авторизуйтесь в портале для клиентов Пассворк — https://portal.passwork.ru

Document image


Скачайте Пассворк в виде ZIP-архива.

💡 Обратите внимание, что эта инструкция подходит для установки 5-ой версии Пассворк (5.х.х).

Для установки предыдущих версией Пассворк обратитесь в техническую поддержку.

Document image


Извлеките архив и скопируйте содержимое в директорию «C:\inetpub\wwwroot\».

Document image


Установка прав доступа

Откройте IIS Manager, нажмите правой кнопкой на вебсайт и выберите «Edit permissions».

Document image


Нажмите «Edit», затем «Add» найдите «IUSR» аккаунт. Выберите в списке «IUSR» и разрешите «Write» и «Modify» опции, затем нажмите «Ok» два раза.

Document image


Изменение физического пути веб-сайта

Нажмите правой кнопкой мыши на «Default Web Site» > «Manage Website» > «Advanced Settings». Измените физическое расположение сайта на «C:\inetpub\wwwroot\public\», затем нажмите «Ok».

Document image


Rewrite rules

Скачайте и установите URL Rewrite : The Official Microsoft IIS Site

⬇️ https://www.iis.net/downloads/microsoft/url-rewrite#additionalDownloads

Закройте IIS Manager и снова откройте его, выберите вебсайт. Кликните два раза на иконку «URL Rewrite». Нажмите «Import rules» и выберите .htaccess файл из корневой директории сайта, нажмите «Open» затем «Import».

Document image


Нажмите «Apply» после успешного импорта.

7. Инсталляция

Откройте http://passwork.local для доступа к веб-сайту.

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

💡 Оставьте все поля в значениях по умолчанию, если вы устанавливаете новую копию Пассворк.

💡 Обратите внимание, случайно генерируемый ключ страницей установки, используется для шифрования базы данных.

Зарегистрируйте администратора Пассворк

Введите логин и пароль для первого пользователя. Пользователь автоматически станет администратором и владельцем организации.

Document image


8. Настройка SSL сертификата в IIS 10

Откройте «Server Manager», выберите «Tools» затем «Internet Information Services (IIS) Manager», выберите сервер и два раза кликните на «Server Certificates», импортируйте сертификат.

Document image


Перейдите к сайтам, выберите сайт и нажмите «Bindings». Выберите «https» протокол из выпадающего списка. Введите полное доменное имя «passwork.local». Выберите SSL сертификат из списка (в инструкции имя сертификата «https»).

Document image


Затем нажмите «Close».

Проверьте SSL-соединение, откройте ссылку https://passwork.local.

9. Настройка продукта для корректной работы в Chrome с SSL

При работе через SSL-соединение (HTTPS) браузер Chrome требует наличия флагов Secure и SameSite у cookie. Без этих флагов браузер не будет принимать куки, и вы не сможете авторизоваться в Пассворке в Chrome.

Для того чтобы установить эти флаги, включите параметр ;session.cookie_secure в файле C:\Program Files\php8\php.ini:

Shell


И установите параметр disableSameSiteCookie (секция [application])в файле C:\inetpub\wwwroot\app\config\config.ini в значение Off.

Shell


💡 Обратите внимание, файл `config.ini` генерируется после прохождения первоначальной настройки на странице установки.

💡 Не устанавливайте эти параметры или верните их в исходное значение, если вы передумаете использовать SSL и будете работать через HTTP-протокол.

10.Настройка фоновых задач

Фоновые задачи — это задачи, которые выполняются по планировщику в фоновом режиме. Например, синхронизация LDAP, загрузка фавиконов и другие задачи, которые требует много времени, постоянного выполнения или распределения ресурсов.