Settings in the GConfiguration.ini file

[System]

Key Written by Setup? Description
CoreHostIdentity Yes

The system configuration key for the custom data configuration that will apply to this Gateway installation.

If not specified, default is MIMaterialsGateway_CONFIGURATION

Not used in MI Pro.
AutoShutdown Yes

Specifies whether the Gateway core should shut down automatically after the last client has disconnected.

If not specified, default is false
AutoShutdownTimeout Yes

If AutoShutdown is enabled: the timeout in minutes for the core to shut down after the last client has disconnected.

If not specified, default is 10

[ConnectionSettings]

Key Written by Setup? Description
LicenseServerAddress Yes

Service layer URL, for example: http://your.granta.server/mi_servicelayer
Authentication Yes

Specifies the method of authentication to use when connecting to the Granta MI Service Layer. Options are:

  • password – username/password validation (‘Basic’ authentication)
  • oidc – OpenID Connect authentication
  • iwa – Integrated Windows Authentication, using Windows Active Directory.
  • certificate – TLS Client Certificate authentication

If not specified, default is iwa

For MI Pro, you must ensure that this setting is either iwa or not specified.
GWUIPath No

Granta MI Gateway URL, for example: GWUIPath=https://your.miserver.name/grantami/gateway
Domain No

Granta MI service layer login domain (*not encrypted)

Not supported for MI Pro
Username No Granta MI service layer login username (*not encrypted)
Password No Granta MI service layer login password (*not encrypted)
UseProxy No Specifies whether to use a proxy to connect to the service layer
ProxyAddress No If UseProxy is enabled, the proxy address for the service layer, for example: http://your.proxy.here
ProxyPort No If UseProxy is enabled, the service layer proxy port (80 for http and 443 for https or custom)
ProxyUsername No If UseProxy is enabled, the service layer proxy domain/username (*not encrypted)
ProxyPassword No If UseProxy is enabled: the service layer proxy password (*not encrypted)
ShowAdvancedHTTP No

Specifies whether to show advanced service layer http settings on the Gateway UI.

If not specified, default is false
SSLPolicy Yes

SSL Certificate permissible errors policy for the Granta MI Service Layer HTTPS connection.

Formatted as a comma separated string of key values:

  • ignoreca – Allow Invalid CA
  • ignoredate – Allow Expired
  • ignorecn – Allow Invalid CN
  • ignoreusage – Allow Invalid Usage

If not specified, the default behavior is that no errors are permitted.
SSLProtocols Yes

Permitted SSL Protocols for the Granta MI Service Layer HTTPS connection.

Supported protocol: tls1.2
ResolveTimeout Yes

Service Layer DNS resolve timeout value in seconds.

If not specified, the default is 1.
ConnectTimeout Yes

Service Layer connection timeout value in seconds.

If not specified, the default is 30.
SendTimeout Yes

Service Layer Send first byte resolve timeout value in seconds.

If not specified, the default is 180.
RecvTimeout Yes

Service Layer Receive first byte timeout value in seconds.

If not specified, the default is 180.
HideDomain No

Hide the domain field in the Gateway Settings UI.

If not specified, the default is false.
EnableScheduledSync No

Determines whether locally stored database schema information is refreshed nightly. To enable automatic updates to take place, the computer must be left on, with the Gateway Core service running, and with Power Save mode turned off.

If not specified, the default is false.

[ClientDebugSettings]

Key Written by Setup? Definition
DebugLogging No

Enable debug logging in the Gateway UI.

If not specified, the default is false.
ShowAdvancedDiagnostics No

Show advanced diagnostic settings in the Gateway UI.

If not specified, the default is false.
ErrorLogging No

Enable error logging.

Note: Administrators can use this setting to enable or disable warning logging. However, users will not be able to override this choice in the Gateway UI.

If not specified, the default is true.
WarningLogging No

Enable warning logging.

Note: Administrators can use this setting to enable or disable warning logging. However, users will not be able to override this choice in the Gateway UI.

If not specified, the default is true.
ProfileLogging No

Enable profile logging.

If not specified, the default is false.
InfoLogging No

Enable informational/activity logging.

If not specified, the default is false.
ProcessMonitoring No

Enable hardware monitoring.

If not specified, the default is false.
SaveFEACards No

Save material card data files to a folder location on the client machine

  • For MI Materials Gateway for Ansys Workbench, the files are saved to the project_files folder associated with the Engineering Data component. If there is no project_files folder (if a new Workbench project has not yet been saved), then the files are saved to local application data.
  • For all other Gateways, files are saved to a host-specific folder in your Gateway local application data.

If not specified, the default is false.

[ClientSettings]

Key Written by Setup? Description
WhereUsedVersionAgnostic No

Specifies whether to include all versions of a record in ‘Where Used’ results.

If not specified, default is true.
ShowBoMExpanded No

Specifies whether to show multiple instances of a part as separate items. (User option available in Gateways for Creo and NX only.)

If not specified, default is false.

Windchill Connection Settings

Each supported version of Windchill requires a separate block of connection settings, with a section heading in the format: [WCVersionConnectionSettings]

where Version is the major and minor version, with no decimal point.

For example, the section heading required for Windchill 13.0 is: [130ConnectionSettings]

Key Written by Setup? Description
ServerAddress No

Windchill server URL, for example: http://your.windchill.server
Authentication No

Specifies the method of authentication to use when connecting to Windchill. Options are:

  • password – username/password validation (‘Basic’ authentication)
  • saml – Single sign-on using the identity provider for your Windchill server

If not specified, default is password
Username No Windchill login username (*not encrypted)
Password No Windchill login password (*not encrypted)
Domain No Windchill login domain (*not encrypted)
UseProxy No Specifies whether to use a proxy to connect to the Windchill server
ProxyAddress No If UseProxy is enabled, the proxy address for the Windchill server, for example: http://your.proxy.here
ProxyPort No If UseProxy is enabled, the Windchill proxy port (80 for http and 443 for https or custom)
ProxyUsername No If UseProxy is enabled, the Windchill proxy domain/username (*not encrypted)
ProxyPassword No If UseProxy is enabled: the Windchill proxy password (*not encrypted)
ProxyUserDomain No If UseProxy is enabled: the Windchill proxy domain (*not encrypted)