Topics: |
This section describes the prerequisites and synchronization usage of the WSO2/MData feature.
This section describes how configure the Omni Server Mode setting in the Omni Gen Server (OGS).
The synchronization functionality is intended for use only in OGS DEVELOPMENT mode, where you must configure the Omni Server Mode setting to DEVELOPMENT, as shown in the following image.
Note: If the OGS is unresponsive (for example, it is not started or in error), the Sync functionality is disabled.
When a new model contains a new subject(s), or a change to the structure of a current subject, a synchronization between the updated data structure and the structure previously existing in OGC is required.
Initialization of the synchronization process is performed using OGC and consists of the following parts:
The following procedure shows a sample workflow of actions for a user to accomplish the synchronization.
Using your browser, connect to the OGC Logon page, log on with the credentials containing the System_Administrator role, and then navigate to the Sources tab from Administration, and click the Sync link, as shown in the following image.
The analysis for the synchronization process begins, where the status bar displays the dynamic progress of the status, as shown in the following image.
After the analysis is complete, a summary on the proposed synchronization appears, as shown in the following image.
You can view the details on the potential update by expanding the View Details link.
Note: View Details refers only to the action modifying the OGC MData structure. To view the details for WSO2 modification, click the Details link near the respective summary items, as shown in the following image.
The following image shows a sample entry after clicking Details from Role(s) to be assigned to users found.
By default, four users (ds_a, ds_b, super_a, and super_b) are granted all the new domain roles (for example, permission to access the new domains or subjects).
To customize those defaults, click Edit. A dialog allowing refinement of the assigned domain roles appears. The user can then add or remove new domain roles and users, as well as the relations between them, as shown in the following image.
By default, each new domain role will be added to all the role sections in policies.
To change the default settings, click Edit. A dialog defining which domain roles will refer to what role sections in all policies appears. The user can match the new domain roles to the regular roles, as shown in the following image.
To start the actual synchronization process, click Apply Changes.
A Loading message appears, as shown in the following image.
When the synchronization is complete, a summary appears displaying the synchronization details, as shown in the following image.
The OGC Application should now be completely in sync with the new OGS data structure, and fully functional in using the new data.
When using the synchronization functionality from a developer environment (for example, IntelliJ IDEA, Eclipse, and so on) with OGS deployed on secured gateway (HTTPS), the configuration of SSL certificates should take place as described in this section.
Note: The following procedure should be performed only if you are running it in your integrated development environment (IDE).
-Djavax.net.ssl.trustStore=[path_to_certificates]\ibi-certs -Djavax.net.ssl.trustStorePassword=changeit -Dhttps.protocols=TLSv1.1,TLSv1.2
where:
..\[OGS_HOME_DIR]\omnigen\OmniGenData
Ensure that the following files are copied:
Note: The certificate can change from time to time. If this happens, you must update them.