Command line parameters

Previous  Top  Next

The installation file Pigeon4Setup.exe can be launched with optional parameters.

ARGUMENT	DESCRIPTION
/S	The installation win run in silent mode (in the background). No human intervention required. If no other parameter is specified, the Pigeon Client will be installed using the Client.ini configuration file if it exists.
/CLIENT	Will pre-select the Pigeon Client installation.
/ADMIN	Will pre-select the Pigeon Admin installation.
/SERVER	Will pre-select the Pigeon Server installation.
/GATEWAY	Will pre-select the Pigeon Gateway installation.
/GENERATOR	Will pre-select the Pigeon Generator for Windows installation.
/UNIX	Will pre-select the Pigeon Generator for Unix installation.
/F	The /F argument force the selection of components. If this parameter is present, the user will not have to choose what to install. If no component is pre-selected, the Pigeon Client will be installed by default. This parameter has no effect if parameter /S is used.
/NOREBOOT	The workstation will not be rebooted after installing the files. Useful with the /S parameter to prevent rebooting the workstation while a user is working on it.
/INI:<iniFileName>	Allow you to specify a custom .INI configuration file for the Pigeon Client configuration.
/HOST:<HostName>	The Pigeon Client will try to connect to the Pigeon Server installed on the specified host machine using the default TCP port number (3100) unless the parameter /PORT is used or the RemotePort value is declared in a configuration INI. This can be useful if you don't plan to use the Pigeon Gateway. If a Pigeon Gateway has been installed and there is no responding Pigeon Server on the specified host machine, then the Pigeon Client will call the Pigeon Gateway to get a new host and TCP port number.
/PORT:<PortNumber>	The Pigeon Client will try to connect to the Pigeon Server installed on the specified host machine specified in the /HOST parameter of the RemoteHost value in the configuration INI file. If a host name is not specified, the /PORT argument is useless. This can be useful if you do not plan to use the Pigeon Gateway. If a Pigeon Gateway has been installed and there is no respond from Pigeon Server on the specified host machine using the specified TCP port number, then the Pigeon Client will call the Pigeon Gateway to get a new host and TCP port number.

Command line installation examples
To install the Pigeon Client and the Pigeon Generator in the background during the day, use this syntax:
Pigeon4Setup.exe /S /CLIENT /GENERATOR /NOREBOOT

To install the Pigeon Client in the background, using a custom MARKETING.INI configuration file, use this syntax (the workstation may reboot if required):
Pigeon4Setup.exe /S /CLIENT /INI:MARKETING.INI

To start the installation program in foreground and specify a custom SALES.INI file:
Pigeon4Setup.exe /INI:SALES.INI
The above command will start the installation program in foreground, giving the choice of installation options to the user, but if the user select the Pigeon Client option, then the specified SALES.INI file will be used.

To start the installation program in foreground and pre-select Pigeon Client and Pigeon Generator:
Pigeon4Setup.exe /CLIENT /GENERATOR
With the above command, the Pigeon Client and the Pigeon Generator will be pre-selected but the user will still be able to select/deselect components.

To force the installation in foreground of the Pigeon Client:
Pigeon4Setup.exe /F
Using the /F parameter prevent the Components selection window to appear.

To force the installation in foreground of the Pigeon Client and specify a custom SALES.INI file:
Pigeon4Setup.exe /F /INI:SALES.INI

To force the installation in foreground of the Pigeon Client, the Pigeon Generator and specify a custom SALES.INI file:
Pigeon4Setup.exe /F /CLIENT /DISTANT /INI:SALES.INI

To force the installation in foreground of the Pigeon Client and specify a custom SALES.INI file but force the Pigeon Client to connect to a host "MyHost" using a TCP port number 3222:
Pigeon4Setup.exe /F /INI:SALES.INI /HOST:MyHost /PORT:3222

Note:   Even if you specify a RemoteHost and/or a RemotePort in the configuration file, using the /HOST: and/or /PORT: overrides the settings found in the INI file.