Главная / Поддержка / Вопросы по RightFax / Автоматическая установка клиентской части RightFax 9.4

Автоматическая установка клиентской части RightFax 9.4

Если в компьютерной сети организации установлена система управления локальной сетью, как, например Microsoft Systems Management, LanDesk или подобные, установку клиентской части фак-сервера RightFax 9.4 возможно автоматизировать на уровне командной строки факс-сервера или на локальном компьютере пользователя. Инсталлятор клиентской части факс-сервера использует Microsoft Windows Installer (msiexec.exe), запустив который из командной строки с определенными параметрами клиентскую часть факс-сервера можно установить в режиме скрытной (автоматической) установки.

Автоматическая установка с помощью msiexec.exe

Перед автоматической установкой c использованием msiexec следует убедиться, что на компьютере пользователя для автоматической установки установлены пакеты Microsoft Visual C++ Redistributable 2005 (x86), Microsoft .Net Framework 2.0 (для Windows XP).

Если на компьютере пользователя установлена 64-битная операционная система, то предварительно, до начала автоматической установки, необходимо установить процессор печати (RightFax Print Processor x64.msi – расположен в папке \Client\RightFax\Setup дистрибутива факс-сервера RightFax 9.4). Для установки процессора печати используются следующие параметры установщика msiexec:

Параметр Описание
/i Описывает, что запускаемая команда является процессом установки приложения. После параметра указывается имя пакета для установки. Например:

/i “RightFax Print Processor x64.msi”

/x Описывает, что запускаемая команда является процессом удаления приложения. После параметра указывается имя пакета для установки. Например:

/x “RightFax Print Processor x64.msi”

/q
b – указывает, что вывод информации о запуске установки приложения отключен. Данный параметр включает вывод процесса установки, а также уведомление о выполнении установки приложения. Например: /qb
n – указывает, что вывод информации о запуске установки приложения отключен. Данный параметр отключает вывода процесса установки, а также уведомление о выполнении установки приложения. Например: /qn
r – указывает, что вывод информации о запуске установки приложения отключен. Данный параметр отключает вывода процесса установки, а также включает уведомление о выполнении установки приложения. Например: /qr
f – указывает, что вывод информации о запуске установки приложения включен. Данный параметр включает вывод процесса установки, а также уведомление о выполнении установки приложения. Например: /qf
INSTALLDIR= Указывает путь в папке, в которую будет установлено приложение. Значение должно оканчиваться обратным слешем (\). По умолчанию равно C:\Program Files\RightFax Например:

INSTALLDIR=”C:\Program Files (x86)\RightFax\”

RUNFROMSETUP= 1 – указывает, что инсталляция приложения производится не с помощью установщика факс-сервера. Например: RUNFROMSETUP=1

Типичная команда выполнения для установки RightFax Print Processor на компьютер пользователя с 64-битной операционной системой:

msiexec.exe /i “RightFax Print Processor x64.msi” /qn RUNFROMSETUP=1 INSTALLDIR=” C:\Program Files (x86)\RightFax\”

Установка клиентской части факс-сервера RightFax 9.4 с помощью msiexec

После установки необходимых приложений и процессора печати RightFax (для компьютеров, с 64-битной операционной системой), запускается процесс установки клиентской части факс-сервера. При использовании msiexec.exe для установки, возможно использовать следующие параметры инсталлятора:

Параметр Описание
/i Описывает, что запускаемая команда является процессом установки приложения. После параметра указывается имя пакета для установки. Например:

/i “RightFax Product Suite - Client.msi”

/x Описывает, что запускаемая команда является процессом удаления приложения. После параметра указывается имя пакета для установки. Например:

/x “RightFax Product Suite - Client.msi” После удаления клиентской части факс-сервера возможно наличие остаточных записей в реестре компьютера пользователя

/q
b – указывает, что вывод информации о запуске установки приложения отключен. Данный параметр включает вывод процесса установки, а также уведомление о выполнении установки приложения. Например: /qb
n – указывает, что вывод информации о запуске установки приложения отключен. Данный параметр отключает вывода процесса установки, а также уведомление о выполнении установки приложения. Например: /qn
r – указывает, что вывод информации о запуске установки приложения отключен. Данный параметр отключает вывода процесса установки, а также включает уведомление о выполнении установки приложения. Например: /qr
f – указывает, что вывод информации о запуске установки приложения включен. Данный параметр включает вывод процесса установки, а также уведомление о выполнении установки приложения. Например: /qf

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

