4 RIB Self-Service Enablement

The Self-service enablement is a feature for provisioning RIB on cloud post deployment only. Because of the promising high availability feature of applications on the cloud environment, this is an essential feature that minimizes the redo of the RIB install cycle post configuration changes to any RIB-app.

The Self-service enablement allows below provisioning in rib-<app>:

Table 4-1 Self-Service Feature

Self-Service Feature:	Self Service Feature on RIB-Admin GUI
Provisioning RIB adapters Choosing the subset of RIB adapters in scope for integration
Provisioning System Options Dynamically modifying configurations via, rib-<app> properties file. Example shown for rib-ext for dropping messages for specific types for subscriptions. Similarly, the drop messages types can be configured for other RIB applications like rib-sim, rib-rms and so on. Note: There are other infrastructure level options that are available only for AMS or devops teams to configure or update, as shown in the screenshot.
Provisioning Injector Service URL Hook to alternate subscribing retail application installation. Injector service url can be updated only for customer owned apps like -rib-ext , rib-lgf
RIB ServiceMonitor Verify InjectorService provisioned in previous step.

Provisioning RIB-Adapters

Every rib-<app> contains a set of publish and subscribing adapters for exchanging messages between retail applications. Subscribing adapters are MDB which are resource intensive. The higher the number of adapters in scope the higher is the resource crunch. In an environment which does not make use of all the publishing and subscribing adapters bundled with the rib-app, the user is allowed to choose a subset of the adapters needed based on the RIB functional flow. This configuration change takes effect dynamically and does not require a redeployment of the rib-<app>.

Follow the steps below for configuring the rib-<app> adapters in scope of the integration.

For every rib-<app> that needs a dynamic adapter selection to be enabled, set the below property to true. By default this property is set to true only for rib-ext. Only AMS or devops team can set this flag for other apps if needed.
```
enableDynamicAdapterInstanceSelection=true
```
Only if the above property is set to true, the user can select the adapters dynamically. Below is the default landing page when RIB adapters added in scope.
In the RIB-Admin GUI, the Manage Configuration > Adapter Selection tab provides the list of all available adapters whose subset can be chosen to publish, subscribe and retry rib messages based on rib integration flows.

Select the subset of publishing, subscribing and retry adapters depending on the rib-integration-flow in consideration and click Save.

Consider the below rib-integration flows:

rib-sim publishing the InvReq message

 <message-flow id="31">
              <node id="rib-sim.InvReq_pub" app-name="rib-sim"
                    adapter-class-def="InvReq_pub" type="DbToJms">
                     <in-db>default</in-db>
                     <out-topic>etInvReq</out-topic>
              </node>
              <node id="rib-ext.InvReq_pub" app-name="rib-ext"
                    adapter-class-def="InvReq_pub" type="DbToJms">
                     <in-db>default</in-db>
                     <out-topic>etInvReq</out-topic>
              </node>
              <node id="rib-rms.InvReq_sub" app-name="rib-rms"
                    adapter-class-def="InvReq_sub" type="JmsToDb">
                     <in-topic>etInvReq</in-topic>
                     <out-db>default</out-db>
              </node>
              <node id="rib-ext.InvReq_sub" app-name="rib-ext"
                    adapter-class-def="InvReq_sub" type="JmsToDb">
                     <in-topic>etInvReq</in-topic>
                     <out-db>default</out-db>
              </node>
       </message-flow>

rib-sim subscribing the ItemLoc message from RMS

<message-flow id="6">
              <node id="rib-rms.ItemLoc_pub" app-name="rib-rms"
                    adapter-class-def="ItemLoc_pub" type="DbToJms">
                     <in-db>default</in-db>
                     <out-topic>etItemLocFromRMS</out-topic>
              </node>
              <node id="rib-ext.ItemLoc_pub" app-name="rib-ext"
                    adapter-class-def="ItemLoc_pub" type="DbToJms">
                     <in-db>default</in-db>
                     <out-topic>etItemLocFromRMS</out-topic>
              </node>
              <node id="rib-sim.ItemLoc_sub" app-name="rib-sim"
                    adapter-class-def="ItemLoc_sub" type="JmsToDb">
                     <in-topic>etItemLocFromRMS</in-topic>
                     <out-db>default</out-db>
              </node>
              <node id="rib-rwms.ItemLoc_sub" app-name="rib-rwms"
                    adapter-class-def="ItemLoc_sub" type="JmsToDb">
                     <in-topic>etItemLocFromRMS</in-topic>
                     <out-db>default</out-db>
              </node>
              <node id="rib-ext.ItemLoc_sub" app-name="rib-ext"
                    adapter-class-def="ItemLoc_sub" type="JmsToDb">
                     <in-topic>etItemLocFromRMS</in-topic>
                     <out-db>default</out-db>
              </node>
       </message-flow>

Considering the above flows, select InvReq_Pub, and ItemLoc_sub and both Hospital adapters as shown in the image below. Adapters Selected

Verify that the selected adapters are reflected on the Adapter Manager tab and are up and running.
To have all the adapters for rib-<app> in scope by default, set the property as follows:
```
enableDynamicAdapterInstanceSelection = false
```
This is the default value for all rib-<app>s except rib-ext.

Provisioning System Options

Application specific properties for the rib-<app> are configured in the rib.properties file. When RIB is deployed on cloud, the application specific properties can be configured in the RIB-Admin GUI application. The Manage Configuration > System Options tab allows the user to edit the properties values post deployment. There are some infrastructure level options that are available only for AMS or devops teams to configure or update.

Following are the frequently configurable RIB properties:

Drop-messages-of-types- for dropping messages for specific types for subscriptions.
Updating facility_id and facility_type for rib-tafr.
A new system option can also be added using 'Add' functionality in UI. Perform the following steps to add the Facilities for rib-tafr.
- Click the Add button.
- Insert a new Facility ID.
  
  For example: key - facility_id.PROD.12345 value - 1
Updating injector service url and policy for rest-app.
Updating IDCS host URL. This is needed only for customer owned applications using Oauth for rest call.

Provisioning InjectorService URL

In the RIB-Admin GUI, the Manage Configuration > Injector Service page allows the user to configure an injector service URL for a customer-owned applications.

Update injector service URL details by providing new host and port details and the user credentials for the service.

RIB ServiceMonitor

Once the RIB integration environment is configured for use by various retail application, as a sanity test the user may need to verify the integration end points. For RIB on cloud, we can ping-test various webservices consumed by RIB using RIB admin GUI.

In RIB Admin GUI, the RibServiceMonitor page lists all the webservices consumed by the rib-application and allows the user to ping the same. The webservices are pingable only if the "ping" operation is supported by the webservice.