Skip to content

Scheduling Optimization and Machine Learning Configuration

To integrate IFS Cloud with IFS Planning & Scheduling Optimization (PSO) the broadcast settings, PSO settings, and authentication settings are required to be set. It's possible to have multiple configurations, e.g. to allow communicating with different PSO systems or tenants from the same IFS Cloud instance.

This page only contains the configurations for IFS Cloud to connect with a PSO tenant. For the full integration to work, the relevant PSO tenant must also be configured to connect back to the IFS Cloud instance. IFS Optimization Framework Configuration Assistant can configure both IFS Cloud and the relevant PSO tenant from a single place.

To use IFS Optimization Framework Configuration Assistant, please use Add New Configuration / Change Configuration commands on this page.

Read more about Scheduling Optimization and Machine Learning.

DB Process Settings

The DB Process Settings are shared by all configurations.

DB Process Start Interval Control how often the background process should run to transfer data for the datasets that are marked for immediate transfer of changes to PSO.
DB Process Log Level Control the log level for IFS Optimization Framework.
DB Process On Enable or disable the background process that transfer data for the datasets that are marked for immediate transfer of changes to PSO.

Scheduling Optimization and Machine Learning Configurations

Configuration ID Unique ID for the configuration.
Account ID Organization ID in the PSO installation that this IFS Cloud instance is configured to connect. The default value is 'Default'.

The substitution variable #IFS_REALM_NAME# can be used to automatically retrieve the value from the corresponding System Parameter 'Namespace', converted to upper case.
Synchronize Users and Roles Synchronize relevant user accounts and roles in IFS Cloud with PSO. This will activate the Users Scheduling Model dataset in Scheduling Optimization Datasets. Read more about the Users Integration.
Admin User Role Permission set for PSO Workbench Administrator users to be synchronized with the Users dataset for this configuration. Read more about the Users Integration.
Runtime User Role Permission set for PSO Workbench users to be synchronized with the Users dataset for this configuration. Read more about the Users Integration.
Client ID Client ID of a service account which has the access to SchedulingServices projection granted. This client account will be used by the Scheduling Broadcast Manager in PSO to communicate with IFS Cloud, and also when IFS Scheduling Optimization is calling PSO RESTful gateway.

Client ID can be created from IAM Client page or using IFS Optimization Framework Configuration Assistant.

NOTE: This client must be a non public client with a service account user attached to it. Connected service account user must have FNDSCH_WEBSERVICE permission set granted.

NOTE: Service account user attached to this client should be added to the users list of PSO tenant with access to see all datasets.

NOTE: If created using the assistant, it will automatically create a service account user with relevant grants and also add it to PSO tenant.
Client Secret Client secret of the client used in Client ID field. This value can be obtained from IAM Clients page in IFS Cloud.

A Client ID can be created from IAM Client page or using IFS Optimization Framework Configuration Assistant. When Client is manually created its secret can be found in IAM Client page. If the configuration is done using IFS Optimization Framework Configuration Assistant this value will be set automatically.
Profile ID The Profile ID used in PSO. The profile can be used to define a specific set of parameters in PSO to be used together with specific Scheduling models.

The Profile ID is defined both on dataset level and configuration level. If the Profile ID is left blank on the dataset it will use the Profile ID from the configuration. Read more about Scheduling Optimization Datasets.

The Profile ID is also passed in the Users integration as some parameters (e.g. for the PSO Workbench) are set for the user, and not for the specific dataset. The same logic as above is applied when retrieving the Profile ID to use here. Read more about the Users Integration.
PSO Client ID The IAM Client ID that is used when PSO authenticate with IFS Cloud. This value will be set to the parameter OpenIdClientId in PSO when using the configuration assistant.

This can be created from IAM Client page or using IFS Optimization Framework Configuration Assistant.

NOTE: This client must be a public client, with URL of PSO server added to its Redirect Uri list in format https://<pso server address>/

NOTE:* If created using the assistant, it will automatically add the URL of PSO server in to Redirect Uri list.
Workbench URL The URL for launching the PSO Workbench.

The following configurations depend on whether PSO is installed in the same cluster as IFS Cloud or if PSO is installed outside the cluster of IFS Cloud.

PSO Installed in same cluster as IFS Cloud PSO Installed outside the cluster of IFS Cloud
PSO URL RESTful gateway URL of the PSO installation. http://ifs-automation-gateway/

NOTE: This is the default value for this field.
RESTful gateway URL of the PSO installation.

Ex:-
https://<pso server address>/automation/gateway
https://<pso server address>/IFSSchedulingRESTfulGateway

The path after the domain may depend on the setting used when installing the PSO server.
IFS Cloud Callback URL URL of the server that hosts the SchedulingServices projection. Application will use it to infer the URL of the projection.

NOTE: Saving a new value for this field will also update IFS Cloud Authentication URL field with a new autogenerated value. It should be changed if the autogenerated value is not valid for the specific installation.
http://ifsapp-odata:8080 URL through with IFS Cloud server could be accessed from PSO server.

In most cases this will be the URL defined in system parameter 'System Url' or 'Secondary Url (external proxy URL)', depending on where the PSO server is located in the network relative to IFS Cloud.

The substitution variables #SYSTEM_URL# and #SECONDARY_URL# can be used to automatically retrieve the value from the corresponding System Parameter.
IFS Cloud Callback URL Thumbprint The certificate thumbprint for the IFS Cloud Callback URL. The parameter is optional but it may be required if using a non-trusted certificate.

This value will be sent in the Broadcast Parameter url_cert_thumbprint to be used when PSO is returning data back to IFS Cloud.

See section on Certificate Thumbprints in the Administration Guide in the PSO documentation for more information.
IFS Cloud Authentication URL URL of the token endpoint for validating client credentials and obtaining authentication tokens.

NOTE: Value for this field will be automatically set when saving a new value for IFS Cloud Callback URL field. Manual change is not required unless the autogenerated value is not valid for the specific installation.
http://ifsapp-proxy/auth/realms/<security realm>/protocol/openid-connect/token

The text <security realm> should be replaced with the correct security realm of the installation.
<ifs cloud callback url>/auth/realms/<security realm>/protocol/openid-connect/token

In most cases <ifs cloud callback url> will be the URL defined in system parameter 'System Url' or 'Secondary Url (external proxy URL)', depending on where the PSO server is located in the network relative to IFS Cloud.

The text <security realm> should be replaced with the correct security realm of the installation.
Authentication Token URL Thumbprint The certificate thumbprint for the Authentication Token URL. The parameter is optional but it may be required if using a non-trusted certificate.

This value will be sent in the Broadcast Parameter auth_token_url_cert_thumbprint to be used when PSO is returning data back to IFS Cloud. It will also be set to the parameter OpenIdAuthorityThumbprint in PSO when using the configuration assistant.

See section on Certificate Thumbprints in the Administration Guide in the PSO documentation for more information.

Activities in Scheduling Optimization and Machine Learning Configuration

Header

Detail

Add New Configuration

Connect a PSO tenant to the IFS Cloud instance with a new Configuration ID using IFS Optimization Framework Configuration Assistant.

Change Configuration

Connect a PSO tenant to the IFS Cloud instance using an existing Configuration ID using IFS Optimization Framework Configuration Assistant. This action is allowed only when the PSO tenant that is currently specified in the configuration is not connected to IFS Cloud instance.

Disconnect Configuration

Disconnect the currently connected PSO tenant from the IFS Cloud instance. After disconnecting you can reconnect it using Change Configuration activity.