Онлайн-установка

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

Пассворк не требователен к системным ресурсам, а необходимое количество серверов зависит от числа активных пользователей, объема хранимых данных и требований к отказоустойчивости системы.

Ознакомьтесь с полными системными требованиями.

Подготовка и получение архива

Открыть PowerShell от имени «Администратора»:

С помощью контекстного меню Пуск

1. Нажать правой кнопкой мыши на значке Пуск в левом нижнем углу экрана.
2. Выбрать «Windows PowerShell (администратор)» из контекстного меню.

С помощью меню Пуск

1. Нажать левой кнопкой мыши на значок Пуск в левом нижнем углу экрана.
2. Прописать powershell
3. Открыть PowerShell от имени «Администратора» комбинацией — Ctrl + Shift + Enter

осторожно

При использовании Windows Server 2016 нужно активировать протокол безопасности TLS 1.2 с помощью команды:

PowerShell

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Получить архив PassworkModule.zip в текущую директорию:

PowerShell

if (-not (Test-Path "$pwd\PassworkModule.zip")) {
    (New-Object System.Net.WebClient).DownloadFile(
        "https://repos.passwork.ru/repository/powershell/PassworkModule.zip", 
        "$pwd\PassworkModule.zip"
    )
    Write-Host "Модуль успешно получен" -ForegroundColor Green
} else {
    Write-Host "Архив с модулем уже существует" -ForegroundColor Red
}

к сведению

В случае ошибок, архив можно скачать вручную: https://repos.passwork.ru/repository/windows_powershell/PassworkModule.zip

Разархивировать PowerShell-модуль:

PowerShell

# Получить расположение PowerShell модулей 
$windowsModulePaths = $env:PSModulePath -split ";" | Where-Object { $_ -like "C:\Windows*" }

# Разархивировать PowerShell-модуль в директорию
Expand-Archive `
    -Path "$pwd\PassworkModule.zip" `
    -DestinationPath $windowsModulePaths -Force

# Удалить архив PassworkModule.zip
Remove-Item "$pwd\PassworkModule.zip"

Установка

Запустить онлайн-установку Пассворка:

PowerShell

Install-Passwork -Method online

Действия, выполняемые функцией

• Проверка версии операционной системы
• Проверка и получение сертификата из клиентского портала
• Проверка доступной версии из клиентского портала
• Подготовка и установка MongoDB
• Установка утилит администрирования
• Установка и настройка PHP
• Проверка и установка IIS с дополнительными расширениями
• Получение и перемещение кода Пассворка
• Настройка веб-сервера с созданием веб-сайта Пассворка
• Настройка веб-сайта Пассворка в связке с PHP

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

Скрипт выполнит проверку прав пользователя, а также произведет загрузку, установку и настройку компонентов. В случае возникновения ошибок, в оболочке PowerShell будут отображены ошибки:

В процессе выполнения скрипт запрашивает API-ключ из клиентского портала:

По завершению отобразится адрес для подключения к Пассворку через веб-браузер. Так выглядит успешная установка:

Настройка Пассворка

После установки и настройки, Пассворк будет доступен по адресу https://your_servername

warning

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

Выбор языка

На первом шаге система предложит выбрать язык интерфейса:

Чек-лист параметров

Чек-лист параметров покажет все ли компоненты установлены на сервере:

Подключение базы данных

Для подключения нужно использовать адрес MongoDB по умолчанию:

Ввод ключа шифрования

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

осторожно

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

Загрузка лицензионного ключа

Лицензионный ключ можно скачать на клиентском портале Пассворка или запросить у менеджера:

Настройка SSL-cертификата

По умолчанию Пассворк генерирует самоподписанный сертификат. После установки можно перейти к использованию полноценных SSL сертификатов.

Использование собственного сертификата

• Для сертификатов, изданных доверенным издателем;
• Для сертификатов, выпущенных доменными центрами сертификации вашей организации.

Откройте «Диспетчер Серверов» → «Средства» → «Диспетчер служб IIS» → «Сертификаты сервера» и нажмите «Импортировать»:

После импорта перейдите на веб-сайт Пассворка, откройте «Привязки» и выберите импортированный веб-сертификат для HTTPS-протокола:

Использование Let’s Encrypt

Если нет доменного центра сертификации (сертификата, выпущенного доверенным центром), но есть публичное DNS-имя сервера, можно настроить Let’s Encrypt.

Выпуск доверенного сертификата win-acme (Let’s Encrypt)

Пассворк станет доступен по протоколу HTTPS с использованием сертификата от Let’s Encrypt.

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

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

осторожно

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

• Работы LDAP;
• Отправки почтовых уведомлений;
• Загрузки фавиконов;
• Очистки коллекции session в базе данных Пассворка.