Перейти к содержанию

Инструкция по установке и обновлению клиентского приложения через msi- и exe- файлы

Назначение документа

В данной инструкции представлено описание процесса установки и обновления клиентского приложения для корпоративного мессенджера VK Teams через msi-установщик и через exe-установщик.

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

Общая информация

На текущий момент для Windows поставляется два установщика:

  • Нативный msi-установщик;
  • Installer.exe — бинарный файл, который запускает msi-установщик.

Установка клиентского приложения возможна с дополнительными параметрами или без них. Обновление клиентского приложения при помощи установщиков не требует каких-либо дополнительных параметров запуска.

Получение msi- и exe- установщиков

Актуальные для релиза установщики можно скачать с https://dl.<сайт_компании>.

Например, если сайт вашей компании mycompany.com, то скачать файл можно со страницы https://dl.mycompany.com.

Установка и обновление клиентского приложения через exe-установщик

И установка, и обновление клиентского приложения осуществляются при помощи команд, представленных ниже.

  1. Скачайте exe-установщик с https://dl.<сайт_компании>.

  2. Установка клиентского приложения через exe-установщик возможна двумя способами:

    • Запустите его двойным кликом мыши.

    или

    • Запустите exe-установщик из командной строки.

      Exe-установщик имеет несколько дополнительных параметров для командной строки:

      • -appx — включает режим тихой установки.

      • -allusers — включает установку на систему (т.е. запускает msi-установщик с ключом ALLUSERS=1).

        Если выполняется не установка, а обновление, то инсталлер может определить, что установка была выполнена на систему, и в таком случае автоматически устанавливает ключ -allusers.

      По дефолту параметры выключены. Запуск exe-установщика из консоли без параметров равнозначен запуску двойным кликом мыши.

Весь процесс установки логируется в %TEMP%/vkteams.install.

Установка и обновление клиентского приложения через msi-установщик

И установка, и обновление клиентского приложения осуществляются при помощи команд, представленных ниже.

Msi-файл запускается стандартной утилитой msiexec. Отвечает за все аспекты установки на Windows — установка, обновление, удаление.

Msi-пакет можно установить либо на систему, либо на пользователя.

В случае установки на систему программа по умолчанию ставится в "ProgramFiles", и доступна всем пользователям компьютера.

В случае установки на пользователя программа по умолчанию ставится в "%LOCALAPPDATA%/Programs" и доступна только текущему пользователю.

Примечание

Установка от имени администратора (клик правой кнопкой мыши → контекстное меню → запуск от имени администратора) — не равнозначна установке на систему.
Если обычный пользователь запустит установку от имени администратора, то клиентское приложение установится на одного пользователя, в домашнюю папку администратора. Автоматический запуск клиентского приложения после установки будет выполнен от имени администратора — т.е. именно в его домашнюю папку будет записан кэш клиента в случае авторизации и использования.
Если пользователь перейдет в раздел ОС «Приложения и возможности», чтобы удалить клиентское приложение, то не увидит его там, т.к. в разделе отображаются программы, которые установлены либо на систему, либо конкретно на этого пользователя.

В утилите можно указать ключи для msiexec, такие как тихую установку (/quiet) или создание файла логов (/L*V). Также есть возможность указать несколько параметров, которые задают msi-установщику определенные правила установки.

Доступны следующие параметры для msi-установщика:

  • ALLUSERS — в зависимости от этого параметра производится установка клиентского приложения для одного пользователя либо на всю систему.
  • MSIINSTALLPERUSER — дополнительный элемент для параметра ALLUSERS. Параметр используется, когда клиентское приложение необходимо установить для одного пользователя.
  • INSTALL_ROOT — параметр выбора пути установки клиента.
  • AUTOUPDATES — возможность автоматического обновления клиентского приложения.
  • AUTOLAUNCH— автозапуск приложения после тихой установки клиентского приложения.
  • PROXY_INI — путь к файлу с настройками проксирования, которые применяет клиентское приложение сразу после установки. Пример файла представлен ниже.

В случае установки на пользователя exe-установщик запускает msi-установщик со следующими параметрами MSIINSTALLPERUSER=1 ALLUSERS=2 AUTOUPDATES=1 AUTOLAUNCH=1.

В случае установки на систему — с параметрамиALLUSERS=1 AUTOUPDATES=1 AUTOLAUNCH=1.

Примеры команд для установки и обновления

На всю систему:

msiexec.exe /i vkteams.msi ALLUSERS=1 

Для одного пользователя:

msiexec.exe /i vkteams.msi ALLUSERS=2 MSIINSTALLPERUSER=1 

Для одного пользователя (т.к. ALLUSERS=2 MSIINSTALLPERUSER=1 являются дефолтными параметрами):

msiexec.exe /i vkteams.msi

Тихая установка,обновление на одного пользователя с логами:

msiexec.exe /i vkteams.msi /quiet /L*V install.log ALLUSERS=2 MSIINSTALLPERUSER=1

Тихая установка с автозапуском:

msiexec.exe /i vkteams.msi /quiet AUTOLAUNCH=1

Установка на одного пользователя, клиентское приложение может автоматически обновляться:

msiexec.exe /i vkteams.msi AUTOUPDATES=1

Установка с указанием пути:

msiexec.exe /i vkteams.msi INSTALL_ROOT=Path

Шаблон файла Proxy.ini

Формат файла для указания настроек проксирования, которые применяет клиентское приложение сразу после установки.

Файл имеет формат ключ=значение. Обязательные группы отсутствуют.

# Тип прокси. В случае отсутствия ключа устанавливается значение по умолчанию "auto". Пустое значение будет считаться ошибкой
proxy_type=[auto, http, socks4, socks5]

# Использовать системный прокси. Значение по умолчанию — "false". Значения, отличные от "true" и "1", будут означать "false"
use_system=[true, false]


# Все ключи ниже используются, только если proxy_type != auto
# Хост и порт. Если не указаны, то будут применены пустой хост и нулевой порт
host=127.0.0.1
port=1234

# Необходима ли авторизация. Значение по умолчанию — "false". Значения, отличные от "true" и "1", будут означать "false"
need_auth=[true, false]

# Если авторизация необходима 
# Имя пользователя и пароль. Если значения необходимы, но не указаны, будут применены пустые значения
username=user
password=1234

# Тип авторизации. Используется, только если proxy_type == http. Значение по-умолчанию - "basic". Пустое значение будет считаться ошибкой
auth_type=[basic, digest, negotiate, ntlm]




Дата обновления документа: 19.02.2024 г.