Автоматическая установка клиентской части 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 |
|
||||
| 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 |
|
Дополнительно можно указать значение следующих параметров:
| Параметр | Описание | |||
| RFSERVERNAME= | Указывает имя сервера RightFax. После установки с указанием значения этого параметра при запуске FaxUtil (утилиты клиентского доступа) клиентская часть будет использовать это значение в качестве имени факс-сервера для подключения по умолчанию. | |||
| INSTALLDIR= | Указывает путь в папке, в которую будет установлено приложение. Значение должно оканчиваться обратным слешем (\). По умолчанию равно C:\Program Files\RightFax Например:
INSTALLDIR=”C:\Program Files\RightFax\” |
|||
| REBOOT= |
|
|||
| /log | Указывает путь к файлу для создания лога установки. Например:
/log “C:\RFInst.log” |
|||
| RUNBYRIGHTFAXSETUP= | 2 – указывает, что для автоматической установки не используется setup.exe дистрибутива факс-сервера. Например: RUNBYRIGHTFAXSETUP=2 | |||
| CONFIGUREFAXCTRL= |
|
|||
| INSTALLVIMPRINTER= |
|
|||
| INSTALLMAPIPRINTER= |
|
|||
| ADDLOCAL= |
|
Следующие примеры описывают стандартные команды для выполнения установки клиентской части факс-сервера 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 | Ошибка |