FACTON Client and Server Configuration

After the FACTON installation you can configure both the client and the server, e.g. to define client and server properties, encrypt .NET Remoting (TCP) or to use OpenID Connect to use the FACTON Identity Broker for logging in (see OpenID Connect).

The following sections provide an overview of console parameters and examples of CONFIG files:

• FACTON Client:

  • Configuration parameters for the FactonNET.exe.config file
  • Command line parameters for the FactonNET.config.exe file

• FACTON Server:

  • Configuration parameters for the FactonService.config file
  • Command line parameters for the FactonServer.config file

Evaluation order of the configuration parameters

1. Default values of the configuration in the code

2. Configuration parameter in the App.config file (e.g. FactonNET.exe.config)

3. Is being overwritten by command line parameters; here, the order of the parameters is relevant

4. Additional overwriting by CONFIG files in the /Plugins directory is possible

 

Client Configuration

Configuration parameters for the FactonNET.exe.config file

Parameter	Type	Default	Description
FactonServer	String, server name or IP address	<empty>	Sets the name or IP address of the application server.
FactonServerPort	Digit, number of the port	-1	Sets the port under which the application server can be reached.
RemotingMode	Enum value (RemotingMode); can be entered as number or text. The following values can be entered: "1" for TCP "5" for TCP + Secure	TCP (1)	Defines the .NET Remoting mode.
Language	String that equals the language identifier, e.g. "de" or "en"	<empty>	Sets the UI language of the client.
StartFile	Text, local data path	<empty>	Local path to a FCT file that is read, for opening objects. Setting is exclusive to the JumpTo Setting.
JumpTo	Text, format: "Type:ID1", "Type:ID1:ID2", "Type:ID1:ID2:ID3"	<empty>	Providing a type and up to 3 IDs, for opening objects. Setting is exclusive to the StartFile Setting.
NoSplash	Boolean, True/False	False	Defines that the splash screen is not shown when starting the client.
UseLocalHelp	Boolean, True/False	True	Activates using the local help instead of the Online Help.
DisableUpdateCheck	Boolean, True/False	False	Deactivates the automatic check for updates.
AutoClientUpdate	Boolean, True/False	False	Activates the automatic client update.
IgnoreOfflineCheck	#Boolean, True/False	False	Deactivates the check whether the client can also be started online (for Client Plus Installation).
StartAsAdmin	Boolean, True/False	False	Forces logging in to the client as administrator (for SSO).
GDITextRendering	Boolean, True/False	True	Defines whether GDI or GDI+ is used as text rendering for Infragistics controls.

Command line parameters for the FactonNET.config.exe file

The command line parameters are provided upon starting the Client, e.g. FactonNET.exe -NoSplash -Language=de.

Highlighted parameters have a different name or behavior compared to the configuration paramaters.

Parameter	Type	Value	Description
Server	Key/Value	String, server name or IP address	Sets parameter: FactonServer with the provided value. When omitting "-" or "/" before the parameter, the provided text is automatically used as value. Example "Client.exe localhost" equals "Client.exe -Server=localhost".
Port	Key/Value	Digit, number of the port	Sets parameter: FactonServerPort with the provided value. Example -Port={port}
RemotingMode	Key/Value	Enum value (RemotingMode)	Sets parameter: RemotingMode with the provided value. Example -RemotingMode={mode}
Language	Key/Value	String	Sets parameter: Language with the provided value. Example -Language={language}
FCT	Key/Value	Text, local data path	Sets parameter: StartFile with the provided value. Example -FCT={fctFilePath}
JumpTo	Key/Value	Text, special format	Sets parameter: JumpTo with the provided value. Example -JumpTo={link}
NoSplash	Flag	<none>	Sets parameter: NoSplash to "True".
UseLocalHelp	Flag	<none>	Sets parameter: UseLocalHelp to "True".
DisableUpdateCheck	Flag	<none>	Sets parameter: DisableUpdateCheck to "True".
AutoClientUpdate	Flag	<none>	Sets parameter: AutoClientUpdate to "True".
IgnoreOfflineCheck	Flag	<none>	Sets parameter: IgnoreOfflineCheck to "True".
AsAdmin	Flag	<none>	Sets parameter: StartAsAdmin to "True".
GDITextRendering	Flag	<none>	Sets parameter: GDITextRendering to "True".
Sleep	Key/Value	Digit, time in seconds	Defers the Client starts by the configured time value. For this parameters there is no equivalent App.config parameter. Example Sleep={time}

 

Configuration of the Application Server

Configuration parameters for the FactonService.config file

Parameter	Type	Default	Description
MigrateDB	Boolean, True/False	False	Migrates the database if a version upgrade is being performed. Further Information in the "FACTON_CM_InstallationGuide_EN.pdf" in your setup file
Port	Digit, number of the port	8086	Sets the port under which the application server is to be reached.
ProjectPortRange	Digit, number of the port	8100	Defines the port number as of which the TCP channels used for the editing of projects are to be opened.
BindTo	Text, IP address	<empty>	Defines an IP address if there are multiple network cards.
RemotingMode	Enum value (RemotingMode); can be entered as number or text. The following values can be entered: "1" for TCP "5" for TCP + Secure	TCP (1)	Defines the .NET Remoting mode.
ParentServerPort	Number of the port	8086	Sets the port of the online application server (for Client Plus Installation).
ParentServer	Text, server name or IP address	<empty>	Sets the IP address of the online application server (for Client Plus Installation).

 

Command line parameters for the FactonServer.config file

Parameter	Description
-Console	Starts the server as console application instead of a Windows Service.
-MigrateDB	Sets parameter: MigrateDB to "True".
-Port={port}	Sets parameter: Port with the provided value.
-RemotingMode={mode}	Sets parameter: RemotingMode with the provided value.
-ProjectPortRange={number}	Sets parameter: ProjectPortRange with the provided value.
-BindTo={ipadress}	Sets parameter: BindTo with the provided value.
-ParentServer={ipaddress}	Sets parameter: ParentServer with the provided value.
-ParentServerPort={port}	Sets parameter: ParentServerPort with the provided value.