Параметр Описание
RFSERVERNAME= Указывает имя сервера RightFax. После установки с указанием значения этого параметра при запуске FaxUtil (утилиты клиентского доступа) клиентская часть будет использовать это значение в качестве имени факс-сервера для подключения по умолчанию.
INSTALLDIR= Указывает путь в папке, в которую будет установлено приложение. Значение должно оканчиваться обратным слешем (\). По умолчанию равно C:\Program Files\RightFax Например:

INSTALLDIR=”C:\Program Files\RightFax\”

REBOOT=
Force – принудительное включение вывода запроса о перезагрузке компьютера пользователя после установки. Например: REBOOT=Force
Suppress – включение вывода запроса о перезагрузке компьютера пользователя после установки, если перезагрузка необходима. Например: REBOOT=Suppress
ReallySuppress – отключение всех запросов и уведомлений о перезагрузке компьютера во время установки клиентской части, вызываемыми параметром Force. Например: REBOOT=ReallySuppress
/log Указывает путь к файлу для создания лога установки. Например:

/log “C:\RFInst.log”

RUNBYRIGHTFAXSETUP= 2 – указывает, что для автоматической установки не используется setup.exe дистрибутива факс-сервера. Например: RUNBYRIGHTFAXSETUP=2
CONFIGUREFAXCTRL=
1 – указывает, что установщику следует сконфигурировать и запустить утилиту faxctrl (утилита для управления клиентской частью факс-сервера в виде значка “факс” в области уведомлений компьютера)
2 – указывает, что установщику следует удалить faxctrl и созданные ею принтеры факс-сервера. Например: CONFIGUREFAXCTRL=1
INSTALLVIMPRINTER=
1 – указывает инсталлятору на установку VIM принтера (для IBM Lotus Notes)
2 – указывает инсталлятору на удаление VIM

Данный параметр применим только для операционных систем на базе Windows XP 32-бит. Например, INSTALLVIMPRINTER=2

INSTALLMAPIPRINTER=
1 – указывает инсталлятору на установку MAPI принтера (для Microsoft Outlook)
2 – указывает инсталлятору на удаление MAPI принтера

Данный параметр применим только для операционных систем на базе Windows XP 32-бит. Например, INSTALLMAPIPRINTER =2

ADDLOCAL=
Указывает, какие компоненты клиентской части факс-сервера следует установить на локальном компьютере. Допустимые значения следующие:

FaxUtil

FaxCtrl

EFM

Outlook

Объединить несколько значений параметра можно, заключив их в кавычки. Например:

ADDLOCAL=”FaxUtil,FaxCtrl,EFM”

Следующие примеры описывают стандартные команды для выполнения установки клиентской части факс-сервера RightFax 9.4 с помощью msiexec (команда должна выполняться одной строкой).

Автоматическая установка стандартных компонентов на компьютер пользователя

msiexec.exe /i 'RightFax Product Suite - Client.msi' /qn REBOOT=ReallySuppress RUNBYRIGHTFAXSETUP=2 CONFIGUREFAXCTRL=1 ADDLOCAL='FaxUtil,FaxCtrl,EFM,Outlook' INSTALLDIR='C:\Program Files\RightFax' RFSERVERNAME=<имя_факс-сервера_для_подключения>

Автоматическое удаление установленных компонентов с компьютера пользователя

msiexec.exe /x 'RightFax Product Suite - Client.msi' RUNBYRIGHTFAXSETUP=2 CONFIGUREFAXCTRL=2 /log 'C:\RFUnInstall.log' /qb

Автоматическое удаление установленных компонентов с компьютера пользователя с выводом информации об удалении

msiexec.exe /x 'RightFax Product Suite - Client.msi' RUNBYRIGHTFAXSETUP=2 CONFIGUREFAXCTRL=2 /log 'C:\RFUnInstall.log'

 

Автоматическая установка с помощью Setup.exe

Следующие примеры описывают стандартные команды для выполнения установки клиентской части факс-сервера RightFax 9.4 с помощью Setup.exe (команда должна выполняться одной строкой).

Установка клиентской части факс-сервера RightFax 9.4

Setup.exe /unattended=true /allowShutdown=true /add='FaxUtil,EFM' /rightFaxServer='myserver'

Изменение установленной клиентской части:

