On-Premise Server Settings.ini Configuration
Table of Contents
Settings.ini Parameter v3.x
This document shows all possible parameters for the settings.ini file.
Use ; at beginning of line for comments. The settings.ini file is divided into sections, shown in square brackets [ ].
General settings are shown at top without square brackets [ ].
If a parameter is used in settings.ini, then it overrides the server's default value. If no parameter is specified, the default value is used.
| Parameter | Description | Values |
|---|---|---|
| Section GENERAL | ||
SessionIDStart |
Start of session PIN numbers Default = 10000 |
1000 – 10000000 |
SessionIDEnd |
End of session PIN numbers Default = 99999 |
9999 – 99999999 |
SQLConnectionString |
Database connection string Default = SQL ConnectionString of the supplied SQL Express Server. The default value only needs to be adjusted if the supplied SQL Express server is not used. |
String |
ServerName |
Internal name of the server for the connections log table entries in the database Default = WEBCONF1 |
String (50) |
ExternalAddress |
FQDN of the Webconference server, used for download of the clients Default = Change2YourServer |
String |
XMLRPCSecure |
Activates the XMLRPC-Secure nterface (also important for OutlookPlugIn) Default = False |
Bool (true/false) |
XMLRPCSecureFQDN |
FQDN of the Webconference Server No default value |
String |
XMLRPCSecurePort |
Defines the port for the listener of the XMLRPC interface, for example XMLRPCSecurePort=5100 Default = 5100 |
Integer |
XMLRPC |
Enables the XMLRPC interface with internal fastviewer licensing Default = false |
Bool (true/false) |
UpdateURL |
Overrides the AutoupdateURL. If you use the Webconference server also for autoupdating the clients, you have to create an update folder in the webconference server folder. In this folder create a folder for every version, for example 3.10.0012 Default = “http://update1.fastviewer.com/update” |
String |
| Section [HttpListenURLs] | ||
listen1 |
First URL where the server waits for HTTP requests. This is to be used like a host header in IIS. Default = "http://*/" |
String |
listen2 |
Second URL where the server waits for HTTPS requests. This is to be used like a host header in IIS. Default = "http://*/" |
String |
| Section [HTTPServer] | ||
CustomizedClientDownload |
Only for ASP Server version. If enabled, the server searches for custom clients in the \clients\ directory. Default = false |
Bool (true/false) |
| Section [ConnectionManager] | ||
RootURLreply |
Response message when the server's root URL is accessed via a browser. Default = fastviewer server |
String (100) |
DirectListenIP |
Defines the IP address on which port 5000 is listened to. If no parameter is entered, all IP addresses of the server are listened to. Default = All IP addresses of the server |
String |
| Section [SessionManager] | ||
RecordPath (applies only to server-side recording) |
Defines the directory for server-side recording. Example: RecordPath=".\recordings\" Default = ".\recordings\" |
String |
RecordAll (applies only to server-side recording) |
Defines that all sessions are always recorded, even if the user has enabled recording. Example: RecordAll=true Default = false |
Bool (true/false) |
MaxRecordFileBytes (applies only to server-side recording) |
Defines the maximum file size of a session recording. Example: 10 MB file size MaxRecordFileBytes=1024*1024*10 0 = Unlimited Default = 0 |
Integer |
RecordFvwRec (applies only to server-side recording) |
Defines the recording format. It must be set to "true" without fail. Example: RecordFvwRec=true Default = false |
Bool (true/false) |
MinVersion |
Defines the minimum version for the Windows module that is still allowed to run. Example: MinVersion="3.20.0064" No default value |
String |
MacMinVersion |
Defines the minimum version for the macOS module that is still allowed to run. Example: MinVersion="3.20.0064" No default value |
String |
ClientURLBase |
Defines the value for the invitation link to fastclient.exe so that the client can be started with one click. Use the [clienturl] variable in the invitation text in the FastViewer portal. |
String |
WebClientURLBase |
Defines the value for the invitation link to the web client. Use the [webclienturl] variable in the invitation text in the FastViewer portal. |
String |
MaxSessionTimeSeconds |
All Instant Meeting and Secure Advisor sessions are automatically terminated after the set maximum session duration per session expires. Example: MaxSessionTimeSeconds=3600 Default = 0 (unlimited) |
Integer |
| Section [DatabaseManager] | ||
BackupPath |
Set the path to the folder where the backup should be stored. The backup creates one backupfile for each weekday, the files are overwritten each week. Example: backupPath=c:\dir1\ No default value |
String |
BackupHourUTC |
Defines the hour at which the backup should start. The hour is always set in UTC. Default = 1 |
0-23 |
ClientLog |
If set to true, each client connection data is recorded in the serverlog. It can be viewed with the logviewer tool. Default = false |
Bool (true/false) |
PerformUpdate |
Enable database schema updates on startup of service. Set to false on second server. Default = true |
Bool (true/false) |
MaxDBLogRetentionDays |
Logs can be deleted automatically. Everything older than 10 days is deleted. 0 means that nothing is deleted. Example: MaxDBLogRetentionDays=10 Default = 0 |
Integer |
CleanUpDetetedHourUTC |
Defines the time of deletion. Value to 15 means that the deletion will take place at 15:00h UTC. Example: CleanupDeletedHourUTC=15 Default = 2 |
Integer |
SetMemoryLimitMB |
For custom SQL Server, this parameter can be used to override the snapshot limit. Example: SetMemoryLimitMB=0 Default = 512 |
Integer |
CleanupDeletedKeepPastHours |
Automatic cleanup of the connection table after a number of hours Default = 168 (7 days) |
Integer |
| Section [Monolith] | ||
Enabled |
Set this to true to enable the web console. |
String |
WebAppListenAddress |
Defines the address that the server listens to for hosting the web app Example: https://Change2YourServer/adhoc/ |
String |
ExternalWebAppAddress |
Defines the address where the web app is hosted, as viewed by a consumer. It should only differ from |
String |
SQLConnectionString |
By default, the value is the SQL Connection string set in the general section, but with the database name (initial catalog) connect instead of fastviewer. Only set this if you want the connect database to be somewhere else. Example: https://Change2YourServer/adhoc/ |
String |
AdhocWebAppListenAddress |
Adjust the listener URL for your adhoc installation Example: https://Change2YourServer/adhoc/ |
String |
ExternalAdhocWebAppAddress |
Adjust this parameter if you are using a load-balancer that rewrites paths Example: https://Change2YourServer/adhoc/ |
String |
| Section [WebRC] | ||
AdhocJoinUrlTemplate |
Set this parameter to show an alternative link for AdHoc sessions in the web console Example: https://testpage.imagoverum.com/adhoc |
String |
| Section [RemoteManager] | ||
LegacyREClientVersions |
Defines the version of the remote client for which no automatic update should take place. Enter here any comma separated list of versions that should not Example: LegacyREClientVersions = 3.20.0053, 3.20.0061, 3.20.0062 No default value |
String |
ServerSideWOL |
Enables the server side WOL feature. Example: ServerSideWOL=true Default = false |
Bool (true/false) |
ServerSideWOLFixedTargets |
A comma-separated list of either network address/subnet mask or broadcast address. Example: ServerSideWOLFixedTargets=10.10.10.0/255.255.255.0,192.168.1.255 No default value |
String |
SessionClientLimit |
Defines the maximum number of participants in a Secure Advisor session (all presenters and participants are counted). Normal conferences are not affected by this. Example: SessionClientLimit=3 Default = 2 |
Integer |
AutoRemoveDoubleEntries |
Automatically removes duplicate entries (computer name exists more than once) from remote clients. Example: AutoRemoveDoubleEntries=true Default = false |
Bool (true/false) |
AutoRemoveDoubleEntriesHourUTC |
Defines the time of removing the duplicate remote clients. Example: always at 1:00 UTC AutoRemoveDoubleEntriesHourUTC=1 Default = 1 |
1 - 23 |
| Section [CEF] | ||
PackageURL |
Path to the CEF Package if SSO is used. Example: PackageURL = http://update1.fastviewer.com/update/1.3/package.exe No default value |
String |
Version |
Version of the CEF Package if SSO is used. Example: Version = 1.3 No default value |
String |
| Section [OAuth2] | ||
Enabled |
Enable OAuth2 for Single Sign-On (SSO) Example: Enabled=true Default = false |
Bool (true/false) |
| Section [Security] | ||
FreeFailedJoins |
Defines the number of possible immediate incorrect entries of session or reservation numbers. There are always 2 free misses by which the value is automatically increased. Example: FreeFailedJoins=2 (means 4 actual failed attempts). Default = 5 |
String |
| Section [UserManager] | ||
SMSUrl |
Defines the sending URL of the own SMS provider. The exact format of the URL must be requested from the Example: SMSUrl="https://www.esendex.com/secure/messe...t/SendSMS.aspx? |
String |
SMSPassword |
Defines the encrypted SMS password for the SMSUrl (%p% is replaced by the password). | String |
SMSAuthKeyLength |
Defines the length of the sent SMS authentication code. Example: SMSAuthKeyLength=5 |
Integer |
|
Section [Logging] Please use only lower values for log levels than default, when requested by support. | ||
General |
Set the logging level for general messages, like start, stop of server. Default = 2 |
0=Info, 1=Noncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled Values lower than 0 are replaced with 0. |
License |
Set the logging level for license related functions. Default = 2 |
0=Info, 1=Noncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled Values lower than 0 are replaced with 0. |
Connection |
Set the logging value for the connection manager. Default = 2 |
0=Info, 1=Noncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled Values lower than 0 are replaced with 0. |
PacketManager |
Set the logging level for the internal packet manager. Default = 2 |
0=Info, 1=Noncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled Values lower than 0 are replaced with 0. |
DatabaseManager |
Set the logging level for database queries. Default = 2 |
0=Info, 1=Noncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled Values lower than 0 are replaced with 0. |
MessageProtocol |
Set the logging level for the internal message protocol from and to the clients. Default = 2 |
0=Info, 1=Noncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled Values lower than 0 are replaced with 0. |
SessionManager |
Set the logging level for the session manager, which Default = 2 |
0=Info, 1=Noncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled Values lower than 0 are replaced with 0. |
XmlProtocol |
Set the logging level for the XMLRPC interface. Default = 2 |
0=Info, 1=Noncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled Values lower than 0 are replaced with 0. |
XMLRPC |
Set the logging level for the XMLRPC Secure Example: XMLRPC=2 |
0=Info, 1=Noncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled Values lower than 0 are replaced with 0. |
CustomizedDownload |
Sets the logging level for downloading personalized subscriber modules. Default = 2 |
0=Info, 1=Noncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled Values lower than 0 are replaced with 0. |
All |
Set the logging level for all above, overwrites the For debugging purpose only. |
0=Info, 1=Noncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled Values lower than 0 are replaced with 0. |
LogFilePath |
Full path to the logfiles. Please use “” at beginning and end of string. Default = “tunnelserver.log” |
String |
MaxLogFileSizeMB |
Value in MB for the maximum logfile size, before a new logfile is created. Default = 100 |
1 - 8000 |
RotationNumberOfFiles |
Number of logfiles to create, before oldest logfile is overwritten. Default = 3 |
1 - 99 |
| Section [PubSub] | ||
NATSServerTLSCertMatch |
Domain of the SSL certificate Standard = “*.fastviewer.com” |
String |
Insecure |
True when SSL is self signed or not valid Standard = false |
Bool (true/false) |
ServerPublicAddress |
FQDN server Standard = “” |
String |
ServerEnabled |
NATS server activation Standard = “true“ |
Bool (true/false) |
LoopbackClient |
Activate the loopback, if you have only one webconference server Standard = “false“ |
Bool (true/false) |
|
Section [SMTP] These values are specific to your e-mail infrastructure. If you are unsure which values to use, please check with your IT/e-mail administrator, as they can provide the exact configuration details for your company.
| ||
SMTPHost |
The hostname or IP address of your e-mail server (e.g., smtp.company.com) | String |
SMTPPort |
Defines the IP address for the e-mail server. The value depends your server setup. Standard = 25 |
String |
SMTPUser |
The username (usually an e-mail address) used for authentication | String |
SMTPPass |
The password for the SMTP user account | String |
SMTPEnableSSL |
Defines whether SSL is used to access the SMTP server. Set to true if your server requires SSL/TLS encryption, and to false otherwise. |
Bool (true/false) |
SenderAddress |
The e-mail address used as the sender for outgoing e-mails | String |
Sample of a settings.ini file
; Name of server (for database connection entries) Servername=WEBCONF1 ; SQL Connection string, the password for user sa is encrypted, so it cannot be used for login in an interactive SQL manager session SQLConnectionString="Data Source=(local)\fastviewer;Initial Catalog=fastviewer;Persist Security Info=True;User ID=sa;Password=<<ZLY5VPd8byicus01ottxqQ==>>" ; SessionIDStart value for that server SessionIDStart=10000 ; SessionIDEnd value for that server SessionIDEnd=99999 ExternalAddress=webconf.yourcompany.com
[Logging]
; The setting value is the limit at which a log message is logged. ; 0=Info, 1=Uncritical, 2=Warning, 3=Important, 4=Critical, 5=Disabled ;All=0 ; this overwrites all others, if less ;Connection=2 ;PacketManager=2 ;DatabaseManager=2 ;General=2 ;License=2 ;MessageProtocol=2 ;SessionManager=2 ;XmlProtocol=2 ;Log file path ;LogFilePath="tunnelserver.log" ;MaxLogFileSizeMB=100 ;RotationNumberOfFiles=3
[HttpListenURLs]
; This section contains a list of URLs where the HTTP Service should listen. ; This is required not only for HTTP downloads but also for normal HTTP communication! ; SSL Listenings should also be added here. listen1="http://*/" listen2="https://*/"
[ConnectionManager]
RootURLreply=fastviewer Webconference Server
[AdminIPList]
Allow1=“RemoteIP“ Allow2=“RemoteIP“
Example:
Suppose you have the following setup:
Web Conference Server
IP Address: 192.168.0.111
Client Computer
IP Address: 192.168.0.15
Configuration:
To allow only the client at 192.168.0.15 to access the admin interface, set:
Allow1="192.168.0.15"
Result:
Now, only the client with the IP address 192.168.0.15 will be able to access the admin page of the web conference server by going to:
arduinohttp://Servername/admin