Skip to main content

Configuration file (.ini)

The Windows and Web user interfaces need a configuration file (settings.ini) to be able to connect to the Software Factory or Intelligent Application Manager.

The connection parameters in the configuration file determine which Software Factory or Intelligent Application Database database is used to load the application model.

Connection parameters

ParameterDescriptionOptions
MetaSourceMeta model sourceSF
IAM
RDBMSRelational database management system of the end productSQLServer
iSeries (IBM i)
Oracle
ServerName or IP address of the end product server, including the instance name
DatabaseDatabase or schema name of the SF or IAM
AuthenticationAuthentication to use when connecting to the IAM.

To specify a different authentication type for an application database, set the Authentication extended property of the runtime configuration in the SF or the application in IAM.
MSWindows - Integrated security for SQL Server
RDBMS - Database username and password
Kerberos - Integrated security for IBM i and SQL Server
Model
(optional, SF only)
To start a specific model
Branch
(optional, SF only)
To start a specific branchDefault: latest branch
Configuration
(optional)
The runtime or global configuration to useName of the runtime configuration.
Default: default configuration
Language
(optional)
Language to use for the login form and splash screenen, nl (ISO 639-1)
en-GB, nl-NL (ISO 639-1/ISO 3166)
eng, nld (ISO 639-2)
Default: system language
ExecutionMode
(optional)
Set to Developer to enable debug options.
An application that does not have the status Production can only be launched in Developer mode.
Enduser
Developer
User (optional)Default username

When no Model, Branch and Configuration are specified, the Windows user interface will load all active runtime configurations.

Examples

IAM

MetaSource     = IAM
RDBMS = iSeries
Server = db2.thinkwisesoftware.com
Database = IAM_PROD
Authentication = Kerberos

SF

MetaSource     = SF
RDBMS = SQLServer
Server = sqlserver.thinkwisesoftware.com\sql2019
Database = SF_DEV
Authentication = MSWindows
Model = MyModel
Branch = 1.20
Configuration = test_environment
ExecutionMode = Developer

Or, to load all active runtime configurations for the current user:

MetaSource     = SF
RDBMS = SQLServer
Server = sqlserver.thinkwisesoftware.com\sql2019
Database = SF_DEV
Authentication = MSWindows
ExecutionMode = Developer

Windows GUI + Indicium

Metasource               = IAM
Server = http://localhost:5000/iam/
Rdbms = indicium

or:

Metasource               = IAM
Server = http://localhost:5000/iam/
ExecutionMode = developer
Language = ENG
Rdbms = indicium

Other parameters

ParameterDescriptionOptions
AllowResetPasswordUsers with RDBMS login are allowed to reset their password.
A link "Forgot password" is shown in the login page. After clicking, a new page is shown where the user can fill in the new password and a code is sent by email.
Yes
No
ApplicationIconIcon in the Windows task bar. .
Absolute path on disk. Use UNC path when it is on a network.
CSVLoggingWrite query logging to csv file. Requires ExecutionMode Developer and subdirectory Logs to exist in the GUI folder.Yes
No
LogToFileWrite logging to file. Requires subdirectory 'Logs' to exist in the GUI folder.Yes
No
NoAsyncReportPreloadDon't preload Crystal Reports when starting (if this crashes the user interface)
ProgressbarColorSet the color of the progressbar of the Splash screen of the Windows user interface.RGB values, comma separated.
Default: 40,170,225
ShowLoginInfoDatabase info on login page and splashscreenYes
No
ShowSplashShow the splash screenYes
No
SmtpEnableSSLSMTP settings for password reset emailsYes
No
SmtpFromFrom email address
SmtpFromDisplayNameFrom display name
SmtpPasswordPassword
SmtpPortPort
SmtpServerServer
SmtpUserUsername
UseWindowsCultureWindows GUI
No (default): uses the Software Factory's settings.
Yes: uses the region and language settings of the operating system (Windows) for displaying and editing values instead of the settings derived from the application language ID from the meta source. (Dates, times, numbers etc.)
Yes
No

Was this article helpful?