Skip to main content
Matrix42 Self-Service Help Center

On-Premise Server

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

10.000 – 99.999
SessionIDEnd

End of session PIN numbers

Default = 99999

10.000 - 99.999
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.

Default =
http://yourserver.com/client/fastclient_i_%1.exe

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.

Default = http://yourserver.com/joinclient.aspx?inv=%1

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 [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
be updated.

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
respective provider.

Example: SMSUrl="https://www.esendex.com/secure/messe...t/SendSMS.aspx?
username=admin&password=%p%&to=%mobile%&messagetype=sms.automatic&message=%message%"

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 - 5
License

Set the logging level for license related functions.

Default = 2

0 - 5
Connection

Set the logging value for the connection manager.

Default = 2

0 - 5
PacketManager

Set the logging level for the internal packet manager.

Default = 2

0 - 5
DatabaseManager

Set the logging level for database queries.

Default = 2

0 - 5
MessageProtocol

Set the logging level for the internal message protocol from and to the clients.

Default = 2

0 - 5
SessionManager

Set the logging level for the session manager, which
handles the complete session management of the Webconference server.

Default = 2

0 - 5
XmlProtocol

Set the logging level for the XMLRPC interface.

Default = 2

0 - 5
XMLRPC

Set the logging level for the XMLRPC Secure
interface.

Example: XMLRPC=2

0 - 5
CustomizedDownload

Sets the logging level for downloading personalized subscriber modules.

Default = 2

0 - 5
All

Set the logging level for all above, overwrites the
above values.

For debugging purpose only.

0 - 5
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)

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==>>"
; Session ID Start value for that server
SessionIDStart=10000
; Session ID End 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

  • Was this article helpful?