В данной статье описаны шаги, которые нужно предпринять в случае переименования сервера, на котором располагается QlikSense или переноса ShareFolder. В первом случае, нужно проделать оба пункта, во втором только последний.
Изменить имя хоста Qlik Sense.
Имя хоста в Qlik Sense определяется содержимым host.cfg, поэтому необходимо изменить значение в этом файле.
Важно: это приведет к недействительности всех сертификатов — их нужно воссоздать.
Одноузловой сервер:
- Войдите в систему под сервисным пользователем QlikSense
- Остановите все службы QlikSense за исключением QlikSense Repository Database
- Откройте Microsoft Management Console (MMC) и удалите все текущие сертификаты QlikSense
- Удалите %ProgramData%\Qlik\Sense\Repository\Exported Certificates\.Local Certificates
- Сделайте копию файла %ProgramData%\Qlik\Sense\Host.cfg переименовав его в Host.cfg.old
- Файл Host.cfg содержит имя хоста, закодированное в base64. Закодируйте новое имя (например, с помощью сервиса base64encode.org) и замените имя в файле
- В QlikSense 3.2.5 или ранее запустите все службы QlikSense для восстановления сертификатов.
- В QlikSense June 2017 * или позже вместо того, чтобы запускать службу репозитория напрямую, выполните в командной строке Windows от имени администратора:
"C:\Program Files\Qlik\Sense\Repository\Repository.exe" -bootstrap -iscentral –restorehostname
* Имейте в виду: центральный сертификат используется для шифрования строк паролей, используемых в подключениях, поэтому изменение этого сертификата означает, что вам нужно будет воссоздать все соединения, содержащие информацию о пароле.
Мультиузловой сервер
В многоузловой среде есть два возможных сценария изменения имени хоста для узла Rim и для центрального узла. Сертификаты всегда генерируются центральным узлом и основаны на имени хоста, поэтому изменение имен хостов здесь занимает больше времени и потребует перераспределения, а в некоторых случаях также удаления и чтения информации о узле.
Изменение имени Rim Node
- Остановите все службы QlikSense
- Откройте Microsoft Management Console(MMC) и удалите все текущие сертификаты QlikSense
- Удалите %ProgramData%\Qlik\Sense\Repository\Exported Certificates\.Local Certificates
- Сделайте копию файла %ProgramData%\Qlik\Sense\Host.cfg переименовав его в Host.cfg.old
- Файл Host.cfg содержит имя хоста, закодированное в base64. Закодируйте новое имя (например, с помощью сервиса base64encode.org) и замените имя в файле
- Запустите QlikSense. Когда он не сможет найти сертификаты, он войдет в режим настройки
- К сожалению, невозможно настроить имя хоста узла в QMC, поэтому, когда имя хоста Rim узла изменено, вы должны его удалить и добавить заново.
На центральном сервере:
- Откройте Qlik Management Console (QMC)
- Нажмите Nodes
- Выберите узел, имя хоста которого изменено
- Нажмите Delete, затем Confirm
- Нажмите Create
- Заполните необходимые детали узла
Нужно воссоздать и/или изменить любые правила, использующие имя старого узла
Изменение имени Central Node
Все сертификаты, используемые Qlik Sense, создаются и подписываются центральным узлом и основаны на имени хоста. Изменение имени хоста на центральном узле нарушает эту цепочку доверия, и поэтому все сертификаты на всех узлах необходимо воссоздать и перераспределить.
На каждом Rim node:
- Остановите все службы Qlik Sense
- Откройте Microsoft Management Console(MMC) и удалите все текущие сертификаты QlikSense
- Остановите все службы Qlik Sense
После запуска без сертификатов они войдут в режим настройки, то есть они будут прослушивать новые сертификаты
На Central node:
- Залогинтесь под сервисным пользователем QlikSense
- Остановите все службы QlikSense за исключением Qlik Sense Repository Database
- Откройте Microsoft Management Console (MMC) и удалите все текущие сертификаты QlikSense
- Удалите %ProgramData%\Qlik\Sense\Repository\Exported Certificates\.Local Certificates
- Сделайте копию файла %ProgramData%\Qlik\Sense\Host.cfg переименовав его в Host.cfg.old
- Файл Host.cfg содержит имя хоста, закодированное в base64. Закодируйте новое имя (например, с помощью сервиса base64encode.org) и замените имя в файле
- В Qlik Sense 3.2.5 или ранее запустите все службы Qlik Sense для восстановления сертификатов.
- В Qlik Sense June 2017 * или позже вместо того, чтобы запускать службу репозитория напрямую, выполните в командной строке Windows от имени администратора:
"C:\Program Files\Qlik\Sense\Repository\Repository.exe" -bootstrap -iscentral –restorehostname
Доработка:
- В QMC перейдите в раздел Nodes
- Выберите каждый узел и нажмите Redistribute
Далее следуйте инструкциям на экране.
* Имейте в виду: центральный сертификат используется для шифрования строк паролей, используемых в подключениях, поэтому изменение этого сертификата означает, что вам нужно будет воссоздать все соединения, содержащие информацию о пароле.
После этих шагов в консоли в разделе Nodes должны быть прописаны актуальные хосты:
Изменение SharedFolder
Если папка SharedFolder находилась на сервере, который был переименован, или папка была перенесена, то одна при открытии приложения будет ошибка:
- Остановите все службы Qlik Sense, кроме Qlik Sense Repository Database на всех узлах
- Переместите папки Apps, ArchivedLogs, CustomData и StaticContent из предыдущей SharedFolder в новую
- Откройте файл QlikSenseUtil.exe (местоположение по умолчанию C:\Program Files\Qlik\Sense\Repository\Util\QlikSenseUtil\QlikSenseUtil.exe).
В QlikSenseUtil:
Нажмите «Connect to database», чтобы подключиться к базе данных репозитория
Имя хоста: введите имя хоста базы данных репозитория. При запуске с центрального узла можно указать localhost.
Пользователь базы данных: qliksenserepository (если вы не настроили сайт для работы с другой учетной записью)
Пароль: пароль для пользователя qliksenserepository
Затем нажмите на раздел «Service Cluster» и нажмите «ОК», чтобы получить текущие значения путей SharedFolder. Замените эти значения на актуальные. Например:
- Нажмите «Save» для сохранения изменений
- Нажмите «Clear» для очистки значений, затем «ОК» для проверки новых значений. Параметры должны быть актуальными.
- Запустите службы QlikSense