Setup.exe /modify /unattended=true /allowShutdown=true /add='faxctrl'

Удаление клиентской части факс-сервера:

Setup.exe /modify /unattended=true /allowshutdown=true /drop='faxctrl' Uninstalling all RightFax client applications from a server: Setup.exe /remove /unattended=true /allowShutdown=true

Перед началом автоматической установки.

1. Скопируйте Setup.exe из корневой директории смонтированного образа факс-сервера RightFax 9.4 в общую сетевую папку (только клиентская часть факс-сервера может быть установлена с помощью командной строки)

2. Скопируйте директорию \Client смонтированного образа факс-сервера RightFax 9.4 в ту же сетевую папку.

Указание уровня информирования пользователя об установке.

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

Параметр Описание
/unattended=true Setup.exe показывает прогресс установки клиентской части, но не нуждается в том, чтобы пользователь вмешивался в процесс установки, в том числе и при возникновении ошибок во время инсталляции. При возникновении ошибки, всплывет ее описание и пользователю необходимо будет только кликнуть ОК для отмены установки.
/quiet=true Setup.exe запускается без вывода какой-либо информации пользователю.

Указание расположения Setup.exe файлов

Запуск инсталляционного приложения клиентской части факс-сервера RightFax 9.4 Setup.exe должна производиться из папки, где расположен файл запуска установки, либо следует указать полный путь к файлу при его запуске. Например:

Setup.exe /manifest=”путь_к_файлу” – путь к папке с расположением файла может быть указан как “D:\RightFax\Client_Install” или как “\\имя_сервера\путь_к_общей_папке”.

Указание типа инсталляции.

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

Параметр Описание
/modify Изменяет установленные компоненты путем их добавления или удаления. Совместно с применением данного параметра должны использоваться параметры Add или Drop
/remove Удаляет все приложения клиентской части факс-сервера RightFax 9.4 с компьютера пользователя. Эта копанда не может быть использована для удаления дополнительных компонентов, которые требовались для установки клиентской части RightFax.

Указание приложений для инсталляции на компьютер пользователя.

С помощью применения параметра Add с указанием его значений, можно определить, какие приложения клиентской части факс-сервера следует установить на компьютер пользователя. Данный параметр указывается, если установка клиентской части на компьютер производится впервые, либо при запуске Setup.exe будет осуществляться добавление не установленных приложений. Например:

/add=”имя_1,имя_2,…” – обязательно заключение имени или группы имен в кавычки

Имена, используемые для указания приложения, которое следует установить, указаны в разделе “Имя приложения клиентской части”.

Указание приложений для деинсталляции с компьютера пользователя.

С помощью применения параметра Drop с указанием его значений, можно определить, какие приложения клиентской части факс-сервера следует удалить с компьютера пользователя. Данный параметр указывается, если установка клиентской части подразумевает удаление установленных приложений. Например:

/drop=”имя_1,имя_2,…” – обязательно заключение имени или группы имен в кавычки

Указание факс-сервера RightFax для подключения.

Для того, чтобы в параметрах приложения после установки, например FaxUtil, было указано имя или IP-адрес факс-сервера, следует задать следующий параметр:

/RightFaxServer=”имя_факс-сервера”.

Остановка процессов клиентской части.

Перед тем, как запускать инсталляцию, необходимо обязательно остановить инсталлированные приложения, являющиеся на момент установки активными процессами. Это можно сделать вручную, но Setup.exe может это сделать самостоятельно, если указать значения параметра:

/allowShutdown=true

 

Имена приложений клиентской части

Имя Описание
FaxUtil RightFax 9.4 FaxUtil
EFM RightFax 9.4 Enterprise Fax Manager
FaxCtrl Драйвер принтера RightFax 9.4
Outlook RightFax 9.4 расширение для Outlook
MAPI Драйвер MAPI принтера
VIM Драйвер VIM принтера
AutoReply RightFax 6.4 автоответ

 

Коды завершения установки

Setup.exe возвращает результирующий код процесса установки клиентской части. Возвращаемый код может быть использован для вывода кода при исполнении файла типа .bat по окончании процесса установки. Также возвращаемый установщиком код результата инсталляции можно использовать совместно с командой errorlevel

Возвращаемый код Описание
0 Успешно
1 Без ошибок, но требуется перезагрузка компьютера для завершения операции установки
-1 Ошибка
 

Для добавления комментария необходима регистрация